Upgrading to IVG 4.1

To upgrade from IVG version 3.12 or earlier to IVG 4.1, you can either install IVG 4.1 on a new VM or uninstall your current version and install IVG 4.1 on the existing VM. To complete the upgrade, you will need to:
  • Capture the current IVG provisioning details
  • Back up the toolkit.properties file
  • Run the IVG Setup Wizard
  • Uninstall the current version of IVG
  • Install IVG 4.1

Step 1: Capture the current IVG provisioning details

Step 2: Back up the toolkit.properties fileBack up the toolkit.properties file prior to uninstalling IVG.

The file should is located at /etc/VirtualHold by default. After uninstalling IVG, place the toolkit.properties file in the /etc/VirtualHold directory on the new VM.

Step 3: Run the IVG Setup Wizard

Use the existing install_ivg.cfg file for your IVG deployment to install 4.1.

If you no longer have the configuration file available, you can use the Setup Wizard to create a new one before installing. The IVG Setup Wizard uses the information from the existing configuration file to populate each screen of the installer, while using default values for any new fields.

  • Select Load existing configuration file to edit.
  • Browse to the location where the previous install_ivg.cfg file was located.
  • Click Next to run the IVG Setup Wizard and update any configuration as needed.
  • Store the install_ivg.cfg file in an easily accessible place as it will be used in Step 5.

Step 4: Uninstall IVG

This step is only needed if you are using the same VM to install IVG 4.1. If you are using a new VM, you can proceed to Step 5. The IVG_xxxx.zip file that is used to install the Interactive Voice Gateway (IVG) also contains the ivguninstaller-xxxx file, which is used to uninstall IVG. The ivguninstaller-xxxx file uninstalls all IVG components and dependencies when executed.

Step 5: Install IVG 4.1

Install Interactive Voice Gateway (IVG) using the configuration file created by the IVG Setup Wizard.

Use the single IVG configuration file to install IVG on each VM in the solution.

  • Copy the ivginstaller file for version 4.1 to the VM where the first instance of IVG will be installed.
  • Copy the install_ivg.cfg file created by the IVG setup wizard in Step 3 to the VM where the first instance of IVG will be installed.

Do not copy the installer and configuration file to a directory name containing spaces.

  • Navigate to the directory containing the ivginstaller file.
  • Enter the following command to change file permissions:
    chmod a+x ivginstaller-xxxx
  • Enter the following command to execute the installer:
    ./ivginstaller-xxxxinstall | tee install:mmddyy.txt
    Where mmddyy is the date of the installation. The tee command saves a dated log of the IVG installation process.
  • Repeat Steps 1-5 on each VM in the solution.

The installer may take 10-15 minutes to complete.