App Server

The App Server acts as the application's frontend and the primary interface for end users. All features and functionalities of Zoho Analytics are accessed through the App Server. In a distributed architecture, multiple instances of the App Server collaborate to manage processing and user access, with one server designated as the primary server.

Minimum system requirements

Installation

Initially, you need to install the application on a server that will function as the parent/primary App Server. Then, proceed to install the same application on additional servers, which will serve as child App Servers. To do this, follow these steps:

• Download the Zoho Analytics application from this page.

• Install Zoho Analytics by following the steps based on your server's OS type.

  Note: On successful installation of Zoho Analytics, please do not start the application immediately. As the primary and child App Servers must be started and configured in a specific sequence, which involves some intermediate steps.
  • Windows Installation
  • Linux Installation - Console mode
  • Linux Installation - Graphical mode

You can use the same downloaded application and follow the above steps to install the child App Servers. Ensure that both the primary and all child App Servers are installed on servers with the same OS type.

Configuration

Step 1: Start the parent/primary App Server

The parent/primary App Server represents the Zoho Analytics application, which is installed initially.

• For Windows:
  1. Log in to the primary server.
  2. Open the Run dialog, type services.msc and click OK.
  3. In the Services dialog that appears, locate Zoho Analytics and Start the application.
• For Linux (both Graphical and Console mode):
  1. Log in to the primary server.
  2. Open the command prompt and navigate to the <Zoho Analytics home>/bin directory (Home folder refers to the installation directory of Zoho Analytics).
  3. Run the sh app_ctl.sh run command to start the Zoho Analytics application.

It will take a few seconds to start all the modules. Once the startup is complete, you can access the application using the following URL: https://<Hostname>:<Web server port> (Hostname represents the hostname or the IP address of the server and the Web server port is the server port chosen at the time of installation), For example: https://bi-server:8443.

Step 2: Access the parent/primary App Server (Zoho Analytics Application)

1. Access the Zoho Analytics application using the following URL: https://<Hostname>:<Web server port>.
2. Provide the default username (admin) and password (admin), and click Sign In.
3. Complete the initial configuration. Click here to learn more.

Step 3: Add the machine configuration of the child server

1. Navigate to Settings > Multi-Server Configuration > Machine Configuration. Please note that the primary server details are added by default.

   

2. Enter the static IP address of the server where the child App Server is installed.
3. Provide a unique name for the server according to your preference.
4. Select the server's OS type from the drop-down menu. It should be the same as that of the primary server. As both the primary and child servers should run on the same OS type.

5. Click Save. Repeat these steps to configure additional child hosts.

   

6. Navigate to the Machine List tab.

7. Hover over the primary server's name and click the Edit icon that appears.

   

8. Update the IP address from the default IP to the static IP address of the primary server, as Zoho Analytics initially uses the localhost IP address, which needs to be replaced with a static IP for the primary server.

   

   Zoho Analytics lets you view all added server details under the Machine List tab, where you also have the option to edit or delete configurations as needed.

Step 4: Start the GRPC agent on the child server

1. Log in to the server where you have installed the child App Server.
2. Open command prompt and navigate to the <ZohoAnalytics home>/bin directory.
3. Run the following command to start the GRPC agent on the child server.
   • For Windows: grpcagent.bat
   • For Linux: sh grpcagent.sh

Step 5: Configure the App Server information

1. Login to the Zoho Analytics application (i.e. the primary App Server).

2. Navigate to Settings > Multi-Server Configuration > App Server. Please note that the primary App Server details are added by default.

   

3. From the App Server tab, select the desired machine configuration from the list where the child App Server is installed. If needed, you can add a new machine configuration by selecting the + Add more option from the drop-down menu.
4. Provide a unique name for the App Server based on your preference. This name is useful in identifying the desired App Server in the Operational Control Center.
5. Enter the port number on which the application is running in the App Server Port section.

6. Click Save.

   

Upon successful addition, a success message will appear at the bottom of the screen. Please repeat these steps to add more child App Server details.

Step 6: Stop the GRPC agent on the child server

1. Log in to the server where you have installed the child App Server.
2. Open command prompt and navigate to the <ZohoAnalytics home>/bin directory.
3. Press CTRL+C to stop the GRPC agent on the child server.

Step 7: Start the child App Server

Start the child App Server by following the steps below

• For Windows:
  1. Open the Run dialog, type services.msc and click OK.
  2. In the Services dialog that appears, locate Zoho Analytics and Start the application.
• For Linux (both Graphical and Console mode):
  1. Open the command prompt and navigate to the <Zoho Analytics home>/bin directory (Home folder refers to the installation directory of Zoho Analytics).
  2. Run the sh app_ctl.sh run command to start the Zoho Analytics application.

Step 8: Check the user interface

Once the child App Server starts successfully, navigate to Settings > Multi-Server Configuration > App Server > App Server List tab; the child App Server details will be listed.