Configuring Services with the Cisco Service Manager

This chapter describes the Cisco Service Manager. It contains the following sections:

• "Starting and Stopping the CSM"

• "Basic CSM Usage"

• "Starting, Stopping, and Restarting Services"

• "Controlling Access to Services"

• "Modifying Basic Options for a Service"

• "Using Advanced Options"

Starting and Stopping the CSM

The Cisco Service Manager (CSM) is a graphical utility that lets you easily start, stop, configure, and monitor services.

If you are running the CSM under Windows NT, double-click the CSM icon in the Cisco Server Suite program group to start the CSM, or select it from the Start menu under Windows NT version 4.0.

---

Note To start the CSM, you must have administrator access.

---

If you are running the CSM under UNIX, follow the procedure below to start the CSM:

---

Note To start the CSM, you must have root access.

---

Step 1 Log in as root (or equivalent).

Step 2 To start the CSM, enter the command:

installation_dir/CSCOcddm/bin/csm

where installation_dir is the directory where you installed the Cisco DNS/DHCP Manager or Cisco Server Suite 1000.

To change the CSM display, use one of the following parameters with the csm command:

Parameter	Description
-colormap new	CSM installs a private colormap. This ensures that all colors requested by the CSM display correctly. When this option is used, other applications may appear to have corrupted colors when the pointer focus is on the CSM window. The inverse is also possible: The CSM colors may appear corrupted if the pointer is in any other application.
-display display	CSM displays itself on the X Window server that is running on the machine designated by the display variable. This will override any 'DISPLAY' environment variable.

To stop the CSM, choose Exit from the File menu.

Basic CSM Usage

When you first start the CSM, a screen appears from which you are instructed to select a

service:

A list of the services available to the CSM appears in the Available Services list. Next to the service name, a red or green circle appears indicating whether the service is running. A green circle indicates that the service is running, and red circle indicates a service is not running.

---

Note The status of services in the Available Services list may on rare occasions not reflect the real state of the services. To verify the state of the services, click the Status button.

---

To select a service, click it. The tabs for the selected service appear in the Service Configuration box.

The option tabs for each service are described in the following list.

• The StartUp tab contains the following subtabs. If you make any changes within the StartUp tab, you must restart the Master Server before your changes take effect (see Chapter 3, "Starting the Master Server").

  • The Basic tab contains options that identify the library that executes the service, indicate whether the service should start automatically, and let you describe the service.

  • Some services have an Access tab, which allows you to control and log attempts to access the service.

  • The Parameters tab contains the path name of the configuration file specific to the service and may contain configuration options specific to the service. For information about options specific to a particular service, see the relevant chapter in this guide.

  • The Advanced tab contains communication options for the service.

• Some services have a Config tab which lets you set service-specific options. If you make any changes within the Config tab, your changes take effect the next time the service is started.

• The DNM service has a Users tab which lets you define users who have access to the DNM server. If you make changes to this tab, your changes take effect when they are saved and the service is restarted.

---

Note The CSM does not provide scroll bars for text fields in the various tabs. If a field or tab is partially obscured, widen the CSM window or drag the X pointer across the text.

---

Starting, Stopping, and Restarting Services

The CSM lets you start, stop, and restart services or configure services to start automatically. If a service is configured to start automatically, the Master Server starts the service whenever a request is received on the Master Server port.

To start a service:

Step 1 Start the CSM.

Step 2 Choose the service you want to start from the Available Services list.

Step 3 Click Start.

To stop a service:

Step 1 Start the CSM.

Step 2 Choose the service you want to stop from the Available Services list.

Step 3 Click Stop.

To restart a service:

Step 1 Start the CSM.

Step 2 Choose the service you want to stop and immediately restart from the Available Services list.

Step 3 Click Restart.

Configuring Services to Start Automatically

You can configure services to start automatically whenever the Master Server is started. To do so:

Step 1 Start the CSM.

Step 2 Choose the service you want to automatically start from the Available Services list.

Step 3 Select the StartUp tab.

Step 4 S

elect the Basic tab.

Step 5 Choose AUTOMATIC in the Start pull-down menu.

Step 6 Choose Save Configuration from the File menu.

Your changes take effect after you restart the Master Server.

Controlling Access to Services

To control access to services, you can configure services to:

• Accept or reject connections from specified networks or individual hosts

• Specify the message sent when a connection is refused

• Log refused connections

• Log accepted connections

Limiting Access to a Service to Specific Networks or Hosts

To limit access to specific networks or hosts:

Step 1 Start the CSM.

Step 2 Choose the service for which you want to limit access from the Available Services list.

Step 3 Select the StartUp tab.

Step 4 S

elect the Access tab.

Step 5 You can specify individual hosts or networks, and you can specify whether connections from those hosts or networks should be accepted or rejected depending on the field in which you enter the addresses of the hosts or networks. Click the '...' button next to the field you want to modify.

The Edit Options dialog box

appears:

Step 6 In the lower field of the Parameter Values group, enter the IP address and subnet mask (if the network or host uses a subnet mask) of the first network or host from which you want to accept connections. For each network or host, enter IP- or IP* followed by the IP address. IP- means that connections are accepted through any port. IP* means connections are only accepted through the privileged ports 0 through 1024.

For networks, the IP address consists of the network number, followed by 0 for the host portion. For example:

IP-161.44.0.0 or IP-161.44.128.0

To specify a subnet mask, use a slash (/) between the IP address and the subnet mask. For example:

IP-161.44.8.64/255.255.255.240

If you do not specify a subnet mask, the default subnet mask for your network is used.

Step 7 Click Add.

Your entry appears in the list box in the Parameter Values group.

Step 8 Repeat Steps 6 and 7 for each network or host from which you want to accept or reject connections.

Step 9 Click OK.

Step 10 If you specified hosts or networks from which to accept connections, choose TRUE from the RejectByDefault pull-down field if you want to specify that connections are accepted only from the networks or hosts you have specified.

Step 11 Choose Save Configuration from the File menu.

Your changes take effect after you restart the Master Server.

Specifying the Message Sent to a Host When a Connection is Refused

To specify the message sent to a host when a connection to the Master Server from that host is refused:

Step 1 Start the CSM.

Step 2 Choose the service from the Available Services list.

Step 3 Select the StartUp tab.

Step 4 Select the Access tab.

Step 5 Enter the message you want sent in the RejectMessage field.

Step 6 Choose Save Configuration from the File menu.

Your changes take effect after you restart the Master Server.

Logging Access to Services

The CSM lets you specify whether to log connections to services. You can specify whether to log accepted connections, and whether to log refused connections.

If you choose to log connections, the connection messages are sent to the default log file. If the Cisco Syslog service is enabled, the default log file is MultiNet\log\info.log under Windows NT or CSCOcddm/log/info.log under UNIX, which is found in the directory in which you installed the CDDM or the Cisco Server Suite 1000.

Caution You should not configure logging for the DNS (Domain Name System) service unless absolutely necessary. Doing so causes an entry to be made in the log file for each DNS request received by the DNS server. On a busy DNS server, available disk space will be rapidly consumed.

Specifying Whether to Log Accepted Connections

To specify whether to log accepted connections to a service:

Step 1 Start the CSM.

Step 2 Choose the service from the Available Services list.

Step 3 Select the StartUp tab.

Step 4 Select the Access tab.

Step 5 Choose TRUE from the LogAccepts pull-down field if you want to log accepted connections.

Choose FALSE if you do not want to log accepted connections.

Step 6 Choose Save Configuration from the File menu.

Your changes take effect after you restart the Master Server.

Specifying Whether to Log Refused Connections

To specify whether to log refused connections to a service:

Step 1 Start the CSM.

Step 2 Choose the service from the Available Services list.

Step 3 Select the StartUp tab.

Step 4 Select the Access tab.

Step 5 Choose TRUE from the LogRejects pull-down field if you want to log refused connections.

Choose FALSE if you do not want to log refused connections.

Step 6 Choose Save Configuration from the File menu.

Your changes take effect after you restart the Master Server.

Modifying Basic Options for a Service

The CSM lets you change basic information about services. You can change:

• The file that actually executes the service

• The text description of the service

Changing the Program that Executes the Service

Caution Making careless changes to the program that executes a service will prevent the service from running. Do not change this field unless you are certain of what you are doing!

To change the program file that executes the service:

Step 1 Start the CSM.

Step 2 Choose the service from the Available Services list.

Step 3 Select the StartUp tab.

Step 4 Select the Basic tab.

Step 5 Enter the path and filename of the new program in the Program field.

Step 6 Choose Save Configuration from the File menu.

Your changes take effect after you restart the Master Server.

Changing a Service Description

To change the text description of a service:

Step 1 Start the CSM.

Step 2 Choose the service from the Available Services list.

Step 3 Select the StartUp tab.

Step 4 Select the Basic tab.

Step 5 Enter the new description in the Description field.

Step 6 Choose Save Configuration from the File menu.

Your changes take effect after you restart the Master Server.

Using Advanced Options

Caution Do not change the socket options in the Advanced tab of the StartUp tab in the CSM unless you are directed to by a Cisco Customer Support Engineer. Changing these options incorrectly will cause the service to stop functioning.