Activating Transaction Logging on a Remote Server

Remote servers can use transaction logging to monitor data requests that the server receives from McIDAS-X clients. This information is written into the file SERVER.LOG, which resides in the first writable directory of the environment from which the server is run.

The following items are logged.

Field	Bytes	Type	Description
1	4	unsign	Server IP address
2	4	int	Server port used
3	4	unsign	Client IP address; see Note below
4	4	char	User ID
5	4	int	Project number
6	12	char	Password
7	4	char	Transaction type
8	4	int	Number of bytes received by server
9	120	char	ADDE request string
10	4	int	Number of bytes going out
11	4	int	100 x CPU seconds
12	4	int	Return code
13	72	char	Error message
14	4	int	Start date in IYD format
15	4	int	Start time of transaction in hhmmss
16	4	int	End time of transaction in hhmmss

Note: Field 3 reports the IP address of the client workstation (if SSH tunneling is not used), gateway (if SSH tunneling is used with a gateway), or server (if SSH tunneling is used without a gateway). See the DATALOC command for SSH tunneling information.

Transaction logging is activated by setting the environment variable ADDE_LOGGING in the remote server account before the server starts. Complete the steps below to do this automatically each time you log in to the remote server account.

1. Add the following line to the remote server account's $HOME/.mcenv file.

export ADDE_LOGGING; ADDE_LOGGING=YES

2. Examine the remote server account's $HOME/.profile file and add the following line if it's not already present. Be sure to leave a space between the period (.) and $HOME.

. $HOME/.mcenv

WARNING!
The SERVER.LOG file will continue to grow in size until it is truncated or removed.
High access volume servers should schedule the file to be rotated or truncated to prevent filling of the file system.

To deactivate transaction logging, remove the line listed in step 1 above from the remote server account's $HOME/.mcenv file.

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]