1. Manuals
  2. Brands
  3. CA Manuals
  4. Software
  5. BABWBN2900E20 - BRIGHTSTOR ARC BACKUP V9...
  6. Manual

CA BABWBN2900E20 - BRIGHTSTOR ARC BACKUP V9 CLIENT Manual

Clients agents guide
Hide thumbs
Table of Contents

Advertisement

Quick Links

CA ARCserve
Backup
®
Client Agents Guide
r15

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BABWBN2900E20 - BRIGHTSTOR ARC BACKUP V9 CLIENT and is the answer not in the manual?

Questions and answers

Summary of Contents for CA BABWBN2900E20 - BRIGHTSTOR ARC BACKUP V9 CLIENT

  • Page 1 CA ARCserve Backup ® Client Agents Guide...
  • Page 2 This documentation and any related computer software help programs (hereinafter referred to as the "Documentation") are for your informational purposes only and are 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 Product References This document references the following CA 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 Technical Support For your convenience, CA provides one site where you can access the information you need for your Home Office, Small Business, and Enterprise CA products. At CA ARCserve Backup Support, you can access the following: ■...

  • Page 7: Table Of Contents

    Contents Chapter 1: Introducing the Client Agents Introduction ................... Benefits of Using a Client Agent ..............Supported Client Systems ..............Chapter 2: Installing the Client Agents Installation Considerations ..............Client Agent for Windows ..............Client Agent for NetWare ..............Enterprise Option for OpenVMS ............
  • Page 8 NetWare-related Configuration Notes ............Configure NetWare Network Communication ..........Back Up Novell Directory Services ............UNIX, Linux, and Mac OS X Client Agent Configuration .......... UNIX, Linux, and Mac OS X Configuration Considerations ........UNIX, Linux, and Mac OS X Client Agent Control Files ........

  • Page 9: Chapter 1: Introducing The Client Agents

    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) Introduction CA ARCserve Backup is a comprehensive storage solution for applications, databases, distributed servers, and file systems.

  • Page 10: Supported Client 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: –...

  • Page 13: Chapter 2: Installing The Client Agents

    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.

  • Page 14: Enterprise Option For Openvms

    Installation Considerations ■ You must have supervisor rights on the eDirectory tree of the NetWare computer on which you are installing this client agent. For details, see your Novell NetWare documentation. ■ For optimum performance, use the latest NetWare C library (CLIB) and Systems Management Server (SMS) modules.

  • Page 15: Install The Client Agents

    Install the Client Agents As a best practice, you should add CA ARCserve Backup to the firewall exceptions list on the agent computers before you install the agents. This requirement affects the following CA ARCserve Backup components: ■ Client Agent for UNIX ■...

  • Page 16: Installation Directories For The Common Agent And Client Agents

    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.

  • Page 17: Chapter 3: Adding And Configuring The Client Agents

    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)

  • Page 18: Manually Add Client Agents

    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: Windows Client Agent Configuration

    Windows Client Agent Configuration To manually add client agents 1. Open the Backup Manager and click the Source tab. 2. Right-click the appropriate client agent object, such as Windows Systems. 3. Select Add Machine/Object. The Add Agent dialog appears. 4. Enter the name of the computer in the Host Name field. Note: If you are adding a NetWare Client Agent, you must use the Novell server name as the host name.

  • Page 20: Windows-Related Configuration Notes

    Windows Client Agent Configuration 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. Note: The System State also supports restoring to an alternate location, but it will not recreate an operational system since the files are placed in default directories created by the agent at the time of restore.

  • Page 21: Backup Priority And Restore/Compare Priority Options

    Windows Client Agent Configuration Backup Priority and Restore/Compare Priority Options The Client Agent for Windows process priority is defined on the Configuration dialog. Select one of the following settings for Backup Priority and Restore/Compare Priority: High Foreground processing performs client agent functions before other processes.

  • Page 22: Use The Backup Agent Admin To Set Windows Parameters

    Windows Client Agent Configuration Use the Backup Agent Admin to Set Windows Parameters To use the Backup Agent Admin to set Windows parameters 1. Access the Agent Admin by clicking Start, Programs or All Programs, CA, ARCserve Backup Agents, Backup Agent Admin. Note: The window contents may differ slightly for each client agent, depending on the specific operating system in use.
  • Page 23 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 24 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.

  • Page 25: Configure Password Security

    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.

  • Page 26: Enable Raw Backup And Restore

    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.

  • Page 27: Configure Windows Network Communication

    Windows Client Agent Configuration Configure Windows Network Communication CA ARCserve Backup client agent services are shared across all configured client agents. By default, Windows client agents use TCP/UDP port 6050. You can change this behavior by using the Network Configuration menu in the Backup Agent Admin.
  • Page 28 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. The updated port information will be saved in the local PortsConfig.cfg file located in \Program Files\CA\SharedComponents\ARCserve Backup.

  • Page 29: Set A Workstation Password

    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.

  • Page 30: Create Windows Access Control List

    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.

  • Page 31: Enable Virus Scanning

    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: Only the listed servers will be able to use the agent for backup/restore ■...

  • Page 32: Customizable Local Options

    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.

  • Page 33: Netware Client Agent Configuration

    NetWare 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.

  • Page 34: Back Up Novell Directory Services

    NetWare Client Agent Configuration To edit the ASCONFIG.INI file 1. From a text editor, open the ASCONFIG.INI file located in the client agent home directory. 2. Add the following line to the NetWare Agent section of the file, specifying the IP address that you want the client agent to use: IPAddress = nnn.nnn.nnn.nnn If a NetWare Agent section does not exist, create one by adding the following...

  • Page 35: Unix, Linux, And Mac Os X Client Agent Configuration

    UNIX, Linux, and Mac OS X Client Agent Configuration UNIX, Linux, and Mac OS X Client Agent Configuration The UNIX, Linux, and Mac OS X client agent configuration file, uag.cfg, is located on the remote client workstation in the client agent home directory. This file, which is scanned for entries whenever a job is submitted to the workstation, can be used to set multiple options associated with the client agent.

  • Page 36: Common Agent Configuration File For Unix, Linux, And Mac Os X

    UNIX, Linux, and Mac OS X Client Agent Configuration The control files installed for both packages include: ■ Directory Control file Use the Directory Control file, uag.cntl, to list all directories or file systems (or both) that you want to exclude from backup operations on a workstation. To specify directories and file systems in this file, enter a slash (/) followed by a one line, complete path name.
  • Page 37 UNIX, Linux, and Mac OS X Client Agent Configuration The Common Agent resides in the /opt/CA/ABcmagt directory. It keeps track of the client agents that are installed on the system in a configuration file named agent.cfg, which also resides in the /opt/CA/ABcmagt directory. Note: CA ARCserve Backup installs related configuration files for the Common Agent, the file system agents, and the Agent for Oracle in different directories on the various UNIX and Linux platforms.
  • 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;...
  • Page 39 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.
  • Page 40 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 (cprocess) and the client agent. The Backup Manager user interface uses the UDP port to browse hosts.
  • Page 41 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...
  • Page 42 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.

  • Page 45: Snapshot And Direct I/O Support For Unix

    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.

  • Page 50: Unix, Linux, And Mac Os X Access Control Lists

    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.
  • Page 52 UNIX, Linux, and Mac OS X Client Agent Configuration Verify ACL Libraries To check that you have the required ACL libraries installed, run the following command: >rpm -qa |grep libacl If the libacl-devel-* or libacl-* packages are not listed, you must install them. Install ACL Library Packages To install ACL library packages 1.

  • Page 53: As/400 Enterprise Option Configuration

    AS/400 Enterprise Option Configuration Create Link to 32-bit Linux ACL Library If libacl.so points to a 64-bit library, you must create a link from the 32-bit library to libacl.so. The following example shows how to create the link on a 64-bit Mainframe Linux platform: >...

  • Page 54: Performance Configuration

    AS/400 Enterprise Option Configuration 3. Type your preferences and press Enter. Note: You can configure the preferences for Library Level Backup and Use QaneSava. These preferences enhance performance. For more information, see the section Performance Configuration. Performance Configuration By default, both Use QaneSava and Library Level Backup are set to *ON. These settings increase the performance of the agent for library level backups.

  • Page 55: Configure Stop Preferences

    OpenVMS Enterprise Option Configuration By setting the flag to *OFF, the SAVOBJ command is used to back up each file inside a library separately. Use this approach if you are not intending to do Library Level Backups. Note: The Library Level Backup feature does not support incremental and differential backups.

  • Page 56: Configure Port Address

    OpenVMS system. Trace Levels for the OpenVMS Enterprise Option Occasionally, based on instructions from Computer Associates Technical Support, you may need to change the level of activity that is logged for the OpenVMS Enterprise Option.

  • Page 57: Chapter 4: Using The Client Agents

    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...

  • Page 58: View Runtime Statistics For The Netware Client Agents

    Activity Logs View Runtime Statistics for the NetWare Client Agents With the NetWare client agent, if the Runtime window is not available, you must switch windows to display it. If you are running Remote Console (RCONSOLE.EXE) to view the server console, press the ALT and F3 keys simultaneously and continue pressing the keys until the Runtime window opens.

  • Page 59: View Activity Log On A Netware Client Agent Machine

    Activity Logs 2. From the Job Status menu, select Activity Log and click Print Preview. The print preview output of a client agent activity log file appears as illustrated by the following screen: View Activity Log on a NetWare Client Agent Machine The NetWare client agent writes to the nwagent.log, which is created in the client agent home directory.

  • Page 60: Activity Logs On Computers Running The As/400 Enterprise Option

    Activity Logs Activity Logs on Computers Running the AS/400 Enterprise Option The Enterprise Option for AS/400 creates a log file in the CA ARCserve Backup library. The two file members are: ■ AGENT.MBR, which records the activities and errors relating to agent operations ■...

  • Page 61: Delete Client Agent Log Files

    Activity Logs Delete Client Agent Log Files For UNIX, Linux, and Mac OS X client agents, delete log files from the client machine the same way you would delete any file on that machine. For example, run: $>rm uag.log For Windows client agent, use the Backup Agent Admin to delete log files. In the Options menu, select Delete Client Agent Log Files.

  • Page 62: Back Up Windows Network Server Data

    Back Up Windows Network Server Data Back Up Windows Network Server Data If you installed a client agent on a Windows server, you can back up the server data through the client agent. To back up Windows network server data 1.

  • Page 63: Netware Start And Stop Requirement

    Client Agent Start and Stop Procedures Start or Stop the Windows Client Agent To start or stop a Windows client agent 1. Open the Backup Agent Admin. 2. From the Options menu, select Services. 3. (Optional) If you do not want the client agent to start automatically each time you start the computer, clear the option, Start the backup agent service as the system starts.

  • Page 64: Unix, Linux, And Mac Os X Client Agents Start And Stop Requirement

    Client Agent Start and Stop Procedures UNIX, Linux, and Mac OS X Client Agents Start and Stop Requirement Before starting the client agent, ensure that it has been configured. If the client agent has not been configured, run the following script: #abuagent/uagentsetup In this example, abuagent represents the full path name of the agent home directory.

  • Page 65: Enterprise Option For As/400 Start And Stop Requirement

    Client Agent Start and Stop Procedures When you enter the uagent start command, the Common Agent status changes from disabled to enabled. In summary, when a particular client agent is started or stopped, the scripts modify the agent.cfg file accordingly, and notify the Common Agent.
  • Page 66 Client Agent Start and Stop Procedures Start the Client Agent for the Enterprise Option for OpenVMS To start the agent, log in as system and issue the following command at the command line: @sys$startup:bab$startup.com 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...

  • Page 67: Index

    Index configuration file • 40 example • 27 ABuagent/uagentsetup command • 64 check agent status access control lists (ACL) OpenVMS • 66 for UNIX, Linux, Mac OS X • 50 UNIX, Linux, Mac OS X • 64 ACL library commands 32-bit Linux •...
  • Page 68 cprocess • 40 nwagent.log • 59 create link from 32-bit library to libacl.so • 53 manager interface for Windows • 18 Direct I/O about • 45 UNIX support • 45 NetWare Directory Control file • 35 ASCONFIG.INI • 33 configuring client agent • 33 CSLOADER.NLM •...
  • Page 69 show sys /proc=aso$* OpenVMS command • 66 single user mode • 50 Snapshot about • 45 buffer • 45 features • 45 output • 45 UNIX support • 45 starting client agents • 62 stopping client agents • 62 straso AS/400 command • 65 trace levels AS/400 •...

This manual is also suitable for:

Arcserve backup

Table of Contents