Embedded Gathr

Gathr Webstudio can be manually configured during deployment process. This requires changing few configuration files manually.

Alternatively, a simpler way is to start the Webstudio in embedded mode. This enables the user to configure Gathr from the UI. Configuring and restarting Gathr can switch the Webstudio to cluster mode.

Embedded mode requires two services Zookeeper and Qpid, these packages are bundled in the Gathr binary and do not need additional setup.

Steps to Run #

1. Extract the Gathr bundle and go to the extracted location in a terminal.

2. This location is called as Gathr installation directory.

3. Run the below command to start Webstudio

   cd bin/
   ./startServicesServer.sh -deployment.mode=embedded
   

Once the command executes, an EULA page opens.

4. Accept the license and hit Next button. Upload License page opens.

5. Upload the license and confirm. Next page is the login page of Gathr

6. Login page is displayed.

In case if the login attempt fails due to invalid license error, follow below steps to re-upload the license and login again.

Steps to resolve the license Issue while starting the tomcat for the first time:

1. Login to the tomcat machine and Navigate to the Gathr/conf/common/license.

2. Create a file named “license” and paste the valid license.

3. As a Gathr user restart the service using below commands:

   ./stopServiceServer.sh
   ./startServicesServer.sh -deployment.mode=embedded -config.reload=true
   

4. Once tomcat is started successfully, you should be able to login to the web UI using Gathr user credentials.