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.

Warning
title Installation prerequisites Prerequisites

To run the Web Application Platform with plugins:

  • You must have a working instance of Teamwork Cloud.
  • You have to obtain the Web_App_Platform_<version number>_noinstall.zip file. Contact your sales executive to get the file.


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


  1. Extract the Web_App_Platform_<version number>_noinstall.zip file
  2. Go to the <Web_App_Platform_no-installer_directory>/shared/conf directory.
  3. Open the webappplatform.properties file. The content of the file is shown below.

    Code Block
    linenumberstrue
    # General properties
     
     
    install.root=.
     
     
    # Web Application Platform properties
     
    
    wap.context=/webapp
    # Specify a guest user name. You can create users using TWC Admin Console.
    wap.guest.username=Guest
    # Specify the guest user password.
    wap.guest.password=Guest
     
     
    # Authentication server properties
     
     
    # Specify the Authentication server location. Use http or https depending on the Authentication server setup.
    authentication.server.uri=https://<nm_authentication_server_ip>:8555/authentication
    # Specify an optional redirect uri if the incoming request does not provide one.
    # By default redirect uri is the authentication server location. Remove # for the property to work.
    #authentication.redirect.uri=https://<nm_authentication_server_ip>/webapp/
    # Specify a unique platform ID.
    authentication.client.id=webApplicationPlatform
    # Specify the authentication client password that platform will use to secure communication with the authentication server.
    authentication.client.secret=CHANGE_ME
    # Set to true to ignore Authentication server certificate validation. Otherwise, set to false.
    # The value depends on the Authentication server setup.
    authentication.server.ignore.certificate=true
     
     
    # Teamwork Cloud server properties
     
     
    # Specify the Teamwork Cloud administrator user name.
    twc.admin.username=Administrator
    # Specify the Teamwork Cloud administrator password.
    twc.admin.password=Administrator
    # Specify the Teamwork Cloud server address. Use http or https depending on the Teamwork Cloud server setup.
    twc.url=https://<teamwork_cloud_ip>:8111
    # Specify the maximum total number of connections.
    twc.client.max.total.connections=20
    # Specify the maximum number of connections for a route.
    twc.client.max.connections.per.route=20
    # Specify how long (in milliseconds) to wait for establishing the connection with the remote server before a timeout exception occurs.
    twc.client.connect.timeout.ms=30000
    # Specify how long (in milliseconds) to wait for the server to respond to various calls before a timeout exception occurs.
    twc.client.socket.timeout.ms=120000
    # Specify how long (in milliseconds) to wait for checking out a connection from the connection pool before an exception occurs.
    twc.client.connection.request.timeout.ms=120000
    # Set to true to ignore Teamwork Cloud certificate validation. Otherwise, set to false.
    twc.client.ignore.certificate=true
     
     
    # FlexNet server properties
     
     
    # Specify the FlexNet licence server IP address.
    flexnet.server.name=<server_ip>
    # Specify the FlexNet license server port.
    flexnet.server.port=<server_port>
     
     
    # Platform mailing engine properties used to send notifications via e-mail
     
     
    # Specyfy the e-mail server host name.
    mail.host=<gate.company.com>
    # Specify the e-mail server port.
    mail.port=25
    # Specify the sender's user name and password.
    mail.username=<user_name>
    mail.password=<password>
    # Specify the e-mail protocol and encoding.
    mail.protocol=smtp
    mail.encoding=UTF-8
    # Specify the sender's e-mail address.
    mail.from.default=<info@company.com>
    mail.from.enabled=false
    mail.smtp.auth=false
    mail.smtp.timeout=30000
  4. Read the comments with property descriptions inside the file and specify the following:

    • Web Application Platform properties
    • Teamwork Cloud server properties
    • Authentication server properties
    • FlexNet server properties
    Note
    titleSpecifying property values
    • Make sure you replace the placeholders in the angle brackets (<>) with actual values (e.g., Teamwork Cloud and Authentication server addresses)
    • Some properties are specified for you. You can leave their values unchanged.
    • Platform mailing engine properties are optional. You can specify them later if needed.
  5. Go to the <Web App Platform no-install directory>/conf directory.
  6. Open the catalina.properties file and edit the following property value as shown below:

    Code Block
    shared.loader="${catalina.base}/shared/conf"
  7. 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>
  8. Generate the SSL certificate file.
  9. Go to the <Web_App_Platform_no-installer_directory>\conf directory and open to edit the server.xml file.
  10. In the server.xml file, change the default values of the following properties to the actual path to 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.
  11. Go to the <Web App Platform no-install directory>/bin directory.
  12. Run the startup.bat file as administrator to start Web Application platform.


Now you can access Web Application Platform by opening a web browser and going to http(s)://<domain_name>:<port>/webapp/resources. By default, Web Application Platform uses the port 8443. Click here, to learn how to start and stop 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. Open the Terminal application.
  2. Execute the following command:

    Code Block
    export JRE_HOME=/<Java_install_directory>
    
    Tip
    titleCommand example

    export JRE_HOME=/usr/java/jdk1.8.0_172-amd64/

  3. Execute the following command:

    Code Block
    export CATALINA_HOME_WEBAPP=/<Web_App_Platfrom_extratcted_no-installer_directory>
    Tip
    titleCommand example
    export CATALINA_HOME_WEBAPP=/Users/admin/Desktop/Web_App_Platform_190_noinstall
  4. Close the Terminal application.