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
title

...

Before

...

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:

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.
  2. 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

...

  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:

    ...

    In your computer settings, specify the JRE_HOME and CATALINA_HOME_WEBAPP variables as shown below:

    ...

    1. Copy the keystore.p12 file from Teamwork Cloud server (<install_root>/CATIANoMagicServices/TeamworkCloud/configuration) to Web Application Platform folder<no-install_root>

    ...

    1. /CATIANoMagicServices/WebAppPlatform/shared/conf.

    2. 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

    ...

      1. 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>
      
    3. Open the Terminal application and execute the following command:

      Code Block
      source /etc/profile

    To specify variables on Windows

    1. Open the Settings app and select System.
    2. On the left side of the Settings dialog, select About.
    3. In the About section, click the Advanced system settings link.
    4. In the System Properties dialog, select the Advanced tab and click the Environment Variables button.
    5. 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>
    6. Click OK.

    Image Removed

    ...

    8443/webapp.