Upgrade Fusion 2.1.4 or 2.4 to Fusion 3.0
The steps below describe how to upgrade from Fusion 2.1.4 or 2.4.x to Fusion 3.0.
To upgrade to 3.0 from an earlier version of Fusion, first follow the steps to upgrade from 1.2 to 2.4, then follow the steps below.
The upgrade scripts require that the following Python libraries are already installed:
Extract it to a folder. Here we’ll call it
fusion-new, just as an example:
mkdir fusion-new tar -C fusion-new --strip-components=1 -xf fusion-3.0.0.tar.gz
FUSION_OLD_HOMEenvironment variable to the old version of Fusion (2.x).
FUSION_HOMEenvironment variable to the new version of Fusion (3.0).
Copy data from older fusion instance to new fusion instance
cp -R $FUSION_OLD_HOME/data/* $FUSION_HOME/data/
Clone the fusion-upgrade-scripts repository, if you haven’t already:
git clone https://github.com/lucidworks/fusion-upgrade-scripts
Run the config upgrade step. This upgrades the customized properties in
$FUSION_OLD_HOME/conf/config.shto the new properties file in 3.0.0 (
cd fusion-upgrade-scripts/src python upgrade-to-3.0.py --upgrade config
After running the step, please check the upgrade config in
$FUSION_HOME/conf/config.shand make sure all the modified properties in config.sh are reflected. Pay particular attention to the ZK connection strings if your existing Fusion installation connected to an external Zookeeper cluster.
If you are running distributed fusion, this step must be performed on all the Fusion nodes. Alternately, if all the fusion nodes use the same configuration, you may just copy the new fusion.properties to all the other nodes.Note
If you are running external Solr or Zookeeper, then modify the
group.defaultproperty in fusion.properties to reflect the services that should be started when
bin/fusionscript is executed.
Start the Zookeeper server which will be used by the new Fusion installation. If you are using the Zookeeper bundled within Fusion, that would be:
cd $FUSION_HOME ./bin/zookeeper start
Run the upgrade script:
cd fusion-upgrade-scripts-internal/src python upgrade-to-3.0.py --upgrade zk
Run 3.0.0 fusion (all services defined in fusion.properties) and validate via Fusion UI:
cd $FUSION_HOME ./bin/fusion start
After running all the services, run this command to upgrade your custom banana dashboards that are saved in Solr collection 'system_banana':
cd fusion-upgrade-scripts-internal/src python upgrade-to-3.0.py --upgrade banana
|Before accessing the Fusion UI, clear your browser’s cache. Otherwise, you may inadvertently access a cached version of the old Fusion UI and see inconsistent behavior.|