Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Content layer
id685410269
Content column
id685410271
Content block
id685455285

On this page

Table of Contents
maxLevel4

Content block
id685410270

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

Note
titlePrerequisites

Before running the Web Application Platform with plugins:

  • You must have a working instance of Teamwork Cloud.
  • If you intend to install the Cameo Collaborator for Teamwork Cloud application, make sure that the FlexNet license server is installed beforehand.
  • Download the Web_App_Platform_<version number>_noinstall.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:

  • Web Application Platform and Teamwork Cloud should be installed on different machines.
  • Before installing Web Application Platform, make sure you know Teamwork Cloud, Authentication server, and FLEXnet server data, such as the hostname (or IP address) and port. You will need to enter this data during installation.
  • After installing Web Application Platform, it is recommended to disable the web container (e.g., Apache Tomcat) on the machine where Teamwork Cloud is installed.



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. Go to the <no-install_root>/shared/conf directory.
  3. Open to edit the webappplatform.properties file, read the comments with property descriptions, and specify the following:

    • Web Application Platform properties
    • Teamwork Cloud server properties
    • Authentication server properties
    • FlexNet server properties
    • Platform service discovery-related properties
  4. In your computer settings, specify the JRE_HOME and CATALINA_HOME_WEBAPP variables as shown below:

    Code Block
    CATALINA_HOME_WEBAPP=/<Web_App_Platform_no-installer_directory>
    JRE_HOME=/<Java_install_directory>
  5. If you want Web Application Platform to use SSL certificates, do the following:
    1. Generate the SSL certificate file.
    2. Go to the <no-install_root>/conf directory and open to edit the server.xml file.
    3. 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>"
      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.
  6. Start Zookeper.
  7. Go to the <no-install_root>/bin directory and run the startup.bat file as administrator to start Web Application platform.
  8. If you chose to install 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.

Info
titleStarting 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 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=/<Web_App_Platform_extracted_no-installer_directory>
    JRE_HOME=/<Java_install_directory>
  5. Click OK.


System variables in the Environment Variables dialog on Windows


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-installer_directory>
    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