Script installer for VideoFX

For Zoom versions up to 7.2, you have to use scripts to install hooks for various VideoFX functions.

These steps are only used for Zoom versions up to 7.2. These are not needed from Zoom 7.3 onwards.
 

After your servers have the necessary environment for VideoFX, we are ready to run the installer for scripts.

The VideoFX setup consists of three different sets of scripts to be copied and configured on the three servers involved (Zoom MAM Server, Ingest Server and Vantage Server). The installation package consists of all the scripts and the primary configuration file config.ini. This configuration file is the master copy containing all the relevant information necessary for the running of the all the scripts. The installation package must be unzipped first, and the config file must be initialized with appropriate values. The unzipped folder and the config file must then be copied over to each of the servers and then the installer must be executed locally on each of them. On running the installer, it copies the scripts and the config files in the correct folder hierarchy, sets appropriate permissions, and completes a few other tasks to get the VideoFX scripts ready for running.

These files and folders are set up by the installer on each server:

  • Zoom MAM Server
    • Archive hook script
    • Restore hook script
    • Direct ingest script
    • Autotask scripts

  • Ingest Server
    • Pre-Check-in hook script
    • Post-Check-in hook script

  • Vantage Server
    • Post-Vantage low-proxy ingest hook scripts

 

Follow the detailed instructions for running the script installer below: 

  1. Firstly, copy the installer from Evolphin support on one of your servers, Zoom MAM Server or the Ingest Server and extract the files

  2. From the extracted folder, open config.ini file for editing. Update the values in this config.ini file as described in this post. This step is important as the config.ini file will store all required parameters needed for setup.
  3. Copy the extracted ZoomScriptInstaller directory with the updated config.ini to your Zoom Server/Ingest Server/Vantage Server.
  4. Open config.ini for editing and update your super admin user credentials for the current server (Zoom, Ingest, or Vantage Server) in serverUserName and serverPassword parameters.
  5. Navigate to ZoomScriptInstaller directory.
  6. For a Linux machine, locate the .pl files and set execute permission for all of them.

  7. Run zoomScriptInstaller.pl on a Linux machine or double click zoomScriptInstaller.bat on a Windows machine.

  8. Enter the path where you want to install scripts and press enter.

  9. Enter the path of Zoom installation Directory on this machine (Windows: [ZoomInstallDir]\Evolphin\DAM; Linux: $home$/zoom).
  10. Select machine type and press enter.
    1. If you are running zoomscriptinstaller.bat on a Windows machine, like Vantage, then this is how the installer would run:

       

    2. On Linux, zoomScriptInstaller.pl would run as follows:
  11. The installer finishes with the required files copied to a folder named zoom-deploy in the path specified in step 9 above.
  12. Open zoom-deploy folder from the path chosen in step 9. This folder now has the necessary scripts for the server to run the VideoFX flow.
  13. On a Linux machine, you need to explicitly assign permissions to Zoom’s default user ‘evolphin’. Set owner as root and setuid permission for files pre-hook/makeReadableByOthers and post-hook/move. Follow these steps to give the necessary permissions:
    1. In the zoom-deploy folder, navigate to the folder pre-hook and run these commands:

    2. In the zoom-deploy folder, navigate to the folder post-hook and run these commands:

  14. Run a script file (.pl) in the Powershell or Terminal window to see if it can locate the required paths and resources.
    For example, this window below shows that the path ‘/home/evolphin/zoom-deploy/logs/pre-hook-Vantage.log’ does not exist.

  15. Fix the errors listed while running .pl scripts. If it relates to a path or permission, then make sure the path is accessible to the script file. If the error relates to missing Perl modules as shown below, then install the missing modules.

  16. Run .pl files and fix any errors with paths or permissions.
  17. For a server running Windows, run a bat file and check for errors. Fix any errors found with configuration, path or permissions.
  18. Repeat from step 4 for all your servers (Zoom MAM, Ingest, and Vantage Server).
  19. If you are using archive module with VideoFX, then continue by setting up the Archive Module as described here.