This section explains how to install Teamwork Cloud (TWCloud) on a single server by using zip files and set up its configuration file to allow access to the authentication server.
To install TWCloud on Windows by unzipping the file
Open the server configuration file C:\ProgramFiles\TeamworkCloud\configuration\application.conf and edit the following lines (the hostname and seed-nodes) to use the node's own IP address.
You must also set the IP address of the Cassandra node in the seeds section. If your Cassandra instance is on the same server, then use the nodes own IP address.
hostname = "10.1.1.123"
seed-nodes = ["akka.tcp://twcloud@10.1.1.123:2552"]
seeds = ["10.1.1.123"]
server.public.host=<serverIP>
authentication.redirect.uri.whitelist=https://<serverIP>:8443>/webapp/
twc.server.host=<serverIP>
cassandra.contactPoints=<serverIP>
Update the configuration file: C:\Program Files\TeamworkCloud\WebAppPlatform\shared\conf\webappplatform.properties - the configuration file for TWC Admin Console
C:\> cd C:\TeamworkCloudSuite\scripts\windows C:\> genkey
If the server is accessed via FQDN or public IP address, then the authentication.redirect.url must also contain entries for them, accordingly, in the format:authentication.redirect.uri.whitelist=https://<serverIP>:8443>/webapp/,https://<PublicIP>:8443>/webapp/,https://<FQDN>:8443>/webapp/,https://md_redirect/ |
There are additional steps to run TWCloud as a service on Windows. Before proceeding, make sure the server's log configuration points to the file location that is writable. You can find the log config in the file C:\TeamworkCloudSuite\configuration\logback.xml.
You need to check if the file location path is editable. |
To run TWCloud on Windows
For example:
C:\> set TWCLOUD_HOME=C:\Program Files\TeamworkCloud
C:\> set JAVA_HOME=C:\Program Files\Java\jre1.8.0_202
Alternatively, set the environment variables by adding them through the Environment Variables dialog (click Control Panel > System > Advanced > Environment Variables > New). |
Run the Teamwork Cloud service installation script, for example:
C:\Program Files\TeamworkCloud\scripts\windows>installService.bat
Run the Authserver service installation script, for example:
C:\Program Files\TeamworkCloud\AuthServer\registerWindowsService.bat
Run the Webapp service installation script
The Webapp service requires its bundled Java (JAVA 11). Therefore, prior to executing the service install script, we must set JRE_HOME and CATALINA_HOME_WEBAPP to point to it.
C:\> set JRE_HOME=C:\Program Files\TeamworkCloud\WebAppPlatform\jre
C:\> set CATALINA_HOME_WEBAPP=C:\Program Files\TeamworkCloud\WebAppPlatform
C:\Program Files\TeamworkCloud\WebAppPlatform\bin\>service.bat install
Set service dependencies
C:\>sc config webapp depend= teamworkcloud
C:\> sc config authserver depend= teamworkcloud
|
To uninstall TWCloud
C:\Program Files\TeamworkCloud\scripts\windows>uninstallService.bat
C:\Program Files\TeamworkCloud\AuthServer\unregisterWindowsService.bat
C:\Program Files\TeamworkCloud\WebAppPlatform\bin\>service.bat uninstall