Installing and configuring the TSM client for Macintosh.
The instructions presume that this is the first time
that TSM has been installed on the computer. It should
work for computers that already have a previous version
of the TSM software, but notes will be made at the end
as to potential problems and how to start over again.

These instructions already presume that you have gone
to http://tsm.princeton.edu and set up a TSM account for
the computer. You will need to know the TSM nodename
(usually the computer's hostid), the TSM server it's on
(TSMx, where x is 1, 2, 3, 4, 5, 6, or 7), and the
TSM password. If you don't know these three things, you
will not be able to configure the TSM client software.
You can find these three pieces of information by going
to http://tsm.princeton.edu and clicking on Maintain for
those TSM accounts for which you are a primary contact.
You cannot look up a TSM password, you can only change
it.

Log on to the computer as the Administrator or with
administrative privileges. Download the current version
of the TSM client software, version 6.1.0.2, here:

ftp://index.storsys.ibm.com/tivoli-storage-management/patches/client/v6r1/Mac/v610/

Save the file, 6.1.0.2-TIV-TSMBAC-Mac.dmg to a folder
on the local computer.

Double click on the .dmg file to start the installation
process. This creates an .mpkg file in a Finder window.
Double click the .mpkg icon to bring up the TSM installer.
Click Continue.

Read the release notes (optional), click Continue.

Select the volume where you want to install the TSM client,
by clicking on it. Click Continue for the next step. Click
Install to begin the Installation. Enter in your Mac's admin 
password to start the installation. Click Close to complete 
the process.

A folder called 'Tivoli Storage Manager' should have been
created in the Applications folder. Open the folder and
double click 'TSM Tools for Administrators'. The other application,
'Tivoli Storage Manager' is a single user version of the
client, meaning that you will only backup/restore the files
belonging to the logged in user (analogous to backing up
a single user in a multiuser environment).

Accept the default 'Tivoli Storage Manager', click OK.
Supply the Mac's admin password, click OK. Be patient, it's
AppleScript.

You should be presented with TSM's configuration wizard.
Click Next.

Create a new options file (if none existed before). Click Next.

Supply the TSM nodename, this is the name that you selected
when you created the TSM account on tsm.princeton.edu. For
purposes of illustration, I'll use FISHTANK (capitalization
isn't important). Click Next.

Accept the default of TCP/IP. Click Next.

The TCP/IP options screen requires you to fill in the address
and port number of the TSM server where the account is registered.
My account is on TSM5, so I supply these values:

Server Address
tsm5.princeton.edu

Port Number
1605

If your TSM server is TSM6, you would supply tsm6.princeton.edu
and 1606.

Click Next.

The server stanza is just a label, it is used for larger Unix
systems that may contact more than one TSM server. Just make it
the same as your TSM server. Since my server is TSM5, this is
what I enter. This entry is case sensitive! Click Next.

Click Next to accept the include/exclude list.

Click Next on the common file exclusion list.

Click Apply to start the configuration process. You will be
prompted for your TSM password. Enter your TSM password and
click Login. Click Finish to close the wizard and start the
TSM application.

This completes the basic installation and configuration. If you
run the TSM backup manually, you do not need to configure the
scheduler. If you want your computer to back up automatically, 
you need to install the scheduler daemon.

Select Client Preferences from the Edit menu. Click on the 
Authorization tab on the left side of the window. Click on the
button in front of 'Password Generate'. Click Apply. Click OK
on the pop-up window. Click on the Performance Tuning tab on 
the left side of the window. Click on the button in front of
'Use memory saving method'. Click Apply. Click OK on the
pop-up window.

Click OK to close the Preferences Editor.

Close the TSM application. Re-open the TSM Application (TSM Tools
for Administrators, Tivoli Storage Manager), click OK, supply
the Mac admin password when prompted. Enter the TSM password,
click Login. Close the TSM application again and re-open it.
Repeat this until you can open TSM without being prompted for
the password. This process encrypts the TSM password on the
client computer, it is necessary in order for the scheduler to
run. Once you can start TSM without being prompted for the TSM
password, close the TSM application.

Double click TSM Tools for Administrators and select Start the
Client Acceptor Daemon. Click OK. Click OK when the window tells
you to be patient. Enter the Mac's admin password, click OK.
Wait for the results screen to come back, stating that the 
Client Acceptor Daemon (CAD) has been started. Click OK.

The CAD will now run and check in with the server every 12
hours. It will back up the computer according to the schedule
assigned to the client. If the computer is rebooted, the
CAD should start up again. If you suspect a problem with
the scheduler, check to see if it is running by opening a 
terminal window and typing in 'ps -ax | grep dsmcad' (without
the quotes). You should see something like this:

636 ??    0:00.03 /usr/bin/dsmcad

It's a good idea to reboot the computer and check to see if the
CAD is running before you attempt to back up (manually or via
the scheduler). 

Make sure that you have the correct power settings so that the
backup will occur overnight. To do this, open the System 
Preferences and click on Energy Saver. Change the setting for
'Put the computer to sleep when it is inactive for:' to 'Never'.

If you want to start the configuration process over again,
you need to remove the dsm.sys and dsm.opt files from this location:
/Library/Preferences/Tivoli Storage Manager/ and then start the
the TSM application again.

To run a backup manually, start the TSM application (TSM Tools
for Administrators, Tivoli Storage Manager, supply the Mac admin
password). Click on Backup. Click the box in front of Local, then
click Backup. The backup may be stopped and started as necessary.