This section explains how to install Teamwork Cloud (TWCloud) on a single server using zip files and set up its configuration file to allow access to the authentication server.
To install TWCloud on Linux by unzipping the file to a directory
Unzip the file to a folder, for example, /opt. Once you have unzipped the file, you will get the folder name /opt/TeamworkCloudSuite.
Open the server configuration file /opt//TeamworkCloudSuite/configuration/application.conf and edit the hostname, seed node, and host address to use the node's own IP address (see the following example).
hostname = "10.1.1.123"
seed-nodes = ["akka.tcp://twcloud@10.1.1.123:2552"]
host = "10.1.1.123"
Also, update the following TWCloud configuration to allow access to the authentication server (protocol and ports are defaults).
# Authentication Server address
esi.auth {
# Authentication Server protocol, IP address and port
# InetAddress.getLocalHost.getHostAddress is used if server is left empty
protocol = "https"
server = "10.1.1.123"
port = "8555"
}
Update theAuthServer configuration: <AuthServer install root>\config\authserver.properties by specifying the IP address instead <serverIP>:
server.public.host=<serverIP>
authentication.redirect.uri.whitelist=https://<serverIP>:8111>/twcloud_admin/,https://md_redirect
twc.server.host= <serverIP>
$ cd /opt/TeamworkCloudSuite/scripts/linux $ ./genkey
There are a number of additional steps to run TWCloud as a service on Linux. 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 TeamworkCloudSuite/configuration/logback.xml.
You need to check if the file location path is editable. |
To run TWCloud as a service on Linux
TWCLOUD_HOME=/opt/TeamworkCloudSuite/
TWCLOUD_OWNR=root
JAVA_HOME=/usr/java/jdk1.8.0_152/
|
Copy the service startup script into the init.d directory, for example:
$ sudo cp /opt/TeamworkCloudSuite/scripts/linux/twcloud-svc /etc/init.d
To make the service start/stop with system startup/shutdown, use chkconfig command:
$ sudo chkconfig --add twcloud-svc
To uninstall TWCloud as a service
Remove the service from chkconfig management:
$ sudo chkconfig --del twcloud-svc
$ sudo rm /etc/init.d/twcloud-svc
Once you have installed TWCloud, use your administrator account to create user accounts through TWAdmin. See Creating a user for the instructions to add user accounts.