RedHat/CentOS 7 Alpaca BroadWorks Version Upgrade

This is a lateral upgrade guide for Alpaca on a particular version of BroadWorks going to a newer version of BroadWorks. i.e. Alpaca R21sp1 -> Alpaca R22.


  • An existing installation of Alpaca.
  • Credentials to access the Alpaca server as root.
  • Working knowledge of ssh and file transfer tool such as scp.
  • BroadWorks system has been upgraded to a newer version.


The guide is split into sections based on the server or machine that the operations should be performed. It is also in chronological order. Performing the steps from top to bottom is the desired procedure.

Local Work Station

Alpaca Server & BroadWorks Application Server

The steps to upgrade Alpaca Server and Alpaca Remote are the same. These steps will reference Alpaca Server, for Alpaca Remote upgrade, make sure to use the appropriate package name.

Uninstall Previous Version

  • Step: U-1
  • Commands:

    1. Turn off the existing Alpaca service.
      • # service alpaca-server stop
    2. Uninstall using yum

      • Any modified configuration file will be automatically backed up as file.extension.rpmsave in the directory that they are currently in.
      • Note the configuration location for
        • Alpaca 7.1.0+: /etc/alpaca/<Alpaca_Package>/config
        • Pre Alpaca 7.1.0: /opt/alpaca/config
      • # yum -y remove alpaca-server-.x86_64

        Running transaction
        Stopping alpaca-server (via systemctl):  [  OK  ]
          Erasing    : alpaca-server-<BW_VERSION>-<ALPACA_VERSION>.x86_64                                                                             1/1
        warning: /opt/alpaca/configuration saved as /opt/alpaca/configuration.rpmsave
        warning: /etc/alpaca/server/config/log4j2.xml saved as /etc/alpaca/server/config/log4j2.xml.rpmsave
        warning: /etc/alpaca/server/config/application-prod.yml saved as /etc/alpaca/server/config/application-prod.yml.rpmsave
        warning: /etc/alpaca/server/config/application-https.yml saved as /etc/alpaca/server/config/application-https.yml.rpmsave
          Verifying  : alpaca-server-<BW_VERSION>-<ALPACA_VERSION>.x86_64                                                                             1/1
          alpaca-server-<BW_VERSION>.x86_64 0:<ALPACA_VERSION>

Install New Version

  • Step: I-1
  • Commands:

    1. # cd /tmp
    2. # yum install -y alpaca-server-ALPACA_VERSION.x86_64.rpm

        alpaca-server.x86_64 0:<ALPACA_VERSION>
      Dependency Installed:
        alsa-lib.x86_64 0:1.1.6-2.el7                                        copy-jdk-configs.noarch 0:3.3-10.el7_5                dejavu-fonts-common.noarch 0:2.33-6.el7           dejavu-sans-fonts.noarch 0:2.33-6.el7
        fontconfig.x86_64 0:2.13.0-4.3.el7                                   fontpackages-filesystem.noarch 0:1.44-8.el7           giflib.x86_64 0:4.1.6-9.el7                       java-1.8.0-openjdk.x86_64 1:
        java-1.8.0-openjdk-headless.x86_64 1:           javapackages-tools.noarch 0:3.4.1-11.el7              libICE.x86_64 0:1.0.9-9.el7                       libSM.x86_64 0:1.2.2-2.el7
        libX11.x86_64 0:1.6.5-2.el7                                          libX11-common.noarch 0:1.6.5-2.el7                    libXau.x86_64 0:1.0.8-2.1.el7                     libXcomposite.x86_64 0:0.4.4-4.1.el7
        libXext.x86_64 0:1.3.3-3.el7                                         libXi.x86_64 0:1.7.9-1.el7                            libXrender.x86_64 0:0.9.10-1.el7                  libXtst.x86_64 0:1.2.3-1.el7
        libfontenc.x86_64 0:1.1.3-3.el7                                      libjpeg-turbo.x86_64 0:1.2.90-6.el7                   libpng.x86_64 2:1.5.13-7.el7_2                    libxcb.x86_64 0:1.13-1.el7
        libxslt.x86_64 0:1.1.28-5.el7                                        lksctp-tools.x86_64 0:1.0.17-2.el7                    mongodb-org.x86_64 0:4.0.5-1.el7                  mongodb-org-mongos.x86_64 0:4.0.5-1.el7
        mongodb-org-server.x86_64 0:4.0.5-1.el7                              mongodb-org-shell.x86_64 0:4.0.5-1.el7                mongodb-org-tools.x86_64 0:4.0.5-1.el7            python-javapackages.noarch 0:3.4.1-11.el7
        python-lxml.x86_64 0:3.2.1-4.el7                                     ttmkfdir.x86_64 0:3.0.9-42.el7                        tzdata-java.noarch 0:2018i-1.el7                  xorg-x11-font-utils.x86_64 1:7.5-21.el7
        xorg-x11-fonts-Type1.noarch 0:7.5-9.el7
      Dependency Updated:
        freetype.x86_64 0:2.8-12.el7          nspr.x86_64 0:4.19.0-1.el7_5         nss.x86_64 0:3.36.0-7.el7_5     nss-softokn.x86_64 0:3.36.0-5.el7_5     nss-softokn-freebl.x86_64 0:3.36.0-5.el7_5     nss-sysinit.x86_64 0:3.36.0-7.el7_5
        nss-tools.x86_64 0:3.36.0-7.el7_5     nss-util.x86_64 0:3.36.0-1.el7_5
  • Step: I-2

  • Remove default configurations and replace with backed up ones.

    • Possible files that could have been backed up:
      • application-prod.yml
      • application-https.yml
      • log4j2.xml
      • configuration
    • Use rm to remove the default configuration file
      • rm file.extension
    • Use mv to rename the backed up configuration
      • mv file.extension.rpmsave file.extension
  • Step: I-3

  • Commands:

    1. # service alpaca-server start

      Starting alpaca-server.d (via systemctl): [ OK ]