Novell Doc: OES 1

1.34 CONLOG

Purpose

Use at the server console to

Capture all console messages generated at the server while CONLOG is loaded. This includes system messages, eDirectory messages, the console output of all commands executed, and messages that announce RCONSOLE connections and disconnections.
Write the messages to the default sys:\etc\console.log file (or to another file of your choice).
View console messages for useful information although they scroll too quickly to read.
Reveal errors that might occur during system initialization.

Syntax


[load] conlog [file=log filename] [save=backup filename] [archive=yes] [entire=yes] [maximum=max file size] [next=hh:mm:ss] | help

HINT:Do not include a space before or after the equals sign (=).

Parameter	Use to
help	View a description of each CONLOG command option. You can load CONLOG using any combination of these options.
file=log filename	Specify the log file you want to use if you don't want CONLOG to write to the default log file sys:\etc\console.log. Note: You can change the name of the log file and store it in another directory. However, most configuration files are in the sys:\etc.
save=backup file name	Specify the filename in which you want to save the preexisting console log. By default, when you load CONLOG or when the console log file reaches its maximum size, the server deletes the existing console log file and creates a new file in its place. This parameter also enables autoexec.ncf to load CONLOG without overwriting the previous console log. Use this parameter at the command line or in autoexec.ncf if you want to examine the old console log for troubleshooting purposes. The backup file is in turn overwritten when a preexisting console log is saved just before it is replaced with a new file.
archive=yes	Archive up to 1000 console log files on your NetWare server. The first time you load CONLOG with this option, the server saves the existing console log file as the console.000 file. Then each time you load the CONLOG utility with the ARCHIVE option (or each time the console log file reaches its maximum when when CONLOG is loaded with the ARCHIVE option), the server increments the extension of the archive file by 1—console.001, console.002, etc.
entire=yes	Capture the lines already on the screen at the time CONLOG is loaded. Without this parameter, CONLOG starts logging with the next output to the console after it is loaded.
maximum=max file size	Specify the maximum size, in kilobytes, of the log file. If the log file exceeds the max file size, it is deleted—or renamed if backup filename was specified. In either case, logging starts over with an empty log file. Important: If a maximum file size is not specified, there is no limit.
next=hh:mm:ss	Specify the time of day (24-hour clock) with hour, minutes, and seconds when the server archives the existing console log and creates a new file. This option allows you to know the beginning time of a backup file or an archive file. Use this option with `save` or `archive`.

Using CONLOG

You can view the console log from a workstation with any text editor. Any logged-in user with the Read right to the sys:\etc directory can view console log files in this way.

To view the console log file from the server console, use the VIEW utility or the INETCFG utility.

Console messages can reveal errors that occur during system initialization.
The command LOAD CONLOG is typically added to the autoexec.ncf file, as in the following example:
- file server name netw5_svr
- ipx internal net c92556e
- load conlog
- load remote
- load rspx
Where you place the load conlog command in autoexec.ncf determines which console messages the server saves in the console log file. To record as many console messages as possible, place the LOAD CONLOG command near the beginning (immediately after the FILE SERVER NAME, as above). Use EDIT or NWCONFIG to modify the autoexec.ncf file.

Examples

To start capturing console messages during system initialization, enter
```
[load] conlog
```
To load CONLOG but save the current log file as clog.bak and limit the size of console.log to 100 KB, enter
```
[load] conlog save=clog.bak maximum=100
```
To load CONLOG, limit the size of console.log to 200 KB, and schedule existing console log files for daily archiving at 6:00 a.m., enter
```
[load] conlog maximum=200 archive=yes next=06:00:00
```
To stop capturing console messages, enter
```
unload conlog
```

Additional Information

Topic	See
Viewing console log file	Section 1.180, VIEW Section 1.65, INETCFG
Editing autoexec.ncf file	Using Server Batch Files in the Server Operating System for NetWare Administration Guide for OES

Topic

See

Viewing console log file

Section 1.180, VIEW

Section 1.65, INETCFG

Editing autoexec.ncf file

Using Server Batch Files in the Server Operating System for NetWare Administration Guide for OES