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 Python 2.7 or greater and that the following Python libraries are already installed:

Steps to upgrade from Fusion 2.4.x to 3.0

Download Fusion 3.0.

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

Set the FUSION_OLD_HOME environment variable to the old version of Fusion (2.x).
Set the FUSION_HOME environment variable to the new version of Fusion (3.0).
```
export FUSION_HOME=fusion-new/3.0.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.sh to the new properties file in 3.0.0 ($FUSION_HOME/conf/fusion.properties).

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.sh and 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.default` property in fusion.properties to reflect the services that should be started when `bin/fusion` script 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
```

Tip	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.