Installing Web Application Platform manually

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 can run on the following third-party web containers that work with Java 17:

• Apache Tomcat
• GlassFish
• WildFly
• Eclipse Jetty
  
  

To install the Web Application Platform

1. Download and install a Java application server or servlet container on which the Web Application Platform will run. For installation instructions, see the documentation of the server you intend to install.
2. Download and extract the Web_App_Platform_<version number>_<operating system>_no_install.zip file.
3. Go to the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf directory.

4. Open to edit the webappplatform.properties file, read the comments with property descriptions inside the file, and specify the following:

   • Web Application Platform properties
   • Authentication server properties
   • Teamwork Cloud server properties
   • FlexNet/DSLS server properties
     
   • Platform service discovery-related properties
5. If you want to install the Authentication server (authentication.war) together with Web Application Platform, do the following:
   1. Go to the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf directory.
   2. Open to edit the authserver.properties file, read the comments with property descriptions, and specify the following properties:
      
      • Data source properties
      • General properties
      • Keystore properties
6. Place the following files into the location that is on the classpath of the web application container you have installed:
   • <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/webappplatform.properties file
   • <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/authserver.properties file (if you plan to install the Authentication server (authentication.war))

   • <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/data directory containing email notifications and document exporter templates (if you plan to install Cameo Collaborator for Teamwork Cloud (collaborator.war) and/or document exporter (document-exporter.war))

     Example

     If you have installed Apache Tomcat 10.1 or a later version, you can choose from the following options (refer to server documentation for all available options):

     • Place the webappplatform.properties file in the <tomcat_home>/shared/conf directory. Then open the <tomcat_home>/conf/catalina.properties file and set the shared.loader property as shared.loader="<catalina_base>/shared/conf".
     • Place the webappplatform.properties file in a custom directory. Add the path to the directory to the list of shared classloader paths defined by the "shared.loader" property in the ${tomcat.home}/conf/catalina.properties file. 

     If you have installed a different web application server, refer to its user manual.

7. Deploy the desired web applications, e.g., webapp.war, admin.war, collaborator.war, resources.war, etc.

8. Open a web browser and navigate to http(s)://<host>:<container_port>/<platform_root>/. You should see a blank page.

9. If you chose to install Cameo Collaborator for Teamwork Cloud, apply the Cameo Collaborator license.

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

Related pages

• Installing Web Application Platform on Windows
• Installing Web Application Platform on Linux with GUI