(5.0+) Checking IVG prerequisites
The Interactive Voice Gateway (IVG) prerequisite check verifies that each server in the solution satisfies the required prerequisites. We recommend running the prerequisite check before installing IVG, to verify that each IVG server is ready for installation.
Running the IVG prerequisite check
Use the following instructions to install IVG dependencies:
- Copy the ivg-dependencies-installer file to the first VM in your IVG solution.
- Enter the following command to change the permissions:
chmod a+x ivg-dependencies-installer-xxxx
- Enter the following command to execute the installer's check function:
./ivg-dependencies-installer-xxxx check
- Repeat Steps 1-3 on each VM in the IVG deployment.
IVG Prerequisite check process
The IVG prerequisite check performs the following process:
- Verifies an IP address is allocated to the VM
- Verifies the correct version of CentOS or RHEL is installed
- Verifies the RHEL subscription is registered, if applicable
- Verifies the OS architecture is 64-bit
- Verifies /etc/fstab is found mounted on tmpfs (/tmp)
- Verifies the installation and correct version of the OS dependencies for the voice platform. The prerequisites and their supported versions are located in the prerequisites folder within the ivginstaller-XXXX.zip file. For a complete list of dependencies, see the Linux operating system prerequisites article for your version of IVG.
- For dependencies not installed, the prerequisite check logs a list of dependencies that still need to be installed on the server.
- For dependencies already installed, the prerequisite check logs a list of existing dependencies and their version. When executed, the IVG installer skips these dependencies.
- For dependencies with a lower version than that packaged with IVG, the prerequisite check logs a list of dependencies to be updated on the server. When executed, the IVG installer installs the supported version of these dependencies.
- For dependencies with a higher version than that packaged with IVG, the prerequisite check logs a list of these dependencies. When executed, the IVG installer skips them.
- For dependencies with a 32-bit version, the prerequisite check logs a list of dependencies that need to be updated to 64-bit prior to executing the installer.
- Verifies the / partition has 1 GB of free disk space.
- We recommend at least 1 GB of disk space for installation of the necessary Linux operating system dependencies.
- Verifies the hollyinstallpath partition has 5 GB of free disk space.
- We recommend at least 5 GB of disk space for installation of the HVP components used by IVG.
- Verifies the /tmp partition has 4 GB of free disk space.
- Werecommend at least 4 GB of disk space for temporary storage of fetched audio, documents, and scripts.
- Verifies the Swap space is equal to the amount of memory (RAM).
- We recommend the Swap space be equal to the memory space.
Your IVG system will most likely require more free disk space than the minimums.
- Identifies the IVG deployment model based on the application_distribution key. Once the deployment model is identified, the prerequisite check identifies the components installed on the VM.
Example
The following IVG components are designated with a yes or no flag for installation:
- pginstall (PostgreSQL)
- hvpinstall (Voice Platform)
- visinstall (VXML Interaction Server)
- ccisinstall (Call Control Interaction Server)
- Verifies the user, group, and installation path for the voice platform, PostgreSQL, and Tomcat.
The prerequisite check creates the user, group, and installation path for the voice platform, PostgreSQL, and Tomcat. They are removed after the process is complete.
Prerequisite check results
Once the prerequisite check is complete, one of the following results is returned:
The IVG server meets the installation requirements. Please proceed with installing IVG.
This means that all prerequisites are satisfied and IVG can be installed on the VM.
The IVG server space requirements were not met. VHT best practices recommend meeting the space requirements, however IVG may still be installed.
This means that the space requirements are not met, however all other requirements are met. Installation can continue.
The IVG server does not meet the installation requirements, and IVG cannot be installed. Please see the error messages for additional details on the requirement errors.
In this case, the IVG prerequisite check determined that the VM does not meet the prerequisites required for IVG installation. Check the error messages returned from the prerequisite check and resolve them before trying again.