Log Files - Advanced

Scheduling a Send Log Files Job

Use the following steps to schedule a send log files operation for a job:

1. From the CommCell Console ribbon, on the Home tab, click Job Controller.

2. From the Job Controller window, right-click the desired job and then click Send Log Files.

   The Send Log Files dialog box is displayed.

3. On the Job Initiation tab, select Schedule and then click Configure.

   The Schedule Details dialog box appears.

4. Select the appropriate scheduling options.

   For information on the scheduling options, see Schedule Pattern.

5. Click OK.

You can track the progress of the job from the Job Controller window of the CommCell Console.

Configuring the HTTP or HTTPS Location for Sending Log Files

You can configure the CommServe to send log files to any HTTP or HTTPS location.

1. On the CommCell Console ribbon, on the Home tab, click Control Panel.

   The Control Panel window is displayed.

2. In the Maintenance sections, click Troubleshooting Settings.

3. In the HTTP Location box, type the new HTTP or HTTPS location.

4. In the HTTP User Name box, type the user account to access the HTTP or HTTPS location.

5. In the Password box, type the password for the HTTP or HTTPS user account.

6. In the Confirm Password box, type the password again.

7. Click OK.

Configuring an HTTP Proxy Server for Sending Log Files

If the CommCell computer uses an HTTP Proxy to connect to the Internet, you must use that HTTP proxy server for sending log files to an HTTP location. For instructions, see Configuring an HTTP Proxy Server for the CommServe Computer.

Configuring the Maximum Log Bundle Size for E-Mails

In some cases, when a log file bundle exceeds the maximum allowed size, a separate e-mail with the remainder of the bundle will be sent to the designated recipient.

Once the recipient saves the log files to disk, the log files can be concatenated into their original form by performing the following steps:

1. From the command line, enter the following: copy /B <source_directory>\<log_file_01_name> + <source_directory>\<log_file_02_name> /B c:\<concatenated _log_file_name>.CAB

2. Open concatenated _log_file_name.CAB using the WinZip application.

Use the following steps to change the maximum bundle size for e-mails:

1. From CommCell Console ribbon, on the Home tab, click Control Panel.

2. Under Maintenance, click EMail and Web Server.

   The EMail and Web Server dialog box appears.

3. In the Mail Server Size Limit (MB) box, type the maximum log bundle size for the e-mails.

4. Click OK.

Sending a Log File Page

Once you view the log file for a CommCell component or a job, you can send the existing log file contents to an email recipient using the following steps:

1. From the CommCell Console, right-click the CommServe, MediaAgent, or Client, point to View and then select Log Files.

2. In the Select the log file to open dialog box, select the log file, and then click Open.

   The selected log file appears in the Log File dialog box.

3. Click File, and then select Send Page.

   The SMTP Parameters dialog box appears.

4. In the SMTP Host box, type the SMTP host server address.

   If you are viewing the log files from a client other than the CommServe, make sure the SMTP host is same as the one configured on the CommServe.

5. In the To box, type the e-mail address of the user to whom you want to send the log page.

6. In the From box, type the e-mail address of the sender.

7. In the Subject box, type the e-mail subject for the log page.

8. Click OK.

Configuring Removal of Non-Log Files

In the log files directory, non-log files are deleted after 90 days by default. You can use this additional setting to configure the number of days a non-log file is saved in the log file directory.

1. In the CommCell Browser, right-click the CommServe computer, and then click Properties.

2. On the Additional Settings tab, click Add.

   The Add Additional Settings dialog box appears.

3. In the Name box, type nDelete_NonLogFiles_OlderThan.

   Alternatively you can click Lookup and search for the additional setting using the Find box

4. In the Category box, select or type EventManager.

5. In the Type box, select or type Integer.

6. In the Value box, type the number of days you want non-log files to be saved.

   The minimum value is 7, and the maximum value is 365.

7. Click OK to close the Add Additional Settings dialog box.

8. Click OK to close the CommCell Properties dialog box.

Manage Compression Settings

By default, log files are compressed into the 7ZIP format during the Send Log Files operation. You can further configure the 7ZIP compression process by specifying a compression level, protecting log files with a password, or create a log of the compression process.

Set the Compression Level

Set the level of file compression for the 7ZIP format by specifying a numeric value. The higher the value, the higher the compression rate, and the slower the compression speed. The higher the compression level, the more resources required to run the compression.

1. In the CommCell Browser, right-click the CommServe computer, and then click Properties.

2. On the Additional Settings tab, click Add.

   The Add Additional Settings dialog box appears.

3. In the Name box, type nLogCompLevel.

4. In the Category box, select or type EventManager.

5. In the Type box, select or type INTEGER.

6. In the Value box, type the number for the compression level that you want:

   Compression Level	Description
   0	Store
   1	Fastest
   3	Fast
   5	Normal
   7	Maximum
   9	Ultra

   Note: If you type any other number, the value defaults to 9.

7. Click OK.

8. Click OK.

Enable Password Protection

Create a password that users must enter to open the compressed log file.

1. In the CommCell Browser, right-click the CommServe computer, and then click Properties.

2. On the Additional Settings tab, click Add.

   The Add Additional Settings dialog box appears.

3. In the Name box, type sLogPassPhrase.

4. In the Category box, select or type EventManager.

5. In the Type box, select or type STRING.

6. In the Value box, type the password that you want to use for opening the compressed log file.

7. Click OK.

8. Click OK.

Create a Log of the Compression Process

1. In the CommCell Browser, right-click the CommServe computer, and then click Properties.

2. On the Additional Settings tab, click Add.

   The Add Additional Settings dialog box appears.

3. In the Name box, type b7ZipDebug.

4. In the Category box, select or type EventManager.

5. In the Type box, select or type STRING.

6. In the Value box, type 1.

7. Click OK.

8. Click OK.

Command Line Operations

You can run the Send Log Files operation from the command line with a custom script that you create.

Creating a Custom Send Log Files Script

You can customize the send log files operation, and then run the script that you create from the command line. According to the options that you select, the log files are sent to the specified recipient e-mail address or stored on a local directory on the CommServe computer.

To create a custom Send Log Files operation:

1. From the CommCell Console, right-click the CommServe, point to All Tasks, and then select Send Log Files.

2. On the Computers tab, select the computers for which you want to send log files, and then click Save As Script.

   The Save As Script dialog box appears.

3. In the File Path box, enter the location and file name for the send log files script, and then click OK.

   The script is saved in the location that you specified.

4. To send log files, run the script from the command line.

Related Reports

Job Summary

Each time you send a log file, the operation is logged as an administrative job and can be seen in the Job Summary Report.

The Job Summary Report displays all data management, data recovery, and administrative jobs that ran in the CommCell during a specified period of time. The report also includes information about all media options. For more information, see Job Summary Report.