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.

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

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

  3. 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.

Navigate to the Setup » Gathr and update the below details.

  • Gathr Web URL
  • Zookeeper Gathr Node
  • Zookeeper Configuration Node

setup_gathr_1.png

Navigate to the Setup » Database and update the below details.

  • Connection URL
  • User
  • Password
  • Run Script

setup_gathr_2.png

Please check the Run Script and click on Save it will execute the DDL & DML in Gathr Metastore.

Navigate to the Setup » Messaging Queue and update the below details.

  • Messaging Type
  • Host List
  • User
  • Password

setup_gathr_3.png

Navigate to the Setup » Elasticsearch and update the below details.

  • Elasticsearch Connection URL
  • Elasticsearch Cluster Name

setup_gathr_4.png

After updating the details, Please do the Gathr restart with -config.reload=true.

If you have any feedback on Gathr documentation, please email us!

← Gathr Prerequisites
Gathr Setup using Manual Deployment →