PesterCat DataBox Minimum System Requirements

PesterCat DataBox requires a JDK/JRE version 1.6 or greater to be installed on your system. PesterCat DataBox is tested using Sun JVM's.

PesterCat DataBox is developed and tested using the following operating systems:

• Redhat Enterprise Linux 5
• Mac OSX 10.4/10.5
• Windows XP/Windows Vista

PesterCat DataBox is a web application that runs as a Unix daemon or Windows Service. The instructions listed below should be executed as root (sudo or equivalent) on Linux or with a user in the Adminstrative group on Windows.

Recommended hardware requirements include:

• 1 Gig of system memory
• 100MB of disk space for installation
• 100MB or more disk space for storing uploaded results

Installation Instructions

PesterCat DataBox instructions are available for the following platforms:

• Linux x86 or x86_64
• Mac OSX 10.4 (Tiger) or 10.5 (Leopard)
• Windows XP or Windows Vista

Once you have completed the installation sign in to the system.

See the port settings section below for information on modifying the server port.

Installation instructions for Linux

1. Download the PesterCat-linux-1_0_0.sh executable installer file to your computer.
2. From the command prompt run the installer using the following command:

   	sh pcat_databox_unix-1_0_0.sh
   

3. Follow the instructions in the installer. Note: If you do not already have a suitable Java Runtime Environment installed the installer will download and install one for you. This runtime environment will be installed in a manner so that it will not conflict with any other Java installations on your machine. The JRE will be installed in the selected PesterCat installation directory.
4. PesterCat DataBox is now running. Check the pcat_dbox.log file for any errors.
5. By default PesterCat DataBox runs on port 8080. Open a web browser and go to 'http://localhost:8080/' on your PesterCat DataBox machine.

Installation instructions for Mac OSX

1. Download the pcat_databox_macos-1_0_0.dmg disk image file to your computer.
2. Once you have downloaded the .dmg file, double-click it. This should cause the disk image to be automatically mounted.
3. Once the disk image mounts, open it, and run the installer. Follow the instructions in the installer complete the installation.
4. When you are finished with the installation eject the disk image.
5. PesterCat DataBox is now running. Check the pcat_dbox.log file for any errors.
6. By default PesterCat DataBox runs on port 8080. Open a web browser and go to 'http://localhost:8080/' on your PesterCat DataBox machine.

Installation instructions for Windows XP/Windows Vista

1. Download the pcat_databox_windows-1_0_0.exe file to your computer.
2. Once you have downloaded the .exe file, double-click it. This will start the installation wizard.
3. Follow the instructions in the installer. Note: If you do not already have a suitable Java Runtime Environment installed the installer will download and install one for you. This runtime environment will be installed in a manner so that it will not conflict with any other Java installations on your machine. The JRE will be installed in the selected PesterCat installation directory.
4. PesterCat DataBox is now running. Check the pcat_dbox.log file in your installation directory for any errors.
5. By default PesterCat DataBox runs on port 8080. Open a web browser and go to 'http://localhost:8080/' on your PesterCat DataBox machine.

Sign In

1. Open a web browser go to the following URL for your PesterCat DataBox machine. Example: http://localhost:8080/ (replace 'localhost:port' with the machine name and port for your installation)
2. Sign in with the default username/password combination of admin/pestercat.
3. You are now ready to upload results with the PesterCat Ant Toolkit. See the PesterCat Ant Automation Tutorial for more information.

Port Settings

By default PesterCat DataBox runs on port 8080. If you are using that port for another application or prefer to run the PesterCat DataBox application on a different port you can edit the conf/server.properties file in your PesterCat DataBox installation directory. Modifying the 'server.port' property and restarting the PesterCat DataBox daemon or service will make the change effective.