The content of this chapter is intended for system administrators. Here, you can learn how to install and configure Web Application Platform and its services without using the installer file.

Web Application Platform, with its services, is bundled with Apache Tomcat (this application should work in similar environments such as GlassFish, WildFly, and Eclipse Jetty).

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.
  • For deployment on Linux, 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.
  • Extract the <product_name>_<version_number>_linux64.zip file.
  • Extract the Web_Application_Platform_<version number>_war_files.zip file, which includes the Web Application Platform service files.

Before starting the installation, you should know the following:

  • We recommend installing Web Application Platform and Teamwork Cloud on different machines.
  • Before installing the Web Application Platform, ensure that you note down the following information: ZooKeeper, Cassandra, Teamwork Cloud, and the license server information (e.g., hostname and port), as well as the keystore file location (located in the <install_root>/Certs directory). You will need this data during the installation process.
  • If you have an all-in-one deployment, then it is highly recommended to stop and disable the WebApp service on the machine where Teamwork Cloud is installed.


To install Web Application Platform

  1. Open the <install_root>/WebAppPlatform/shared/conf/webappplatform.properties file for editing, read the comments with property descriptions, and specify the following:
    • Web Application Platform properties
    • Authentication server properties
    • Teamwork Cloud server properties
    • FlexNet/DSLS server properties
    • Platform service discovery-related properties
  2. To configure the Authentication server (authentication.war), a part of the Web Application Platform, do the following:
    1. Copy the keystore file to the <install_root>/Certs/ directory
    2. Open for editing the <install_root>/WebAppPlatform/shared/conf/authserver.properties file, read the comments with property descriptions, and specify the following:
  3. Edit the following files:
    • <install_root>/WebAppPlatform/shared/conf/webappplatform.properties
    • <install_root>/WebAppPlatform/shared/conf/authserver.properties
  4. Copy all web applications (WAR files) to <install_root>/WebAppPlatform/webapps/

    You can remove the WAR files of applications that will not be used. (Example: document-exporter.war, simulation.war...)

  5. Install the webapp service and enable it to start automatically. For example:
    service.sh install 
systemctl enable webapp 
systemctl start webapp
    CODE

For information on how to start Web Application Platform, refer to Starting and Stopping Web Application Platform. You can access Web Application Platform by opening a web browser and navigating to https://<domain_name>:<port>/webapp.