Alpaca Remote Installation

This is an installation guide for Alpaca Remote on BroadWorks Application Servers for reading audit logs and BroadWorks Xtended Services Platform Servers for reading access logs.

Assumptions

  • 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, Xtended Services Platform (XSP) Servers, 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 servers where Alpaca Remote will be installed.

Guide

This guide is divided 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

  • Step: O-1
    1. Download the Alpaca Remote installation RPM. This requires an ECG Portal Account.
    2. Transfer the downloaded installation package to each BroadWorks Application Server's "/tmp" directory.
    3. Transfer the downloaded installation package to each BroadWorks Xtended Services Platform Server's "/tmp" directory.

BroadWorks Application Server

  • Step: _AS-1
  • Commands:

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

      Installed:
      

      alpaca-remote-22.x86_64 0:8.8.6-RELEASE

      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:1.8.0.191.b12-1.el7_6 java-1.8.0-openjdk-headless.x86_64 1:1.8.0.191.b12-1.el7_6 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

      Complete!

    3. From your workstation log in to Alpaca. From there a BroadWorks cluster must be configured according to the Configuration Guide.

    4. Follow the Remote Client guide to setup Alpaca Remotes within the Alpaca Web UI. Remote Client Guide

    5. Configure Alpaca Remote according to the Configuration Guide.

    6. $ mv ecg.license.txt /opt/alpaca-remote

    7. $ service alpaca-remote start

Xtended Services Platform Server

  • Step: _XSP-1
  • Commands:

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

      Installed: alpaca-remote-22.x86_64 0:8.8.6-RELEASE

      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:1.8.0.191.b12-1.el7_6 java-1.8.0-openjdk-headless.x86_64 1:1.8.0.191.b12-1.el7_6 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

      Complete!

    3. From your workstation log in to Alpaca. From there a BroadWorks cluster must be configured according to the Configuration Guide.

    4. Follow the Remote Client guide to setup Alpaca Remotes within the Alpaca Web UI. Remote Client Guide

    5. Configure Alpaca Remote according to the Configuration Guide.

    6. $ mv ecg.license.txt /opt/alpaca-remote

    7. Add the Alpaca user to the bwadmin group. This is required due to the default permissions on the tomcat directory in /var/broadworks/logs/. $ usermod -G bwadmin alpaca

    8. $ service alpaca-remote start