Starting and stopping the application

To start Zoho Analytics, open your Windows Services and navigate to the Zoho Analytics service. Right click the service name and select Start or Stop, to start and stop the application accordingly. You can also start the application from the command prompt by executing the run.bat file found under the <Zoho Analytics>\bin folder.

Note: To start or stop Zoho Analytics, please ensure you are logged in to the server on which your Zoho Analytics application is installed. 

Navigate to the directory where Zoho Analytics is installed in your computer or server. Launch a terminal from the <Zoho Analytics>/bin folder, and use the following commands to start and stop the application:

• Start the application by executing these commands (from the command prompt/terminal): sh app_ctl.sh run or sh run.sh

• Stop the application by executing these commands (from the command prompt/terminal): sh app_ctl.sh StopServer or sh StopServer.sh

Taking a backup of your Zoho Analytics data

It is recommended to take a regular backup of your Zoho Analytics data and configuration.

• Stop the Zoho Analytics service.

• Open the command prompt (as administrator) and change the directory to <Zoho Analytics home>\bin

• Run the command backupDB.bat and wait for the script to take a complete backup of your installation.

• A compressed ZIP file will be created in the location <Zoho Analytics home>\Backup

The following are some additional parameters that can be included with the backupDB command:

• -t d : By including this parameter with the backupDB.bat command, you can specify the backup to be a dump file.

• -t b : By including this parameter with the backupDB.bat command, you can specify the backup to be a binary file.

• -t fb : By including this parameter with the backupDB.bat command, you can specify the backup to be a file backup.

• -f : This parameter allows you to provide a name for the backup file.

• -d : This parameter allows you to specify the directory that the backup file has to be saved in. 

• -p : This allows you to specify a password for the backup file.

Here are some examples of the above scripts:

backupDB -f test -d ../Backup -t b -p Test123

backupDB -p Test123

backupDB -f test

Recovering your Zoho Analytics data

• Install a new copy of Zoho Analytics. The new copy should be of the same build number as your original installation.

• Start the Zoho Analytics service and make sure the application is accessible.

• Stop the Zoho Analytics service.

• Open the command prompt (as administrator) and change the directory to <Zoho Analytics home>\bin

• Run the command restoreDB.bat <full directory path of your backup ZIP file>

Note:

By default, Zoho Analytics sets a password for the backup file, which will be the reverse of the file's name. For instance, the 'Test123' backup file would have '321tesT' as its default password. This can be modified while taking a backup, using this command. 

Therefore, while restoring a backup, the following command has to be included with the restoreDB command:

• -p : This parameter, followed by the password, allows you to restore the password protected backups. 

Here are some examples:

restoreDB test.ezip -p 321tseT

restoreDB OfflineBackup235161 -p 321tseT

restoreDB test.ezip -p tset 

Once the recovery is complete, start the Zoho Analytics service

Performance fine tuning

In most cases, you wouldn't need to increase the memory used by the Zoho Analytics processes. But if you feel the application is slowing down, you can increase the heap memory allocated to it.

Open the Wrapper.conf file present in the <Zoho Analytics home>\conf directory and search for the string Maximum Java Heap Size (in MB). Change the value of wrapper.java.maxmemory= from 1024 to a maximum of 4096. This allocates 4GB of memory to the Zoho Analytics processes.

Make sure that you do not allocate all available memory on the server to Zoho Analytics.

Upgrading to the latest version

• It is recommended to upgrade to newer versions of the software at least once every 2 months. 

• To upgrade to the latest version, stop Zoho Analytics, take a folder backup of the Zoho Analytics installation directory and then run UpdateManager.bat file present in the <Zoho Analytics home>\bin directory.

Important Note: Open the command prompt as administrator and then run the UpdateManager.bat script to avoid upgrade failures due to insufficient permissions.

Change the web server port

Follow the steps given below to change the web server port where Zoho Analytics is running.

• Open the Services window and stop the Zoho Analytics service.

• Navigate to the <Zoho Analytics home>\bin directory from command prompt or terminal in administrator mode.

• Execute the changeHostPort.bat using the following syntax.

changeHostPort.bat <new port number> true

• Once the script gets executed successfully, start the Zoho Analytics service.

Note: On Linux servers, run sh changeHostPort.sh

Moving Zoho Analytics from one server/folder to another

• Open the Services window and stop the Zoho Analytics service.

​

• Take a backup of the entire <Zoho Analytics home> directory and then move it to the new server. 

• On the new server, navigate to <Zoho Analytics home>\bin directory from command prompt or terminal in administrator mode.

• Run ServerMigration.bat

• If the port that Zoho Analytics was running on, in the old server is occupied in the new one, the script will prompt for a new port number.

Note: On Linux installations, run sh ServerMigration.sh