Installation CentOS and RedHat
Installation tested on CentOS 7.
Prerequisites
- Java JDK 1.8
- Mongo Database
- Oracle TimesTen Java Libraries
- BroadWorks Profile Server Access
- Audit Log Network File Sharing
- Alpaca Service
Mongo Setup
Alpaca uses Mongo as it's backing database. A minimum of version 3.4 is required. The newest release can be found on Mongo's webpage.
Follow the official install instructions
TimesTen Setup
- Download the TimesTen installation archive.
- Extract and run
setup.sh
.- Installation as root is acceptable.
- The instance name can be anything and will determine directory name.
- Install in client only mode.
- Installation location can be anywhere. Our example commands use
/opt/TimesTen/tt1122
. - Do not restrict access to root or another group if other tools will be installed on the server.
- The TNS_ADMIN, quick start programs, documentation, HOST, and PORT can all be skipped.
- After installed, the TimesTen
lib
directory must be set in theALPACA_TT_LIB
environment variable for Alpaca to retrieve.-
echo "export ALPACA_TT_LIB=/opt/TimesTen/tt1122/lib" >> /etc/bashrc
- To add the path to the current shell run
source /etc/bashrc
-
- Remove obsolete JDBC drivers.
- In your TimesTen lib directory you will find multiple
ttjdbc*.jar
files. Alpaca only needsttjdcb8.jar
. - Create a backup directory and move all of the
ttjdcb*.jar
files except for thettjdcb8.jar
into this directory.
- In your TimesTen lib directory you will find multiple
- Add TimesTen
lib
directory to the linux library linking path.echo "/opt/TimesTen/tt1122/lib" > /etc/ld.so.conf.d/timesten.conf
- Verify that the TimesTen library is loaded by
ldconfig -v | grep TimesTen -A 20
. - The output should display the library links being created.
Profile Server Setup
The IP address of the Alpaca system must be in an access control list on the BroadWorks profile server to allow access to device configuration files.
- Login to the Profile Server.
- In the BWCLI navigate to
/Applications/BroadworksFileRepos/NetworkAccessLists/WebDav
. - Add the IP address of the Alpaca server.
add <IP_ADDRESS> description <DESCRIPTION>
- e.g., if there's no NAT and you're running Alpaca on 192.168.25.200, you could do:
add 192.168.25.200 "Alpaca workstation"
Application Server Open Client Server External Authentication ACL
Alpaca uses the XSPs to communicate via OCI to the Application Server. If the Application Server has an ACL configured for the OCS External Authentication, the XSPs must be listed.
- Login to the Application Server.
- In the BWCLI, login as an administrator and navigate to
/Applications/OpenClientServer/ExternalAuthentication/AccessControlList
- Use the
get
command to confirm if an ACL is configured.- If an ACL is configured, ensure the XSP which Alpaca will send OCI requests to is listed.
- Otherwise, if the XSP is not listed in the output, add the XSP using the following format.
add <XSP_IP_ADDRESS> description xsp
- Otherwise, if the XSP is not listed in the output, add the XSP using the following format.
- If no IPs are listed, then BroadWorks allows external authentication by default and no adjustments are necessary.
- If an ACL is configured, ensure the XSP which Alpaca will send OCI requests to is listed.
Audit Log NFS Setup
Alpaca indexes BroadWorks audit logs for each configured Application cluster. This requires access to a directory or directories housing BroadWorks Audit logs. This is typically done via NFS.
Source Application Server
- Make sure the following packages are installed:
nfs-utils-*
nfs-utils-lib-*
rpcbind-*
- Add the following line to the /etc/exports file.
-
/var/broadworks/logs/appserver <ALPACA_SERVER_IP>(ro,fsid=0,sync)
-
- Run the following commands:
chkconfig nfs on
chkconfig rpcbind on
service rpcbind start
service nfs start
Alpaca Server
- Add the following line to the
/etc/fstab
file.<BW_AS_IP>:/var/broadworks/logs/appserver <DESTINATION_DIRECTORY> nfs defaults 1 1
- Mount all the file systems listed in
/etc/fstab
:mount -a
- This will ignore those marked as “noauto”, excluded by the -t flag, or those that are already mounted.
BroadWorks Logging Configuration
Alpaca reads the Audit Logs created by the Application Servers to provide the historic details within specific log entries.
The following steps detail how to configure a BroadWorks Application Server to log the necessary details to the Audit Log file for Alpaca.
- Login to the Application Server's bwcli.
AS1# bwcli
- Navigate to the Audit Log's configuration enable verbose logging and accountInfo.
AS_CLI> cd /Applications/ExecutionAndProvisioning/PS/Logging/InputChannels/AuditLog
AS_CLI/Applications/ExecutionAndProvisioning/PS/Logging/InputChannels/AuditLog> set accountInfo true
AS_CLI/Applications/ExecutionAndProvisioning/PS/Logging/InputChannels/AuditLog> set verbose true
- The getRequest
option is not required by Alpaca.
- Next ensure AuditLogs are being output to a file.
AS_CLI/Applications/ExecutionAndProvisioning/PS/Logging/InputChannels/AuditLog> q;q;Output
AS_CLI/Applications/ExecutionAndProvisioning/PS/Logging/OutputChannels> get
- If the Audit logs are not enabled to be output to a file, enable the Audit Logs.
AS_CLI/Applications/ExecutionAndProvisioning/PS/Logging/OutputChannels> set AuditLog enabled true
Alpaca Setup
- Download the Alpaca tarball(.tar.gz) to the
/opt
directory on the server. - Extract the archive.
cd /opt
tar xzvf /opt/alpaca-21sp1-6.0.0-RELEASE-bin.tar.gz
- Create a symlink to the new alpaca directory.
-
ln -s alpaca-21sp1-6.0.0 /opt/alpaca
-
- Create an alpaca user.
useradd -m alpaca
- Change the ownership of the
/opt/alpaca
directory and all of its children.chown -R alpaca:alpaca /opt/alpaca/
- Copy the license file from the ECG portal
ecg.license.txt
into theconfig
directory. - Perform configuration according to Alpaca configuration guides.
- Copy the
alpaca
file into/etc/init.d
. - Run the following commands:
-
chkconfig --add alpaca
chkconfig alpaca on
-
- Launch service with
service alpaca start
. - Alpaca can then be accessed by visiting
http://<SERVER_IP>:8080
or other location as configured.