Title: Installing on the Macintosh

On the Traction TeamPage Server Installers Page, either click the "Download Installer for Mac OS X" button or download and run the installer.

If you see a security warning, proceed with the download.

If your browser did not automatically unzip the zip file, find the zip file and unzip it, then run the installer app by double-clicking the icon.

The installer will start to run.

The splash screen appears and lets you choose the language you would like to use for installing.

After choosing your language and clicking OK, you come to the first installer panel.

Press next to go to the license agreement panel.

Read the license agreement, then click the "I accept the terms of this License Agreement" radio button. You will not be able to continue the installation if you do not accept the terms. If you do not wish to accept the terms, you may cancel the installation.

After accepting the license, the installer displays upgrade information.

For additional upgrade information, see the Help section Installing Traction TeamPage Upgrades.

Next, Traction displays an important warning that if you are upgrading Traction, you should shut down the instance that you are upgrading.

Next, you can select the location where the Traction application should be installed.

Important! Unless you are familiar with Unix and the Terminal, we recommend that you accept the default location. Generally the only time Macintosh users need to change this is when they are installing multiple Traction servers on the same computer.

All application and configuration files will be installed in this directory. By default, all subsequent data files are also created in this directory, although during Journal creation you can select to locate your data in a different location.

Before file copying commences you can review your settings.

If you are satisfied with your selections, click "Install". Otherwise you can go to earlier panels or cancel.

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.

Press next to show a summary of the installation.

You can now press done to exit the installer.

Running Traction

There are three ways to run Traction on your Macintosh:

Running Traction as an Application

If you just wish to run Traction periodically, you can use the TractionOSX.app program to run it. A shortcut to this icon is normally placed on the desktop during installation.

The doc icon will bounce while Traction is starting up; when it stops bouncing, you should be able to reach Traction via the configured URL (the default is localhost:8080). If you have trouble contacting the Traction server after clicking the icon, please see "Running Traction from the Terminal" for troubleshooting and diagnostic information.

Note that when you run this way, clicking the dock icon has no effect; it only serves as an indication that Traction is running. When you are ready to stop Traction, you should use the "shutdown Traction" button in Server Setup | General.s

Running Traction from the Terminal

To complete your initial Traction installation and configuration, we recommend that you run Traction from the Terminal program.

To do this, run the Terminal program, which lives in the /Applications/Utilities folder.


cd /Applications/Traction/traction/server/

Press Enter, then type


When you press Enter, the program will start. Your terminal should look something like this:

The URL for your Traction server is displayed on the last line, in this case plum.local:8080.

Open a web browser and enter that URL. You should be redirected to a page that looks like this:

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

If you need to, you can shut down your Traction server cleanly by typing control-c in the Terminal window.

After shutting it down, you can run it again using the ./run command, or you can use the SystemStarter scripts described above to have Traction always running silently in the background for you.

Configuring Traction to Start and Shutdown Automatically

Note: the following instructions apply to Macintosh OS 10 versions prior to 10.10 Yosemite. If you need instructions for starting Teampage automatically on Yosemite or later, please contact support@tractionsoftware.com.

Traction includes an installer that installs the necessary scripts to /Library/StartupItems to make Traction start automatically on boot and shutdown cleanly on shutdown.

Important! These scripts assume that Traction is installed in /Applications/Traction. If you installed your Traction server in a different folder, you will need to edit the variable TRACTIONDIR in /Library/StartupItems/Traction/Traction after completing the installation.

To run this installer, open the folder /Applications/Traction/traction/server/extras/scripts and double-click the TractionRunner.pkg.zip to unzip the installer.

The installer icon should appear.

Double-click this icon to run the installer.

Click continue to choose a destination.

Select your boot volume, then press continue.

When you click the Install button, you will be required to enter your password:

When you press OK, the installation is performed. When the installation completes, you should see the confirmation screen.

Press the close button to close this screen.

Important! If you installed your Traction server in a different folder, you will now need to edit the variable TRACTIONDIR in /Library/StartupItems/Traction/Traction.

Using the Start/Stop Script from the Terminal

After you have completed installing and configuring your Traction server, you can start and stop it from the Terminal using these commands.

To start Traction from the terminal, run:

sudo /sbin/SystemStarter start Traction

to stop Traction cleanly from the terminal, type

sudo /sbin/SystemStarter stop Traction

You will be required to enter your password.

Disabling the Start/Stop Script

To disable Traction from starting automatically, or after uninstalling Traction, you need to remove the scripts that this installer installs. To do this, type the following in the console:

sudo rm -r /Library/StartupItems/Traction

You will be required to enter your password.

Related Articles
Article: Doc144 (permalink)
Date: March 22, 2008; 4:06:04 PM Eastern Daylight Time

Author Name: Documentation Importer
Author ID: importer