Installing services

The installation of product 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.

For a complete list of service files, please see Web Application Platform services.

Prerequisites

OpenJDK Java 21.0 (see system requirements for version information)

Installing product services

To install product services

Install Java 21 from Adoptium. As an alternative, the OpenJDK Java provided in the base Linux package repository can be used:
```
sudo dnf install -y java-21-openjdk
```
BASH
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
```
BASH
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
```
BASH
Make sure that Magic Collaboration Studio is operational by going to https://<server_address>:8443/webapp. You should see the login screen.

For more information, see Accessing web applications.

When you complete the steps above, the preliminary product configuration is created. This means that your system is functional and you can log in to Magic Collaboration Studio . 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 Microsoft TrueType font package is required in order to generate PDF/HTML files. Please see Installing Microsoft TrueType fonts for Document Exporter.