Here, you can learn how to run Web Application Platform with its service by using the no-installer package.
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 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.
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 FlexNet 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.
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
- If you want to use the Authentication server in the same environment as Web Application Platform, open for editing the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/authserver.properties file, read the comments with property descriptions, and specify the following:
- If you want Web Application Platform to use SSL certificates, do the following:
- Generate the SSL certificate file.
- Go to the <no-install_root>/CATIANoMagicServices/WebAppPlatform/conf directory and open to edit the server.xml file.
- In the server.xml file, change the default values of the following properties to the actual path to the certificate file and password:
certificateKeystoreFile="<path_to_certificate_file>"
certificateKeystorePassword="<password>"
Important
The certificateKeystorePassword property value must be the same as the -storepass and -keypass property values that you specified when creating the SSL certificate.
- Start Zookeper.
- Go to the <no-install_root>/CATIANoMagicServices/WebAppPlatform/bin directory and run the startup.bat file as administrator to start Web Application Platform.
To access Web Application Platform, open a web browser and go to http(s)://<domain_name>:<port>/webapp.
Starting Web Application Platform manually
If you want to start Web Application Platform, start Zookeeper first and only then - Web Application Platform.