IBM Tivoli Storage Manager V6.2 UNIX and Linux Backup-Archive Client known problems

Technote (FAQ)


Question

This document contains warnings and known problems for the IBM Tivoli Storage Manager V6.2 UNIX and Linux backup-archive clients.

Answer

Tivoli Storage Manager Client known problems and limitations



Contents

Common Tivoli Storage Manager Client warnings
  • If you back up or archive data from a Tivoli Storage Manager Version 6.2 client, you cannot restore or retrieve that data using a Tivoli Storage Manager Version 6.1 or earlier client.
  • NAS backups performed on a Tivoli Storage Manager Version 6.2 server using the BACKUP NODE server command can only be restored using the RESTORE NODE server command or a Tivoli Storage Manager Version 6.2 client.

Back to Contents

Common Tivoli Storage Manager Client known problems and limitations

Common known problems and limitations for version 6.2.5 (applies to all modifications of version 6.2.5)
  • Dsmagent can crash if it is killed during a restore operation

    On UNIX and Mac platforms, when the Tivoli Storage Manager Java GUI or Web GUI is used to perform restore or retrieve operations, and the dsmj or dsmagent process is killed while the operation is still in progress, the dsmagent can crash. There is no negative impact other than creating a core file.

    If you need to end an application while an operation is in progress, either click the Stop button, or have the Tivoli Storage Manager administrator cancel the session.


Common known problems and limitations for version 6.2 (applies to all modifications of version 6.2)
  • Client-side data deduplicaton memory requirements
    Client-side data deduplication might require additional memory during backup or archive processing. You might need to increase the system limit on the size of the data area (segment). To check current setting of the limit, run the following command:

         ulimit -d

    To update the limit, run the following command:

         ulimit -d <new value>
    or

         ulimit -d unlimited
  • 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.

  • 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 the 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 UNIX and Linux clients:

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

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

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

    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.

  • The list of new and changed messages in client_message.chg is not up-to-date

    The client_message.chg file that is included with the client does contain the current list of new and changed client messages from V6.1.0 to V6.2.0. See this technote for the list of V6.2 new and changed client messages: http://www.ibm.com/support/docview.wss?uid=swg21424452

  • 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 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 UNIX and Linux warnings
  • For option and input files in DBCS locales, ensure that all TSM client option and input files (such as dsm.opt, dsm.sys, and filelist) are created in the same SBCS locale as the TSM client.

Back to Contents

Common UNIX and Linux known problems and limitations
  • NFSTIMEOUT option

    This known problem applies to all UNIX and Linux platforms except for Mac OS. The nfstimeout option can fail if the NFS file system is hard mounted. If a hang occurs, remove the nfstimeout option from your options file and soft mount the NFS file system as follows:

    mount -o soft,timeo=5,retry=5 machine:/filesystem /mountpoint

    The parameters are defined as follows:

    • soft: Generates a soft mount of the NFS file system. If an error occurs, the stat() function returns with an error. If the option hard is used, stat() does not return until the file system is available.
    • timeo=n Sets the time out for a soft mount error to n seconds
    • retry=n Set the internal retries and the mount retries to n, the default is 10000.
  • TSM editor in various terminal environments

    The TSM interactive-mode command line editor is designed to work in the following terminal environments:

    • xterm --- This is the default if terminal type not recognized.
    • xterm (Linux KDE)
    • aixterm
    • dtterm
    • VT-100

    Each of these terminals has a slightly different key map, so certain keys, such as the destructive backspace or the arrow keys, might not be supported on your workstation. If your terminal type is not supported, or you find working with the supplied editor support to be inconvenient, then add EDITOR NO to your dsm.opt file to use the native input support. Using this option will disable interactive-mode command recall.
  • Client interoperability
    • Data that has been backed up from Mac OS versions prior to Mac OS X will not have the correct file owner or permissions when restored on Mac OS X. After the restore is complete, use the "sudo chown" and "sudo chmod" commands to set them.
    • Files backed up or archived by the z/OS Unix System Services client cannot be restored or retrieved by any other TSM Unix client. Files backed up or archived by any other TSM Unix client cannot be restored or retrieved by the z/OS Unix System Services client.
    • Files backed up or archived with DES-56 encryption on Intel platforms such as Linux86 cannot be restored or retrieved on non-Intel platforms (for example, AIX), and vice versa. AES-128 is the recommended encryption method.
  • File names containing characters with code > 127 (does not apply to Mac OS)

    If you want to back up files with names containing characters with a code > 127, ensure that you have chosen either an SBCS character set locale or a DBCS character set locale corresponding to the encoding of the file names. The default code page C or the code page POSIX supports characters up to 127 only. Files whose names contain special characters that are not supported by the current locale will be skipped.

    It is strongly recommended that you perform a system backup by using a SBCS character set to prevent any file or directory from being skipped. This action ensures that all files are backed up independent of their character set encoding.

  • Restore and retrieve using FOLLOWSYMBOLIC option

    If you want to restore or retrieve to a destination path that contains a symbolic link to a directory, use the "FOLLOWSYMBOLIC Yes" option setting either during the operation or in your client options file (dsm.opt). This setting allows you to restore or retrieve the original directory tree underneath the destination path. Otherwise, you will get the ANS4029E error during restore or retrieve.

  • Option and input files in DBCS locales

    If you create TSM client option and input files (such as dsm.opt, dsm.sys, and file lists) using different SBCS locales or using DBCS locales, the TSM client might not correctly process the file names in those files. You might receive error messages ANS1228E or ANS4005E.

    Ensure that all TSM client option and input files, such as dsm.opt, dsm.sys, and file lists, are created in the same locale as the TSM client.

  • Java GUI and Web client known problems and limitations
    • The Web and Java GUI client will fail to restore a directory if a filespace with the same name exists on the Tivoli Storage Manager server. You might see the error message "No Objects on the server match query" or "ANS1395E The destination filespace or drive letter is unavailable. The following object is not processed: Filespace: '/'".

      For example, '/opt' is a file system backed up by Tivoli Storage Manager. After reinstalling the machine, '/opt' is a directory below file system '/'. File system '/opt' no longer exists on the Tivoli Storage Manager client machine. The file system '/' and all of its subdirectories, including directory '/opt', is backed up by Tivoli Storage Manager. At this point there are both '/' and '/opt' file spaces on the Tivoli Storage Manager server for this Tivoli Storage Manager client node. Trying to restore files out of filespace '/', directory '/opt' fails using the Web/Java GUI (dsmj) client.

      If you experience this problem, the workaround is to use the command line Tivoli Storage Manager client to restore the files. Put the file space name in curly brackets.

      Example:
      dsmc restore "{/}opt/subdirectory/*" -subdir=yes

    • The maximum trace file size (tracemax) for the Java GUI preference editor is 2147483647 MB. This is a temporary workaround until the preference editor can accommodate larger numbers.
    • Web Client Security Exception

      If you get a Security Exception error when running the Web Client in your browser due to the Web Client trying to open a TCP/IP socket to a socks server, disable the proxy server via your browser settings or Java Plugin control panel. See the "Starting a Web Client Session" section in Chapter 3 "Getting Started" of the "IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients Installation and User's Guide" for more information.

    • Web Client concurrent restore

      Running more than one restore or retrieve operation at the same time from the Web Client might cause the browser to hang when destination or message windows from the different restore/retrieve processes appear on the screen at the same time. If this happens, close the Web Client browser windows, stop the TSM Agent service, then retry the operations using only one Web Client session.

    • Insufficient space in Javaheap (Java GUI)

      If you receive the following messages from Java Virtual Machine (JVM) while running DSMJ:

      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 64M. To increase the maximum heap size, add the option -Xmxn (where n is size in MB) in the DSMJ script, such as the following example:

      java -Xmx256m -DDSM_LANG=$LANG -DDSM_CONFIG=$DSM_CONFIG -DDSM_DIR=$DSM_DIR \
          -DDSM_LOG=$DSM_LOG -DDSM_OPTIONS="$OPTIONS" -DDSM_ROOT=$PWD    \
          ${JAVA_XARGS} -jar dsm.jar

      This example increases the maximum heap size to 256MB.

    • Search/Filter (Web and Java GUI)

      The Search/Filter function might appear to be unresponsive when searching through very large file systems. This is caused by the Java Virtual Machine (JVM) running out of memory. You should see a "java.lang.OutOfMemoryError" in the Java console.

      The Search/Filter function is not supported for Data Protection for Lotus Domino and Data Protection for WAS objects.

    • Problems with different JRE versions
      • There are several different Java Runtime Environment (JRE) versions available. Depending on the version and the operating system, there are some known problems related to JRE. See the Software Requirements section for the supported and required JRE version to be used with the TSM Java GUI for your operating system.
      • Some JRE versions have problems transferring the cursor focus to a component. For example, accessing shortcuts in the menu (e.g., pressing ALT-F to open the file menu) and combo-boxes in a modal dialog by clicking the mouse button might not get the cursor focus correctly. To solve this problem, transfer the cursor focus manually to that component by pressing the TAB key (or CTRL-TAB) several times.
    • Preference Editor limitations (Java GUI)
      • The domain list in the "Backup" tab of the preferences editor does not reflect any domains excluded via the dash operator after "domain ALL_LOCAL" in the domain statement of the client options file.
      • When any option is changed in the preferences editor of the Java GUI, the domain list is rewritten to the client options file.
      • When using the preferences editor to modify the Include-Exclude list, and the selected rule contains a space (for example, /test dir/inclexcl.txt), the rule will not be correctly displayed in the "Filename or Pattern" field. To work around this problem, you can either manually update this field via the "Browse" button, or manually type in the correct path. This will be fixed in a future release.
      • The Preferences Editor invoked from the UNIX Backup-Archive Client Java GUI uses the DSM_CONFIG variable instead of the passed parameter "optfile".
      • The warning in the Diagnostic tab is not removed from the filename box when tracing is disabled and an error exists.
    • Backup Window
      • When you select an item in the filelist tree of Backup window, the drop-down box for backup type will be permanently disabled. To re-enable this, exit the Backup window and reload the window.
    • Web client performance
      • Disable Java caching from the Java Control Panel to help improve performance on the Web client on the machine running the browser.
Back to Contents

Common AIX known problems and limitations
Common AIX known problems and limitations for version 6.2.2
  • If you perform snapshot difference incremental backups of N-Series or NetApp volumes, make sure that the volumes are defined with a security style of UNIX. Backups will complete successfully even if the security style is NTFS or MIXED. However, it is recommended that you use a security style of UNIX.
  • During snapshot difference incremental backup of N-Series or NetApp volumes, if files are skipped due to any reason, such as Tivoli Storage Manager server media mount being unavailable, these files might not be backed up during subsequent backups either, unless the files have been modified. Such files will be logged to the TSM error log. You can back them up manually or perform a snapshot difference backup with the option "createnewbase" set to "yes".
  • Snapshot-based image backup of file systems or logical volumes in a big or scalable volume group
    The Tivoli Storage Manager client will fail to perform snapshot-based image backup of two or more file systems or logical volumes in parallel for a big or scalable volume group. It is an AIX OS limitation. To avoid this situation, run snapshot-based image backups for big or scalable volume group sequentially, ensuring that the first backup is complete before starting the next one.

    For example avoid invoking image backup as follows:

    1. dsmc backup image /fs1 /fs2 /fs2
    2. Start image backup for /fs1. Start image backup for /fs2 while the backup of /fs1 is still in progress.

    This problem will be fixed in an upcoming AIX maintenance level with the APAR IZ74114.

  • During restore of NFS file system TSM client can failed to change modification or access time of the directories. And the following message can be dispayed:

    ANS4007E Error processing 'directory name': access to the object is denied
    ** Unsuccessful **


  • If a multi-line text contains symbols that occupy more than one column position (like Japanese or Chinese characters), the client command line interface can behave incorrectly when a character from any line except the first is backspaced over. In this case, the first line from the bottom can be multiplied 3 times. Backspace works correctly during deletion of any character from the first line.

Common AIX known problems and limitations for version 6.2 (applies to all modifications of version 6.2)
  • On AIX 6.1, if the EFS user keystore password is different from the user login password, the EFS keystore is not automatically opened when the user logs in. In such a situation, the TSM client might fail to restore a non-EFS file into an EFS file system. If this happens, the user can either launch the TSM client with the efskeymgr -o command or synchronize the keystore password with the user login password with the efskeymgr -n command. For example:

    efskeymgr -o ./dsmj
    efskeymgr -n
  • When the NFS server corresponding to an NFS file system mounted on AIX is not reachable due to a network error or some other problem, the following error message is displayed on the console while performing TSM client operations:

    NFS getattr failed for server
    nfs_sever_name: error 3 (RPC: 1832-006 Unable to send)

    In order to prevent this error message from being displayed by the AIX operating system, unmount the NFS file system having the problem and retry the TSM client operation.

  • If you use the memoryefficient=diskcachemethod option for full incremental backup, you might need large amounts of disk space. Ensure that large file support is enabled on the file system that is being used for the disk cache file.
  • AIX 6.1 Encrypted File System (EFS) restore to an alternate destination might hang if the destination EFS file system runs out of disk space. To prevent this problem, apply the following AIX 6.1 APAR:
    • 610 (6.1.0): IZ42302
    • 61B (6.1.1): IZ42301
    • 61D (6.1.2): IZ42300
  • Incremental by date backups on AIX 6.1 might back up files that have been previously backed up and are unchanged. Upgrade to the latest service pack for your AIX technology level as this problem has been resolved by AIX APAR IZ22211.
  • Resolving errors during AIX JFS2 snapshot based backup/archive and image backup:

    The TSM client supports snapshot based backup and archive operations to provide a consistent backup of files and online image backup by exploiting the integrated snapshot capability provided by JFS2 on AIX 5.3 or later.

    The TSM client deletes the AIX JFS2 snapshot created during the backup process during TSM termination. However, there are situations in which AIX may fail the snapshot delete request made by TSM.

    The following are some cases when a snapshot delete request might fail:

      1. The user types Ctrl-C during a TSM snapshot backup process. In this case the JFS2 snapshot unmount request may fail with the "Device Busy" error because the TSM process was in the middle of accessing the snapshot.
      2. The user invokes two TSM snapshot backup requests concurrently for the same file system.

      For example: dsmc backup image /fs1 is issued from one console and dsmc backup image /fs1 is issued from a second console concurrently. In this case, if TSM process 1 from console 1 created the first snapshot for /fs1 and TSM process 2 from console 2 created the second snapshot for /fs1, then if process 2 happens to finish first and tries to delete the snapshot, AIX will fail the delete request.
      3. The User invokes two TSM snapshot backup requests concurrently for two virtual mount points whose source file system is the same.

      For example: dsmc incr /fs1/level1/dir1 from one console and dsmc incr /fs1/level2/level3/dir3 from a second console concurrently.


    The reason for this is that AIX expects the snapshot delete requests to be issued in a particular order with the oldest snapshot deletion being requested first, the next oldest snapshot deletion being requested next, and so on. If TSM is not able to follow this sequence due to concurrent processes creating snapshots for the same file system, AIX will fail the delete requests. In the above situations, TSM will log a warning message asking the user to delete the snapshots manually. In some cases, TSM might even fail the backup. If this happens, the user will have to delete the snapshots manually and retry the operation.

    To avoid these scenarios, do not start concurrent TSM snapshot operations on the same file system that may lead to snapshot deletion failures.

    You can use the following steps to perform a manual snapshot deletion:

      1. snapshot -q -c' ' srcFS
      2. df -k
      3. umount -f /tsmxxxxxxxxxx
      4. rmdir /tsmxxxxxxxxxx
      5. snapshot -d /dev/tsmxxxxxxxxxx
      6. If snapshot delete fails with Device Busy or some other error message, unmount the source file system: umount -f srcFS and retry snapshot delete.
      7. ls -l /dev/tsmxxxxxxxxxx
      8. If any /dev/tsmxxxxxxxxxx LVs remains: rmlv -f /tsmxxxxxxxxxx
      9. If you have unmounted source file system, mount it: mount srcFS

    If there are any snapshots that failed to be deleted during a previous TSM execution, TSM attempts to delete them during its next invocation. The reason for this is while older snapshots remain, AIX will fail deletion requests for newer snapshots for a given file system.

    There are some cases where TSM will not attempt to delete older snapshots:

      1. If the snapshot was not created by TSM. TSM names its snapshots with the prefix tsm in order to distinguish them from other snapshots created for the same file system. In this case, TSM will display an error message prompting the user to delete the older snapshot and retry the operation.
      2. If the snapshot is created by TSM but is still mounted. In this case, the snapshot is in active use by some other TSM process and cannot be deleted.
      3. If the snapshot is created by TSM, is not mounted but is newly created. In this case, the snapshot may have been just created by some other TSM process and cannot be deleted.

    In all such cases, the user might have to perform a manual deletion since leaving unused older snapshots around will cause subsequent TSM backups to fail to delete snapshots.

    NOTE: AIX has some defect fixes related to JFS2 snapshots in AIX 5.3.7 (AIX 5.3 ML7) or later and AIX 6.1 or later. If these fixes are not applied, it may cause either an AIX system crash or TSM to hang during snapshot deletion and snapshot query processes. It may also cause data corruption during used block image backup. Thus, TSM will not perform snapshot monitoring, the snapshot deletion feature described above, and used block image backup unless AIX is at the levels mentioned above. In order to exploit these features, ensure that your OS level is at AIX 5.3.7 (AIX 5.3 ML7) or later and AIX 6.1 or later.

  • Used Block Image backup:

    The TSM client will perform used block image backup for both snapshot and static image backups by default, unless:

      1. The AIX OS level is lower than 5.3.7.
      2. The option imagegapsize is set to zero.
      3. The file system is not AIX JFS2.
  • Symbolic link as a virtual mount point:

    Do not define symbolic links as virtual mount points, when performing snapshot based file backup or archive operations. In scenarios similar to the following, make sure that you set snapshotproviderfs=NONE or remove the snapshotproviderfs option.

    Example:

    • /fs1 is a file system with a directory name dir1 that has one or more files and subdirectories.
    • Create a symbolic link to /fs1/dir1 under a second file system /fs2 as follows: ln -s /fs1/dir1 /fs2/dir2
    • In the dsm.opt file, set: followsymbolic yes
    • In the dsm.sys file, set:
      • snapshotproviderfs NONE
      • virtualmountpoint /fs2/dir2
    • Issue this command: dsmc incr /fs2/dir2
  • Performing snapshot backup of multiple virtual mount points for a given file system:

    If you are performing a snapshot backup of two or more virtual mount points for the same file system with a single command, such as:

    • dsmc incr /fs1/level1/dir1 /fs1/level1/level2/dir2 /fs1/level1/level2/level3/dir3

    The TSM client will take a single snapshot of file system /fs1 to back up all three virtual mount points.

    In this case, make sure that you specify a single presnapshotcmd and a single postsnapshotcmd for the entire command as shown below:

    • dsmc incr /fs1/level1/dir1 /fs1/level1/level2/dir2 /fs1/level1/level2/level3/dir3 -presnapshotcmd=pre-script -postsnapshotcmd=post-script
  • Using ssh localhost dsmc command:

    When running ssh localhost dsmc command, the TSM client uses the server stanza defined in the dsm.opt file in the default installation directory, /usr/tivoli/tsm/client/ba/bin for the 32-bit client or /usr/tivoli/tsm/client/ba/bin64 for the 64-bit client, ignoring the environment variable DSM_CONFIG, if it is set. Ensure that the dsm.opt file in the default installation directory has the correct server stanza when you invoke dsmc with ssh.

  • Restoring a file as a non-root TSM authorized user:

    After restoring a file as a non-root TSM authorized user, the restored file is not owned by the TSM authorized user who restored the file, if the restore overwrites the original file.

    • Set up a non-root TSM authorized user, such as tsmuser.
    • Create a directory structure such as: /fs1/testdir with file file1.
    • Set the permissions on the directory testdir as 755 and owned by root, the permissions on the file file1 as 777 and owned by a different user than the TSM authorized user, say testusr.
    • Backup the testdir directory as the TSM authorized user: dsmc sel "/fs1/testdir/*" -su=y
    • Modify the contents of the original file file1
    • As the TSM authorized user, without removing the original file, restore the testdir directory to original location: dsmc rest "/svt1/testdir/*" -su=y -repl=y

    The restored file should now be owned by the authorized user tsmuser. However, the restored file file1 is still owned by the original owner testusr.

    In order to avoid this problem, restore the file either as root or as the original owner of the file.

  • VxFS Sparse File Restore

    When a sparse file is restored in the Veritas file system it can occupy more disk space than it did originally at the time of backup. This is a limitation caused by the inner workings of the space allocation algorithm used by the file system.

  • Because of the limited functionality of the dtterm application, not all function keys of the command line clients operate as expected. The Control-Left and Control-Right key combinations and the Home and End keys do not work. In the Aixterm environment the keys operate as specified.
  • Use NDMP directory level backup with valid filespace mapping.
  • If the COMMMethod or LANFREECommmethod options are set to SHAREdmem, the AIX environment variable EXTSHM needs to be turned on to enable extended shared memory. In order to turn on EXTSHM setting, do one of the following:
    • To make this a permanent change, add the following line to the /etc/environment file:
      EXTSHM=ON
    • To make the change in the immediate shell, enter:
      EXTSHM=ON
      export EXTSHM

      Note: This change is effective until you log out of this shell.
  • If the cluster service is HACMP 5.3, a return code of -2 or -4 can mean the cluster service is not enabled, the Cluster Information Daemon is not started, or the cluster service has not finished initializing. User action is needed to ensure that the cluster software (clinfo) is running and fully initialized.
  • Connecting to server SSL port by mistake

    If a client connects to an SSL port on the server but the client does not have the SSL option enabled, the client would seem to hang until the session times out on the server.

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

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


Back to Contents

AIX known problems and limitations
  • Problem with NFSV4 ACL

    In the case of NFSV4 ACL, a change to the standard UNIX permissions will also change the ACLs. Since TSM stores ACLs along with the file data, a change to UNIX permissions will cause a corresponding change to NFSV4 ACLs resulting in the backup of the entire file. You can set the skipaclupdatecheck option to yes to avoid this problem. The skipaclupdatecheck option disables checksum and size comparisons of ACL data. When set to yes (default is no), the Tivoli Storage Manager client will not perform checksum and size comparisons before or after backup and during incremental processing (ACL checksum from previous backup and current ACL) to detect ACL updates. However, current ACL data will be backed up if the file is selected for backup due to other reasons. If only ACLs are updated on a file, the next incremental backup will not recognize this ACL update, and the file will not be backed up.

  • Journaled limitation

    On AIX, it is possible to create path names greater than the defined limit (1023). The journal will not detect any changes when the path name is greater than the limit, and, therefore, no error message will not be generated.


Back to Contents

AIX GPFS known problems and limitations
  • When using the TSM Hierarchical Storage Management (HSM) Client:
    • An "umount" of a managed GPFS file system does not trigger failover.
    • Stub files that are restored using the TSM backup-archive client are restored to resident state if the option RESTOREMIGSTATE = NO is set.
    • If GPFS is restarted on the node where a file is being recalled with the dsmrecall command, the DMAPI session named 'dsmrecall' might still exist after the GPFS restart. The extra DMAPI sessions do not affect HSM operations unless the DMAPI session limit (4000) is exceeded. If this happens, all further HSM operations will not be possible until GPFS is restarted on the quorum node.
  • GPFS ACL support has been modified to back up ACL data if a file's change time (ctime) has changed since the last backup. This is done so that TSM can accurately detect changes in ACLs and other GPFS extended attributes. A file's ctime will change whenever owner, mode, or ACLs change. When any of these changes occur TSM will back up the entire file even if the file's data has not changed. This is because ACL data is stored along with the file data on the server.
  • Due to further changes in GPFS 3.2, the size returned for extended file attributes can be non-zero, regardless of the presence of extended ACLs. Such files are processed as if they have ACLs.

Back to Contents

AIX JFS2 known problems and limitations
  • When using the TSM Hierarchical Storage Management Client:
    • If you use the RESTOREMIGSTATE = NO option, stub files that are restored using the Tivoli Storage Manager Backup-Archive Client are restored to resident state.
Back to Contents

HP known problems and limitations
  • VxFS sparse file restore
    When a sparse file is restored in the Veritas file system, it can occupy more disk space than it did originally at the time of backup. This is a limitation caused by the inner workings of the space allocation algorithm used by the file system.
  • Raw logical volume backup does not support devices other than logical volumes, such as /dev/dsk/c0t0d1. Logical volume devices usually take the form /dev/vgXY/lvolAB.
  • Because of the limited functionality of the dtterm application, not all function keys of the command line Clients operate as expected. The Control-Left and Control-Right key combinations and the Home and End keys do not work.
  • The default limit of the data segment size of a process in HP-UX (11.23) is 64 MB. When backing up large file systems, the TSM Client might exceed this limit and thus run out of memory. To increase this limit, the kernel needs to be modified in the following way:
      1. As root user, start "sam".
      2. Select "Kernel Configuration"
      3. Select "Configurable Parameters"
      4. Locate "maxdsize" and increase its value using the menu entry "Actions/Modify Configurable Parameter". For example, set it to 268435456 for a 256 MB max size of the data segment.
      5. The kernel gets rebuilt by sam after this change and the system needs to be rebooted for the new setting to take effect.
  • For image backup, file systems are umounted and re-mounted read-only in order to prohibit access during the backup. However, you might still be able to change the size of the file system by using a volume manager. Such operations must be avoided during image backup.
  • The tape prompt option is not supported for the Web GUI.
  • The Veritas file system (VxFS) versions 3.5, 4.1 and 5.0, HP and Veritas volume managers are supported. Image backup support is restricted to logical volumes managed by the HP-UX or HP Itanium volume manager only (see the table below).
    Image backup support
    HP-UX version / volume manager
    VxFS 4.1
    VxFS 5.0
    11i v2 / HP VM
    supported
    supported
    11i v2 / VxVM
    unsupported
    unsupported
    11i v3 / HP VM
    supported
    unsupported
    11i v3 / VxVM
    unsupported
    unsupported

  • When doing image backup directly to tape, the RESOURCEUTILIZATION option value cannot exceed the value of the MAXNUMMP on the server for that node. If it does,the backup can fail with an Unknown System Error message.
  • After installing the "Required Patch Bundle for HP-UX 11i v2, September 2004", dsmc can hang if the TCPWINDOWSIZE is set to values that are multiples of 64. To solve the problem, qupgrade to HP-UX patch level July 2005 or newer.
  • During image backup and restore over LANFree, pressing Ctrl-C can lead to a core dump of the client. Such operations must be avoided during image backup or restore.
  • To display the Java GUI in Traditional Chinese or Simplified Chinese, you must install additional patches for the fonts:

    HP-UX 11i
         PHSS_26975 - s700_800 11.11 Chinese-S TrueType fonts patch
         PHSS_26977 - s700_800 11.11 Chinese-T TrueType fonts patch

Back to Contents



Common Linux known problems and limitations
  • Set the option SKIPACL to "yes" when reading block has to be aligned on sector size, and the Tivoli Storage Manger server is earlier than version 6.1.
  • When restoring to NFS-mounted file systems, remount them using the mount option "noac" to prevent NFS-related errors that are not detectable by the client.
    Note: The performance can be raised for NFS by using larger values for the options rsize and wsize (for example 8192).
  • Backupset restore from tape is not supported in this release of the Linux client.
  • Double-byte languages can be displayed incorrectly on browsers on Linux machines due to browser or JRE issues. If you experience font problems on Linux with DBCS, you can try using a browser on a different machine. Upgrading the Linux machine to the latest kernel and JRE level might also clear the problem.
  • The Java GUI supports Japanese, Korean, Simplified and Traditional Chinese. However, Java supports these encodings only on some Linux platforms. For more information, see http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html#jfc-table for JRE 1.5 and http://java.sun.com/javase/6/webnotes/install/locales.html#jfc-table for JRE 1.6. If you would like to display the Java GUI on Linux for other languages, you can modify the font configuration as described in this document at http://java.sun.com/j2se/1.5.0/docs/guide/intl/fontconfig.html for JRE 1.5 and at http://java.sun.com/javase/6/docs/technotes/guides/intl/fontconfig.html for JRE 1.6.
  • If you get warnings about missing "standard symbols l" fonts when starting the Java GUI with dsmj, try replacing the "standard symbols l" string with the word "symbol" in the Java font.properties file. The font name "standard symbols l" might be different, because not all Linux distributions use the same name for this font.
  • Path names longer than 1024 bytes
    Although Linux system supports files and directories with path plus file name length up to 4096 bytes, the TSM Client currently limits the lengths of the file name and path name. The maximum file name length is limited to 256 bytes and the maximum path name length to 1023 bytes. An error message is displayed on the console when these lengths exceed their limits. This will be fixed in a future release.
  • Image restore to another location for XFS file system
    When restoring an image with XFS file system to another location, you might see the message "ANS1066E Restore successful. File system mount failed" appear on the screen. The mount of XFS file system is not possible because by default XFS does not allow the mount of several XFS file systems with the same FS UUID simultaneously. Use the XFS mount option "nouuid" to mount XFS file systems with the same UUID or manually change FS UUID using xfs_admin utility.
  • File system and ACL support
    For Ext2/Ext3/XFS/JFS ACL support on Linux, the Tivoli Storage Manager client uses the libacl.so library, so it is searched for in the following locations:
    • A colon-separated list of directories in the user's LD_LIBRARY_PATH environment variable.
    • The list of libraries cached in /etc/ld.so.cache. /usr/lib, followed by /lib.
    Ensure there is a valid library or symbolic link present in each of the specified locations.
  • If the host name shown with the hostname command is not specified in the /etc/hosts file, there will be no GUID support available. If you want to have GUID support, you must add the host name into the /etc/hosts file.
  • In the Java GUI the preview of the Include-Exclude List might hang. This can be avoided by setting the following before starting the GUI:
    export MALLOC_CHECK_=0

Back to Contents

Linux86 known problems and limitations

Linux86 known problems and limitations for version 6.2.5 (applies to all modifications of version 6.2.5)
  • If GPFS software is uninstalled while the Tivoli Storage Manager client is still installed, the Tivoli Storage Manager client will fail to start because of missing links to GPFS libraries. In this case, you can either reinstall the Tivoli Storage Manager client or recreate the missing links manually. To recreate the links manually, issue the following commands:
    ln -s /opt/tivoli/tsm/client/api/bin/libgpfs.so/ usr/lib/libgpfs.so
    ln -s /opt/tivoli/tsm/client/api/bin/libdmapi.so /usr/lib/libdmapi.so


Linux86 known problems and limitations for version 6.2.2 (applies to all modifications of version 6.2.2)
  • If GPFS software is uninstalled while TSM client is still installed, TSM client will fail to load because of missing links to GPFS libraries. In this case you can either reinstall TSM client or recreate the missing links manually. To recreate the links manually, issue the following commands:
    ln -s /opt/tivoli/tsm/client/api/bin/libgpfs.so /usr/lib/libgpfs.so
    ln -s /opt/tivoli/tsm/client/api/bin/libdmapi.so /usr/lib/libdmapi.so
  • During snapshot difference incremental backup of N-Series or NetApp volumes, if files are skipped due to any reason, such as Tivoli Storage Manager server media mount being unavailable, these files might not be backed up during subsequent backups either, unless the files have been modified. Such files will be logged to the TSM error log. You can back them up manually or perform a snapshot difference backup with the option "createnewbase" set to "yes".
  • When installing the Tivoli Storage Manager backup-archive client and API on a 64-bit RHEL 6 system, you might run into errors like the following:
    error: Failed dependencies:
        libstdc++.so.6 is needed by TIVsm-API

    In Red Hat Enterprise Linux 5, if a package was available for both the main and the compatibility architectures, both architectures of the package were installed by default. In Red Hat Enterprise Linux 6, only the package for the primary architecture is installed by default.

    To avoid problems during the backup-archive client and API installation on a 64-bit machine, be sure to install libstdc++ and compat-libstdc++ packages for 32-bit as well.

  • If you perform snapshot difference incremental backups of N-Series or NetApp volumes, make sure that the volumes are defined with a security style of UNIX. Backups will complete successfully even if the security style is NTFS or MIXED. However, it is recommended that you use a security style of UNIX.

Linux86 known problems and limitations for version 6.2 (applies to all modifications of version 6.2)
  • When using the Tivoli Storage Manager Hierarchical Storage Management (HSM) Client:
    • If GPFS is restarted on the node where a file is being recalled with the dsmrecall command, the DMAPI session named 'dsmrecall' might still exist after the GPFS restart. The extra DMAPI sessions do not affect HSM operations unless the DMAPI session limit (4000) is exceeded. If this happens, all further HSM operations will not be possible until GPFS is restarted on the quorum node.
  • The Java GUI on a SLES10 System is not able to display Japanese font types, because there is a defect in the Java VM. For more information, see this Web page: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5029424
  • If you want to start the TSM scheduler using the inittab, ensure that the required language environment is set. You can do this by starting a script that is first sets the environment and then starts the scheduler. See also the section that handles SBCS in this file.
  • Image backup on raw devices

    Only certified image backup from raw devices, where their corresponding partitions are marked with ID x83, are shown in the partition table. To see the IDs of all partitions of the partition table, use the command "fdisk -l" and look for the column marked with "Id".

  • If you see distorted characters when running the TSM Command Line Client (dsmc) under the ru_RU locale, issue the following command:

    xterm -font -*-*-*-*-*-*-*-*-*-*-*-*-iso8859-5 &

    A new xterm window will appear and the correct ru_RU font will be used. Export LANG and LC_ALL to ru_RU as usual.

  • Displaying DBCS on Web/Java GUI

    Certain JREs on Linux (x86, PPC) platforms do not include the font.properties file for Korean, Traditional Chinese, and/or Simplified Chinese. You can create one by copying the English font.properties and modifying the SansSerif font definitions like so:

  • For Korean, create a file named font.properties.ko:

# SansSerif font definition
#
sansserif.0=\
-b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.1=-ms-Gulim-medium-r-normal--*-%d-*-*-c-*-ksc5601.1987-0

sansserif.italic.0=\
-b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.italic.1=\
-ms-Gulim-medium-r-normal--*-%d-*-*-c-*-ksc5601.1987-0

sansserif.bold.0=\
-b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.bold.1=\
-ms-Gulim-medium-r-normal--*-%d-*-*-c-*-ksc5601.1987-0

sansserif.bolditalic.0=\
-b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.bolditalic.1=\
-ms-Gulim-medium-r-normal--*-%d-*-*-c-*-ksc5601.1987-0

  • For Simplified Chinese, create a file named font.properties.zh_CN:

# SansSerif font definition
#
sansserif.0=\
-b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.1=\
-default-ming-medium-r-normal--16-160-72-72-c-160-gb2312.1980-0

sansserif.italic.0=\
-b&h-lucidasans-medium-i-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.italic.1=\
-default-ming-medium-r-normal--16-160-72-72-c-160-gb2312.1980-0

sansserif.bold.0=\
-b&h-lucidasans-bold-r-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.bold.1=\
-default-ming-medium-r-normal--16-160-72-72-c-160-gb2312.1980-0

sansserif.bolditalic.0=\
-b&h-lucidasans-bold-i-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.bolditalic.1=\
-default-ming-medium-r-normal--16-160-72-72-c-160-gb2312.1980-0

  • For Traditional Chinese, create a file named font.properties.zh_TW:

# SansSerif font definition
#
sansserif.0=-b&h-lucidaans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.1=-default-ming-medium-r-normal--16-*-*-*-c-160-big5-0

sansserif.italic.0=\
-b&h-lucidasans-medium-i-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.italic.1=\
-default-ming-medium-r-normal--16-*-*-*-c-160-big5-0

sansserif.bold.0=\
-b&h-lucidasans-bold-r-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.bold.1=\
-default-ming-medium-r-normal--16-*-*-*-c-160-big5-0

sansserif.bolditalic.0=\
-b&h-lucidasans-bold-i-normal-sans-*-%d-*-*-p-*-iso8859-1
sansserif.bolditalic.1=\
-default-ming-medium-r-normal--16-*-*-*-c-160-big5-0

  • When using option 'COMMMETHOD Sharedmem', you might get the error message 'ANR8294W Shared Memory Session unable to initialize' on the server or storage agent console. By default, Linux is not set up with sufficient system resources to create the message queues. You must increase the kernel parameter MSGMNI to 128 (default is 16). You can modify this parameter by performing the following command:

    echo 128 > /proc/sys/kernel/msgmni

    To enable this parameter to remain persistent after rebooting the system, you can instead add the following line to the file /etc/sysctl.conf, then reboot the machine:

    kernel.msgmni=128


To view current ipc settings, run this command:

 ipcs -l

    and look at the "max queues system wide" value. The default is 16.
  • GPFS only: GPFS ACL support has been modified to back up ACL data if a file's change time (ctime) has changed since the last backup. This is done so that TSM can accurately detect changes in ACLs and other GPFS extended attributes. A file's ctime will change whenever the owner, mode, or ACLs change. When any of these changes occur, TSM will back up the entire file even if the file's data has not changed. This is because ACL data is stored along with the file data on the server.
  • A fix for the GPFS defect 497282 should be applied to the GPFS on Linux86 to recognize and successfully back up updated ACLs to the server.
  • Due to further changes in GPFS 3.2, the size returned for extended file attributes can be non-zero, regardless of the presence of extended ACLs. Such files are processed as if they have ACLs.
  • Running the TSM client GUI by issuing the 'dsmj' command on RedHat 5.0 on x86_64 (AMD64 or Xeon) platform might result in the following error message:

    -jar option not found

    This problem is caused by the fact that the default RedHat 5.0 installation on x86_64 does not have JRE (Java Runtime Environment) installed. Install the valid Java Runtime environment that supports the jar parameter.

  • Java GUI Preference Editor Authorization panel error:

    In the Java GUI authorization panel, when the "All groups and users can request TSM services" check box is checked, the change is not recorded. This is a known problem.


Back to Contents

LinuxPPC known problems and limitations
  • If you want to start the TSM scheduler using the inittab, ensure that the required language environment is set. You can do this by starting a script first sets the environment and then starts the scheduler.
  • Displaying DBCS on Web/Java GUI

    Certain JREs on Linux (x86, PPC) platforms do not include the font.properties file for Korean, Traditional Chinese, and/or Simplified Chinese. You can create one by copying the English font.properties and modifying the SansSerif font definitions like so:


For Korean, create a file named font.properties.ko:

  # SansSerif font definition
  #
  sansserif.0=-b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.1=-ms-Gulim-medium-r-normal--*-%d-*-*-c-*-ksc5601.1987-0

  sansserif.italic.0=\
            -b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.italic.1=\
            -ms-Gulim-medium-r-normal--*-%d-*-*-c-*-ksc5601.1987-0

  sansserif.bold.0=\
            -b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.bold.1=-ms-Gulim-medium-r-normal--*-%d-*-*-c-*-ksc5601.1987-0

  sansserif.bolditalic.0=\
            -b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.bolditalic.1=\
            -ms-Gulim-medium-r-normal--*-%d-*-*-c-*-ksc5601.1987-0
   

For Simplified Chinese, create a file named font.properties.zh_CN:

  # SansSerif font definition
  #
  sansserif.0=-b&h-lucidasans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.1=\
        -default-ming-medium-r-normal--16-160-72-72-c-160-gb2312.1980-0

  sansserif.italic.0=\
        -b&h-lucidasans-medium-i-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.italic.1=\
        -default-ming-medium-r-normal--16-160-72-72-c-160-gb2312.1980-0

  sansserif.bold.0=\
        -b&h-lucidasans-bold-r-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.bold.1=\
        -default-ming-medium-r-normal--16-160-72-72-c-160-gb2312.1980-0

  sansserif.bolditalic.0=\
        -b&h-lucidasans-bold-i-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.bolditalic.1=\
        -default-ming-medium-r-normal--16-160-72-72-c-160-gb2312.1980-0
 

For Traditional Chinese, create a file named font.properties.zh_TW:

  # SansSerif font definition
  #
  sansserif.0=-b&h-lucidaans-medium-r-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.1=-default-ming-medium-r-normal--16-*-*-*-c-160-big5-0

  sansserif.italic.0=\
           -b&h-lucidasans-medium-i-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.italic.1=\
           -default-ming-medium-r-normal--16-*-*-*-c-160-big5-0

  sansserif.bold.0=\
           -b&h-lucidasans-bold-r-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.bold.1=\
           -default-ming-medium-r-normal--16-*-*-*-c-160-big5-0

  sansserif.bolditalic.0=\
           -b&h-lucidasans-bold-i-normal-sans-*-%d-*-*-p-*-iso8859-1
  sansserif.bolditalic.1=\
           -default-ming-medium-r-normal--16-*-*-*-c-160-big5-0
 

  • When using option 'COMMMETHOD Sharedmem', you might get error message 'ANR8294W Shared Memory Session unable to initialize' on the server or storage agent console. By default, Linux is not set up with sufficient system resources to create the message queues. You must increase the kernel parameter MSGMNI to 128 (default is 16). You can modify this parameter by performing the following command:

    echo 128 > /proc/sys/kernel/msgmni
     

    To enable this parameter to remain persistent after rebooting the system, you can instead add the following line to the file /etc/sysctl.conf, then reboot the machine:

    kernel.msgmni=128
     

    To view current ipc settings run this command:

    ipcs -l
     

    and look at "max queues system wide" value. The default is 16.


Back to Contents

LinuxZ known problems and limitations
  • The Java GUI supports Japanese, Korean, Simplified and Traditional Chinese, but only Japanese and Simplified Chinese can be displayed correctly on Linux using JRE v1.5.0. This is because Java officially only fully supports Japanese and Simplified Chinese Writing Systems (see http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html#jfc-table for more information). If you would like to display the Java GUI on Linux for other languages, you might be able to do so by modifying the font.properties file on your own as described in this Web page: http://java.sun.com/j2se/1.5.0/docs/guide/intl/fontconfig.html
  • If SELinux is installed on the system but is disabled, installation of the GSKit crypto component (gskcrypt31-8.0.13.3.linux.s390.rpm) can produce multiple messages as follows:

    libsepol.context_from_record: MLS is enabled, but no MLS context found
    libsepol.context_from_record: could not create context structure
    libsemanage.validate_handler: invalid context system_u:object_r:textrel_shlib_t specified for /usr/local/ibm/gsk 8/lib/C/icc/osslib/libcrypto.so.0.9.7 [all files]
    libsemanage.dbase_llist_iterate: could not iterate over records

    This is related to a problem that has been identified and resolved by Redhat. The problem is fixed in policycoreutils-1.33.12-14.4.el5. See this report for more information.

    These installation errors do not affect TSM functionality and can be ignored. To work around the problem, you can bypass the SELinux check by setting the following environment variable before installation:

    export GSK_DISABLE_SELINUX_TEST=1

    When you set this environment variable, the installation should complete successfully without displaying any error messages.

    The problem does not occur if SELINUX=enforcing is set.


Back to Contents

Mac OS X warnings
  • Case Sensitive HFS+ support

    Mac OS X supports an optional Case Sensitive HFS+ file system. Before backing up any files in that file system ensure the new Case Sensitive HFS+ volume does not have the same name as any 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.


Back to Contents

Mac OS known problems and limitations
  • Symbolic link owner not correct after restore
    During restore of symbolic links the owner is not set. The default owner is used instead. The owner can be set by using the 'chown' command with the '-h' option
  • Objects on a Xsan 2.0 file system have their modification, change, and attribute times stored in a high resolution format--to the nanosecond. Tivoli Storage Manager will not back up or restore these fractions of a second of times. The fractional time will not be used to determine if a file should be backed up and it will always be set to zero during restore.
  • TSM treats symbolic links as files. When an input path to the command line contains a symbolic link, TSM is unable to process the path. This only occurs when the path entered on the command line. This is due to limitations in Mac OS X.
  • Include and exclude statements, added with the Preference Editor, that have Unicode characters in the path might not be written to the dsm.sys file correctly. The names will be written with question marks for the characters that could not be properly translated. The include or exclude statement will work because a question mark is a wildcard character. However, the include or exclude statement may match more files than intended.

    Unicode include or exclude statements can be added to a Unicode INCLEXCL file to work around this limitation.

  • Due to limitations in Mac OS X, files with certain characters will not be managed by TSM correctly. Some examples are:

    0131 LATIN SMALL LETTER DOTLESS I
    01C8 LATIN CAPITAL LETTER L WITH SMALL LETTER J
    1FB2 GREEK SMALL LETTER ALPHA WITH VARIA AND YPOGEGRAMMENI
    03D0 GREEK BETA SYMBOL
    03D1 GREEK THETA SYMBOL

    There are several more. The problem is that these characters can be represented in uppercase, but cannot be represented in lowercase correctly.

    The recommendation is to either rename these files or use a case-sensitive file system.

  • Due to limitations in Mac OS X, Tivoli Storage Manager will crash if it encounters any of the following Unicode symbols as part of a name:

    D800 - <Non Private Use High Surrogate, First>
    D87F - <Non Private Use High Surrogate, Last>
    DB80 - <Private Use High Surrogate, First>
    DBFF - <Private Use High Surrogate, Last>
    DC00 - <Low Surrogate, First>

Note: These are special Unicode flag symbols. They are not normally used in file names.

Back to Contents



Solaris known problems and limitations
  • The following devices are supported on the Solaris client:
    • Normal disk slices (SPARC and x86)
    • Metadevices created with Solaris Volume Manager on Solaris 10 (SPARC and x86)
    • Metadevices created with Veritas Volume Manager v4.x (SPARC)

    Other devices are not supported.
  • The overlap device of the root disk (c0t0d0s2) is not supported from raw device backup. Avoid using this feature on disks or slices that are used as swapping device.
  • Meta devices created by the Veritas Volume Manager must be listed including its disk group in the /etc/vfstab to be recognized by the TSM backup-archive client for an image backup of file systems. Raw devices should not be listed in the /etc/vfstab.

    For example:

    /dev/vx/dsk/<disk group>/<meta device name>

    is the correct meta device name to be used in the /etc/vfstab file. Specifying /dev/vx/dsk/would not be recognized correctly (ANS1134E).

  • For image backup, the file systems are unmounted and re-mounted read-only if you use COPYSERIALIZATION=STATIC in order to prohibit access during the backup. However, you might still be able to change the size of the file system by using a volume manager for all values of copy serialization. Such operations must be avoided during image backup.
  • Image backup of large volumes

    The current client version can only back up volumes created on disks with the VTOC label. Volumes larger than 1TB require EFI disk label which is currently not supported by the TSM client. As a result image backup is not possible for volumes larger than 1 TB.

  • Disk slices containing cylinder 0 should not be backed up or restored. If this happens, the VTOC will be overwritten. If you need to back up the first disk slice, exclude cylinder 0 by starting the disk slice from cylinder 1 (using the format utility). During a restore, the backup-archive client does not check whether cylinder 0 is contained in the device that is overwritten.
  • When doing image backup directly to tape, the RESOURCEUTILIZATION option value cannot exceed the value of the MAXNUMMP on the server for that node. If it does,the backup can fail with an Unknown System Error message.
  • Using the backupset and portable media functionality requires tapes that are fully compliant with the Sun generic device driver standards. Note that several non-Sun tapes are not fully compatible with all required I/O operations, although simple tape commands such as tar work without problems.
  • Sparse file handling

    Sparse files (files whose block size and the number of physical disk blocks allocated to store file data are not equal) are handled as sparse files on the Tivoli Storage Manager Server. If a block of a file consists only of bytes with value zero, this block is not restored as a physical disk block. For sparse files with large holes in the address space this will lead to an increase of performance. If files have been backed up as sparse files and need to be restored as normal files (non-sparse files), this should be done by the internal option MAKESPARSEFILE NO in dsm.opt or makesparsefile=no which is supported by the command line Client only. The option is only necessary for files where the existence of physical disk blocks is required. This is the case in some rare situations for system files like ufsboot which is needed during boot time. The boot file loader of the operating system accesses physical disk blocks directly and does not support sparse files.

  • VxFS sparse file restore

    When a sparse file is restored in the Veritas file system, it can occupy more disk space than it did originally at the time of backup. This is a limitation caused by the inner workings of the space allocation algorithm used by the file system.

  • Because of limitations of the standard system settings, the TSM Client does not use large communication buffers by default. This can be changed by specifying "LARGECOMMBUFFERS YES" in the Client system options file (dsm.sys). Read the following section for information about how to set up your system to let ordinary users run TSM with large communication buffers.

    If you specify "LARGECOMMBUFFERS YES" in the dsm.sys file to enable large communication buffers, non-root users may get the following error message when starting an TSM Client or API application:

    "ANS1030E System ran out of memory. Process ended."

    To fix this problem, do the following steps:

      1. Switch to root by issuing "su".
      2. Append the following statement to the file /etc/system:

        set shmsys:shminfo_shmmax=2097152

      If your /etc/system file already contains such a statement, ensure that its value is at least 1500000.
      3. Reboot the system by issuing "reboot"
  • Because of the limited functionality of the dtterm application, not all function keys of the command line Clients operate as expected. The Control-Left and Control-Right key combinations and the Home and End keys do not work.
  • During image backup and restore over LANFree, pressing the Ctrl-C keys can lead to a core dump. You must avoid such operations during image backup or restore.
  • Limitations of the TSM Solaris backup-archive client functionality regarding QFS:
    • The package LSCqfs 3.5.0 is the standalone version of QFS. Only this version of QFS is supported.
    • Image backup of QFS file systems is not supported.
    • A QFS file system contains two hidden system files and a system directory that cannot be backed up. A backup of these files is not needed. They contain internal data to manage the file system. This data will be automatically excluded from a backup and recreated automatically by the file system itself if a restore of files is invoked.
    • The TSM Solaris backup-archive client does not support the combination of QFS and SAM to archive files onto a tertiary background storage such as tapes. Files are recalled from tape onto disk automatically if migrated files are found during the backup.
  • When the TSM Remote Agent runs on Solaris, you might encounter communication failure from the browser while monitoring the backup or restore of multiple NAS volumes, even though the backup or restore operations complete normally. To avoid such monitoring problems, wait until one backup or restore operation is finished before starting another, or use the TSM Server Scheduler to back up or restore multiple NAS volumes.
  • Use NDMP directory level backup with valid filespace mapping.
  • Limitations of the TSM Solaris backup-archive client functionality regarding Solaris Zones:
    • It is not necessary to install the TSM backup-archive client manually on each Local Zone, because it is automatically installed when the TSM client is installed in the Global Zone, or when the Local Zones are created or installed after TSM has been installed. This is valid if the TSM packages are installed without using the -G option of the pkgadd command.
    • On sparse root Local Zones the /usr file system is usually mounted as LOFS read-only. In this case the TSM installation procedure would not be able to create the required links for TSM libraries and TSM option files in the /usr file system. If TSM is already installed in the Global Zone these links are already present and no further actions are required, otherwise a Warning message is produced asking to create the required links manually from the administrator of the Global Zone. The commands required to creates these links are printed out after the Warning message as well.
    • When performing a backup with the domain option set to "all-lofs" in a Solaris 10 Global Zone, all explicit loopback file systems (LOFS) are backed up including all loopback file systems (LOFS) of each non-global zones.
    • When performing an incremental backup of the local zones from the global zone, the administrator must take special care about which files from the zone-directories should be included or excluded in the backup (for example, dev-directory, system files, kernel files, and so on, which are not automatically excluded).
    • Any image backup for a file system that is mounted within a Local Zone should be performed within the Local Zone where the file system is mounted.
    • HSM Client support of Solaris SPARC Local Zones means that the administrator of the Global Zone is now able to manage Veritas File Systems that are assigned to the Local Zones. This operation cannot be performed directly from the Local Zone. Only the administrator of the Global Zone has the privilege to add Space Management to the Veritas file systems assigned to or created from the Local Zones.
    • The HSM Solaris package is provided for SPARC system only and must be installed in the Global Zone only. The -G option of the pkgadd command is not required.
    • Any installation of the HSM package in the Local Zones is not allowed or supported. Any attempt to install it in the Local Zone produces the following message:

      WARNING:

      The package <TIVsmChsm> may only be installed on the global zone!
      Please note that Veritas File Systems assigned to <zone_name>
      can be managed directly from the administrator of the Global Zone.
      The package <TIVsmChsm> is not required to be installed on <zone_name>.
    • HSM files and daemons that are not present or running in the Local Zones and HSM commands such as dsmmigfs q or dsmls can be executed from the Global Zone only.
Back to Contents

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Storage Manager
Client

Software version:

6.2

Operating system(s):

AIX, HP-UX, Linux, Macintosh, Solaris

Reference #:

1417528

Modified date:

2013-04-19

Translate my page

Machine Translation

Content navigation