Here's how to configure TSM on a Macintosh computer, running OS X.

First, if you haven't done so already, get a TSM account. Visit
http://tsm.princeton.edu and click on the 'Register' link. Make
sure you note the TSM password and the TSM server you are on. These
will be displayed on your browser, but not emailed to you. If you
do not know these two items, you can click on the 'Maintain' link
at http://tsm.princeton.edu and change your password or look up
your server.

Second, you'll need to get the most current TSM client software.
This is available at http://tsm.princeton.edu. Download the .dmg
file and install it. Do not start the TSM application yet.

INSTALLING THE TSM CLIENT SOFTWARE

1) The current version of the TSM client software is 5.4.0.4,
download file 5.4.0.4-TIV-TSMBAC-Mac.dmg to your desktop. Double
click this file.

2) A disk named Tivoli Storage Manager should now be mounted on
your desktop. If it is not open, double click it to open it.

3) Double click the Tivoli Storage Manager.mpkg file to start the
installation process.

4) Click Continue (Introduction).

5) Click Continue (Read Me).

6) Select the destination for the program, click Continue (Select
Destination).

7) Click Install (Installation Types).

8) You should be challenged for your Macintosh password. This is
not your TSM password, but the password you use to log into your
Mac. It should have administration authority (to allow you to
install software).

9) Click Close (Finish).

10) Quit the Installer (the disk can be dismounted now, you may
also discard the .dmg file).

You are now ready to start and configure the TSM client.

CONFIGURING THE TSM CLIENT SOFTWARE


1) Check to see if there are any files in Library -> Preferences
-> Tivoli Storage Manager (/Library/Preferences/Tivoli Storage
Manager). If there are, it's because of an earlier install and
this may cause your customization to fail. Remove the Tivoli
Storage Manager folder and its contents, if it exists.

2) Double click on 'TSM Tools for Administrators', this should
be in a TSM folder inside of your Applications folder. You will
be prompted for your Macintosh administrative password. If you
are asked to update permissions, click Yes.

3) The next window you see should be the TSM Tools for Administrators.
Tivoli Storage Manager should be highlighted. Click OK.

4) Enter your Macintosh administrative password. Click OK.

5) If you don't have an options file (dsm.opt or dsm.sys in
/Library/Preferences/Tivoli Storage Manager/), it will prompt you
to create one. Click Next.

6) Enter the server name. This is the 'short' name for the
TSM server you are on. It is of the form 'TSMx'. If your account
is on TSM3, your server name will be TSM3. Click Next.

7) The communication method should be TCP/IP. Click Next.

8) The tcp address will be of the form tsmx.princeton.edu,
where x is your server number. If your account is on TSM3, then
your server address is tsm3.princeton.edu.The port number is of
the form 160x. If your account is on TSM4, then your port is 1604.
There are five TSM servers, TSM1 to TSM5. Make sure that your
TSM servername (e.g., TSM5) matches the correct tcpserveraddress
(e.g., tsm5.princeton.edu) and tcp port number (e.g., 1605).
Not having the name, address and port aligned is the cause for
most connection failures. Click Next.

8) Enter your TSM node name. This is the name of the account
as you registered it. Most of the time, it will be the same
as the host name for the computer, but it need not be. Make
sure you type it in exactly as you registered it, but case
is not important. Click Next.

9) Click Finish.

10) The TSM application window should be open, select
Client Preferences from the Edit menu (you may be prompted
for your TSM password).

11) Select Authorization from the left hand side of the
window. Click the radio button in front of Password
Generate. Click Apply.

12) Click OK when the program tells you that you will
need to restart the application for the changes to take
effect (we'll do that later).

13) Select Performance Tuning from the left hand side
of the window. Check the radio box in front of Use memory
saving method. Click Apply. Click OK.

14) Click OK to close the Preferences editor.

15) Close the TSM application.

16) Restart the TSM Tools for Administrators application.
If you are prompted for your Macintosh administrator password
and your TSM password. If you are not prompted for your
TSM password, skip the rest of this step. If you were
prompted for your TSM password, shut down the application
and start it again. When the TSM password has been properly
seeded and encrypted, the application will start up without
prompting you for it. This is necessary for the scheduler
to run correctly.

17) Close the TSM application.

18) Restart the TSM Tools for Administrators application.

19) Select 'Start the Client Acceptor Daemon' and click OK.

20) Supply the correct Mac and/or TSM passwords if challenged.
Click OK.

21) Wait for the successfully started message. Click OK.

22) Adjust your energy saving settings if you intend to let the
scheduler run your backup overnight (this requires you to log out
and leave your computer on overnight). Open the System Preferences
application and click on Energy Saver. Select 'Sleep' option if it
is not selected by default. Move the slider for "Put the computer
to sleep when it is inactive for:' to 'Never'. Check the box in
front of 'Put the display to sleep when the computer is inactive
for:' to a value of your choice. Uncheck the box in front of
'Put the hard disk(s) to sleep when possible.'

RUNNING YOUR FIRST BACKUP (MANUAL INCREMENTAL BACKUP)

1) Start the TSM Tools for Administrators program. If you start
the the Tivoli Storage Manager application, it will only let
you back up files which belong to the userid you logged into
the Macintosh with. Starting the Tools application lets you
back up the entire files or files from more than one user.

2) Select the Tivoli Storage Manager application from the menu
and click OK. Supply your Macintosh passowrd and click OK.

3) The application should have started up without asking you
for a TSM password. If it did ask for a TSM password, please
review your Configuration steps.

4) Click on Backup.

5) Check the box in front of Local.

6) Click Backup.

That's it! Since this is a true incremental, you may stop and
start the backup at will. It will not back up any file that
it already has a copy of (unless it has changed from the last
backup).

If you have problems with the configuration, it's probably because
there was an error in your node name, TSM password or server
information. You can check this information again by visiting
http://tsm.princeton.edu and clicking on the Maintain link.
Get the correct information and then start the above process
from the beginning.

To see if the scheduler is running, open a Terminal window and
enter: 'ps -ax | grep dsm' (without the quotes). You should see
something like this:

345   ??   S    0:00.03    /usr/bin/dsmcad

Configuration files are located here:

/Library/Preferences/Tivoli Storage Manager/

TSM logs (error, scheduler, etc.) are here:

/Library/Logs/tivoli/tsm/