Progress
Installation and Configuration Guide
Version 9
for UNIX


Starting and Managing a NameServer Using the
NSMAN Utility

The NSMAN utility runs on both Windows and UNIX platforms. It allows you to invoke the following management functions on a local or remote NameServer instance:

Unlike the Progress Explorer, the NSMAN utility has no mechanism for viewing log files or deleting configured NameServer instances. If you want to view the NameServer log file or delete the NameServer instance, you must do it manually using operating system commands. To delete the NameServer, you must remove the entry for this NameServer instance in the NameServer properties file. For more information on managing log files, see the "Configuring Progress Unified Broker Log Files" section. For more information on accessing the NameServer properties file, see the "Editing the Properties File" section.

NOTE: Before you can delete a NameServer instance, you must stop the NameServer.

This is the syntax to invoke the NSMAN utility:

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

-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 user-name and password.

Windows NT supports three different formats for user-name:

-port port-number

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

-help

Displays command-line help.

For example, the following command starts a NameServer instance named NSReservations on a host named SMPflights using UDP port 30000 as user admin:

nsman -name NSReservations -host SMPflights -port 30000 -user admin -start 

Note that any nsman command that specifies a user name, typically prompts for the password, as well.


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