w3Monitor Application

The w3Monitor application monitors the number of connections for each server pool/Web host combination defined in the w3Config file, logging activity in the w3MonitorLog file. As the number of available connections changes, w3Monitor adds or removes connections as specified in the w3Config file.

NOTE

Under various conditions, such as application errors or if D3 is shutdown without first shutting down FlashConnect, there may be incorrect information displayed by WWW-STATUS. w3Monitor often detects and removes this incorrect information. The w3Lines file is internally used by FlashConnect to maintain the state of each connection and may be cleared once FlashConnect has been shut down normally. It is available to the user through the WWW-STATUS command.
The format of the w3Lines file may change from release to release.

Connections are added if:

Phantom ports are available.
D3 licenses are available.
The maximum number of connections specified in the w3Config file have not been reached.
The minimum number of free connections specified in the w3Config file are not available.

Connections are dropped if:

The minimum number of connections specified in the w3Config file have not been reached.
The maximum number of free connections specified in the w3Config file is exceeded.
The HBPeriod is exceeded while the connection is waiting for a message from FCService.

w3Lines entries are deleted if:

The D3 process does not exist.
The D3 process is a phantom process and is not running FlashConnect.

NOTE	Connections started on regular ports (not phantoms) are not automatically deleted from the w3Lines entry if the port is in use, even if the port is not running FlashConnect.

w3Monitor confirms that the phantom associated with a w3Lines entry is running WWW-IRUN and that the phantom was started within five minutes of the time the connection was started.

w3Monitor reads the w3Config file every time a server pool/Web host is checked, but not more often than every five minutes. Changes take effect the next time the server pool/Web host is checked.

Manually Controlling Server Pools and w3Monitor

WWW-MANAGER is typically used to start and stop both server pools and the w3Monitor. However, if manual control is needed, or more visibility of w3Monitor’s action is needed, both the server pools and w3Monitor can be manually controlled.

If more visibility of w3Monitor’s activities is needed, w3Monitor can also be run from a terminal.

w3Monitor only manages enabled server pools. The WWW-POOL or WWW-START commands are used to enable a server pool, and WWW-STOP is used to disable a server pool.

w3Monitor Status Display

As w3Monitor runs, it displays status information on the screen. The information displayed is subject to change without notice.

The Configuration Array lists all server pools and hosts monitored by w3Monitor. The information in this array is derived from the w3Config file.

The w3Config field definitions are:

Field	Definition
Entry	Index into the Configuration Array for each entry.
Trigger	Amount of time (internal format of seconds) that passes before the next entry is processed.
Service	Server pool name.
Host	Name of Web host running Lysergic.
minimum	Minimum number of connections to this host for this server pool.
maximum	Absolute maximum number of connections to this host for this server pool.
MaxFree	Maximum number of unused connections for this host for this server pool.
MinFree	Minimum number of unused connections for this host for this server pool.
Period	Number of seconds between checks.
HB	Number of seconds to wait after the last contact with FCService before the connection is terminated.

As displayed in the above example, State reflects the configuration information for the server pool/host being checked.

In the example above, the Now information reflects the state and changes to the server pool/host being monitored. The field definitions are:

Field	Definition
Now	Internal timedate (in seconds) when processing this entry started.
PortsInUse	Number of FlashConnect connections in use.
NumPortsFree	Number of FlashConnect connections not in use.
ServiceUP	1 = service is running (from dict w3Lines, serverpoolname).
TotalAdded	Cumulative number of connections started since w3Monitor was last started.
TotalKilled	Cumulative number of connections stopped since w3Monitor was last started.
PortsKilled	List of PIDs stopped since w3Monitor was last started.
PortsKilled:	List of currently available FlashConnect PIDs.
PortChange:	Number of connections started (positive) or ended (negative) by this check.
WaitForNextTrigger	Time and date the last check completed.
Sleeping for:	Number of seconds until the next server pool/Host is checked.