Warning! You are viewing an older version of Alpaca Guides. View the latest
Installation
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 IP address of the Alpaca Web 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 Web tarball to the /opt folder on the server.
- Untar the tarfile
- Create a symlink from the new Alpaca Web folder to
/opt/alpacaweb
ln -s alpacaweb-4.2.0 /opt/alpacaweb
- Create the alpacaweb user with the home directory of /opt/alpacaweb
- Change the ownership of the /opt/alpacaweb folder and all of it's children
- Copy the Alpaca license file
alpaca.license
into theconf
folder - Edit the
conf/alpaca.properties.json
file to configure the BroadWorks cluster element for the desired BroadWorks install. See the Alpaca configuration guide for further details. - (Optional) Edit the
conf/alpaca.web.properties.json
to configure any additional Alpaca Web settings. See the configuration guide for additional information. - The TimesTen
lib
directory must be set in therunner
script. Openrunner
and updateDEFAULT_TT_LIB
to the TimesTenlib
directory. - Copy the
alpacaweb
file into /etc/init.d - Run
chkconfig --add alpacaweb
andchkconfig alpacaweb on
- Alpaca Web can then accessed by visiting
http://serverip:8080
.
Apache Integration
Accessing Alpaca Web through Apache is supported using the AJP connector. This allows for access through port 80 as expected from most web applications. The AJP port defaults to 8009 but can be modified using the alpaca.web.ajp.port
environment variable.
Configuration for this is typically performed as a .conf
file in /etc/httpd/conf.d
that connects a virtual host to the Alpaca Web installation.
Example configuration located at /etc/httpd/conf.d/alpaca.e-c-group.com.conf
<VirtualHost *:80>
ServerName alpaca.e-c-group.com
ProxyPass / ajp://localhost:8009/
ProxyPassReverse / ajp://localhost:8009/
<!-- Other settings -->
</VirtualHost>
To modify the Apache timeout, modify the httpd.conf
file in /etc/httpd/conf/
. Add the following lines
#
# Proxy Server directives. Uncomment the following lines to
# enable the proxy server:
#
<IfModule mod_proxy.c>
ProxyRequests On
<Proxy *>
AddDefaultCharset off
Order deny,allow
Allow from all
</Proxy>
ProxyPreserveHost Off
ProxyTimeout 1200