Installing Web Application Platform on Windows

On this page

The content of this page is intended for system administrators. Here you can learn how to install and configure Web Application Platform with Cameo Collaborator and Resource Manager and TWCloud Admin plugins developed by No Magic.

Installation for production use

To install the Web Application Platform for production use

1. Run the Web_App_Platform_<version number>_win64.exe file as an administrator to start the installation wizard.
2. Specify the location where you want to install the Web Application Platform in one of the following ways:
   
   • Use the default location suggested in the Where would you like to install? box.
   • Click Choose and select a location on your machine.
3. Click Next.
4. Select the Advanced Install radio button and click Next.

5. Select the checkboxes next to the plugins you want to install and click Next.

   Tip

   Click the plugin name to read its description on the bottom of the installation wizard or the read the plugin documentation listed below:

   • TWCloud Admin
   • Resource Usage Map
   • Resources
   • Cameo Collaborator for Teamwork Cloud

6. Specify the Teamwork Cloud hostname (or IP address), rest API port, and client API port in the appropriate boxes.

7. If your Teamwork Cloud instance does not use SSL certificates, clear the SSL checkbox. Otherwise, leave the checkbox selected.
8. Click Next.

9. Specify the Authentication server hostname (or IP address), port, and password to be used by the authentication client (the Client secret) in the appropriate boxes.

10. If your Authentication server instance does not use SSL certificates, clear the SSL checkbox. Otherwise, leave the checkbox selected.

11. Click Next.

12. Specify the FLEXnet server hostname (or IP address) and port in the appropriate boxes.

13. Click Install.

14. When you get the notification that Web Application Platform is successfully installed, click Next.
15. If you do not want to start Web Application Platform after exiting the installation wizard, clear the Start Web Application Platform as service checkbox. Otherwise, leave the checkbox selected.
16. Click Done.
17. When the installation is finished, update the authentication.redirect.uri.whitelist property in the authserver.properties file by adding the Web Application Platform address http(s)://<domain_name>:<port>/webapp as its value.
18. Apply the Cameo Collaborator for Teamwork Cloud license.

Web Application Platform is now installed with the selected plugins and started if you choose this option in step 15. If you need to start the Web Application Platform manually, click here to learn how to do it. To access Web Application Platform, open a web browser and go to http(s)://<domain_name>:<port>/webapp/resources. By default, the Web Application Platform uses the port 8443.

Installation for testing purposes

If you want to install the Web Application Platform for testing purposes only, you have to install it on the same machine as Teamwork Cloud and Authentication servers. You can do it in two different ways:

• Install Teamwork Cloud. Web Application platform with the Resources, TWCloud Admin, and Cameo Collaborator web apps will be installed together with Teamwork Cloud.

  Testing Cameo Collaborator

  To check if Cameo Collaborator is installed together with Teamwork Cloud, go to the <Teamwork_Cloud_installation_directory>\WebAppPlatform\webapps\webapp directory. If the collaborator folder is in this directory, Cameo Collaborator is installed and you can test it after applying the Cameo Collaborator license.

• Run the Web_App_Platform_<version number>_win64.exe file and choose the Quick Install option.

This section explains how to install the Web Application Platform using the executive file (the second option described above). It installs the platform using default property values. You can change these values later if needed.

To install the Web Application Platform for testing purposes

1. Stop Web Application Platform on the machine where Teamwork Cloud is running.
2. Run the Web_App_Platform_<version number>_win64.exe file to start the installation wizard.
3. Specify the location where you want to install the Web Application Platform in one of the following ways:
   
   • Use the default location suggested in the Where would you like to install? box.
   • Click Choose and select a location on your machine.
4. Click Next.
5. Select the Quick Install radio button and click Next.
6. When you get the notification that Web Application Platform is successfully installed, click Next.
7. If you want do not want to start Web Application Platform after exiting the installation wizard, clear the Start Web Application Platform as service check box.
8. Click Done.
9. When the installation is finished, update the authentication.redirect.uri.whitelist property in the authserver.properties file by adding the Web Application Platform address http(s)://<domain_name>:<port>/webapp as its value.
   
   

Web Application Platform is now installed with Cameo Collaborator, Resources and TWCloud Admin plugins. If you need to start the Web Application Platform manually, click here to learn how to do it. To access Web Application Platform, open a web browser and go to http(s)://<domain_name>:<port>/webapp/resources. By default, Web Application Platform uses the port 8443.

Changing Web Application Platform property values

After installing the Web Application Platform, you can change its property values in the webappplatform.properties file. Click here, to learn more about each property.

To change Web Application Platform property values

1. Go to the <wap_installation_directory>\apache-tomcat\shared\conf directory.
2. Open the webappplatform.properties file.
3. Change the desired property values.
4. Save and close the file.
5. Restart the Web Application Platform.

Related pages

• Installing Web Application Platform on Linux
• Installing Web Application Platform manually