InetSvcs.cf file and file logging

Inetsvc.cf file and file logging

The InetSvcs.cf file

The InetSvcs.cf file resides in the same folder as the Internet Services executable file and is used to set some of Internet Services initial options at startup. It consists of two sections: [Config] and [Debug].

The [Config] section

The [Config] section of the InetSvcs.cf file can contain two switches:

Console = [-1 | 0 | 1]

and

Logging = [-1 | 0 | 1].

It can also contain a number of signal settings:

• SET_SIGUSR1

• SET_SIGUSR2

• SET_SIGINFO

• SET_SIGVTALRM

The Console switch is used to determine whether or not Internet Services displays a console when it is running. This option can only be set at startup. If you wish to change it, you must change the value of the switch and restart Internet Services.

The Logging switch is used to determine whether or not Internet Services writes logging information, when it is running, to disk. Unlike the Console switch, this can be reconfigured while Internet Services is running using the Write log to disk button on the Control tab on the Internet Services Monitor form, or using the Service > Console To File menu on the Internet Services console (if Internet Services is showing a console).

Note

The Log to File and Console to File options are only temporary and will revert back to the default setting (as configured in the InetSvcs.cf file) when you restart Internet Services.

There are three possible values for both the Console and the Logging switch:

• (enabled)

• 0 (disabled)

• -1 (use default).

The default value for each switch is determined by which platform on which Internet Services is running and in what mode in which it is running. By default, the console is disabled when Internet Services is running as a Windows service. Otherwise, it is enabled.

Note

Linux and OS X versions of Internet Services do not support a console. In this environment the switch is ignored (console is permanently disabled).

File logging is generally disabled when the console is enabled and enabled if the console is disabled.

OS X and Linux versions of Internet Services support a set of signals that can be sent to the Internet Services process, which triggers certain commands. The list of handled signals is output in response to starting fcisd with the --help argument, along with the default actions:

SIGQUIT(3)	Quit
SIGHUP(1)	Get Configuration
SIGINFO(29)	Task List (OS X only)
SIGVTALRM(26)	Task List
SIGUSR1(10/30)	Force Internet Connection (10 on Linux/30 on OS X)
SIGUSR2(12/31)	Flush HTTP Cache (12 on Linux/31 on OS X)

The above actions can be redefined with entries in the inetsvcs.cf file, in the Config section, using the following keywords:

SET_SIGUSR1

SET_SIGUSR2

SET_SIGINFO

SET_SIGVTALRM

The value for each of these keywords is a list of one or more command numbers, separated by commas, surrounding by double quotes. The command numbers are the same as those that would be supplied to the FCUTIL command:

Command number	Command/Diagnostic Menu item
1100	Display Service Task List
1101	Display DNS Cache
1102	Display Kernel Task List
1103	Display Kernel Statistics
1104	Flush HTTP Cache
1107	Display HTTP Cache
1110	Display Import Tables
1111	Console to file
1112	Display Temporary IP Block List
1113	Flush Temporary IP Block List
1114	Display Blackholed Connections
1115	Flush Blackholed Connections
1116	General Statistics
1117	Reset Log levels
1118	Zero All Log levels
1119	Display Abuse List
1120	Flush Abuse List
1121	Display Alias Tables
1122	Display MIME Types
1130	Turn SyncServices console off
1131	Turn SyncServices console on
1150	Display Memory Leak statistics (special versions only)
1151	Start Memory Leak tracking (special versions only)
1152	Stop Memory Leak tracking (special versions only)
1153	Display Memory Tracking list (special versions only)
1154	Display Memory Handle table (special versions only)
10000	Get Configuration
10001	Force Internet Connection
10002	Set Priority to High
10003	Set Priority to Medium
10004	Set Priority to Low
10005	About Internet Services
10006	Shutdown Internet Services

For example, to display the kernel task list, followed by the kernel statistics when the USR1 signal is received, add this to the inetsvcs.cf file:

[Config]

SET_SIGUSR1 = "1102, 1103"

The [Debug] section

The [Config] section of the InetSvcs.cf file is used to set the initial levels for Internet Services Debugging. The debug keywords used in this file are prefixed by "DBG_". For example,

to set the initial level of HTTP server debug logging to 3 when Internet Services starts up, you would add this line to the [Debug] section of the InetSvcs.cf:

DBG_ICHTTP = 3

since the debug keyword for HTTP Server is ICHTTP.

Top

Internet Services file logging

You can configure Internet Services to write logging information to disk, so that it can be reviewed at a later date. The Internet Services log file is called InetSvcs.log (Windows) or fcisd.log (Mac OS X). This file is stored in the same folder that holds the Internet Services executable.

Internet Services creates a new log file on startup and renames any old files as InetSvcs.OLD (Windows) or fcisd.old (Mac OS X). Any previous inetsvcs.old file is lost.

By default, the Internet Services file logging is disabled unless Internet Services is running without a console, if Internet Services is running on a platform that does not support one (some UNIX variants), or Internet Services is running as a Windows Service or Unix daemon, in which case it is ignored.

The log file can be enabled or disabled at startup using the InetSvcs.cf file, or while Internet Services is running using either the Internet Services Monitor or the Internet Services Service menu on the Internet Services console.

Top