Downloading log files
If there are problems with your installation that you cannot solve, you might be asked to send the log files to UNICOM Intelligence Support. The easiest way to do this is to use the Download tab to create a Zip (compressed) file that you can then send by email.
The download process copies all files that were created on or after a given start date or that were last modified on or before a given end date. When choosing dates, remember that some files grow more quickly than others so you might need to extend the date range outside the period when the problem actually existed. The download process also creates a ReadMe file containing information related to the problem. You provide some of this information and some comes from DPM.
Downloading is usually quite fast, but it might take some time if you download a lot of very large log files or you download Windows event logs. You cannot use UNICOM Intelligence Interviewer - Server Admin while the download is in progress.
Only one user can download log files at a time.
Zipped files are named <site_name>_<yyyy>–<mm>–<dd>.zip, for example: BJH_2007–10–26.zip.
The date range, the file types downloaded, and the setting for Windows event files are saved in DPM as application settings, so that they become the defaults the next time you run Manage Logs.
Contents of the zip file
The Zip file that Manage Logs creates contains the following files in the order shown:
dpm_out.txt
A text file listing the contents of DPM.
ReadMe.html
Additional information about the files:
▪when the Zip file was created and by which version of the log tool
▪which versions of UNICOM Intelligence Interviewer - Server Admin and its associated applications are installed
▪the names of the computers whose log files have been included, the function of each computer in the cluster (interviewing server, for instance), each computer’s time zone, and how many log files have been collected from each computer
▪information that you entered on the Download tab.
If you need to change the problem description, you can edit the file, and then save it back into the zip file; you do not need to rerun the download for this.
ApplicationEvents.csv
SystemEvents.csv
The Windows application and system event logs, if requested.
*.tmp
UNICOM Intelligence log files. The exact files depend what was requested.
To compress and download log files
1 Click the Download Logs tab.
2 In Machines, choose the computers whose log records you want to download.
3 In Log file types, choose the types of log files you want to download:
|
Select
|
For
|
|
UNICOM Intelligence Interviewer - Server Admin (ISE)
|
Records related to the interview engine.
|
|
UNICOM Intelligence Interviewer - Server Admin Components (IVW)
|
Records related to interviews.
|
|
Others
|
Records from log files for other activities such as Participants or Export Data. Select the appropriate log files from the list.
|
4 In Log files date filter, choose the date range you want to see. Possibilities are the last two, 12, or 24 hours, the last two days, the last week, or the latest (the last modified log file for each selected log file type). The default is the last two days.
To specify your own date range, select Custom, and then specify the start and end dates.
The date range applies to the creation and last modified dates of the log files themselves, not to the dates that the log entries were written. On a lightly loaded system, this might mean that some files contain information that is not relevant to the current issue.
5 If you want to download the Windows system and application logs, select Include windows event logs?. The default is to download these files as they often contain useful information about what has been happening on a computer while UNICOM Intelligence Interviewer - Server Admin has been running.
6 Select Use regular expression to filter? if you want to define a regular text expression upon which to search. When selected, you can enter a text expression in the provided field. Only log files that contain the defined text will be returned.
7 Under ReadMe, specify information to be added to the ReadMe file that is created to accompany the log files.
Priority: Select the job’s importance to you.
Contact details: Type the contact information of the person that the support representative should contact about the problem.
Description of problem: Type a description of the problem. If you have other information that will be helpful, include it here: for example, if a sample management script has recently been changed or the problem occurred after a system upgrade.
8 Click Download Logs.
See also