1. Manuals
  2. Brands
  3. Computer Associates Manuals
  4. Software
  5. ARB6002700WF0. ..... - BRIGHTSTOR ARCSERVE...
  6. Manual

Computer Associates ARB6002700WF0. ..... - BRIGHTSTOR ARCSERVE 2000 Manual

Client agents guide
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
BrightStor
ARCserve
Backup
®
®
Client Agents Guide
r11.5
D01165-2E

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ARB6002700WF0. ..... - BRIGHTSTOR ARCSERVE 2000 and is the answer not in the manual?

Questions and answers

Related Manuals for Computer Associates ARB6002700WF0. ..... - BRIGHTSTOR ARCSERVE 2000

Summary of Contents for Computer Associates ARB6002700WF0. ..... - BRIGHTSTOR ARCSERVE 2000

  • Page 1 BrightStor ARCserve Backup ® ® Client Agents Guide r11.5 D01165-2E...
  • Page 2 This documentation and related computer software program (hereinafter referred to as the "Documentation") is for the end user's informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. ("CA") at any time. This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of CA.

  • Page 3: Table Of Contents

    Contents Chapter 1: Introducing the Client Agents Agent Features ........................7 Supported Client Systems ...................... 8 How Client Agents Work......................9 Agent Features ........................9 Push Technology ......................9 Proactive Backup for Windows ..................10 Windows Computer Name Resolution................10 Security Features ......................
  • Page 4 Access Control List Support for UNIX and Linux..............23 Chapter 3: Adding and Configuring the Client Agents Auto Discovery or Manual Addition of Client Agents ..............25 Auto Discover Client Agents on a Windows Server or a NetWare Server ......... 25 Manually Add a Client Agent to a Windows Server or a NetWare Server .........
  • Page 5 Chapter 4: Using the Client Agents Runtime Statistics ....................... 61 View Runtime Statistics for the Windows Client Agent ............61 View Runtime Statistics for NetWare Client Agents ............. 62 Activity Logs ........................62 View Activity Logs on a Windows Server................62 View Activity Logs on a UNIX or Linux Server..............

  • Page 7: Chapter 1: Introducing The Client Agents

    Chapter 1: Introducing the Client Agents ® ® BrightStor 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 compatible agents BrightStor ARCserve Backup offers are a specific set of operating-system-based client agents.

  • Page 8: Supported Client Systems

    Supported Client Systems Supported Client Systems BrightStor ARCserve Backup offers the following client agents: ® ® BrightStor ARCserve Backup Client Agent for Windows. This client agent supports the following: – Windows 98 – Windows Millennium (Me) – Windows NT – Windows 2000 –...

  • Page 9: How Client Agents Work

    BrightStor ARCserve Backup and the client agents are designed to support data storage activities for companies and organizations with networked computers. In these scenarios, Computer Associates customers use the BrightStor ARCserve Backup base product and its client agents (and any required options).

  • Page 10: Proactive Backup For Windows

    Agent Features When the client agents are installed and configured, you can use BrightStor ARCserve Backup to receive data from each workstation in your data network. The client agent browses its targeted directories, prepares the data, and transmits the data across the packet network. The backup server then prepares the data for storage on the designated backup devices.

  • Page 11: Intelligent Client-To-Server Data Encryption

    BrightStor ARCserve Backup provides the scanning and curing components of ™ eTrust Antivirus, Computer Associates’ premier anti-virus engine, to protect your data. Important! BrightStor ARCserve Backup provides only the scanning and curing components. It does not provide a full install of eTrust Antivirus. For the NetWare client agent, a full install of eTrust Antivirus is required to use virus scanning and repair.

  • Page 12: Multiple Network Interface Cards For Windows

    Agent Features Multiple Network Interface Cards for Windows The Windows client agent supports multiple network interface cards (NICs). For computers with more than one network card, the client agent checks all enabled NICs to determine which cards are activated and being used for transmission.

  • Page 13: Crc Verification For Windows And Netware

    Agent Features CRC Verification for Windows and NetWare The Windows and NetWare client agents generate cyclic redundancy check (CRC) codes for all the files sent to the BrightStor ARCserve Backup server. The CRC is used to verify the integrity of the files to be backed up. Access Control Lists for Windows, UNIX, Linux, Mainframe Linux, and Mac OS X Access control lists (ACLs) for Windows, UNIX, Linux, and Mac OS X client agents let you control which BrightStor ARCserve Backup server accesses the...

  • Page 14: Multistreaming For Windows, Unix, Mainframe Linux, And Linux

    Agent Features Multistreaming for Windows, UNIX, Mainframe Linux, and Linux If you have more than one drive and more than one volume to be backed up, you can configure that system’s client agent to use multistreaming. With multistreaming, you can take advantage of all available tape devices on the system.

  • Page 15: Snapshot And Direct I/O Features For Solaris And Hp-Ux Systems

    Agent Features Snapshot and Direct I/O Features for Solaris and HP-UX Systems You can enhance the performance of certain UNIX file systems (UFS) and Veritas file system (VxFS) volumes by using the Snapshot and Direct I/O (Direct Input/Output) features. Note: These features are available at the disk volume level only, and only for Solaris and HP-UX systems.

  • Page 17: 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 BrightStor ARCserve Backup client agent software. The client agent provides communication between a workstation and the BrightStor ARCserve Backup server. This chapter describes how to install client agents. System Requirements See the readme file on the installation CD for hardware and software requirements for installing and running client agents.

  • Page 18: Client Agent For Netware

    Installation Considerations There are some limitations when performing a remote setup during a client agent for Windows installation. The limitations are as follows: – Windows XP—You cannot perform a remote installation on a machine running Windows XP if the computer has been configured with the feature Force Network Logons Using Local Accounts to Authenticate as Guest.

  • Page 19: Enterprise Option For Openvms

    Install the Client Agents 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: –...

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

    Common Agent Automatic Installation 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 that are installed automatically during the first installation of any UNIX, Linux, or Mac OS X client agent.

  • Page 21: Common Agent Components

    Common Agent Automatic Installation Common Agent Components The Common Agent runs at all times as a daemon, listening for requests on behalf of all the UNIX, Linux, and Mac OS X client agents that are installed on the system. During each client agent’s installation, the BROWSER, AGENT, MERGE, and VERIFY components are registered with the Common Agent in a separate section.
  • Page 22 Common Agent Automatic Installation The following sample shows the configuration file before and after the script changes are made. Before the change: [36] #[BABcmagt] #NAME BABcmagt #HOME /opt/CA/BABcmagt #TCP_PORT 6051 #UDP_PORT 6051 After the change: [36] #[BABcmagt] NAME BABcmagt HOME /opt/CA/BABcmagt TCP_PORT 9051...

  • Page 23: Host Equivalence User Credentials

    Common Agent Automatic Installation Host Equivalence User Credentials When the Common Agent checks user credentials, it gives preference to host equivalence settings of the system. A UNIX, Linux, or Mac OS X system can be set up to grant access for specific users on specific hosts without requiring the user to provide credentials.
  • Page 24 Common Agent Automatic Installation 2. To install the packages, run the following commands: rpm -ivh <libacl-package-name> rpm -ivh <libacl-devel-package-name> as in this example: >rpm –ivh libacl-2.3.3-1.rpm >rpm –ivh libacl-devel-2.3.3-1.rpm This step installs the libacl.so library into your Linux system. If the Linux client agent is running on a 32-bit Linux system, ACL support is now enabled.

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

    Chapter 3: Adding and Configuring the Client Agents After installing BrightStor 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.
  • Page 26 Auto Discovery or Manual Addition of Client Agents To identify the client objects in your network, follow these steps: 1. Open the Backup Manager and click the Source tab. Note: If the Backup Engine is not running, you will be prompted to start it during this procedure.

  • Page 27: Manually Add A Client Agent To A Windows Server Or A Netware Server

    Auto Discovery or Manual Addition of Client Agents Manually Add a Client Agent to a Windows Server or a NetWare Server If Auto Discovery does not detect all client agents in your network for some reason or if you want to add a particular client agent, you can manually add a client agent to a Windows server or NetWare server using the Windows manager interface.
  • Page 28 Auto Discovery or Manual Addition of Client Agents 3. 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. 4.

  • Page 29: Manually Add A Client Agent To A Unix Or Linux Server

    Windows Client Agents Configuration Manually Add a Client Agent to a UNIX or Linux Server To manually add a client agent to a UNIX or Linux server, you must add each client agent machine using the Database Manager. To add a client agent, follow these steps: 1.

  • Page 30: Windows-Related Configuration Notes

    Windows Client Agents 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 31: Backup Priority And Restore/Compare Priority Options

    Windows Client Agents 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 32: Use The Backup Agent Admin To Set Windows Parameters

    1. Open the Backup Agent Admin. To open the Backup Agent Admin from the Windows Programs menu (All Programs menu on XP machines), select Computer Associates, BrightStor, 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 33: Configure Password Security Options

    Windows Client Agents Configuration 6. Define the Log. Enter the number of days to keep the log for. 7. Define the program execution options. 8. Click OK to save your changes and exit the dialog. To change your configuration later, you must return to the Configuration dialog.

  • Page 34: View Configuration Selections

    Windows Client Agents Configuration View Configuration Selections To view your configuration selections, open the Backup Agent Admin, expand Options, and then select Configuration, as shown in the following example: Configure Windows Network Communication BrightStor ARCserve Backup client agent services are shared across all configured client agents.
  • Page 35 Windows Client Agents Configuration To configure network communication, follow these steps: 1. Open the Backup Agent Admin. 2. From the Options menu, select Network 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 BrightStor ARCserve Backup to use.

  • Page 36: Set A Workstation Password

    Windows Client Agents Configuration Any updated information also needs to be modified in the Windows CAPortConfig.cfg file and copied to the BrightStor ARCserve Backup home directory. The following example shows a CAPortConfig.cfg file: #Hostname IP address (optional) TCP port UDP port #myhost nnn.nnn.nnn.nnn 6050...

  • Page 37: Create Access Control Lists

    Windows Client Agents Configuration Create Access Control Lists 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 BrightStor ARCserve Backup servers for the particular client agent.

  • Page 38: Enable Virus Scanning

    5. Click OK when you are finished adding or removing client agent names. Enable Virus Scanning ™ Computer Associates’ premier antivirus system, eTrust Antivirus, is bundled with BrightStor ARCserve Backup and is available through the Backup Manager. The eTrust Antivirus software offers extra protection for your critical data, securing it from virus threats even during backup and restore activities.

  • Page 39: Customizable Local Options

    NetWare Client Agent Configuration Customizable Local Options When you explicitly select a parent object (in a parent-child database configuration), you can right-click a client agent object to customize local backup options. For more information on explicit job packaging see the Getting Started , and for more information on how to select sources when customizing local options see the Administrator Guide .

  • Page 40: Configure Netware Network Communication

    NetWare Client Agent Configuration Configure NetWare Network Communication To configure the NetWare client agent for communication, edit the ASCONFIG.INI file to specify the IP address assigned to the client agent by the system administrator. Specifying an IP address is useful in a server with multiple IP addresses.

  • Page 41: Back Up Novell Directory Services

    Important! Do not change any of the variables in the agent configuration unless instructed to do so by a representative of Computer Associates Technical Support. UNIX, Linux, and Mac OS X Configuration Considerations The following list describes issues that you should be aware of when configuring the client agent on the UNIX, Linux, and Mac OS X platforms.

  • Page 42: Port Address Configuration

    UNIX, Linux, and Mac OS X client agents: The Computer Associates Common Agent The Computer Associates UNIX File System Agent (uagent) Note: You must install the Common Agent before you install the uagent. 42 Client Agents Guide...

  • Page 43: Common Agent Configuration File

    UNIX, Linux, and Mac OS X Client Agent Configuration File 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.
  • Page 44 UNIX, Linux, and Mac OS X Client Agent Configuration File Common Agent Configuration File Structure Each section of the agent.cfg file contains groups of fields that directly correspond to an installed client agent on a UNIX, Linux, or Mac OS X device in the backup network.
  • Page 45 UNIX, Linux, and Mac OS X Client Agent Configuration File File Contents Field Description AGENT uagentd Backup module for the client agent daemon MERGE umrgd Merge daemon VERIFY umrgd Scan daemon Client Agent Home Directory The default client agent home directory, BABuagent, is automatically defined during installation and setup.

  • Page 46: Configurable Options

    Note: These options should be carefully set by administrators having UNIX, Linux, or Mac OS X knowledge. If you do not understand what an option or parameter means, do not set the feature unless instructed to do so by a Computer Associates Technical Support representative. Option Description...
  • Page 47 UNIX, Linux, and Mac OS X Client Agent Configuration File For example: -CAUSER A: USER1 N: USER2 In this example, A means –ALLOW and N corresponds to -DENY. Option Description -DENY Use this option with Single User mode, with the -S or <network NOPASSWORD option, to define the IP addresses that are address>...
  • Page 48 UNIX, Linux, and Mac OS X Client Agent Configuration File For example, the option -P 10 assigns a wait time period for the backup or restore pre-script of 10 minutes. Note: An error occurs if you use the -P option without defining a number n. Option Description -Prebackup...

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

    UNIX, Linux, and Mac OS X Client Agent Configuration File 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 50 UNIX, Linux, and Mac OS X Client Agent Configuration File 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 51 UNIX, Linux, and Mac OS X Client Agent Configuration File 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 key value pairs are in KEY=VALUE format with one pair on each line.
  • Page 52 UNIX, Linux, and Mac OS X Client Agent Configuration File Configuration File Example 1 This is a sample configuration file for a 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 53 UNIX, Linux, and Mac OS X Client Agent Configuration File Configuration File Example 3 This is a sample configuration file for the HP-UX operating system that can have either an advanced version of the VxFS file system or the online JFS file system installed.

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

    UNIX, Linux, and Mac OS X Client Agent Configuration File 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/BABcmagt.

  • Page 55: As/400 Enterprise Option Configuration

    AS/400 Enterprise Option Configuration For UNIX, Linux, and Mac OS X client agents, the specific type of ACL can be specified in uag.cfg, or you can specify them using the -S, -NOPASSWORD, - CAUSER, -ALLOW, and -DENY options. For more information about these options, see the section Configurable Options.

  • Page 56: Configure Start Preferences

    AS/400 Enterprise Option Configuration Configure Start Preferences To configure start preferences for the AS/400 Enterprise Option, follow these steps: 1. From the command line, issue: straso 2. Press F4. The available options display. 3. Type your preferences and press Enter. Note: One of the preferences you can configure is Library Level Backup.

  • Page 57: Trace Levels For The As/400 Enterprise Option

    AS/400 Enterprise Option Configuration Trace Levels for the AS/400 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 AS/400 Enterprise Option. Because tracing levels can affect backup performance, do not change the values unless you receive specific instructions from Computer Associates Technical Support.

  • Page 58: Configure Stop Preferences

    OpenVMS Enterprise Option Configuration Configure Stop Preferences To configure stop preferences for the AS/400 Enterprise Option, follow these steps: 1. From the command line, issue: endaso 2. Press F4. The options display on the configuration screen. 3. Type your preferences and press Enter. OpenVMS Enterprise Option Configuration Other than the port address, the OpenVMS Enterprise Option does not require additional configuration after installation.

  • Page 59: Tcp/Ip Stack Optimization

    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. Because tracing levels can affect backup performance, do not change the values unless you receive specific instructions from Computer Associates Technical Support.

  • Page 61: Chapter 4: Using The Client Agents

    To obtain runtime statistics for Windows client agents, follow these steps: 1. From the Windows Programs (or All Programs, on XP machines) menu, select Computer Associates, BrightStor, ARCserve Backup Agents, Backup Agent Admin. 2. Select Connections. The system displays the last ten jobs processed. If the job is still active, you can click the job to display its current runtime statistics.

  • Page 62: View Runtime Statistics For Netware Client Agents

    Activity Logs View Runtime Statistics for 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 63 Activity Logs The printer or print-to-file output of a client agent activity log file looks like the one shown in the following sample: Using the Client Agents 63...

  • Page 64: View Activity Logs On A Unix Or Linux Server

    Activity Logs View Activity Logs on a UNIX or Linux Server To view logs for a client agent on a UNIX or Linux BrightStor ARCserve Backup server, follow these steps: 1. From the BrightStor ARCserve Backup Home Page, open the Report Manager.

  • Page 65: View Activity Log On A Unix, Linux, Or Mac Os X Client Agent Machine

    Activity Logs View Activity Log on a UNIX, Linux, or Mac OS X Client Agent Machine As soon as the UNIX, Linux, or Mac OS X client agent begins running, an activity log file called uag.log is created and stored in the logs directory. The logs directory resides under the client agent home directory.

  • Page 66: Delete Client Agent Log Files

    Back Up Windows Network Server Data 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 agents, use the Backup Agent Admin to delete log files: Back Up Windows Network Server Data...

  • Page 67: Client Agent Start And Stop Procedures

    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 68: Unix, Linux, And Mac Os X Client Agents Start And Stop Requirement

    Client Agent Start and Stop Procedures Start the NetWare Client Agent To start the Netware client agent, issue the following command at the remote server console prompt: nwagent The NetWare client agent includes a module called CSLOADER.NLM, which performs monitoring functions. When you start the NetWare client agent, CSLOADER.NLM also starts.

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

    Client Agent Start and Stop Procedures Stop the UNIX, Linux, or Mac OS X Client Agent To stop the UNIX, Linux, or Mac OS X client agent, log in as root and issue the following command at the command line: # uagent stop Common Agent Start and Stop Status Communication Whenever a client agent is started or stopped, the UNIX, Linux, or Mac OS X...

  • Page 70: Openvms Enterprise Option Start And Stop Requirement

    Client Agent Start and Stop Procedures Start the Client Agent for the AS/400 Enterprise Option To start the agent, log on to AS/400 and issue the following command at the command line: straso Stop the Client Agent for the AS/400 Enterprise Option To stop the agent, log on to AS/400 and issue the following command at the command line: endaso...

  • Page 71: Index

    Index access control lists (ACL) ca_dbmgr command • 29 about • 13 caagent for UNIX, Linux, Mac OS X • 54 start command • 21 ACL library stop command • 21 32-bit Linux • 23 update command • 21 Linux libacl.so • 23 caagentd packages •...
  • Page 72 agent.cfg • 42 installation considerations caagperf.cfg • 49, 51 NetWare • 18 CAPortConfig.cfg • 34, 42 OpenVMS • 19 port.cfg • 42 Windows • 17 PortsConfig.cfg • 34 IP address Solaris sample • 52 on remote Windows machine • 10 configuring UNIX, Linux, and Mac OS X ACLs •...
  • Page 73 OpenVMS uag.cfg • 41 bab$shutdown.com command • 70 uag.cntl Directory Control file • 42 bab$startup.com command • 70 uag.log activity log file • 65 configuration • 58 uagent command • 68 show sys /proc=aso$* command • 70 uagentsetup script • 68 TCP/IP stack optimization •...

This manual is also suitable for:

Babnwup900ne6 - brightstor arcserve backup v9Babwbn2900ne7 - brightstor arc backup v9 ntwkBrightstor arcserve backup

Table of Contents