Upgrading Content Fusion
Pre-Upgrade Notes
- System requirements: On the server running Content Fusion, you need enough disk space to create a backup. The backup file contains a compressed archive of all files located in /fusion/data/, so to be safe, the free space should be at least equal to the size of the data folder.
- Custom frameworks and plugins will need to be reinstalled manually on the new server.
- The upgrade process will involve some downtime, so pick a time that does not affect the users.
Recommended Upgrade Procedure
- Deploy the new version of Content Fusion on a new server:
- Access the Configuration Page and set the administrator password. See the configuration section:
- Once the new server is ready, reinstall any custom Web Author frameworks or plugins that you were using on the old server.
- Enable maintenance mode on the old server. Maintenance mode is needed to ensure that users are not making any changes to the tasks while the backup is being created.
-
Create a backup of the data on the old server by running the following command on the old server:
sudo bash /fusion/admin/create-fusion-backup.sh MY_BACKUP_FILE
This will create a backup archive (MY_BACKUP_FILE) in the current directory. If the backup file already exists, you will be prompted to choose whether or not to overwrite it. If you run the create-fusion-backup.sh command without specifying the backup file, it will create a timestamped file (e.g.
fusion-backup-20240325125325.tar.gz
) in the current directory. - Copy the
fusion-backup.tar.gz
backup file to the newly deployed server. -
On the newly deployed server, run the following command to restore the backup:
where the path to the backup file is updated to match your situation.sudo bash /fusion/admin/restore-fusion-backup.sh /path/to/fusion-backup.tar.gz
Step Result: After restoring the backup, all the user tasks and configurations will be available in the new Content Fusion server.
- Because the backup was created while maintenance mode was enabled, the new Content Fusion server will be in maintenance mode after the backup restore. Go to the Administration Page and disable maintenance mode.
- To test the upgrade, check to make sure the tasks and configurations that were present
on the old server are now present on the new server.Note: Depending on the configuration, you may have to configure your mail server to accept emails from the new Content Fusion server.
- Replace the old server with the new one.
Fast Upgrade Procedure
Restriction: This procedure is only available for
installations created with the Linux installation kit and the version you want to upgrade
from is at least 5.0.
To upgrade an installation that was created by the installation kit:
- Go to the Content Fusion Download webpage.
- Go to the Linux tab and download the Oxygen Content Fusion Enterprise Server installation kit.
- Create a backup of
your current installation. This step serves as a safeguard, ensuring that you can later
recover your data from the previous version of Content Fusion in case of unforeseen
complications that may arise during the installation process.Important: The /fusion/ folder will be removed during the installation, so your backup should not be located within it.
- Run the installer (the installation requires root privileges)
using the
-u
flag.sudo bash Oxygen_Content_Fusion_Enterprise.sh -u
Note: When the
-u
flag is used, the installation
kit will upgrade the current version of Content Fusion, while keeping all the existing
data and configuration settings. The Administration page credentials will be reset to the
initial setting (user=fusion
/ password=oxygenxml) and will need to be re-configured.