FAQ - Personal Computers on Campus: Restoring Files with ADSM Backup

Table of Contents General Questions for ADSM Backup Software Where can I find additional information about ADSM? Who can use ADSM? Can I use it from home? I just received my FaCT computer. How do I set ADSM up on it? I'm moving to a new office. Can I use ADSM to backup/retrieve files from the new location? I got a new computer/new hard drive. Can I retrieve files that I backed up from my old computer/hard drive? I'm trying to retrieve files from my old computer to a new computer, and I get the error message: "ANS1410E Unable to access the network path". Help! I notice that I get an error message if I use the archive command in datasave. The error is "The management class does not contain any archive copy groups. Unable to continue with archive." How long are the files saved? How can I authorize other users to restore my files? When I tried to set up my datasave account, I received a message saying that my machine was not in the database. What does that mean? About ADSM on Windows NT/2000/XP/Vista How do I run the ADSM scheduler on Windows NT/2000/XP/Vista? I have a computer that used to belong to someone else. How do I change the ADSM setup on it? I restored some files from my old PC and now I can't access them. Help! Installing and Configuring ADSM TSM Backup Software for Macs I have a multi-user Mac. Is there anything special I have to do? I'm using ADSM witn MAC OS X's Case Sensitive HFS+ file system; anything special I need to do? How do I un-install TSM? Running ADSM TSM Backup Software for Macs When I try to open the TSM client, the splash screen flashes but nothing else happens. What can I do? When the scheduler tried to run TSM I got PASSWORDACCESS communications failure error messages. What did I do wrong?

Question 1.1 Where can I find additional information about ADSM?

• ACCC Documents for ADSM
• Software clients from the ACCC FTP site
• A complete set of IBM/Tivoli Storage Manager documentation (Tivoli Storage Manager is what IBM calls ADSM now) is available online on the Tivoli Web site. Links and recommended documents are given in the ADSM Related Links page.

Question 1.2 Who can use ADSM? Can I use it from home?

• The short answers are only faculty and staff and no.
• For more information, see ADSM - Network Backup: What it is and who can use it.

Question 1.3 I just received my FaCT computer. How do I set ADSM up on it?

• Follow the instructions in ADSM Backup for FaCT Personal Computers.

Question 1.4 I'm moving to a new office. Can I use ADSM to backup/retrieve files from the new location?

• Yes. ADSM node names are independent of location. As long as you know your ADSM node name and password there is no problem.

Question 1.5 I got a new computer/new hard drive. Can I retrieve files that I backed up from my old computer/hard drive?

• Yes. Even if you get a new computer, you can continue to use your old nodename and old password with ADSM on the new computer. Since you're using the same account -- node name and password -- you will have access to all your old files.
• There is one quirk, though. If you are restoring files to a different computer or if you are restoring to a hard drive with a different label, then you can not select "Restore to Original location". Instead, you must select "Restore to Following location" and specify where to restore the files to.
• If your old computer is handed down to someone else, make sure that its new owner isn't using your ADSM setup. The new owner must register the machine themselves and get their own nodename.
• Warning: Do not try to restore system files of old machine to the new machine. All PCs/Macs have their own system settings.

Question 1.6 I'm trying to retrieve files from my old computer to a new computer, and I get the error message: "ANS1410E Unable to access the network path". Help!

• The problem is that ADSM is trying to connect to your original computer and isn't finding it. Use "Restore to Following Location" as explained above.

Question 1.7 I notice that I get an error message if I use the archive command in datasave. The error is "The management class does not contain any archive copy groups. Unable to continue with archive."

• The archive function is not available at UIC. We run ADSM only as a backup/recovery system. Currently, we have no plans to enable the archival function and commit to long term data storage.

Question 1.8 How long are the files saved?

• As long as a file exists on your PC, ADSM will keep a backup of that file. This "most recent" backup is called the ACTIVE copy. If you never erase it from your PC, ADSM never erases the backup copy.
• If you erase a copy from your PC, then the next time you invoke ADSM, the backup copy will be changed from ACTIVE to INACTIVE. It will then remain on tape for 60 days before ADSM deletes the backup copy. This gives some leeway to recover a file that was lost.
• If you modify a file (and run ADSM often), ADSM will keep 1 "active" copy and 6 "inactive" copies. The active copy sticks around forever (unless you erase it from your PC) while only the 6 most recent "inactive" copies are kept for as long as 28 days. Each time you change the active file, the previous backup copy is marked as "inactive". Since a max of 6 inactive copies is kept, the oldest inactive copy will be deleted to make room.

Question 1.9 How can I authorize other users to restore my files?

• While in ADSM, from the Utilities menu, select Set Authorization (Windows) or Node Access List (Macs), then select Add. Fill in the Add authorization information. Click OK. You can authorize others for the whole drive, or selected directories, or selected files.

Question 1.10 When I tried to set up my datasave account, I received a message saying that my machine was not in the database. What does that mean?

• Your computer is not registered with our Domain Name Servers. Contact the Client Services Office for information on how to register your computer.

Question 2.1 How do I run the ADSM scheduler on Windows NT/2000/XP/Vista?

• When running NT, 2000, XP, or Vista, the scheduler is started differently than on 95/98/ME. It is started and run as a System Service, which means it should come up at boot time.
• Click Start Settings (XP) Control Panel Classic View (Vista) Administrative Tools Services
• Find TSM Scheduler in the list of services.
• Right click it and select Properties. Startup type should be Automatic. Under the Log On tab, make sure that it is set to Log On As System account, with Allow service to interact with desktop checked. If you changed anything here, reboot, to see if it comes up automatically now.
• What if the service is not there in the list of services? You might have an out-of-date version or it might not be configured correctly. Be sure you are running Version 5+ of Tivoli Storage Manager, and follow the instructions for installing the Scheduler in ADSM TSM Network Backup for Windows: Installation
• If it runs in a DOS window under NT/2000/XP, it is clearly set up wrong or is an obsolete version.
• HOW TO TELL FOR SURE THAT IT IS RUNNING OK: Examine file C:\Program Files\Tivoli\TSM\baclient\dsmsched.log and scroll down to the bottom. It tells you in this file what is going on.
• Because TSM runs as a service in NT/2000/XP/Vista, the safe icon will not be in the task bar as it is on 95/98/ME when the Scheduler is runing.

Question 2.2 I have a computer that used to belong to someone else. How do I change the ADSM setup on it?

The TSM manual says: "When the [TSM] client scheduler ... runs as a Windows service, the options in the registry are used instead [of the options in the dsm.opt file]. If you are using the scheduler service and change an option in the dsm.opt file, you must update the corresponding value in the registry as well."

The problem is that changing the information in with the TSM client doesn't necessarily change the TSM Registry entries. This is of interest to people using version 5.4 and below of the TSM Windows Client. In Version 5.5 and higher, changing scheduler information in the TSM Scheduler Setup Wizard will change the Registry entries.

So, if you are recycling a computer -- changing it from one nodeID to another, say from cbabbage.adsm1 to adabyron.adsm1, then you should delete the Tivoli Windows Registry items before you install and/or reconfigure. Or if you want to cleanly re-install TSM, you should delete the Registry entries.

Here's how to change from one nodeID to another.

• If you are using Window XP or Vista,
  1. Install the newest version of TSM for it (current is Version 5.5.1.1), if necessary.
  2. Then open the TSM Backup-Archive GUI, edit the Preferences in TSM and use the TSM Scheduler Wizard to set TSM up to use the new nodeID.
  3. If you set TSM up to use the TSM Client Acceptor, you will have to delete the Client Acceptor daemon service from your Windows Registry as outlined below.
• However, if you are using an older version of Windows,
  1. You need to completely uninstall TSM and delete the TSM Schedule service and the Tivoli and IBM/ADSM software entries in your Windows registry.
  2. Then install TSM from scratch and set it up for the new nodeid.

Here's how to delete the TSM entries from your registry.

1. Start Run...
2. Type: regedit
   in the Open: box and click OK.
3. On the left-hand side of the Registry Editor, click the + beside HKEY_LOCAL_MACHINE.
4. Click the + beside SYSTEM.
5. Click the + beside CurrentControlSet. (This is the one that your system uses when it boots. The other ControlSets are the last known good configurations.)
6. Click the + beside Services.
   
7. Scroll down to find the TSM Scheduler and the TSM Client Acceptor if you are using that. Right-click on their names and select Delete from the right-click menu.
   
8. Do the same with My Computer HKEY_LOCAL_MACHINE Software IBM ADSM -- Right-click on ADSM and select Delete.
9. Do the same with My Computer HKEY_LOCAL_MACHINE Software Tivoli -- Right-click on Tivoli and select Delete.

Question 2.3 I restored some files from my old PC and now I can't access them. Help!

• We have seen several cases where people have restored files from one Windows PC to another Windows PC (both of which use NTFS file systems) and then they can not access the restored files or folders on the new PC, even if they are logged in on an administrator account.
• Our Windows guru says the problem is small but important difference between the administrator accounts on the two PCs.
• This IBM Support page, How to take ownership of a file or a folder in Windows XP, explains how to fix this. While the page is specific for Windows XP, it also applies to Vista.

Question 3.1 I have a multi-user Mac. Is there anything special I have to do?

• The old way:
  • The instructions on how to configure TSM so that non-administrators can manage their own data is in the TSM HTML Manual that comes with the TSM installation.
  • Click on the Mac OS X Applications folder, then click on the Tivoli Storage Manager icon.
  • In the Tivoli Storage Manager folder, double-click on TSM HTML Manual.
  • Click on Installing Tivoli Storage Manager in the Table of Contents in the blue frame on the left.
  • Scroll down to the bottom of this section in the right frame; the instructions are in the section titled, Enabling non-administrators to manage their own data (required system administrator task).
  • I didn't do it, but I checked it and mine was set up like it says anyway.
• The new way: The system administrator must set Passwordaccess to generate and must use TSM to generate a password file. This is already part of the setup instructions, which might explain why it worked for me.

Question 3.2 I'm using ADSM witn MAC OS X's Case Sensitive HFS+ file system; anything special I need to do?

• If you are using Apple MacOS X 10.3 and higher new optional Case Sensitive HFS+ file system with the IBM TSM (ADSM) Mac client, you need .
• Note added Nov, 2008: if you are using the Mac OS case sensitive HFS+ OS, upgrade your TSM client to the latest version on our FTP site at: ftp://ftp.uic.edu/pub/adsm_clients/clients/mac/osx/latest immediately. There is a bug fix for this feature in them.
• The client needs a writable error log. If a log isn't present, it will be opened under the name and permissions of the user who invokes the applications. It may mean that the user won't have permission and it won't run.
• It is strongly recommended that you create any required logs (a) in a directory and (b) with proper permissions to allow all users on your Mac write access.

• Ensure the new Case Sensitive HFS+ volume does not have the same name as existing TSM volumes for the node. Either the TSM volumes can be renamed on the TSM server, or the CS HFS+ volume can be renamed locally.
• Recommended Action:

  Before backing up any files in a Case Sensitive HFS+ filesystem:

  1. Install the TSM Mac client interim fix 5.2.0.3 or a later V5.2 deliverable.

  2. If the Case Sensitive HFS+ filesystem volume is the same name as an existing TSM volume, either rename that existing TSM volume or rename the new CS HFS+ volume, to prevent case sensitive files from being mixed with case preserving files.

Question 3.3 How do I un-install TSM?

Move the following folders to the trash; you may not have all of the items, depending on which version of the TSM client you are uninstalling:

1. /Applications/Tivoli Storage Manager
2. /Library/Application Support/tivoli
3. /Library/StartupItem/dsmcad
4. If you wish, /Library/Logs/tivoli
5. If you wish, ~/Library/Logs/tivoli
6. If you wish, /Library/Preferences/Tivoli Storage Manager
7. If you wish, ~/Library/Preferences/Tivoli Storage Manager

Remove the following symbolic links:

1. /usr/bin/dsmc
2. /usr/bin/dsmtca
3. /usr/bin/dsmcad
4. /usr/bin/dsmadmc
5. /usr/bin/dsmtrace
6. /usr/bin/dsmagent
7. /usr/lib/libxmlutil-5.5.0.0.dylib
8. /usr/lib/libtsm550xerces-c1_6_0.dylib|

If you wish, move the following receipts to the trash:

1. /Library/Receipts/TsmBaClientCommon.pkg
2. /Library/Receipts/TsmBaDsmadmc.pkg
3. /Library/Receipts/TsmBaDsmc.pkg
4. /Library/Receipts/TsmBaHelpCat.pkg
5. /Library/Receipts/TsmBaIcc.pkg
6. /Library/Receipts/TsmBaJavaBundle.pkg
7. /Library/Receipts/TsmBaJavaCommon.pkg
8. /Library/Receipts/TsmBaJavaGui.pkg
9. /Library/Receipts/TsmBaSmp.pkg
10. /Library/Receipts/TsmBaWebApplet.pkg

Question 4.1 When I try to open the TSM client, the splash screen flashes but nothing else happens. What can I do?

• This will happen when there is a problem with your configuration files.
• Use Finder to go to /Library/Preferences/Tivoli Storage Manager (or /User/Library/...)
• Control-click on TSM System Preferences or tsm.sys and open it with TextEdit.app.
• Now find the problem with the preferences. If you modified the Include/Exclude statments, it's likely that the problem is an unmatched quotation mark in them.
• Fix the problem, and make sure when you save the file it's still a plain text file.
• Try TSM again.

Question 4.2 When the scheduler tried to run TSM I got PASSWORDACCESS communications failure error messages. What did I do wrong?

• If you got error messages like:

  11/07/2005 13:55:12 ANS1835E PASSWORDACCESS is GENERATE, but password needed for server 'ADSM'.
  Either the password is not stored locally, or it was changed at the server.
  

• You didn't properly initiate Password Generate.
• Change your ADSM password using the ACCC password changing utility, http://passwords.accc.uic.edu/
  Do not change your ACCC Common password. Click the: "Click here to change your ADSM password." link on the bottom right to change your ADSM password.
• Then log into TSM for Administrators with your new ADSM password, then quit TSM.
• Just logging into TSM for administrators resets Password Generate and should take care of that error message. (It's a fatal error message.)

Need Additional Help?