View Source

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

Verify that 'java –version' is the active version of Java (Oracle JDK 1.8.0_152).
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>

Generate default keypair and certificate by running the following command.
```
$ 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

Choose or create a user dedicated to running the server, for example, twcloud.
Create a file, /etc/twcloud/twcloud-env, and set the required environment variables as the following:
```
TWCLOUD_HOME=/opt/TeamworkCloudSuite/ 
TWCLOUD_OWNR=root
JAVA_HOME=/usr/java/jdk1.8.0_152/ 
```
TWCLOUD_HOME: to point to the directory where TWCloud was installed.
TWCLOUD_OWNR: the user account under which TWCloud will run.
JAVA_HOME: a directory containing a Java JDK or JRE.

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
```
Remove the service script from the init.d directory by typing the following:

        $ sudo rm /etc/init.d/twcloud-svc

Once you have installed TWCloud, use your administrator account to create user accounts through TWCloud Admin. See Creating user and group for the instructions to add user accounts.

Starting TWCloud and TWCloud Admin on Linux