Ubu: Upgrade Graphlytic

1. Special upgrade steps

Every release should be upgraded by steps described in chapter Common upgrade steps except these specific versions:

Upgrade from any version to 1.13.0

Graphlytic 1.13.0 stores Graphlytic data in its own database. No Graphlytic data are stored in Neo4j database (only indexes). You have 2 possibilities how to migrate to Graphlytic 1.13.0:

  1. Install new fresh Graphlytic 1.13.0 (recommended)

    • in this case you will lost data about: users, groups, jobs, settings, saved visualizations. You can save some of them manually. For example you can export settings, manually take XML of existing jobs.

  2. Migrate Graphlytic data from Graphlytic 1.12.2

    • in this case all current Graphlytic data will be migrated (except jobs and indexer configuration)

    • in this case you need to upgrade to Graphlytic 1.12.2

    • then you can use Graphlytic Migration Tool 1.13.0. See Migration Tool 1.13.0 how to use it.

Upgrade from any version to 1.11.0

  1. new structure of directories of Graphlytic home directory was delivered in release 1.11.0. Backup all your graphlytic data and configuration files, install 1.11.0 and copy your previous data and configuration files to new installation.

  2. after Graphlytic is started, go to Settings and reindex nodes and relationships (indexer was changes due to upgrade to Neo4j 3).

2. Common upgrade steps

Follow these steps for standard Graphlytic upgrade:

  1. stop Graphlytic and Neo4j (see Ubu: 5. Stop Graphlytic)

  2. backup configuration files or start scripts you have changed (for example: graphlytic.conf, etc.)

  3. unpack Graphlytic installation package and copy content into Graphlytic home directory. Confirm all overwrites of files from prior installation (for example: graphlytic.war). Replace old version of neo4j-gl-plugin in Neo4j "plugin" directory.

    $ sudo su graphlytic
    graphlytic:$ cp /tmp/graphlytic-<version>.tar.gz /usr/share/graphlytic
    graphlytic:$ cd /usr/share/graphlytic
    graphlytic:$ tar zxvf graphlytic-<version>.tar.gz
    graphlytic:$ rm /usr/share/neo4j/neo4j-community-3.0.0/plugins/neo4j-gl-plugin-<version>.jar
    graphlytic:$ cp /tmp/neo4j-gl-plugin-<version>.jar /usr/share/neo4j/neo4j-community-3.0.0/plugins/
  4. restore backup files of Graphlytic you have backed up previously.

  5. start Neo4j and Graphlytic (see Ubu: 4. Start Graphlytic)