On this page
The installation of Teamwork Cloud services and initial configuration is described in this section. Installation using the provided script is highly recommended. The process involves installing the service(s), generating an initial self-signed SSL certificate, creating the twcloud user for file and service ownership, then configuring the Linux environment for performance and security.
Prerequisites
- OpenJDK Java 17.0 (see system requirements for version information)
Installing Teamwork Cloud services
To install Teamwork Cloud services
Install Java 17 from Adoptium. As an alternative, the OpenJDK Java provided in the base Linux package repository can be used:
sudo dnf install -y java-17-openjdk
- Download and extract the installation file from the 3DS media package (<product_name>_<version_number>_installer_linux64.bin). Place the installation file and script in an executable directory.
Install Teamwork Cloud by executing the install_twc_mcs_ol_rhel.sh script.
sudo ./install_twc_mcs_ol_rhel.sh
- Follow the on-screen installation guidance.
When the Teamwork Cloud pre-installation summary is displayed, check if the information is correct and press ENTER.
- After installation is complete, optionally setup shortcuts and utilities for Admin Tools.
If Admin Tools was set up, execute twc-start.sh to start all services. Otherwise, manually start twcloud, zookeeper, and webapp services with the command:
sudo systemctl start twcloud zookeeper webapp
Make sure that Teamwork Cloud is operational by going to https://<server_address>:8443/webapp. You should see the Teamwork Cloud login screen.
For more information, see Accessing Teamwork Cloud web applications.
When you complete the steps above, the preliminary Teamwork Cloud configuration is created. This means that your system is functional and you can login to Teamwork Cloud. Refer to the section below for additional configurations and troubleshooting.
Additional configuration and troubleshooting
| Topic | Reference |
|---|---|
| Remote Cassandra node | In application.conf (shortcut: conf-twc), set the contact-points parameter to Cassandra node address. |
| Multi-server deployment | See Advanced services configuration. |
| System Error displayed on web browser | See FAQ entry. |
| Change SSL certificate | See Managing SSL certificate. |
| Update Administrator password | See Setting up Administrator user. |
Document exporter font package
To use Cameo Collaborator document exporter, a TrueType font package is required in order to generate PDF/HTML files. Please see Installing Microsoft TrueType fonts for Document Exporter.