Cisco Systems 2.1(1) manual Capturing Nicroi Data to Roilog.txt, Copying Nicroi Log Files, 170

Chapter 13: - Using Cisco Common Tools

How to Use the NICROI Utility

Note: The time shown is the time that the log is closed, meaning the time that information stopped being written to that particular log and another log is created. You can see in this list also the size of the file.

Step 3 If you do not see the date and time you are looking for, you can view more log files by typing mgmt file list more until you see the log file that you would like to capture. This log file format is useful if you have several specific time periods that you want to capture.

Capturing NICROI Data to Roilog.txt

The roilog.txt file is a file that is invoked by opening and closing it, this file is NOT automatically generated as the niclog.xxx. This log file is useful if you have one general, extended period of time that you want to capture. Use the following steps to create a roilog.txt file:

To "Open" a roilog.txt file:

From within NICROI issue the log open [<filename>] command. This command causes all status displayed in the NICROI logging window to be stored in a log file on the NICROI host system. The name of the log file can be specified. If omitted, the default name is roilog.txt which is placed in the current directory of the process from which NICROI starts.

Note: If you use this type of log file, you must close the log to stop the writing of information (once you have captured the time frame in question) before you copy the log file out to analyze it.

To "Close" an roilog.txt file:

From within NICROI type the .log command to close the NICROI log file. No further file logging is performed.

Copying NICROI Log Files

You can copy these log files to your local drive. There are basically two ways you can gather this data, based on which file format you choose to use above.

Copying Files Using Roilog.txt

If you have opened and created a log file using the method for roilog.txt, upon closing the log file, you have a copy of the log on your local drive. The file will be located in the directory from which you began your NICROI session. Unless you have specified a download directory using the .xdir c:\<path name> command, then the file is created and written onto your local drive at the location from which you started your NICROI session.

Copying Files Using Niclog.xxx

If you choose to use the niclog.xxx files you need to download or transfer the files to your local drive using the nmg roi transfer command as outlined below. Remember, if you do not specify a transfer directory with the .xdir c:\<path Name> command then the file is transferred to the

Cisco Support Tools User Guide for Cisco Unified Software Release 2.1(1)

170