Computer Associates BABWBN2900E20 - BRIGHTSTOR ARC BACKUP V9... User manual

CA ARCserve®Backup for
Windows
Agent for VMware Guide
r12

This documentation and any related computer software help programs (hereinafter referred to as the
“Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by CA at
any time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in
part, without the prior written consent of CA. This Documentation is confidential and proprietary information of CA
and protected by the copyright laws of the United States and international treaties.
Notwithstanding the foregoing, licensed users may print a reasonable number of copies of the Documentation for
their own internal use, and may make one copy of the related software as reasonably required for back-up and
disaster recovery purposes, provided that all CA copyright notices and legends are affixed to each reproduced copy.
Only authorized employees, consultants, or agents of the user who are bound by the provisions of the license for
the Product are permitted to have access to such copies.
The right to print copies of the Documentation and to make a copy of the related software is limited to the period
during which the applicable license for the Product remains in full force and effect. Should the license terminate for
any reason, it shall be the user’s responsibility to certify in writing to CA that all copies and partial copies of the
Documentation have been returned to CA or destroyed.
EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, TO THE EXTENT PERMITTED BY
APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING
WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY
LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT
LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY
ADVISED OF SUCH LOSS OR DAMAGE.
The use of any product referenced in the Documentation is governed by the end user’s applicable license
agreement.
The manufacturer of this Documentation is CA.
Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the
restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-
7014(b)(3), as applicable, or their successors.
All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
Copyright © 2008 CA. All rights reserved.

CA Product References
This documentation set references the following CA products:
■Advantage™ Ingres®
■BrightStor®ARCserve®Backup for Laptops and Desktops
■BrightStor®CA-1®Tape Management
■BrightStor®CA-Dynam®/B Backup for VM
■BrightStor®CA-Dynam®/TLMS Tape Management
■BrightStor®CA-Vtape™ Virtual Tape System
■BrightStor®Enterprise Backup
■BrightStor®High Availability
■BrightStor®Storage Resource Manager
■BrightStor®VM:Tape®
■CA ARCserve®Backup Agent for Novell Open Enterprise Server for Linux
■CA ARCserve®Backup Agent for Open Files on NetWare
■CA ARCserve®Backup Agent for Open Files on Windows
■CA ARCserve®Backup Client Agent for FreeBSD
■CA ARCserve®Backup Client Agent for Linux
■CA ARCserve®Backup Client Agent for Mainframe Linux
■CA ARCserve®Backup Client Agent for NetWare
■CA ARCserve®Backup Client Agent for UNIX
■CA ARCserve®Backup Client Agent for Windows
■CA ARCserve®Backup Enterprise Option for AS/400
■CA ARCserve®Backup Enterprise Option for Open VMS
■CA ARCserve®Backup for Microsoft Windows Essential Business Server
■CA ARCserve®Backup for Windows
■CA ARCserve®Backup for Windows Agent for IBM Informix
■CA ARCserve®Backup for Windows Agent for Lotus Domino
■CA ARCserve®Backup for Windows Agent for Microsoft Data Protection
Manager
■CA ARCserve®Backup for Windows Agent for Microsoft Exchange
■CA ARCserve®Backup for Windows Agent for Microsoft SharePoint

■CA ARCserve®Backup for Windows Agent for Microsoft SQL Server
■CA ARCserve®Backup for Windows Agent for Oracle
■CA ARCserve®Backup for Windows Agent for Sybase
■CA ARCserve®Backup for Windows Agent for VMware
■CA ARCserve®Backup for Windows Disaster Recovery Option
■CA ARCserve®Backup for Windows Disk to Disk to Tape Option
■CA ARCserve®Backup for Windows Enterprise Module
■CA ARCserve®Backup for Windows Enterprise Option for IBM 3494
■CA ARCserve®Backup for Windows Enterprise Option for SAP R/3 for
Oracle
■CA ARCserve®Backup for Windows Enterprise Option for StorageTek
ACSLS
■CA ARCserve®Backup for Windows Image Option
■CA ARCserve®Backup for Windows Microsoft Volume Shadow Copy
Service
■CA ARCserve®Backup for Windows NDMP NAS Option
■CA ARCserve®Backup for Windows Serverless Backup Option
■CA ARCserve®Backup for Windows Storage Area Network (SAN) Option
■CA ARCserve®Backup for Windows Tape Library Option
■CA XOsoft™ Assured Recovery™
■CA XOsoft™
■Common Services™
■eTrust®Antivirus
■eTrust®Firewall
■Unicenter®Network and Systems Management
■Unicenter®Software Delivery
■Unicenter®VM:Operator®

Contact CA
Contact Technical Support
For online technical assistance and a complete list of locations, primary service
hours, and telephone numbers, contact Technical Support at
http://ca.com/support.
Provide Feedback
If you have comments or questions about CA product documentation, you can
send a message to [email protected].
If you would like to provide feedback about CA product documentation, please
complete our short customer survey, which is also available on the CA Support
website.

Contents
Chapter 1: Introducing the Agent 9
Introduction................................................................................... 9
How to Administer Virtual Machines to Manage Backup Operations ................................ 9
How VMware Consolidated Backup Works ...................................................... 11
VCB Limitations .............................................................................. 13
How the Agent Protects VMs that Reside on Local Storage and a SAN ............................ 14
Chapter 2: Installing and Configuring the Agent 15
How to License the Agent for VMware .......................................................... 15
Installation Prerequisites ...................................................................... 16
How to Install and Configure the Agent ........................................................ 16
Register vcb_com.dll on 32-bit Systems .................................................... 17
Register vcb_com.dll on 64-bit Systems .................................................... 17
Install the Agent Using the Server Admin ...................................................... 19
Set Up Backing Up ESX Server Systems Using a Backup Proxy System ........................... 19
Configure ESX Server 3.0.2 Systems ....................................................... 20
Configure ESX Server 3.5 Systems......................................................... 23
Configure ESX Server 3i Systems .......................................................... 26
Configure VirtualCenter Server 2.0.2 Systems .............................................. 28
Configure VirtualCenter Server 2.5 Systems ................................................ 32
Configure the Agent to Perform Full Backups in Full VM (Raw) Mode and Daily Incremental and
Differential Backups in File Mode .............................................................. 34
Populate the CA ARCserve Backup Database Using the ARCserve VMware Configuration Tool ...... 35
Populate the CA ARCserve Backup Database Using the ca_vcbpopulatedb Command Line Utility ... 39
Create a ca_vcbpopulatedb Configuration File............................................... 42
Examples ................................................................................ 44
ca_vcbpopulatedb Utility Return Codes ..................................................... 45
When to Populate the ARCserve Database ...................................................... 46
Configure the Agent to Protect VMs that Reside on a SAN ....................................... 46
Uninstall the Agent ........................................................................... 48
Chapter 3: Backing Up and Restoring Data 49
How to Browse Backup Volumes ............................................................... 49
Backup Modes ................................................................................ 51
Back Up Data ................................................................................ 53
How the Agent Supports the Preflight Check Utility .......................................... 55
Contents 7

8 Agent for VMware Guide
Filter VM Backup Data ........................................................................ 56
How to Browse Restore Sessions .............................................................. 57
Restoring Data ............................................................................... 59
Restore File-Level Data.................................................................... 59
Restore Raw (Full VM) Level Data to ESX Server 3.0.x and ESX Server 3.5 Systems........... 62
Restore Raw (Full VM) Level Data to ESX Server 3.5 and ESX Server 3i Systems Using the VMware
Converter ................................................................................ 67
VCB Backup and Restore Limitations ........................................................... 68
Appendix A: Troubleshooting 71
VM Mount Operation Fails ..................................................................... 71
VM Unmount Operation Fails .................................................................. 73
The ARCserve VMware Configuration Tool or the ca_vcbpopulatedb Utility Fails ................... 73
Index 75

Chapter 1: Introducing the Agent
This section contains the following topics:
Introduction (see page 9)
How to Administer Virtual Machines to Manage Backup Operations (see page
9)
How VMware Consolidated Backup Works (see page 11)
VCB Limitations (see page 13)
How the Agent Protects VMs that Reside on Local Storage and a SAN (see page
14)
Introduction
CA ARCserve Backup is a comprehensive storage solution for applications,
databases, distributed servers, and file systems. It provides backup and
restore capabilities for databases, business-critical applications, and network
clients.
Among the agents CA ARCserve Backup offers is the CA ARCserve Backup
Agent for VMware. VMware provides you with a mechanism called VMware
Consolidated Backup (VCB) that is integrated with VMware ESX Server and
VMware VirtualCenter Server. VCB lets you protect Virtual Machine (VM) files
and data. Using VCB you can offload VM backup activity to a dedicated backup
proxy system, and then use the backup and restore functionalities provided by
CA ARCserve Backup to protect Virtual Machines.
How to Administer Virtual Machines to Manage Backup
Operations
The agent lets you back up data and it works best under the following
circumstances:
■You want to reduce resource restraints in the ESX Server system.
Note: VMware ESX Server is an application that manages system, storage,
and network resources in multiple VM environments.
■You do not want to deploy a backup agent on your VMs.
■Your environment consists of VMs residing on different types of data
stores.
■You need to restore data at the file level or raw (full VM) level.
Chapter 1: Introducing the Agent 9

How to Administer Virtual Machines to Manage Backup Operations
VCB lets you perform the following administrative tasks:
■Take a snapshot of a VM and mount or export the backup data to one or
more backup proxy systems and remove the load from the ESX Server
system.
■Perform file level backups and restores of a VM running any VMware-
supported Windows-based operating system.
■Perform raw (full VM) level backups and restores of a VM running any
VMware-supported operating system.
■Perform LAN-free (Local Area Network) backups, if the VMs reside on a
SAN.
■Back up a VM, regardless of its power state.
■Reduce administration overhead by centralizing backup management on
backup proxy systems. You do not need to deploy agents on the VMs.
Note: This capability requires you to install the CA ARCserve Backup Client
Agent for Windows on the backup proxy system.
10 Agent for VMware Guide

How VMware Consolidated Backup Works
How VMware Consolidated Backup Works
The agent lets you perform raw VM (full VM) and file level VM backups using a
backup proxy system.
The following diagram illustrates the network architecture for backing up VM
images or files using a backup proxy system:
Chapter 1: Introducing the Agent 11

How VMware Consolidated Backup Works
When you deploy this architecture in your environment, consider the following:
■Microsoft .NET Framework Version 2.0 or higher must be running on the
backup proxy system.
■If the VM resides on a SAN LUN, the LUN must be shared between the ESX
Server system and the backup proxy system and have the same LUN
number assigned. The LUN in the backup proxy system should not be
signed.
Note: To obtain the latest information about this configuration, see the
VMware VCB documentation.
■The raw (full VM) level backup method makes a copy of all of the disk and
configuration files associated with a specific VM, letting you restore the
entire VM.
You can use this method for disaster recovery operations.
■The file level backup method lets you make a copy of individual files
contained on the disk in a VM, which can include all files.
You can use this method for situations that involve restoring files that
were corrupted or accidentally deleted.
■When you submit a backup job, you can perform a raw (full VM) level or
file level backup of the VM. You must specify the primary or member
server where the job will execute.
Important! To perform file level backups of a VM, a VMware-supported
Windows operating system must be installed on the VM.
When the backup job is running, the primary or member server
communicates with the Client Agent for Windows that is running on the
backup proxy system. The Client Agent for Windows then takes a snapshot
of the VM and mounts or exports the snapshot into the backup proxy
system, by default, into the Client Agent for Windows installation
directory.
Note: For information about changing the default mount path, see Set Up
Backing Up ESX Server Systems Using a Backup Proxy System.
The Client Agent for Windows then replaces the root directory and creates
the CA ARCserve Backup database records as if the backup was taken
directly from the VM. This behavior ensures that you can perform file level
restores to the original VM location.
More information:
Set Up Backing Up ESX Server Systems Using a Backup Proxy System (see
page 19)
12 Agent for VMware Guide

VCB Limitations
VCB Limitations
When you use VCB in your environment, consider the following limitations:
■You cannot back up VMs with virtual disks that are physically compatible
Raw Device Maps (RDM), Independent - persistent and Independent non-
persistent disks.
■To back up VMs stored on a SAN storage LUN, the LUN should be
accessible to the backup proxy system, and have the same LUN number
assigned. The LUN in the backup proxy system should not be signed.
Note: To obtain the latest information about this configuration, see the
VMware VCB documentation.
■To back up an individual file or directory, a VMware-supported Windows-
based operating system must be running on the VM.
■VCB supports mounting up to 60 concurrent VM volumes.
Examples: Mounting Concurrent VMware Volumes
■60 VMs with one C:\ drive
■30 VMs with two VM volumes: one C:\ drive and one D:\ drive
■VCB does not support the use of non-English, multibyte characters. Paths
and registry strings that consist of non-English, multibyte characters may
not display properly.
Note: For information about how to install VCB, set up VCB, and the
limitations of using VCB, see the VMware Virtual Machine Backup Guide on the
VMware website.
Chapter 1: Introducing the Agent 13

How the Agent Protects VMs that Reside on Local Storage and a SAN
14 Agent for VMware Guide
How the Agent Protects VMs that Reside on Local Storage
and a SAN
The CA ARCserve Backup Agent for VMware lets you protect VMware-based
data that resides on local storage and on a storage area network (SAN). For all
data store types, the VMs must be accessible from the backup proxy system.
The list that follows describes the environment configuration requirements for
each of the data store types:
■SAN, iSCSI Data Stores--The backup proxy system must be attached to
the same disk where the VM resides and must be attached using the same
SAN, iSCSI infrastructure.
■Local Storage Data Stores--The VMs must reside on disks that are
attached directly to the ESX Server system. With local storage
environments, the backup proxy system should be able to communicate
with the ESX Server system via the LAN.
Note: The terms SAN/iSCSI are used to denote shared storage between Proxy
and ESX Server Systems.Wherever SAN is mentioned is also applicable to
iSCSI environments where Disks are shared using iSCSI infrastructure.
When you implement the agent with VI 2.5, the process of populating the CA
ARCserve Backup database using the ca_vcbpopulatedb Command Line Utility
or the ARCserve VMware Configuration Tool lets CA ARCserve Backup
configure the agent to detect the data store types of the VMs in your
environment.
However, if the VMs reside on a SAN, and the backup proxy system is not
attached to the same SAN, you must modify an .ini file labeled
VMDatastoreTypes.ini that contains the data store types detected by CA
ARCserve Backup when you populate the CA ARCserve Backup database. CA
ARCserve Backup creates the VMDatastoreTypes.ini file in the Client Agent for
Windows installation directory. By default, the CA ARCserve Backup Client
Agent for Windows is installed in the following directory:
C:\Program Files\CA\ARCserve Backup Client Agent for Windows
Note: For information about how to modify VMDatastoreTypes.ini to protect
VMs that reside on a SAN, see Configure the Agent to Protect VMs that Reside
on a SAN (see page 46).

Chapter 2: Installing and Configuring
the Agent
This section contains the following topics:
How to License the Agent for VMware (see page 15)
Installation Prerequisites (see page 16)
How to Install and Configure the Agent (see page 16)
Install the Agent Using the Server Admin (see page 19)
Set Up Backing Up ESX Server Systems Using a Backup Proxy System (see
page 19)
Configure the Agent to Perform Full Backups in Full VM (Raw) Mode and Daily
Incremental and Differential Backups in File Mode (see page 34)
Populate the CA ARCserve Backup Database Using the ARCserve VMware
Configuration Tool (see page 35)
Populate the CA ARCserve Backup Database Using the ca_vcbpopulatedb
Command Line Utility (see page 39)
When to Populate the ARCserve Database (see page 46)
Configure the Agent to Protect VMs that Reside on a SAN (see page 46)
Uninstall the Agent (see page 48)
How to License the Agent for VMware
The CA ARCserve Backup Agent for VMware uses a count-based licensing
method. You must register one CA ARCserve Backup Agent for VMware license
for each ESX Server system that is running in your VMware environment. The
licenses for the agent are registered on the CA ARCserve Backup Primary
Server or Stand-alone Server.
Example: Licensing
Your environment consists of three ESX Server systems and you want to
protect the VMs in the ESX Server systems using the backup proxy
mechanism.
You must register three CA ARCserve Backup Agent for VMware licenses on
the CA ARCserve Backup Primary Server or Stand-alone Server.
Chapter 2: Installing and Configuring the Agent 15

Installation Prerequisites
Installation Prerequisites
Before installing the agent, you must satisfy the following prerequisites:
■Ensure your system requirements meet the minimum requirements
needed to install the agent.
For a list of requirements, see the readme file.
■Ensure that you have Administrator privileges.
■Ensure that you know the name and password of the system where you
are installing the agent.
■Ensure that Microsoft .NET Framework Version 2 or higher is installed and
running in your environment.
How to Install and Configure the Agent
There are two methods that you can use to install the agent:
■Install the agent while you are installing CA ARCserve Backup. The agent
follows the standard installation procedure for CA ARCserve Backup
system components, agents, and options.
■Install the agent after you install CA ARCserve Backup. The Server Admin
lets you install and uninstall the agent at any time after you install CA
ARCserve Backup.
Note: For more information, see Install the Agent Using the Server Admin
(see page 19).
To install and configure the agent, ensure that you complete the following
tasks:
1. Follow the procedures about installing CA ARCserve Backup in the
Implementation Guide.
Note: To install the agent, you must select the Primary Server or Stand-
alone Server installation type. The agent does not support member server
installations.
2. Install the license for the CA ARCserve Backup Agent for VMware on the
CA ARCserve Backup Primary or Stand-alone Server.
3. If Microsoft .NET Framework 2.0 is not present on your system before you
install the agent, you must register the vcb_com.dll file on the backup
proxy system. For more information, see Register vcb_com.dll on 32-bit
Systems (see page 17) or Register vcb_com.dll on 64-bit Systems (see
page 17).
4. Complete the configuration tasks described in Set Up Backing Up ESX
Server Systems Using a Backup Proxy System (see page 19).
16 Agent for VMware Guide

How to Install and Configure the Agent
Register vcb_com.dll on 32-bit Systems
If Microsoft .NET Framework 2.0 is present on your system before you install
the agent, the installation process automatically registers the vcb_com.dll
component while you install the agent. However, if Microsoft .NET Framework
2.0 is not present on your system when you install CA ARCserve Backup or
you install Microsoft .NET Framework 2.0 after you install the agent, you must
register the vcb_com.dll component manually.
This topic describes how to register the vcb_com.dll component on 32-bit
operating systems.
Important! You must register the vcb_com.dll component on the backup
proxy system.
To register vcb_com.dll on 32-bit systems
1. Open a Windows Command Line and change to the following directory:
C:\WINDOWS\Microsoft.NET\Framework
2. After you change to this directory, change to the directory that is greater
than Microsoft .NET Framework Version 2.0. For example:
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727
3. Execute the following command:
regasm <Client Agent for Windows installation directory>\Vcb_com.dll
Note: By default, the Client Agent for Windows is installed in the following
directory:
C:\Program Files\CA\ARCserve Backup Client Agent for Windows
After the execution is complete and successful, the following output
appears in the .NET Command Prompt or the Windows Command Prompt:
Microsoft (R) .NET Framework Assembly Registration Utility 2.0.50727.42
Copyright (C) Microsoft Corporation 1998-2004. All rights reserved.
Types registered successfully.
Register vcb_com.dll on 64-bit Systems
If Microsoft .NET Framework 2.0 is present on your system before you install
the agent, the installation process automatically registers the vcb_com.dll
component while you install the agent. However, if Microsoft .NET Framework
2.0 is not present on your system when you install CA ARCserve Backup or
you install Microsoft .NET Framework 2.0 after you install the agent, you must
register the vcb_com.dll component manually.
This topic describes how to register the vcb_com.dll component on 64-bit
operating systems.
Chapter 2: Installing and Configuring the Agent 17

How to Install and Configure the Agent
Important! You must register the vcb_com.dll component on the backup
proxy system.
To register vcb_com.dll on 64-bit systems
1. Open a Windows Command Line and change to the following directory:
C:\WINDOWS\Microsoft.NET\Framework
2. After you change to this directory, change to the directory that is greater
than Microsoft .NET Framework Version 2.0. For example:
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727
3. Execute the following command:
regasm <Client Agent for Windows installation directory>\x86\Vcb_com.dll
Note: By default, the Client Agent for Windows is installed in the following
directory:
C:\Program Files\CA\ARCserve Backup Client Agent for Windows
After the execution is complete and successful, the following output
appears in the .NET Command Prompt or the Windows Command Prompt:
Microsoft (R) .NET Framework Assembly Registration Utility 2.0.50727.42
Copyright (C) Microsoft Corporation 1998-2004. All rights reserved.
Types Registered Successfully.
Note: The ARCserve VMware Configuration Tool (VCBUI) and the
ca_vcbpopulatedb utility are installed in <Client Agent Installation
Directory>/x86. By default, the Client Agent for Windows is installed in the
following directory:
C:\Program Files\CA\ARCserve Backup Client Agent for Windows
18 Agent for VMware Guide

Install the Agent Using the Server Admin
Install the Agent Using the Server Admin
The agent follows the standard installation procedure for CA ARCserve Backup
system components, agents, and options. However, if you did not install the
agent when you installed CA ARCserve Backup, you can use the Server Admin
to install the agent.
To install the agent using the Server Admin
1. Log in to the ARCserve primary server.
From the CA ARCserve Backup Manager Console, click Server Admin in the
Quick Start menu.
The Server Admin opens.
2. From the domain directory tree, right-click the primary server and select
Install/Uninstall Options from the pop-up menu.
The Install/Uninstall Options dialog opens.
3. Check the check box next to Agent for VMware and click OK.
CA ARCserve Backup installs the agent.
4. After you complete the installation, you must complete the configuration
tasks described in Set Up Backing Up ESX Server Systems Using a Backup
Proxy System (see page 19).
Set Up Backing Up ESX Server Systems Using a Backup Proxy
System
The following sections describe how configure the communication protocol to
set up backing up ESX Server systems and VirtualCenter Server systems using
a backup proxy system.
This release of CA ARCserve Backup supports configurations on the following
VMware applications:
■ESX Server 3.0.2 systems
■ESX Server 3.5 systems
■ESX Server 3i systems
■VirtualCenter Server 2.0.2 systems
■VirtualCenter Server 2.5 systems
Chapter 2: Installing and Configuring the Agent 19

Set Up Backing Up ESX Server Systems Using a Backup Proxy System
Configure ESX Server 3.0.2 Systems
This topic describes how to configure the communication protocol on ESX
Server 3.0.2 systems.
To configure ESX Server 3.0.2 systems
1. Install ESX Server. For more information about ESX Server requirements,
see the VMware ESX Server Installation guide on the VMware website.
Note: To manage your ESX Servers through VMware VirtualCenter, you
must install and configure VirtualCenter Server as part of Virtual
Infrastructure installation.
2. Install VCB on the backup proxy system with the following environmental
conditions:
■Windows 2003 Server (32-bit or 64-bit) must be the operating system
running on the backup proxy system.
■If the VMs that you want to back up reside on a SAN, the backup
proxy system must be able to access the SAN storage LUN, and have
the same LUN number assigned. The LUN in the backup proxy system
should not be signed.
Note: For information about VCB installation, setup, and limitations, see
the Virtual Machine Backup Guide on the VMware website.
20 Agent for VMware Guide