On this page
The installation of Magic Collaboration Studio 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 Magic Collaboration Studio services
To install Magic Collaboration Studio 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 Magic Collaboration Studio 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 Magic Collaboration Studio 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 Magic Collaboration Studio is operational by going to https://<server_address>:8443/webapp. You should see the Magic Collaboration Studio login screen.
For more information, see Accessing Magic Collaboration Studio 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.