Previous Page Index Next Page Microsoft Home Page

Return to Start Page



iiAdministrative Tools

Because different administrators have different routines and styles, Microsoft provides three different ways to administer ILS. First, administrators can use Internet Service Manager, which provides a centralized view of all the machines on the LAN running IIS services. Second, administrators can use Inetcfg, a command line tool that can also be used to administer other Microsoft Internet services. Finally, ILS provides an ActiveX™ server component to use on an ASP page. Using the Active Server Pages script interpreter technology, administrators can use a Web interface to give clients access to ILS.

iiii

ISM Administrative Tool

Internet Service Manager provides a graphical interface for managing ILS and other IIS services. Administrators access and configure the ILS controls by looking at the LDAP service property sheet. The tabs and controls in that property sheet are described here.

To use the ISM administrative tool for ILS

The LDAP properties sheet contains tabs specific to ILS: Service and ILS Server. The following sections contain descriptions of the options available.

iii

Service

The following table contains descriptions of all the options available on the Service tab.

Field

Description

Connection Timeout

The number of seconds a connection can remain inactive before the ILS server drops the connection.

Default: 600 seconds.

Maximum Connections

The maximum number of connections allowed on a single ILS or ILS server.

Default: 1000.

User Name

The name of the user.

Default: The user name currently saved on the server.

Password

The password of the user listed in the User Name field.

Default: The password currently saved on the server.

Allow Anonymous

A check box you use to either permit or not permit anonymous logon operations.

Default: Allowed.

Basic (No Encryption)


Note   The Basic (No Encryption) item is provided with the overall LDAP service, but does not govern settings in ILS-only installations.


Windows NT Challenge/Response

A check box you use to either enable or disable password authentication for logon operations.

Default: Allowed.

Comment

A space for descriptive information, label text, or usage instructions. Text from this field is visible in ISM.

Default: None.

Current Sessions

A command button that provides access to a screen containing information about all sessions currently active.

LDAP User Sessions

The following table contains descriptions of all the options available on the LDAP User Sessions dialog box.

Field

Description

Users

The user names representing those who are currently connected using LDAP.

From

The IP address of those who are currently connected using LDAP.

Time

Represents the length of time the users have been connected using LDAP.

Refresh

Updates the list of current users.

Disconnect

Disconnects a selected user from the LDAP service.

Disconnect All

Disconnects all users from the LDAP service.

iiiiii

ILS Server

The ILS Server tab contains settings specific to the ILS service. You can configure additional ILS servers to help handle request-processing activity.

The following table contains descriptions of all the options available on the ILS Server tab.

Field

Description

Enable ILS Server

A check box that controls whether ILS is enabled on the server. ILS maintains a database in memory. The database is limited in number of users as well as duration.

Client Time to Live

The number of minutes a user can remain in the ILS database before memory is purged, and the user’s registration information is removed.

Default: 20 minutes.

Maximum Registered Users

The maximum number of users the ILS database can hold. Users that attempt to register after the database reaches its maximum are refused until a memory purge opens an available spot.

Default: 5000.

Enable ULP Interface

A check box that controls whether the ULP interface is enabled on the server.

Default: Enabled.

iiii

Command Line Administrative Tool

This section describes the command line tool used to administer ILS. The command line administrative tool, Inetcfg.exe, is designed to perform the same administrative functions provided by LDAP Service Properties in ISM. Using the inetcfg commands facilitates automation and bulk processing from batch files.

To use the command line administrative tool for ILS

For a complete list of ILS commands, type inetcfg LDAP at the command prompt.


Note   For multivalue attribute strings described in the following sections, you do not need quotation marks if you do not include spaces between the comma-separated-values.


iiiiii

ILS Specific Commands

iiiThe following sections contain descriptions for the ILS-specific commands.

Enable_ILS_Server

This command enables the specified ILS server.

inetcfg LDAP Enable_ILS_Server EnableFlag {1 | 0} [ServerName]

Parameter

Description

EnableFlag

A setting of 0 disables ILS support on the specified server. A setting of 1 enables ILS support on the specified server.

ServerName

The name of the server that will process this command. If no server name is given, the current server is used.

Example

inetcfg LDAP Enable_ILS_Server 1 server01

The example enables the ILS server server01.

Get_ILS_Settings

This command gets the ILS configuration settings. See the Set_ILS_Settings command for a list of configurable parameters.

inetcfg LDAP Get_ILS_Settings [ServerName]

Parameter

Description

ServerName

The name of the server that will process this command. If no server name is given, the current server is used.

Example

inetcfg LDAP Get_ILS_Settings server01

The example gets the ILS settings on the server01 server.

Set_ILS_Settings

This command sets the ILS-specific configuration settings.

inetcfg LDAP Set_ILS_Settings ClientTTL EnableULS MaxUsers [ServerName]

Parameter

Description

ClienltTTL

Maximum length of time a client remains in the ILS database (in minutes).

Enable ULS

Enables the User Location service for ILS.

MaxUsers

Maximum number of registered users supported by this ILS server. If this maximum is reached, new entries are refused.

ServerName

The name of the server to process the command. If you do not specify a server name, the command is processed by the current server.

Example

inetcfg LDAP Set_ILS_Settings 60 1 1024 server01

The example sets the ILS time-to-live default to 60 minutes, enables ULS, sets the maximum number of registered users to 1,024, and establishes itself on the server01 server.

iiii

General Service Commands

The following are general service commands.

Disconn_User

This command disconnects a user from the ILS Service. To retrieve a list of currently connected users, use Get_Conn_User_List.

inetcfg LDAP Disconn_User UserID [ServerName]

Parameter

Description

UserID

The IP address of the user to be disconnected. To get a list of userIDs for all currently connected users, use the Get_Conn_User_List command.

ServerName

The name of the server that will process this command. If no server name is given, the current server is used.

Example

inetcfg LDAP Disconn_User 157.55.71.208 server01

The example disconnects the user at the specified IP address from the server01 server.

Get_Conn_User_List

This command returns a list of the users currently connected to the LDAP service. After the list is returned, you can use the userID with the Disconnect_User command.

inetcfg LDAP Get_Conn_User_List [ServerName]

Parameter

Description

ServerName

The name of the server that will process this command. If no server name is given, the current server is used.

Example

inetcfg LDAP Get_Conn_User_List server01

In this example, the server server01 retrieves the list of currently connected users.

Set_Auth_List

This command sets the list authorization providers.

inetcfg LDAP Set_Auth_List PartitionNumber [ServerName]

Parameter

Description

PartitionNumber

The index of the partition to use to retrieve the list of authorization providers.

ServerName

The name of the server that will process this command. If no server name is given the current server is used.

Example

inetcfg LDAP Set_Auth_List 4 server01

In this example, the server server01 retrieves the list of authorization providers for partition 4.

Get_Auth_List

This command gets the current list of authorization providers.

inetcfg LDAP Get_Auth_List [ServerName]

Parameter

Descriptions

ServerName

The name of the server that will process this command. If no server name is given, the current server is used.

Example

inetcfg LDAP Get_Auth_List server01

In this example, the server server01 retrieves its list of authorization providers.

Get_DB_State

This command gets information about the state of the database.

inetcfg LDAP Get_DB_State [ServerName]

Parameter

Description

ServerName

The name of the server to process the command. If you do not specify a server name, the command is processed by the current server.

Example

inetcfg LDAP Get_DB_State server01

In this example, the server server01 gets the state information for its database.

iiiii

Web Page Scripting

The Web pages that accompany ILS were created using the ActiveX server component, which encapsulates the operations necessary for specified operations on the ILS database. Administrators interact with the scripting component through standard HTML pages, which can be viewed with any current Web browser. Especially relevant to ILS are the Web pages that allow users to register themselves in the databases.

For information about use and customization of the ILS Web pages, see the Internet Locator Server Web Page Author’s Guide.

Previous Page Index Next Page Microsoft Home Page

Return to Start Page


© 1996-1997 Microsoft Corporation. All rights reserved.