Upgrading to Zoom Server 5.x (Windows)

Zoom Server Upgrade From 5.0 to 5.2

Upgrade Instructions From 5.0 to 5.2:

The following instructions describe how to upgrade a Zoom Server installed on Windows 7/8. These instructions assume you have downloaded the zoom-server-win64.zip from the Zoom Support Center.

  1. In Windows Services, restart the Zoom Server service.
    For information on how to restart / stop, refer to Starting and Stopping Zoom Services (Windows) .
  2. Wait till the checkpoint gets completed. If there is a lot of data to be checkpointed, it will take some time to complete. Checkpointing is complete when the Zoom Web Management Console (ex: zmserver:8443) becomes accessible. Alternatively, you can check the server_log and see that the “checkpoint started” and “checkpoint ended” messages appear in the entries after a restart.
  3. In Windows Services, stop the Zoom Server and Zoom Preview Server services.
  4. Navigate to the Zoom install directory [DAM].
    On Windows, this is located in C:\Program Files (x86)\Evolphin\DAM.
  5. Copy or backup the conf folder; Also copy the db folder.
    If your db folder is located outside the install directory [DAM], you do not need to back up the db folder.
  6. If the redo location is different (not inside the db directory), then back up the redo folder.
    1. The redo location is specified in the <dbspec> <redoLogDir> xml tag inside the server.xml file in the conf folder.
    2. By default, the redo location is within the db folder itself.
  7. Copy or backup the “webcontext\servers\PreviewServer\cache” folder, if present, to outside the DAM folder.
  8. Go to Control Panel>Program and Features and Uninstall Evolphin Zoom.
  9. Follow the instructions in the uninstall wizard.
  10. After the restart, delete the following files from within the [DAM]/webcontext/ location:
    • [DAM]/webcontext/servers/ZoomServer
    • [DAM]/webcontext/servers/vabweb
    • [DAM]/webcontext/servers/PreviewServer/jsp
    • [DAM]/webcontext/servers/PreviewServer/webapp
  11. Unzip the zoom-server-win64.zip downloaded from the Zoom Support Center.
  12. Once unzipped, navigate to the setup.exe and double click it.
  13. Follow the instructions for the Zoom installer.
  14. Restart your computer.
    When your computer restarts, the service will start automatically on launch. Go to your Services and stop the Zoom Server and Zoom Preview Server services prior to continuing.
  15. Copy all files/folders from backup conf/ , db, and redo folders and replace them in new [DAM]/conf/ and other respective folders.
    Make sure to manually copy all files/folders from backup conf/ and replace them in newly installed conf/. Don’t 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[DAM]/Conf/ directory. In case of user-specific changes in backup conf/, please manually do all the changes in the newly installed [DAM]/conf/ directory.
  16. Follow the link Metadata Migration to migrate the metadata.
  17. Open preview-server.xml from [DAM]/conf/ and replace localhost with Server IP Address.preview-server
    If the Zoom Server and the 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.
  18. Open server.xml from [DAM]/conf/  
  19. Search and identify the <reviewserverspec> section.
  20. Remove this entire tag – starting from "<reviewserverspec>" phrase and ending with "</reviewserverspec>"
  21. 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>
  22. 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:befaft
  23. Replace 0.0.0.0 in <host> tag of the <networkspec> and <webserverspec> with the Zoom Server’s  IP Address.
  24. The <host> tag in the <ServerConnection> which is in the <reviewserverspec> section must contain the Zoom Preview Server IP address.
  25. If the Zoom Server and the Preview Server are running on the same machine, all three tags will be pointing to the same address.
  26. 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
  27. 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.
  28. If you had moved the db folder out of the install directory in the beginning, move it back to the install directory now (overwriting newly created empty db folder).
  29. In Windows Services, Start the Zoom Server and Zoom Preview Server services.
  30. Check the Zoom Version.

Zoom Server Upgrade From 5.2 to 5.3

Upgrade Instructions From 5.2 to 5.3:

The following instructions describe how to upgrade a Zoom Server installed on Windows 7/8. These instructions assume you have downloaded the zoom-server-win64.zip from the Zoom Support Center.

  1. In Windows ServicesStop the Zoom Server and Zoom Preview Server  (Only if the Preview Server is configured to run on the same machine as the Zoom Server) services.
  2. Edit the [DAM]/conf/server.xml file in a text editor.
  3. Search for the <autoRestartEnabled> tag and the <doCheckpoint> tag under the <autorestartspec> section, and set them 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. In Windows Services, restart the Zoom Server service.
    For information on how to restart, refer to Starting and Stopping Zoom Services (Windows) .
  6. In Windows Services, stop the Zoom Server and Zoom Preview Server services.
  7. Navigate to the Zoom install directory [DAM].
    On Windows, this is located in C:\Program Files (x86)\Evolphin\DAM.
  8. Copy or backup the conf folder; Also move the db folder out of the installation folder.
    If your db folder is located outside the install directory [DAM], you do not need to move or backup the db folder.
  9. Go to Control Panel>Program and Features and Uninstall Evolphin Zoom.
  10. Follow the instructions in the uninstall wizard.
  11. Unzip the zoom-server-win64.zip downloaded from the Zoom Support Center.
  12. Once unzipped, navigate to the setup.exe and double click it.
  13. Follow the instructions for the Zoom installer.
  14. Restart your computer.
    When your computer restarts, the service will start automatically on launch. Go to your Services and stop the Zoom Server and Zoom Preview Server services prior to continuing.
  15. Copy all files/folders from backup conf and replace them in new [DAM]/conf/
    Make sure to manually copy all files/folders from the backup conf. Don’t delete any file/folder from the newly installed [DAM]/conf folder.
  16. Please refer to steps 14 and 15 from the previous section outlining the upgrade instructions from 5.0 to 5.2 or greater; modify the server.xml and preview-server.xml as per the instructions given in these steps.
  17. If you had moved out the db folder, move it back into the [DAM] folder now.
  18. In Windows Services, Start the Zoom Server and Zoom Preview Server services.
  19. Check the Zoom Version.
Customers who are currently using Zoom 4.x builds will have to first upgrade to Zoom 5.0 and then upgrade to Zoom 5.3 build. Click here to check instructions on how to upgrade from Zoom 4.x series

Zoom Server Upgrade From 5.3 to Newer Versions

Upgrade Instructions From 5.3 to Newer Versions:

The following instructions describe how to upgrade a Zoom Server installed on Windows 7/8. These instructions assume you have downloaded the zoom-server-win64.zip from the Zoom Support Center.

  1. In Windows Servicesstop the Zoom Server and Zoom Preview Server (Only if the Preview Server is configured to run on the same machine as the Zoom Server) services.
  2. Edit the [DAM]/conf/server.xml file in a text editor.
  3. Search for the <autoRestartEnabled> tag and the <doCheckpoint> tag under the <autorestartspec> section, and set them 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. In Windows Services, restart the Zoom Server service.
  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 the message:
    “Redo log checkpointing ended”
    in the server_log.0 file. Only look for the latest entry in the file.
  7. In Windows Services, stop the Zoom Server and Zoom Preview Server services.
    For information on how to start and stop services, refer to Starting and Stopping Zoom Services (Windows)
  8. Navigate to the Zoom install directory [DAM].
    On Windows, this is located in C:\Program Files (x86)\Evolphin\DAM.
  9. Copy or backup the conf folder; Also move the db folder out of the installation folder.
    If your db folder is located outside the install directory [DAM], you do not need to move or backup the db folder.
  10. Go to Control Panel>Program and Features and Uninstall Evolphin Zoom.
  11. Follow the instructions in the uninstall wizard.
  12. Unzip the zoom-server-win64.zip downloaded from the Zoom Support Center.
  13. Once unzipped, navigate to the setup.exe and double click it.
  14. Follow the instructions for the Zoom installer.
  15. Restart your computer.
    When your computer restarts, the service will start automatically on launch. Go to your Services and stop the Zoom Server and Zoom Preview Server services prior to continuing.
  16. Copy zoom.key from backup conf/ and paste it in the newly installed [DAM]/conf/ directory.
  17. Copy the following files from backup conf/ and replace them in the newly installed [DAM]/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 [DAM]/conf/ directory. In case of user-specific changes in backup conf/, please manually do all the changes in the newly installed [DAM]/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 the same flag in wrapper.conf of newly installed [DAM]/conf/ directory.
  18. If you had moved out the db folder, move it back into the [DAM] folder now.
  19. In Windows Services, Start the Zoom Server and Zoom Preview Server services.
  20. Check the Zoom Version.
    Customers who are at revisions before 5.3, please see the previous sections for upgrade instructions.

Leave a Comment