/
Stage 8 - Upgrade JanusGraph (0.3.1 -> 0.5.3)

Stage 8 - Upgrade JanusGraph (0.3.1 -> 0.5.3)

Objective

Upgrade JanusGraph from 0.3.X to 0.5.3.

Prerequisites

Ensure previous stages have been completed without error.

Make sure that the JanusGraph service is stopped.

Steps

If you are on Linux, and connected to the Internet, the below process is automated and can be run via the syndeia-cloud-3.5_janusgraph_pre-setup.bash script included in the syndeia-cloud-3.5. build_version _janusgraph_setup.zip media

  1. Extract and install JanusGraph

    1. Ensure you have Janusgraph 0.5.3 (Release 0.5.3 · JanusGraph/janusgraph ) downloaded to your home directory.

      wget https://github.com/JanusGraph/janusgraph/releases/download/v0.5.3/janusgraph-full-0.5.3.zip

    2. Unzip the JanusGraph package to /opt.

      sudo unzip janusgraph-full-0.5.3.zip -d /opt/

    3. Take ownership of the extracted folder.

      sudo chown -R janusgraph:janusgraph /opt/janusgraph-full-0.5.3

    4. Create a renamed copy of the file /opt/janusgraph-full-0.5.3/conf/janusgraph-cql-configurationgraph.properties as janusgraph-cql-configurationgraph-syndeia.properties.

      sudo -u janusgraph cp /opt/janusgraph-full-0.5.3/conf/janusgraph-cql-configurationgraph.properties /opt/janusgraph-full-0.5.3/conf/janusgraph-cql-configurationgraph-syndeia.properties

      1. Update the following properties in /opt/janusgraph-full-0.5.3/conf/janusgraph-cql-configurationgraph-syndeia.properties file.

        graph.graphname=syndeia_cloud_graph_config storage.hostname=<your_Cassandra_host>

      2. Add the following properties.

        storage.username=syndeia_admin storage.password=<password_specified> graph.allow-upgrade=true

  2. If you installed Elasticsearch on the same machine, add the following properties to use Elasticsearch for search indexing.

    index.search.backend=elasticsearch index.search.hostname=localhost

  3. Create a renamed copy of the file /opt/janusgraph-full-0.5.3/conf/gremlin-server/gremlin-server-configuration.yaml as gremlin-server-configuration-syndeia.yaml.

    sudo -u janusgraph cp /opt/janusgraph-full-0.5.3/conf/gremlin-server/gremlin-server-configuration.yaml /opt/janusgraph-full-0.5.3/conf/gremlin-server/gremlin-server-configuration-syndeia.yaml

    1. Update the following property in /opt/janusgraph-full-0.5.3/conf/gremlin-server/gremlin-server-configuration-syndeia.yaml file.

      ConfigurationManagementGraph: conf/janusgraph-cql-configurationgraph-syndeia.properties

  4. Navigate to the new Janusgraph installation folder.

    cd /opt

  5. Update the symlink to point to the new installation.

    sudo ln -vfns janusgraph-full-0.5.3 janusgraph-current

  6. Take ownership of the extracted folder & symlink.

    sudo chown -R janusgraph:janusgraph /opt/janusgraph-current sudo chown -R janusgraph:janusgraph /opt/janusgraph-full-0.5.3

  7. Start the JanusGraph service.

    sudo systemctl start janusgraph

  8. Verify that the JanusGraph service is up (see Verification section below).

  9. Open the /opt/janusgraph-full-0.5.3/conf/janusgraph-cql-configurationgraph-syndeia.properties file, look for the following entry and delete it.

    graph.allow-upgrade=true

  10. Restart the JanusGraph service.

    sudo systemctl restart janusgraph

Verification

To check the status of the JanusGraph service, use the following command.

sudo systemctl status janusgraph

You can verify that it started if, Active: active (running) shows up in the output.