Upgrading Zoom Servers with HADR (Independent Databases)


  1. Zoom should be installed with the HADR module in (I) configuration, i.e. Independent DB locations, not shared, at each Zoom server. Assuming e.g. ZS1, ZS2 & ZS3 = Three servers with independent DBs (I mode)
  2. Preview server(s) installed on separate machines (Assuming e.g. ZPS1 & ZPS2)


  1. For each Zoom Server:
    1. Restart the Zoom Server service with checkpoint.
      1. Use the javaZoom utility as given in: https://help.evolphin.com/docs/v5/server/zoom-server-checkpointing-on-restart/
      2. A privileged user is required to restart the service when using the javaZoom command.
        1. On Windows: Open Command Prompt as Administrator.
        2. On Linux: Switch to the root user in the Terminal.
      3. Otherwise, use javaZoom to enable checkpoint but not restart (-nr option). Then services can be restarted manually, as done normally.
    2. Wait for the checkpoint to complete.


  • This checkpoint restart can be done in a staggered manner, i.e. one Zoom Server at a time, so that the users are able to use the system while one service is unavailable during checkpointing.
  • Preferably, perform this upgrade process soon after the scheduled auto-restart of the Zoom servers, so that there is lesser data to checkpoint and it completes faster.
  1. Open the HADR Dashboard Status page in the Web Management Console. Wait till all the servers (or at least the DB writer server(s)) have the same Last Delivered transaction number, matching the highest Last Proposed number.
  2. Immediately, stop the Zoom server services on all the machines ZS1, ZS2 & ZS3.
  3. Stop the HADR file-server services on all the machines ZS1, ZS2 & ZS3.
  4. Again, restart with checkpointing, each Zoom server service. Wait for checkpointing to complete and then immediately stop the service.
  5. Stop the preview-server service (and curator-server service, if enabled) on the ZPS1 & ZPS2 machine(s).
  6. Copy or backup the conf folder on each Zoom server & Preview server
  7. Move or backup the db folder out of the installation directory in each zoom server.

If db folder is not located in the installation directory, you do not need to back up the db

  1. Move or back up the preview cache folder out of the Zoom installation directory on the ZPS machines.
    1. Preview cache location is given in the <previewCacheLocation> field in the conf/preview-server.xml file.
    2. Skip this step if the preview cache folder is not located in the installation directory.
  2. Uninstall the Zoom installation on all the server & preview-server machines (ZS1, ZS2, ZS3; ZPS1, ZPS2) :
    1. On Windows: From the Control Panel > Programs > Uninstall the Evolphin Zoom program, or uninstall using the old cached installer.
    2. On Linux: Delete the ZOOM_INSTALL_DIR folder.
  3. Install the new Evolphin Zoom version
    1. On Windows: Install using the Setup file. Stop all the Zoom services after the installation completes.
    2. On Linux: Unzip the zoom-unix64.tar.bz2 setup file.
  4. Copy the new conf folder in any one server to a new backup.
    1. This is useful in comparing and adding any new files, properties, or changes required for the new Zoom version into the existing conf.
  5. On each Zoom server, copy all files/folders from the earlier backup conf/ and replace them in the new [ZOOM_INSTALL_DIR]/conf/
  6. On each Preview server, copy all files/folders from the earlier backup conf/ and replace them in the new [ZOOM_INSTALL_DIR]/conf/
  7. On each Zoom server, if it had been moved out of the installation directory in step 7, move the DB folder back to its original location.
  8. Start the Zoom & HADR service on ZS1, ZS2 & ZS3
  9. Start the Preview service (and Curator service, if enabled) on ZPS1 & ZPS2 machines.

Leave a Comment