(3.6 - 3.9) Uninstalling IVG

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 requires no modification, and uninstalls all IVG components and dependencies when executed.

The uninstaller also creates a separate .yaml file that contains the voice platform application provisioning data. This file can be referenced to re-provision the voice application parameters if IVG is re-installed.

Uninstalling 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 location where ivguninstaller-xxxx was saved.
  • Copy ivguninstaller-xxxx to the VM where IVG will be uninstalled.
  • Run the following command to change the permissions:

chmod a+x ivguninstaller- xxxx

  • Run the following command to execute the uninstall file:

./ivguninstaller-xxxx| tee uninstall_mmddyy

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 uninstaller.
  • 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.

IVG uninstaller process

The IVG uninstaller process uninstalls the components and dependencies of IVG that were installed on the VM by reading the uninstall_ivg.cfg file created during installation. The uninstall_ivg.cfg is compiled by the IVG installer process as it executes, and contains the information required to uninstall IVG from the VM.

The following topics detail what is uninstalled for each component.

Important

The /etc/VirtualHold directory is not removed by the uninstaller.

Uninstall VIS, Voice Files, and CCIS

The IVG uninstaller performs the following to uninstall the VXML Interaction Server (VIS), voice files, and Call Control Interaction Server (CCIS):

  • Uninstalls VIS, CCIS, and its dependencies:
    • Uninstalls Apache Tomcat.
      • Removes cron jobs, VIS, Voices, and CCIS
    • Uninstalls Java.

The toolkit.properties file is not removed.

Uninstall PostgreSQL Database

The IVG uninstaller performs the following to uninstall the PostgreSQL database:

  • Uninstalls the following prerequisites for the PostgreSQL database:
    • postgres-client
    • ruby
  • Uninstalls the PostgreSQL database.

Important

If the PostgreSQL database is uninstalled from a multiple IVG system, the remaining IVG instances that read from the database will not work.

Uninstall Voice Platform and Dependencies

The IVG uninstaller performs the following to uninstall the voice platform and its dependencies:

The uninstaller only removes dependencies installed by the installer. If a dependency was previously installed independent of IVG, the uninstaller does not remove it.

  • Enables SELinux.
  • Uninstalls voice platform dependencies:
    • gzip
    • libais
    • libcurl
    • libogg
    • libvorbis
    • libxml2
    • libxslt
    • libyaml
    • ncurses
    • net-snmp
    • openssl
    • speex
    • tcsh
    • xerces
    • zsh

The uninstaller does not uninstall the following OS dependencies:

  • CentOS
    • perl
    • perl-libs
  • RHEL
    • expect
    • tcl
    • ksh
  • Uninstalls voice platform, including patches.
  • The voice platform provisioning .yaml file is placed in the /etc/VirtualHold/backup directory.