ID: 7167

Print Friendly, PDF & Email

Installing and setting up EZ

The EZ Updater setup requires atleast one EZ Downloader and one or more EZ Clients. We are starting with the EZ Downloader installation first. After that we will Configure the EZ Downloader so that EZ Client installation is made available to the client machines. Once the client machines have installed EZ Client, the EZ Updater system is ready to go auto-pilot!

Check that the prerequisites for EZ installation are fulfilled before proceeding further. These are listed here.

 

Access your support account or Evolphin support team’s email to 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 owner as “evolphin”.
    The user evolphin should be a non-sudo user.
  2. Extract the ezupdater-*-server.tar.bz2 file using 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 on 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, 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 is populated by a proper non-sudo user are 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 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 to true.

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

 

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

For each EZ Downloader, there should be at least one EZ Admin. The EZ Admin account created on any EZ Downloader machine can only be used locally on that machine.

EZ Admin account registration

The steps are as follows:

  1. Open EZ Web portal (https://localhost:5551).
  2. Click Sign Up on the login page. The user creation page is shown.

  3. Enter the details. All fields are mandatory. 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

Login to the EZ Web portal with the new EZ Admin account. On first login, 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 all contents and paste here.
  • Check for Update URL: It will show https://download.evolphin.com:5551 . Do not change this value as it is the Evolphin server from where the builds will be downloaded.
  • Check for Updates: Enter the update checking frequency. It is recommended to keep this as Every Day.
  • Click Save.

 

Products To Watch section

Select Zoom products as per your usage. Checking all four options is recommended. Click Save.

 

Products To Update section

Do not change anything except setting installation frequency to Automatic. Click Save.

 

Mail Settings section

Configure the mail settings so that the required people are notified by email when an event occurs in the EZ setup. All fields are mandatory:

  • Outgoing SMTP Server: Enter the outgoing SMTP server address
  • SMTP Server Port: Enter the port number used by the SMTP server.
  • SMTP User: Enter SMTP username or email address.
  • SMTP Password: Enter the password for the SMTP user account.
  • BCC List: Enter comma separated list of email addresses that will receive notifications from EZ. These users will get mails regarding all client machines managed by this EZ Downloader.
  • From: Enter the email address of the user from which the mail will be sent.
  • Security: Choose the security protocol in use from NONE, SSL, TLS.
  • Once these value are entered, click * Test Mail to test these settings. A mail should be received by every email address configured here. If not, recheck these settings.
  • After testing fine, click Save.

 

After the configuration in the last step, the EZ Downloader will automatically start downloading the Zoom builds from the Evolphin server as scheduled.

In the mean time, set up the EZ Clients. Access your support account or Evolphin support team’s email to download the EZ Updater Clients for Windows and Mac as needed. Follow these steps to upload the EZ Client setup(s) for use by the client machines:

  • Open EZ Web portal in a web browser. Login as the EZ Admin.
  • Click Upload EZ on the top menu bar.
  • 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 1-click install.

All fields are mandatory.

  • URL: This is the download link to be shared with all clients, so they can download the latest EZ Client bits to install.
  • Mac Build: Upload the latest EZ Client bits for Mac.
  • Windows Build: Upload latest EZ Client bits for Windows.
  • Downloader URL: Enter the default EZ Downloader URL for the the clients to communicate with. You must enter the address in form of https://[IP Address]:5551 where DNS name may also be used in place of IP address.
  • Default Zoom Server: This feature is not available in this beta release.
  • EZ Port: Enter the port number to be used by EZ for further communication, i.e. 5551.
  • Check For Update Frequency: Select update checking frequency to be used by the EZ Clients. It is recommended to choose Every Day.
  • Auto Update IP Address: Select to enable or disable automatic update of IP address value in the configuration files on the EZ Client machines. It is recommended to keep as true.
TRUE: it will not allow external connection (EZ Downloader machine) to push Zoom updates to the EZ Client machines. It will also mean that clients can access their EZ Web portal (https://localhost:5551) without any login screen. However, no one from outside the network will be able to access this portal.
FALSE: it will allow external connection (EZ Downloader machine) to push Zoom updates to EZ Client machines. This will allow anyone to access the webmin portal with valid credentials (the user credentials are generated as before for EZ Admin in Step 2 above). In this scenario, EZ Client will have to create user access for the EZ Web portal. This option is not supported for now.
  • Save these values.
  • Copy the URL to send out to Zoom Clients (copy the URL manually if Copy URL button does not work)
  • Share the URL over email or other means so that the clients may access it.

 

  • Download your OS specific build from https://[EZDownloaderIP]:5551/client/download.html (for e.g. https://192.168.0.17:5551/client/download.html). This link is shared by the EZ Admin.

 

  • Extract the zip file.
  • Execute ez-client.pkg or ez-client.msi file as per the OS.

You might need to explicitly allow the setup to run.

  • Follow the on-screen instructions to finish the installation.
  • The EZ Client now is ready. EZ Assistant is the application for accessing EZ Updater features on the EZ Client machines.
If the EZ Client already had Zoom Client, then after installing EZ Client make sure the installer for that version of Zoom Client is also available in EZ Downloader. This will be downloaded have saved by the EZ Client locally.

Even subsequently, whenever EZ Client tries to install a new Zoom update, the previous Zoom version may only be uninstalled if it is already available with the EZ Client.

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