Progress
Installation and Configuration Guide
Version 9
for Windows
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:
-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 supports three different formats for user-name:
- A user name as a simple text string, such as
“mary”
, implies a local user whose user account is defined on the local NT server machine, which is the same machine that runs the AdminServer.- A user name as an explicit local user name, in which the user account is defined on the same machine that runs the AdminServer except the user name explicitly references the local machine domain, for example
"\mary"
.- A user name as a user account on a specific NT domain. The general format is Domain\User, in which the
User is a valid user account defined within the domain and the
Domain is any valid NT Server, including the one where the AdminServer is running.
-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 namedSMPflights
using UDP port 30000 as useradmin
:
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 |