Upgrading from previous versions
After downloading the software, it is recommended to unzip on a different directory from the current directory. You can also use the same directory and overwrite the files.
Keeping the same directory for Clarive¶
If you decide to keep the same directory as the previous version of Clarive, it is necessary to make a backup of folders
$CLARIVE_BASE/clarive and replace them with the new ones.
New Directory for Clarive¶
When using a different directory, it is necessary to update the environment variable $CLARIVE_BASE with the directory where you want to unzip the new version.
We must also move the folders where the logs, the features and configurations, etc are.
mv $CLARIVE_BASE_OLD $CLARIVE_BASE rm -rf $CLARIVE_BASE/local rm -rf $CLARIVE_BASE/clarive
Once these steps are done, the new version of the directory is decompressed in the new directory
Data migrations may be required when starting the server (dispatcher or web server).
When migrations are needed, the following message will be shown:
pid_file: /opt/clarive/logs/cla-web-host-3000.pid (I)2015-03-04 21:19:38.057 [B::Mongo:81] Mongo: new connection to db `acmebank` (D)2015-03-04 21:19:38.062 [cache:43] CACHE Setup ok: expire_seconds 90000 driver Mongo ERROR: Migrations are not up to date. Run with --migrate flag or use migra- commands
To remedy this situation, start the server or dispatcher with the
--migrate option added:
cla web-start -c [config_file] --migrate
This will trigger a migration run, after which it will start the server/dispatcher normally.