Upgrading to IVG 5.3.2 or 5.3.3

Upgrading from IVG 5.3.x to the 5.3.2 or 5.3.3 patch involves two steps:

  • Install the new patch file for Holly Voice Portal (HVP):
    • HVP 7.2.19 for IVG 5.3.2
    • HVP 7.2.20 for IVG 5.3.3
  • Update version information in the version.txt file (/etc/VirtualHold/version.txt)

Install the HVP patch

  • Copy the Holly patch file to /export/home/holly-ivg on the IVG server.

File names for different versions are listed below.

IVG 5.3.2

  • For RHEL 7.9/CentOS 7.9, use HVP-7.2.19-3217-b899dfd-rh7.install
  • For RHEL 8.6, use HVP-7.2.19-3218-b899dfd-rh8.install

IVG 5.3.3

  • For RHEL 7.9/CentOS 7.9 use HVP-7.2.20-3247-45e6c41-rh7.install
  • For RHEL 8.6 use HVP-7.2.20-3248-45e6c41-rh8.install

In this document, the commands will reference the RHEL 8.6 patch file HVP-7.2.19-3218-b899dfd-rh8.install. Update the filename based on your OS, if needed.

  • Change the permissions of the patch file to be owned by the holly-ivg user with execute permissions.

For IVG 5.3.2:

chmod a+x /export/home/holly-ivg/HVP-7.2.19-3218-b899dfd-rh8.installchown holly-ivg:holly-ivg /export/home/holly-ivg/HVP-7.2.19-3218-b899dfd-rh8.install

For IVG 5.3.3:

chmod a+x /export/home/holly-ivg/HVP-7.2.20-3248-45e6c41-rh8.installchown holly-ivg:holly-ivg /export/home/holly-ivg/HVP-7.2. 20-3248-45e6c41-rh8.install
  • Log in as the holly-ivg user.
su - holly-ivg

You will be taken to the user's home path /export/home/holly-ivg. The HVP patch should already be there. The next few steps must be taken as the holly-ivg user.

  • Stop the hmsweb worker.
fm stop hmsweb
  • Run the Holly patch file to upgrade Holly.

For IVG 5.3.2:

./export/home/holly-ivg/HVP-7.2.19-3218-b899dfd-rh8.install

For IVG 5.3.3:

./export/home/holly-ivg/HVP-20-3248-45e6c41-rh8.install

Warnings related to .tar files are expected. You may see many warnings similar to the following examples, and they can be ignored.

tar: ./web/hmsrails/public/assets/v1/.sprockets-manifest-70dee2d68d042ccbf4fede090befd12e.json: Cannot stat:
No such file or directory

tar: ./web/hmsrails/public/assets/v1/application-71c108703dcaa09c7af225f04cbe0742d780bcf9e7b10617d2b1434881143943.css:
Cannot stat: No such file or directory

If successful, the last few lines of the output should appear as follows:

Update config (factory settings)
  browser
  callcontrol
  hmsweb
  openssl
  sip_ap
Release applied
  • Start the hmsweb worker.
fm start hmsweb
  • Restart Holly services
hvpctl restart
  • Run foreman to verify that all workers are running and that the holly version has been updated.
fm

Following is example output from foreman showing all Holly workers:

Fri Dec 16 08:58:33   installhvp04+holly-ivg   (HVP-7.2.19-3218-b899dfd)
Holly Foreman (2432984): up 2 h 36 min
  NAME                 OP           TIME   PID    MEM   CPU%  THR   FD  FAIL
  browser              ok        2:36:48 2433112 586.6M   0.00  427  418     0
  callcontrol          ok        2:36:48 2433010  86.2M   0.00   55   16     0
  configserver         /ok       2:36:53 2432942  46.4M   0.00   39   25     0
  ctieventconsumer     ok        2:36:48 2433060 109.9M   0.00   18   31     0
  foreman              /ok       2:36:48 2432984  10.0M   0.00   15   34     0
  hlm                  ok        2:36:48 2433012  16.8M   0.00   17   15     0
  hmspageserver        ok        2:36:48 2433013  17.6M   0.00    9    9     0
  hmsweb               ok        2:36:48 2433106  11.2M   0.00    1   20     0
  hvg                  ok        2:36:48 2433015  61.5M   0.50  835  429     0
  hvss                 ok        2:36:48 2433016  15.7M   0.00   15   13     0
  logmgr               ok        2:36:48 2433017  22.3M   0.00   24   18     0
  • Run the holly-version command to verify the Holly version is now HVP-7.2.19 (for IVG 5.3.2) or HVP-7.2.20 (for IVG 5.3.3).
holly-version

Update version information

After patching, the final step is to update version information for IVG and Holly in the version.txt file (/etc/VirtualHold/version.txt). You will need sudo/root user access to make the following changes.

For IVG 5.3.2:

  • Update the Holly Version to 7.2.19
  • Update the IVG version to 5.3.2

For IVG 5.3.3:

  • Update the Holly Version to 7.2.20
  • Update the IVG version to 5.3.3

Below is an example showing the two updates for version 5.3.2:

example version display