IBM Support

IBM Tivoli Storage Manager V7.1 Windows backup-archive Client known problems and limitations

Question & Answer


Question

This document contains warnings and known problems for the IBM Tivoli Storage Manager V7.1 Windows backup-archive clients.

Answer

Tivoli Storage Manager V7.1 Windows backup-archive client known problems and limitations



Contents
Tivoli Storage Manager Client Warnings


Common Tivoli Storage Manager Client warnings
  • If you back up or archive data from a Tivoli Storage Manager Version 7.1 client, you cannot restore or retrieve that data using a Tivoli Storage Manager Version 6.4 or earlier client.

    For more information about Tivoli Storage Manager Server/Client compatibility and upgrade considerations, go to http://www.ibm.com/support/docview.wss?&uid=swg21053218.
  • NAS backups performed on a Tivoli Storage Manager Version 6.3 server using the BACKUP NODE server command can only be restored by using the RESTORE NODE server command or a Tivoli Storage Manager Version 6.3 or later client.

Back to Contents

Windows client warnings
  • Windows PE

When running the client as described in the Tivoli Field Guide "Tivoli Storage Manager Recovery Techniques Using Windows Preinstallation Environment (Windows PE)" you will receive the error message:

ANS1464S Cannot load ICC encryption library

Because the scenarios described in the field guide are not run from a fully installed TSM client, the registry entry indicating the location of the ICC encryption library does not exist. Since the recovery scenarios described in the field guide do not involve TSM encrypted files, you can bypass this error by modifying your client options file and specifying the option ENCRYPTIONTYPE DES56. This prevents the client from attempting to load the ICC encryption library.

  • Image backup does not work with shared memory protocol.

To use the SHAREDMEM (shared memory) communications method, the TSM server and client must be executed by the same user. If the server and client are started by different accounts, then they will not be able to establish a connection with each other.
  • VM backup and restore: VMware off-host backups using vStorage for Data Protection API
  • TSM VMware off-host backup uses the virtual machine host name as the default TSM node name to store file level backup data on the TSM server. TSM clients installed inside the guest operating system also uses the host name as the default TSM node name, and therefore allows for an easy restore of off-host backup file restores. TSM Full VM backup uses the host name as the virtual machine Full VM image name on the TSM server. To ensure that these backup images are unique, TSM backup will check for duplicate host names in the same backup operation. If a duplicated is detected, the backup will fail with the following error message: ANS4161E Duplicate virtual machine name 'hostname' was detected in the same backup operation.
  • Full virtual machine backups of Windows 7 guest OS, using the LAN or Hotadd transport, when running on VMware Virtual Center 2.5 and ESX 3.5u5 will fail. The failure is not seen with other guest operating systems, or when running on vCenter4.0/ESX 4.0 level of VMware.
  • vStorage File-level backup operations can cause a crash of dsmc.exe or dsmcsvc.exe when processing certain virtual machines with very complex disk configurations. The exact virtual machine disk configuration which triggers this crash is unknown, but it was encountered on one occasion with a virtual machine having more than thirty volumes spread across six virtual VMDK disks. The volumes included a complicated mix of various software RAID types, spanning multiple disks and using different stripping. The call stack of the crash will be similar to:

    Stack Trace:
    vixMntapi.dll, VixMntapi_FreeVolumeInfo()+205696 bytes
    vixMntapi.dll, VixMntapi_FreeVolumeInfo()+219128 bytes
    vixMntapi.dll, VixMntapi_FreeVolumeInfo()+75736 bytes
    vixMntapi.dll, VixMntapi_FreeVolumeInfo()+78327 bytes
    vixMntapi.dll, VixMntapi_OpenDiskSet()+138 bytes
    dsmc.exe
  • vStorage File-level backup operations that crash or are are terminated (by pressing the Ctrl-C keys) from dsmc.exe or dsmcsvc.exe using the Hotadd Transport mode can leave the Hotadd(ed) disk mounted on the Proxy system. This mounted disk must be removed via the Virtual Center's "Edit Settings" dialog.

Back to Contents


Tivoli Storage Manager Client limitations and known problems


Common Tivoli Storage Manager Client known problems and limitations
  • A space need after colon for some languages in GUI message panels for messages(internal reference #152295)


  • Problem: When user sees a error message, space is missing from the start of the paragraph.

    Workaround: No work around. Text is still readable.

  • Sometimes user gets an ANS2120W warning, but it is a false positive and can be ignored.

    If a node with replication enabled is replicated to a target sever. And the backup to the source node fails or canceled.
    Then the output of an "dsmc query vm" or "dsmc restore vm" command from the TARGET node (via automated failover) prompts the following warning:
    ANS2120W The last store operation date reported by the server TAPSRV07 of 00/00/0 00:00:00 UTC does not match the last store operation date of 06/26/2015 03:37:36 UTC stored by the client for the filespace \VMFULL-win2008r2x64 - small.

    If it is a restore, you can safely choose to continue.
  • NOT ABLE TO USE THE TSM WEB CLIENT HELP WHEN USING THE CHROMEBROWSER
    This behavior is solved with v7.1.3, see APAR IT08462.(internal reference #92035)


  • Problem: When using the Chrome browser to access the Tivoli Storage Manager web client, the table of contents in the web client help appears jumbled, and the links in the table of contents do not work.

    Workaround: Access the web client with the Firefox browser or Internet Explorer browser and view the help there.
  • TSM Client processes Windows native deduplicated files in un-optimized form.

    If a file has been deduplicated between incremental backups, TSM will recognize a change in the file and will backup the file. It may not look right for the user because the change (file being deduplicated) is invisible to user. From end user point of view file was not changed. However, internally operating system replaces original file with a stub file, very similar to HSM. TSM client detects that change and this change is the trigger for file backup.  
    (Internal reference #101535)
  • The -absolute option does not work while doing a Journal base backup. The option is accepted, but all files are not backed up. The user will see this error in the dsmerror.log:

    ANS7559E The absolute option requires specifying the NoJournal option when performing a Journal Based Backup for backing up fs \\xxxxx\x$. (Internal reference #95289)

    Workaround: Add the -nojournal option to the command.
  • When the user attempts to modify an existing node access rule from the JGUI (Utilities -> Node Access List), the predefined path is not selected in the tree. (Internal reference #94088)
  • Java GUI: Adding Access Rule to the Node Access List fails when the file is not under a directory but in the root of the file system. (Internal reference #94256)

    Workaround:
    1. Locate a file under dir in the file system.
    2. Fill in the '*' for Filename field. This will grant access to all the files in the file system.
  • If the passwordaccess generate is set in the client option file and if an invalid password is given at the first attempt during open registration with the client, the second attempt will fail as well. (Internal reference #94896)

    Workaround:
    Retry open registration.
  • The 'capicmd' GSKit application (gsk8capicmd.exe, gsk8capicmd_64.exe on Windows; gsk8capicmd, gsk8capicmd_64 on UNIX) used to create SSL key database files fails with the "File already exists" error if one of the files of the key database has been deleted. A workaround for this issue is to delete all key database files and re-try key generation. Key database files match the following pattern: "dsmcert.*". The recommended way to delete the key database is to use following command:
  • "gsk8capicmd -keydb -delete -db dsmcert.kdb -pw password"

    Internal ticket 5571 has been opened to track this issue.


  • Initial configuration wizard reports a protocol violation
  • During a first time configuration, the configuration wizard will report a protocol violation. Additionally, the Domain panel will not list the file systems to select for the domain option.

    The error dialog can be dismissed and the configuration wizard can be used without further error.

    After the initial configuration, use the preference editor to set the Domain option.


  • Interrupt with CTRL-C
  • During a command line client operation, pressing CTRL-C might result in a TSM client program exception or other unexpected behavior. To abort a command line client operation, press the 'Q' key instead of CTRL-C.


  • Web Client tree expansion
  • When using the Web Client, the browser can crash if you do the following, using the view menu item in the backup or restore tree window:

    • Click on "Expand Entire Branch"
    • Then click on "Collapse Entire Branch"
    • Web Client font requirements for non-English file names

    For browsers running on AIX, the browser machine must have the WorldType fonts (available as package X11.fnt.ucs.ttf - AIXwindows Unicode True Type Fonts on the AIX distribution media) installed.

    For browsers running on Windows, the browser machine must have the Arial Unicode MS font installed. See Microsoft's KB article 287247 for installation instructions. If you require this font, contact your Microsoft representative.


  • Logfile out of space handling
  • If any log file (dsmerror.log, dsmsched.log, or dsmwebcl.log) runs out of space during a session, writing to that log ceases, but other processing continues. End of processing return codes will reflect all errors and conditions, not just those we were able to log.

    To prevent this problem, set the ERRORLOGMAXSIZE (for dsmerror.log) or SCHEDLOGMAXSIZE (for dsmsched.log and dsmwebcl.log) options to limit the log size to available space. Note that using these options causes the log data that would exceed the maximum to be written at the beginning of the log, overwriting the oldest entries.


  • ERRORLOGMAX and SCHEDLOGMAX behavior in out-of-space conditions:
  • If the specified maximum error log file size is greater than the available free space on the specified file system and the log is being transitioned from a non-wrapped log to a wrapped log, the following error message will be issued:



    ANS1521E Failure writing to a Tivoli Storage Manager log or log-related file:
    <LOG FILE NAME>, errno = 28, There is not enough space in the file system

    This is correct behavior. However, the log header record might be incomplete or there may be no "END OF DATA" text marker at the end of the error log. After space has been made available, the TSM client will subsequently treat the log as unwrapped because a valid header record is not found. A new log will be created and this partial log will be written to the prune file.

    If there is insufficient space in the file system to append an entry to the log, the TSM client will continue to run, but the error message will not be logged.


  • Some keywords have not been translated into Chinese for the backup-archive client:
  • Some keywords, such as "Snapshot", have not been translated into Chinese. This is most notably evident in the backup-archive client GUI.

  • If client encryption is used and you choose to abort a command line backup or archive operation when prompted for an encryption key, the entire operation will immediately end with return code (RC) 12, even if there are other files eligible for backup that do not require encryption.
  • When regional settings are updated in the Java GUI preference editor, the GUI needs to be restarted before the changes become effective.
  • There are minor errors displaying ANS1036S in foreign languages: On all platforms Polish has an extra period on the second line, and on several platforms the format is incorrect.
  • Handling spaces in file names in schedule definitions

  • When defining or updating a schedule objects parameter or the schedule options parameter with file specifications that contain blank spaces, use quotation marks around each file specification that contains blanks, then single quotes around all of the specifications. The following are some examples of proper usage of the objects parameter:

    For Windows clients:

    objects=’"c:\home\proj1\Some file.doc"’
    objects=’"c:\home\proj1\Some file.doc" "c:\home\Another file.txt" c:\home\noblanks.txt’
    objects=’"c:\home\My Directory With Blank Spaces\"’
    objects=’"c:\Users\user1\Documents\Some file.doc"’
    objects=’"c:\Users\user1\Documents\Some file.doc" "c:\Users\user5\Documents\ Another file.txt" c:\Users\user3\Documents\noblanks.txt’ objects=’"c:\Users\user1\My Directory With Blank Spaces\"’

    This will ensure that c:\home\proj1\Some file.doc is treated as a single file name, as opposed to two separate files (c:\home\proj1\Some, and file.doc). Some examples of options parameter usage:

    options='-preschedulecmd="c:\home\me\my files\bin\myscript" -postschedulecmd="c:\home\me\my files\bin\mypostscript" -quiet'
    options='-presched="c:\home\me\my files\bin\precmd" -postsched=finish'

    You can also refer to the objects and options parameter information for the define schedule and update schedule commands in the appropriate IBM Tivoli Storage Manager Administrator’s Reference.


  • Java GUI does not start with invalid option in options file
  • In rare cases, when there is an error in the dsm.opt file, the Java GUI will not start properly. The Java GUI will attempt to start, but at some point after 70%, the title screen disappears and nothing appears to happen.

    To work around the problem, refer to the dsmerror.log or dsmj.log file in the installation directory or from where the command to start the Java GUI was issued for the offending option, and remove it manually from the options file. You should be able to restart the client without problems.

  • Reset button does not function properly in Preference Editor Communications Panel
  • On certain systems, the Communications panel in the Preference editor will not display correctly when the Reset button of the preference editor is invoked. When you click the Reset button, the list of communication methods might not display the proper list after the reset is complete.

    If there is a need to reset the communication panel back to the original settings, exit out of the preference editor and restart it.


  • IMAGEGAPSIZE Option
  • The value for the IMAGEGAPSIZE option should not be specified outside the listed ranges for MB and GB units. If it is, the client will not report it as an error.


  • Select all after applying filter from Backup window
  • After applying a filter to a directory in the Backup window, when you check the check box for this filtered directory, the corresponding files in the file view on the right are not checked (not selected). To select the files in that filtered directory, click on the name of the checked directory and the boxes next to the filtered files are checked.

  • Connection Information dialog might not appear in certain situations
  • The Connection Information dialog might not appear correctly in certain situations. An exception will be logged in the dsmj.log file when this occurs. This will occur when you do the following:


    1. Start the Java GUI.
    2. Change the password (Utilities -> Change Password).
    3. After successfully changing the password, click either the Backup, Restore, Archive, or Retrieve button.
    4. Attempt to open the Connection Information dialog (File -> Connection Information).

Back to Contents

Common Windows client known problems and limitations
  • Once "Getting Started.." clicked, "Help Topics" Does not work.
    This limitation is fixed with backup_archive client v7.1.4 (internal reference #103499)


  • Problem: When launching the online help from the Backup-Archive Client GUI (dsm) using the ?->Help Topics menu item, the online help does not load the initial "Help Topics" page.

    Workaround: Manually click any help topic from the list on the left pane to load a help topic.

  • Backup of a GPFS file system (version 4.1) on Windows may fail with "ANS1228E Sending of object '\\<machine>\<drive letter>\.snapshots' failed." and "ANS5283E The operation was unsuccessful." (Internal reference #91581)

    GPFS version 4.1 is creating a ".snapshots" directory in the root of the file system. Trying to backup this directory fails with ANS1228E and ANS5283E. The overall return code of the backup operation will be 12.
    If snapshot based backups are performed with the SNAPSHOTROOT option (e.g. "-SNAPSHOTROOT=<\\<machine>\<drive letter>\.snapshots\<SNAPSHOTNAME>"), this problem does not appear.

    Workaround:
    Exclude the <\\<machine>\<drive letter>\.snapshots directory from the backup.
  • A misleading message during image backup is displayed. 
    This behavior is solved with v7.1.3, see APAR IT08519 (Internal reference #92129)


  • Problem: A misleading message during image backup is displayed. The management class name the image is being bound to is not correct. Example: 

    05:33:21 ANS2714W The management class '?I?HXO0?OCS8' specified for the 'TSM' backup destination is invalid. The default management class will be used.

    Workaround: User can issue a query backup to verify the management class name was bound correctly.
  • When performing an image restore on top of a GPT formatted volume in an Microsoft cluster environment the image restore may be fail with the following error:
    ANS1287E Volume could not be locked.

    The problem occurs because a TSM image restore requires an exclusive lock on the volume being restored. The volume is first placed in maintenance mode and then restored. There is a problem that the rhs.exe process gets a handle on the volume after the volume is put into maintenace mode. (Internal reference #95044)

    Workaround: Restore the volume to alternate non GPT formatted volume.
  • Backup of ReFS file system produces an ANS1996W "The volume mount points enumeration on 'X:\' volume failed. Windows system error code: 3; reason: 'The system cannot find the path specified.'" warning. This warning is a result of failure of Windows API FindFirstVolumeMountPoint() to find mount points. This warning does not prevent successful file level and image backups of ReFS volumes. Case 112101982825440 has been reported to Microsoft to track the issue.
  • While performing an incremental backup using the snapdiff option on a Windows TSM Client, the CIFS default security type must have NTFS-Style. The CIFS security style can be set from either of the following methods:
    • FilerView:

    Filer View -> CIFS -> Configure -> Security
    Use Group ID Permissions: No
    Default Security Style: ntfs
    • By issuing the following qtree command: qtree security /vol/nnn ntfs.

    If the CIFS security is set to mixed or unix, the client will be unable to perform the SnapDiff backup because the share will appear to be FAT and not NTFS, and will return the message: ANS2837E Failed to perform incremental backup operation using snapshot difference as the user id and password for NAS Filer have not been configured correctly.

  • Windows 2008 must be restored using Windows PE 2.0. Windows 7 and Windows 2008 R2 require Windows PE 3.0 for ASR restore.

    Snapshot Differential Backup fails from the Windows Scheduler Service when a UNC name of a NetApp Volume is specified in the DOMAIN option

    Specifying a NetApp volume in the DOMAIN statement will cause snapdiff incremental backup to fail and the following error message to be logged in the client error log:

    ANS2831E       Incremental by snapshot difference cannot be performed on '\\dumber\svt1_win' as it is not a NetApp NFS or CIFS volume.

    The problem does not occur when a drive letter mapped to the CIFS share is specified in the domain statement instead of the share's UNC name.

    The problem can be circumvented by defining a simple pre-schedule command via the PRESCHEDULECMD option.
    The easiest method of doing this is to create a batch (.cmd) file that specifies the Windows NET USE command(s) for the NetApp CIFS share name(s) being used for Snapshot Differential Backup.
    For example, the following NET USE command would make the share UNC names directly accessible to a snapdiff backup run from the scheduler service:

    NET USE \\NetAppServer\NetAppShareName

    The above command would be added to a batch file which would be run by specifying it with the client PRESCHEDULECMD .
    See client documentation of the PRESCHEDULECMD for more information on defining and specifying pre-schedule commands.
  • Installation Path Limitation
  • The TSM Client utilizes the Microsoft Windows Installer. Currently, there is an installation path limitation of 256 bytes.

    • Single Byte character sets use 1 byte per character
    • Double Byte character sets use 2 bytes per character

    Also note: TSM Client language packs use the installation path of the base client installation, so a base installation of the TSM Client that uses the maximum number of bytes in its installation path might cause the language pack installation to fail.

  • VSS image backup might fail after a VSS image restore on small volumes (about 500 MB).
  • On Windows Vista and later operating systems, VSS stores snapshot data on the volume on which the snapshot is being taken. This data located in the "System Volume Information" directory. On a 500 MB disk it takes about 350 MB to create the snapshot. TSM backs up only used blocks during the image backup. The data internal to VSS is also saved as part of the image. During an image restore, TSM recovers all image data. In this case, a second VSS image backup is not possible because of the lack of free space on the hard disk. VSS cannot create a snapshot for TSM due to the lack of space.


  • Euro symbol (€) support
  • The euro symbol does not display correctly in the command-line client. This is a Microsoft Windows limitation since the OS does not officially have a euro symbol-compatible code page (for example, cp858). In order to enable this support, you must first contact Microsoft for the cp858 file (c_858.nls) and install it under c:\WINNT\System32\ (or wherever your Windows directory is located). Then you need to modify the registry. IMPORTANT: The registry editor requires extreme accuracy. If you are not accustomed to editing the registry, ask your Windows administrator to make this change for you.

    To enable support for the 858 code page, do the following:


    1. Start the registry editor.
    2. Navigate to the following registry key:

          HKEY_LOCAL_MACHINE\
            SYSTEM\
              CurrentControlSet\
                Control\
                  Nls\
                    CodePage

    3. In the right-hand pane of the registry editor, locate the name "850". Change the value of the "850" name to the following:

            c_858.nls

    4. Close the registry editor. Reboot Windows. The TSM command line client should now display the euro symbol correctly. NOTE: Make sure your console is using a euro-capable font (for example, Lucida Console).

    To enable support for the Latin 1 code page, do the following:


    1. Start the registry editor.
    2. Navigate to the following registry key:

        HKEY_LOCAL_MACHINE\
          SYSTEM\
            CurrentControlSet\
              Control\
                Nls\
                  CodePage

    3. In the right-hand pane of the registry editor, locate the name "850". It should have a null (empty) value. Change the value of the "850" name to the following:

          c_850.nls

    4. Close the registry editor. The TSM GUI should now display the menus correctly.
  • Restoring from a backupset from a 3570 tape library attached to the client system is not supported.
  • The Web Client applet runs as a snap-in on Microsoft Management Console when the Web Client agent is installed on Windows platforms only. The Web Client applet does not work in Microsoft Management Console for Web Client agents installed on non-Windows machines.
  • When using the Web client, there are certain situations where the "Action Complete" dialog will be obscured from view and unselectable via the Windows task bar, causing other windows on top of it to become unclickable until this dialog is closed. To circumvent this problem, use the Task Manager or the "Alt-Tab" keys to bring the "Action Complete" dialog to the foreground so it can be closed. Once this dialog is closed, the other open dialogs will become accessible.
  • When installing the TSM scheduler service while the TSM server is down or otherwise unreachable, the node password will not be stored on the client computer. Without a stored password, the scheduler service cannot connect to the TSM server. To resolve this, after the TSM server becomes available, use the command line or GUI client to connect to the server, and enter the password when prompted. This will cause the password to be stored on the client computer, allowing the scheduler service to authenticate with the server.
  • This problem might occur when you are setting up a scheduler running through a firewall using the server-initiated sessions. In this case, start the scheduler from the command line (dsmc schedule) and enter the node's password when prompted. After the password is updated, stop the command line scheduler (press the 'q' key twice), then restart the scheduler service.


  • After an image has been restored to a plain file using the -imagetofile option with the "restore image" command, a data copy utility will be needed to transfer the image data from the file to a disk volume. While IBM does not provide such a utility, there are several ports of the UNIX "dd" command available for Windows. You can get one of those ports here:

 
http://uranus.it.swin.edu.au/~jn/linux/rawwrite/dd.htm

    As an example, you can enter the following command to copy the image data from the file x.img to the volume x: with the block size of 1 megabyte:

   c:\> dd if=x.img of=\\.\x: bs=1M
  • UNC names are not allowed if the local system account is set to logon

  • Restoring the system state
  • Files that are protected by the System File Protection (SFP) are restored to temporary files and replaced on reboot. Any in-use system files are also restored to temporary files and replaced on reboot. The following files have been identified by Microsoft as ones that cannot be restored:


  Ctl3dv2.dll
  DtcSetup.exe
  NtDll.dll
  Smss.exe

    You will see temporary files for those that can not be restored on your machine after the reboot because they cannot be renamed to the original file names. The names of the temporary files will begin with "$TSMxxx.orginal_name".

    Even though these files cannot be restored, this does not harm to your operating system. The temporary files TSM created can be deleted with the proper permissions.

  • Windows GUI is unresponsive during large retrieve operations
  • Currently there is a problem when starting a retrieve operation from the main window. The client appears to be unresponsive, but it is still processing information that is received from the server. The client will respond when the information has been processed.


  • Windows GUI Configuration Wizard
  • The Windows GUI Configuration Wizard for creating a service does not properly set up a service when the user selects the option to run the service under a different user account. The issue is that on Windows, the user that runs the service needs to be granted the "Logon as a service" security right and that is not being setup. You can avoid this problem by going into the MMC services panel and re-entering the users password, after which Windows automatically grants the required right to that user.


  • Windows GUI local backupset restore
  • If you do not select a backupset location after being prompted, you will receive the "Operation stopped by user" error message.

  • Windows GUI Preference Editor
  • In the Windows GUI preference editor Diagnostic tab, the warning is not removed from the filename box when tracing is disabled and an error exists.


  • Web Client performance workaround
  • Disable Java caching from the Java Control Panel to help improve performance on the Web client on the browser machine.


  • TSM Client Automatic Deployment known problems and limitations
  • Client installation images and temporary files are not removed after an automatic restart
  • After the client deployment, the deployment manager tries to remove the self-extracting installation images and temporary files. However, if the deployment manager automatically restarts the client computer, the reboot interrupts the cleanup and the self-extracting images and temporary files are not removed. The deployment status will be "Success".


  • A client deployment requires a reschedule if the deployment process missed the set start time
  • To ensure all system resources are released before the new client installation, the client deployment utilizes a two-step process:


    1. The setup script registers the deployment process with Windows Task Scheduler as a task to run at a set start time. The setup script exits and all system resources used by the backup archive client are released.
    2. At the start time, the operating system triggers the deployment process, which is independent of the client.

    However, if the start time is missed, the deployment status is "Unknown" and the ANE4252E message is logged in the setup.log file. The client deployment requires a reschedule.


  • A client deployment requires a reschedule if the extraction of the installation image stalls
  • If the extraction of the installation image takes longer than 10 minutes, the deployment status is "Stopped", and the client deployment requires a reschedule.


  • The client deployment status is "Failed" with exit code 259 if the installation takes more than one hour
  • If the installation of the new client takes longer than one hour, the deployment manager times out with a deployment status of "Failed" and Microsoft installer return code 259, which indicates that no data is available. Check the installBA.log for the actual installation result.


  • Intermittent problem with Active Directory individual object restore
  • Active Directory queries ("query adobjects" command) and restores ("restore adobjects" command) can occasionally fail. In case of failure, the following error error message might be issued:

    ANS5821E Cannot connect to Active Directory.

    A retry of the operation should resolve the issue. If you see it constantly failing after several retries, contact TSM support.


  • Insufficient space in Javaheap
  • If the following messages are received from Java Virtual Machine (JVM) while running DSM executable:



    JVMST109: Insufficient space in Javaheap to satisfy allocation request
    JVMDG217: Dump Handler is Processing OutOfMemory - Please Wait.
    JVMDG315: JVM Requesting Heap dump file

    These errors indicate that your JVM maximum heap size is too small. The default value is 64 MB. To increase the maximum heap size and avoid this issue, add the -Xmxn (where n is size in MB) option on DSM startup. For example, to increase the maximum heap size to 256 MB, the following should be done :



    dsm -Xmx256m
  • The client crashes backing up a virtual machine on vCenter/ESX 4.1 when using TSM application protection.
  • The problem is being investigated. In the meantime, do not use TSM application protection (INCLUDE.VMTSMVSS) with VM's on vCenter/ESX 4.1.


Back to Contents

Windows 32-bit known problems and limitations
  • Moving a directory from Windows Explorer using cut and paste can result in the old and new directories not being properly backed up or expired during a journal based backup under certain circumstances.
  • A directory move operation can be done from a command prompt with the move or rename command, or from Windows Explorer using drag and drop or cut and paste.

    The TSM Journal daemon assumes that a "move directory" operation has occurred when a delete directory operation is followed immediately by a create directory operation.

    If a delete directory operation is not followed by a create directory operation (for the same directory), the delete operation is assumed to be for a single directory object and not as the result of a move operation.

    For a move operation, journal based backup must force a normal incremental backup of both directories in order to ensure that all files in the deleted directory are expired correctly, and that all files in the destination directory are backed up correctly.

    For a single directory delete operation, only the directory itself is expired on the TSM server.

    Since it is possible to perform other operations between the time a Windows Explorer directory cut operation is performed and when the follow-on paste operation is performed, the TSM Journal daemon might not correctly identify the operation as a directory "move" operation.


  • Restoring files causes the journal to record the change activity. If the restore is using the active backup copy, the change record is deleted from the journal. When restoring with a backupset, it is not possible (without querying the server) to know if the copy of the file is the active backup copy. The net result is that if the next incremental backup is done using the journal, these files will be backed up again. This can be avoided by performing an incremental with the -NOJOURNAL option.
  • Known problems with anti-virus software
  • Some anti-virus software can incorrectly generate change notifications to the TSM journal service, causing files that have not changed to be incorrectly backed up during journal based backup.

    Development is currently working with virus protection vendors to fix these problems. If you see these problems with virus protection vendors not listed below, report the problem to your virus protection software vendor or IBM support.

    Symantec Norton Anti-Virus Corporate Edition (Nav)

    Symantec has implemented an interim fix which eliminates most incorrect change notifications generated during Nav scan processing.

    This interim fix was incorporated into Nav CE version 7.51 and must be obtained from Symantec technical support.

    The complete fix is included in Norton Anti-Virus Corporate Edition 8.0 and higher.

    Customers should refer to Knowledge Base article 4011082926 and the CRT STS number (Defect 362082, Incident 421919).

    Note that the initial interim fix still generates some incorrect notifications for attribute (read-only, archive, etc) bitmask changes, and requires a registry setting for NAV and a Journal Based Backup .ini file setting.

    Note that this fix will prevent Nav from preserving the last access timestamp on any scanned objects.

    The Journal Based Backup service must also be configured to not generate change notifications for last accessed timestamp changes and attribute bitmask changes.

    Two changes must be made to enable this fix:


    1. Set the following DWORD registry value:

            HKLM\Software\Intel\LANDesk\VirusProtect6\CurrentVersion
              NoFileMod = 1

    This setting prevents Nav from caching and restoring timestamps and security information during scan processing.


    2. Include the following in the Based Backup .ini file (tsmjbbd.ini):

            [JournaledFileSystemSettings]
            NotifyFilter=0x15b

    This setting will generate change notifications for the following type of change activity:

    • Name changes (creations, deletions, and renames)
    • Size changes
    • Modification timestamp changes
    • Security (acl) changes

    It will not generate notification for last access timestamp or attribute bitmask changes.

  • Restoring data with multiple TSM encryption keys
  • If you need to restore a group of files that have been encrypted by TSM with more than one encrypt key for the group, the files might not be restored. The following error message will be logged in dsmerror.log:

    ANS4014E Error processing '\\spike\c$\want\dollar': unknown system error (150) encountered. Program ending.

    The restore will continue, but the file will not be restored. You need to re-submit the restore request to restore the individual file.


  • Windows 32-bit and 64-bit interoperability
  • Windows 32-bit applications have a different HKEY_LOCAL_MACHINE\SOFTWARE registry tree from 64-bit applications. This means that the 32-bit and 64-bit TSM API are mutually exclusive and their passwords will be stored in different locations in the registry tree. Thus the 32-bit API will not be able to access the password entries generated by the 64-bit API.

    For example:

    The 64-bit BA client package will only install a 64-bit scheduler. But another application could be using the 32-bit API. If the scheduler and application share the same node name, then the generated passwords stored in the registry in encrypted form could become out of sync. If the application changes the password, the 32-bit portion of the registry will be updated with the new password, but the 64-bit portion of the registry will not reflect this change.

    To alleviate password synchronization issues between 32-bit and 64-bit Windows clients, use a separate node name for each client.


  • Windows image backup and restore
  • The TSM client can back up a consistent snapshot of a volume, but it cannot guarantee consistency of applications that store data on multiple (different) volumes. For example, the TSM client can back up the image on drive F:, but if Application A keeps its main data files on drive F: and its log files are on drive G:, when the TSM client restores drive F: the data files might not be in sync with whatever changes might have gone into the log files on drive G: since the image backup of drive F:.

    If an unrecoverable read failure occurs during image backup, the following message is displayed:



    ANS0322E (RC4161) no text available for this return code.

    The return code 4161 means device read error.

  • Bad Sectors on a drive
  • If part of the volume resides on an area of the drive with bad sectors TSM will skip those sectors while sending image data to the server, displaying the warning message ANS2026W. In some rare cases an attempt to read data from bad sectors may lead to device read failure with image backup failing. If this is the case the possible workarounds are:


    1. If the volume is formatted (not raw) use full incremental backup instead of image backup.
    2. If the volume resides on an IDE drive, try moving the data to a SCSI drive. SCSI drives are more robust in terms of bad sector recovery.
  • Problems migrating from 32-bit to 64-bit
  • The restore of system state data backed up from 32-bit Windows environments to 64-bit Windows environments (and vice versa) is not supported.

    The restore of DFS links backed up from 32-bit Windows environments to 64-bit Windows environments (and vice versa) is not supported.

    When migrating from 32-bit Windows to 64-bit Windows, it is recommended that you avoid backing up the 64-bit system state data into the same file spaces containing the 32-bit system state data. This precludes inadvertently restoring the 32-bit data, which is incompatible with 64-bit Windows.

    To avoid commingling the data, you can do either of the following before migrating to 64-bit Windows:

    • Ask your TSM administrator to rename the existing file spaces. Once the migration is complete and you have backups of the 64-bit system object or system state data, your TSM administrator can delete the renamed file spaces. Since the 32-bit system state data must not be restored to 64-bit Windows, there is little reason to retain the data.
    • File spaces to rename include one or more of the following:
    • SYSTEM STATE
    • SYSTEM SERVICES
    • Ask your TSM administrator to delete the existing file spaces (listed above) for your node.
  • Connecting to server SSL port by mistake
  • If a client connects to SSL port on the server but the client doesn't have SSL enabled, the client would seem to hang until the session times out on the server.

    The client doesn't have a way to tell whether server is expecting SSL or not. If you forget to enable SSL on the client, it will try to connect with regular (non-SSL) session to server's SSL port. The connection will "hang" because both client and server would wait on expected responses from each other.

    To avoid this situation, make sure you set SSL option to "yes" along with setting the TCPPort to server's SSL port.


  • Browsing Web Client help issue
  • When browsing Web Client help, the following error message maybe logged in the dsmerror.log on the machine where the TSM Client Acceptor resides:



       Error reading http request.

Back to Contents

Windows 64-bit known problems and limitations
  • "No file spaces' on 'query VM' for Hyper-V guests needs to be documented (Internal reference #119871)


  • Problem: For backup-archive clients on Windows x64, when a Periodic Full backup is used to back up Microsoft Hyper-V virtual machines, the query vm command lists the virtual machines that have been backed up, but includes the message "No file spaces for node node_name were found on the server". This is because there were no Incremental Forever backups. You must be licensed to use Tivoli Storage Manager for Virtual Environments: Data Protection for Microsoft Hyper-V to use the Incremental Forever backup type.

    Workaround: None
  • CLUSTERDISKONLY option set NO may cause slowness on Backup-Archive Client startup (Internal reference #90569)


  • Problem: A one time delay of 8 to 40 seconds during program start when CLUSTERDISKONLY option is set to NO.

    Workaround: None
  • File level back up of a Windows 2012 VM using a Windows 2012 backup proxy fail (Internal reference #98499)


  • Problem: When performing a file level back up of a Windows 2012 VM using a Windows 2012 backup proxy, the operation will fail with return code 4 and a four access denied messages.
    The customer will see the following type of errors for four different directories, one which will look like this:
    ANS1228E Sending of object '\\vm3a\c$\Windows\System32\LogFiles\WMI\RtBackup' failed.
    ANS4007E Error processing '\\vm3a\c$\Windows\System32\LogFiles\WMI\RtBackup': access
    to the object is denied.
    Even though the backup is reported as failed, everything is backed up successfully with the exception of four directories and the backup may be used for restore.

    Workaround: Perform the file level backup of the Windows 2012 VM using a Windows 2008 or Windows 2008 R2 backup proxy(data mover).

Back to Contents

VMware backup known problems and limitations

VMware off-host full VM backup using vStorage APIs
  • VM backup with application protection of VMs hosting vCenter or vCenter related infrastructure applications fails with ANS2330E during first attempt. (internal reference #147798)
      
    Problem: VM backup with application protection of VMs hosting vCenter or vCenter related infrastructure (Platform Services Controller server, databases used by vCenter, etc) may fail with ANS2330E during first attempt due to VMware APIs are unresponsive during snapshot operation.
           
    Workaround:
    • Disable application protection for such vms and use in-guest client to backup necessary application data.
    • Use application protection with persistent VSS snapshots (done automatically during second attempt of vm backup).

  • Disks identified with testflag VMRESTORE_FORCE_THIN  marked as thick eager zeroed after VM is restored on NFS based datastores. (internal reference #108542)

    Problem: This issue occurs during a VMware restore with snapshot due to a VMware bug identified in the following VMware Knowledge Base article: http://kb.vmware.com/kb/2137818

    The disk is marked as thick eager zeroed when the snapshot is removed after the VM is restored. The disk is created thin and is only marked as thick eager zeroed at the end of the restore operation. This issue does not impact performance or storage.


  • Unable to get SAN transport when performing backup or restore VM operations on disks that are a multiple of 2 TB in size. (internal reference #105397)

    Problem: When attempting to perform a SAN backup or restore VM operation on a virtual machine that has virtual disks that are greater than 2 TB, NBDSSL or NBD transport may be selected instead of SAN. This problem may occur if the virtual disk is a multiple of 2 TB in size (2 TB, 4 TB, 6 TB, etc).
    See the following VMware KB article for detailed information: http://kb.vmware.com/kb/2135503

    Workaround: To workaround this issue until VMware provides a fix, specify the VMVSTORTRANSPORT option to NBD or NBDSSL in dsm.opt (Windows) or dsm.sys (Linux).


  • Intermittent backup failure of VMs on vVol datastores in V7.1.4 (internal reference #108537)

    Problem:
    In this scenario, a backup VM operation using the scheduler service fails with the following error messages:
    ANS4174E
    ANS1228E
    ANS5283E

    However, the same VMs can be backed up successfully by starting the operation manually (dsmc backup vm), or by starting the scheduled backup manually using dsmc sched.

    The failure occurs when all of the following conditions exist:
    • The VMs are on vVol datastores.
    • A different userid account is used for the scheduler service. For example, a Local Administrator account versus the Active Directory Administrator account.

    Workaround:
    This is a known issue. To avoid this issue, make sure that the same account is used for all backup operations. If the problem still exists, change the temp working directory in the dsmvddk.opt file by setting the tmpDirectory option. Create this temp working directory using the same account that will be used for performing backups.

  • Unique VM names (internal reference #145450)

    Problem:
    VMware vCenter allows for two or more virtual machines to have the same display name. IBM Spectrum Protect requires that all virtual machine names in a vCenter server configuration be unique.

    Workaround:
    To prevent errors during processing, ensure that all virtual machines have a unique display name.

  • Transport mode does not failover (internal reference #145451)

    Problem:
    In this scenario, the vmvstortransport option is specified during a backup vm and restore vm operation. The specified transport mode becomes unavailable during processing and the operation fails. The Tivoli Storage Manager backup-archive client does not failover to another transport mode when the specified transport mode becomes unavailable during an operation.

    When this occurs, the dsmerror.log contains a reference to "VixDiskLib_Write" or VixDiskLib_Read".

  • VMware Change Block Tracking (CBT) support for content-aware backups (internal reference #145453)

    Problem:
    IBM Spectrum Protect full VM backup will use VMware Change Block Tracking (CBT) support if available to enable content-aware (used-block only) backups. VMware CBT requires ESX 4.0 or later host (with virtual hardware 7). IBM Spectrum Protect will turn on CBT on the first IBM Spectrum Protect backup of the virtual machine.
    IBM Spectrum Protect full VM backup does support virtual machines that do not support CBT. In this case, both used and unused areas of the disk will be backed up and an informational message will be logged to the dsmerror.log. The command line 'dsmc show vm all' will display the CBT status. See also http://www-01.ibm.com/support/docview.wss?uid=swg21681916


  • RDM Physical Compatibility Mode and Independent disks (internal reference #145455)

    Problem:
    Backups are not supported for virtual machines that have either independent disks (either persistent or non-persistent), or that have raw device mapping (RDM) disks configured in physical compatibility mode. RDM disk configured in virtual compatibility mode are supported. In previous releases, attempting to back up a virtual machine that included one of these disks would fail.
    Two options have been added to allow the virtual mskiprd skioachine backup to succeed, but skip the backup of these disks. Also on restore, these disks will not be restored. The options are "VMPROCESSVMWITHPRDM=NO/YES" and "VMPROCESSVMWITHINDEPENDENTDISK=NO/YES". The default for these options is "NO", meaning the virtual machine will fail to backup.

    Workaround:
    If both types of disks are included in the virtual machine, then both options must be specified and set to "YES" for the backup to succeed.


  • Client-side deduplication performance and return code=254 (internal reference #145456)

    Problem:
    VMware off-host full VM backups with client-side deduplication enabled fails with return code=254. Error message:

    ANS7899E The client referenced a deduplicated extent that does not exist on the IBM Spectrum Protect server.


    This error can occur when a IBM Spectrum Protect server expiration or similar process is either in the process of removing a deduplicated extent or has an extent locked during the backup. A subsequent backup should succeed.

    Workaround:
    When running heavy backup loads on the IBM Spectrum Protect server, if a VM backup fails multiple times with RC=254 or an increase backup run time is noticed when client-side deduplication is enabled, disable client-side deduplication for the VMware backup proxy node. This issue does not occur when using server-side deduplication.
  • Incorrect level of the VMware Tools (internal reference #145466)

    Problem:
    When a IBM Storage Protect backup VM command fails consistently with the following error in the dsmerror.log, an incorrect level of the VMware Tools might have been installed inside the guest OS:

    ANS9365E VMware vStorage API error.
    IBM Spectrum Protect function name : visdkWaitForTask
    IBM Spectrum Protect file          : vmvisdk.cpp (2811)
    API return code   : 78
    API error message : Cannot create a quiesced snapshot because the create snapshot operation exceeded the time quielimit for holding off I/O in the frozen virtual machine.


    or
    ANS9365E VMware vStorage API error for virtual machine '<vmname>'.
    IBM Spectrum Protect function name : CreateSnapshot_USCORETask
    IBM Spectrum Protect file          : ..\..\common\vm\vmvisdk.cpp (6704)
    API return code   : 2249
    API error message : An error occurred while saving the snapshot: Failed to quiesce the virtual machine.


    Workaround:
    It might be necessary to uninstall and re-install the latest version of VMware Tools on the guest OS virtual machine.
    If the problem persist, refer to the following VMware Knowledge Base (KB) article for detailed information and solution: "Cannot create a quiesced snapshot because the snapshot operation exceeded the time limit for holding off I/O in the frozen virtual machine ".
    http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1018194


  • Long running snapshot delete (internal reference #145542)

    Problem:
    A IBM Spectrum Protect backup VM command can fail if the delete snapshot of a failed prior run requires a longer timeout value than one set by the VMware vCenter. The following error might be logged in dsmerror.log as a result of this timeout value that is exceeded by the vStorage API:

    ANS9365E VMware vStorage API error, API error message: "server refused connection", API return code:14009


    Workaround:
    The snapshot delete will continue to be processed. The next backup attempt should succeed.

  • Change Block Tracking (CBT) needs reset (internal reference #145546)
  • Problem: When a TSM Backup VM fails with one of the following warning messages in the dsmerror.log:



    ANS9365E VMware vStorage API error.
    TSM function name : visdkQueryChangedDiskAreas
    TSM file          : vmvisdk.cpp (3592)
    API return code   : 12
    API error message : SOAP 1.1 fault: "":ServerFaultCode[no subcode]"A specified parameter was not correct. deviceKey"

         
    ANS9365E VMware vStorage API error.
    TSM function name : visdkPrintSOAPError
    TSM file          : vmvisdk.cpp (885)
    API return code   : 12
    API error message : SOAP 1.1 fault: "":ServerFaultCode[no subcode]"Error caused by file /vmfs/volumes/4ade85fd-81f49624-57f5-000e
    0cdd0d21/winxp-32/winxp-32.vmdk"

    It might be necessary to reset the VMware Change Block Tracking (CBT) for the virtual machine.

    This error can occur if the ESX server is shut down or rebooted without first entering maintenance mode. It can also occur when a backup is attempted through both the ESX Server and vCenter at the same time for the same VM. Change Block Tracking is needed by TSM to back up content-aware (used-block only areas of the disk). If CBT is in this failed state, TSM will continue with the backup, and will back up the used and unused areas of the disk.


    Workaround: Run a single TSM backup with the testflag vmbackup_cbt_reset.

    Example:  dsmc backup vm 'myvm' -testflag=vmbackup_cbt_reset.

    This testflag will require a snapshot and snapshot delete to turn off CBT and a second snapshot to turn on CBT. Therefore, the testflag should not be set permanently as it could impact backup performance.

  • "Clear lazy zero" is repeated in VMware vCenter task during VM Restore (internal reference #145548)

    Problem:
    When performing a virtual machine restore with disk type set to 'eager zero' using vSphere 4.1 or higher and when using SAN transport, the message "Clear lazy zero" is repeated in the "recent tasks" section of the VMware vSphere console, and the performance of the restore drops. VMware, instead of zeroing a VMDK as it is created, instead sets the lazy zero bit on each block in the VMDK so that it can be cleared at a later time. To avoid the performance issue, perform a restore to the ESX server instead of a vCenter.


  • Slow restore using SAN transport (internal reference #145550)

    Problem:
    Although VM backups using SAN as transport is very fast, VM restores using SAN is usually the slowest of all transports. This problem is more prevalent when thin disks are used, and VMware recommends using NBDSSL for restores when thin disks are involved.
    See the following VMware KB article for more detailed information (Best practices when using SAN transport for backup and restore): http://kb.vmware.com/kb/1035096

  • Thin-provisioned disk (internal reference #145552)

    Problem:
    There is a know problem in VMware vSphere 4 where a snapshot disk does not show the correct thin- or thick-provisioned trait based on the actual disk's property. As a result, when a backup of a virtual machine with a thin-provisioned disk set in the disk properties is performed, IBM Spectrum Protect is unable to save the thin-provisioned disk attribute. Since this attribute is not saved, IBM Spectrum Protect is unable to restore the disk as thin-provisioned, but instead will restore the disk using the thick-provisioned disk attribute.
    See the following VMware KB article for detailed information: http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1020137
    VMware vSphere 5 provides the ability to get the thin or thick trait, so this will be saved on backup, and the disk will be created with the saved attribute on restore.
    There is also a known issue with the VMware VDDK where thin disks being restored to a local datastore might incorrectly try to use the SAN transport. To restore thin disks in this situation, and also preserve the thin attribute, the "VMVSTORTRANSPORT nbdssl:nbd" (or any acceptable values excluding "san") should be used. Since "san" is not in the list of transports to use, it will not be incorrectly chosen when restoring thin disks to a local datastore.


  • English/7bit ASCII virtual machine names (internal reference #145562)

    Problem:
    There are some limitations of the VMware vStorage APIs and in IBM Spectrum Protect processing virtual machines with non-English/7bit ASCII characters in the name. Tivoli Storage Manager support for VMWare backup and restore is limited to English virtual machine names. Names using other languages is not supported at this time.


  • VMware datastore space issues for backups (internal reference #145566)

    Problem:
    When backing up a VM, a snapshot of the VM is taken and usually stored in the same datastore as the virtual hard disk that is being backed up. If there is not enough space in the datastore for this snapshot, an error will occur.

    If the VM is not running, the error message that is returned will be like the following message:
    'API error message : File testVM/testVM.vmx is larger than the maximum size supported by datastore[DataStore1_LUN1_500GB]'.


    However if the VM is running, the error returned might not be as obvious and similar to the following message:
    'API error message : Cannot create a quiesced snapshot because the create snapshot operation exceeded the time limit for holding off I/O in the frozen virtual machine.'


    Be aware of the space needed on the VMware datastore for the snapshot files when backing up VMs with large virtual disks. See the following VMware KB article for more detailed information:
    http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1012384


  • Virtual Machine names containing commas, semi-colon characters, or other special characters (internal reference #145567)

    Problem:
    The following characters have special meaning to Tivoli Storage Manager, and therefore virtual machine names containing these characters cannot be backed up using the FULL VM backup commands.
    These special characters are:  " ' : ; * ? ,  < >  / \ | 
    (double quote, single quote, colon, semi-colon, asterisk, question mark, comma, less than, greater than, forward slash, backslash, vertical bar)


  • Backing up the backup proxy (internal reference #145568)

    Problem:
    It is possible for a backup proxy running in a virtual machine to back itself up, but there are some known issues where the backup might fail because a snapshot cannot be created.
    The backup will fail with the message:
    "Cannot create a quiesced snapshot because the snapshot operation exceeded the time limit for holding off I/O in the frozen virtual machine".


    Workaround:
    It might be possible to prevent this message by modifying how a part of the virtual machine is quiesced. It is possible to configure the virtual machine so that application data is not quiesced, while still allowing the file system to be quiesced. The implication to this is that application data might not be flushed to disk before the snapshot is take. File system data will still be flushed, and the I/O held while the snapshot is being taken. See VMware KB for more detailed information: http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1031298


  • Backing up Windows 2008 and Windows 2008 R2 virtual machines containing dynamic disks (internal reference #145570)

    Problem:
    Backing up Windows 2008 and Windows 2008 R2 virtual machines that contain dynamic disks can result in the dynamic disks being detached from Windows at the end of the backup. The dynamic disks are still intact and can be reconnected to Windows.
    This problem occurs because application-consistent quiescing is performed when the snapshot is taken during the backup process. For application-consistent quiescing to be available on Windows 2008 and Windows 2008 R2, one of the conditions that Windows requires is that the virtual machine must not use dynamic disks. This is because VMware uses a hardware provider to perform the VSS snapshot, and shadow copies created by hardware providers of volumes that reside on dynamic disks have a specific requirement that they cannot be imported onto the same system.
    See the following Microsoft VSS topic for more detailed information: http://msdn.microsoft.com/en-us/library/aa384594%28v=vs.85%29.aspx

    Workaround:
    It might be possible to prevent this message by modifying how part of the virtual machine is quiesced. It is possible to configure the virtual machine so that application data is not quiesced, while still allowing the file system to be quiesced. The implication to this is that application data might not be flushed to disk before the snapshot is taken. File system data will still be flushed, and the I/O held while the snapshot is being taken.
    See the following VMware KB article for more detailed information: http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1031298

  • Restoring virtual machines backed up with Data Protection for VMware 7.1.2 from down-level clients is not supported (internal reference #145571)

    Problem:
    Virtual machines backed up with Data Protection for VMware 7.1.2 cannot be restored from down-level clients. This includes prior levels of the Tivoli Storage Manager backup-archive client, as well as prior levels of Data Protection for VMware.

  • Backing up a virtual machine that has a Data Protection for VMware volume mounted (internal reference #145574)

    Proble
    m: When the virtual machine being backed up is running Data Protection for VMware and has a Data Protection for VMware volume mounted, the backup of that virtual machine might fail with the following message:

    "Cannot create a quiesced snapshot because the snapshot operation exceeded the time limit for holding off I/O in the frozen virtual machine".


    Workaround:
    To allow the backup of this virtual machine to continue, unmount the volume from Data Protection for VMware and try the operation again.

  • Avoid uses of / (slash), \ (backslash) or % (percent) in named elements (virtual machine names, datacenter names, folder names, and so on) (internal reference #145576)

    Problem:
    VMware allows the use of (/, \, %) but VMware internally stores each of these characters as an escape sequence. A slash is escaped as %2F or %2f, a backslash is escaped as %5C or %5c, and a percent is escaped as %25.
    If one is using these special characters, then the escape sequence must be used to reference them in the IBM Tivoli Storage Manager client.
    For example: OurDatacenter\LevelOne becomes OurDatacenter%5cLevelOne
  • Message: "You do not have access rights to this file" (internal reference #145433)
  • Problem:  When a TSM backup VM command fails with the following error message in the dsmerror.log:



    ANS9365E VMware vStorage API error.
    TSM function name : VixDiskLib_Open
    TSM file : vmvddksdk.cpp (1404)
    API return code : 13
    API error message : You do not have access rights to this file


    The following should be checked:
    1. On a Windows 2008 proxy, verify that the SAN policy is set to OnlineAll
    2. Verify the TSM proxy can see the SAN disks and they are not marked as OFFLINE
    3. Verify the TSM client can resolve the name and IP of the ESX host correctly
    4. Verify the vStorage APIs license is applied
    5. Verify the VDDK temp directory contains only UTF-8 characters. Set the correct directory
    in dsmvddk.opt with tmpDirectory option. For example: tmpDirectory = C:\mnt\vmwaretmp

  • Powering on a restored Linux Guest VM with EFI boot enabled might fail. (internal reference #145435)

    Problem:
    Powering on a restored Linux Guest VM with EFI boot enabled might fail. Manual steps are required in order to configure the guest VM to properly boot from the restored Linux EFI boot disk.

    Workaround:
    The following steps describe the procedure to successfully boot from a restored Linux EFI guest VM:
    1. Remove the boot VMDK from the VM. WARNING: DO NOT DELETE THE VMDK FILE.
    2. Add the boot VMDK back to the VM and enable the boot into EFI setup console.
    3. Boot the machine and use console EFI Setup to reconfigure the boot options, adding the boot VMDK back.
    4. Use the console EFI Setup to change the boot order.
    5. Boot the machine.

  • Message "NBD_ERR_NETWORK_CONNECT (internal reference #145436)

    Problem:
    When using NBD transport, the following error in the dsmerror.log may indicate that a VMware limit of ESX host connections has been exceeded. User action is to reduce the vmmaxparallel and vmlimitperhost options to limit the number of IBM Spectrum Protect connections to the ESX host.

    ANS9365E VMware vStorage API error.
    TSM function name : VixDiskLib_Open
    TSM file          : vmvddksdk.cpp (1748)
    API return code   : 14009
    API error message : NBD_ERR_NETWORK_CONNECT


    Further VMware documentation can be found here: http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1022543

  • Restore operations using a HotAdd mode might not clean up target VMDKs from the DataMover vmx file. (internal reference #145442)

    Problem:
    If a HotAdd mode is used, during restore operations, target VMDKs might not clean up from the Data Mover vmx file.

    Workaround:
    In order to clear this problem, turn off the Data Mover VM, edit the vmx file to remove the redundant vmdks.


  • A VM backup of a virtual machine that contains a VMDK that exceeds 2 TB fails with the following message:
    ANS2236I The virtual machine 'VM NAME' contains one or more disks that exceed the maximum size limit. These disks will be excluded from the backup."

    The maximum size limit is 2 TB. Therefore, the correct message text is shown below:
    ANS2236I The virtual machine 'VM-name' contains one or more disks that exceed the 2 TB maximum size limit. These disks will be excluded from the backup.

    Workaround: Set VMSKIPMAXVMDKS=yes in the dsm.opt file to skip a VMDK that is equal to, or greater than, 2 TB during a VM backup operation.
  • Scheduler service running as "Local System Account" can consume large amounts of memory


  • Running the TSM scheduler as a Windows service running as "Local System Account" can consume large amounts of memory when processing full VM backups using vStorage APIs (TSM server define schedule action=BACKUP subaction=VM when vmbackuptype=FULLVM and vmfulltype=VSTOR). When run on a backup proxy with multiple scheduler services, the memory used on a single scheduler service process can jump to 800 MB when processing 20-30 VMs. This condition is not seen on every backup attempt. When running multiple scheduler services, for example 8-10, on a single backup proxy and more than a single process sees the increased memory usage, the performance of the entire backup and system can be effected.
    Temporary fix: Set up the TSM scheduler to run as a Windows service running as "Administrator Account". IBM is working with VMware for a fix to run as "Local System Account".

  • Restore to ESX server instead of to the vCenter

  • Restoring a virtual machine to ab ESX server, when that VM was backed up from vCenter, requires -datacenter=ha-datacenter parameter on the restore command.

  • Solution for write-protected SAN on Windows Server 2008 proxy

  • From VMware VDDK 5.0 Release Notes:
    Solution for write-protected SAN on Windows Server 2008 proxy
    When using SAN Transport or Hot Add mode on a Windows Server 2008 proxy, make sure to set the Windows SAN policy to "Online All" using Microsoft Windows DISKPART utility, otherwise writes produce error message:

    "ANS9365E VMware vStroage API error, API rc 1, API error message:Unknown error".

    A TSM client trace in some cases will show a vStorage API message "media is write protected". The SAN policy can be set by issuing the following command from diskpart:

    diskpart
    san policy OnlineAll
    exit

    See the following VMware KB article for detailed information: http://kb.vmware.com/kb/1035096
    For Hot Add mode, if setting the SAN policy to "Online All" does not resolve this issue, it might be necessary to also disable automount to prevent Windows from automatically mounting and assigning driver letters to the volumes added for the Hot Add transport. This can be done by issuing the following commands from diskpart:

    diskpart
    automount disable
    automount scrub
    exit

Back to Contents

VMware VI API known problems and limitations

    Tivoli Storage Manager client does not display virtual machines in Virtual Center linked mode. Tivoli Storage Manager development believes that this is a VMware issue. The VI API does not support Virtual Center in linked mode. You have to set up the backup proxy as it does today connecting each vCenter server. The Tivoli Storage Manager client supports connecting to one vCenter server at one time.


Back to Contents

TSM Client Configuration Wizard for Fastback Integration known problems and limitations

  • TSM FastBack V5.5.1 or later version is required

  • The TSM Configuration Wizard for FastBack integration requires TSM FastBack v5.5.1 or later version.

  • TSM FastBack Viewable Storage is not supported for Client Groups

  • When creating TSM FastBack Client Groups, use the selections from the server/volume panel. If you chose an entry from the Viewable Storage, you receive a FastBack warning message - FBSG10571 - recommending that this selection not be used. The TSM for FastBack integration will NOT work for any selections made from the Viewable Storage, and unpredictable results will occur if such a selection is made.

  • Unicode characters are not supported by FastBack

  • TSM FastBack does not support unicode characters, so when creating FastBack policy names, etc., be sure to avoid entering unicode characters. TSM Client Configuration Wizard for FastBack uses the names displayed by the FastBackShell "mount dump" command, so avoid any characters which appear differently when displayed via that command versus what is entered into the TSM FastBack Manager GUI. (Some UTF-8 characters may be formatted differently by FastBack for display purposes and will not work with the TSM Client Configuration Wizard for FastBack).
  • The TSM FastBack credential file is required On the FastBack installation drive, a directory named \FastBackTSMScripts must exist and must contain the credential.txt file for the TSM for FastBack integration. The TSM Client Configuration Wizard for FastBack will create subdirectories and script files in this directory, so care must be taken not to delete files that might be needed for subsequent scheduled TSM backups

  • On the FastBack installation drive, a directory named \FastBackTSMScripts must exist and contain the file credential.txt for the TSM for FastBack integration. The TSM for FastBack integration will create subdirectories and script files into this directory, so care must be taken not to delete files which may be needed for subsequent scheduled TSM backups.

  • Avoid FastBack Policy names that differ only by underscores and spaces

  • The subdirectories created for script files are named as follows:
    \FastBackTSMScripts\Policy\server\volume (e.g. C:\FastBackTSMScripts\Policy_Name_1\TESTMACHINE\C)
    To avoid problems with spaces appearing in these scripts, the directory names are created by converting any spaces ' ' to underscores '_'. Hence these two Policy names "Policy with spaces" and "Policy_with_spaces" will both be stored to the same directory and overwrite each other if both are used for the TSM Client Configuration Wizard for FastBack.

  • The "Schedule Start" and "Register FastBack Client as Client Node" pages that simplify the TSM schedule startup procedure are available for the Java GUI only.

  • These pages are not available if you use the wizard in the Web Client.

  • Resource Bundle Error Messages displayed in the dsmerror.log when running the wizard - Web Client version only

  • The following Resource Bundle Error messages might be displayed in dsmerror.log when running the Tivoli Storage Manager Configuration Wizard for FastBack from the Web Client:
    Error opening input file com/ibm/ps/uil/nls/UilInternalResources_en.class
    These errors do not affect the functioning of the Web Client wizard and can be ignored.

  • LVSA driver creates tsmlvsacache directory to store internal data. This directory is not excluded from image backup.


Back to Contents

[{"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Client","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
17 June 2018

UID

swg21646952