How to use, configure and troubleshoot CAReport ... - SupportConnect

How to use, configure and troubleshoot CAReportcommand in addition using Alert Email/SMTP functionContentsINTRODUCTIONRequirement SummaryExternal Software DependenciesHardwareIMPLEMENTATION STEPSCreate CAReports generic job with Jobscheduler WizardStart Generic CAReports job to create the report and sent to per email to AlertEmailCreate Custom Reports Using the Report Writer UtilitySetting up Alert Manager for Email Alert with the attached Report by MSExchange Server or SMTPAppendixHow to Debug CAReports activity and alerts to Email

Requirement Summary1. BrightStor ARCserve Backup Server2. BrightStor ARCserve Backup Manager3. Alert ManagerExternal Software DependenciesExchange Server 2000/2003HardwareNoneIntroductionThe purpose of this document is to show how to create a BrightStor ARCserveBackup Report using the Job scheduler Wizard and Report Writer. In addition tothis description Alert Manager will be configured to get these Reports by Email orSMTP. The Appendix will contain Debug settings for the different topics discussedin this document.

The Job Scheduler Wizard screen opens.Select ‘Use Default Server’ and hit ‘Next’This opens the Command dialogue – you use this to select commands and the appropriate‘switches’ to run with the commands.

NOTE: Both path to the report name and the output name MUST be shownCAReports -r "C:\Program Files\CA\BrightStor ARCserveBackup\Templates\Reports\Daily Job StatusReport.xml" -o "C:\ProgramFiles\CA\BrightStor ARCserve Backup\testreport1_lecjo01a.xml" -f xml –alertNOTE: Parameter –s is not listed here as it would prevent showing what’s happening inthe background after the job starts. Use –s to run it in silent mode.

If all of your selections appear correctly, hit the Submit button.NOTE: Enter the description to find the job in large job status lists and submitNOTE: exit Job scheduler by selecting “X” in the upper right corner.

Start Generic CAReports job to create the report and sent to per email to AlertEmail

While waiting, ARCserve Backup will open the Report Writer to show the newly-createdreport from the template. Please do not save as this is the template filled with data fromthe ARCserve Database. Just exit to continue…..NOTE: You can prevent this window by using the option – s for silent mode

This window shows the job finished successfully…Verified in the Activity Log…

This shows the Alert e-mail being sent for the completed job.

NOTE: In case the files asc.gif, desc.gif and response.xsl were not created, these files areneeded to appropriately display the XML file after creating the report. You can just createthem by opening the Report Writer in ARCserve and create a dummy report.

Create Custom Reports Using the Report Writer UtilityReport Writer is a BrightStor ARCserve Backup utility that you can use to create customreports. You can access Report Writer from the Utilities menu (or the Utilities section) inthe BrightStor ARCserve Backup home page.If you are using a Raima database, the specific ODBC driver must be installed. ReportWriter checks to determine if the Raima ODBC driver is installed and installs itautomatically if the driver is not present.Note: Reports created using Report Writer can be previewed, printed, or scheduled inReport Manager.To create and generate a custom report:1. Open the Report Writer utility by selecting the Utilities menu and then choosingReport Writer.2. Select the File menu and click Open to locate the report you want if you aregenerating a Predefined report. Otherwise, if you are generating a User-defined report, goto Step 3.3. Enter a name for your report in the Report Title text box. Optionally, you canenter a description of your report in the Description text box.4. In the Available Queries table, highlight the source from which you want togather information for your report. When you highlight a source (such as Tape or MediaPool), the Available Columns table is populated with the types of data you can collectfrom the selected source. For example, if you select Job in the Available Queries table,you can choose to collect information about the Job Type, the Job Owner, the Job's StartTime, and several other items.

To select an item to include in your report, highlight the item in the Available Columnstable and click Add. The item will be moved to the Report Columns table.Note: You can create reports made up of information collected from multiple sources.For example, you could create a report that reports on Job Type, Tape Name, and SourceHost.5. Click Next to go to the Report Criteria screen. From this screen, you cancustomize your report in the following ways:• Set the order of the records--The records (or rows) in the columns of your reportcan be sorted in either ascending or descending order. By default, the records areordered in ascending order.• Set the order of the columns--The column at the top of the Report Columns listwill be the first (left-most) column in your report. To change the position of acolumn, highlight it in the Report Columns table and click the up or down arrow.• Set filters--The records for your report can be filtered for specific criteria that youdefine. Use the Enter Value field, along with the Operators and Condition dropdownmenus, to specify the criteria for each type of record (each listing in theReport Columns table) in your report. After specifying a filter, click Add Criteriato add it to the Query Criteria table.For example, to report only on jobs with a Job ID between 150 and 250, follow thesesteps:1. Click Job, Job ID in the Report Columns table.2. Set the Operators drop-down menu to ">=", type 150 in the Enter Value field, andset the Condition drop-down menu to "and." Then click Add Criteria.

3. Set the Operators drop-down menu to "

Save a copy as XML file. Create a folder to store the Reports if you want otherwise usethe ARCserve Home folder.

This shows the file saved to the ‘Testreports’ folder.

Setting up Alert Manager for Email Alert with the attached Report by MSExchange Server or SMTPMS Exchange Server ConfigurationNOTE: Choose the new item from your (Global) Address book.

Choose ‘Message Attributes’Just enter a Subject for your email (This is a subject for ALL Alert mails)Afterwards right click again and logon to the Email system in case it is not the local one

Add Security Information

Send a Test Message to verify connectivity.

Alert SMTP ConfigurationAdd a ‘New Item’Enter the e-mail address and the display name.

For the newly-added name modify the SMTP settings.Please enter SMTP Server name or use the IP address of this server.NOTE: It is recommended to use SMTP Alert system for MS Exchange 2003

AppendixHow to Debug CAReports activity and alerts to EmailPlease enable Job engine to debug more info into the Activity log. Do this by changingthe message output of the Job engine in the ARCserve Backup Server AdminASLoggerd.exe in Debug (Process for Activity log logging)ABNT 11.xX:\Program Files\CA\BrightStor ARCserve Backup\config\asloggered.cfgExample from asloggered.cfg: (# represent commented out lines)### Set up asloggerd debugging mode.### 0: no debugging messages.### 1: to log debugging messages to $(BRIGHTSTOR_HOME)/log/caloggerd.log,### 2: to log debugging messages to system console.DEBUG_MODE = 1Traces to create job tasks logs:Edit MS Registry with “regedit.exe”HKEY_LOCAL_MACHINE\SOFTWARE\ComputerAssociates\BrightStor ARCserveBackup\Base\Task\Common

TraceOperationABNT 11.xHKEY_LOCAL_MACHINE \ Software \ ComputerAssociates \ BrightStor ARCserve Backup \Base \ Task \ CommonValue name: TraceOperationData Type: REG_DWORDData: 1TraceMiscABNT 11.xHKEY_LOCAL_MACHINE \ Software \ ComputerAssociates \ BrightStor ARCserve Backup \Base \ Task \ CommonValue name: TraceMiscData Type: REG_DWORDData: 1TraceTSIABNT 11.xHKEY_LOCAL_MACHINE \ Software \ ComputerAssociates \ BrightStor ARCserve Backup \Base \ Task \ CommonValue name: TraceTSIData Type: REG_DWORDData: 1This will create the following file in the BrightStor ARCserve Backup\Log directory:TskJob##.Log, BrightStor.logIf you encounter problems sending the email by Alert Service enable the followingdebug:

Alert in DebugABNT 9.0 / 11.xHKEY_LOCAL_MACHINE \ SOFTWARE \ ComputerAssociates \ Alert \ CurrentVersion \ServiceHighlight Service, then select Edit Add Key,Key Name: TraceClass: (leave blank), click OKHighlight Trace, then select Edit Add Value,Value Name: (pick from the list below),Data Type: REG_DWORD,click OK, Data: 1 = On, 0 = OffOther acceptable data values = 2, 3 (higher value generating the mostdetail in the log)Application to Trace Value Name Ouput FileMS Exchange ExchPstr AlrtExch.logMS Mail MsmlPstr AlrtMsml.logUnicenter TNGPstr Alrt_TNG.logLotus Notes NotePstr AlrtNote.logSMTP SMTPPstr AlrtSMTP.logAlert API AlBuild Alert.log