Warning! You are viewing an older version of Alpaca CLI Guides. View the latest
Installation for Mac
Prerequisites
-
Java JDK 1.8
- The newest release can be found on Oracle's webpage.
-
Oracle TimesTen
- TimesTen needs to be installed on the machine where Alpaca is to be installed.
- Follow the official instructions to install TimesTen in a location of your choosing.
- The TimesTen
lib
directory must be set in theALPACA_TT_LIB
environment variable for Alpaca to retrieve. - e.g.
echo "export ALPACA_TT_LIB=/opt/TimesTen/tt1122/lib" >> /etc/bashrc
- 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.
Setup
- Download the Alpaca tarball
- Extract the archive in the desired location
- 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. - Run via
./alpaca
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.