MBS Agent for Microsoft Windows v. 6.82.3388 Issue Date 19 April 11 10
1 OVERVIEW This document contains release notes for the 6.82 Windows Agent 32-bit as well as the following Plug-Ins: Exchange 2003 DR and MAPI Plug-In Oracle Plug-In SQL Plug-In SharePoint Plug-In Cluster Plug-In This release is for use in combination with Remote or Windows Agent Console 6.82, and Vault 5.53, 6.04a, 6.21d, or later. Agent 6.82 supports BMR-type backup Jobs. For full BMR-type restores, SR (System Restore) software version 1.1 (or greater) is required. In these release notes, "Agent Console" without "Remote" or "Windows" in front means that it applies to both Remote and Windows Agent Console. If something applies to only one version, it will be noted. 1.1 Release History Version 6.81.3357, November 29th, 2010 Version 6.82.3388, February 28th, 2011 1.2 Supported Platforms This Agent is supported on the following Microsoft x86 platforms: - Windows XP Professional (SP3) - Windows Vista Home Basic (SP2) - Windows Vista Home Premium Edition (SP2) - Windows Vista Business Edition (SP2) - Windows Vista Ultimate Edition (SP2) - Windows Vista Enterprise Edition (SP2) - Windows 7 Starter (SP1) - Windows 7 Home Basic (SP1) - Windows 7 Home Premium (SP1) - Windows 7 Professional (SP1) - Windows 7 Enterprise (SP1) - Windows 7 Ultimate (SP1) - Windows Server 2008 Server Core (SP2) The Exchange Plug-In (DR, MAPI) is supported on the following platforms (including Cluster support).
Exchange Server 2003 (SP2) on the following platforms: - Windows Small Business Server 2003* (SP2) and R2 (SP2) * Note: Exchange DR only (MAPI is not supported on Windows Small Business Server) The Oracle Plug-In is supported on the following platforms. Oracle 9i on the following platforms: - Windows Server 2003 Standard, Enterprise (SP2) - Windows Server 2003 Standard, Enterprise R2 (SP2) Oracle 10g on the following platforms: - Windows Server 2003 Standard, Enterprise 2003 (SP2) - Windows Server 2003 Standard, Enterprise R2 (SP2) - Windows Server 2008 Standard, Enterprise (SP2) Oracle 11g on the following platforms: - Windows Server 2003 Standard, Enterprise (SP2) - Windows Server 2003 Standard, Enterprise R2 (SP2) - Windows Server 2008 Standard, Enterprise (SP2) The SQL Plug-In is supported on the following platforms (including Cluster support). SQL Server 2000 (SP4) on the following platforms: SQL Server 2005 (SP3) on the following platforms: SQL Server 2008 (SP2) on the following platforms: SQL Server 2008 R2 is supported on the following platforms:
The SharePoint Plug-In is supported on the following platforms (including Cluster support). SharePoint Portal Server 2003 on the following platforms: Microsoft Office SharePoint Server 2007 on the following platforms: Windows SharePoint Services (WSS) 3.0 (SP2) on the following platforms: 2 NEW FEATURES Support for backup and restore of data on GPT drives (BMR not supported). 3 INSTALLATION NOTES 3.1 Windows Agent 6.82 32-bit 3.1.1 Installation Requirements * A computer running one of the supported operating systems listed in Section 1.2 * CPU and RAM to meet the basic requirements of your operating system, as prescribed by Microsoft * 16-bit (or greater) video properties for optimal GUI display * Windows Internet Explorer 6 (or greater) * A TCP/IP stack (for communicating with the Vault, Agent, and Agent Console software) * At least 100 MB of free disk space for a new
installation. An upgrade may require more. If there is not enough disk space, the application will issue a message. Also, for this installation, the system drive requires free space to decompress the package (regardless of which drive the installation targets). The actual amount of space will vary, but a recommended amount of 100 to 200 MB should suffice. The environment variables TEMP and TMP use %USERPROFILE% by default. Make sure that this variable points to a drive that has sufficient temporary space. This release is for use in combination with Remote or Windows Agent Console 6.82, and Vault 5.53, 6.04a, 6.21d, or later. 3.1.2 Conditional Requirements * You require.net Framework 2.0 if you install the Agent Assistant with the Agent. * DO NOT INSTALL the Agent in a Windows-encrypted directory. Exclude installation directories (as well as anti-virus directories) from open-file protection. Note: If you use an anti-virus (AV) program, disable real-time scanning on reads (called "outgoing" on some AV products). Do not back up the actual AV directories. In order to graphically configure and administer the Agent, you need to install Agent Console on a networkconnected Windows system. To manage an Agent from both Windows Agent Console and Remote Agent Console, you must install them using the same service-account user identities. That is, the "Software BUAgent" and "Software Agent" service accounts must be the same. Otherwise, the BUAgent will not be able to provide status or administration functions. The accounts under which services run appear in the VVAgent and BUAgent logs. 3.1.3 Licensing To backup and restore data to/from a data-protection vault, you need a valid account, user name and password. Contact your Service Provider to obtain the required information. 3.1.4 Install/Uninstall/Upgrade
Included application File List The 32-bit Agent kit installs: 6.82.3388 buagent.exe 6.82.3388 - VV.exe 6.82.3388 VVAgent.exe 6.82.3388 - VVExch.dll 6.82.3388 - VVExchMapi.dll 6.82.3388 - SharePointPlugin.dll 6.82.3388 - SQLSvr70.dll 6.82.3388 - OraPlugin.dll * Agent software (VVAgent or BUAgent) Note: The Agent installation will place the file VVClMsg.dll in the System directory. This file contains the error codes and resource strings that the event viewer uses to display Agent messages. 3.2 Plug-Ins Exchange DR (VSS) and MAPI Plug-In For information regarding LCR, SCR, and CCR support, refer to the section about the Cluster Plug-In. Oracle Plug-In "Oracle Instant Client Support for Windows" is required. Instant Client Support is supplied (from the download web site) as a separate component from the Plug-In. It must be installed separately by the user. The installation will provide a warning to install Instant Client Support if it is not already installed. If you install the Oracle Plug-In, you must also install the "Oracle Instant Client Support for Windows" after the Windows 32-bit Agent has been installed. This is a separate InstallShield installation, not included as part of the Agent installation, and must be run separately. SQL Plug-In This version of the Plug-In supports the Microsoftdefined Virtual Backup Device Interface (VDI). Note: For Microsoft SQL Server 2008 (SP2), the Plug-In requires the SQL-DMO component, which was removed from Microsoft SQL Server 2008. You need to install the
"Microsoft SQL Server 2005 Backward Compatibility Components" package. A download is available at: http://www.microsoft.com/downloads/details.aspx?familyid=c6c3e9ef-ba29-4a43-8d69- A2BED18FE73C&displaylang=en Note: Microsoft SQL Server 2008 installs a 2008 version Native Client by default. This 2008 default version is not supported. You must install the Microsoft SQL Server 2005 Native Client. SharePoint Plug-In SQL Server Native Client is required. SharePoint Plug-In backup jobs that use multiple, separate SQL Servers are not supported. That is, you cannot have SharePoint environments that use different SQL Server instances to host the various SharePoint databases. Cluster Plug-In This version of the Plug-In supports SQL Server 2008 (SP2). Install it as part of the Agent: 1. Install Agents and Plug-Ins on Physical Nodes. 2. Configure Cluster, Exchange, or SQL Plug-Ins on the Physical Nodes. 3. Create a new Agent for your Cluster on the Virtual Node using the IP address or host name. 4. From the newly created Agent, double-click the Global file to open the "Virtual server shared area" window. From here, select a drive letter for your Cluster, and then click OK. This will open the Agent Configuration Window. 5. Here you must specify your Vault connection information. Click OK to finish. 4 KNOWN ISSUES and FIXES 4.1 Fixes in This Release "Synchronizing Agent to Base Vault fails with error "Cannot find target Vault". This has been fixed in this release. (20348) Windows Backup Error: "SS -E-05803 VRegistry::Initialize () error reading HKEY_LOCAL_MACHINE\SYSTEM\CurrentControl Set\Control\hivelist\\REGISTRY\USER\S-1-5-21-1482476501-
746137067-1957994488-3140". This has been fixed in this release. (20262) Agent not backing up folders within a mount point/drive. Error message O/S message: The filename or extension is too long. This has been fixed in this release. (20259) Exchange2007 VSS: the timeout of powershell command needs to be extended. This has been fixed in this release. (20226) BMR Backup Fails with "ENVC-E-04096 Get drive layout of drive \\.\PhysicalDrive1 failed error=2 0x2" and "ENVC-E-04096 CaptureSystemRestorePointInfo Env Exception: Failed to get GPT drive info". This has been fixed in this release. (20210) LVR 1:1 - agent restore from passive incorrectly "The Vault at <agent connection ip> has delegated the operation.". This has been fixed in this release. (20148) DPM backup to local disk fails with error DPM -E-8848 replica can not be backed up at this time: "Volume D:" on "nb01bh01.crb.local" Protection Group "Daily Snapshot - Files". This has been fixed in this release. (20142) Base vault does not allow restores directly. This has been fixed in this release. (20133) Remote Agent Console Agent kit management cosmetic error. This has been fixed in this release. (20080) Numerous 6.81 Windows Agents Show Offline in Remote Agent Console. This has been fixed in this release. (20064) System State backup fails with VSS -E-05563 GetVolume MountPointW() failed for i:\jdedwards (OS error: ) This has been fixed in this release. (20007) Multiple Agents have DTA file corruption; Synchronize Often Does Not Rebuild DTA. This has been fixed in this release. (20003) System State Backup Fails with NONE-E-05548 VsscBackup: :getsnapshotpath internal error - failed to map volume Volume{6de50b63-f290-11df-8769-005056946059}. This has been fixed in this release. (19979)
Win 2008 Server Becomes Unresponsive During Backup and must be Rebooted. This has been fixed in this release. (19991) BUAgent consumes large amount of memory. This has been fixed in this release. (19220) Agent gets stuck in reconnection with Vault. This has been fixed in this release. (19717) Agent core dumps when it restores from an offline safeset (detached Secondary Storage). This has been fixed in this release. (18776) 4.2 Known Issues The Agent does not backup and recover a file's hardlink when located in a folder mounted on another partition. A restore does not contain the hardlink information and restores actual files. (20475) When selecting databases for a backup in Exchange 2003 (with Windows Agent Console or Remote Agent Console) the version and build beside the server name may show up as an Exchange 2000 Version and Build. This is a cosmetic problem which may occur if two Exchange servers are registered in the same Active Directory, and the first one is Exchange 2003, and the second one is Exchange 2010. (19526) Unable to create a BMR-type backup Job on Windows 7 when an active "OEM Partition" exists. WORKAROUND: Set the "primary partition" to active, which should contain boot, page file, crash dump attributes. (18391) Restoring Exchange databases to an alternate location fails for a fully qualified file name greater than 260 characters, and directory names greater than 248 characters. Alternate location restores with names and directories that are shorter will succeed. (18292) BMR-type backup Job failed with " Failed to initialize BMRCaptureEnvInfo.dll:... failed to Capture System Restore Point Info". Workaround: If you failover manually (move the cluster apps through the GUI) then you need to restart the passive node machine. This is only for a Windows 2003 cluster environment. It works correctly with a Windows 2008 cluster. (18002) Verifying the MAPI Profile as a user with administrator
rights (but not as the user "Administrator") Agent installation folder locked by UAC will show "failed to load ex2000.dll". You can still connect to the Agent, create Jobs, but when you try to test the MAPI Profile as that user, it will fail. WORKAROUND: Add your user to the group to grant permission to access the Agent folder. Retry the MAPI Profile test. (17957) Exchange VSS backups may fail when third party Shadow Copy Providers exist on the system. WORKAROUND: user can set registry to force select system provider: HKEY_LOCAL_MACHINE\SOFTWARE\<service provider>\agent\ UseSystemVSSProvider = 1 (DWORD) (17805) Mount point data is not backed up when a backup selection exists above the mount point in a directory. In other words, if a backup selection contains a mount point in a sub-directory, the data recursive to the mount point is not backed up. RECOMMENDATION: To back up a mount point and its data contents, create a separate Job for this selection. (17192) 5 PRODUCT SUPPORT 5.1 Technical Support Complete contact information for your provider is available through the Help Support menu in Agent Console. 5.2 Product Updates Product updates are available from your provider's web site. 5.3 Documentation This documentation is available for the Agent: Agent for Windows User's Guide Agent Release Notes (this document) Windows Agent Console Operations Guide (and help) Remote Agent Console help Agent Plug-In guides All documentation is available at from your service provider.