Title: Overview

Traction TeamPage is a Java language application that provides Web server, database, search engine and hypertext Journal functions to implement TeamPage blog, wiki, tagging and Enterprise 2.0 collaboration capabilities described in the Traction User Guide.

In order to deploy and use your own instance of a Traction TeamPage server you will need: 1) A physical or virtual computer running one of the supported host operating systems in order to run the Traction TeamPage software as a server for your own company or use; 2) A license file for Traction TeamPage.

To review the hardware and software requirements and recommendations for running Traction TeamPage, please see TeamPage System Requirements.

See Welcome1 for the current software download link, computer hardware and operating system requirements, and access to a free TeamPage license (five named accounts and five spaces). If you purchased a larger TeamPage license, you should have received a license file for your TeamPage configuration by email. See TractionSoftware.com's Buy page for license information. If you need help purchasing a license please email sales@tractionsoftware.com.

The Traction TeamPage installation procedure for each host operating system is described in the following chapters. Follow the step-by-step instructions for the Operating System

You may wish to review the following Frequently Asked Questions before installing.

Pre-Installation FAQ

What port does Traction run on?

By default, the Traction server runs on port 8080, although you can select a different port during installation or at any time later using the web-based server setup interfaces.

How can I change the port Traction uses?

Traction provides a web-based interface that allows you change Traction's port, or you can change the port= line in the Traction/traction/server/Traction.properties file while the server is not running to select a different port.

Can Traction run on the same port as another web server, e.g. Apache or IIS

Yes, provided that you configure the machine to have multiple IP addresses and you configure both the other server and Traction to bind to only one of the available IP addresses. If you are not familiar with how to do this, contact Traction Software support for a FAQ.

What if I already have a server running on the port Traction uses?

If you already have a process using that port, Traction will not be able to start and will report the error:

If you are running as a Windows service or Unix daemon, Traction will exit without requiring a keypress. If your service or daemon never starts up, this may be the problem. You can check the logfile to see if this happened. To resolve this, you can choose a different port, or enable binding to a different IP address.

Where is Traction's logfile?

The status logfile is in the folder Traction/traction/server/logs/traction.log inside the installation directory, e.g. /usr or C:\Program Files.

If I install on one computer, can I move Traction to another computer later?

Yes, this is very straightforward. If the journal is stored in the default location in the server directory, you can just copy the server directory to the corresponding location on the new machine and re-run the installer. Re-running the installer is the standard upgrade procedure and will install any platform-specific run scripts or registry settings. Finally, you'll need to set up any auto-start and auto-shutdown capabilities that you may have configured.

If the journal is stored outside the server directory, you may need to move this file so it is available to the other machine, then use the Journal Setup interface to tell Traction the location of the journal.

Can I move Traction to a different operating system, e.g. from Widows to Linux?

Yes. Traction's data files are fully portable between platforms in all locales, so you can even move journals with Japanese share folders between platforms. The procedure is the same as for moving between machines (described above), except that you will need to run the Traction installer for the new platform after copying the server directory.

Can I run Traction on protected ports like port 80 or 443?

Yes, provided that Traction run as a Windows Administrator account or a Unix root user. Ports less than 1024 can only be accessed by programs running with root/Administrator permissions.

If I want to run on port 80, do I really have to run as root/Administrator?

Techniques for working around this requirement exist, but tend to be very platform and installation specific and are outside the scope of what we cover in this guide.

Depending on your platform, you may be able to reroute traffic from port 80/443 to other ports. For example, on Solaris and BSD, you might add a line like this to ipnat.conf:

rdr dnet0 port 80 -> port 8080

If you replace dnet0 with the interface you want to remap from and with the IP address of the host running Traction, traffic on port 80 can be shifted to a non-root process on, in this case, Traction's default port 8080. On Linux you can do the same thing using ipchains.

Some customers use a port-forwarding router to direct traffic to other ports.

Do I Need X11 to Install Traction on Linux or Solaris Systems? Even for a console install?

No, X11 should not be required for a headless install.

How do I back up the software?

To back up Traction, you need to copy the Installation and Journal directories. See How do I Back Up and Restore Traction TeamPage? for more details.

Moving an existing installation to new hardware

Please see Customer267: How do I move a Traction TeamPage Installation to a different computer?.

Related Articles
Article: Doc191 (permalink)
Date: March 22, 2008; 4:11:05 PM EDT
Author Name: Documentation Importer
Author ID: importer