Table of Contents

Commands

Admin Commands

Handling Administration
Exiting Network Registrar

Server Commands

Controlling Servers
Displaying the Server's Health
Setting and Unsetting Debugging

Network Registrar User Interface

Through Network Registrar's graphical user interface(GUI), ntwkreg, or command line interface (CLI), nrcmd, you control your servers' operations. The nrcmd commands that control the server include the following.

• Handling administrators

• Starting, stopping and reloading the servers

• Getting health and statistics

• Setting and unsetting debugging output

Commands

The commands handle administration and affect the way you can view Network Registrar activity.

Admin Commands

The Admin commands allow you to address the Network Registrar database, to specify system administrator information, and to exit Network Registrar.

Handling Administration

The admin command allows you to configure administrators for the cluster. You can choose any string for the administrator's name. Network Registrar uses the password to authenticate the names. If you create an administrator without a password, Network Registrar cannot authenticate the name and thus will deny that user access to the cluster.

Adding an Administrator

Use the admin create command to create an administrator and associated password. For example, to create the administrator bob with the password of xyz, type:

nrcmd> admin bob create password=xyz

Creating a Password Without Displaying It

If you want to enter a password and not have Network Registrar display the password on your screen, create an administrator and do not supply a password. Then use the enterPassword command to enter a password and prevent Network Registrar from echoing it on the screen. Network Registrar prompts you to verify the password before it accepts it.

nrcmd> admin bob enterPassword

Changing the Administrator's Password

nrcmd> admin bob set password=abc

Exiting Network Registrar

Exiting Network Registrar's user interface does not affect your network servers' or your hosts' ability to request leases or access the Internet.

To exit Network Registrar's CLI, use the exit command. Network Registrar writes all your unsaved changes to the database. If Network Registrar is unable to save your changes, it displays the same error code as if you had used the save command.

Use the exit command to quit Network Registrar's command line interface when you are in interactive mode.

nrcmd> exit

Server Commands

The server command allows you to affect the behavior of the server. After you have used the server command or any other time you have changed the server's configuration, you need to reload the server.

Controlling Servers

Administration includes:

• Starting servers---Continues a server after it has been paused

• Stopping servers---Pauses a server

• Reloading servers---Updates the server configuration in the database and reloads all server information

Starting Network Registrar's Servers

nrcmd> server DNS start

Stopping Network Registrar's Servers

nrcmd> server DHCP stop

Reloading Network Registrar's Servers

nrcmd> server DHCP reload
 

Displaying the Server's Health

Use the server getHealth command to display the specified server's health. For example, to display Network Registrar's DHCP server's health, type:

nrcmd> server DHCP getHealth

Displaying Server Statistics

nrcmd> server DHCP getStats

Setting and Unsetting Debugging

You can use the server setDebug and server unsetDebug to set or unset the debugging level and the location of the debug messages. You can specify either MLOG or WINDOW as locations. The default is MLOG.

Use the server setdebug command to specify the debugging level. For example, to set the DNS debugging level to 5, type:

nrcmd> server DNS setDebug D=5

Posted: Thu Jul 13 11:36:04 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.