Downloading log files
If there are problems with your installation that you cannot solve, you may be asked to send the log files to your UNICOM Intelligence support representative. 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 may 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.
Zipped files are named SiteName_yyyy–mm–dd.zip (for example, BJH_2007–10–26.zip). Once the file has been created, Manage Logs displays a standard Windows download message box asking whether you want to open or save the file.
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.
What's in 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 may do so by editing the file and saving 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.
Notes
▪Although downloading is usually quite fast, it may take some time if you download a lot of very large log files or you download Windows event logs. You will not be able to use UNICOM Intelligence Interviewer - Server Admin while the download is in progress.
▪If you have a number of people with administrator privileges, only one of those users can download log files at a time.
To zip and download log files
1 Select 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 (Shift+Left Click or Ctrl+Left Click).
|
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. If you would rather specify your own date range, select Custom and then choose the start and end dates in the new fields that Manage Logs displays.
Note 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 may mean that some files contain information that is not relevant to the current issue.
5 Select Include windows event logs? if you want to download the Windows system and application 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 name and telephone number or email address 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