Loading...

Log Files - Advanced

Table of Contents

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.

Sending Log Files to an FTP Location

  1. From the CommCell Browser, right-click the CommServe, MediaAgent, or client, point to All Tasks, and then select Send Log Files.
  2. On the Computers tab, select the name of the client computer for which you need the logs.
  3. On the CommCell Information tab, select the CommCell logs to be uploaded from the following list:
    • CommServe Database
    • Get Latest Database(s)

      If you select this option, a disaster recovery job will run on the CommServ database, and the logs from that disaster recovery job will be sent.

    • Database Logs
  4. On the Machine Information tab, select the client logs to be uploaded from the following list:
    • Logs
    • OS Logs
    • Process Dump
    • Job Results
    • Index
    • Include database used for Optimized Scan
    • To mask host names, IP addresses, and file paths, select Scrub Log Files.
  5. On the Output tab, select Output to and browse to a local folder where the logs can be collected.

    Ensure that the Upload and Email checkboxes are not selected.

  6. Click OK.
  7. When the operation is complete, upload the log files to http://upload.netapp.com (see NetApp KB article 1010090).

Enabling a Passive FTP Connection

If you are using an FTP server to upload the log files, by default, the client connects to the Server through port 21 of the Server. However, you can enable a passive FTP connection, where the client first receives the port number to be used for connection from the Server and then connects to the Server using the specific port number.

Use the following steps to enable passive FTP connection:

  1. In the CommCell Console, right-click the CommServe, MediaAgent, or Client, point to All Tasks, and then select Send Log Files.
  2. On the Computers tab, select the name of the client computer for which you need the logs.
  3. On the Output tab, select the Use Passive FTP Connection check box.
  4. Click OK.

Sending Log Files to an HTTP or HTTPS Location

You can upload the log files to an HTTP or HTTPS website that is defined in the Control Panel. By default, log files are sent to https://logs.commvault.com/webconsole. To configure a different HTTP or HTTPS website, see Configuring the Default HTTP or HTTPS Location.

  1. In the CommCell Console, right-click the CommServe, MediaAgent, or Client, point to All Tasks, and then select Send Log Files.
  2. Select the name of the client computer for which you need the logs.
  3. Click the CommCell Information tab and select the CommCell logs to be uploaded from the following list:
    • CommServe Database
    • Get Latest Database(s)

      If you select this option, a disaster recovery job will run on the CommServ database, and the logs from that disaster recovery job will be sent.

    • Database Logs
  4. Click the Machine Information tab and select the client logs to be uploaded from the following list:
    • Logs
    • Machine Configuration
    • OS Logs
    • Process Dump
    • Job Results
    • Index
    • Include database used for Optimized Scan
    • To mask host names, IP addresses, and file paths, select Scrub Log Files.
  5. On the Output tab, select Upload, and then select Upload to HTTP Server.
  6. Click OK.

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 Internet gateway client to connect to the Internet, you must use that client as an HTTP proxy server for sending log files to an HTTP location.

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

    The Control Panel window is displayed.

  2. In the Maintenance section, click Internet Options.

    The Internet Options dialog box is displayed.

  3. On the HTTP Proxy tab, select the Use HTTP Proxy Server check box and provide the following details:
    1. In the Proxy Server box, type the hostname of the HTTP proxy server.
    2. In the Proxy Port box, type the port used by the HTTP proxy server. By default, the port is 1025.
    3. If you need to configure user authentication for the proxy server, select the Use Authentication check box and provide the user credentials to access the HTTP proxy site.
  4. Click OK.

Related Topics

Using an Internet Gateway to Send Log Files

If the CommServe computer has no Internet connectivity, you can use the Private Metrics Reporting Server or a client computer as an Internet gateway to send log files. The Internet gateway computer downloads the log files locally, and then transfers the software to the CommServe cache. The log files are removed from the Internet gateway computer after the transfer.

About This Task

When you specify a client as the Internet gateway, the following services will use the Internet gateway:

  • Cloud Metrics Reporting
  • Private Metrics Reporting
  • Download Software
  • Log Monitoring Cloud Policies

When you specify the Private Metrics Reporting Server as the Internet gateway, the following services will use the Internet gateway:

  • Cloud Metrics Reporting
  • Send Log Files

Procedure

  1. On the CommCell Console ribbon, click the Control Panel button.
  2. Click Internet Options.
  3. On the Internet Gateway tab, select which computer to use as an Internet gateway:
    • To use the Private Metrics Reporting Server as an Internet gateway, click Metrics Server.
    • To use a client computer as an Internet gateway, click Use Client, and then in the Client list, select the name of the computer you want to use as a gateway.

      Note: Only clients connected to the Internet appear in the list.

  4. Click OK.

Uploading Log Files Using the Last Successful Method

You can upload the log files using the last method that was successful. For example, if the last successful upload used the FTP method, then the log files will be sent using FTP.

  1. In the CommCell Console, right-click the CommServe, MediaAgent, or Client, point to All Tasks, and then select Send Log Files.
  2. Select the name of the client computer for which you need the logs.
  3. Click the CommCell Information tab and select the CommCell logs to be uploaded from the following list:
    • CommServe Database
    • Get Latest Database(s)

      If you select this option, a disaster recovery job will run on the CommServ database, and the logs from that disaster recovery job will be sent.

    • Database Logs
  4. Click the Machine Information tab and select the client logs to be uploaded from the following list:
    • Logs
    • Machine Configuration
    • OS Logs
    • Process Dump
    • Job Results
    • Index
    • Include database used for Optimized Scan
    • To mask host names, IP addresses, and file paths, select Scrub Log Files.
  5. On the Output tab, select Upload, and then select Automatic.
  6. Click OK.

Sending Log Files Using Email

To send log files immediately, you can send them to one or more email recipients. The email recipients can be user groups created within the CommCell Console as well as external domain user groups.

Caution: Log files can be large files, and emails with large file attachments are often rejected by email servers. To send an email notification instead of sending the log files by using email, see Setting Up Email Notifications.

Before You Begin

A mail server must be configured in the CommCell Console. For information on configuring an email server, see E-Mail Server Configuration.

Procedure

  1. From the CommCell Browser, right-click the CommServe, MediaAgent, or client, point to All Tasks, and then select Send Log Files.
  2. On the Computers tab, select the name of the client computer for which you need the logs.
  3. On the CommCell Information tab, select the CommCell logs to be uploaded from the following list:
    • CommServe Database
    • Get Latest Database(s)

      If you select this option, a disaster recovery job will run on the CommServ database, and the logs from that disaster recovery job will be sent.

    • Database Logs
  4. On the Machine Information tab, select the client logs to be uploaded from the following list:
    • Logs
    • Machine Configuration
    • OS Logs
    • Process Dump
    • Job Results
    • Index
    • Include database used for Optimized Scan
    • To mask file locations and machine names, select Scrub Log Files.
  5. On the Output tab, select Attach logs to E-mails.

    Caution: Log files can be large files, and emails with large file attachments are often rejected by email servers.

  6. On the Notifications tab, select the Email check box.
  7. In the Available Users and User Groups list, select the users who should receive the log files, and then click the right arrow button (>).
  8. In the Additional Recipients box, type the email addresses for additional users who are not part of the CommCell Group.
  9. In the Subject (Ticket Number) box, type the subject for the email notification.
  10. Optional: In the Problem Description box, type a description of the problem that requires troubleshooting.
  11. Click OK.

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.

Saving Log Files to a Disk

You can save the selected logs to your local disk or to any network path using the following steps:

Saving Log Files to a Local Disk

  1. From the CommCell Console, right-click the CommServe, MediaAgent, or Client, point to All Tasks, and then select Send Log Files.
  2. On the Computers tab, select the name of the client computer for which you need the logs.
  3. On the CommCell Information tab, select the CommCell logs to be saved.
  4. On the Machine Information tab, select the client logs to be saved:
    • Logs
    • Machine Configuration
    • OS Logs
    • Process Dump
    • Job Results
    • Index
    • Include database used for Optimized Scan
    • To mask host names, IP addresses, and file paths, select Scrub Log Files.
  5. On the Output tab, select the Output To check box.
  6. Select Local Path, and then in the box, type the path where the log files need to be saved.
  7. Click OK.

Saving Log Files to a Network Location

  1. From the CommCell Console, right-click the CommServe, MediaAgent, or Client, point to All Tasks, and then select Send Log Files.
  2. Select the name of the client computer for which you need the logs.
  3. On the CommCell Information tab, select the CommCell logs to be saved.
  4. On the Machine Information tab, select the client logs to be saved:
    • Logs
    • Machine Configuration
    • OS Logs
    • Process Dump
    • Job Results
    • Index
    • Include database used for Optimized Scan
    • To mask host names, IP addresses, and file paths, select Scrub Log Files.
  5. On the Output tab, click the Save tab.
  6. Select Output To, and then select Network Path.
  7. Click Impersonal User.

    The Change User Account dialog box appears.

  8. Select Use This Account.
  9. Type the user name and password that will be used to access the network location, and then click OK.
  10. In the box, type the network path where the log files are saved.

    Alternatively, you can click Browse to select the location.

  11. Click OK.

Sending Log Files for a Job

You can upload, save, or e-mail the log files of a specific job based on the Job ID. Alternatively, you can email the log page of the job to an email recipient as described in Sending a Log File Page.

SAP for Oracle jobs and clients include, the SAPARCH directory content and SAPBACKUP directory content in addition to the logs.

  1. From the CommCell Console, right-click the CommServe, MediaAgent, or Client, point to All Tasks, and then select Send Log Files.
  2. Click Job ID and type the job ID number in the box.
  3. Click the CommCell Information tab and select the CommCell logs to be saved.
    • CommServe Database
    • Get Latest Database(s)

      If you select this option, a disaster recovery job will run on the CommServ database, and the logs from that disaster recovery job will be sent.

    • Database Logs
  4. Click the Machine Information tab and select the client logs to be saved.
    • Logs
    • Machine Configuration
    • OS Logs
    • Process Dump
    • Job Results

      The Job Results option includes backup.out/restore.out files.

    • Index
    • Include database used for Optimized Scan
    • To mask host names, IP addresses, and file paths, select Scrub Log Files.
  5. Click the Output tab and then select the output method to be used.
  6. Click OK.

You can also configure the send log files operation to include the output package of the cvsnapcore utility. The cvsnapcore utility collects the executable file and shared libraries from a core dump file. For more information, see FAQ - Collect the executable file and shared libraries from a core dump file.

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.

Setting Up Email Notifications

When uploading log files to an FTP or HTTP location or saving the log files to a local or network location, you can configure a notification email to be sent to users when the upload or save operation completes or fails.

Use the following steps to set up e-mail notifications:

  1. From the CommCell Browser, right-click the CommServe, MediaAgent, or client, point to All Tasks, and then select Send Log Files.
  2. After making your log file selections, click the Notification tab.
  3. Select the Email check box.
  4. Select the users to notify from the Available User and User Groups list, and then use the right arrow button (>) to add them to the Users to be Notified list.
  5. In the Additional Recipients box, type the email address for additional users who are not part of the CommCell Group.
  6. In the Subject (Ticket Number) box, type the subject for the email notification.
  7. Optional: In the Problem Description box, type a description of the problem that requires troubleshooting.
  8. Click OK.

Setting Timeout Period for Uploading Log Files

When uploading log files to an FTP location takes a long time, by default, the upload operation will timeout after 60000 milliseconds. You can change this default timeout period using the following steps:

  1. Open Registry Editor (Regedit.exe or Regedt32.exe).
  2. Expand HKEY_CURRENT_USER > Software > Microsoft > Windows > CurrentVersion, and then click InternetSettings.
  3. Click the Edit menu, point to New, and then select DWORD Value.
  4. Type KeepAliveTimeout as the registry key name, and then press ENTER.
  5. Select the KeepAliveTimeout registry key, click the Edit menu, and then select Modify.

    The Edit DWORD Value dialog box appears.

  6. In the Value data box, enter the amount of time, in milliseconds, that you want to wait before the upload times out.

    For example, if you want the upload to time out after 2 minutes, enter 120000.

  7. Click OK to save your settings.

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

It is recommended that you use this method to send log files from the command line.

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.