Version 8.1: Updates for IBM Spectrum Protect for Windows Backup-Archive Clients Installation and User's Guide

• Per APAR IT24198
  - In the "Include options" topic, item 4 in the Notes in the include.encrypt section is changed to the following text:
  4. Encryption is not compatible with the IBM Spectrum Protect™ for Virtual Environments Data Protection for VMware Recovery Agent. If the client is configured for encryption, you can use the client to restore backups that were created with the full or incremental backup modes (MODE=Full and MODE=Incremental) from the Version 7.1 or earlier client. However, you cannot use the Recover Agent to restore the encrypted backups.
  
  - In the Delete Backup command:
  The sentence: "When you specify -objtype=VM, this command deletes only virtual machine backups that were created with any of the following modes: FULL, IFINCR, and IFFULL."
  is replaced by the following sentence: "When you specify -objtype=VM, this command deletes only virtual machine backups that were created with any of the following modes: IFINCR, and IFFULL."
  
  - In the Expire command:
  The sentence: "When objtype=VM is specified, the expire command expires only full virtual machine backups (MODE=FULL or MODE=IFFULL) for the virtual machine that is specified on the vmname parameter."
  is replaced by the following sentence: "When objtype=VM is specified, the expire command expires only full VM backups (MODE=IFFULL) for the VM that is specified on the vmname parameter."
   
• Per APAR IT23560
  Clients > Configuring backup-archive clients > Configure the IBM Spectrum Protect client > Configuring IBM Spectrum Protect client/server communication with Secure Sockets Layer > Creating a symbolic link to access the latest GSKit library
  The following text has been added:
  Before you begin
  • An IBM Spectrum Protect™ client, V8.1.2 and later levels, and V7.1.8 and later V7 levels requires GSKit version 8.0.50.78.
  • An IBM Spectrum Protect client, V8.1.1 and earlier V8 levels, and V7.1.7 and earlier levels requires a version of GSKit earlier than version 8.0.50.78.
   
• Per APAR IT23086
  Clients > Configuring backup-archive clients > Configure the IBM Spectrum Protect client > Automated client failover configuration and use > Configuring the client for automated failover
  The following text has been added:
  Note
  If the replication server is V8.1.1 or earlier, and SSL is enabled, you must manually install the SSL certificate on the client with the following command:
  gsk8capicmd_64 -cert -add -db dsmcert.kdb -stashed -label "TSM server STSM01 self-signed key" -file <certificate_file> -format ascii
  Where <certificate_file> is the path to the corresponding certificate.
   
• Per APAR IT23809
  In topics "Comparing incremental-by-date, journal-based, and NetApp snapshot difference to full incremental and partial incremental backups" and "Snapdiff":
  The following text has been added:
  Snapshot differential backup operations are not supported in the IBM Spectrum Protect for Virtual Environments environment. You cannot run snapshot differential backup operations of a file system that resides on a NetApp filer on a host where the Data Protection for VMware or Data Protection for Microsoft Hyper-V data mover is also installed.
   
• Per APAR IT23865
  Clients > Backup-archive client options and commands > Processing options > Client options reference > Queryschedperiod
  The following text has been added:
  Tip: If the period set by the queryschedperiod option is much smaller than the randomization window of a schedule that is set by the server administrator, the start of the schedule can be delayed. To avoid such a delay, adjust the following values:
  • The client action duration (with the SET CLIENTACTDURATION server command)
  • The randomization of scheduled start times (with the SET RANDOMIZE server command)
  • The value of the queryschedperiod option
  
  Given the settings for the client action duration and the randomization window of a schedule, the following examples show how to calculate the query schedule period.
  Client Action Duration: 1 Days
   Schedule Randomization Percentage: 25%
   Query Schedule Period: 6 hours
  
   Client Action Duration of 1 day = 24 hours
     24 hours x .25 = 6 hours
   Use a query schedule period of 6 hours or higher.
  
  Example 2:
    Client Action Duration: 3 Days
   Schedule Randomization Percentage: 10%
   Query Schedule Period: 8 hours
  
   Client Action Duration of 3 days = 72 hours
     72 x .10 = 7.2
   Use a query schedule period of 8 hours or higher.
   
• Per APAR IT23581
  Clients > Back up and restore data with backup-archive clients > Backing up your data > Deleting backup data
  The "Results" section has been updated as follows:
  Results
  Note:
  •I f you specify Delete Active Objects or Delete Inactive Objects, only the files are considered for removal.
  • If you specify Delete Active Objects or Delete Inactive Objects and select a directory that contains no files for removal, the following message is displayed during the delete backup operation:
  ANS5030E No objects on server match query.
  The last parent inactive directory is removed based on retention policy settings on the server.
  • A directory is deleted only if you select Delete All Objects.
  • To delete file spaces, click Utilities > Delete Filespaces from the main window.
  • To delete backup copies using the command-line client, use the delete backup command.
   
• Per APAR IT23279
  Clients > Back up and restore data with backup-archive clients > Backing up your data > Display backup processing status
  In Table 1. Client command line informational messages, the descriptions of "Data transfer time", "Network data transfer rate", "Aggregate data transfer rate", and "Total number of bytes transferred" are incorrect. These descriptions have been updated as follows:

  Data transfer time:	The sum of the times that each backup, archive, restore, or retrieve session takes to send data across the network. This number does not include the time for the client to read the data from disk before the date is sent, nor the time to wait for server transactions to complete. This number can be greater than the elapsed processing time if the operation uses multiple concurrent sessions to move data, such as multi-session backup and restore operations. This number includes the time that it takes to send data more than once due to retries, such as when a file changes during a backup operation.
  Network data transfer rate:	The average rate at which the network transfers data between the client and the server. This statistic is calculated by dividing the total number of bytes transferred by the time to transfer the data over the network. This statistic does not include the time for the client to read the data from disk before the data is sent, nor the time to wait for server transactions to complete.
  Aggregate data transfer rate:	The total number of bytes transferred during a backup, archive, restore, or retrieve operation, divided by the total elapsed time of the operation.
  Total number of bytes transferred:	The total number of bytes transferred during the backup, archive, restore, or retrieve operation. This value includes data that is sent more than once due to retries, such as when a file changes during a backup operation.

Updates that apply to 8.1.2 and earlier versions

• Per APAR IT22875
  Clients > Backup-archive client options and commands> Processing options > Client options reference > Domain.vmfull
  The following statement is added for the vmname parameter under Domain.vmfull for VMware virtual machines:
  "The names are case-sensitive."
   
• Per APAR IT22157
  Clients > Backup-archive client options and commands > Processing options > Client options reference > Snapdiff
  The following statement is incorrect:
  (Windows) The snapdiff (snapshot difference) option is for backing up NAS/N-Series file server volumes that are NFS or CIFS attached.
  
  It is replaced by the following two statements:
  (Windows) The snapdiff option is for backing up NAS/N-Series file server volumes that are CIFS attached.
  (Linux) The snapdiff option is for backing up NAS/N-Series file server volumes that are NFS attached.
   
• Per APAR IT20791
  Clients > Backup-archive client options and commands > Processing options > Client options reference
  In the Enableinstrumentation, Instrlogmax, and Instrologname options, the following statement is removed:
  "The option can be set in the client option set on IBM Spectrum Protect server."

Updates that apply to Version 8.1.0

• Per APAR IT20793
  Clients > Configuring backup-archive clients > Configure the IBM Spectrum Protect client > Configuring NetApp and IBM Spectrum Protect for snapshot difference incremental backups > Protecting clustered-data ONTAP NetApp file server volumes
  In Step 2, the order of the arguments in the set netappsvm command is incorrect:
  dsmc set netappsvm management_filer_hostname storage_virtual_machine_hostname storage_virtual_machine_name
  The correct order of the arguments is updated to the following text:
  dsmc set netappsvm storage_virtual_machine_hostnamemanagement_filer_hostname storage_virtual_machine_name