3.5 Service Pack 2 (3.5 SP2)


Updates and fixes in this service pack (3.5 SP2)

Syndeia Cloud (SC) 3.5 SP2, including the REST API and the Syndeia Cloud Web Dashboard, has several improvements which are listed here: Syndeia 3.5 SP2 - Improvements.


Installation Process

Syndeia Cloud 3.5 SP2 is a full build of Syndeia Cloud and not a patch/incremental build. It is an in-place upgrade of the Syndeia Cloud services and does NOT require any data migration. Follow the steps below to deploy Syndeia Cloud 3.5 SP2.

  1. Download & extract the three .zip files to your home dir, i.e. syndeia-cloud-3.5-SP2.zip, syndeia-cloud-3.5-SP2_janusgraph.zip, syndeia-cloud-3.5-SP2_cassandra_zookeeper_kafka_setup.zip

  2. Identify your current Syndeia Cloud version and platform (Windows, Linux). The version can be identified by checking the Help > About menu in Syndeia Cloud Web Dashboard.

  3. Follow the instructions below for the scenario and platform relevant to your environment.


Scenario 1: If you are deploying SC 3.5 for the first time with this service pack (or starting from scratch)

Linux / Windows

  1. Gather the three .zip files you downloaded for Syndeia Cloud 3.5 SP2 and follow the instructions here: Deployment.

  2. There are two (2) Deployment Methods and we recommended using the Automated Deployment method as a quick start.


Scenario 2A: If you are already running SC 3.5 SP1 and upgrading to this 3.5 SP2 release

Linux

  1. To upgrade Syndeia Cloud (SC) to 3.5 SP2: in your bash shell, run the below and follow the prompts:  

    export SC_snapshot_version_old=3.5-SP1 cd ~/syndeia-cloud-3.5-SP2/bin/ ./syndeia-cloud-3.5_install.bash --upgrade -s -SC_v 3.5-SP2

    Note, if you are running a multi-node configuration you will also need to pass in --multi_node (or -m), ie:

    export SC_snapshot_version_old=3.5-SP1 cd ~/syndeia-cloud-3.5-SP2/bin/ ./syndeia-cloud-3.5_install.bash --upgrade -s --multi_node --SC_version=3.5-SP2

Windows

  1. Stop all existing SC services via services.msc (SCM)

  2. To upgrade Syndeia Cloud (SC) to 3.5 SP2: in a Cygwin/WSL terminal, run the below and follow the prompts:

    export SC_snapshot_version_old=3.5-SP1 cd ~/syndeia-cloud-3.5-SP2/bin/ ./syndeia-cloud-3.5_install_windows.bash --upgrade -s -SC_v 3.5-SP2

    Note, if you are running a multi-node configuration you will also need to pass in --multi_node (or -m), ie:


Scenario 2B: If you are already running SC 3.5 and upgrading to this 3.5 SP2 release

Linux

  1. To upgrade Syndeia Cloud (SC) to 3.5 SP2: In your bash shell, run the below and follow the prompts:  

    Note, if you are running a multi-node configuration you will also need to pass in --multi_node (or -m), ie:

Windows

  1. Stop all existing SC services via services.msc (SCM)

  2. To upgrade Syndeia Cloud (SC) to 3.5 SP2: In a Cygwin/WSL terminal, run the below and follow the prompts:

    Note, if you are running a multi-node configuration you will also need to pass in --multi_node (or -m), ie:


Scenario 3: If you are already running SC 3.4 SP3 and upgrading to this 3.5 SP2 release

Linux / Windows

  1. Please follow the instructions on the Migration page but use SC 3.5 SP2 everywhere where it references SC 3.5.


Verification

  1. Scenario 2 ONLY: Confirm batch_size_warn_threshold_in_kb and batch_size_fail_threshold_in_kb in /etc/cassandra/default.conf/cassandra.yaml have been bumped up from their defaults, ex:

    If you make changes to the above, restart the Cassandra service:

    If you frequently deal with large artifact sizes you may want to configure your monitoring to watch for the “batch size” warn messages and bump up as needed.

  2. Scenario 2 ONLY: Make sure sc-store service’s application.conf at /opt/icx/syndeia-cloud-current/store-impl-3.5-SP2/conf/application.conf contains the following performance tuning enhancements on ~L95:

    If not, add them and restart the sc-store service.

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