Installing TIBCO Data Science - Team Studio

Before you begin
  1. Install TIBCO Data Science - Team Studio on a Linux platform. See System Requirements for more information.
  2. Docker Engine must be installed in your system. See System Requirements for more information.
  3. You must have a Linux user (for example, tds), and the user must belong to your Docker Linux group. The system administrator can also create a Linux user. Use the following command to add the user to your Docker Linux group.
    $ sudo usermod -aG docker $USER

    For more information, see the Docker documentation.

  4. Download the TIBCO Data Science - Team Studio installer package from TIBCO eDelivery to your local machine.
    Procedure
  1. Switch user to provide ownership for installing TIBCO Data Science - Team Studio (for example, tds).
    $ su - tds
    Note: You can switch to any user to install TIBCO Data Science - Team Studio. The user must belong to your Docker Linux group.

  2. Create an installer directory and a downloads directory.

    $ mkdir -p installers downloads

  3. Configure your shell environment for the user.

    1. Update the .bash_profile.

      $ echo "export PATH=\$HOME/installers/current/harness:\$PATH" >> ~/.bash_profile

    2. Reload the .bash_profile.

      $ source ~/.bash_profile
  4. Copy the TIBCO Data Science - Team Studio downloaded file (for example, tds-installer-7.1.0.tgz) to the downloads directory.

  5. Extract the TIBCO Data Science - Team Studio installer file to the installers directory.

    $ tar xvfz downloads/tds-installer-x.x.x.tgz -C installers
    Note: Here x.x.x is the version of the TIBCO Data Science - Team Studio installer package. So, if you are extracting the installer package version 7.0.0, enter the following command: 
    $ tar xvfz downloads/tds-installer-7.0.0.tgz -C installers

    You can download various versions of the TIBCO Data Science - Team Studio installer from TIBCO eDelivery and extract them to the installers directory. Now, you can browse the following directory structure for upgrades and downgrades of TIBCO Data Science - Team Studio.

    /$HOME
    ├── downloads
    │   └── tds-installer-7.0.0.tgz
    │   └── tds-installer-7.0.x.tgz
    │   └── tds-installer-7.x.x.tgz
    └── installers
        ├── current -> tds-installer-7.0.0
        ├── tds-installer-7.0.0
        ├── tds-installer-7.0.x
        ├── tds-installer-7.x.x

  6. Link the current TIBCO Data Science - Team Studio installer.

    $ ln -snf tds-installer-x.x.x installers/current
    Note: Here x.x.x is the version of the TIBCO Data Science - Team Studio installer. So, if you are installing version 7.0.0, enter the following command: 
    $ ln -snf tds-installer-7.0.0 installers/current
  7. To configure the TIBCO Data Science - Team Studio platform, perform the following steps:

    1. Use the following command line to start the configuration.

      $ tds platform configure

    2. Specify the target for installing the software. The default is docker-local.

    3. Specify whether you want to install the R Connector.

    4. Specify whether you want to install the Notebooks. If yes, then specify if you want any additional Python packages. For example, pip:theano, conda:matplotlib=3.5.1, and so on.

    5. A private encryption key is generated for encrypting or decrypting the sensitive data. The encryption key is stored in the following path:

      resources/tds-chorus/secret/data_encryption_password

      Note: Use the following command line to copy the encryption key.
      cp resources/tds-chorus/secret/data_encryption_password /home/tds/encryption.key

      Place the generated encryption key in all the nodes of the Spark cluster in the directory /etc/tds. It must be accessible to the user submitting the Spark jobs.

    6. A .car file for integrating the TIBCO Data Virtualization with TIBCO Data Science - Team Studio is generated. The file is stored in the following path:

      build/tds-datavirt

      For more information on integration, see Integrating TIBCO Data Virtualization with TIBCO Data Science - Team Studio.

    7. Manage your Domain Name System (DNS).

      1. Enter your DNS name.

        Note: Do not use an underscore (_) in the DNS hostname.

      2. Specify whether you want to enable the Transport Layer Security (TLS). If yes, enter the following details:

        1. Path of the TLS digital certificate.

        2. File path of the TLS private key.

    All the answers to the questionnaire are saved to the default environment file.

    ./tds/installers/current/default.env
    Note: If you do not want to go through the interactive questionnaire, enter the following command:
    $ tds platform build –env-file/path/to/my-custom.env

  8. Build the Docker container images.

    $ tds platform build

  9. Now, deploy the build. This command starts the application.

    $ tds platform start
    Note: Before performing the next step, wait for 5 minutes for the containers to boot.

  10. Use the following command line to create all the base operator.

    $ tds platform seed

  11. If you are using NFS as a shared drive, create a directory for the Jupyter Notebook configuration, and then add the following lines to the tds-notebook section of the compose file generator in the installer located at $HOME/installers/current/compose/fragments. 

    -target: /<directory_path>
 source: /<directory_path>
 type: bind

  12. Restart the TIBCO Data Science - Team Studio application.

  13. Log in as siteadmin using the default password, and then change your default password.