Carbonite Server Backup
Agent for IBM i
Version 7.51.7308
Release Notes, April 25, 2019
______________________________________________________________________
Contents
1	Overview
1.1	Release History
1.2	Supported Platforms
2	NEW FEATURES in Version 7.5x
3	INSTALLATION NOTES
3.1	Installation Requirements
3.2	Licensing
3.3	Install/Upgrade
4	FIXES and KNOWN ISSUES
4.1	Fixes
4.2	Known Issues
5	PRODUCT SUPPORT
5.1	Technical Support
5.2	Product Updates
5.3	Documentation
© Carbonite Inc. 2019.  All Rights Reserved.
The release notes are governed by the Terms of Service found at https://www.carbonite.com/terms-of-use/carbonite-general-enterprise-terms-of-service.  Carbonite, at its sole discretion, reserves the right to modify or revoke these Release Notes at any time, without notice.
______________________________________________________________________
1	Overview
This document contains release notes for IBM i Agent version 7.51.
The Agent is supported with Director 8.xx and later versions.
1.1	Release History
Version 7.51.7308, April 25, 2019
Version 7.50.7307, March 20, 2019
1.2	Supported Platforms
This version of the Agent is supported on:
•	IBM i V7R3
•	IBM i V7R2
•	IBM i V7R1
•	IBM i V6R1. The following PTFs or later PTF levels must be installed before you install or upgrade the Agent on IBM i V6R1:
PTF Group	Text	Level	
SF99626 	6.1 ELECTRONIC SERVICES GROUP PTF	11	
SF99610	CUMULATIVE PTF PACKAGE C5063610 	15063	
SF99609	GROUP HIPER                                           	210	
SF99608	GROUP SECURITY                                        	60	
SF99605 	HARDWARE AND RELATED PTFS 	17	
SF99601   	DB2 FOR IBM I                                           	33	
SF99562 	JAVA                                                            	41	
SF99356 	PRINT PTFS                                                 	31	
SF99354 	TCP/IP PTF                                                   	17	
SF99187   	BACKUP RECOVERY SOLUTIONS	61	
SF99115 	IBM HTTP SERVER FOR I                               	46	
Note: For a disaster recovery on IBM i V6R1, the cumulative and group PTFs listed above must be applied before you install the Agent.
2	NEW FEATURES in Version 7.5x
•	The Agent now communicates with the vault using the TLS 1.2 protocol. 
•	A Preserve Hard Links parameter has been added for IFS backup jobs. This option specifies whether hard links are preserved when you back up and restore hard links and the original linked file at the same time.
•	To ensure that system subsystem and user subsystems can be restored in a disaster recovery scenario, *SBSD and *JOBD objects in the QSYS library are now backed up in *IBM type backup jobs.
•	To minimize the size of backup data, the Agent now compresses data from all backups using the “Better” compression method. 
•	During a restore, fields for entering the encryption password now appear on the main Run Restore screen instead of on a separate screen. 
•	The Agent can now be installed, upgraded and uninstalled silently.
3	INSTALLATION NOTES
3.1	Installation Requirements
Before installing the Agent, we recommended installing the latest cumulative, hyper and group PTFs (Program Temporary Fixes) from IBM.
3.2	Licensing
The Agent is installed with a 30-day trial license. The Agent has full functionality for the 30-day trial period. During this time, obtain a full license code from your service provider and enter it in the Work with License screen.
3.3	Install/Upgrade
The IBM i Agent is provided in a .zip file (ibmiagent-7.51.7308.zip) or as an iso file (ibm_i_agent_7_51_7308.iso).
For information about installing or upgrading the Agent, see the IBM i Agent User Guide.
4	FIXES and KNOWN ISSUES
4.1	Fixes
4.1.1	Fixes in Version 7.51
An “Invalid library name in exclude list” error no longer occurs if you remove an exclusion from a backup job. (EV-28834)
Email notifications are sent successfully when a backup or restore succeeds or fails. (EV-33197) 
Non-java files with names that include java file extensions (e.g., .jar, .class or .java) are backed up without calling the system API in *IFS jobs, so a “ThreadApi is in error status” error no longer occurs for these files. (EV-32945)
In backup and restore logs for *OBJ jobs, objects are now counted correctly in summary totals. As a result, the numbers of files and directories examined, backed up and restored reported in the logs have changed. The following table indicates how specific object types are counted:
Object type	Previously counted as	Now counted as	
physical file	directory	file	
logical file	directory	file	
physical file member	directory	No longer counted. Only the parent physical file is counted as a file.	
spool file	file	No longer counted. Only the parent output queue is counted as a file in the logs.	
_END_MBR.MBR (agent-created file that indicates the end of the member list)	directory	No longer counted	
_END_MBR$poolxxxxxxx.MBR (agent-created file that indicates the end of the spool file list)	file	No longer counted	
Note: These changes do not affect logs for *IFS or *SYS jobs. (EV-33209)
A “No files backed up” warning no longer appears in the log after a successful physical file or logical file only backup. (EV-20999)
A “Keyword PRESCAN not valid for this command” warning no longer occurs when you change an *OBJ type job. (EV-33199)
4.1.2	Fixes in Version 7.50
Security improvements have been made, including using SHA-256 and TLS 1.2 for communications with vaults.
An issue has been addressed where a task was marked as suspect on the vault when a file changed from a symbolic link to a file between backups. (EV-22555, EV-30850, EV-23281, EV-22237)
If a network interruption occurs during a backup, the agent can reconnect to the vault and successfully the complete the backup. (EV-26516)
Error and warning messages no longer appear in backup logs for objects that are excluded from backup jobs. (EV-24734)
An issue where the agent sometimes did not save file data has been resolved. (EV-19691)
4.2	Known Issues
For a disaster recovery on IBM i V6R1, the required cumulative and group PTFs listed in Supported Platforms must be applied before you install the agent. Otherwise, the agent will fail to connect to the vault. Applying these PTFs could take extra time and require extra time for the disaster recovery. (EV-32428)
When you synchronize or restore data from a vault version earlier than Director 8.30, RPC-E-AUTHERROR authentication errors sometimes appear in the log. This problem does not occur when the Agent is used with Director version 8.30 or later. (EV-30718)
If an *OBJ type backup job is terminated in the middle of a backup process, do not restart the backup job immediately. Wait at least 45 minutes until you restart the job and set QFS to *NO when you restart it for the first time. (EV-29245)
PTF status files QUSRSYS/QAPZ* are special operating system objects that cannot be overwritten. For this reason, they are excluded from *ALLUSR and *SYS backups, and from QUSRSYS library backups. To backup the PTF status files, you must back them up to a save file and include the save file in an *ALLUSR backup job. When you restore the PTF status files (most likely in a disaster recovery scenario),  you must delete any existing QUSRSYS/QAPZ* files first, and then restore them from the save file. (32667)
If you create a job to back up document folders /QDLS only, no files will be saved. /QDLS is saved by default when you do an IFS root backup. If you want to back up /QDLS individually, you can set up a *IFS type job INCLUDE(('/QDL*')). (32414)
If you try to restore a multiple member file and exclude one or more members, the entire file is not restored. The same situation applies to spool files. (32664)
Do not use the IBM Advanced Scheduler for submitting Agent Jobs. The Agent uses the standard job scheduler, which requires multi-threading. The IBM Advanced Scheduler uses the RCLRSC command, which is not compatible with multi-threaded applications. (10844/5865)
5	PRODUCT SUPPORT
5.1	Technical Support
Contact information for your provider is available from your provider.
5.2	Product Updates
Product updates are available from your service provider.
5.3	Documentation
The following documentation is available for the Agent:
•	Agent for IBM i User Guide
•	Agent for IBM i release notes (this document)