WebSpeed
Installation and
Configuration Guide


NSMAN Utility

Use the NSMAN utility to control the operation of a configured NameServer. The utility allows you to start a NameServer, query its status, and shut down a NameServer.

SYNTAX

Operating System

Syntax
UNIX
Windows
nsman
  {
      { -name name-server
        {
             -kill
           | -start
           | -stop
           | -query
        }
        [
             -host host-name -user user-name
           | -user user-name
        ]
        [ -port port-number ]
      }
    | -help
  } 

PARAMETERS
-name name-server

This parameter is required. It specifies the name of the NameServer.

-kill

Stops and removes the NameServer from memory, no matter what it is doing.

-start

Starts the NameServer.

-stop

Tells the NameServer to stop itself.

-query

Queries the NameServer for its status.

-host host-name

Specifies the name of the machine where the AdminServer is running. If a host name is not specified, it defaults to the local host name.

-user user-name

Specifies a user name and prompts for a password. A user name and password are required only when you use the -host parameter and specify a remote host name. If you specify a remote host name with the -host parameter, but do not specify a user name with the -user parameter, you receive a prompt for a username and password.

-port port-number

Specifies the port number of the machine where the AdminServer is running. If a port number is not specified, it defaults to 20931.

-help

Displays command-line help.

NOTE

Table C–3 shows several examples that use the NSMAN command. Assume the NameServer is NS1; the user name is tom; and the AdminServer is on the remote host finance on the port 9999.

Table C–3: NSMAN Command Examples
Task
Commands
Start a local NameServer.
nsman -name NS1 -start 
Start a remote NameServer.1
nsman -name NS1 -host finance -port 
9999 -user tom -start 
Query a local NameServer.
nsman -name NS1 -query 
Query a remote NameServer.1
nsman -name NS1 -host finance -port 
9999 -user tom -query  
Stop a local NameServer.
nsman -name NS1 -stop 
Stop a remote NameServer.1
nsman -name NS1 -host finance -port 
9999 -user tom -stop 
  1. Prompts for a password.

NOTES

Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095