Installing AnthillPro

Before Installing

Requirements

Before installing AnthillPro, the following must be installed:

• Java SDK 1.4 or greater. Set the JAVA_HOME environment variable to point to the Java directory.

Database Requirements

AnthillPro3 uses an embedded database to store information. If you wish to use a different database, the following are also supported:

• Apache Derby (included in download)
• Oracle

  If using Oracle 9i, you must use the JDBC driver for Oracle 10g.

• MySQL (works with 4.1.22 and later)

  If using MySQL 5, use the 5.0.8 driver version. The 5.1 version has some bugs that will cause the AnthillPro server to throw an error. If you are using the 5.1 version, switch the driver jar file in the server's lib/ext directory and then restart.

• Microsoft SQL Server

If using a database other than Apache Derby:

• You must use one of the command line installers for installation.
• You need to download the appropriate JDBC driver file for your database. These are typically downloaded from the database vendor.
• You need to create an empty database for AnthillPro3 to use with a dedicated user.

See the User Documentation for detailed instructions on installing AnthillPro with a database other than Derby.

Choosing a Download

The AnthillPro3 installer can be downloaded in several forms. Select the download(s) that best meet your needs. The two command line installers have identical contents but are packaged differently.

• anthill3-<version>.tar.gz -- Command line installer for Unix/Linux.
• anthill3-<version>.zip -- Command line installer for Windows.
• anthill3-<version>.jar -- Graphical installer.

Windows Installation from .zip File

Installing the Server

To install the AnthillPro server, follow the steps below:

1. Download the anthill3-<version>.zip file.
2. Expand the zip file using a tool like WinZip. Expanding will create an anthill3-install directory.
3. Open the anthill3-install directory created in the previous step in Windows Explorer.
4. If you are using a database other than Apache Derby, copy the JDBC driver file(s) into the anthill3-install\lib\ext directory.
5. Run the install script install-server.bat.
6. Input Y to install new server.
7. Provide the following information:
   • Directory where the AnthillPro server should be installed. We suggest C:\Program Files\anthill3\server.
   • Home directory of the JRE/JDK used to run the server. We suggest C:\Program Files\Java\jre1.6.0_05.
   • Port on which AnthillPro server should listen for Agent connections. We suggest 4567.
   • IP address that the server should listen on. We suggest leaving this blank so that AnthillPro listens on all IP addresses bound to the machine.
   • Whether AnthillPro should use HTTPS for the Web UI. We suggest Y.
   • Unsecured HTTP port for the Web UI. This will be used to redirect unsecured requests to the secured HTTPS port when using HTTPS for the Web UI. We suggest 8080.
   • Secured HTTPS port for the Web UI. We suggest 8443.
   • Database type if other than the embedded Derby database.
   • Database username. We suggest anthill3.
   • Database password. We suggest password. The password can be changed once the installation is complete.
8. Install as Windows service (optional). Type Y to install as Windows service. Type N to finish installation process.
9. To automatically install the AnthillPro server as a Windows service, enter:
   • Service name and click OK. We suggest ah3server. (A unique name is required for each  instance.)
   • Login for the installed server and click OK. We suggest .\localsystem.
   • Yes to automatically start ah3server service.
10. To manually install the AnthillPro server as a Windows service (optional):
    • Run ah3server.cmd install uniqueservicename (located in bin\service folder of the AnthillPro directory).
    • Provide the service name and account information.

To run the AnthillPro server, follow the steps below:

1. In Windows Explorer navigate to the AnthillPro3 server directory created during the installation. If you took our suggestion, then this is C:\Program Files\anthill3\server. Enter the bin directory.
2. Run the start script start_ah3server.cmd.
3. Alternatively, from the command line run the start command.bin\ah3server.cmd start.
4. The application can now be accessed in the web browser. The default user name and password is admin / admin.

Installing the Agent

To install the AnthillPro agent:

1. Download the anthill3-<version>.zip file.
2. Expand the zip file using a tool like WinZip. Expanding will create an anthill3-install directory.
3. Open the anthill3-install directory created in the previous step in Windows Explorer.
4. If you are using a database other than Apache Derby, copy the JDBC driver file(s) into the anthill3-install\lib\ext directory.
5. Run the install script install-agent.bat.
6. Input Y to install new agent.
7. Provide the following information:
   • Directory where the AnthillPro agent should be installed. We suggest: C:\Program Files\anthill3\agent.
   • Home directory of the JRE/JDK used to run the server. We suggest C:\Program Files\Java\jre1.6.0_05.
   • External IP address where the agent can be reached. This is the IP address that the server needs to use to contact the agent. If both server and agent are on the same LAN, then this is an IP address that is bound to the agent machine. The machine name may work as well.
   • Port on which the agent is listening for server connections. We suggest: 4568.
   • IP address that the server is listening on. If the agent and server are on the same LAN, then this is an IP address bound to the machine on which the server is installed.
   • Port on which the server is listening for agent connections (in our example above, the value is 4567).
8. Enter name of agent.
9. Type Y to automatically install the AnthillPro agent as a Windows service. Type N to complete installation process.
10. If automatically installing the AnthillPro agent as a Windows service, enter:
    • Service unique name. We suggest ah3agent. (A unique name is required for each  instance.)
    • Login for installed agent service. We suggest .\localsystem.
    • Yes to automatically start service.
11. To manually install the AnthillPro agent as a Windows service:
    • Run ah3server.cmd install uniqueservicename (located in bin\service folder of the AnthillPro directory).
    • Provide the service name and account information.

To run the AnthillPro agent, follow the steps below:

1. In Windows Explorer navigate to the AnthillPro3 agent directory created during the installation. If you took our suggestion, then this is C:\Program Files\anthill3\agent. Enter the bin directory.
2. Run the start script start_ah3agent.cmd.
3. Alternatively, from the command line run the start commandbin\ah3agent.cmd start.
   
   

   ---

   Linux/Unix Installation from .tar.gz File

   Installing the Server

   To install the AnthillPro server, follow the steps below:

   1. Download the anthill3-<version>.tar.gz file.
   2. Open a UNIX shell to the directory containing the above downloaded file.
   3. Extract the downloaded tar.gz file. Type tar -zxf anthill3-<version>.tar.gz . On some installations of Solaris and HP-UX the default tar command will not properly handle our tar files. You may need to use \ install GNU tar.
   4. cd anthill3-install
   5. If you are using a database other than Apache Derby, copy the JDBC driver file(s) into the anthill3-install/lib/ext directory.
   6. Run the install script ./install-server.sh.

   During the installation you will be prompted for the following information:

   1. The directory where the AnthillPro server should be installed. We suggest /opt/anthill3/server.
   2. The port on which AnthillPro server should listen for Agent connections. We suggest 4567.
   3. The IP address that the server should listen on. We suggest leaving this blank so that AnthillPro listens on all IP addresses bound to the machine.
   4. Whether AnthillPro should use HTTPS for the Web UI. We suggest Y.
   5. The unsecured HTTP port for the Web UI. This will be used to redirect unsecured requests to the secured HTTPS port when using HTTPS for the Web UI. We suggest 8080.
   6. The secured HTTPS port for the Web UI. We suggest 8443.

   To run the AnthillPro server, follow the steps below:

   1. Open a UNIX shell to the directory where you installed the server. If you took our suggestion, then this is /opt/anthill3/server.
   2. cd bin
   3. Run the start script ./ah3server start.
   4. The application can now be accessed in the web browser. The default user name and password is admin / admin.

   Installing the Agent

   During the installation you will be prompted for the following information:

   1. The directory where the AnthillPro agent should be installed. We suggest /opt/anthill3/agent.
   2. The external IP address where the agent can be reached. This is the IP address that the server needs to use to contact the Agent. If both server and agent are on the same LAN, then this is an IP address that is bound to the agent machine.
   3. The port on which the Agent is listening for Server connections. We suggest 4568.
   4. The IP address that the server is listening on. If the agent and server are on the same LAN, then this is an IP address bound to the machine on which the server is installed.
   5. The port on which the Server is listening for Agent connections. This is the value from #2 in the Server installation section.

   To run the AnthillPro agent, follow the steps below:

   1. Open a UNIX shell to the directory where you installed the agent. If you took our suggestion, then this is /opt/anthill3/agent.
   2. cd bin
   3. Run the start script ./ah3agent start.
   
   

   ---

   Installation using the Graphical Installer

   Installing the Server and Agent

   To install the AnthillPro server and agent, follow the steps below:

   1. Download the anthill3-<version>.jar file. Internet Explorer may rename it to anthill3-<version>.jar. If it does, rename it back to .jar.
   2. Run the executable jar by double clicking on it, or run it from the command line. Type java -jar anthill3-<version>.jar.

   During the installation you will be prompted for the following information:

   1. The directory where the AnthillPro server should be installed.
   2. The port on which AnthillPro server should listen for Agent connections. We suggest 4567.
   3. The IP address that the server should listen on. We suggest leaving this blank so that AnthillPro listens on all IP addresses bound to the machine.
   4. Whether AnthillPro should use HTTPS for the Web UI. We suggest Y.
   5. The unsecured HTTP port for the Web UI. This will be used to redirect unsecured requests to the secured HTTPS port when using HTTPS for the Web UI. We suggest 6000.
   6. The secured HTTPS port for the Web UI. We suggest 6443.
   7. The directory where the AnthillPro agent should be installed. We suggest /opt/anthill3/agent.
   8. The external IP address where the agent can be reached. This is the IP address that the server needs to use to contact the Agent. If both server and agent are on the same LAN, then this is an IP address that is bound to the agent machine.
   9. The port on which the Agent is listening for Server connections. We suggest 4568.
   10. The IP address that the server is listening on. If the agent and server are on the same LAN, then this is an IP address bound to the machine on which the server is installed.
   11. The port on which the Server is listening for Agent connections. This is the value from #2 in the Server installation section.

   To run the AnthillPro server and agent, follow the instructions for your operating system as listed above.