Alpaca 7.2

Warning! You are viewing an older version of Alpaca Guides. View the latest

Alpaca Remote Installation

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

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

Guide

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

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

BroadWorks Application Server

Step: _AS-1

Commands:

$ cd /tmp

$ yum install -y alpaca-remote-ALPACA_VERSION.x86_64.rpm

Installed:
  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: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!

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.
Update the "hostname", "port", "broadWorksLicensePath", and "reader.directory" configuration settings. Reference the Configuration Guide.
$ mv ecg.license.txt /opt/alpaca
$ service alpaca-remote start