Install or upgrade Tenfold Cloud Connect (TCC) for RedHat Linux

Before installing Tenfold Cloud Connect (TCC), ensure that your system meets these requirements.

Install TCC for RedHat Linux

  1. Download the RPM package for your version of RedHat Enterprise Linux (RHEL) from Tenfold. You can use the following curl command:

    curl -O https://downloads.tenfold.com/app/tcc/tcc-<tcc_version>.x86_64-rhel<OS_version>.rpm

    Refer to tenfold.com/downloads to find the correct version of TCC for your deployment.

  2. To install a particular TCC version, you can install the RPM package using this command:

    sudo rpm -ivh tcc-<tcc_version>.x86_64-rhel<OS_version>.rpm

    After you install the RPM package, the /opt/tenfold/tcc/version/<tcc_version> directory is created.

  3. Activate the newly installed version of TCC by running this script:

    sudo /opt/tenfold/tcc/versions/<tcc_version>/tcc-version-selector.sh

  4. If this is the first TCC installation, then you need to update the configuration.

    sudo vi /opt/tenfold/tcc/config.properties

    At minimum, change app.org.id to your org ID:

    ConfigureTCCProperties.png

    Restart the server after making any configuration changes using the following command:

    sudo service tcc restart

  5. At this point, it is a good idea to check the logs to ensure that there were no errors when TCC restarted. You can find this information in the TCC logs, located at /opt/tenfold/tcc/logs/tcc.log.

    Run the following command to check whether TCC restarted successfully:

    sudo tail -f /opt/tenfold/tcc/logs/tcc.log

    Your output should resemble the following:

    TCCLogsConfirmInstallationSuccessful.png

Add additional TCC instances to a server

You can add additional TCC instances to a server to test a new environment, to test with or evaluate rolling out to a separate group, or other reasons. TCC supports one to many instances on a single server.

Prerequisite: You have installed at least one working TCC instance using the instructions shown above.

In the following instructions, tcc-<new_instance> is a placeholder for the name you want to use for your new TCC instance.

  1. At the command line, type the following command to copy the existing TCC directory:

    cp -rf /opt/tenfold/tcc /opt/tenfold/tcc-<new_instance>

  2. Navigate to the new folder:

    cd /opt/tenfold/tcc-<new_instance>

  3. Open a text editor and edit the configuration file. You can use the text editor of your choice. This is the command for using vi:

    sudo vi config.properties

  4. Update the config properties.

    If you are using vi, type "i" to enter insert mode.

    1. Change the port to a unique port.

    2. Update the org id to your Tenfold org id.

    3. Change app.instanceid to an app instance ID of your choosing.

    TCCConfiguration.png

  5. Save your changes and exit.

    If you are using vi, press ESC and then type:

    :wq!

  6. Update the logback.xml (located here: /opt/tenfold/tcc/logback.xml) file to include the path to the new directory you made.

    You can use this command to open the xml file in vi:

    sudo vi logback.xml

    Change the paths shown in the screenshot to the path to your new directory:

    EditLogbackXml.png

  7. Copy the service by entering the following command:

    cp /etc/systemd/system/tcc.service /etc/systemd/system/tcc-<new_instance>.service

  8. Use a text editor to edit the service file (located here: /etc/systemd/system/tcc-example.service) so all paths highlighted in the image below point to the directory for the new TCC instance.

    To use vi, type this command:

    sudo vi /etc/systemd/system/tcc-<new_instance>.service
    UpdatePathsInServiceFile.png

  9. Restart the services by typing this command:

    sudo service tcc-<new_instance> restart

    When the command line cursor comes back and starts blinking, the instance is running.

Upgrade TCC

  1. Download the RPM package for your version of RedHat Enterprise Linux (RHEL) from Tenfold. You can use the following curl command:

    curl -O https://downloads.tenfold.com/app/tcc/tcc-<tcc_version>.x86_64-rhel<OS_version>.rpm

    Refer to tenfold.com/downloads to find the correct version of TCC for your deployment.

  2. Install the RPM package:

    sudo rpm -ivh tcc-<tcc_version>.x86_64-rhel<OS_version>.rpm

    After you install the RPM package, the /opt/tenfold/tcc/version/<tcc_version> directory is created.

  3. Activate the newly installed version of TCC by running this script:

    sudo /opt/tenfold/tcc/versions/<tcc_version>/tcc-version-selector.sh

    TCC restarts.

  4. At this point, it is a good idea to check the logs to ensure that there were no errors when TCC restarted. You can find this information in the TCC logs, located at /opt/tenfold/tcc/logs/tcc.log.

    Run the following command to check whether TCC restarted successfully:

    sudo tail -f /opt/tenfold/tcc/logs/tcc.log

    Your output should resemble the following:

    TCCLogsConfirmInstallationSuccessful.png

Upgrade multiple TCC instances

  1. Complete the steps in the Upgrade TCC section.

  2. Navigate to the tcc directory:

    cd /opt/tenfold/tcc

  3. Run this command to display the path details of the latest binary:

    ls -l

    The output displays as follows:

    tcc.jar -> /opt/tenfold/tcc/versions/3.0.0/tcc-3.0.0-fat.jar
In this section: