In the CommCell Browser, right-click the CommServe, click All Tasks, and then select
Send
Log Files. The Send Log Files window is
displayed.
From the General tab, provide the following information:
one or more recipient email addresses (multiple email addresses
separated by a comma)
a Subject (Ticket Number)
a Problem Description
From the Computers tab, choose the appropriate Job ID if
you are sending the log files of a specific job.
If you wish to send the log files to specific computer(s), you can select and move
the appropriate client computers from the Available Computers
list to the Selected Computers
list.
From the CommCell Information tab, select the following options,
if desired:
CommServe if you wish to include the
CommServe database log files.
SRM Database if you wish to include the SRM database log
files.
Database logs if you wish to include the error logs for the
CommServe Database Engine.
From the Machine Information tab, select the log information you wish
to include, if any.
From the Output tab, select the following options:
If you wish to upload the log files to an existing FTP and/or HTTP location, select
the Upload to FTP Location and/or Upload to HTTP Server check box.
If Upload to HTTP Server is selected, you can define a proxy
server by clicking Proxy Settings.
If you wish to send the log file information immediately, select the
Email
to Recipients box. Type the address of the recipient(s) who are to
receive the log file information.
To send log files to multiple
recipients, select the desired recipients in the Available Users
field. You can then add or remove the desired recipients from the
Users to be Notified using the appropriate arrow buttons. Note that
log files can be configured to be sent via e-mail to user groups created
from within the CommCell Console as well as external domain user groups.
To save the log files to a specific directory on the CommServe disk, select
the Save to Folder check box. You can either type or browse the
CommServe local path.
In order to save the log files to the CommServe
disk, the user must have Administrative Management capability at
CommServe level.
Click Ok.
Command Line Interface - Send Log Files
Before you Begin
Ensure that you have a product capable of opening tar files.
Ensure that a mail server is defined in the CommCell Console.
Ensure that you are running the utility from the CommServe computer when using the
command line.
Specify a valid e-mail address or local destination path on the
CommServe to store the log files.
To send log files from the command line, navigate to the
<software installation path>\Base folder
and enter the required information. You can choose to type in the commands
manually at the command prompt or use an input file as described in the
following sections:
Custom commands can be created by defining new commands utilizing the
required arguments.
To create custom commands:
Open the GXCommands table by navigating
to Start | Programs | Microsoft SQL Server
2005 | SQL Server Management Studio | Databases | CommServ.
In the commandToRun column, add the appropriate arguments to a
new row in the table (see Required Arguments
for a list of available arguments to include).
Note the ID number for the
new command as it appears in the ID column.
Open the GXCommandOSMapping table by
navigating to Start | Programs | Microsoft SQL Server
2005 | SQL Server Management Studio | Databases | CommServ.
Locate the ID number for your command in the
GXCommandid column.
Enter the operating system ID for your computer in the
simOSFamily column. This information should be
entered in the cell that corresponds to the command ID number. The operating
system IDs supported are listed below:
In this example, the input file is located in the c:\logs
directory on the CommServe computer. An input file is created which will be
executed at the command prompt using the following command:
sendLogFiles.exe -af "c:\logs\logs.txt"
The input file is formatted as follows:
[<CommServe_Name>]
[s]
[<subject>]
<email_address>
[j]
<job_ID_number>
The -j and -rm
commands cannot be used
together in the same send log files operation.
Click View, and then click Log Files. The Select the Log File to Open
window is displayed.
Open a specific log file, either by selecting the log file name from the list
or by typing the name of the log file in the field provided. (In the Files of
type field, Log Files (*.log) is displayed by default.)
Click Open. The contents of the log file are displayed in the
Log File for Job n dialog box.
A specific job:
Right click an active job in the Job Controller, or right-click a job
in a job history window, then click View Logs. The contents of the log file are
displayed in the Log File for Job n dialog box.
From the File menu of the Log File for Job n dialog
box, click Send Page.
From the SMTP
Parameters
dialog box, type the name of an SMTP host (mail server). If you are viewing log files
from a remote CommCell Console, then the SMTP host should be the same as the CommServe. If
it is not the same, the operation
will fail due to security issues.
To
configure the time range for sending log files:
From the CommCell Console, right-click on the CommServe icon, click
All Tasks, and then click Send Log Files. This opens the
Send Log Files dialog box.
Click the Time Range tab.
Select the Time check box if you wish to include a specific
number of hours or days to be included in the log files prior to the
current time or date.
Select the Select Date/Time option if you wish to choose a
specific range of dates to be included in the log files. You may also
select the time zone that corresponds to the dates and times selected.
You can access the Troubleshooting Settings dialog box using either of
the following:
The CommCell Console's Control Panel.
The Settings button in the Send Log Files dialog box.
To
configure troubleshooting settings using the Control Panel:
From the CommCell Console, right-click on the CommServe icon, click
Control Panel, and then click Troubleshooting Settings. This
opens the Troubleshooting Settings dialog box.
Specify the FTP or HTTP Location, User Name, and Password.
If you wish to receive notification emails regarding successful or
failed FTP operations, you can select the Notify User Upon FTP
Completion/Failure check box and provide the email address to which the
notifications will be sent. You can also provide an email address to which
log settings will be sent.
If you wish to restore all settings to their factory defaults, click the
Reset to Factory Settings button.
To
configure troubleshooting settings using the Send Log Files dialog
box:
From the CommCell Console, right-click on the CommServe icon, click
All Tasks, and then click Send Log Files. This opens the
Send Log Files dialog box.
Click the Settings button. This opens the Troubleshooting
Settings dialog box.
Specify the FTP or HTTP Location, User Name, and Password.
If you wish to receive notification emails regarding successful or
failed FTP operations, you can select the Notify User Upon FTP
Completion/Failure check box and provide the email address to which the
notifications will be sent. You can also provide an email address to
which log settings will be sent.
If you wish to restore all settings to their factory defaults, click
the Reset to Factory Settings button.
To
configure FTP settings to receive Workstation Backup client log files:
Open the GxGlobalParam table in the CommServe database.
Add a new row with name = SendLogsClientUseFTP and value
= -FTPServer <servername> -FTPUser
<username> -FTPPassword <password>. For example,
-FTPServer mcrae64 -FTPUser Orange -FTPPassword
Orange.
Save the changes. The log files from the workstation Backup clients
would be sent to the specified server.
View the Log Files of a CommServe, SRM Server, MediaAgent, or Client
Computer
To view the log files
of a CommServe, MediaAgent, or client computer.
From the CommCell Browser, right-click a CommServe, MediaAgent, or client
computer, click View, and then click Log Files. The Select the Log File to Open
window displays.
To see a specific log file, either select the log file name from the list
or type the name of the log file in the field provided. (In the Files of
type field, Log Files (*.log) is displayed by default.) Click Open.
The contents of the log file are displayed.