Installing on Docker | Zoho Analytics On-Premise

Installing on Docker


This documentation details the process of working with Zoho Analytics On-Premise for Docker.

Deploy Zoho Analytics On-Premise on Docker

You can download Zoho Analytics On-Premise on Docker easily. Follow the steps below to download the image and run the container in Docker.

Step 1: In the download page, choose Docker from the Deploy on drop down, and click Download Now.

Step 2: Copy the Docker pull command that appears in the Docker Hub page.

Step 3: Run the copied command docker pull zohoanalytics/onprem to download the docker image. 

You can list the downloaded images using the following command: docker images

Step 4: Before starting the docker container, create a directory on your server to store periodic backups of Zoho Analytics On-Premise. This will prevent data loss if the container is killed intermittently. This step is highly recommended.
Note: Periodic application backups will be moved to this new directory (in the local machine) automatically to avoid loss of data when the container is killed.

Step 5: To start your docker container, use the below command. The backup directory in our example is C:\Zoho\MyBackup and the container name is onprem.
docker run -d -p 8443:8443 -v C:\MyBackup:/home/zaop/Zoho/Analytics/Backup --name=onprem zohoanalytics/onprem

In addition to starting the docker container, this command performs the following actions:

  • Maps the ports of the docker container and the host server.

  • Links the Zoho Analytics On-Premise backup folder to the backup folder C:\Zoho\MyBackup present on the host server.

Note: If you are running Docker on Windows, the below popup appears. Click Share it to proceed.

You can check the containers that are running using the following command: docker ps

Step 6: Execute an interactive bash shell on the downloaded container using the following command: docker exec -it onprem bash

Step 7: Before starting the application, switch to the Zoho/Analytics/bin directory.

Step 8: Start Zoho Analytics On-Premise using the command: nohup sh app_ctl.sh run &. Use the command disown to remove jobs from the job table of the parent shell.

Note: To stop the application, use the following command: sh app_ctl.sh shutdown

Step 9: Once the application has started, you can access the application from a web-browser using the following URL.

https://<serverIP address>:8443 (replace <server IP address> with the docker IP address)

Use the following credentials in the screen that appears to login to Zoho Analytics On-Premise. Please change the default password upon login.
Username: admin
Password: admin

Backup the database

Zoho Analytics On-Premise automatically backs up data every day, and stores the data in the Zoho/Analytics/Backup directory.  
Sample file name: OfflineBackup_20200706134016.ezip (The number appended is the backup time stamp)

Running ad hoc backups

Follow the steps below to back up your Zoho Analytics On-Premise data per your requirements. 

Step 1: Execute an interactive bash shell on the container using the command docker exec -it demobackup bash.

Step 2: To start the backup, change the directory to Zoho/Analytics/bin, and execute this command sh backupDB.sh

Once a complete backup is taken, the following screen appears. 

Step 3: Copy the masterIV and masterKey to the product's default backup directory. These files are required to decrypt the restored database. 

Restore backup

Follow the steps below to restore a backup file. 

Step 1: Copy the backup folder to the home directory /home/zaop.

Step 2: Execute an interactive bash shell on the container as a root user using the command docker exec -it --user=root demorestore bash, and change the ownership of your backup folder.

Step 3: Change the directory to Zoho/Analytics/bin and execute the interactive bash shell on the container using the command docker exec -it demorestore bash.

Step 4: To restore the backup, use the command sh restoreDB.sh, followed by the full directory path of the backup file and its password. 

Note: The password is the name of the backup file in reverse.

This is how the command would appear: sh restoreDB.sh /home/zaop/MyBackup/OfflineBackup_20200715.ezip -p 51700202_pukcaBenilffO

The following screen appears after restoring the backup file successfully. 


    Access your files securely from anywhere

      Zoho CRM Training Programs

      Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

      Zoho CRM Training
        Redefine the way you work
        with Zoho Workplace

          Zoho DataPrep Personalized Demo

          If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

          Zoho CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION









                                            You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                Manage your brands on social media

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • Related Articles

                                                                                                              • Installing on AWS

                                                                                                                You can deploy Zoho Analytics On Premise on AWS easily. Follow the steps below to do this. In the download page, choose AWS from the Deploy on drop down, select the required deployment tier, and click Deploy Now. Sign in to your AWS account, and ...
                                                                                                              • Installing on Azure

                                                                                                                You can deploy Zoho Analytics On Premise on Azure easily. Follow the steps below to do this. Step 1: In the download page, choose Azure from the Deploy on drop down, and click Deploy Now. Step 2: Sign in to your Azure account, and click the Create ...
                                                                                                              • Installation Guide

                                                                                                                This installation guide will help you complete the installation of Zoho Analytics On-Premise.  Zoho Analytics On-Premise Editions Zoho Analytics On-Premise is available in two editions, Personal and Professional. Personal Edition - This is a single ...
                                                                                                              • Zoho Analytics - Mobile BI App

                                                                                                                This app allows you to access your Zoho Analytics data on to go, and stay up-to-date on key performance metrics. The Zoho Analytics Mobile BI app allows you to access your reports and dashboards, and provides various sharing features that facilitate ...
                                                                                                              • Applying a SSL Certificate

                                                                                                                This documentation provides the general guidelines for applying a SSL certificate. However, to import a SSL certificate into a tomcat server, it is advisable to refer the instructions published by the respective Certificate Authorities.   Importing ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  Resources

                                                                                                                  Videos

                                                                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                  eBooks

                                                                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                  Webinars

                                                                                                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                  CRM Tips

                                                                                                                  Make the most of Zoho CRM with these useful tips.



                                                                                                                    Zoho Show Resources