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


  • Download the ManageEZ tarball to the /opt folder on the server.
  • Untar the tarfile
  • Create a symlink from the new ManageEZ folder to /opt/manageez ln -s manageez-4.2.0 /opt/manageez
  • Create the manageez user with the home directory of /opt/manageez
  • Change the ownership of the /opt/manageez folder and all of it's children
  • Copy the Alpaca license file alpaca.license into the conf folder
  • Edit the conf/ file to configure the BroadWorks cluster element for the desired BroadWorks install. See the Alpaca configuration guide for further details.
  • (Optional) Edit the conf/ to configure any additional ManageEZ settings. See the configuration guide for additional information.
  • The TimesTen lib directory must be set in the runner script. Open runner and update DEFAULT_TT_LIB to the TimesTen lib directory.
  • Copy the manageez file into /etc/init.d
  • Run chkconfig --add manageez and chkconfig manageez on
  • ManageEZ can then accessed by visiting http://serverip:8080.

Apache Integration

Accessing ManageEZ 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 manageez.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 ManageEZ installation.

Example configuration located at /etc/httpd/conf.d/

<VirtualHost *:80>

     ProxyPass / ajp://localhost:8009/
     ProxyPassReverse / ajp://localhost:8009/

     <!-- Other settings -->