Files in this download contain Licensed Materials, property of IBM, (C) Copyright IBM Corp. 1998-2014. All Rights Reserved. The Licensing Agreement is viewable at the following link: http://www-947.ibm.com/systems/support/machine_warranties/machine_code.html IBM periodically releases firmware updates that are intended to, among other things, support new features, increase overall reliability, improve tape handling, further reduce any possibility of data loss/data error, and provide continued enhancements to diagnostic capabilities. The readme files contain information that may not be included in the IBM T4500 documentation. The readme files take precedence over the documentation. Therefore, any information in this file that conflicts with information in the documentation will supersede the TS4500 Tape Library Operator Guide. The IBM TS4500 Tape Library is responsible for providing basic and advanced tape functionality for backup/restore and archive environments. For more details on functionality and other operation procedures, consult your copy of the TS4500 Tape Library Info Center. A softcopy is available for viewing at the following link: https://www.ibm.com/docs/en/ts4500-tape-library?topic=STQRQ9/com.ibm.storage.ts4500.doc/ts4500_ichome.html In order to provide maximum performance and reliability, it is recommended that the recommended version of microcode is installed on your IBM tape libraries and tape devices. These firmware updates are intended to, among other things, increase overall reliability, improve tape handling, further reduce any possibility of data errors and provide continued enhancements to diagnostic capabilities. CODE LEVEL RECOMMENDATIONS: Current TS4500 firmware level recommendations are available at https://www.ibm.com/support/pages/ibm-ts4500-code-update-recommendation The IBM TS4500 Tape Library follows the IBM Product Security Incident Response Team (PSIRT) process to comprehensively address security vulnerabilities in IBM products. Review the process description and view or subcribe to IBM security bulletins in the following link: https://www.ibm.com/trust/security-psirt Notes: 1. Drive code update could fail for multiple drives when selecting control path and non control path drives together for a drive code update. Work-around: Update drives either one by one or in group of CP or non-CP. Do not select CP and non-CP drives together for a drive code update. 2. When remote authentication is enabled, it is possible for a valid user login to fail while other valid logins are successful. Any attempt to update the password via the web user interface will fail. The following work-around can be used to clear this problem. i. Log into the web user interface with a remote user account with an administrator role. ii. Disable (temporarily) Remote Authentication. Logout. iii. Log in with admin user or local user with administrator role. iv. From Users page, Create a temporary user. v. Delete the temporary user. vi. Enable Remote Authentication. Logout. vii. Retry logging in with user accounts that previously failed. 3. For firmware level 1.10.0.0, REST over Ethernet (RoE) drive and library firmware update does not work 4. For firmware level 1.10.0.0, some 3592 JF cartridges don't return complete attributes via REST 5. For firmware levels 1.9.0.0, 1.9.0.1, 1.9.0.2, and 1.10.0.0 running on libraries with 1 or more Dx5 frames, initial setup must be run attached to the primary LCC 6. For firmware levels 1.9.0.0, 1.9.0.1, 1.9.0.2, and 1.10.0.0 running on libraries with 1 or more Dx5 frames, the Door Safety Interlock Test during Library Verify may reflect incorrect status. As a work-around, the test can either be skipped, cancelled, or successfully run from a web browser that is connected via Ethernet to the primary LCC 7. For firmware level 1.9.0.2 and 1.10.0.0, for all tape drives, the REST and mount history csv LifetimeRemaining and MotionMeters may intermittently indicate a value of 0 8. For firmware level 1.9.0.2 and 1.10.0.0, for TS1170 tape drives, the mount history csv MotionMeters may intermittently indicate an invalid (lower) non-zero value 9. For firmware levels 1.9.0.0, 1.9.0.1 and 1.9.0.2 when using TLS security for encryption key server communications, LCCs that are not attached to the customer network may experience resets or loss of communications with the key server 10. On first load of LTO9 media, the drive will show an Operation of Loading in the Properties dialog during the LTO9 media optimization process 11. TS4500CLI Tool 1.9.0.1 -restoreConfiguration might require an additional reset of the library if configuration was not restored after the self reset. 12. Customers with LTO7/LTO8 on P380 level using Legato NetWorker or NetBackup with encryption and experiencing a hang during a write operation should downlevel to N9M0 to resolve this issue. 13. For firmware levels 1.8.0.0 and 1.8.0.1, when configured with TLS support for SKLM, some key requests from the library may time out in cases of heavy workloads at the SKLM. 14. In firmware levels 1.7.0.0, 1.7.0.1, and 1.7.0.2, an LCC may fail to establish communications with an initializing tape drive for an invalid reason. If the drive is a control path drive, host-to-library communications will fail. In order to work-around this problem, the LCC must be reset 15. JD(JD, JL, JZ) and JE(JE, JM, JV) media types when used in TS1150(EH8), TS1155(55F/55E) or TS1160 (60F/60E) require a critical fix for tension control issues. This fix is included starting in drive firmware levels EH8_A9A, 55E_A9A, 55F_A9A, 60F_625 and 60E_625. The new firmware will re-tension JD and JE tapes on the very first load of a tape on a drive with these new levels. This action will add about three minutes to the first load time. Once a tape is re-tensioned, it will not go through this action again. Once the drives are upgraded with the new level, do not downgrade the drive firmware to an older level. JC(JC, JK, JY) media type is not affected. 16. For customers with Rear Door Sensor (FC 4892), opening either side or front door without first pausing the library can result in a library freeze. Per TS4500 best practices, the user must pause library before opening either front or side doors. 17. Un-initialized M8 media and pre-initialized M8 media are both supported with a minimum LTO8 tape drive firmware level of HB82 and a minimum library firmware level 1.4.1.2. The usage of M8 media with prior firmware levels may result in a permanent reduction in the capacity of the M8 media from 9 TB to 6 TB (native). 18. Firmware version 1.6.0.0-B00 and above are not backwards compatible to previous levels of code. Once on 1.6.0.0-B00 level or above, you cannot downgrade lower than 1.6.0.0-B00. 19. Firmware version 1.6.0.0-B00 and above does not support restoring configurations from codes lower than 1.6.0.0-B00. MAIN NEW FEATURES 1.11.0.1-C00 level includes: - Additional fixes (See fixlist) 1.11.0.0-D00 level includes: - Added REST support for managing logical libraries - Added REST support to include descriptors in the event description returned - Added REST support to set library customer information - Added REST support to modify password/session policy - Added REST support to modify NTP settings - Added REST support to configure encryption method - Added REST support to modify capacity utilization threshold and dual accessor utilization threshold - Added REST support for cartridge attributes when querying GET /v1/dataCartridges and GET /v1/diagnosticCartridges - Added RoE (REST over Ethernet) support for library firmware update, drive firmware update and restore configuration - Added support for TLS for Syslog - Added End of Call feature - Added code to report new event for syslog certificate expiration - Additional fixes (See fixlist) 1.10.0.2-A00 level includes: - Additional fixes (See fixlist) 1.10.0.1-B00 level includes: - Added REST support for managing logical libraries - Additional fixes (See fixlist) 1.10.0.0-F00 level includes: - 3592-70F (Jag7 FC) Drive Support - 3592-70S (Jag7 SAS) Drive Support - Added REST support for cartridge attributes when querying GET /v1/dataCartridges and GET /v1/diagnosticCartridges - Added REST support for temperature and humidity fields in accessor reports - Added REST support for session types and login events - Added REST support to configure syslog settings - Added REST error details to failed requests - Added REST support for library verify - Added RoS (REST over SCSI) support to modify ipv4 ethernet configuration - Added RoS support to query NTP and timezone settings for the library - Added RoS support to query password policy and session timeout values - Added RoS support to query, sessions, user accounts, and roles - Added RoS support to create local user - Added RoS support to update drive firmware - Added RoS support to update library firmware - Added RoS support to export, query and create drive logs - Added RoS support to query logical libraries and volser ranges - Added RoS support to modify user passwords and create new local users with permanent passwords - Added RoE (REST over Ethernet) support for GET requests - Added RoE support for PUT/POST - Added RoE support for save configuration and restore configuration - Added RoE support for export library logs and export drives logs - Added End of Call in web GUI - Added support to allow LDAP users to login with passwords up to 64 characters long - Added new operation column in web pages Drive and Drive by Logical Library - Added collection of cartridge attributes after unloading cartridge from drive - Added support for new cartridge attributes to mount history - Added support for save configuration and restore configuration on web GUI - Added temperature and humidity fields to accessor reports - Added support on cartridges page for including the resource type in location - Added descriptions for drive TapeAlerts in MIB file - Additional fixes (See fixlist) 1.9.0.0-F00 level includes: - Added REST cartridgeAccess attribute for 'GET /v1/library' - Added REST lastRestart attribute for 'GET /v1/nodesCards' - Added REST support for "timezone" attribute for 'GET /v1/library' - Added REST support for 'GET /v1/fcPorts' and 'GET /v1/sasPorts' - Added REST support for 'GET/v1/events/{ID}/fixProcedure' to query fix procedures based on event ID - Added REST support for 'GET/v1/ioStation' and 'GET/v1/ioStations/{location}' - Added REST support for 'PATCH /v1/library {"name": }' - Added REST destinationLocation parameter for workItems moveToSlot and moveToIOStation - Added REST new "unknown" state for node cards and drives when LCC is no longer communicating - Added REST serial number {sn} parameter for all POST/PATCH drive commands - Added REST stateReferenceEvent attribute for 'GET /v1/accessors' and 'GET /v1/accessors/' - Added REST support for 'GET /v1/powerSupplies' - Added REST support for 'PATCH /v1/library {"timezone": }' - Added REST support for power supply degraded in library status reporting - Added REST support to include snapshot logs in REST log file list - Added support for power supply degraded library state on Web - New event 0707 for power supply state change - Additional fixes (See fixlist) 1.8.0.0-C00 level includes: - 3588-F9C (LTO9 FC Multi Mode) Drive Support - 3588-F9S (LTO9 FC Single Mode) Drive Support - 3588-S9C (LTO9 SAS) Drive Support - 3592-60S (Jag6 SAS) Drive Support - TLS support for SKLM - REST support for accessor speed adjustment - REST support for moving cartridges (moveToSlot, moveToDrive and moveToIOStation) - REST support to request specific log files from the library - REST support for reporting frame door open/close transitions as attributes rather than states - REST support for querying the state of all slots or using a location parameter - REST support for scannerFailed state for Accessors resource - REST support for accessible attribute for Drive and Cartridges resources - REST support for internalAddress attribute for Cartridges resources and ability to move all cartridges types to I/O station - REST support for new tasks of calibrateFrame and calibrateLibrary - REST support for new attributes of GET /v1/reports/drives for drive clean - Additional fixes (See fixlist) 1.7.0.0-C00 level includes: - Support for rear door open detection and reporting (each frame requires plant feature code 4892) - Activity log on GUI System Summary - REST support for data cartridges, frames, and reports - Additional fixes (See fixlist) 1.6.0.0-B00 level includes: - 3592-60E (Jag6 Eth) Drive Support - REST over SCSI API - Additional fixes (See fixlist) 1.5.0.3-500 level includes: - Additional fixes (See fixlist) 1.5.0.2-A00 level includes: - Additional fixes (See fixlist) 1.5.0.1 level includes: - 3592-60F (Jag6 FC) Drive Support - 3588-F8S (LTO8 FC Single Mode) Drive Support - Additional fixes (See fixlist) 1.4.1.3 level includes: - New version of IBM-TS4500-MIBv2.mib - Additional fixes (See fixlist) 1.4.1.2 level includes: - Un-initialized M8 media and Pre-initialized M8 media is supported with a minimum LTO8 tape drive firmware level of HB82 - Additional fixes (See fixlist) 1.4.1.1 level includes: - LTO8 tape drive support - Pre-initiialized M8 media is supported with a minimum LTO8 tape drive firmware level of HB82 - Additional fixes (See fixlist) 1.4.0.1 level includes: - Additional fixes (See fixlist) 1.4.0.0 level includes: - 3592-55E Tape drive support - 3592-55F Tape drive support - Additional fixes (See fixlist) 1.3.0.5 level includes: - Additional fixes (See fixlist) 1.3.0.3 level includes: - Additional fixes (See fixlist) 1.3.0.1 level includes: - Dual Accessor support - Integrated Service Bays - Elastic Capacity support - New Flex track cable - TS7700 backend switch support - External TSSC Support - Additional fixes (See fixlist) 1.2.0.3 level includes: - Additional fixes (See fixlist) 1.2.0.2 level includes: - Additional fixes (See fixlist) 1.2.0.1 level includes: - Additional fixes (See fixlist) 1.2.0.0 level includes: - LTO7 tape drive support - 18 Frames supported (7 Dx5 maximum, 128 tape drives maximum) - Redeployment of S24 and S54 frames from TS3500 to TS4500 - Mixed LTO and 3592 media types (Not in the same frame) - SNMP query configuration - Ability to grow to the left - Additional fixes (See fixlist) 1.1.1.6 level includes: - Additional fixes (See fixlist) 1.1.1.5 level includes: - Additional fixes (See fixlist) 1.1.1.3 level includes: - Additional fixes (See fixlist) 1.1.1.1 level includes: - TS1150 (3592 EH8) support - Additional fixes (See fixlist) 1.1.0.5 level includes: - Additional fixes (See fixlist) 1.1.0.2 level includes: - High Density (HD2) L25, L55, D25, D55, S25, D25 frames - Integrated Management Console (IMC) - I/O Magazine - 4 frames maximum size (1 Lx5 maximum) - Single accessor only - Single media type (LTO or 3592) - LTO5, LTO6 and TS1140 tape drives supported SUPPORTED OPERATING SYSTEMS: This tape library works with the following operating systems: AIX, pSeries, xSeries, zSeries and Windows. For details on supported tape attachment please refer to the System Storage Interoperation Center website. http://www.ibm.com/systems/support/storage/config/ssic/ TROUBLESHOOTING: IBM Tape Diagnostic Tool (ITDT) provides the customer with functionality to perform maintenance tasks and run diagnostic tasks to determine tape device issues. This is available to download with the device driver. Support: Support for the following ITDT version: * ITDT-SE v9.6.2.20240425 (See ITDT limitations under Known Issues and Limitations section) * ITDT-GE v9.6.2.20231114 (See ITDT limitations under Known Issues and Limitations section) Support for the Following MIB Files: *Go to Fix Central under the TS4500 product and get the latest MIB file Known Issues and Limitations: - Brocade: Brocade HBAs, and their IBM version, do NOT support L-port topology. Direct attach configurations to our Tape Storage products is therefore NOT supported with these cards. - Brocade: Brocade HBA driver on Linux has to be installed manually by user, as it is not native on the operating system - CPF/DPF: Control Path and Data Path Failover is not supported when running devices connected to a single host server with HBAs that use different HBA drivers. - ITDT: For a complete list of ITDT Limitations and Known Issues, please refer to the Readme file and the "Device Driver Installation and User Guide" distributed with the software. - AIX / ITDT: AIX OS sets per default maximum size file to 1 GB. For execution of ITDT physical copy, from Tape to Image or from Image to Tape with files bigger than 1 GB, "ulimited -f unlimited" must be run before this operation. - LTO9 SAS drive supported only in Intel based servers - TS1170 SAS drive supported only in Intel based servers