The content of this chapter is intended for system administrators. Here, you can learn how to install and configure Web Application Platform with Cameo Collaborator and other services by using the command-line interface.

Installation prerequisites and other important information

Before installing Web Application Platform with services, you need to:

  • Have a working instance of Teamwork Cloud.
  • If you intend to install the Cameo Collaborator for Teamwork Cloud service, make sure that DSLS or the FlexNet license server is installed beforehand.
  • 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.
  • Increase the open file limit for the OS (or for Web Application Platform/Tomcat) to a minimum of 20 000 files.
  • Have access to the keystore file with the same certificate that is used in Teamwork Cloud for authentication configuration.

Before starting the installation, you should know the following:

  • We recommend installing Web Application Platform and Teamwork Cloud on different machines.
  • Before installing Web Application Platform, make sure to note down Zookeeper, Cassandra, Teamwork Cloud, and the license server information (e.g., hostname and port), as well as the keystore file location (you can find it in the <install_root>/Certs directory). You will need this data during installation.
  • After installing Web Application Platform, it is recommended to stop the WebApp service on the machine where Teamwork Cloud is installed.


To install Web Application Platform and services (advanced installation)

  1. Open the terminal and go to the directory where the <product_name>_<version number>_installer_linux64.bin file and script are stored.

  2. Install Web Application Platform with services by executing the install_twc_mcs_ol_rhel.sh script.

    sudo ./install_twc_mcs_ol_rhel.sh
    SHELL

  3. When the introduction to Teamwork Cloud installation is displayed, press Enter to continue.

  4. Select the Advanced installation option and press Enter. (Example: Type "2" and press Enter.)
  5. Deselect Teamwork Cloud and press Enter. (Example: Type "1" and press Enter.)
    There should be only one ZooKeeper running for one deployment. You can choose to deploy on the Teamwork Cloud server or Web Application Platform server.
  6. Specify the location where you want to install Web Application Platform Services:
    • Press Enter to use the default installation directory.
    • Enter the full path to the installation directory and press Enter.
  7. Press Enter to install all available services, or type a comma-separated list of numbers to choose the services you need to install.
  8. Follow the on-screen installation instructions.
  9. When the pre-installation summary is displayed, check if properties are specified correctly, and press Enter to start the installation.
  10. When Web Application Platform Services is successfully installed, press Enter.
  11. If you want to start the WebApp service right after installation, type "2". Otherwise, press Enter.
  12. If you installed the Cameo Collaborator for Teamwork Cloud service, apply the Cameo Collaborator license.

Web Application Platform is now installed with the selected services. For information on how to start Web Application Platform, refer to Starting and Stopping Web Application Platform. To access Web Application Platform, open a web browser and go to https://<domain_name>:<port>/webapp.


Scripts for upgrading Java and Tomcat in the Linux environment: