Installing Quick Start

For a basic installation, follow these steps.

Perform this task on a dedicated Linux server.

Prerequisites

  • You must install on a Linux platform. See System Requirements for more information.
  • You must have root access.

Procedure

  1. Unzip the Team Studio download file into the home folder, for example /home/dsts.
  2. Verify the integrity of the installer file by running the following commands. (Compare the output to make sure it matches.)
    cat CHECKSUM
    md5sum TIB_sfire-dsc-6.5.0_linux_x86_64.sh
    
  3. Make the installer executable by running the following command.
    chmod +x TIB_sfire-dsc-6.5.0_linux_x86_64.sh.
  4. As the root user, run ./TIB_sfire-dsc-6.5.0_linux_x86_64.sh.
    Note: If the installer fails with the following message
    -bash: ./TIB_sfire-dsc-6.5.0_linux_x86_64.sh: /bin/sh: bad interpreter: File too large
    
    
    then as a workaround, run the following instead.
    bash ./TIB_sfire-dsc-6.5.0_linux_x86_64.sh
    This error is caused by the installer's large file size on some systems.
    The license agreement is displayed.
  5. Type y to continue.
  6. Specify the user that should run Team Studio processes.
    By default, this user is named chorus.
  7. Enter the full path to the Team Studio installation directory and Team Studio data directory. By default, they are set to /usr/local/chorus and /data/chorus. Keep in mind that any directory you choose must be writable by the user. Verify the amount of free space on your volume by running df -h.
    This key is stored as server.key in the shared data directory. By default this path is /usr/local/chorus/shared/server.key.
  8. Enter your passphrase.
    Your passphrase can be any combination of alphanumeric characters. This passphrase is used to generate a secret key to use to recover passwords from the database. Write it down and keep it in a safe place.
  9. Choose whether to install the Team Studio workflow editor.
    The installer performs a series of checks for a supported operating system version, the running user, and the Java version. If these requirements are not met, the installer quits.
    When the installer completes, it displays a message indicating a successful installation.
    Team Studio successfully installed:
    Install Directory: /usr/local/chorus
    Data Directory: /data/chorus
    Version: <version>
    Would you like to modify the system settings for Team Studio?
    System settings can be modified later by executing chorus_control.sh configure.  [y/N]:
    Further information on these configuration options can be found at Team Studio Configuration Properties.
  10. Run the command source chorus_path.sh.
    This command sets necessary environment variables
  11. Switch to the user that was created to run Team Studio processes.
    By default this user is chorus.
  12. Put your chorus.license in the $CHORUS_HOME/shared directory.
  13. Ensure the temporary file location is set to alpine.java.io.tmpdir=$CHORUS_DATA/tmp in deploy.properties.

What to do next

In your $CHORUS_HOME directory, start Team Studio, change to the chorus user by running su - chorus, and then type ./chorus_control.sh start .