ID: 2547

Upgrading Zoom Server (Linux / 5-x)

Step-by-step guide to upgrading Zoom Server 5.x installations on Linux

Upgrade Instructions From 5.0 to 5.2:

The following instructions describe how to upgrade a Zoom Server installed on RedHat Enterprise Linux or CentOS. These instructions assume you have downloaded the zoom-unix64.tar.bz2 from the Zoom Support Center.

  1. Restart the Zoom Server services.
  2. Stop the Zoom Server and Zoom Preview Server (Only if preview server is configured to run on the same machine as the zoom server) Services.
    For information on how to start and stop services for a Linux Server, see Starting and Stopping Zoom Services (Linux)
  3. Copy or backup the conf folder; Also move or backup the db folder out of the installation directory.
    If your db folder is not  located in the installation directory, you do not need to backup the db/ folder.
  4. Delete the ZOOM_INSTALLATION_DIR folder.
  5. Unzip the zoom-unix64.tar.bz2 downloaded from the Zoom Support Center.
  6. Copy all files/folders from backup conf/ and replace them in new [ZoomDir]/conf/
    Make sure to manually copy all files/folders from backup conf/ and replace them in newly installed conf/.Do not delete any file/folder from the newly installed conf/.
     For Upgrade from 5.0 to 5.5 or greater, copy only zoom.key from backup conf/ and paste it in newly installed [ZoomDir]/Conf/ directory. In case of user specific changes in backup conf/, please manually do all the changes in the newly installed [ZoomDir]/conf/ directory.
  7. Follow the link Metadata Migration to migrate the metadata.
  8. Open preview-server.xml from [ZoomDir]/conf/ and replace localhost with Server_Ip_Address.preview-server-xml
    If the Zoom Server and the Zoom Preview Server are running on different machines, then edit the preview-server.xml only on the machine where the Zoom Preview Server is running. Note that, the Server IP Address here refers to the Zoom Server machine’s IP address.
  9. Open server.xml from [ZoomDir]/conf/  
    1. Search and identify the <reviewserverspec> section.
    2. Remove this entire tag – starting from "<reviewserverspec>" phrase and ending with "</reviewserverspec>"
    3. Copy in this place, the following xml snippet:
      • <reviewserverspec>

        <trackProgress>true</trackProgress>
        <usePreviewForFileUpload>true</usePreviewForFileUpload>
        <useSslForDesktopClient>false</useSslForDesktopClient>
        <previewFileType>FLV</previewFileType>
        <previewResolution>480</previewResolution>
        <audioPreviewResolution>44100</audioPreviewResolution>
        <generateHiResPreviews>false</generateHiResPreviews>
        <imageHiRes>1920</imageHiRes>
        <hiResThresholdSize>100</hiResThresholdSize>
        <ServerConnection>

        <port>8873</port>
        <sslPort>8013</sslPort>
        <host>0.0.0.0</host>
        <listenerHost>0.0.0.0</listenerHost>
        <enableSsl>false</enableSsl>
        <self>true</self>

        </ServerConnection>

        </reviewserverspec>

    4. Check the following screenshot to see what this section would have been like before, and what it should look like after you have copied the snippet given above:  befaftlinux
       For upgrade from 5.0 to 5.5 or greater, do not follow steps from 9.1 to 9.4 as above given xml snippet already exists in newly packaged server.xml.
    5. Replace 0.0.0.0 in <host> tag of the <networkspec> and <webserverspec> with Zoom Server machine’s  IP Address.
    6. The <host> tag in the <ServerConnection> which is in the <reviewserverspec> section must contain the Zoom Preview Server IP address.
    7. If the Zoom Server and the Preview Server are running on the same machine, all three tags will be pointing to the same address.
    8. If Zoom Server and the Preview server are running on different machines, care must be taken to update these tags as indicated here. In that case, enter the IP addresses as shown here, on the server.xml of both the machines.server-xml
    9. The <self> tag of the <ServerConnection> must be set to true on the machine where the Preview Server is running. Therefore, if both Zoom Server and Preview Server are running on the same machine, then in that server.xml, this tag must be set to true. If they are running on separate machines, then do the following:
      • in the Zoom Server machine, set this tag to false
      • in the Preview Server machine, set this tag to true.
  10. If you had moved the db folder out of the installation directory in the beginning, move it back to the installation directory now (overwriting newly created empty db folder).
  11. Start the Zoom Server and Zoom Preview Server services.
  12. Check the Zoom Version.

Upgrade Instructions From 5.2 to 5.3:

The following instructions describe how to upgrade a Zoom Server installed on RedHat Enterprise Linux or CentOS. These instructions assume you have downloaded the zoom-unix64.tar.bz2 from the Zoom Support Center.

  1. Stop the Zoom Server and Zoom Preview Server (Only if preview server is configured to run on the same machine as the zoom server) services.
    For information on how to start and stop services for a Linux Server, see Starting and Stopping Zoom Services (Linux)
  2. Edit the [ZoomDir]/Conf/server.xml file.
  3. Search for the “doCheckpoint” tag under the <autorestartspec> section, and set it to true.
    <autorestartspec>
    <frequency>7</frequency>
    <date>2014-06-28 18:30:00.0 UTC</date>
    <time>00:00</time>
    <autoRestartEnabled>true</autoRestartEnabled>
    <doCheckpoint>true</doCheckpoint>
    </autorestartspec>
  4. Save the file.
  5. Restart the Zoom Server services.
  6. Stop the Zoom Server and Zoom Preview Server services.
    For information on how to start and stop services for a Linux Server, see Starting and Stopping Zoom Services (Linux)
  7. Copy or backup the conf folder; Also move or backup the db folder out of the installation directory.
    If your db folder is not  located in the installation directory, you do not need to backup the db/ folder.
  8. Delete the ZOOM_INSTALLATION_DIR  folder.
  9. Unzip the zoom-unix64.tar.bz2 downloaded from the Zoom Support Center.
  10. Copy all files/folders from backup conf/ and replace them in new [ZoomDir]/conf/
    Make sure to manually copy all files/folders from backup conf/ and replace them in newly installed conf/.Do not delete any file/folder from the newly installed conf/.
  11. Please refer to steps 8 and 9 from the previous section outlining the upgrade instructions from 5.0 to 5.2 or greater; execute the same steps here.
  12. If you had moved the db folder out of the installation directory in the beginning, move it back to the installation directory now (overwriting newly created empty db folder).
  13. Start the Zoom Server and Zoom Preview Server services.
  14. Check the Zoom Version.

Upgrade Instructions From 5.3 to a Newer Version :

The following instructions describe how to upgrade a Zoom Server installed on RedHat Enterprise Linux or CentOS. These instructions assume you have downloaded the zoom-unix64.tar.bz2 from the Zoom Support Center.

  1. Stop the Zoom Server and Zoom Preview Server (Only if preview server is configured to run on the same machine as the zoom server) services.
    For information on how to start and stop services for a Linux Server, see Starting and Stopping Zoom Services (Linux)
  2. Edit the [ZoomDir]/Conf/server.xml file.
  3. Search for the “doCheckpoint” tag under the <autorestartspec> section, and set it to true.
    <autorestartspec>
    <frequency>7</frequency>
    <date>2014-06-28 18:30:00.0 UTC</date>
    <time>00:00</time>
    <autoRestartEnabled>true</autoRestartEnabled>
    <doCheckpoint>true</doCheckpoint>
    </autorestartspec>
  4. Save the file.
  5. Restart the Zoom Server services.
  6. Wait for the Zoom server to finish the checkpointing. To verify whether checkpointing is finished, go to zoom server’s log directory and look for message:
    “Redo log checkpointing ended”
    in server_log.0 file. Only look for latest entry in the file.
  7. Stop the Zoom Server and Zoom Preview Server services.
    For information on how to start and stop services for a Linux Server, see Starting and Stopping Zoom Services (Linux)
  8. Copy or backup the conf folder; Also move or backup the db folder out of the installation directory.
    If your db folder is not  located in the installation directory, you do not need to backup the db/ folder.
  9. Delete the ZOOM_INSTALLATION_DIR  folder.
  10. Unzip the zoom-unix64.tar.bz2 downloaded from the Zoom Support Center.
  11. Copy zoom.key from backup conf/ and paste it in the newly installed [ZoomDir]/conf/ directory.
  12. Copy the following files from backup conf/ and replace them in the newly installed [ZoomDir]/conf/ directory.
      • metadataspec.xml
      • preview-server.xml
      • server.xml
    Make sure to merge all the changes made at the time of deployment in backup conf/ to the newly installed [ZoomDir]/conf/ directory. In case of user specific changes in backup conf/, please manually do all the changes in the newly installed [ZoomDir]/conf/ directory.
    For example: If you have changed the value of  “wrapper.java.initmemory=128″  flag in wrapper.conf of backup conf/ to increase the initial java heap size, then you have to manually edit/replace the value of same flag in wrapper.conf of newly installed [ZoomDir]/conf/ directory.
  13. If you had moved the db folder out of the installation directory in the beginning, move it back to the installation directory now (overwriting newly created empty db folder).
  14. Start the Zoom Server and Zoom Preview Server services.
  15. Check the Zoom Version.
Customers who are at revisions before 5.3, please see the previous sections for upgrade instructions.

For Zoom 6.0 and above, there are a couple of functionalities that require additional configurations. 

  1. Zoom supports a new ‘Search and Index’ engine called the Zoom Curator. Please check here for configuration instructions. 
  2. Zoom supports a faster search mechanism in the Asset Browser called Faceted Search. Please check here for configuration instructions.