(3.6) IVG installer process

Overview

After configuring the configuration files, the IVG Installer automatically installs the necessary components onto the designated Virtual Machine (VM). The details of what the IVG Installer installs are detailed by deployment model below.

Standalone IVG

A single IVG Installation installs all necessary components and prerequisites onto a single VM. The automatic installation process performs the following:

  • Verifies the correct version of CentOS or RHEL are installed.
    • Verifies the RHEL subscription is registered (if applicable).
    • Verifies the OS architecture is 64-bit.

Note:

Refer to the Callback Compatibility and Integration Matrix for supported OS versions.

  • Prepares the Linux environment.
    • Adds hostname and FQDN to /etc/hosts file.
    • Enables Firewalls
    • Turns on IP tables
    • Checks for SELinux as enabled or disabled.

Notes:

  • If only the FQDN exists in the /etc/hosts file, the installer adds the hostname in this step.
  • For a list of ports opened by the platform, please reference Appendix A of the HVP Linux Installation Guide.
  • Verifies the / partition has 1 GB of free disk space.
  • If the / partition has less than 1 GB of free disk space, a warning message stating that VHT recommends at least 1 GB of disk space for installation of the necessary Linux operating system dependencies is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the hollyinstallpath partition has 5 GBs of free disk space.
  • If the hollyinstallpath partition has less than 5 GBs of free disk space, a warning message stating that VHTrecommends at least 5 GBs of disk space for installation of the HVP components used by IVG is displayed. Enter yto continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the /tmp partition has 4 GBs of free disk space.
  • If the /tmp partition has less than 4 GBs of free disk space, a warning message stating that VHT recommends at least 4 GBs of disk space for temporary storage of fetched audio, documents, and scripts is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the Swap space is equal to the amount of memory (RAM).
  • If the Swap space is less than the amount of memory (RAM), a warning message stating that VHT recommends the Swap space be equal to the memory space for installation of IVG is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Sets server umask value to 0022.

Note:

Setting umask to 0022 instead of 0027 allows all users to read, write, and run files from all directories. This permits full usage of IVG.

  • Verifies the installation and correct version of the following OS dependencies for the voice platform. The prerequisites and their supported versions are located in the prerequisites folder of the ivginstaller-XXXX.zipfile:
    • cyrus-sasl-plain
    • expat
    • expect
    • gzip
    • ksh
    • libaio
    • libcurl
    • libogg
    • libvorbis
    • libxml2
    • libxslt
    • libyaml
    • mailx
    • ncurses
    • net-snmp
    • nfs-utils
    • openssl
    • pcre
    • perl
    • postgresql92-server
    • speex
    • xerces (CentOS)
    • xerces-c (RHEL)
    • tcsh
    • zsh

Notes:

  • If a supported version of a dependency is already installed, the installer skips to the next dependency.
  • If an unsupported version of a dependency is installed, the installer uninstalls the unsupported version and installs the supported version.
  • Installs the PostgreSQL database.
  • Installs HVP and any required patches.
    • Creates the voice platform database with tablespace for:
      • Configuration
      • Logs
    • Starts the required HVP workers.
    • Applies performance enhancement default values.
  • Installs the SELinux security policies (if enabled in Step 2) by executing the install_hollyhvp_selinux_policy.ksh script.

Note:

If SELinux is enabled, the IVG Installer provides an option to install SELinux policies. The policies allow HVP to function normally during SELinux enforcement, and avoid SELinux imposing limitations on the installation and operation of the platform. Please refer to Section 6 of the HVP Installation Guide for further information.

  • Installs VXML Interaction Server (VIS) and its dependencies:
    • Verifies the supported version of Java Runtime Environment (JRE) is installed.

Notes:

  • If a supported version of Java is already installed, the installer skips this step.
  • If an unsupported version of Java is installed, the installer uninstalls the unsupported version and installs the supported version.
  • Verifies the supported version of Apache Tomcat Version installed.
  • Publishes the VIS .war files under tomcat/webapps folder.
  • Publishes the voices media files to webapps folder.
  • Creates the name files folder under tomcat/webapps/ROOT.
  • Configures the toolkit.properties file under /etc/VirtualHold folder.
  • Creates a cron job for deleting old name files older than 8 days.
  • Creates a cron job for deleting old PostgreSQL logs older than 30 days.
  • Runs the HVP Call Control Interaction Server (CCIS) installation.
    • Publishes the vht-ivg.war file under tomcat webapps.
    • Configures the voice platform parameters from the hvp_params.cfg file.
  • Creates the uninstall_ivg.cfg file and places it at /etc/VirtualHold/.
  • The installer restarts HVP to complete installation.
  • The installer restarts the VM.

Multiple IVG

The IVG Installer must be executed on multiple VMs: the first VM will contain the database and the first IVG instance, and subsequent VMs will contain the additional IVG instances. The installation process of each VM is detailed below.

IVG and local PostgreSQL database

The IVG Installer performs the following steps to install the PostgreSQL database on the first VM.

  • Verifies CentOS or RHEL version 6.8 or 7.3 are installed.
    • Verifies the RHEL subscription is registered (if applicable).
    • Verifies the OS architecture is 64-bit.

Note:

Refer to the Callback Compatibility and Integration Matrix for supported OS versions.

  • Prepares the Linux environment.
    • Adds hostname and FQDN to /etc/hosts file.
    • Enables Firewalls (CentOS or RHEL 7.3)
    • Turns on IP tables (CentOS or RHEL 6.8)
    • Checks for SELinux as enabled or disabled.

Notes:

  • If only the FQDN exists in the /etc/hosts file, the installer adds the hostname in this step.
  • For a list of ports opened by the platform, please reference Appendix A of the HVP Linux Installation Guide.
  • Verifies the / partition has 1 GB of free disk space.
  • If the / partition has less than 1 GB of free disk space, a warning message stating that VHT recommends at least 1 GB of disk space for installation of the necessary Linux operating system dependencies is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the hollyinstallpath partition has 5 GBs of free disk space.
  • If the hollyinstallpath partition has less than 5 GBs of free disk space, a warning message stating that VHTrecommends at least 5 GBs of disk space for installation of the HVP components used by IVG is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the /tmp partition has 4 GBs of free disk space.
  • If the /tmp partition has less than 4 GBs of free disk space, a warning message stating that VHT recommends at least 4 GBs of disk space for temporary storage of fetched audio, documents, and scripts is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the Swap space is equal to the amount of memory (RAM).
  • If the Swap space is less than the amount of memory (RAM), a warning message stating that VHT recommends the Swap space be equal to the memory space for installation of IVG is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Sets server umask value to 0022.

Note:

Setting umask to 0022 instead of 0027 allows all users to read, write, and run files from all directories. This permits full usage of IVG.

  • Verifies the installation and correct version of the following OS dependencies for the voice platform. The prerequisites and their supported versions are located in the prerequisites folder of the ivginstall-XXXX.zipfile:
    • cyrus-sasl-plain
    • expat
    • expect
    • gzip
    • ksh
    • libaio
    • libcurl
    • libogg
    • libvorbis
    • libxml2
    • libxslt
    • libyaml
    • mailx
    • ncurses
    • net-snmp
    • nfs-utils
    • openssl
    • pcre
    • perl
    • postgresql92-server
    • speex
    • xerces (CentOS)
    • xerces-c (RHEL)
    • tcsh
    • zsh

Notes:

  • If a supported version of a dependency is already installed, the installer skips to the next dependency.
  • If an unsupported version of a dependency is installed, the installer uninstalls the unsupported version and installs the supported version.
  • Installs the PostgreSQL database.
  • Installs HVP and any required patches.
    • Creates the voice platform database with tablespace for:
      • Configuration
      • Logs
    • Starts the required HVP workers.
    • Applies performance enhancement default values.
  • Installs the SELinux security policies (if enabled in Step 2) by executing the install_hollyhvp_selinux_policy.ksh script.

Note:

If SELinux is enabled, the IVG Installer provides an option to install SELinux policies. The policies allow HVP to function normally during SELinux enforcement, and avoid SELinux imposing limitations on the installation and operation of the platform. Please refer to Section 6 of the HVP Installation Guide for further information.

  • Installs VXML Interaction Server (VIS) and its dependencies:
    • Verifies the supported version of Java Runtime Environment (JRE) is installed.

Notes:

  • If a supported version of Java is already installed, the installer skips this step.
  • If an unsupported version of Java is installed, the installer uninstalls the unsupported version and installs the supported version.
  • Verifies the supported version of Apache Tomcat Version installed.
  • Publishes the VIS .war files under tomcat/webapps folder.
  • Publishes the voices media files to webapps folder.
  • Creates the name files folder under tomcat/webapps/ROOT.
  • Configures the toolkit.properties file under /etc/VirtualHold folder.
  • Creates a cron job for deleting old name files older than 8 days.
  • Creates a cron job for deleting old PostgreSQL logs older than 30 days.
  • Runs the HVP Call Control Interaction Server (CCIS) installation.
    • Publishes the vht-ivg.war file under tomcat webapps.
    • Configures the voice platform parameters from the hvp_params.cfg file.
  • Creates the uninstall_ivg.cfg file and places it at /etc/VirtualHold/.
  • The installer restarts the HVP to complete installation.
  • The installer restarts the VM.

IVG and remote PostgreSQL database

The IVG Installer performs the following steps to install IVG on subsequent VMs.

  • Verifies CentOS or RHEL version 6.8 or 7.3 are installed.
    • Verifies the RHEL subscription is registered (if applicable).
    • Verifies the OS architecture is 64-bit.

Note:

Refer to the Callback Compatibility and Integration Matrix for supported OS versions.

  • Prepares the Linux environment.
    • Adds hostname and FQDN to /etc/hosts file.
    • Enables Firewalls (CentOS or RHEL 7.3)
    • Turns on IP tables (CentOS or RHEL 6.8)
    • Checks for SELinux as enabled or disabled.

Notes:

  • If only the FQDN exists in the /etc/hosts file, the installer adds the hostname in this step.
  • For a list of ports opened by the platform, please reference Appendix A of the HVP Linux Installation Guide.
  • Verifies the / partition has 1 GB of free disk space.
  • If the / partition has less than 1 GB of free disk space, a warning message stating that VHT recommends at least 1 GB of disk space for installation of the necessary Linux operating system dependencies is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the hollyinstallpath partition has 5 GBs of free disk space.
  • If the hollyinstallpath partition has less than 5 GBs of free disk space, a warning message stating that VHT recommends at least 5 GBs of disk space for installation of the HVP components used by IVG is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the /tmp partition has 4 GBs of free disk space.
  • If the /tmp partition has less than 4 GBs of free disk space, a warning message stating that VHT recommends at least 4 GBs of disk space for temporary storage of fetched audio, documents, and scripts is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Verifies the Swap space is equal to the amount of memory (RAM).
  • If the Swap space is less than the amount of memory (RAM), a warning message stating that VHT recommends the Swap space be equal to the memory space for installation of IVG is displayed. Enter y to continue or n to exit IVG installation.

Note:

Your IVG system will required more free disk space than this minimum value. Adjust your system resources accordingly.

  • Sets server umask value to 0022.

Setting umask to 0022 instead of 0027 allows all users to read, write, and run files from all directories. This permits full usage of IVG.

  • Verifies the installation and correct version of the following OS dependencies for the voice platform.The prerequisites and their supported versions are located in the prerequisites folder of the ivginstall-XXXX.zipfile:
    • cyrus-sasl-plain
    • expat
    • expect
    • gzip
    • ksh
    • libaio
    • libcurl
    • libogg
    • libvorbis
    • libxml2
    • libxslt
    • libyaml
    • mailx
    • ncurses
    • net-snmp
    • nfs-utils
    • openssl
    • pcre
    • perl
    • postgresql92-server
    • speex
    • xerces (CentOS)
    • xerces-c (RHEL)
    • tcsh
    • zsh

Notes:

  • If a supported version of a dependency is already installed, the installer skips to the next dependency.
  • If an unsupported version of a dependency is installed, the installer uninstalls the unsupported version and installs the supported version.
  • Installs HVP and any required patches.
    • Creates the voice platform database with tablespace for:
      • Configuration
      • Logs
    • Starts the required HVP workers.
    • Applies performance enhancement default values.
  • Installs the SELinux security policies (if enabled in Step 2) by executing the install_hollyhvp_selinux_policy.ksh script.

Note:

If SELinux is enabled, the IVG Installer provides an option to install SELinux policies. The policies allow HVP to function normally during SELinux enforcement, and avoid SELinux imposing limitations on the installation and operation of the platform. Please refer to Section 6 of the HVP Installation Guide for further information.

  • Installs VXML Interaction Server (VIS) and its dependencies:
    • Verifies the supported version of Java Runtime Environment (JRE) is installed.

Notes:

  • If a supported version of Java is already installed, the installer skips this step.
  • If an unsupported version of Java is installed, the installer uninstalls the unsupported version and installs the supported version.
  • Verifies the supported version of Apache Tomcat Version installed.
  • Publishes the VIS .war files under tomcat/webapps folder.
  • Publishes the voices media files to webapps folder.
  • Creates the name files folder under tomcat/webapps/ROOT.
  • Configures the toolkit.properties file under /etc/VirtualHold folder.
  • Creates a cron job for deleting old name files older than 8 days.
  • Creates a cron job for deleting old PostgreSQL logs older than 30 days.
  • Runs the HVP Call Control Interaction Server (CCIS) installation.
    • Publishes the vht-ivg.war file under tomcat webapps.
  • Creates the uninstall_ivg.cfg file and places it at /etc/VirtualHold/.
  • The installer restarts HVP to complete installation.
  • The installer restarts the VM.

Notes:

This installation process is repeated for any additional IVG instances installed on dedicated VMs.

Standalone PostgreSQL

The IVG Installer performs the following steps to install the PostgreSQL database on the first VM.

  • Run the IVG Installer to complete the installation process. The IVG Installer installs the PostgreSQL database on the server by performing the following:
  • Install the prerequisites for PostgreSQL. The prerequisites and supported versions are located in the prerequisites folder of the ivginstaller-XXXX.zipfile.
    • expect
    • ksh
    • perl
    • postgresql95
    • postgres-client
    • ruby
  • Install the PostgreSQL database.
  • Creates the uninstall_ivg.cfg file and places it at /etc/VirtualHold/.