Page History
...
- Make sure that the JAVA_HOME environment property links to the Java 11 directory.
- Go to the directory where TWCloud is unzipped and select the AuthServer directory.
- Update the file <TWCloud directory>/AuthServer/config/authserver.properties as follows:
- 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 a FQDN, use it instead of the IP address.
- twc.server.host - Enter the IP address of the server where TWCloud is installed in place of ${twc.server.ip}.
- twc.server.port - Specify the port of TWCloud Admin REST API (the default is 8111).
- twc.server.protocol - Specify the protocol of TWCloud Admin REST API (the default is https).
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).
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.
- Save the authserver.properties file.
- 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.
- Open the command prompt to <TWCloud directory>/AuthServer and run the file registerWindowsService.bat.
- Open the Windows Services panel or Task Manager's Services tab.
- Locate Authentication Server in the Windows Services panel (or AuthServer in Task Manager) and start it.
...
Linux
To deploy an authentication server using the zip file
- Go to the directory, where TWCloud is unzipped and select the AuthServer directory.
- Update the file <TWCloud directory>/AuthServer/config/authserver.properties as follows.
- 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.
- twc.server.host - Enter the IP address of the server where TWCloud is installed in place of ${twc.server.ip}.
- twc.server.port - Specify the port of TWCloud Admin REST API (the default is 8111).
- twc.server.protocol - Specify the protocol of TWCloud Admin REST API (the default is https).
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).
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.
- Save the file authserver.properties.
- 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.
- 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.
- To make the service start/stop with system startup/shutdown, use the following command: sudo chkconfig authserver on.
- Start the authentication server: sudo systemctl start authserver.
To deploy an authentication server using the installer
- 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.
- Start the authentication server: sudo systemctl start authserver.
To undeploy an authentication server
- Type sudo systemctl stop authserver to stop the authentication server.
- Disable the service with this command: sudo systemctl disable authserver.
- Remove the file by typing: sudo rm /etc/systemd/system/authserver.service.
- Remove the directory <TWCloud directory>/AuthServer.