CA BABWBN2900E20 - BRIGHTSTOR ARC BACKUP V9..., Manual

Page 1: ...Client Agents Guide r15 CAARCserve Backup ...

Page 2: ...r responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed 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 ...

Page 3: ...ve 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 Exchange S...

Page 4: ...Cserve 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 ARCserve Backup Patch Manager CA ARCserve Backup UNIX and Linux Data Mover CA ARCserve D2D CA ARCserve High Availability CA ARCserve Replication CA VM Tape for z VM CA 1 Tape Management...

Page 5: ...ssistance and customer services Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your product Provide Feedback If you have comments or questions about CA product documentation you can send a message to techpubs ca com If you would like to provide feedback about CA product documentation compl...

Page 6: ......

Page 7: ... Adding Client Agents 17 How to Add Import and Export Agents and Nodes 17 Manually Add Client Agents 18 Windows Client Agent Configuration 19 Windows Related Configuration Notes 20 Security Configuration Options 20 Backup Priority and Restore Compare Priority Options 21 Multiple Concurrent Restore or Compare 21 Backup and Restore Execution Options 21 Use the Backup Agent Admin to Set Windows Param...

Page 8: ...e OpenVMS Enterprise Option 56 Chapter 4 Using the Client Agents 57 Runtime Statistics 57 View Runtime Statistics for the Client Agent for Windows 57 View Runtime Statistics for the NetWare Client Agents 58 Activity Logs 58 View Activity Logs on a Windows Server 58 View Activity Log on a NetWare Client Agent Machine 59 View Activity Log on a UNIX Linux or Mac OS X Client Agent Machine 59 Activity ...

Page 9: ...ent agents share data storage tasks with the backup servers in your network You may need multiple client agents depending on the number and variety of network machines that require regular data backup and restore functionality This guide provides information on installing configuring and adding client agents for all workstations and servers in your network storage environment Benefits of Using a C...

Page 10: ...omputers and operating systems Supported Client Systems CA ARCserve Backup offers client agents that support the following platforms Note For a detailed description of supported operating systems and versions see the Client Agents Readme file located on the CA ARCserve Backup installation media CA ARCserve Backup Client Agent for Windows This client agent supports the following Windows Server 2008...

Page 11: ...s 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 Red Hat Enterprise Server SLES CA ARCserve Backup Enterprise Option for AS 400 CA ARCserve Backup Client Agent for Mac OS X CA ARCserve Backup Enterprise Option for OpenVMS ...

Page 12: ......

Page 13: ...Considerations The following sections include information you should review before installing the client agents Client Agent for Windows Before installing the client agent for Windows review the following considerations Before you can run the client agent for Windows your computer must be configured to communicate using one or more of the following network protocols Transmission Control Protocol I...

Page 14: ... Important If necessary you can install two or more of these communications packages on the same computer however you can run only one package at a time Do not run two or more of these communications packages simultaneously on the same computer Note If you change OpenVMS TCP IP stacks at any time you must reinstall the OpenVMS Enterprise Option You should back up your OpenVMS system disk before in...

Page 15: ...omputers see the platform specific documentation Note By default CA ARCserve Backup communicates using port 6051 Install the Client Agents To install a windows client agent or a cross platform agent use the CA ARCserve Backup for Windows DVD For more information about installing CA ARCserve Backup client agents click the following links on the CA ARCserve Backup installation browser Installation I...

Page 16: ...gt opt CA BABuagent Solaris SPARC 9 10 opt CA ABcmagt opt CA ABuagent Linux SUSE Redhat Linux OES Asianux Miracle Red Flag Turbo Linux opt CA ABcmagt opt CA ABuagent Mainframe Linux Red Hat SUSE opt CA BABcmagt opt CA BABuagent FreeBSD opt CA BABcmagt opt CA BABuagent Debian opt CA ABcmagt opt CA ABuagent ESX opt CA ABcmagt opt CA ABuagent Tru64 opt CA BABcmagt opt CA BABuagent Note The above dire...

Page 17: ...guration see page 55 Adding Client Agents If you have CA ARCserve Backup installed on a Windows server you can add client agents from your network using the Add Import Export Node feature or you can add client agents manually The following sections include information on each of these methods How to Add Import and Export Agents and Nodes Setting up a job in an environment with many agents and node...

Page 18: ... or the Central Agent Admin Add multiple nodes and agents using a csv and txt file 1 From the Backup Manager Source Tab or the Restore Manager Destination Tab select a node 2 Use the Import function on the Add Import Export Nodes dialog and specify the name of the csv or txt file from the user interface The node and agent names are imported from the csv or txt file and are added into the system 3 ...

Page 19: ...olution lets the local Windows computer automatically detect the remote Windows machine s IP address when connecting for backup and restore operations This is the recommended method and works even if you do not know the computer s IP address Note If the target Windows computer has a dynamic IP address using computer name resolution is preferable If you are not adding a Windows client agent if comp...

Page 20: ...ient agent system hive However this feature is unavailable when you use the Client Agent Registry session to restore individual system keys Security Configuration Options The Client Agent for Windows security options are defined on the Configuration dialog Select one of the following types of security System Security Lets you use Windows security to perform backup compare and restore operations Th...

Page 21: ...figuration dialog Enable the Allow multiple simultaneous restore or compare jobs check box on the Configuration dialog if you want the Windows client agent to accept multiple concurrent restore or compare jobs 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 defi...

Page 22: ...dmin 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 2 From the Agent Admin select the Options tab The Configuration dialog opens ...

Page 23: ...em displays a warning when these database files are in use Password Security Select this Security option to set an individual password for security This setting enables the client agent to run under the local system account Password Security is disabled by default Setting Process Priority These settings determine the priority given to the processes needed for the backup restore or compare operatio...

Page 24: ...tion and Post Execution Programs Select the following execution options 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 operation Post execution Enter or select the name of any batch programs for example C WINAGENT PRE CMD that you want to automatically execute after the backup operation Execution ...

Page 25: ...d password should identify a valid user in the local machine s database or in the domain database if the workstation is a member of a domain Also when you specify the account to use it may be necessary to distinguish between two accounts that use the same name such as Administrator by indicating where Windows can find each account You can identify the client object s location by using tree name fo...

Page 26: ...disabled by default You must enable the option for each agent To enable raw backup and restore of a physical disk or volume 1 From the Windows Start menu click Start Programs CA ARCserve Backup and Backup Agent Admin The ARCserve Backup Agent Admin window appears 2 Click Options Configuration The Configuration window appears 3 Click Enable physical disk volume backup and restore 4 Click OK The raw...

Page 27: ...up 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 To configure Windows network communication 1 Open the Backup Agent Admin 2 From the Options menu select Network Configuration ...

Page 28: ...e Implementation Guide Select IP Address The Windows client agent supports the use of multiple network interface cards NICs For computers with more than one network card the agent checks all enabled NICs in the machine You can manually override this selection by choosing the IP address of the NIC that you want to dedicate for backup purposes When you define this configuration the client agent will...

Page 29: ...ent 2 Choose Security from the pop up menu 3 Enter the local Windows user account name or enter the Windows domain account using the tree format 4 Enter the password and click OK Note If you use a client agent to perform remote client backups and restores the password you set for the client agent overrides any shared password set for the workstation If you do not use client agent software for your...

Page 30: ... backup and restore to a specific group of CA ARCserve Backup servers for the particular client agent The ACL type can be No ACL used No list is specified this is the default Include list A list of servers allowed to access the client agent machine for backup and restore options Exclude list A list of servers that are not allowed to access the client agent machine for backup and restore options Al...

Page 31: ... agent names Enable Virus Scanning CA Anti Virus software offers extra protection for your critical data securing it from virus threats even during backup and restore activities Using this option you can configure the Windows client agent to automatically detect and repair viruses during a backup copy count or restore operation To enable virus scanning 1 Open the Backup Manager or the Restore Mana...

Page 32: ...nt Agent for Windows can exclude database and log files from backups of database applications such as Microsoft Exchange and Microsoft SQL Server when performing backups During the backup job the Client Agent for Windows communicates with the database agent to obtain a list of files that the backup job should exclude from the file system backup The Client Agent for Windows then excludes files from...

Page 33: ...ps open NetWare files during a backup When backing up NetWare files using the NetWare client agent in some cases multiple files are detected as open and are skipped during the backup Should this happen select the Retry tab in the Backup Options dialog and then select the Use Lock Mode if Deny Write Fails option in the File Sharing section and resubmit the job NetWare has a 255 character path name ...

Page 34: ...ollowing command at the server console unload nwagent 5 When the client agent has been unloaded restart the client agent that is reload the agent at the server prompt by issuing the following command nwagent A message appears at the server prompt confirming the use of the IP address specified in the ASCONFIG INI file IP Address nnn nnn nnn nnn from ASCONFIG INI file will be used A similar message ...

Page 35: ...X Linux and Mac OS X sessions Single character directory names You may experience display issues in restore views when restoring single character directory names The data appears correctly in the database view Traverse Symbolic Links and Traverse NFS The options Traverse Symbolic Links and Traverse Network File System NFS are not supported for restore operations Note If a configuration discrepancy...

Page 36: ...stem file is stored on the client agent workstation in the uagent home directory Browser Configuration File The Browser Configuration file cabr cfg enables raw devices to be viewed with the browser You must ensure that you have entered the absolute name of the raw device on a separate line in the cabr cfg file Common Agent Configuration File The Common Agent configuration file agent cfg keeps trac...

Page 37: ...om need to modify this configuration file Manual modification of this file is required only to enable some debugging messages or to change the default TCP IP port on which the Common Agent runs A sample agent cfg file with a client agent installed is as follows 0 ABagntux NAME ABagntux VERSION nn nn nn HOME opt CA ABuagent ENV CA_ENV_DEBUG_LEVEL 4 CA_ENV_DEBUG_LEVEL ENV LD_LIBRARY_PATH opt CA CAli...

Page 38: ...t type a predefined number of a specific client agent in the network for UNIX and Linux 4 Object type a predefined number of a specific client agent in the network for Mac OS X NAME ABagntux Name of the client agent VERSION nn n Release and version number of the client agent HOME opt CA ABuagent Default home directory for the client agent ENV CA_ENV_DEBUG_LEVEL 4 Environment variable passed to the...

Page 39: ...t 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 Not all client agents have all of these components For example in the following sample configuration file you can see the BROWSER component cabr the AGENT component uagentd and the MERGE and VERIFY component umrgd in the sect...

Page 40: ...X Linux and Mac OS X configuration files The following example shows the Windows server configuration file CAPortConfig cfg Hostname IP address optional TCP port UDP port myhost xxx xxx xxx xxx 6051 6051 The following example shows the syntax for the client agent configuration file agent cfg 36 NAME ABcmagt HOME opt CA ABcmagt TCP_PORT 7090 UDP_PORT 7085 Common Agent Port Numbers By default the Co...

Page 41: ...nfig subdirectory under the home directory BAB_HOME config port cfg on the backup server By default the Common Agent uses another UDP port 0xA234 41524 to receive CA ARCserve Backup requests for the Auto Discovery of UNIX Linux and Mac OS X client agents This port is not configurable Host Equivalence User Credentials When the Common Agent checks user credentials it gives preference to host equival...

Page 42: ...the specified component Only after it has validated both the client agent and the requested component does the Common Agent activate the client agent and the component The Common Agent then returns to a state of waiting for additional requests Configurable Options Options are used to optimize and customize the operation of the client agent However none of these options are required for the client ...

Page 43: ...ple CAUSER A USER1 N USER2 In this example A means ALLOW and N corresponds to DENY Option Description DENY network address host address Use this option with Single User mode with the S or NOPASSWORD option to define the IP addresses that are not allowed access to the client agents For example DENY 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...

Page 44: ...ill be treated as the filename S Enables the Single User mode option In Single User mode user credentials are not checked against valid user IDs and passwords Instead access is granted based on the ALLOW DENY or CAUSER options For more information see the specific option s async nonblocking Sets socket I O to asynchronous nonblocking mode s bufsize Specifies the size of the socket buffer Options a...

Page 45: ...X and UFS with fssnap installed on Solaris The client agent mounts the snapshot to a temporary directory created in the root volume and then generates the snapshot backup After the snapshot backup is complete the client agent dismounts from the temporary directory and deletes the snapshot To perform a snapshot backup you must specify a snapshot buffer A snapshot buffer is the disk space used to st...

Page 46: ...bled the logging flag in the caagperf cfg file The following sections describe how to configure a UNIX client agent to use these features Configure Snapshot and Direct I O To configure the Snapshot and Direct I O features follow these steps 1 Enable the environment variable CAAGPERF_ENABLE by adding the following line in the agent cfg file ENV CAAGPERF_ENABLE 1 Note The agent cfg file is in the op...

Page 47: ...ng By default all options are disabled If no special processing is needed for a volume that volume should not be in the caagperf cfg file The keys and their values are described in the following table Key Value DOSNAP Enables the Snapshot feature on a volume The value should be BACKUP meaning that a snapshot should be taken during the backup operation SNAPSHOTBUFFER Specifies the buffer used for s...

Page 48: ...and the section has Direct I O enabled for backup and restore DEBUG opt DOSNAP BACKUP SNAPSHOTBUFFER garbage snapbufferfile_1 export home DOSNAP BACKUP SNAPSHOTBUFFER garbage snapbufferfile_2 DOUBIO BACKUP_RESTORE Example Solaris 8 operating system with the advanced version of the VxFS file system installed The file contains three sections The first line of the file is a debugging flag The three s...

Page 49: ...r the AS 400 Enterprise Option Occasionally based on instructions from CA 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 CA Technical Support The following table shows all of the AS 400 Enterprise Option trace le...

Page 50: ... can use two types of ACLs with the UNIX Linux or Mac OS X client agent Example Allow or Deny Users An access control list can deny or allow specific users to perform backups or restores For example a part of the agent cfg file is shown in the following sample You need to make similar changes for other client agent sections if you want to apply ACLs to those client agents too 0 NAME ABagentux VERS...

Page 51: ... 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 You can apply both types of ACLs concurrently In each case DENY takes precedence over ALLOW In the Single User mode all operations on the client agent ar...

Page 52: ...h 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 If the Linux client agent is running on a 64 bit Linux system you must ensure that the libacl so library is a 32 bit version You can check t...

Page 53: ... 64 bit Mainframe Linux platform cd lib ln sf libacl so 1 libacl so Use the appropriate link command for your 64 bit Linux system 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 star...

Page 54: ...y level backups Use the Use QaneSava flag to toggle between ON and OFF With the Use QaneSava flag set to ON back ups are executed without creating a temporary SAVF file By setting the flag to OFF backups are executed and will create a temporary SAVF file Use the Library level backup flag to control the backup of libraries When the Library level backup flag is set to ON the SAVLIB command is applie...

Page 55: ...ackup feature does not support incremental and differential backups 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 Type your preferences and press Enter OpenVMS Enterprise Option Configuration Other than the port addre...

Page 56: ...t these values to the largest value allowed by the specific stack installed on the 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 Because tracing levels can affect backup performance do not change the values unles...

Page 57: ...statistics apply only to Windows and NetWare View Runtime Statistics for the Client Agent for Windows CA ARCserve Backup lets you view runtime statistics for computers running the Client Agent for Windows To view runtime statistics for the Client Agent for Windows 1 From the Windows Start Menu select Programs CA ARCserve Backup and click Backup Agent Admin The Backup Agent Admin opens 2 Select Con...

Page 58: ...C keys simultaneously to display a list of current windows and then you can choose the Runtime window 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 ...

Page 59: ...ts by selecting View nwagent log at the console 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 The uag log file records all activities and errors that occur during machi...

Page 60: ...cords information on CA ARCserve Backup browsing activities 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 is created for each job and every subsequent...

Page 61: ...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 Select the log files you want to delete and click Delete as shown in the following illustration ...

Page 62: ...cted 8 If you are prompted for security enter the appropriate security for your environment 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 Windows Start and Stop Requirement The Windows clie...

Page 63: ...at this file was created and stored properly in the SYSTEM directory on the NetWare server s SYS volume 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 st...

Page 64: ...un the configuration script uagentsetup 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 type the following command at the command line uagent stop Common Agent Start and Stop Status Whenever a client agent is started or stopped the UNIX Linux or Mac OS X system scripts modify the agent cfg file by marking the client agent entry in the...

Page 65: ... If this command fails the client agent may need to be configured To configure the client agent run the following script abuagent uagentsetup In this example abuagent represents the full path name of the agent home directory The default path is opt CA ABuagent Enterprise Option for AS 400 Start and Stop Requirement You must have JOBCTL job control authority to start or stop the client agent Start ...

Page 66: ...mmand 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 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 a...

Page 67: ...ion file 45 46 caagperf log file 45 cabr cfg Browser Configuration file 35 CAPortConfig cfg configuration file 40 example 27 check agent status OpenVMS 66 UNIX Linux Mac OS X 64 commands rm uag log 61 ABuagent uagentsetup 64 bab shutdown com OpenVMS 66 bab startup com OpenVMS 66 caagent 40 endaso AS 400 65 mount 45 nwagent 63 print filename to view logs 59 straso AS 400 65 uagent status 64 Common ...

Page 68: ...L library version 52 log files activity 58 caagperf log 45 deleting 61 nwagent log 59 M manager interface for Windows 18 N NetWare ASCONFIG INI 33 configuring client agent 33 CSLOADER NLM 63 NDS 34 network client facility 63 nwagent command 63 open files 33 path name 33 unload nwagent command 63 network interface cards NIC IP address 27 Novell directory services NDS 34 nwagent command 63 nwagent l...

Page 69: ...S 400 49 OpenVMS 56 U uag cfg 35 uag cntl Directory Control file 35 uag log activity log file 59 uagent command 64 uagentsetup script 64 UDP port Common Agent 40 unload nwagent command 63 user access Common Agent 41 V virus scanning 31 W Windows Backup Agent Admin 22 enable virus scanning 31 IP address 27 password security 22 port number 27 process priority 22 shares support 20 system hive restore...