Running the Upgrade

After preparing the computer for the upgrade, follow these steps to complete the task.

1. As the chorus user, make the installer executable.

   This instruction applies if you downloaded the installer as the chorus user. If you downloaded with another account, log in as root for this step.

   $ chmod +x ~/TIB_sfire-dsc-6.5.0_linux_x86_64.sh

2. As the chorus user, run the installer with the following command.

   $ ./TIB_sfire-dsc-6.5.0_linux_x86_64.sh

3. Type y to accept the license agreement.

   If you type n, the installer exits.

   The installer prompts you for the installation directory.
4. Provide the installation directory for the installation you are upgrading from.
5. When the installer completes the installation, and before you start the Team Studio server, perform the following steps.
   1. Place the file chorus.license in the $CHORUS_HOME/shared directory
   2. Review and customize the properties listed in the file chorus.properties.

      Specifically, set the property workflow.url = http://localhost:9090/. See Team Studio Configuration Properties for more information.

6. Add the following items to the file ~/.bashrc.

   This step is required because the installer cannot write to the this file.

   # User specific environment and startup programs
   PATH=$PATH:$HOME/bin
   export JAVA_HOME=[/path/to/jdk1.7]
   # default CHORUS_HOME=/usr/local/chorus
   export CHORUS_HOME=[/path/to/installation/directory] 
   # default CHORUS_DATA=/data/chorus
   export CHORUS_DATA=[/path/to/data/directory]
   export PATH=$PATH:$JAVA_HOME/bin
   export PATH

7. In the file $CHORUS_HOME/shared/chorus.properties, verify the following Java options.

   java_options = -Djava.security.egd=file:/dev/./urandom -server -Xmx4096m -Xms2048m -Xmn1365m -XX:MaxPermSize=256m -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -XX:ParallelGCThreads=3 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=./ -XX:+CMSClassUnloadingEnabled

8. Ensure you specify enough Jetty threads.
   1. Check the number of cores specified in the file /proc/cpuinfo. In the following example, we have 8 processors, zero actual cores, and 8 processing units.

      $ cat /proc/cpuinfo | grep processor
      processor   : 0
      processor   : 1
      processor   : 2
      processor   : 3
      processor   : 4
      processor   : 5
      processor   : 6
      processor   : 7
      $ cat /proc/cpuinfo | grep 'core id'
      $ cat /proc/cpuinfo | grep processor | wc -l
      8

   2. If the server has more than 16 processors, in each of the following jetty.xml files, modify the maxThreads to 140.
      • $CHORUS_HOME/current/vendor/jetty/jetty.xml
      • $CHORUS_HOME/current/vendor/jetty/etc/jetty.xml

      <Set name='maxThreads'>140</Set>

9. If you have a Team Studio installation from 2017 or earlier, when you upgrade to version 6.3.2 or later, in the file alpine.conf, modify the default output directories to the following values.

   alpine.hdfs.output.dir=tsds_out/
   alpine.hdfs.runtime.dir=tsds_runtime/
   alpine.hdfs.model.dir=tsds_model/