View Source

On this page

Here, you can learn how to run Web Application Platform with its service by using the no-installer package.

Before starting, you should know the following:

It is recommended to run Web Application Platform and Teamwork Cloud on different machines.
Before running 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>/TeamworkCloud/configuration directory).
If Web Application Platform runs on a separate machine, it is recommended to stop the WebApp service on the machine where Teamwork Cloud is running.
You can run Authentication service or other services in different environments for scalability.

Prerequisites

Before running the Web Application Platform with services, you need to:

Have a working instance of Teamwork Cloud.
If you intend to use the Cameo Collaborator for Teamwork Cloud service, make sure that DSLS or the FlexNet license server is installed beforehand.
Download the Web_App_Platform_<version number>_<operating_system>_no_install.zip file.
If you use Linux, increase the open file limit for the OS or Web Application Platform/Tomcat to a minimum of 20 000 files.

Running Web Application Platform with no-install package

To run Web Application Platform by using the no-install package

Download and extract the Web_App_Platform_<version number>_<operating system>_no_install.zip file.
Open for editing the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/webappplatform.properties file, 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
Open for editing the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/authserver.properties file, read the comments with property descriptions, and specify the following:
- General properties
- Keystore properties
Copy the keystore.p12 file from Teamwork Cloud server (<install_root>/CATIANoMagicServices/TeamworkCloud/configuration) to Web Application Platform folder<no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf.

Web Application Platform is released with pre-configured SSL certificates and keystore.
Perform this step only if you need to change the default values when the keystore file name, path, or password changes.

Go to the <no-install_root>/CATIANoMagicServices/WebAppPlatform/conf directory and open the server.xml file.
In the server.xml file, specify the following properties (use the same certificate file that is used in Teamwork Cloud):
- certificateKeystoreFile="./shared/conf/keystore.p12"
- certificateKeystorePassword="nomagic"
- type="RSA" />

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

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 http(s)://<domain_name>:8443/webapp.