IBM Support

IBM Spectrum Protect 8.1 Windows backup-archive client known problems and limitations

Question & Answer


Question

This document contains warnings and known problems for the IBM Spectrum Protect 8.1 Windows backup-archive clients.

Answer

This document is divided into linked sections for ease of navigation.
You can use the following links to navigate to the section of the document you want.


Content


 


Warnings

Backup-archive client warnings

Currently, no known backup-archive client warnings for 8.1 release.
 

Windows backup-archive client warnings

Currently, no known Windows backup-archive client warnings for 8.1 release.



 


Known problems and limitations

Backup-archive client known problems and limitations

  • Help Links Incorrect for backup-archive legacy web and Java GUIs (internal reference: #199951)
    Problem: The help links in the legacy web GUI and the Java GUI point to 8.1.10 help and not 8.1.11 help.
    Workaround: After clicking on links and being in 8.1.10 help, select the version level at the top of the web page and change it to 8.1.11 to see the correct help.
    Affected platforms: AIX, Linux, Mac, Windows
    Limitation: Since 8.1.11. Solved with 8.1.12.
     

  • File "client_message.chg" contains incorrect information (internal reference #185266)
    Problem:  The installed file: C:\Program Files\Tivoli\TSM\doc\client_message.chg contains incorrect information.
    Workaround:  The correct information is:

    ##########################################################################
# Name:    client_message.chg
# Created: Wed March  8 09:24:40 2019
# Description: Message changes from ITSM 8.1.7 to ITSM 8.1.8
##########################################################################
# Licensed Materials - Property of IBM
# (C) Copyright IBM Corporation 1999,2019. All rights reserved.
# U.S. Government Users Restricted Rights - Use, duplication or disclosure
# restricted by GSA ADP Schedule Contract with IBM Corporation.
##########################################################################
These are the new client messages: ANS1044W, ANS9421E
These are the changed client messages: ANS2567E, ANS9419W, ANS4174E

    Affected platforms: AIX, Linux, Mac, Windows
    Limitation: Since 8.1.8. Solved with 8.1.9.
     

  • IBM Redbooks Link from backup-archive client GUI should be updated to an available page. When accessing the link, an error message is displayed.  (internal reference #180291)
    Problem: The link is not correct:  http://www.redbooks.ibm.com/portals/tivoli
    Workaround: IBM Spectrum Protect Redbooks can be found at http://www.redbooks.ibm.com/Redbooks.nsf/domains/spectrumcomputing
    Affected platforms: AIX, Linux, Mac, Windows
    Limitation: Since 8.1.7. Solved with 8.1.8.
     

  • Updating and Expiring a Node Password can result in rejected session (internal reference #147153)
    Problem: If a node's password is updated and later expires before it is ever used, the next time the node attempts to connect to the server the session will be rejected.  A subsequent attempt to connect to the server will not be rejected.
    Problem Verification: The rejected connection attempt will return

    ANS1026E (RC136) The session is rejected: There was a communications protocol error

    Workaround: To work around the rejected connection, retry the connection.
    Affected platforms: AIX, Linux, Mac, Windows
    Limitation: Since 8.1.2. Solved with 8.1.4
     

  • A long delay can be experienced while performing operations to the IBM Spectrum Protect Server before the operation fails with GSKKM_ERR_DATABASE_OPEN. (internal reference #148640)
    Problem: The problem is specific to the following scenario on UNIX. A user is attempting to configure client/server communication with Secure Socket layers. The version of the IBM Spectrum Protect server is not relevant in this case, but they are using the 8.1.2 IBM Spectrum Protect Client and API. The user manually imports the server certificate (dsmcert.kdb) as a root user, they do this action by either running the GSKit command-line utility program, gsk8capicmd, to import the certificate, or they use the new dsmcert tool. The user then switches to another non-root user on the system, they then attempt to perform IBM Spectrum Protect Client operations. In this scenario, the user experiences a long delay, anywhere between 5 to 20 minutes, before the client fails with a GSKKM_ERR_DATABASE_OPEN error.
    Problem Verification: The operation can appear to be hung, as it might take up to 20 minutes before failing. The failures can be different depending on the operation being attempted, but a GSKKM_ERR_DATABASE_OPEN error will be logged on dsmerror.log and dsierror.log.
    Workaround: The workaround is to manually change the permission on the certificate (dsmcert.kdb) so that both root and non-root users have read access to the certificate files "chmod go" and "r dsmcert.*"
    Affected platforms: AIX, Linux, Mac, Windows
    Limitation: Since 8.1.2. Solved with 8.1.4
     

  • If a keystore contains several hundred entries then there can be a delay when starting a client session. (internal reference: #148702)
    Problem: There can be a long delay when starting a client session. This behavior occurs when a certificate keystore contains more than a couple hundred entries.
    Workaround: Keep the keystore to fewer than 50 certificates.
    Affected platforms: AIX, Linux, Mac, Windows
    Limitation: Since 8.1.2. Solved with 8.1.4
     



 

Backup-archive client known problems and limitations related to web user interface

  • Some web user interface login issues do not have specific error messages. (internal reference #SPP-BA-374)
    Problem: Under rare circumstances, when an admin user or password fails to login to the web user interface there is only a return code, and not a specific message.
    Problem Verification: The following error message will be shown instead:

    "Try to log in again. If the problem persists, contact your administrator. Unable to login (rc = 3028)."

    Workaround: Check if admin password is expired.
    Affected platforms: AIX, Linux, Windows
    Limitation: Since 8.1.13
     

  • Some web user interface messages contain indeterminate object names (internal reference #SPP-BA-367)
    Problem: Some messages that are issued by the IBM Spectrum Protect web user interface contain indeterminate object names because the web user interface cannot obtain the necessary information from the server. For example, if you tried to use the web user interface to retrieve a file from an archive package that was removed at the same time by the backup-archive client, the following error message is issued in the error details panel:

    ANS1345E No objects on the server match '{0}{1}{2}'

    The requested objects are shown as placeholders because the web user interface can no longer obtain the object names on the server.
    Workaround: The local dsmerror log file contains the complete message.
    Affected platforms: AIX, Linux, Windows
    Limitation: Since 8.1.13
     

  • Error trace line output to dsmerror.log when session timeout (internal reference #SPP-BA-366)
    Problem:  If there wasn't any operation on backup-archive client web user interface for 30 minutes, an error is output to dsmerror.log like:

    ANS0361I DIAG: sessClose: Communications close error: -50

    This error does not cause any real problem. All running jobs continue.
    Workaround: Sign out backup-archive client web user interface if no more operation needs to be done on it.
    Affected platforms: AIX, Linux, Windows
    Limitation: Since 8.1.13
     

  • Running tasks in parallel on separate client nodes on the same host is not supported (internal reference: #SPP-BA-229)
    Problem:  When you log in to the web user interface and run several tasks consecutively, each of these tasks must wait until the previous task is completed. Only after one task is finished can the next task begin.
    However, when you log in to a second node on the same host (that is, the same URL), any task that you create is not started and remains in the "Waiting" state until the tasks in the first node is completed. Furthermore, no information about the running tasks that are initiated in the first node is displayed.
    The tasks on the second node can start only after the tasks on the first node is completed.
    Workaround: None. You must wait until the tasks on the first node are completed before the tasks on the second node can be started.
    Affected platforms: AIX, Linux, Windows
    Limitation: Since 8.1.7 (Linux x86, Windows), 8.1.8 (Linux on POWER, Linux zSeries), 8.1.9 (AIX)
     

  • Trace logging is not working in backup-archive web client (internal reference: #199853)
    Problem: The tracing for the functionality of the web client cannot be turned on in backup-archive client 8.1.11 without a workaround.
    Problem Verification: If tracing is not working in 8.1.11 for the web client, check the messages.log in the webserver directory. If a message like the following is seen, then the installation is impacted:

    2020-11-03 17:46:46,118 FRAPI.ManagedExecutorService-thread-4 ERROR Unable to create file wsjar:file:/opt/tivoli/tsm/tdpvmware/common/webserver/usr/servers/veProfile/apps/FR_API.war!/../../logs/fr_api.log java.io.IOException: No such file or directory
        at java.io.File.createNewFile(File.java:1023)
        at org.apache.logging.log4j.core.appender.rolling.RollingFileManager$RollingFileManagerFactory.createManager(RollingFileManager.java:658)
        at org.apache.logging.log4j.core.appender.rolling.RollingFileManager$RollingFileManagerFactory.createManager(RollingFileManager.java:641)
        at org.apache.logging.log4j.core.appender.AbstractManager.getManager(AbstractManager.java:113)

    Workaround: In the following directory /webserver/usr/servers/veProfile/apps directory do the following.
    1. Copy and rename FR_API.war to FR_API.war.orig.
    2. Unzip the FR_API.war file into a FR_API.war directory.
    3. Restart the webserver.
    Affected platforms: AIX, Linux, Windows
    Limitation: Since 8.1.11. Solved with 8.1.12
     

  • Inactive files might not be restored when restoring a directory by using the web user interface. (internal reference: #179512)
    Problem: When a directory is restored by using the web user interface, the handling of the inactive files depends on the backup status (active or inactive) of the directory.
    If the backup status of the directory is inactive (that is, the directory was no longer present at the time of the last backup), then all files in the selected directory, and related subdirectories, are restored.
    If the backup status of the directory is active (that is, the directory was present at the time of the last backup), then only the active files of this directory, and related subdirectories, are restored. Inactive files, that might be displayed on the user interface, are not restored.
    Problem Verification: Restore a directory that contains inactive files.
    Workaround: Select the individual inactive files to restore.
    Affected platforms: Linux, Windows
    Limitation: Since 8.1.7 (Linux x86, Windows), solved with 8.1.8
     

  • The "Detailed Failed Restore Information" panel of the web user interface does not effectively report that a "disk full" message relates to the target directory.   (internal reference: #179513)  
    Problem: In the case of a restore failure to an alternative location due to insufficient disk space in the target directory, the "Detailed Failed Restore Information" panel of the web user interface erroneously reports that the source disk is full. The "disk full" message displays next to the source "Object Name" files, and so this could be erroneously interpreted that the source disk is full, when in fact it is the alternative location of the target directory that is full.
    Problem Verification: Restore files and directories to an alternative location where there are no disk space issues.
    Affected platforms: Linux, Windows
    Limitation: Since 8.1.7 (Linux x86, Windows). Solved with 8.1.8.
     

  • Restore a directory to alternate location that only has files only in nested directories on a full disk. (internal reference: #179574)
    Problem: When a directory is restored to an alternate location that has insufficient disk space and the restored directory has only files in nested directories. The restore fail but there is no information available about which files failed.
    Problem Verification: Restore a directory to an alternate location that contains files only in nested directories by using the IBM Spectrum Protect 8.1.7 web user interface.
    Workaround: No workaround available.
    Affected platforms: Linux, Windows
    Limitation: Since 8.1.7 (Linux x86, Windows). Solved with 8.1.8.
     

  • Long running restore can fail in the web user interface when signing off (internal reference #180815)
    Problem: Signing off during a long running restore can result in a failed restore. Starting a long running restore and signing of when this restore is still running can result in a failed restore. The restore task is failed but it can be that still all files where restored. It is not possible to see which files where restored.
    Workaround: Do not sign off during running restore task.
    Affected platforms: Linux, Windows
    Limitation: Since 8.1.7 (Linux x86, Windows). Solved with 8.1.8.
     



 

Windows backup-archive client known problems and limitations

  • Message "ANS1592E Failed to initialize SSL protocol" might be encountered after installing a previous level Data Protection application on the same system as the IBM Spectrum Protect Client. (internal reference #199014)
    Problem: The following files:
    C:\Program Files\ibm\gsk8\copyright
    C:\Program Files\ibm\gsk8\catalogs\gsk8crypt64.cat
    C:\Program Files\ibm\gsk8\catalogs\gsk8ssl64.cat
    C:\Program Files\ibm\gsk8\lib64\N\icc\icclib\icclib085.dll
    C:\Program Files\ibm\gsk8\lib64\N\icc\icclib\iccsig.txt
    might be deleted or back-leveled during installation of the following:

    • IBM Spectrum Protect for Databases: Data Protection for Oracle
    • IBM Spectrum Protect for Databases: Data Protection for Microsoft SQL Server
    • IBM Spectrum Protect for Mail: Data Protection for Microsoft Exchange
    Workaround: Run an installation repair of the IBM Spectrum Protect Client. This can be done by:
    • Right-click "IBM Spectrum Protect Client" in the "Programs and Features".
    • Select "Repair"
    • Re-run the installation from the original package and
    • select "Repair" during in the Program Maintenance dialog.

    Affected platforms: Windows
    Limitation: Since 8.1.11.
     

  • Backup of OneDrive file marked as 'On Demand' can fail with ANS4004E (internal reference #197352)
    Problem: If the option SNAPSHOTPROVIDERFS VSS is used in dsm.opt, then the backup of OneDrive file which is marked as 'On Demand' will fail with following error message:

    ANS4004E Error processing '...': destination file or directory is write locked

    Because a volume shadow copy is read only.
    Workaround: Set the option SNAPSHOTPROVIDERFS to NONE.
    Affected platforms: Windows
    Limitation: Since 8.1.0.
     

  • IBM Spectrum Protect Client UI "Edit" -> "Java Diagnostic" dialog box shows an incorrect operating system - Windows Server 2016 (internal reference # 179755 & # 179754)
    Problem: On Windows 2019, the field display Windows 2016 instead of Windows 2019. It is a display issue and does not impact functionality.
    Workaround: none
    Affected platforms: Windows
    Limitation: Since 8.1.7.
     

  • Win 10 backup-archive client command line freezes with password prompt (internal reference # 174374)
    Problem: The dsmc and dsmadmc commands hang when prompting for the password on Windows 10 build 1803.  Additionally, Crtl-C command will not terminate the process.  Either kill the process or close the command prompt terminates the process.
    Workaround:
    - dsmc command: set PASSWORDACCESS GENERATE in the dsm.opt file.  Use the IBM Spectrum Protect GUI interface to sign in to the Protect server. This will generate and store the password.  The dsmc command can now be used.
    - dsmadmc command: There is no workaround for dsmadmc.  A different machine must be used that is not at the 1803 level.
    Affected platforms: Windows
    Limitation: Since 8.1.6, Vendor issue, see more information in: https://developercommunity.visualstudio.com/content/problem/247770/-getch-broken-in-vs-157.html?childToView=385180
     

  • IBM Spectrum Protect database backup completes with the following message - ANR1893E Process 2 for Database backup completed with a completion state of FAILURE. (internal reference #168928)
    Problem: The backup db fails if IBM Spectrum Protect client 8.1.6 or later installed on the same system as IBM Spectrum Protect Server 8.1.5 or earlier. The problem is that the 8.1.6 API cannot read the DSMI_CONFIG that Db2 sets when it starts the backup.
    Problem Verification: Database backup fails with the following error message:

    ANR2984E Database backup terminated due to environment or setup issue related to DSMI_CONFIG - DB2 sqlcode -2033 sqlerrmc 406.

    Workaround:  Create this link for the IBM Spectrum Protect API so that picks up the default dsm.opt from the working directory.

    mklink C:\ProgramData\IBM\DB2\DB2TSM1\<Server Instance>\dsm.opt "<Server Instance Path>\tsmdbmgr.opt"

    For example: 

     mklink C:\ProgramData\IBM\DB2\DB2TSM1\SERVER1\dsm.opt "C:\server1\tsmdbmgr.opt"

    Affected platforms:  Windows
    Limitation: Since 8.1.6. Vendor issue, see IT26376
     

  • On Windows 2016, backup systemstate completes with RC=8. (internal reference #132298)
    Problem: Performing backup systemstate on Windows 2016 might finish with rc = 8 due to some non-existing files returned to us by Windows System state writer. We currently have an incident open with Microsoft so that they can address this issue.
    Problem Verification: The following warning will be seen in the dsmerror.log:

    ANS4251W System Writer file '\\?\globalroot\device\harddiskvolumeshadowcopy82\windows\servicing\version\10.0.14393.0\amd64_installed': not found.
ANS4251W System Writer file '\\?\globalroot\device\harddiskvolumeshadowcopy82\windows\servicing\version\10.0.14393.0\x86_installed': not found.

    Workaround: There is currently no workaround for this issue. However, if the only entries in the dsmerror.log file are the two warning messages described above, they can safely ignore these and consider the backup as successful. See Third-party backup warnings after you install a servicing update in Windows Server 2016
    Affected platforms:   Windows
    Limitation: Since 8.1.2. See Third-party backup warnings after you install a servicing update in Windows Server 2016
     

  • Automatic backup-archive deployment might fail when updating to version 8.1.2 (internal reference #150841)
    Problem: When you use the automatic backup-archive deployment to upgrade to version 8.1.2, it might fail if the optional BA client package "VMware vStorage API runtime files" is installed on the system and the client is configured for SSL/TLS communication (SSL YES in dsm.opt file)
    Workaround: Uninstall the optional B/A client package before you use 8.1.2 automatic backup-archive client deployment or perform a manual update not use 8.1.2 automatic backup-archive client deployment
    Affected platforms:   Windows
    Limitation: Since 8.1.2. Solved with 8.1.4
     

  • Non-root users of the IBM Spectrum Protect Client might need access to the certificate store for server certificates, but permission problems thwart such access. (internal reference #150024)
    Problem: The dsmcert utility installed with the IBM Spectrum Protect backup Archive Client is used to create a certificate store for server certificates. The file permissions on the store restrict access to the creator of the store and the root user. Non-root users of IBM Spectrum Protect will likely need access to the store.
    Workaround: Access can be granted by running the following commands:

    dsmcutil addace -entity:JohnDoe -object:TSM.*

    Affected platforms:  AIX, Linux, Mac, Windows
    Limitation: Since 8.1.0. Solved with 8.1.4
     

  • "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 Data Protection for Microsoft Hyper-V to use the Incremental Forever backup type.
    Workaround: None
    Affected platforms:  Windows
    Limitation:  Since 7.1 release. Permanent restriction, see APAR IT14948.
     

  • Windows GUI client freezes and generates a crash dump while deleting backup data. (internal reference # 172104)
    Problem: Windows GUI client freezes during delete backup operation. This problem caused by crash of background process. After the crush occurred dump file is generated in the backup client installation directory.
    Problem Verification:  Attempt to delete backup by using Windows GUI client. Make sure there is no dsmagent crash dump files in the backup client installation directory. If the operation freezes and a crash dump file is created in the client directory then you are affected by the problem. Delete backup by using command line interface should work fine.
    Workaround: Use command line client to delete backup data. By using Windows GUI client versus CLI client it's a matter of convenience.
    Affected platforms:  Windows
    Limitation:  Since 8.1.6. Solved with 8.1.7, see IT26378
     



 


Known issues and limitations found in previous version

Windows client warnings

  • 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 Tivoli Storage Manager client, the registry entry indicating the location of the ICC encryption library is not created. Since the recovery scenarios described in the field guide do not involve Tivoli Storage Manager 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 Tivoli Storage Manager 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 by using vStorage for Data Protection API
     

  • Tivoli Storage Manager VMware off-host backup uses the virtual machine hostname as the default Tivoli Storage Manager node name to store file level backup data on the Tivoli Storage Manager server. Tivoli Storage Manager clients installed inside the guest operating system also uses the hostname as the default Tivoli Storage Manager node name, and therefore allows for an easy restore of off-host backup file restores. Tivoli Storage Manager Full VM backup uses the hostname as the virtual machine Full VM image name on the Tivoli Storage Manager server. To ensure that these backup images are unique, Tivoli Storage Manager backup will check for duplicate hostnames 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.

  • vStorage File-level backup operations that crash or are are terminated (by pressing the Ctrl-C keys) from dsmc.exe or dsmcsvc.exe by using the Hotadd Transport mode can leave the Hotadd(ed) disk mounted on the Proxy system. This mounted disk must be removed through the Virtual Center's "Edit Settings" dialog.

  • vStorage File-level backup operations can cause a crash of dsmc.exe or dsmcsvc.exe when processing certain virtual machines with 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 by 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


Common windows client known problems and limitations

  • 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 server. 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 (through 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.
     

  • Tivoli Storage Manager Client processes Windows native deduplicated files in unoptimized form. (Internal reference #101535)
    If a file has been deduplicated between incremental backups, Tivoli Storage Manager will recognize a change in the file and will backup the file. It might not look right for the user because the change (file being deduplicated) is invisible to user. From user point of view file was not changed. However, internally operating system replaces original file with a stub file, similar to HSM. Tivoli Storage Manager client detects that change and this change is the trigger for file backup.  

  • The -absolute option does not work while doing a Journal base backup. (Internal reference #95289)
    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$

    Workaround: Add the -nojournal option to the command.
     

  • 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

  • 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 Tivoli Storage Manager 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 you use the web client, the browser can crash if you do the following, by using the view menu item in the backup or restore tree window:
    - Click "Expand Entire Branch"
    - Then click "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.
     

  • Log file 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. By 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 might be no "END OF DATA" text marker at the end of the error log. After space has been made available, the Tivoli Storage Manager client will then 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 Tivoli Storage Manager 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 quotation marks 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 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).
     

Windows client known problems and limitations

  • Error during image restore (Internal reference #95044)
    When performing an image restore on top of a GPT formatted volume in a Microsoft cluster environment the image restore might be fail with the following error:

    ANS1287E Volume could not be locked.

    The problem occurs because a Tivoli Storage Manager 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 maintenance mode.
    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 by using the snapdiff option on a Windows Tivoli Storage Manager 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.

  • Installation Path Limitation
    The Tivoli Storage Manager Client uses 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
    Note: Tivoli Storage Manager Client language packs use the installation path of the base client installation, so a base installation of the Tivoli Storage Manager 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. Tivoli Storage Manager 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, Tivoli Storage Manager 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 Tivoli Storage Manager 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:

    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 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 Tivoli Storage Manager 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).
    5. Start the registry editor.
    6. Navigate to the following registry key:   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage
    7. In the right 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
    8. Close the registry editor. The Tivoli Storage Manager 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 through the Windows taskbar, 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 Tivoli Storage Manager scheduler service while the Tivoli Storage Manager 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 Tivoli Storage Manager server. To resolve this, after the Tivoli Storage Manager 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. 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 cannot 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 Tivoli Storage Manager 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 file name 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.
     

  • 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 uses 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 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 Tivoli Storage Manager 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

  • "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 might 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 except for four directories and the backup might 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).



 

[{"Product":{"code":"SSEQVQ","label":"IBM Spectrum Protect"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Client","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF014","label":"iOS"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.1","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
02 February 2022

UID

swg21993250

Page Feedback