If you have any questions about the upgrade process, please contact us.
Your database can be easily backed up using the 'Download Database Backup' button at the top of the System Settings page. Use an FTP utility such as FileZilla or direct file access from your hosting control panel to download a copy of your site files.
There were many requirement changes from the previous version. This is an important step.
Log into your account at FusionInvoice.com, ensure your support/update plan is up to date, and download the latest package. Save it locally to your computer.
Navigate to the downloaded install package and unzip the contents into a temporary folder on your computer.
In previous releases, it was possible to transfer your license key and database information by copying the older files. Due to important modifications to the code within those files, that is not possible with this release.
Copy the following section, which will be contained in your database connection information, from the /config/database.php of your existing installation into a separate text file.
'mysql' => [
'host' => 'yourhost',
'database' => 'yourdatabasename',
'username' => 'yourusername',
'password' => 'yourpassword',
'prefix' => '',
'driver' => 'mysql',
'charset' => 'utf8',
'collation' => 'utf8_unicode_ci',
'strict' => false,
],
Copy your license key, from the /config/app.php file in your existing installation, which should be in the section that looks similar to the code below:
'key' => 'YourLicenseKeywillbehere',
>>>>>>> 2023docs
Delete these folders from the FusionInvoice installation on your server:
Upload the following folders and files from the installer package to the FusionInvoice folder on your server:
It is recommended that you use a standard FTP program such as FileZilla to upload the files to your server.
Delete all existing files from within the following directories:
Find the following section of code in /config/database.php and replace it with the information from the old database.php file in Step 4.
'mysql' => [
'host' => 'yourhost',
'database' => 'yourdatabasename',
'username' => 'yourusername',
'password' => 'yourpassword',
'prefix' => '',
'driver' => 'mysql',
'charset' => 'utf8',
'collation' => 'utf8_unicode_ci',
'strict' => false,
],
The media, bootstrap/cache, and storage directories will require recursive read, write, and modify permissions.
The exact steps to set the appropriate permissions will depend on your web host and server configuration. FusionInvoice cannot advise on the exact steps or permissions to apply to make these folders writable. If you have questions about this step, please contact your web host or system administrator.
This step involves running the setup process, which performs all the new version updates to your FusionInvoice database.
To avoid caching issues that could cause a failed upgrade and general unhappiness, we recommend that you run the update in a private/incognito browser window .
If you wish to run the update in your normal (non-private) browser window, first close your browser. If you have multiple browser windows open, you must close them all.
From the newly opened browser window, navigate to https://YourFusionInvoiceURL/setup and follow the prompts. If your https://YourFusionInvoiceURL/setup produces an error, try using https://YourFusionInvoiceURL/index.php/setup instead. When finished, your database will be updated.
Once this step is completed, you will be prompted to enter your license key, which can be found in your fusioninvoice.com account. You will then be able to log back into your upgraded FusionInvoice system.
*Note - In previous versions, the license key was held in the app.php file. That is no longer the case - the license key is now held in the database.
None of the templates in the custom folder (such as invoice or quote templates) will automatically upgrade. You are responsible for updating the code to match the latest default templates.
Log into your account at FusionInvoice.com and download the add-on package to upgrade. Save it locally to your computer.
Navigate to the downloaded Add-on package and unzip the contents.
Upload the unzipped add-on folder from your computer to the custom/addons folder on your server and let it merge/overwrite the existing folder. It is recommended that you use a standard FTP program such as FileZilla to upload the folder to your server.
Log into your FusionInvoice install and go to System -> Add-ons and press the Upgrade button for the add-on if it appears. If the Upgrade button doesn't appear, then no further action is required and the add-on should be upgraded and ready to use.