UbuS: Upgrade Graphlytic

Special upgrade steps

Unless otherwise stated in this chapter, upgrade to any version can be done by following the step described in the Common upgrade steps chapter.

Upgrade from Graphlytic 2.x to Graphlytic 3.x

  1. Follow the Common upgrade steps

  2. Configure and reindex the fulltext index - see Graph Connections#FulltextSearchConfiguration

  3. Optional: Drop the old (Graphlytic 2.x) manual fulltext index from Neo4j. Assuming the index was used only for Graphlytic purposes it's safe to remove it and spare some disk and RAM. Use this cypher to remove the index:

    CALL db.index.explicit.drop('node_fulltext')

Common upgrade steps

Follow these steps for standard Graphlytic upgrade:

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

  2. backup configuration files or start scripts you have changed.

    1. /conf/*.*

    2. all folders set in the graphlytic.conf file or other folder defined in UbuS: Important directories

    3. run scripts

  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 /var/lib/neo4j/plugins/neo4j-gl-plugin-<version>.jar
    graphlytic:$ cp /tmp/neo4j-gl-plugin-<version>.jar /var/lib/neo4j/plugins/
  4. restore backup files of Graphlytic you have backed up previously.

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