Page 2
This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as the “Documentation”) is for your 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.
Page 3
CA Technologies Product References This document references the following CA Technologies products: ■ BrightStor® Enterprise Backup ■ CA Antivirus ■ CA ARCserve® Assured Recovery™ ■ CA ARCserve® Backup Agent for Advantage™ Ingres® ■ CA ARCserve® Backup Agent for Novell Open Enterprise Server for Linux ■...
Page 4
■ 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 ■...
Page 5
Contact CA Contact CA Support For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following resources: ■...
Documentation Changes The following documentation updates have been made since the last release of this documentation: ■ Rebranded to CA Technologies. ■ This release of CA ARCserve Backup no longer includes client agent support for NetWare platforms. All topics referencing NetWare platforms were updated or removed.
Contents Chapter 1: Introducing the Client Agents Introduction ................................. 9 Benefits of Using a Client Agent ........................... 9 Supported Client Systems ............................10 Access the Backup Agent Admin ..........................12 Chapter 2: Installing the Client Agents Installation Considerations ............................13 Client Agent for Windows ...........................
Page 8
UNIX, Linux, and Mac OS X Client Agent Configuration ..................... 35 UNIX, Linux, and Mac OS X Configuration Considerations .................. 35 UNIX, Linux, and Mac OS X Client Agent Control Files ..................36 Common Agent Configuration File for UNIX, Linux, and Mac OS X ..............37 Snapshot and Direct I/O Support for UNIX ......................
Chapter 1: Introducing the Client Agents This section contains the following topics: Introduction (see page 9) Benefits of Using a Client Agent (see page 9) Supported Client Systems (see page 10) Access the Backup Agent Admin (see page 12) Introduction CA ARCserve Backup is a comprehensive storage solution for applications, databases, distributed servers, and file systems.
Supported Client Systems ■ Assist with monitoring the progress of backup jobs ■ Maintain and monitor backup logs with the status of backup and restore activities ■ Facilitate backup of applications or file systems Client agents can also augment data protection for all client computers from a single CA ARCserve Backup server in the network.
Page 11
Supported Client Systems ■ CA ARCserve Backup Client Agent for Linux. This client agent supports the following: – Red Hat – SuSE – Turbo – Debian – RedFlag – Miracle Linux – Asianux ■ CA ARCserve Backup Client Agent for Mainframe Linux. This client agent supports the following: –...
Access the Backup Agent Admin Access the Backup Agent Admin The Backup Agent Admin allows you to configure various agents and set multiple options. You can view data about the agent desktop regarding the local system, connections, agent status, and configuration options. The following options are available using the Backup Agent Admin: ■...
Chapter 2: Installing the Client Agents To perform a backup or restore job, you must install and start the appropriate CA ARCserve Backup client agent software. The client agent provides communication between a workstation and the CA ARCserve Backup server. This chapter describes how to install client agents.
Installation Considerations Enterprise Option for OpenVMS Before installing the enterprise option for OpenVMS, review the following considerations. ■ A computer running the supported Alpha and VAX operating systems can use either TCP or User Data Protocol (UDP) with any of the following communications software: –...
Install the Client Agents This requirement affects the following CA ARCserve Backup components: ■ Client Agent for UNIX ■ Client Agent for Linux ■ Client Agent for Mainframe Linux ■ Oracle Agent on UNIX platforms ■ Oracle Agent on Linux platforms ■...
Installation Directories for the Common Agent and Client Agents Installation Directories for the Common Agent and Client Agents The following table describes the default installation paths for the CA ARCserve Backup Common Agent and the CA ARCserve Backup Client Agents for UNIX and Linux platforms.
Chapter 3: Adding and Configuring the Client Agents After installing CA ARCserve Backup and its various client agents, you must add and configure each client agent machine in your network to the backup server. This chapter discusses the procedures for adding and configuring client agents. This section contains the following topics: Adding Client Agents (see page 17)
Adding Client Agents You can use the Add, Import, and Export Nodes feature to add multiple nodes and agents into the system in either of the following ways: Add multiple agents and nodes using the user interface 1. From the Backup Manager Source Tab or the Restore Manager Destination Tab, select a node.
Page 19
Adding Client Agents 4. Select Add Machine/Object. The Add Agent dialog appears. 5. Enter the name of the computer in the Host Name field. 6. Select the protocol you want to use to connect to the computer. Select TCP/IP and, if you are adding a Windows client agent, select Use Computer Name Resolution.
Page 20
Adding Client Agents 7. Enter the Username and Password for the computer in the Security Information section. 8. Click OK. The client agent is added to the server. To manually add client agents in a Classic View 1. Open the Backup Manager and click the Source tab. The Source directory tree appears.
Windows Client Agent Configuration Windows Client Agent Configuration The following sections discuss the Windows client agent configuration options. Windows-Related Configuration Notes General information pertaining to the configuration of the Windows client agent includes: ■ Restoring System State—The System State supports the Restore to Original Location option.
Windows Client Agent Configuration Password Security Lets you set individual passwords for security. This setting enables the client agent to run under the local system account. Password Security is disabled by default. Note: If password security is selected, and DSA-based database agents (such as Sybase, Informix, and so on) are installed on the machine, whole node backup is not supported.
Windows Client Agent Configuration Backup and Restore Execution Options The Client Agent for Windows execution options are defined on the Configuration dialog. Select the pre-execution programs, post-execution programs, and define the execution delay. Pre-execution Enter or select the name of any batch programs (for example, C:\WINAGENT\PRE.CMD) that you want to automatically execute before the backup or restore operation.
Page 24
Windows Client Agent Configuration 2. From the Agent Admin, select the Options tab. The Configuration dialog opens. 24 Client Agents Guide...
Page 25
Windows Client Agent Configuration You can define the following settings using the Configuration dialog: ■ Security Type Specification--Select one of the following types of security: System Security--Select this Security option to use Windows security to perform backup, compare, and restore operations. The client agent impersonates the active network user;...
Page 26
Windows Client Agent Configuration ■ Log--The Log file is stored in the following path: <ARCserve_HOME>\ARCserve Backup Client Agent for Windows\ntagent.log. The log for every job that runs is stored in this log file. Keep Log For--Specifies the number of days (the default is 60 days) to keep the agent log.
Windows Client Agent Configuration Configure Password Security The client agent service uses the node (machine) user name and assigned password to log on to the CA ARCserve Backup network. To set password security for the client agent 1. Start the Backup Manager, and then right-click the machine name. A pop-up menu appears.
Windows Client Agent Configuration 2. Expand Options and then select Configuration. The current settings are displayed. Enable Raw Backup and Restore You can use CA ARCserve Backup to perform raw backup and restore of physical disks and volumes. The capability to perform raw backup and restore of physical disks and volumes is disabled by default.
Windows Client Agent Configuration 2. Click Options, Configuration. The Configuration window appears. 3. Click Enable physical disk/volume backup and restore. 4. Click OK. The raw backup and restore feature is enabled for the agent. For more information on how you can perform raw backup and restore, see the Administration Guide. Configure Windows Network Communication CA ARCserve Backup client agent services are shared across all configured client agents.
Page 30
Windows Client Agent Configuration 3. Using this dialog, set the following network parameters for the client agent: ■ Specify Port Number--Accept the defaults or enter the port values you want CA ARCserve Backup to use. If you want to use the original default port, click the Reset button.
Windows Client Agent Configuration Set a Workstation Password If you selected password security when configuring the Windows client agent from the Backup Agent Admin, you must specify the same password in CA ARCserve Backup. To set a workstation password 1. From the Backup Manager, right-click the name of the client agent. 2.
Windows Client Agent Configuration Create Windows Access Control List You can limit the servers authorized to perform backups on a Windows client agent object by generating an access control list (ACL). This feature is defined through the Backup Manager and the Backup Agent Admin. By creating an access control list and defining its type, you can restrict data backup and restore to a specific group of CA ARCserve Backup servers for the particular client agent.
Windows Client Agent Configuration 3. When the Access Control List dialog appears, the default is to not use ACL and the setting All servers will be able to use the agent for backup/restore is selected. To create an ACL, select one of the following choices: ■...
Windows Client Agent Configuration Delete Delete the infected file. Cure CA Anti-Virus cures the files that have been found to be infected. With the Cure option, infected files are automatically repaired during a backup without user intervention. 6. If you want each archive’s component files individually verified, enable Scan Compressed Files.
UNIX, Linux, and Mac OS X Client Agent Configuration ■ If the Exchange Information Store is offline, the Agent for Microsoft Exchange Server provides an empty list of Exchange databases and log files that should be excluded from the backup job. As a result, CA ARCserve Backup does not skip the Exchange server files and includes all files during the file system backup.
UNIX, Linux, and Mac OS X Client Agent Configuration UNIX, Linux, and Mac OS X Client Agent Control Files The UNIX, Linux, and Mac OS X client agent control files specify which directories, file systems, or file system types are to be excluded from backup operations on a specific workstation.
UNIX, Linux, and Mac OS X Client Agent Configuration Common Agent Configuration File for UNIX, Linux, and Mac OS X The Common Agent (caagentd binary) is a standard component for all UNIX, Linux, and Mac OS X client agents. It is installed automatically during the first installation of UNIX, Linux, or Mac OS X client agent.
Page 38
UNIX, Linux, and Mac OS X Client Agent Configuration The environment variable field (ENV) contents are also determined during client agent installation and configuration. However, if required, you can enter values for this variable into the file manually. You should modify the agent.cfg only in certain circumstances;...
UNIX, Linux, and Mac OS X Client Agent Configuration Client Agent Home Directory The default client agent home directory, ABuagent, is automatically defined during installation and setup. If required, however, you can specify a different home directory. To locate the name of the home directory, look in the agent.cfg file under the ABagntux section of the file.
UNIX, Linux, and Mac OS X Client Agent Configuration Port Address Configuration The default port for TCP and UDP is 6051. The TCP port is used for communication and data transfer between the backup server and the client agent. The Backup Manager user interface uses the UDP port to browse hosts.
UNIX, Linux, and Mac OS X Client Agent Configuration The following sample shows the configuration file before and after the script changes are made. Before the change: [36] #[ABcmagt] #NAME ABcmagt #HOME /opt/CA/ABcmagt #TCP_PORT 6051 #UDP_PORT 6051 After the change: [36] #[ABcmagt] NAME...
UNIX, Linux, and Mac OS X Client Agent Configuration [36] #[ABcmagt] NAME ABcmagt HOME /opt/CA/ABcmagt NO_HOSTS_EQUIV=1 You can place the Common Agent in No Password mode or Single User mode with a set of access control lists if necessary. For more information about ACLs, see UNIX, Linux, and Mac OS X Access Control Lists (see page 50).
Page 43
UNIX, Linux, and Mac OS X Client Agent Configuration -ALLOW N:172.16.0.0(255.255.255.0) H:172.31.255.255 In this example, N denotes a network address and H denotes a host IP address. You can set an optional subnet mask. Option Description -b bufsize Defines the disk I/O buffer size in bytes. Options are 16384 to 65536 bytes;...
Page 44
UNIX, Linux, and Mac OS X Client Agent Configuration Option Description -P n Specifies the default time out, followed by a variable number (n), which is user-defined and measured in minutes (0 to 10). The default is 5 minutes. For example, the option -P 10 assigns a wait time period for the backup or restore pre-script of 10 minutes.
UNIX, Linux, and Mac OS X Client Agent Configuration Snapshot and Direct I/O Support for UNIX UNIX client agents support the Snapshot and Direct I/O features. To take advantage of these features, one of the following environments must exist on the machine running the UNIX client agent: Feature Platform...
Page 46
UNIX, Linux, and Mac OS X Client Agent Configuration For a Direct I/O backup or restore, you need to check the client environment and edit the caagperf.cfg configuration file. You can view Snapshot and Direct I/O on the file systems in the caagperf.cfg file by executing the mount command at the command line after submitting the backup or restore job.
Page 47
UNIX, Linux, and Mac OS X Client Agent Configuration Configuration Table Parameters and Values The format of the configuration file is similar to a Windows .inf file. It has sections and key value pairs. The section names are the names inside the square brackets, and the key value pairs are in KEY=VALUE format with one pair on each line.
Page 48
UNIX, Linux, and Mac OS X Client Agent Configuration Configuration Files for UNIX Systems The following are examples of different variations of UNIX systems configuration files. Example: Solaris 8 or Solaris 9 operating system with a UFS file system with fssnap installed The first line of the file is a debugging flag.
Page 49
UNIX, Linux, and Mac OS X Client Agent Configuration Example: HP-UX operating system having either an advanced version of the VxFS file system or the online JFS file system installed The file contains four sections. The first line of the file is a debugging flag. The sections in the file are the /, /var, /usr, and /export volumes.
UNIX, Linux, and Mac OS X Client Agent Configuration UNIX, Linux, and Mac OS X Access Control Lists For UNIX, Linux, and Mac OS X client agents, ACLs are supported in Single User mode only. This is also known as No Password mode. A UNIX, Linux, and Mac OS X client agent—or database backup agent—can be put into Single User mode by specifying a NOPASSWORD entry in its corresponding section in the Common Agent configuration file, agent.cfg, located in /opt/CA/ABcmagt.
Page 51
UNIX, Linux, and Mac OS X Client Agent Configuration Example: Access the System with IP Addresses An access control list can determine whether specific IP addresses can access the system. For example, a part of the agent.cfg file is shown in the following sample. You must make similar changes for other client agent sections of the file if you want to apply ACLs to those client agents too.
Page 52
UNIX, Linux, and Mac OS X Client Agent Configuration Install ACL Library Packages To install ACL library packages 1. Copy the ACL library packages from the CD image, or download them from the internet to your Linux system: -libacl package (such as libacl-2.2.3-1.rpm) -libacl-devel package (such as libacl-devel-2.3.3-1.rpm) 2.
AS/400 Enterprise Option Configuration AS/400 Enterprise Option Configuration The AS/400 Enterprise Option start and stop preferences are configured using STRASO and ENDASO. Configure Start Preferences Library Level Backup preferences can be configured to enhance the AS/400 Enterprise Option. To configure start preferences 1.
OpenVMS Enterprise Option Configuration Configure Stop Preferences If necessary, you can set stop preferences for the AS/400 Enterprise Option. To configure stop preferences 1. From the command line, type: endaso 2. Press F4. The options display on the configuration screen. 3.
OpenVMS Enterprise Option Configuration Trace Levels for the OpenVMS Enterprise Option Occasionally, based on instructions from CA Technologies Technical Support, you may need to change the level of activity that is logged for the OpenVMS Enterprise Option. Because tracing levels can affect backup performance, do not change the values unless you receive specific instructions from CA Technologies Technical Support.
Chapter 4: Using the Client Agents This chapter includes details such as how you can start and stop client agents, and how you can schedule or initiate backup and restore jobs of client agents in a standard backup environment. This section contains the following topics: Runtime Statistics (see page 57) Activity Logs...
Activity Logs Activity Logs The server-based CA ARCserve Backup system generates an activity log, which displays information about all the jobs that the client agent processes. The following sections explain how to display the activity log for each client agent from the server side and from the client agent side.
Back Up Windows Network Server Data Activity Logs on Computers Running the OpenVMS Enterprise Option As soon as the agent begins running on the server, CA ARCserve Backup generates an activity log file named aso$agent_<nodename>.log, and stores it in the logs directory. A new log file—identified by sequential job number, date, and time—...
Client Agent Start and Stop Procedures Client Agent Start and Stop Procedures The following sections describe the procedures for starting and stopping the various client agents. Note: If the client agent is stopped at any time during a backup or restore job, the job will fail and must be restarted.
Page 61
Client Agent Start and Stop Procedures Start the UNIX, Linux, or Mac OS X Client Agent After installing a UNIX, Linux, or Mac OS X client agent, the agent is started automatically. To check the status of the agent, type the following command at the command line: # uagent status To start the agent, type the following command at the command line: # uagent start...
Client Agent Start and Stop Procedures Check the Status of the UNIX, Linux, and Mac OS X Client Agents To check the status of a UNIX, Linux, or Mac OS X client agent, log in as root and issue the following command at the command line: # uagent status If this command fails, the client agent may need to be configured.
Page 63
Client Agent Start and Stop Procedures Stop the Client Agent for the Enterprise Option the OpenVMS To stop the agent, log in as system and issue the following command at the command line: @sys$startup:bab$shutdown.com Check the Status of the Client Agent for the Enterprise Option OpenVMS To check the status of the client agent, log in and issue the following command at the command line: show sys /proc=aso$*...
Glossary access control list An access control list (ACL) is a list of access control entries (ACE). Each ACE in an ACL identifies a trustee and specifies the access rights allowed, denied, or audited for that trustee. activity log An activity log is a log file that displays information about all the jobs that the client agent processes.
Index configuration file • 40 example • 29 ABuagent/uagentsetup command • 61 check agent status access control lists (ACL) OpenVMS • 63 for UNIX, Linux, Mac OS X • 50 UNIX, Linux, Mac OS X • 61 ACL library commands 32-bit Linux •...
Page 68
create link from 32-bit library to libacl.so • 52 manager interface for Windows • 18 Direct I/O about • 45 network interface cards (NIC) UNIX support • 45 IP address • 29 Directory Control file • 36 OpenVMS endaso AS/400 command • 62 bab$shutdown.com command •...
Need help?
Do you have a question about the BABWBN2900NE5 - BRIGHTSTOR ARC BACKUP V9 DIS and is the answer not in the manual?
Questions and answers