Upgrading to IVG 3.9
Interactive Voice Gateway (IVG) version 3.9.0 supports an upgrade from any of the following versions:
- 3.5.0
- 3.6.0
- 3.7.0
- 3.8.0
The IVG upgrade runs using the IVG Setup Wizard like a new installation. The IVG Setup Wizard imports the information from the existing configuration file on each screen of the installer, and populates any new screens with the default values. This process ensures the correct versions of the third party software - including Java, PostgreSQL, and Tomcat - are installed, and that the install_ivg.file is generated using the new IVG Setup Wizard with the correct keys, values, and syntax.
The upgrade process consists of the following activities:
- Backing up the toolkit.properties file
- Uninstall IVG to generate the uninstall file and export the provisioned data
- Run the IVG setup wizard and import the saved install_ivg.cfg file to generate a new install_ivg.cfg file
- Install IVG
Backing up the toolkit.properties file
Backup the toolkit.properties file prior to uninstalling IVG by saving a copy locally. After uninstalling IVG, re-install the toolkit.properties file on the VM.
Uninstalling IVG
The ./ivginstaller file also uninstalls IVG. The file requires no modification, and uninstalls all IVG components and dependencies when executed.
The uninstaller creates a separate .yaml file that contains the voice platform application provisioning data. Reference this file to re-provision the voice application parameters when re-installing IVG.
Use the following steps to uninstall IVG from a VM:
Root user access is required to perform the uninstall, and is only used for the duration of the uninstall process.
- Navigate to the directory where the ./ivginstallerwas saved.
- Copy the ./ivginstaller file to the VM where IVG will be uninstalled.
- Run the following command to change the permissions:
chmod a+x ivginstaller- xxxx
- Run the following command to execute the uninstall file:
./ ivginstaller- xxxx uninstall | tee install_ mmddyy .txt
Where mmddyy is the date of the uninstall
- The following message displays:
You have executed IVG uninstaller. This will uninstall all of the IVG components. Please confirm once again to proceed...? (y/n):
- Enter y to continue. Enter n to exit.
- The IVG components are uninstalled.
- The uninstaller creates a backup hvp_params.cfg configuration file and places it at /etc/VirtualHold/backup. This backup file contains all the voice platform configuration.
Important
The backup file is overwritten each time the uninstaller is executed.
- The uninstaller checks for the ivginstaller directory. If the directory is present, the uninstaller removes it.
- The VM is restarted.
Learn more in the Uninstalling IVG version 3.9 topic.
Running the IVG setup wizard
The IVG setup wizard builds the configuration file required for IVG installation. Each screen of the setup wizard collects installation details for IVG and its components, and compiles the user input into a single configuration file. This configuration file is then used to install IVG on each VM in the deployment.
Use existing configuration files to upgrade IVG. The IVG setup wizard uses the information from the existing configuration file to populate each screen of the installer, and populates any new screens with the default values.
Reinstalling IVG
Install Interactive Voice Gateway (IVG) on designated Linux VMs using the configuration file created by the IVG setup wizard. Use the single IVG configuration file to install IVG on each VM in the IVG deployment.
- Copy the ivginstaller file to the VM where the first instance of IVG will be installed.
- Copy the install_ivg.cfg file created by the IVG setup wizard to the VM where the first instance of IVG will be installed.
Important
The target directory name where the files are copied must not contain spaces.
- Navigate to the directory where the ivginstallerwas saved and open the installer.
- Enter the following command to change the 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. This saves a dated installation log of the IVG installation process.
- Repeat Steps 1-5 on each VM in the IVG deployment.
The installer may take 10-15 minutes to complete, which is marked by a IVG server restart.