IBM Support

IBM Spectrum Protect Version 8.1.7.000 fix pack readme files

Product Readmes


Abstract

Readme files for server components are available when there is a fix pack update.

Content

Security enhancements

The image depicts an exclamation point to show readers that this information is particularly important.

 Beginning with IBM Spectrum Protect Version 8.1.2, enhancements were added to enforce stricter security settings. Before  you install or upgrade IBM Spectrum Protect, see What you should know about security before you install or upgrade the server.

Latest IBM Spectrum Protect server and client fix packs and interim fixes
To find the latest IBM Spectrum Protect fix packs and interim fixes, see technote 1239415.

Readme files
To find readme files for your fix pack, click the appropriate tab.

Tab navigation



The following readme files are available for the components in this release:

  
Readme file - IBM Spectrum Protect server Fix Pack 8.1.7.000
 

The IBM Spectrum Protect server provides backup, archive, and space management services to clients. You can set up multiple servers in your enterprise network to balance storage, processor, and network resources.

Fix history
To view APARs that were resolved in this fix pack, see technote 1998548.

Compatibility with earlier versions
For compatibility with earlier versions, see technote 1053218.

System requirements
For server system requirements, see technote 1243309.

Obtaining the server installation package
Download this fix pack from Fix Central or Passport Advantage.

The server package on Fix Central does not contain the license. If you are upgrading the server from V8.1.0 or later, the installed license is compatible with this fix pack.

If you are installing the IBM Spectrum Protect server for the first time or are upgrading from V6 or V7, download the IBM Spectrum Protect V8.1.7 server package from Passport Advantage.

For more information about how to download the server package, see the download document for AIX and Linux or the download document for Microsoft Windows.

Installing and upgrading

The image depicts an exclamation point to draw the reader's attention to this paragraph.

 Because of the security updates in recent product releases, installation and upgrade procedures have changed significantly. To help avoid issues, follow the installation and upgrade procedures in the product documentation. For the latest hardware and software requirements, see technote 1243309. As noted in the system requirements, the guidelines for selecting hardware on IBM AIX®️ systems have changed. You can install IBM Spectrum Protect on any appropriately provisioned and configured hardware on which you can run an operating system that is supported for the IBM Spectrum Protect release.

To install the server, follow the procedure for your operating system:


To upgrade the server, follow the procedures in Upgrading to V8.1.

After you install or upgrade the server, ensure that you have followed the instructions to prepare the server for database backup operations:


Restrictions on upgrading the server from V7 to V8

To upgrade an IBM Spectrum Protect server from V7.1.7.200 or later to V8, upgrade the server directly to V8.1.1 or later.

To upgrade an IBM Spectrum Protect server from V7.1.8 or later to V8, upgrade the server directly to V8.1.3 or later.

Updates, limitations, and known problems


Updates, limitations, and known problems are documented in the form of technotes in the Support knowledge base at the Support Portal. As problems are discovered and resolved, IBM Software Support updates the knowledge base. By searching the knowledge base, you can find workarounds or solutions to problems.

Updates

For a list of new product features and updates, see What's new. In addition, this fix pack includes the following update:

Improved fault tolerance for IBM Cloud Object Storage

In storage environments that use multiple accesser endpoints for data transfer to IBM Cloud Object Storage, the IBM Spectrum Protect server now seamlessly handles retry requests. If an accesser is malfunctioning or unavailable, the server redirects the request to an accesser that is working properly.

IBM Software Support might provide additional update information as technotes at the Support Portal. To search for possible updates, use the following search query link:

http://www.ibm.com/support/search.wss?rs=663&tc=SSGSG7&atrn=Keywords&atrv=supdates817

Limitations and known issues

The following table lists limitations and known issues for this fix pack:

 
Issue Description
To use the storage area network (SAN) discovery feature on a Linux on Power Systems (little endian) operating system, you must install a Marvell QLogic Fibre Channel adapter. For instructions, see technote 2017411.
To use the SAN discovery feature on a Linux x86_64 server with the Ubuntu Server LTS operating system, you must install a Marvell QLogic Fibre Channel adapter. For instructions, see technote 2015363.
Client deployment update packages fail to replicate from a hub server to a spoke server.

Client deployment update packages that were downloaded to a repository on a hub server might fail to replicate to a spoke server. The failure occurs when the spoke server is IBM Spectrum Protect V8.1.6 or later and you added the spoke by using the Add Spoke wizard in the Operations Center. If client deployment replication is failing, the following error is displayed on the Backup-Archive Client Updates page in the Operations Center:

Failed to prepare update packages.

In addition, the following error messages might be displayed in the activity log:

ANR0453W Server to server session refused - no password defined.
ANR0454E Session rejected by server SPOKE816A, reason: 201 - Communication Failure.

To resolve the issue, update the server password for the spoke and hub servers in the server definition by completing the following steps:

1. Use the DSMADMC command to start an administrative client session.
2. In the administrative client, connect to the hub server. Issue the following command on one line:
update server spoke_server serverpassword=spoke_server_password
3. In the administrative client, connect to the spoke server. Issue the following command on one line:
update server hub_server serverpassword=hub_server_password
4. In the Operations Center, verify that errors are no longer displayed on the Backup-Archive Client Updates page.

In the configuration wizard, some fields might be distorted. If you run the configuration wizard (dsmicfgx) by using a Unicode locale (such as EN_US or DE_DE), fields for Secure Sockets Layer (SSL) entries might be distorted. The fields are smaller in height than other fields in the user interface.

No action is required to resolve this issue. You can enter values in the fields, and the values are processed.

Alternatively, to work around the issue, you can run the configuration wizard by using a non-Unicode locale such as en_US or de_DE.

Tip: Ensure that you set the language of the server to the correct locale. By default, the configuration wizard uses the operating system's locale.

For more information, see technote 0720087.
The output of QUERY and SELECT commands might not be displayed correctly if the characters were created in a code page that is different from the system locale of the IBM Spectrum Protect server.

This issue occurs only if the IBM Spectrum Protect server is installed on a Windows operating system. If the characters in free text fields were created in a code page that is different from the system locale of the server, values in the free text fields might not be displayed correctly, for example:

register node node01 node01Pw contact="經理'

The issue can also occur if a user enters text in a language that differs from the system locale. For example, the system locale is English, but the user defines a retention rule by entering French characters for the DESCRIPTION parameter:
 
define retrule rule1 NODE01 retention=150 description="Çàâ" startdate=12/20/2018 starttime=01:00:00 schedstyle=classic frequency=weekly dayofweek=saturday

If the QUERY RETRULE command is issued, the output will not display the French characters (Çàâ) correctly.


This issue affects only the display of text and does not affect server operations. This issue is not limited to V8.1.7.

Restrictions apply to the REMOVE STGPROTECTION command. Review the restrictions:
  • If you issue the PROTECT STGPOOL or REPAIR STGPOOL command on a source server, you cannot simultaneously run the REMOVE STGPROTECTION command on the corresponding storage pools on the target server.
  • If you issue the REMOVE STGPROTECTION command on a source server, you cannot simultaneously run the REPAIR STGPOOL command on the corresponding storage pools on the target server.
Restrictions apply to the operations and storage pool types that are supported for network data management protocol (NDMP) operations. Review the restrictions:
  • Data deduplication is supported only with NetApp file servers and only if the file servers do not use SnapMirror to Tape backup operations.
  • Container storage pools are supported only with NetApp file servers and only if the file servers do not use SnapMirror to Tape backup operations.

For more information about the operations and storage pool types that are supported for different brands of file servers, see Storage pool types for NDMP operations.
Restrictions apply when you specify the DEFRAG parameter on the MOVE CONTAINER command. To avoid possible issues, do not run the MOVE CONTAINER command with the DEFRAG=YES option during data ingestion, backup, or delete operations.
Caching policy for storage systems might cause data corruption. For storage systems that have aggressive caching policies in which data is confirmed as written before it is committed to permanent storage, data corruption can occur if a power outage or other event prevents the write cache from being committed.

The write cache typically has a battery to prevent loss of data from the cache during short power outages. If a power outage occurs and no battery is available, or the battery cache is full, or the length of the power outage exceeds battery capacity, or another event occurs that prevents the write cache from being committed, any data that IBM Spectrum Protect is managing can become corrupted.

This data includes the location of data, the size of the volumes to which data was written, and data deduplication information that links data to multiple objects.

For more information about requirements for committing cached data to permanent storage, see technote 1137676.
Network connection to a NetApp file server becomes unresponsive during a logical interface (LIF) failover. When IBM Spectrum Protect is configured for network data management protocol (NDMP) operations in a NetApp clustered environment, the network connection to the NetApp file server might become unresponsive during backup operations.

You might experience this issue when a LIF failover occurs in the NetApp cluster. IBM Spectrum Protect does not support LIF failovers for NDMP operations.
IBM Tivoli Monitoring for Tivoli Storage Manager is not available in IBM Spectrum Protect V8.1 product releases. The Tivoli Monitoring for Tivoli Storage Manager component is not delivered in IBM Spectrum Protect V8 product releases. Instead, you can monitor your storage environment by using the Operations Center, a web-based user interface. For instructions, see Installing and upgrading the Operations Center.

Tip: In limited lab testing, Tivoli Monitoring for Tivoli Storage Manager V7 was used to monitor an IBM Spectrum Protect V8 server and to generate reports. For instructions about installing and configuring Tivoli Monitoring for Tivoli Storage Manager, see  Tivoli Monitoring for Tivoli Storage Manager.

IBM Software Support might provide additional information about limitations and known issues for this fix pack as technotes at the Support Portal. To search for possible limitations and known issues, use the following search query link:

http://www.ibm.com/support/search.wss?rs=663&tc=SSGSG7&atrn=Keywords&atrv=sreadme817


Readme file - IBM Spectrum Protect device support Fix Pack 8.1.7.000


You can use various storage devices with IBM Spectrum Protect to meet specific data protection goals.

The following information is for devices that are supported by IBM Spectrum Protect server Fix Pack 8.1.7.000.

Fix history

To view APARs that were resolved in Fix Pack 8.1.7.000, see technote 1994495.



Supported devices

For information about the devices and hardware that you can use with IBM Spectrum Protect, see the support website for your operating system:

New device support

This release does not introduce support for new devices.

Tip: Support for the IBM TS1160 tape drive was introduced in interim fix 8.1.6.100 and is also available in Fix Pack 8.1.7.000.

Configuring devices

For information about configuring and managing devices, see
Configuring storage or the IBM Spectrum Protect Tape Solution Guide.

The following table provides actions that you can take to more efficiently manage your devices and to avoid device configuration issues.
 
Action Description
Ensure that HBAs meet requirements. For best results, connect tape drives and tape libraries to the system on their own host bus adapter (HBA). Do not share the HBA with other device types, such as DISK.
Do not exceed the maximum number of devices that are supported by IBM Spectrum Protect. For information about the maximum number of devices that you can use with IBM Spectrum Protect device drivers on each operating system, see technote 1364225.
Review the support information for SAS device support. Serial Attached SCSI (SAS) devices can be used with some operating system versions and architectures. For information about operating systems versions and architectures for SAS devices, see technote 1396706.
Review requirements for running the IBM Spectrum Protect passthru driver with a non-root user ID on Linux operating systems. For information about how a non-root user ID can use devices with the IBM Spectrum Protect passthru driver on Linux, see technote 1321130.

To ensure that non-root user IDs can use devices that are configured with the IBM Spectrum Protect passthru driver, specify option -g or -a in the device autoconf utility. To add read and write permissions for groups to the SCSI generic driver (sg) device files, specify option -g. To add read and write permissions for all users to the sg device files, specify option -a.
Ensure that libraries meet requirements. IBM Spectrum Protect Extended Edition is required for a library with more than four drives or more than 48 storage slots.

For a library with multiple drives, a drive element address is required for the DEFINE DRIVE and UPDATE DRIVE commands. However, if the library reports drive serial numbers, you can specify ELEMENT=AUTODETECT, and the element address is not required. Alternatively, you can automatically associate a library with its drives by issuing the PERFORM LIBACTION command, and specifying ACTION=DEFINE.

Readme file - IBM Spectrum Protect Operations Center Fix Pack 8.1.7.000
 

The Operations Center is a web-based interface that you can use to manage your IBM Spectrum Protect environment.

Fix history

To view APARs that were resolved in this fix pack, see technote 1998545.

Compatibility with the IBM Spectrum Protect server

For information about Operations Center compatibility with the IBM Spectrum Protect server, see technote 1640917.

System requirements

For Operations Center system requirements, see technote 1653418.



Obtaining the Operations Center installation package

Download this fix pack from Fix Central.



Installing and upgrading

For installation and upgrade instructions, see Installing and upgrading the Operations Center.

Updates


To learn about updates in the Operations Center V8.1.7, see Operations Center updates.

IBM Software Support might provide additional update information as technotes at the Support Portal. To search for updates, use the following search query link:

http://www.ibm.com/support/search.wss?rs=663&tc=SSGSG7&atrn=Keywords&atrv=ocupdates817

Limitations and known issues

For a list of known issues, see technote 0870550.

To search for additional limitations and known issues, use the following search query link:

http://www.ibm.com/support/search.wss?rs=663&tc=SSGSG7&atrn=Keywords&atrv=ocreadme817


 

Copyright and trademark information:

http://www.ibm.com/legal/copytrade.shtml

Notices

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.



This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

Third-Party License Terms and Conditions, Notices and Information

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions:
  • the Excluded Components are provided on an "AS IS" basis
  • IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  • IBM will not be liable to you or indemnify you for any claims related to the Excluded Components
  • IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components.

Document information

More support for: IBM Spectrum Protect

Component: Server

Software version: 8.1.7

Operating system(s): AIX, Linux, Windows

Reference #: 0735109

Modified date: 22 February 2019