On this page
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 install 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 the installation, you should know the following:
- It is recommended to run Web Application Platform and Teamwork Cloud on different machines.
- Before running Web Application Platform, note down Teamwork Cloud, the Authentication server, and FlexNet server data, such as the hostname (or IP address) and port.
- 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.
- Go to the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf directory.
Open to edit the 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
In your computer settings, specify the JRE_HOME and CATALINA_HOME_WEBAPP variables as shown below:
CATALINA_HOME_WEBAPP=/<no-install_root> JRE_HOME=/<Java_install_directory>
- 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.
- If you installed Cameo Collaborator for Teamwork Cloud, apply the Cameo Collaborator license.
To access Web Application Platform, open a web browser and go to http(s)://<domain_name>:<port>/webapp. By default, Web Application Platform uses port 8443.
Starting Web Application Platform manually
If you want to start Web Application Platform, start Zookeeper first and only then - Web Application Platform.
Specifying JRE_HOME and CATALINA_HOME_WEBAPP variables
In this section, you can learn how to specify the JRE_HOME and CATALINA_HOME_WEBAPP variables in different operating systems.
To specify variables on Linux
- Go to the /etc directory and open the profile file.
Copy the following lines to the profile file and replace the placeholders between angle brackets (<>) with actual paths:
export CATALINA_HOME_WEBAPP=/<path_to_Web_App_Platfrom_extratcted_no-install_root> export JRE_HOME=/<path_to_Java_install_directory>
Variable examples
export CATALINA_HOME_WEBAPP=/Users/admin/Desktop/Web_App_Platform_190_noinstall
export JRE_HOME=/usr/java/jdk1.8.0_172-amd64/
Open the Terminal application and execute the following command:
source /etc/profile
To specify variables on Windows
- Open Control Panel and go to System and Security > System.
- Select the Advanced system settings option on the left side of the System dialog.
- In the System Properties dialog, click the Environment Variables button.
In the System variables area of the Environment Variables dialog, specify the values for the JRE_HOME and CATALINA_HOME_WEBAPP variables as shown below:
CATALINA_HOME_WEBAPP=/<no-install_root> JRE_HOME=/<Java_install_directory>
- Click OK.