background image

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. 

The uag.log file records all activities and errors that occur during machine 
backup and restore jobs. Each job is identified numerically in sequence, as well 
as by date and time, in the log display. 

On the client agent machine, you can view the contents of these logs using the 
print 

filename 

command. 

Note:

 All log messages relating to the Common Agent are located in the 

/opt/CA/BABcmagt/logs/caagentd.log file. 

 

Activity Logs on Computer Running the  AS/400 Enterprise Option 

The Enterprise Option for AS/400 creates a log file in the BrightStor ARCserve 
Backup library. The two file members are: 

„

 

AGENT.MBR, which records the activities and errors relating to agent 
operations 

„

 

ASBR.MBR, which records information on BrightStor ARCserve Backup 
browsing activities 

 

Activity Logs on Computers Running the OpenVMS Enterprise Option 

As soon as the agent begins running on the server, BrightStor 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 
startup of the agent. The content of each log file is determined by the level of 
tracing enabled on the agent. 

 

Using the Client Agents  65  

 

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

Page 1: ...BrightStor ARCserve Backup Client Agents Guide r11 5 D01165 2E...

Page 2: ...e and effect Should the license terminate for any reason it shall be the user s responsibility to return to CA the reproduced copies or to certify to CA that same have been destroyed To the extent per...

Page 3: ...Windows and NetWare 13 Access Control Lists for Windows UNIX Linux Mainframe Linux and Mac OS X 13 Extended Attributes for Linux and FreeBSD 13 File System Specific Flags for Linux and FreeBSD 13 Data...

Page 4: ...ation 34 Set a Workstation Password 36 Create Access Control Lists 37 Enable Virus Scanning 38 Customizable Local Options 39 NetWare Client Agent Configuration 39 NetWare related Configuration Notes 3...

Page 5: ...or Mac OS X Client Agent Machine 65 Activity Logs on Computer Running the AS 400 Enterprise Option 65 Activity Logs on Computers Running the OpenVMS Enterprise Option 65 Delete Client Agent Log Files...

Page 6: ......

Page 7: ...provides information on installing configuring and adding client agents for all workstations and servers in your network storage environment Agent Features BrightStor ARCserve Backup client agents ar...

Page 8: ...Client Agent for NetWare BrightStor ARCserve Backup Client Agent for UNIX This client agent supports the following AIX HP UX Solaris Tru64 FreeBSD BrightStor ARCserve Backup Client Agent for Linux Thi...

Page 9: ...ion critical data on your network They help to Facilitate backup of applications or file systems Facilitate monitoring of the backup progress Facilitate monitoring for backup log activities With clien...

Page 10: ...ce group configured to accept ProActive jobs and you should dedicate this device group for ProActive jobs only To configure a device group to accept ProActive jobs click Properties during device group...

Page 11: ...ent agent a full install of eTrust Antivirus is required to use virus scanning and repair For the Windows client agent a full install of eTrust Antivirus is required to receive automatic virus signatu...

Page 12: ...options which let you verify that your data was backed up correctly If you select the Scan Backup Media Contents option BrightStor ARCserve Backup checks the header of each file on the backup media If...

Page 13: ...5 4 will backup and restore ACLs Both default and access ACLs will be supported This feature is not supported in FreeBSD version 4 11 Extended Attributes for Linux and FreeBSD The Client Agent for Lin...

Page 14: ...erformed at the node level On a UNIX or Linux server you can configure the multistreaming level You can have only as many jobs running simultaneously as the number of local and remote devices or group...

Page 15: ...apshot of a UNIX volume mounts the snapshot to a temporary directory created in the root volume and then generates the backup After the snapshot backup has completed the file system agent dismounts fr...

Page 16: ......

Page 17: ...e and a complete list of locations primary service hours and telephone numbers contact Customer Support at http ca com support Installation Considerations The following sections include information yo...

Page 18: ...BrightStor ARCserve Backup installation CD Client Agent for NetWare Before installing the client agent for NetWare review the following considerations The client agent for NetWare can be installed on...

Page 19: ...tions 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 bef...

Page 20: ...the agent cfg file is updated with the new client agent s information You will seldom need to modify this configuration file Manual modification of this file is required only to enable some debugging...

Page 21: ...nn HOME opt CA BABuagent ENV CA_ENV_DEBUG_LEVEL 4 CA_ENV_DEBUG_LEVEL ENV LD_LIBRARY_PATH opt CA CAlib opt CA BABcmagt LD_LIBRARY_PATH ENV SHLIB_PATH opt CA CAlib opt CA BABcmagt SHLIB_PATH ENV LIBPAT...

Page 22: ...If you configure the Common Agent to run on a port other than the default port you should also configure the BrightStor ARCserve Backup server to access this Common Agent You can do this by making an...

Page 23: ...in the chapter Adding and Configuring the Client Agents Access Control List Support for UNIX and Linux BrightStor ARCserve Backup Client Agent for UNIX BrightStor ARCserve Backup Client Agent for Lin...

Page 24: ...te a link to a 32 bit library if necessary Verify the Linux ACL Library Version To check the version go to the directory where libacl so is installed and follow these steps 1 Run ls l libacl so to dis...

Page 25: ...r ARCserve Backup installed on a UNIX or Linux server you must add client agents manually The following sections include information on each of these methods Auto Discover Client Agents on a Windows S...

Page 26: ...riate client agent object such as Windows NT 2000 XP 2003 Systems 3 Choose Add Using Auto Discovery BrightStor ARCserve Backup displays a list of all the machines it finds during Auto Discovery in the...

Page 27: ...can manually add a client agent to a Windows server or NetWare server using the Windows manager interface To manually add a client agent you must add each client agent machine to the Backup Manager T...

Page 28: ...ws computer has a dynamic IP address using computer name resolution is preferable If you are not adding a Windows client agent if computer name resolution fails because of various DNS server or networ...

Page 29: ...for reference on the Client tab of the Database Manager 4 Click OK Note As an alternative method for adding client agents to a UNIX or Linux server you can use the ca_dbmgr command line utility using...

Page 30: ...ystem registry keys during a regular restore of the client agent system hive However this feature is unavailable when you use the Client Agent Registry session to restore individual system keys Securi...

Page 31: ...ore 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 Configuration Options...

Page 32: ...on the specific operating system in use 2 From the Options menu select Configuration 3 Define the security option 4 Define the Backup Priority and Restore Compare Priority option 5 Define the multiple...

Page 33: ...pop up menu to open the Security dialog The User Name field should already contain the client agent s assigned user name 3 Enter the password for the client agent Note The user name and password shou...

Page 34: ...ct Configuration as shown in the following example Configure Windows Network Communication BrightStor ARCserve Backup client agent services are shared across all configured client agents By default Wi...

Page 35: ...tor ARCserve Backup server component To do this you must modify the remote server PortsConfig cfg file For more information on port configuration see the Administrator Guide Enable VI virtual interfac...

Page 36: ...To specify the client agent password in BrightStor ARCserve Backup follow these steps 1 From the Backup Manager right click the name of the client agent 2 Choose Security from the pop up menu 3 Enter...

Page 37: ...lient 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 All other servers in the networ...

Page 38: ...ing for Windows client agents follow these steps 1 Open the Backup Manager or the Restore Manager 2 From the toolbar click the Options button to display the Global Options dialog 3 Click the Virus tab...

Page 39: ...b at a time Trying to submit jobs to the client agent from multiple BrightStor ARCserve Backup servers at the same time may cause the current job to fail BrightStor ARCserve Backup skips open NetWare...

Page 40: ...following line to the end of the ASCONFIG INI file NetWare Agent 3 Save the file and exit from the editor 4 Unload and restart the client agent Unloading is required for changes to the ASCONFIG INI fi...

Page 41: ...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 t...

Page 42: ...rtant information about the UNIX Linux and Mac OS X configuration files The following example shows the syntax for the UNIX and Linux server configuration file port cfg and the Windows server configur...

Page 43: ...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 configurat...

Page 44: ...e is started or stopped and restarted An example of the agent cfg file is shown in the following table with a description of each agent field File Contents Field Description 0 Object type a predefined...

Page 45: ...Common Agent Connection Requests Work To initiate a client agent session the BrightStor ARCserve Backup server requests a connection for a UNIX Linux or Mac OS X client agent to use a specific backup...

Page 46: ...representative Option Description ALLOW network address host address Use this option with Single User mode with the S or NOPASSWORD option to define the IP addresses of computers that are authorized t...

Page 47: ...s and H denotes a host s IP address You can set an optional subnet mask Option Description l Causes the client agent to check for advisory locks The default is mandatory locks only m maxbuf Sets the n...

Page 48: ...s 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...

Page 49: ...lient 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 tem...

Page 50: ...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...

Page 51: ...ial 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...

Page 52: ...P SNAPSHOTBUFFER garbage snapbufferfile_1 export home DOSNAP BACKUP SNAPSHOTBUFFER garbage snapbufferfile_2 DOUBIO BACKUP_RESTORE Configuration File Example 2 This is a sample configuration file for a...

Page 53: ...our sections The first line of the file is a debugging flag The sections in the file are the var usr and export volumes In this file the volume is enabled for Direct I O during backup and restore and...

Page 54: ...n n HOME opt uagent NOPASSWORD CAUSER A CAUSER1 N CAUSER2 NOPASSWORD enables Single User mode and CAUSER specifies the users for whom permission is being granted or denied A stands for ALLOW and N st...

Page 55: ...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 are performed with superuser privileges The caage...

Page 56: ...onfiguration When configuring start preferences you can enable the Library Level Backup feature by setting its value to ON When you enable this feature the SAVLIB command is applied for library object...

Page 57: ...The following table shows all of the AS 400 Enterprise Option trace levels Level Description ASO TRACE This controls the trace depth of the client agent Valid values are 1 and 0 to 0xFFFFFFFF Setting...

Page 58: ...tional configuration after installation Configure Port Address The default TCP and UDP port addresses are both 6050 The TCP port is used for communication and data transfer between the cprocess and th...

Page 59: ...Option Because tracing levels can affect backup performance do not change the values unless you receive specific instructions from Computer Associates Technical Support Level Description ASO TRACE Thi...

Page 60: ......

Page 61: ...ocessed Note Runtime statistics apply only to Windows and NetWare View Runtime Statistics for the Windows Client Agent To obtain runtime statistics for Windows client agents follow these steps 1 From...

Page 62: ...of current windows and then you can choose the Runtime window Activity Logs The server based BrightStor ARCserve Backup system generates an activity log which displays information about all the jobs...

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: ...ck Activity Log to view a list of logs as shown in the following example View Activity Log on a NetWare Client Agent Machine The NetWare client agent writes to the nwagent log which is created in the...

Page 65: ...BABcmagt logs caagentd log file Activity Logs on Computer Running the AS 400 Enterprise Option The Enterprise Option for AS 400 creates a log file in the BrightStor ARCserve Backup library The two fi...

Page 66: ...pen the Backup Manager 2 Click the Source tab 3 Expand the Network object and then expand the Windows NT 2000 XP 2003 Systems network object until you locate the client machine 4 Right click the clien...

Page 67: ...top the Windows client agent The Backup Agent Admin monitors the client agent activity and protects against accidental job failures if the Universal Agent service stops To start or stop a Windows clie...

Page 68: ...CSLOADER NLM to stop the loading sequence Stop the NetWare Client Agent To stop the NetWare client agent issue the following command at the NetWare server console prompt unload nwagent UNIX Linux and...

Page 69: ...d to issue uagent start to enable the BABagntux section of the agent cfg file When you enter the uagent start command the Common Agent status changes from disabled to enabled In summary when a particu...

Page 70: ...he appropriate network credentials to operate the OpenVMS machine on which the client agent resides Start the Client Agent for the OpenVMS Enterprise Option To start the agent log in as system and iss...

Page 71: ...bab shutdown com OpenVMS 70 Common Agent configuration file 43 bab startup com OpenVMS 70 AS 400 BABuagent uagentsetup 69 configuration 55 ca_dbmgr 29 endaso command 58 caagent 21 job control authori...

Page 72: ...lic redundancy check 13 verify ACL library version 24 D log files activity 62 data compression 13 caagperf log 49 Database Manager for UNIX or Linux servers 29 deleting 66 nwagent log 64 Direct I O M...

Page 73: ...command 70 single user mode 54 Snapshot about 49 buffer 49 feature overview 15 features 49 output 49 UNIX support 49 starting client agents 67 stopping client agents 67 straso AS 400 command 70 system...

Reviews: