Title: Installing on Linux and Solaris

First download the Traction TeamPage Server Installer for your platform.

Important! Note: Due to a problem with the ZeroG InstallAnywhere installer, X11 libraries must be installed on the target system, even for console-only installations. We apologize for this inconvenience. As soon as ZeroG has a fix for this problem we will release installers that do not suffer this limitation.

You can do either a Console installation or an X11 Installation.

At the end of this chapter there are instructions on configuring the Traction server to start and stop as a daemon.

Console Installation



To start the installer in console mode, sh the downloaded installer with the -i console flag passed.



Next, chose a locale for the installer.



Press enter after reading each of the information pages.



To accept the terms of the license agreement, press Y and Enter to continue.



The installer will then remind you to make sure that if you are upgrading, you shut down the running Traction instance before proceeding.



Please don't skip this important step! Once you have verified that Traction is no longer running, press Enter to continue.

Choose the path where you would like to install Traction. Some popular choices are /opt, /opt/traction, /usr, /usr/local, /usr/local/traction.



Next, you can choose the Java Virtual Machine (JVM) to be used to run Traction. The installer tries to list all the installed JVMs.



In almost all cases, we recommend that you choose option 1, the default: Install a Java VM specifically for this application. In certain circumstances, such as when you wish to run Traction using 64-bit mode on Solaris on a SPARC architecture, you will need to specify another JVM already installed on the system.

A summary will appear to let you review your changes before running the installer.



During the installation a progress meter will show the percentage of the installation completed.



After the files have been copied, you can specify the initial network settings for Traction. If you're not sure, you can accept the defaults; these settings can be changed later via the Traction interface or by editing the Traction.properties file while the server is not running.



If you install on a port less than 1024, you will need to run as root. If you wish to serve on port 80, but not run with root privileges, you can Overview, or use Apache ProxyPass as a front-end. If you wish to use ProxyPass, contact Traction Software support for instructions.





If you wish to enter a bind address, choose option 2; the installer will prompt you for the address to use.

After the network settings have been written, the following message will appear:



To start Traction in the foreground (during initial configuration), change to the traction/server subdirectory of the installation directory and run TractionApplication:



To continue the configuration, open a web browser and navigate to the URL shown.



You can now proceed to the next step, Installing a License.

X11 Installation



To start the installer in X11 mode, you will need to have a valid DISPLAY configured.

Then, sh the downloaded installer. You should see the following on your console.



Then a small window should appear prompting you for the locale in which you would like to perform the installation.



After you choose a locale and press OK, you will see a welcome screen.



Press next to go to the license screen. To enable the Next button, you must accept the terms of the license agreement.



The next screen explains the upgrade procedure.



The installer will then remind you to make sure that if you are upgrading, you shut down the running Traction instance before proceeding.



Please don't skip this important step! Once you have verified that Traction is no longer running, press Enter to continue.

Next, choose the path where you would like to install Traction. Some popular choices are /opt, /opt/traction, /usr, /usr/local, /usr/local/traction.



A summary will appear to let you review your changes before running the installer.



During the installation a progress meter will show the percentage of the installation completed.



After file copying completes, you can optionally configure the initial network settings. If you are running multiple instances of Traction on the same computer, either the port must be different for each instance, or you must specify a different bind address for each instance and check the "Bind to a specific IP address" checkbox.



When the network settings have been written, the following message will appear:

cd

To start Traction in the foreground (during initial configuration), change to the traction/server subdirectory of the installation directory and run TractionApplication:



To continue the configuration, open a web browser and navigate to the URL shown.



You can now proceed to the next step, Installing a License.

Configuring Traction to Start and Shutdown Automatically



Bundled with Traction is a script that can be used to start and stop Traction when the system changes runlevel (on boot and shutdown).

The script is shipped as server/extras/scripts/S99Traction.

Important! If you plan to run multiple Traction instances on the same machine, you will need to make multiple copies of the script, one for each instance, and you will need to follow the instructions for stopping via URL instead of via signal.

On both Solaris and Linux



1. Copy the script S99Traction to /etc/init.d/traction (thus renaming it to traction in the process).

cp extras/scripts/S99Traction /etc/init.d/traction


On Solaris



2. Create two symlinks to /etc/init.d/traction: /etc/rc2.d/S99Traction and /etc/rc2.d/K99Traction

cd /etc/rc2.d
ln -s /etc/init.d/traction S99Traction
ln -s /etc/init.d/traction K99Traction


Installing on Linux



2. cd /etc/init.d

3. chkconfig --add traction

Configuring the Script



Please note that you must customize the script by setting certain variables to match your installation. Minimally, you need to ensure that the TRACTIONDIR variable points to your installation's server directory.



Attachments:
image827.gif
image425.gif
image828.gif
image427.gif
image829.gif
image830.gif
image799.jpg
image831.gif
image430.gif
image832.gif
image833.gif
image834.gif
image835.gif
image836.gif
image370.jpg
image837.gif
image838.gif
image839.gif
image840.gif
image841.gif
image843.gif
image844.gif
image845.gif
image846.gif
image847.gif
image848.gif
Related Articles
Article: Doc143 (permalink)
Date: March 22, 2008; 4:05:46 PM EDT
Author Name: Documentation Importer
Author ID: importer