Alpaca Remote Installation

This is an installation guide for Alpaca Remote on a BroadWorks Application Server.


  • This is not an upgrade.
  • A valid SSL certificate for the Alpaca Server's hostname.
  • Credentials to access the Alpaca server as root.
  • Credentials to access the connected BroadWorks Application and Profile Servers.
  • BroadWorks Credentials to make changes via bwcli.
  • Working knowledge of ssh and file transfer tool such as scp.
  • Java 8 available on the Application Server.


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

BroadWorks Application Server

  • Step: _AS-1
  • Commands:

    1. $ cd /tmp
    2. $ yum install -y alpaca-remote-ALPACA_VERSION.x86_64.rpm

        alpaca-remote-21sp1.x86_64 0:6.6.0-RELEASE_1
      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                    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

    3. From your workstation log in to Alpaca. From there a BroadWorks cluster must be configured according to the Configuration Guide. An application server token will also need to be created for the cluster. This application server token will be configured on this application server in the "/opt/alpaca-remote/config/application-prod.yml" file under the "authenticationToken" field.

    4. Update the "hostname", "port", "broadWorksLicensePath", and "" configuration settings. Reference the Configuration Guide.

    5. $ mv ecg.license.txt /opt/alpaca

    6. $ service alpaca-remote start