You can use the options in the Send Log Files dialog box to configure the types of logs to send, the location where you want to send the logs, the users you want to notify about the logs, and when to send the logs.
Computers
You can use this tab to select job IDs and computer options.
Jobs: To send the log files for jobs based on the job ID assigned by the Job Manager, select this option, and then enter the job IDs. Separate each job ID with a comma (,), semicolon (;), or space.
-
If selected, only the logs associated with the job IDs are included.
-
If cleared, logs from all jobs run on the selected computers are included.
This option is turned off by default.
Computers: To send the log files for one or more computers, leave this option selected.
Show only selected: Select this option to view only those computers that you selected in the Computers list.
Search Content: Select this option to enable searching the log files and returning only those lines that match a given text string.
Search Text: Enter the text string to be searched for in the log files.
CommCell Information
You can use this tab to select the CommCell information you want to include with the log files.
CommServe Database: To include the CommServe database log files, select this option.
Get Latest Database(s): When selected, this option runs a new disaster recovery backup on the CommServ database, and then includes the latest database log files.
In situations where the send log file action is triggered while a DR backup job is in progress, a new DR backup job will NOT be initiated. Instead the Send Log Files job will simply wait for the running DR Backup job to end, to collect the latest database. If necessary, you can setup the nMaxWaitingTimeForRunningDR additional setting to the CommServe computer, to set the maximum waiting time for the DR Backup job.
Database Logs: When selected, this option includes the error logs from the CommServe Database Engine. Database dump files are not included in the Send Log Files bundle that is sent through email.
Other Databases (CVCloud, Workflow): When selected, this option includes the log files for the CVCloud database, the Workflow database, and other databases created for Commvault software.
Machine Information
You can use this tab to select system configuration and performance logs to be included with the log files, if any.
Logs: Select this option if you wish to include logs for jobs. If logs are sent for the CommServe, existing globalflaginfo.log files are included. Globalflaginfo.log files are created by the Microsoft Global Flags Editor (GFlags) debugging tool. For information on GFlags, go to the Microsoft Developer Network website.
-
Log Fragments for this job only
Select this option if you wish to include logs for a specific job.
Machine Configuration: Select this option if you want to include information such as the number volumes, amount of used space, and how many processes are running on the CommServe computer.
OS Logs: Select this option if you want to include file system and application event information, including the event logs.
Process Dump: Select this option to include a system failure dump. For example: the Dr. Watsons file for Windows or core files for UNIX.
Job Results: Select this option if you want to include job results from the CommServe computer. The Job Results option also includes backup.out/restore.out files.
Index: Select this option if you want to include the index that was created during the selected backup job, or the latest index created for the selected client or subclient.
Include database used for Optimized Scan: Select this option if you want to include the database used for the Optimized Scan feature.
Scrub Log Files: Masks host names, IP addresses, and Windows and UNIX file paths in the collected log files by replacing them with the text, "Masked."
The following data is considered for scrubbing:
-
Client and host name of the CommServe computer, client, MediaAgent and other entities.
-
Client name, CommServe computer or MediaAgent name, and host name of the client and MediaAgent.
-
Pipeline (end name of source and destination).
-
IP address, Windows or UNIX path, or UNC path.
-
All Commvault user and group names.
-
The hostname and IP address in the system configuration file: <windows installation>windows/system32/drivers/etc/host.
The path for the scrub configuration file is <commvault installation>/reports/sendlogfiles/scrub.config.
Each line in the scrub configuration file uses sensitive keyword. The user can customize the sensitive keywords in the configuration file.
The following are the example file format:
-
CustomizedData001
-
localServer001
Note: If the srub.config file is not configured properly then the load to the scrub log bundle increases by a tremendous amount. Avoid using words like 'a', 'in', and 'the' in the file format.
Collect Hyperscale information: Select this option if you want to collect HyperScale logs (such as glusterfs) from nodes.
ESX Hosts
You can use this tab to specify which ESX logs to send.
Add: Click this button to open the Browse dialog box.
Browse Dialog Box: In this dialog box, select the ESX hosts that you want to send log files for. Click OK to close the dialog box.
Remove: Use this button to remove ESX hosts from the list. Select an ESX host in the list, and then click Remove.
Output
You can use the options on this tab to send or save the log files to a particular location, to attach log files to an email, and to configure the chunk size of log files.
Upload to HTTPS: Leave this option selected to send the log files to the default HTTPS location. This option is selected by default.
Output To: To save the log files to a location on the CommServe computer, or to another computer on the network, select this option.
-
Local Path: To send the log files to a location on your computer, select this option .
-
Network Path: To send the log files to another computer in your network, select this option.
-
Impersonate User: To configure the user account and password that is used to access the network path, click this button.
The Change User Account dialog box appears.
Enter the credentials for the network path.
-
Browse: Allows you to navigate the directory to which you want to save the log files.
Attach Logs to Emails (not recommended): Select this option to attach the log files to an email. Log files can be large files, and emails with large file attachments are often rejected by email servers. Therefore, we do not recommend you send log files as an email attachment.
Enable Chunking: Leave this option selected to split large log files into smaller file chunks during the upload process. This option helps to avoid time delays due to uploading large file sizes. By default, log files are chunked into 512 MB files that are named with an incremental suffix, such as .001. This option is selected by default.
If you clear this option, log files are sent in one large file and might cause upload delays.
- Chunk file size: Enter the maximum size (in MB) for log file chunks. After the log file reaches this size, it will split into an additional file. The default chunk size is 512 MB.
Notification
You can use this tab to configure notifications to users about sending log files.
E-mail: If you anticipate the size of the log files will exceed the limits set by the designated mail server, you can configure the software to send portions of the log files through multiple e-mail notifications. Once the e-mail notifications are received, the receiver can concatenate the log files and view them in their entirety.
-
Available Users and User Groups: Users that are able to receive notifications.
-
Users to be Notified: Add or remove users within the domain that should receive notifications using the arrow buttons provided.
-
Additional Recipients: If you want to send the log files to anyone else, type the e-mail addresses in this box.
-
Include me in Email: Select this check box to have the software automatically send you the notifications.
-
Subject (Ticket Number): Type a subject or ticket number to be included in the subject line.
Problem Description: In this box, type the details of the specific problem encountered.
Job Initiation
You can use this tab to configure scheduling options.
Immediate: Specifies this job will run immediately.
Schedule: Specifies this job will be scheduled. When you click Configure, the Schedule Details dialog box will open and allow you to configure the schedule pattern.
Save As Script: Click to open the Save As Script dialog, which allows you to save this operation and the selected options as a script file (in XML format). The script can later be executed from the Command Line Interface using qoperation execute command.
When you save an operation as a script, each option in the dialog will have a corresponding xml parameter in the script file. When executing the script, you can modify the value for any of these XML parameters as per need.
Select the Log File to Open
You can use this tab to view the log files of the selected CommCell resource.
The files that reside on a given computer may differ depending on the role of the computer in the CommCell (CommServe, MediaAgent, Client). A CommServe computer contains only the CommServe log files. A computer that is both a CommServe and a Client contains the log files of both entities.
Logs by Job ID
You can use this tab to view the log files of a specific job based on the job ID assigned by the Job Manager.
Enter Job ID: Enter he ID assigned to the job.
SMTP Parameters
You can use this tab to send a log file to a remote computer.
SMTP Host: The host where the email server exists.
To: The recipient's email address.
From: Your email address.
Subject: The subject of the email.