Borland^® Gauntlet™ 2007 Installation Notes
Version 1.1

These installation notes provide installation instructions for Borland^® Gauntlet™ 2007 for both Windows and Linux.

For more information on this release, see the readme.htm. The default location is Borland\Gauntlet2007.

Windows Installation Instructions

Important! Turn off all anti-virus software before you install Gauntlet.

Upgrade Installation

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

• The directory where Gauntlet is currently installed so it can be upgraded. Your storage directory and the data in it are preserved. This includes all passwords and user accounts.
• Whether to keep your existing license or upgrade with a new evaluation license.

New Installation

Note: You must have a JDK to run the Gauntlet installer.

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

• Directory where you want to install Gauntlet
• JDK you want Gauntlet to use
• Location of the directory that Gauntlet uses to store data (gauntlet_storage)
• Port numbers for the dashboard, database, and SCM
• From address for administrative email messages
• A replacement for the default administrator password

Installing Gauntlet

1. Go to the directory where you extracted the download file.
2. Click Gauntlet2007.exe to start the installation wizard.
3. Follow the instructions in the installation wizard to complete the Gauntlet installation.

Getting to the Dashboard

Do one of the following:

• From the Windows Start Menu, choose Programs > Borland Gauntlet 2007 > View Gauntlet Dashboard.
  This starts the Gauntlet Dashboard in Internet Explorer.
• Enter the Gauntlet URL in the Address field of your browser.
  The URL is in the format
  http://{your machine's hostname}:{port}/gauntlet/dashboard

Uninstallation Instructions

1. Choose Start > Control Panel > Add or Remove Programs.
2. Select Borland Gauntlet 2007.
3. Click Remove to uninstall Gauntlet.

Top

Linux Installation Instructions

Important! Turn off all anti-virus software before you install Gauntlet.

Upgrade Installation

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

• The directory where Gauntlet is currently installed so it can be upgraded. Your storage directory and the data in it are preserved. This includes all passwords and user accounts.
• Whether to keep your existing license or upgrade with a new evaluation license.

New Installation

Note: You must have a JDK to run the Gauntlet installer.

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

• Directory where you want to install Gauntlet
• JDK you want Gauntlet to use
• Location of the directory that Gauntlet uses to store data (gauntlet_storage)
• Port numbers for the dashboard, database, and SCM
• From address for administrative email messages
• A replacement for the default administrator password

Installing Gauntlet

1. Open a UNIX shell.
2. Change to the linux directory in the directory where you extracted the download file.
3. Type java -jar Gauntlet2007.jar to start the graphical installation wizard in X windows.
4. Follow the instructions in the installation wizard to complete the Gauntlet installation.

Console Installation Instructions

You can invoke the Linux installation in console mode by typing the following:

java -jar Gauntlet2007.jar -i console

This mode allows you to interact with the installer without requiring any UI capability on the Linux machine.

Getting to the Dashboard

Enter the Gauntlet URL in the Address field of your browser.
The URL is in the format
http://{your machine's hostname}:{port}/gauntlet/dashboard

Running Gauntlet as a UNIX Service

You can create a script that adds Gauntlet as a service that starts each time a Linux system restarts. Following is a sample script showing how you do this. This would be the content of a file called /etc/init.d/gauntlet.

#!/bin/sh
#
# gauntlet    Startup script for the Borland Gauntlet
#  
# next two lines are for chkconfig
#
# chkconfig: - 99 1
# description: Borland Gauntlet 2007 server
#
# Source function library.
. /etc/rc.d/init.d/functions

# IMPORTANT: set these to values in your installation
GAUNTLET_HOME=/home/username/install/gauntlet_home
# IMPORTANT: set these to values in your installation
GAUNTLET_USER=username

start() {
        echo "Starting Borland Gauntlet at $GAUNTLET_HOME as $GAUNTLET_USER"
        su -l $GAUNTLET_USER -c $GAUNTLET_HOME/bin/startstack
        RETVAL=$?
}
stop() {
        echo "Stopping Borland Gauntlet at $GAUNTLET_HOME as $GAUNTLET_USER"
        su -l $GAUNTLET_USER -c $GAUNTLET_HOME/bin/stopstack
        RETVAL=$?
}

# See how we were called.
case "$1" in
  start)
        start
        ;;
  stop)
        stop
        ;;
  *)
        echo "Usage: gauntlet {start|stop}"
        exit 1
esac

exit $RETVAL

Once you copy the file to /etc/init.d/gauntlet, you can do the following (as root):

# chkconfig --add gauntlet
# chkconfig gauntlet on

Uninstallation Instructions

1. Stop the stack.
2. Delete the Gauntlet2007 directory.

Top