Driven Administrator Guide

version 2.0.5

Upgrading to Driven Server 2.0

Tip	Contact Technical Support before starting the upgrade or data migration.

Prerequisites

Ensure that all applications that feed data to Driven do not run while performing upgrade and migration.
Back up the data of your Driven deployment. See Backing Up and Restoring Driven Repositories for more information.
For sites running a stand-alone Elasticsearch cluster: Upgrade the cluster to Elasticsearch version 1.5.2. Also, if required, upgrade Elasticsearch plugins to be compatible with version 1.5.2.
If you have Driven 1.2 or an earlier version, complete the upgrade and migration steps between each iterative version of 1.x that applies to your environment until you are at version 1.3 before upgrading to version 2.0:
- Migrating Data and Upgrading Driven 1.1 > 1.2
- Upgrading Driven 1.2 > 1.3
Driven Server 1.3 > 2.0 upgrade does not require you to perform data migration steps and is documented below.

Upgrade the Driven Server

To upgrade the Driven Server, you need to replace the WAR file contents of your deployment with the contents of the version 2.0 WAR file while the server is stopped. After you restart the server, install version 2.0 of the Driven CLI Client.

Step 1: Download the Driven Server installation ZIP archive, which includes Apache Tomcat and embedded Elasticsearch libraries, by one of the following methods:

Download the ZIP archive from http://files.concurrentinc.com/driven/2.0/driven-server/driven-tomcat-2.0.5.zip
Alternatively, on UNIX, Linux, and Mac, run the following command:

$ wget -i http://files.concurrentinc.com/driven/2.0/driven-server/latest-tomcat.txt

Step 2: Extract the ZIP archive to the default driven-tomcat-2.0.5/ directory, which is later referred to as ${UPGRADE_DIR}.

Step 3: Run the shutdown.sh script in the Driven installation directory:

$ cd ${INSTALL_DIR}
$ bin/shutdown.sh

Step 4: Remove the contents of the ${INSTALL_DIR}/webapps/ directory by running the following command:

$ rm -rf ${INSTALL_DIR}/webapps/*

Step 5: Copy the WAR file from the newly extracted webapps directory to the webapps directory in the Driven installation path:

$ cp ${UPGRADE_DIR}/webapps/ROOT.war ${INSTALL_DIR}/webapps/ROOT.war

Step 6: Ensure that the system user that will run Tomcat has execute and write permissions on the copied WAR file.

Step 7: Run the startup.sh script in the Driven installation directory:

$ cd ${INSTALL_DIR}
$ bin/startup.sh

Step 8: Follow the steps in Installing the Driven CLI Client.

Next Topic

Troubleshooting Driven