Page History

Linux

To deploy an authentication server using the zip file

1. Go to the directory, where TWCloud is unzipped and select the AuthServer directory.
2. Update the file <TWCloud directory>/AuthServer/config/authserver.properties as follows.
   1. server.public.host - Enter the IP address of the authentication server in place of ${server.ip}. If TWCloud is installed behind a proxy or firewall with NAT, use a public IP address. If you are accessing the server via FQDN, use it instead of the IP address.
   2. twc.server.host - Enter the IP address of the server where TWCloud is installed in place of ${twc.server.ip}.
   3. twc.server.port - Specify the port of TWCloud Admin (the default is 8443 8111).
   4. twc.server.protocol - Specify the protocol of TWCloud Admin (the default is https).

   5. authentication.redirect.uri.whitelist - Update the whitelist of redirect URI. Also, change the TWCloud swager's redirect URI (the initial is https://${twc.server.ip}:8111/) by setting the TWCloud IP address or FQDN instead of ${twc.server.ip}. Change the Web App Platform redirect URI (the initial is https://${webapp.server.ip}:8443/webapp/) by setting the Web App Platform IP address or FQDN (if you are accessing the server by FQDN) instead of ${webapp.server.ip} (and change the port/protocol if they were changed).

   6. cassandra.contactPoints and cassandra.port - Update the Cassandra host(s) if the database is installed on different machine(s) and the Cassandra port if the custom port is configured in the database for CQL clients listening.
      

3. Save the file authserver.properties.
4. Make sure that the log configuration points to the file location that is writable. You can find the log config in the file <TWCloud directory>/AuthServer/config/logback-spring.xml.
5. Copy the file <TWCloud directory>/AuthServer/script/authserver.service to the following directory /etc/systemd/system: sudo cp <TWCloud directory>/AuthServer/script/authserver.service   /etc/systemd/system.
6. To make the service start/stop with system startup/shutdown, use the following command: sudo chkconfig authserver on.
7. Start the authentication server: sudo systemctl start authserver.

To deploy an authentication server using the installer

1. Make sure that the log configuration points to the file location that is writable. You can find the log config in the file <TWCloud directory>/AuthServer/config/logback-spring.xml.
   
2. Start the authentication server: sudo systemctl start authserver.
3. Start the authentication server: sudo service authserver start.

To undeploy an authentication server

1. Type sudo systemctl stop authserver to stop the authentication server.
2. Remove the service from chkconfig management with this command: sudo chkconfig authserver off.
3. Remove the file by typing: sudo rm /etc/systemd/system/authserver.service.
4. Remove the directory _ <TWCloud directory>/AuthServer._