EVault Agent for Solaris Version 5.02.2023 Release Notes - March 9th, 2006 _______________________________________________________________ =============================================================== Contents 1 Overview 1.1 Release History and Changes 2 Features 3 Fixes 4 Known Issues 5 Installation Notes 5.1 Installation Requirements 5.2 Install/Uninstall Procedure 5.3 Configuration 6 Product Support 6.1 Technical Support 6.2 Product Updates 6.3 Documentation 7 Legal Information _______________________________________________________________ =============================================================== 1 OVERVIEW This document contains release notes for the latest release of the Agent for Solaris. This Agent is supported on the following platforms: Solaris 7 (with patch 106327-14), and Solaris 8 and 9. The Agent software kit consists of two programs, "VV" and "VVAgent". VVAgent is the (daemon) agent program, while VV is a command line program used to perform such tasks as backup, restore, re-synch and other requests. --------------------------------------------------------------- 1.1 Release History and Changes for Agent version 5.00 December 28th, 2004 - First release, version 5.00.1681 February 9th, 2005 - Second release, version 5.01.1747 March 9th, 2006 - Third release, version 5.02.2023 _______________________________________________________________ =============================================================== 2 FEATURES 2.1 Encrypted communication between CentralControl and Agents All communication between the CentralControl and the Agents is now encrypted with the AES encryption algorithm with a cipher strength of 128 bits. This encryption runs silently. --------------------------------------------------------------- 2.2 Backup options can now be configured for different compression schemes: None, Minimum, Normal, Better, or Maximum. These choices allow the user to optimize the volume of data sent against the speed of transmission. _______________________________________________________________ =============================================================== 3 FIXES for version 5.02.2023 3.1 DTS#6693 Solaris Agent 5.01 can core-dump when trying to create a task on a multi-tape system with CentralConrtol. This has been fixed in this release. --------------------------------------------------------------- FIXES for version 5.01.1747 3.2 Task fails when filename path is more than 512 characters. This has been changed in this release so that the task will not fail but a warning will be placed in the log about the offending long filename path. --------------------------------------------------------------- 3.3 Modification of an Oracle Plug-in task in the 5.00 CentralControl with 5.00 Solaris Agent would result in a forced task re-registration. This has been fixed in version 5.01.1703. Note: The Oracle Plug-in 5.01 must be used with Solaris Agent version 5.01 and up. The Oracle Plug-in will not work with Solaris Agent 5.00. _______________________________________________________________ =============================================================== 4 KNOWN ISSUES 4.1 Under Solaris, VVAgent may report the following error messages if the kernel tunable parameters are not set correctly: - PROG-E-0003 O/S error: Too many open files - error opening file /usr/local//Test/SYNCH.MIR for output - SSET-E-0111 error committing synchronization data - error opening file /usr/local//Test/00000004.CAT for output - SSET-E-0005 O/S error: No space left on device (when file system has sufficient amount of space) This problem occurs because of the limit on the number of shared memory segments, semaphores or file descriptors per process. Those are configurable parameters in the Solaris kernel, which the user should change. To increase the default setting follow these steps: (Note: If the settings are already set to larger values, then leave them intact.) 1) Become superuser. 2) Add the following lines to /etc/system: (if a setting already exists, increase it accordingly) set shmsys:shminfo_shmmni=200 set shmsys:shminfo_shmseg=200 set semsys:seminfo_semmni=200 set semsys:seminfo_semmns=5000 set semsys:seminfo_semmap=5000 set rlim_fd_cur=256 3) Verify the kernel parameter has changed by doing: grep shmsys /etc/system grep semsys /etc/system 4) Reboot the system. --------------------------------------------------------------- 4.2 For a backup or restore task on an NFS system to succeed you need to have proper permissions to read, write, and create files and directories on the mounted Network File System. This includes the remote system allowing operations for an anonymous user. A good test is to try it from the command line first. If you cannot read/write/create files and directories on NFS manually, then the backup and restore also will not work. This issue applies to all Unix platforms. --------------------------------------------------------------- 4.3 If you are upgrading to 5.x and the upgrade is not successful, the install process will roll everything back to the pre-install state. However, the Agent does not automatically start up again. You can start it manually. In the event of an upgrade failure, the log file will be found under a directory called: .UpgradeFailure. --------------------------------------------------------------- 4.4 Solaris only validates the first 8 characters of a password (you may enter more). Thus, the Agent password to access the server should only be a maximum length of 8 characters. --------------------------------------------------------------- 4.5 Solaris may be configured to have its swap file on the /tmp directory. If the tmp directory becomes full with other tasks, the Agent may fail with a core dump. This may occur even if there is enough physical memory available. The administrator should ensure that the /tmp directory has sufficient space, or that other high-memory tasks are not running when a backup is running. --------------------------------------------------------------- 4.6 After upgrading the Unix agent from versions 3.x, 4.x, to 5.x the DTX files are deleted. WORKAROUND: Run another backup of that task and then the DTX files will be recreated. A warning will be sent to the backup log about the missing DTX file. --------------------------------------------------------------- 4.7 The Oracle Plug-in 5.01 must be used with Solaris Agent version 5.01 and up. The Oracle Plug-in will not work with Solaris Agent 5.00. _______________________________________________________________ =============================================================== 5 INSTALLATION NOTES 5.1 Installation Requirements The installation requirements for the Agent program are as follows: Hardware * CPU - Ultrasparc * RAM - A minimum of 512 MB. Software * EVault Director version 5.00 * EVault CentralControl version 5.00 * OS - Solaris 7 or 8 or 9 (Note: Solaris 7 needs Patch 106327-14 or greater) * Network - A TCP/IP stack (to communicate with Client Agent systems) --------------------------------------------------------------- 5.2 Install/Uninstall Procedure All EVault products have appropriate installation guides. The guides are located at: http://support.EVault.com --------------------------------------------------------------- 5.3 Configuration Each machine to be backed up must have the Agent software installed and subsequently configured with CentralControl. See the CentralControl User's Guide for detailed information. This guide is available at: http://support.EVault.com _______________________________________________________________ =============================================================== 6 PRODUCT SUPPORT 6.1 Technical Support Complete contact information for your provider is available under the Help Support menu. --------------------------------------------------------------- 6.2 Product Updates Product updates are available from your provider's web server site. --------------------------------------------------------------- 6.3 Documentation The documentation available for the Agent is as follows: The Agent for Unix Guide The CentralControl User's Guide The Agent Release Notes (this document) All documentation is available at the following location on the EVault site: http://support.EVault.com _______________________________________________________________ =============================================================== 7 LEGAL INFORMATION Software License Agreement - Agent Software This legal document is an agreement between you, the end user, and the licensor (herein referred to as "licensor"). BY INSTALLING THIS AGENT SOFTWARE PRODUCT, YOU ARE CONSENTING TO BE BOUND BY THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS AGREEMENT, UNINSTALL THIS PRODUCT AND RETURN IT TO THE PLACE OF PURCHASE FOR A FULL REFUND. AGENT FOR SOLARIS SOFTWARE LICENSE 1. GRANT OF LICENSE. In consideration of your payment of the license price to an authorized Dealer, as Licensor, grants to you, the Licensee, a non-exclusive right to use and display this copy of the Agent software program (hereinafter the "Software") on specific computer(s) at your location(s). The licensor reserves all rights not expressly granted to Licensee. If you have not paid a license fee for the Software, then the licensor grants to you the right to use the Software ONLY for evaluation or educational purposes. This latter grant specifically excludes production use of the Software. 2. OWNERSHIP OF SOFTWARE. As the Licensee, you own the magnetic or other physical media on which the software is originally or subsequently recorded or fixed, but the licensor retains title and ownership of the Software recorded on the original media and all subsequent copies of the Software, regardless of the form or media in or on which the original and other copies may exist. This license is not a sale of the original Software or any copy. 3. COPY RESTRICTION. This Software and the accompanying written materials are copyrighted. Unauthorized copying of the Software, including Software that has been modified, merged, or included with other software, or of the written materials is expressly forbidden. You may be held legally responsible for any copyright infringement that is caused or encouraged by your failure to abide by the terms of this license. 4. USE RESTRICTIONS. You may not modify, adapt, translate, reverse engineer, decompile, disassemble, or create derivative works based on the Software. You may not modify, adapt, translate, or create derivative works based on the written materials without the prior consent of the licensor. 5. TRANSFER RESTRICTIONS. This Software is licensed only to you, the Licensee, and may not be transferred to anyone without prior written consent of the licensor. Any authorized transferee of the Software shall be bound by the terms and conditions of this agreement. In no event may you transfer, assign, rent, lease, sell, or otherwise dispose of the Software on a temporary or permanent basis as expressly provided herein. 6. TERMINATION. This license is effective until terminated. This license will terminate automatically without notice from the licensor if you fail to comply with any provision of this license. Upon termination you shall destroy the written materials and all copies of the Software, including modified copies, if any, and certify in writing that all copies have been destroyed. 7. WARRANTY AND MAINTENANCE. The licensor warrants the Software to perform substantially in accordance with the User Documentation, as amended from time to time, and will maintain, modify, repair or replace the Software during the ninety (90) day warranty period, at no additional cost to the Licensee. The licensor does not warrant that the use of the Software will be uninterrupted or error free. The licensor will provide Support Services to customers that have paid the qualifying support fee. The Support Services include product maintenance and shall entitle the customer to; telephone support for troubleshooting, user guidance, and problem corrections and all product fixes and new minor releases via a World Wide Web site. 8. INDEMNIFICATION. Licensor will defend at its own expense any action against Licensee brought by a third party to the extent that the action is based upon a claim that the Licensed Software infringes any U.S. copyrights or misappropriates any trade secrets recognized as such under the Uniform Trade Secret law, and Licensor will pay those costs and damages finally awarded against Licensee in any such action that are specifically attributable to such claim or those costs and damages agreed to in a monetary settlement of such action. The foregoing obligations are conditioned on Licensee notifying Licensor promptly in writing of such action, Licensee giving Licensor sole control of the defense thereof and any related settlement negotiations, and Licensee cooperating and, at Licensor's request and expense, assisting in such defense. 9. LIMITATION OF LIABILITY. Subject to paragraph 8, the licensor, nor any authorized Vault Service Provider of the Software, will not be liable for any damages including any loss of data, profits or savings, claims against Licensee by any other party or any other incidental or consequential damages arising out of Licensee's use of, or inability to use the software, even if the licensor (or such Dealer) is advised of the possibility of such damage. Subject to paragraph 8 above, the Licensee agrees that the licensor's (or such Dealer's) liability under this License shall not exceed the License fees paid by the Licensee for the software licensed hereunder. 10. MISCELLANEOUS. This agreement is governed by the laws of the State of Delaware and venue in any suit arising hereunder shall be Wilmington, Delaware USA. Should you have any questions regarding this Agreement, please contact us in writing at the address shown in your software license agreement. _______________________________________________________________ ===============================================================