Warning! You are viewing an older version of Alpaca CLI Guides. View the latest
Installation for CentOS & RedHat
Prerequisites
-
Java JDK 1.8
- The newest release can be found on Oracle's webpage.
-
Oracle TimesTen
- See below for specific instructions.
- The IP address of the Alpaca system must be in an access control list on the BroadWorks profile server.
- Login to the Profile Server.
- In the BWCLI navigate to
/Applications/BroadworksFileRepos/NetworkAccessLists/WebDav
- Add the IP address of the machine running Alpaca's migration tools.
add {IP} description {description}
TimesTen Installation
- Download the TimesTen installation archive from here.
- Extract the archive.
- Run the
setup.sh
script in the extracted directory. - Follow the setup instructions. TimesTen can be installed in client only mode. Most other items can be default.
- 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
-
- 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.
Alpaca Setup
- Download the Alpaca tarball
- Extract the archive in
/opt
. - Create a symlink from the new alpaca directory.
-
ln -s alpaca-core-5.1.0 /opt/alpaca
-
- Create alpaca user with home directory of
/opt/alpaca
.useradd -m -d /opt/alpaca alpaca
- Change the ownership of the /opt/alpaca directory and all of its children
chown -R alpaca:alpaca /opt/alpaca/
- Change the permissions to allow the alpaca group to modify all files
chmod -R g+rw /opt/alpaca/
- Move your license file (typically ecg.license.txt) into the
conf
directory of the extracted archive. - Edit the
conf/alpaca.properties.json
file to configure the BroadWorks cluster element for the desired BroadWorks install. See the configuration guide for additional information. - Verify installation by running
./check
. See Check Tool - Run via
./alpaca
Setup an Alpaca Users "alice" and "bob"
- Add the user to the Alpaca group.
usermod -G alpaca,alice alice
usermod -G alpaca,bob bob
Tools
Configuration Check Tool
A tool to check and verify the configurations of Alpaca.
- Run after configuring Alpaca.
- Run via
./check
- Checks:
- License file
- Times Ten Configuration
- Times Ten connection to Application Server
- Connection to Broadworks
- Profile Server Access
Upgrade Tool
A tool to copy Alpaca configurations from one Alpaca installation to another.
- Copies properties file, license file, log4j configuration file, and cache configuration file.
- Run via
./upgrade -i <Previous Alpaca Configuration Path>
- Compatible with Alpaca version
4.1.0
and above.