ADSM Tivoli Storage Manager Backup for Apple Macintosh: Getting Started

The ACCC's ADSM service uses IBM's Tivoli Storage Manager Backup-Archive Client (TSM) to do the backup and restores. (Archive services is not available.) The current versions are:

• TSM version 5.5 for Mac OSX 10.5, Intel or PowerPC (version 5.5.0.6)
• TSM version 5.4 for Mac OS X 10.4.7 to 10.4.11, Intel or PowerPC (version 5.4.1.2)
• TSM version 5.3 for Mac OS X versions 10.3.9 to 10.4.6, PowerPC Mac G3 or higher (version 5.3.5.3)
• For Mac OS X 10.1 to 10.3.8 -- Earlier versions of Mac OS X are no longer supported.
• TSM version 5.1 for Mac OS 9 (version 5.1.5.1)
• The previous TSM Backup-Archive Client for the Mac client is still available; it works with Mac OS System 7.x, Mac OS 8.0, Mac OS 8.1, and Mac OS 8.5.x.

But note that once you backup any files using Version 5.3.2 or higher, and you cannot back out your upgrade and go back to a version lower than Version 5.3.2. An upgrade to version 5.3.2 or higher includes an upgrade to Unicode support that that upgrade is one-way.

There were major changes in TSM when it when from version 5.3.1 to 5.3.2:

• The format of the TSM password file changed, and
• The Macintosh client became Unicode-enabled, supporting Unicode for file, directory, and file space names.

Therefore any version of the TSM client from Version 5.3.2 and up is compatible with higher versions of TSM, which means that you can install 5.3.5.3, 5.4.1.2, or 5.5.0.6 over Version 5.3.2 and higher.

But... TSM Versions 5.2 and lower must be uninstalled when you upgrade to any higher version. However, the IBM documentation says (Installing Tivoli Storage Manager, Macintosh Client Environment):

Note: Due to differences between this and prior versions of Tivoli Storage Manager, the installation [of Version 5.4] will remove prior versions of Tivoli Storage Manager. The prior installations that will be removed include the following:

• /Applications/Tivoli Storage Manager v5.1
• /Applications/Tivoli Storage Manager v5.2
• /Applications/Tivoli Storage Manager v5.2.2
• /Applications/Tivoli Storage Manager v5.2.3
• /Applications/Tivoli Storage Manager v5.2.4

If versions prior to Version 5.3.2 are installed in some other location, the following must be done before installation:

1. Remove or rename the existing TSM System Preferences and TSM User Preference files in /Library/Preferences/Tiovli Storage Manager.
2. Delete the prior versions.

So if this is to be believed, the newer versions will uninstall previous 5.2 versions for you if you installed them in the usual place. I can't confirm this because I had Version 5.3.4 on my Mac and Version 5.4.1.2 installed without any problems over it.

TSM Backup or TSM Backup for Administrators?

After you install TSM, you will find two TSM Backup GUI clients in the Tivoli Storage Manager folder in your Applications Folder. You are supposed to be able to set TSM up so that a non-Admin user can backup his or her own files, but in practice, that doesn't work very well.

Use the TSM Backup for Administrators -- TSM Tools for Administrators in version 5.4 -- to set up an automated backup of your entire machine. As you might have guessed, you must use an Admin type of account to authorize the use of TSM Backup for Administrators. (In the manual, in particular in Chapter 2, it talks about Root users and Authorized users. TSM runs as a Root user, with a UID of 0, when you use TSM Backup for Administrators.)

If you don't know whether your account is an Admin type, check in the System Preferences Accounts tool. You don't have to be logged in in an administrator account; you can just login when you use TSM with an administrator account's name and password.

The six-step procedure in this document will register your machine with our ADSM server, create a complete backup of your files, and schedule your machine for regular automatic backups.

The introductory document in this site explains who may use the ACCC's ADSM service and what machines they can use it on. (Machine, actually. Only one machine per customer.) See Intro: What ADSM Is and Who Can Use It above to see whether you're eligible.

You must be a current UIC faculty or staff member and have a UIC netid and common password or other password that allows you to authenticate with Bluestem to use ADSM. If you do not yet have a netid and password, you can obtain one now.

Click here if you do not yet have a UIC netid
Click here to activate your netid.

To set up and install your TSM client, you will need to know (1) your ADSM node name, which is your netid - dot - adsm1 -- for example: adabyron.adsm1 for Ada Byron Lovelace -- and (2) the ADSM password you've chosen.

Some notes:

• Before installing TSM, you must register your Mac to use the ACCC ADSM server. This is so that the server is aware of your machine, and it also provides you with security, so that your data may only be saved or restored with your ADSM password.
  
  
• If you previously had a machine registered for ADSM, you don't need to re-register. But if your old machine was passed on to someone else, you do have to make sure that the person who inherited your old machine uses his or her own ADSM account to back it up, not yours. Only one machine per ADSM account.
  
  
• If you have inherited a machine that was previously backed up with ADSM under someone else's name, and TSM is still installed, you don't have to reinstall the TSM client; just do register yourself to use TSM (if necessary) and then put your TSM node name in your TSM System Preferences or dms.sys file; see the Configure Your TSM Client section of the appropriate page in this group. You will also have to reschedule for regular, automatic backups

1. Click the link below to register your machine with ADSM.
   
   
2. A new browser window will open, displaying the ACCC ADSM backup policies. Read them; if your machine qualifies for ADSM backup service, click the I agree with the above provisions button.
   
   
3. You will be asked to Bluestem authenticate yourself by entering your UIC netid and ACCC common password.
   
   
4. You will be asked to choose an ADSM password. This password is unique to ADSM and is not related to your other passwords.
   
   
5. Follow all of the registration instructions, then close the new browser window and continue following the instructions below.

Click here to register your machine with ADSM, if necessary.

If you have already registered to use ADSM, the ADSM register Web page will tell you that your ADSM node name -- which is your netid - dot - adsm1, adabyron.adsm1, for example -- is already registered for ADSM. What about your ADSM password in this case?

• If you are installing the new version of TSM over your old one and if you previously used Password Generate, the stored password from your old version will also allow you to log into the new one.
  
  
• Otherwise, while you are configuring your TSM client, you will be asked to login to ADSM. When the TSM Login dialog box open, type your ADSM node name for your User id, type your ADSM password, and click Login.
  

You will need to change your ADSM password:

• If you are uninstalling your previous version of TSM and you previously used Password Generate; your password probably has changed.
• Or, please don't tell me this is true, if you just didn't use your ADSM account; you may forgotten your password.

In either case, you'll need to change it to something that you do know, because you will need it to login to TSM. Go to the ADSM password change Web page to change it. Don't worry; you'll use your UIC netid and ACCC common password to log into the ADSM password page; it won't matter whether you know your current ADSM password.

Click here to change your ADSM password if you need to.

Don't assume that just because TSM.app allowed you to log in with a ADSM password that you have the right ADSM password. It's been my experience that TSM will accept just about any password, but if it isn't the right password, you won't be able to create a proper Password Generate password or execute any commands that actually involve logging into the server. If there is any question in your mind that you don't know your ADSM password, change it.

If you *don't know* your ADSM password: Use the ACCC ADSM Password Changing Utility

You don't know your ADSM password -- and you won't if you use password generate -- you will have to use the ACCC ADSM password changing utility to change your ADSM password. The ACCC ADSM password changing utility uses your ACCC common password for authentication. If you need your ADSM and don't know it, use your netid and ACCC password to change it; see ADSM Passwords.

If you *do know* your ADSM password: In the TSM Client

If you know what your ADSM password is, you can either use the ACCC ADSM password changing utility (above), or you can change your password in the TSM client, as below:

1. Open your TSM client folder in your Mac X Applications folder and double-click on TSM Backup for Administrators. You will be asked to enter the name and password of an administrator account; do so and click OK to continue.
   
   
2. You should now see the TSM Main Menu screen. Click on Utilities in the menu bar and select Change Password....
   
   
3. In the Change Password screen, type your current ADSM password in the Current password: box, and type your new password twice, in the New Password: and Verify password: boxes, then click the Change button.
   
   
   
4. After you change your password, stop and restart the TSM Client, so you can login with your new password.

• TSM version 5.5 for Mac OSX 10.5, Intel or PowerPC (version 5.5.0.6)
• TSM version 5.4 for Mac OS X 10.4.7 to 10.4.11, Intel or PowerPC (version 5.4.1.2)
• TSM version 5.3 for Mac OS X versions 10.3.9 to 10.4.6, PowerPC Mac G3 or higher (version 5.3.5.3)
• For Mac OS X 10.1 to 10.3.8 -- Earlier versions of Mac OS X are no longer supported.
• TSM version 5.1 for Mac OS 9 (version 5.1.5.1)
• The previous TSM Backup-Archive Client for the Mac client is still available; it works with Mac OS System 7.x, Mac OS 8.0, Mac OS 8.1, and Mac OS 8.5.x.

A complete set of IBM/Tivoli manuals for ADSM are available online; there are links in the Related Links page.

See The ADSM Mac FAQ How do I un-install TSM?