Versions Compared

Key

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

...

id685410269

...

id685410271

...

id685455285

On this page

Table of Contents
maxLevel4

...

minLevel

...

2

...


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

Note
titleBefore you start

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

...

...

...

...

Before starting the installation, you should know the following:

Running Web Application Platform

...

with no-install package

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


  1. Download and extract the Web_App_Platform_<version number>_<operating system>_no_install.zip file.

...

  1. Open for editing the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf

...

  1. /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:

Code Block
CATALINA_HOME_WEBAPP=/<no-install_root>
JRE_HOME=/<Java_install_directory>

...

  1. Open for editing the <no-install_root>/CATIANoMagicServices/WebAppPlatform/shared/conf/authserver.properties file, read the comments with property descriptions, and specify the following:
  2. 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.

  3. Note
    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.

    1. Go to the
    1. <no-install_root>/CATIANoMagicServices/WebAppPlatform/conf

...

    1. directory and open the server.xml file.
    2. In the server.xml file,

...

    1. specify the following properties

...

    1. (use the same certificate file that is used in Teamwork Cloud):
      • certificateKeystoreFile="

...

      • ./shared/conf/keystore.p12"
      • certificateKeystorePassword=

...

Warning
titleImportant
The certificateKeystorePassword property value must be the same as the -storepass and -keypass property values that you specified when creating the SSL certificate.
      • "nomagic"
      • type="RSA" />
  1. Install the webapp service and enable it to start automatically. For example:
    Code Block
    languagebash
    themeDJango
    linenumberstrue
    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>:

...

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

  1. Go to the /etc directory and open the profile file.
  2. Copy the following lines to the profile file and replace the placeholders between angle brackets (<>) with actual paths:

    Code Block
    export CATALINA_HOME_WEBAPP=/<path_to_Web_App_Platfrom_extratcted_no-install_root>
    export JRE_HOME=/<path_to_Java_install_directory>
    
    Tip
    titleVariable examples
    export CATALINA_HOME_WEBAPP=/Users/admin/Desktop/Web_App_Platform_190_noinstall
    export JRE_HOME=/usr/java/jdk1.8.0_172-amd64/
  3. Open the Terminal application and execute the following command:

    Code Block
    source /etc/profile

To specify variables on Windows

  1. Open Control Panel and go to System and Security > System.
  2. Select the Advanced system settings option on the left side of the System dialog.
  3. In the System Properties dialog, click the Environment Variables button.
  4. 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:

    Code Block
    CATALINA_HOME_WEBAPP=/<no-install_root>
    JRE_HOME=/<Java_install_directory>
  5. Click OK.

Image Removed

System variables in the Environment Variables dialog on Windows

8443/webapp.