Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Installation Process: step 2: fix grammar

...

  1. Download & extract the three .zip files to your home dir, i.e. syndeia-cloud-3.4.SP1_2021-10-14.zip, syndeia-cloud-3.4.SP1_2021-10-14_janusgraph.zip, syndeia-cloud-3.4.SP1_2021-10-14_cassandra_zookeeper_kafka_setup.zip

  2. Identify your current Syndeia Cloud version and platform (Windows, Linux). Version can be identified by the filename of the .zip you originally downloaded, e.g. syndeia-cloud-3.4.2021-06-03, syndeia-cloud-3.4.2021-06-03, etc.)

  3. Start following the instructions below for the scenario and platform relevant to your environment. If a platform is not listed, no specific actions are needed for that platform.

...

Scenario 2: If you are already running SC 3.4 and upgrading to this 3.4 SP1 release

...

Linux

5. Stop all existing SC services via services.msc (SCM)
6. 4. To upgrade the Janusgraph (JG) SC DB to 3.4 SP1: In a Cygwin/WSL terminal, run:  ~/syndeia-cloud-3.4.SP1_2021-10-14_janusgraph_setup/bin/syndeia-cloud-3.4_janusgraph_setup_windows.bash --upgrade ( (info) this will run conf/syndeia-cloud-3.4_janusgraph_init_upgrade.groovy which sets query.smart-limit to false , adds sLabel to both edges and vertices, and kicks-off re-indexing with these new labels for your existing graph data)
7run /opt/janusgraph-current/bin/gremlin.sh and the following Groovy code below ( (info) this will check & set query.smart-limit to false):

Code Block
languagegroovy
:remote connect tinkerpop.server conf/remote.yaml session
:remote console
graph = ConfiguredGraphFactory.open('syndeia_cloud_graph')
graph.tx().rollback()
mgmt = graph.openManagement()
// below checks query.smart-limit
mgmt.get('query.smart-limit')
mgmt.set('query.smart-limit', false)
// above sets query.smart-limit to "false"
mgmt.get('query.smart-limit')
// you should get ==>false above
mgmt.commit()
:quit

The output as you execute each line should look similar to this:

Code Block
languagegroovy
gremlin> :remote connect tinkerpop.server conf/remote.yaml session
==>Configured localhost/127.0.0.1:8182-[0f1a9b8d-8430-4dcd-a72d-05d5c5b0ffb9]
gremlin> :remote console
==>All scripts will now be sent to Gremlin Server - [localhost/127.0.0.1:8182]-[0f1a9b8d-8430-4dcd-a72d-05d5c5b0ffb9] - type ':remote console' to return to local mode
gremlin> graph = ConfiguredGraphFactory.open('syndeia_cloud_graph')
==>standardjanusgraph[cql:[localhost]]
gremlin> graph.tx().rollback()
==>null
gremlin> mgmt = graph.openManagement()
==>org.janusgraph.graphdb.database.management.ManagementSystem@aa6b750
gremlin> // below checks query.smart-limit
==>null
gremlin> mgmt.get('query.smart-limit')
==>true
gremlin> mgmt.set('query.smart-limit', false)
==>org.janusgraph.diskstorage.configuration.UserModifiableConfiguration@436ce29
gremlin> // above sets query.smart-limit to "false"
==>null
gremlin> mgmt.get('query.smart-limit')
==>false
gremlin> // you should get ==>false above
==>null
gremlin> mgmt.commit()
==>null
gremlin> :quit

5. To upgrade Syndeia Cloud (SC) to 3.4 SP1: in a Cygwin/WSL terminalyour bash shell, run:  ~/syndeia-cloud-3.4.SP1_2021-10-14/bin/syndeia-cloud-3.4_install_windows.bash --upgrade --SC_version=v 3.4.SP1_2021-10-14 and follow the prompts

  • Linux:

5. To upgrade the Janusgraph (JG) SC DB to 3.4 SP1: run:  . ((warning) Note, if you are running a multi-node configuration you will also need to pass in --multi_node (or -m), ie: ~/syndeia-cloud-3.4.SP1_2021-10-14_janusgraph_setup/bin/syndeia-cloud-3.4_janusgraph_setup.bash --upgrade ( (info) this will run conf/syndeia-cloud-3.4_janusgraph_init_upgrade.groovy which sets install.bash --upgrade --multi_node --SC_version=3.4.SP1_2021-10-14)

Windows

4. Stop all existing SC services via services.msc (SCM)
5. To upgrade the Janusgraph (JG) SC DB to 3.4 SP1: In a Cygwin/WSL terminal, run /opt/janusgraph-current/bin/gremlin.bat and the following Groovy code below ( (info) this will check & set query.smart-limit to false):

Code Block
languagegroovy
:remote connect tinkerpop.server conf/remote.yaml session
:remote console
graph = ConfiguredGraphFactory.open('syndeia_cloud_graph')
graph.tx().rollback()
mgmt = graph.openManagement()
// below checks query.smart-limit
mgmt.get('query.smart-limit')
mgmt.set('query.smart-limit', false)
// above sets query.smart-limit to

...

 "false"
mgmt.get('query.smart-limit')
// you should get ==>false above
mgmt.commit()
:quit

The output as you execute each line should look similar to this:

Code Block
languagegroovy
gremlin> :remote connect tinkerpop.server conf/remote.yaml session
==>Configured localhost/127.0.0.1:8182-[0f1a9b8d-8430-4dcd-a72d-05d5c5b0ffb9]
gremlin> :remote console
==>All scripts will now be sent to Gremlin Server - [localhost/127.0.0.1:8182]-[0f1a9b8d-8430-4dcd-a72d-05d5c5b0ffb9] - type ':remote console' to return to local mode
gremlin> graph = ConfiguredGraphFactory.open('syndeia_cloud_graph')
==>standardjanusgraph[cql:[localhost]]
gremlin> graph.tx().rollback()
==>null
gremlin> mgmt = graph.openManagement()
==>org.janusgraph.graphdb.database.management.ManagementSystem@aa6b750
gremlin> // below checks query.smart-limit
==>null
gremlin> mgmt.get('query.smart-limit')
==>true
gremlin> mgmt.set('query.smart-limit', false)
==>org.janusgraph.diskstorage.configuration.UserModifiableConfiguration@436ce29
gremlin> // above sets query.smart-limit to "false"
==>null
gremlin> mgmt.get('query.smart-limit')
==>false
gremlin> // you should get ==>false above
==>null
gremlin> mgmt.commit()
==>null
gremlin> :quit

6. To upgrade Syndeia Cloud (SC) to 3.4 SP1: in your bash shella Cygwin/WSL terminal, run:  ~/syndeia-cloud-3.4.SP1_2021-10-14/bin/syndeia-cloud-3.4_install_windows.bash --upgrade --SC_version=v 3.4.SP1_2021-10-14 and follow the prompts ((warning) Note, If you are running a multi-node configuration you will also need to pass in --multi_node (or -m), ie: ~/syndeia-cloud-3.4.SP1_2021-10-14/bin/syndeia-cloud-3.4_install.bash --upgrade --multi_node --SC_version=3.4.SP1_2021-10-14).

Scenario 3: If you are already running SC 3.3 SP1 and upgrading to this 3.4 SP1 release

...

Linux / Windows

4. Please follow the instructions on the Migration page but use SC 3.4 SP1 everywhere where it

...

references SC 3.4.

Verification

  1. Follow the steps in the section Validating Syndeia Cloud Installation & Configuration on the following page to verify your installation: