Installing and setting up EZ

The EZ setup has at least one EZ Updater machine and one or more EZ Clients. We start with the EZ Updater installation first. After that, we configure the EZ Updater, so the EZ Client builds are available to client machines. Once the client machines have installed EZ Client (and Zoom Client), the EZ system is ready to go auto-pilot!

Check that the prerequisites for EZ are fulfilled before proceeding further.

If you run into any problems during installation, please check the EZ FAQs.

Step 1: Install EZ Updater

Access your support account for Evolphin support team’s email and download the EZ Updater for Windows or Linux as needed. These are the steps for installing it on Linux and Windows respectively:

EZ Updater for Linux

  1. Download the relevant setup (*.tar.bz2) file and save it locally, preferably at the home directory with the owner as “evolphin”.
    The user evolphin should be a non-sudo user.
  2. Extract the ezupdater-*-server.tar.bz2 file using the command below (* is the version).

    tar -jxvf ezupdater-*-server.tar.bz2

    The path where the ezupdater setup is extracted will also be used to install Zoom. A new folder named as ezupdater will be created in the same location as shown above.

  3. Change permission of /home/evolphin/ezupdater/bin/ezupdater to 755 so that anyone can execute it.
  4. Create EZ Updater service by copying the script from /home/evolphin/ezupdater/bin/ezupdater_init.d.sh  to /etc/init.d/ezupdater
    In order to copy scripts to /etc/init.d folder, the user needs root permission.
  5. Open /etc/init.d/ezupdater in any text editor and change the values of the variables EZ_HOME and EZ_USER.

    EZ_HOME is the installation directory. By default, it is set to /home.evolphin/ezupdater and it is used for installation.EZ_USER is the authorized user. By default, it is set to evolphin user and is used for installation.

  6. Change the permission of file /etc/init.d/ezupdater to 755

    Changing permission and making sure EZ_HOME and EZ_USER are populated by a proper non-sudo user is necessary.

  7. Start the services with the user evolphin

    /etc/init.d/ezupdater start OR service ezupdater start

  8. Check the status

    /etc/init.d/ezupdater status OR service ezupdater status

  9. Open [InstallationPath]\EvolphinZoomUpdaterData\conf\ez-updater.xml and change the value of <downloader> tag under <configuration> to true.
  10. Restart the ezupdater service.
  11. Check if the EvolphinZoomUpdaterData folder is created ([InstallationPath]/EvolphinZoomUpdaterData). The installation is successful.
    EvolphinZoomUpdaterData is the folder which contains all the configuration files, all the logs, and all the backup files.

EZ Updater for Windows

  1. Download the relevant setup (*.msi) file and save it locally.

  2. Execute the msi file.
  3. Follow the on-screen instructions to install EZ Updater.

  4. Open C:\Windows\System32\config\systemprofile\AppData\Roaming\EvolphinZoomUpdaterData\conf\ez-updater.xml and change the value of <downloader> tag under <configuration> to true.

  5. Restart the Evolphin Zoom Updater service.
  6. Check if the EvolphinZoomUpdaterData folder is created (C:\Windows\System32\config\systemprofile\AppData\Roaming\EvolphinZoomUpdaterData).
    EvolphinZoomUpdaterData is the folder that contains all the configuration files, all the logs, and all the backup files.

Step 2: Configure EZ Updater

After installation, the Evolphin Zoom Updater login page should open up. If it does not open, then manually open this link: https://localhost:5551. For the first run, we have to register an EZ Admin account on this EZ Web portal.

For each EZ Updater, there should be at least one EZ Admin account. The EZ Admin account created on an EZ Updater machine can only be used for that machine, not for another EZ Updater.

EZ Admin account registration

You need atleast one EZ Admin account to manage the EZ setup.

Follow these steps to create EZ Admin account:

  1. Open your EZ Web portal (https://[EZUpdaterIP]:[5551]).
  2. Click Sign Up on the login page. The user creation page is shown.
  3. Enter the details. All fields are mandatory. The master password should be copied as it is from ez-updater.xml under <masterPass> tag. The location of ez-updater.xml file is:

    Windows: C:\Windows\System32\config\systemprofile\AppData\Roaming\EvolphinZoomUpdaterData\conf\

    Linux: [InstallationPath]\EvolphinZoomUpdaterData\conf\

    Mac: /Library/Application\ Support/EvolphinZoomUpdaterData/conf/

  4. Submit the values. The EZ Admin user account is created.

Setting up EZ Updater

After registering an EZ Admin, move on to setting up the EZ Updater.

Follow these steps to configure your EZ Updater:

Login to the EZ Web portal with the EZ Admin account. On the first login with this EZ Admin account, the Settings page should open up. If for some reason the Settings page is not displayed, click on Settings tab in the top menu bar.

The following sections have to be configured:

EZ Updater Settings section

  • Client Name: Enter the unique company name provided by the Evolphin support in the ticket. The name should be exactly the same as provided in the ticket.
  • EZ Downloader License Number: Enter the unique license key text provided by the Evolphin support in the ticket. To do so, open the license file, select and copy all of its contents and paste here.
  • Check for Update URL: Our support team will give you the URL to the Evolphin Server from where the builds will be downloaded.
  • Check for Updates: Select the update check frequency. It is recommended to keep this as Every Day.

Click Save. Move to the next section.

Products To Watch section

Select Zoom products as per your usage. It is recommended to select all four options. Click Save.

Products To Update section

Set the installation frequency to Automatic. Do not change anything else in this section. Click Save.

Mail Settings section

Configure the mail settings so that all people required to be notified get an email when an event occurs in the EZ setup.

All fields are mandatory:

  • Outgoing SMTP Server: Enter the outgoing SMTP server name.
  • SMTP Server Port: Enter the port number used by the SMTP server.
  • SMTP User: Enter SMTP username.
  • SMTP Password: Enter the password for the SMTP user account.
  • BCC List: Enter a comma-separated list of email addresses that will receive notifications from EZ. These users will get emails regarding all client machines managed by this EZ Updater.
  • From: Enter the email address of the user from which the mail will be sent.
  • Security: Select the security protocol in use from NONE, SSL, or TLS.

Once these values are entered, click * Test Mail to test these settings. A mail should be received by every email address configured here. If not, recheck and update these settings.

After testing fine, click Save.

Step 3: Prepare and send the link for EZ Client installation

After the configuration in the last step, the EZ Updater will automatically start downloading the available Zoom builds from the Evolphin Server as scheduled.

In the meantime, set up the EZ Client machines. Access your support account or Evolphin support team’s email to download the EZ Updater Clients for Windows and Mac as needed (this is the same location from where you had downloaded the EZ Updater setup).

Do not attempt to set up Zoom Server builds for automatic installation. Zoom Server builds are only meant for manual installation after distribution from Evolphin.

Follow these steps to upload EZ Client build(s) that will be used to set up EZ Client machines:

  1. Open EZ Web portal in a web browser and log in as the EZ Admin.
  2. Click Upload EZ on the top menu bar.
  3. The Upload EZ page is displayed. This Upload EZ page gives the option to preconfigure and upload the EZ Client setup bits so that the clients are able to perform a 1-click install.
  1. Update the values as follows. All fields are mandatory.
    • Mac Build: Browse and open the file containing the latest EZ Client bits for Mac so it is uploaded and ready for your Zoom Client users on Mac.
    • Windows Build: Browse and open the file containing the latest EZ Client bits for Windows so it is uploaded and ready for your Zoom Client users on Windows.
    • Downloader URL: Enter the default EZ Updater URL for EZ Clients to communicate with. You must enter the address in the form of https://[IPAddress]:[Port] where DNS name may also be used in place of IP address. Only port 5551 is supported.
    • EZ Port: Enter the port number to be used by EZ for communicating with EZ Clients. Only port 5551 is supported right now.
    • Check For Update: Select update check frequency for the EZ Clients. It is recommended to choose Every Day.
  2. Save these values.
  3. Copy the URL to send out to Zoom Clients using the Copy URL button (or copy manually).
  4. Share the URL over email or other means so that all EZ Clients may access it.

Step 4: Install EZ Client

The last step in setting up EZ is to install it on the EZ Client machines (that will host Zoom Client). The build is shared by your EZ Admin after EZ Updater has been set up.

On the client machine, download your OS-specific build from the link shared by your EZ Admin. The link will point to the EZ Updater machine and should look like this: https://[EZUpdaterIP]:[EZPort]/client/download.html (for e.g. https://192.168.0.17:5551/client/download.html).

For first time Zoom set up on Windows clients, user needs to manually install Zoom Client either before or after installing the EZ Client. Zoom Updater Service would keep it up-to-date after that.

Only the link shared by your EZAdmin, that points to your EZ Updater (https://[EZUpdaterIP]:[EZPort]/client/download.html) should be used to install EZ Clients. Any other client builds will not work.

Follow these steps to install EZ Assistant for Windows or macOS:

  1. Download your OS-specific build from https://[EZUpdaterIP]:[EZPort]/client/download.html (for e.g. https://192.168.0.17:5551/client/download.html). This link is shared by the EZ Admin. The zip files are mac_ez_client.zip and win_ez_client.zip for each OS.

  2. Extract the zip file you need.

For Mac

  1. Check the extracted files.
  2. Locate the ez-client.pkg file in the extracted files. Sometimes, Safari can automatically extract the ZIP upon download.

  3. Right-click the ez-client.pkg file in the Finder and select Open With -> Installer.app

  4. A warning prompt might appear, informing about the installer. Click Open to start installing.

  5. Follow the on-screen instructions.
  6. During the installation, Installer.app might ask for permission to access the Downloads folder. Click OK to allow it to access the Downloads folder.

    If you deny permission to access the Downloads folder, then you would need to re-install the application again after unblocking the Installer app from Mac Security and Privacy settings. Click here for details.
  7. The installation proceeds after allowing access to the Downloads folder.
  8. Once the EZ Client is installed, it will start by searching for an update to the Zoom Client on this machine.
  9. If a Zoom Client update is available, a prompt is shown to install it.

  10. Click Install Now to begin Zoom Client upgrade/installation.
  11. The EZ Client runs the Evolphin Zoom Updater service to check and notify of Zoom Client updates at the frequency set by your EZ Admin.

For Windows

  1. As stated at the beginning, if you are installing EZ Client on a Windows machine that does not already have Zoom Client, then you need to install Zoom Client manually. The Zoom Client can be installed before or after the EZ Client.
  2. Check the extracted files.
  3. Locate the EZ installer, ez-client.msi file, in the extracted files.

  4. Double-click the ez-client.msi file to begin the installation of EZ Client.
  5. A warning prompt might appear, informing about the installer. Click More Info and then click Run anyway to start installing.

  6. The installation starts. Follow the on-screen instructions to finish the installation.
  7. Install the Zoom Client if it was not installed before.
  8. Once the EZ Client is installed, it will start by searching for an update to the Zoom Client on this machine.
  9. If a Zoom Client update is available, a prompt is shown to install it.
  10. Click Install Now to begin Zoom Client upgrade/installation.
  11. After Zoom Client is upgraded, EZ will prompt to restart. Click Yes to restart your computer.

  12. The latest available Zoom Client is now installed on the Client machine.
  13. The EZ Client runs the Evolphin Zoom Updater service to check and notify of Zoom Client updates at the frequency set by your EZ Admin.

The EZ Client now is ready. EZ Assistant is the application for accessing EZ Updater features on the EZ Client machines.

Windows client machine must be restarted after any Zoom update/installation by the EZ Client.

After installation, the EZ Assistant will start automatically and run the Evolphin Zoom Updater service to check for the latest available Zoom Client builds.

EZ is now ready to monitor and install Zoom Client builds as made available my your EZ Admin. Check EZ Client page to know about how EZ Assistant automates this.