Trouble Shooting Guide

General stuff

/etc/default/merge

The file /etc/default/merge has a lot of settings that govern NeTraverse Win4Lin Terminal Server. Some of these must NOT be changed. Others can be changed, and all users will get the new settings. Settings in the user's environment can be used to override the default settings from /etc/default/merge.

Watch this space for descriptions of the settings in /etc/default/merge. Until then follow the directions of other documentation for changing certain settings.

Details on NeTraverse Win4Lin Terminal Server Logging

All the following NeTraverse Win4Lin Terminal Server programs have built in logging capability. You can set these environment variables in /etc/default/merge or export them in your local environment.

Summary Table:
Program Environment Default file Default bit flags Start/stop
win ; dos DOS_LOG @dos.log ffff SIGPWR
xcrt XCRT_LOG @xcrt.log 1000 SIGPWR
em EM_LOG
MRGWIN_LOG*		 @.merge/em.log 0 none
winsock WSOCK_LOG @wsock.log 1000 SIGPWR
winsetup WINSETUP_LOG @winsetup.log 1000 none
crt CRT_LOG @crt.log 1000 none
tkbd TKBD_LOG @tkbd.log 1000 none
upgrade_u UPGRADE_U_LOG @upgrade_u.log ffff none
admconvert ADMCONVERT_LOG @admconvert.log 1000 none
winadmin WINADMIN_LOG @winadmin.log 1000 none
winconfig WINCONFIG_LOG @winconfig.log 1000 none
makexsym MAKEXSYM_LOG @makexsym.log 1000 none
mapfname MAPFNAME_LOG @mapfname.log ffffffff none
*MRGWIN_LOG is a second optional logging value that only specifies a bit flags value.
Note: SIGPWR is 30 on Linux, and 19 on OpenServer, OpenLinux, and UnixWare.

Note: The filename specification:

Note: Environment variable setting: The Logging variable must be set to one of the following forms: 

        xxxxxxxx:filename 
        filename:xxxxxxxx 
        xxxxxxxx 
        filename
Where filename is the filename specification as explained above, and xxxxxxxx is an up to eight hex digit value (for 32 bit flags). Each bit flag enables a certain kind of logging. The different programs use the big flags in different ways, and not all the 32 bit flags are necessarily always used. Also the significance of the bit flags may change from release to release. So typically you only use the default except when advised to try another value.

For those programs that have a logging start/stop signal, the setting can be preceded by a plus character, "+", which delays the start of logging until the start signal is received. Examples using the "+" variation: 

        +/tmp/mylog:1ffff
        +@homelog
        +ffffffff
        +
The default DOS_LOG and XCRT_LOG settings in /etc/default/merge are both "+". This means that when the SIGPWR signal is sent to the dos, win or xcrt process it will start logging using the default filename and bit flag value.

When sending the signal to the dos or win process, you must be careful to send it to the correct process. Each session has two dos or two win processes. One process is the "parent" of the other. The signal is to be sent to the parent process, NOT the child process.