NEW RELEASE! The 2022x Refresh2 Hot Fix 3 was released on February 28, 2025. For more information, see 2022x Refresh2 Hot Fix 3 Version News.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Download and install the web server on which 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. 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
  4. If you want to install the Authentication server (authentication.war) together with Web Application Platform, do the following:
    1. Copy the KeyStore file to the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/ directory.
    2. Open for editing the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/authserver.properties file, read the comments with property descriptions, and specify the following:
  5. Place the following files into the location that is on the classpath of the web server 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 Magic Collaboration Studio (collaborator.war) and/or document exporter (document-exporter.war))

      Tip
      titleExample

      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.


  6. Deploy the desired web applications, e.g., webapp.war, admin.war, collaborator.war, resources.war, etc.
  7. Open a web browser and navigate to http(s)://<host>:<web_server_port>/<platform_root>/. You should see a blank page.

  8. If you chose to install Cameo Collaborator for Magic Collaboration Studio, apply the Cameo Collaborator for Magic Collaboration Studio license.

...