Tellurian DhcpdNT

A DHCP service for
Windows NT and Windows 95

Copyright © 1998 Tellurian Pty Ltd

Copyright (c) 1995, 1996 The Internet Software Consortium.
All rights reserved.

trinkets@tellurian.com.au
24 July 1998

Tellurian DhcpdNT is a member of our iNTernet trinketsTM range of products, which enable your Microsoft Windows* NT or Windows 95 computer to provide the kinds of network service which has traditionally only been available on "big" computers, such as those running the Unix operating system.

Tellurian DhcpdNT is a service for Windows NT Workstation or Server, and works stand alone with Windows 95.   It complies with the Internet RFC 2131 for Dynamic Host Configuration Protocol or DHCP and permits your Windows NT or Windows 95 computer to be the DHCP server for your organisation's network.   It also supports multi-homing and is good for BOOTP clients conforming to RFC951 and RFC1533.

This document describes the installation, care and feeding of your DHCP service to ensure a long and satisfying relationship between you, your service and the network you are running.

Tellurian DhcpdNT was developed by porting the `Internet Software Consortium DHCP server' to Windows NT/95.   Where possible the original DHCP algorithms have been retained.   Changes have been made corresponding to operating system differences between Windows NT/95 & Unix.

* Trademarks are used by or registered to their respective owners.

Windows NT

Installation for Windows NT

Place the dhcpdnt.exe file in the directory you wish it to permanently reside, change to this directory then run:

dhcpdnt.exe --install

This will place an entry in the registry for a service called DhcpdNT that will execute dhcpdnt.exe from this directory.   If you move DhcpdNT to a different directory you will have to update the registry; the easiest way is to re-install it.

By default Tellurian DhcpdNT will be registered as a manually started service and will use configuration files in the root directory.   You may change these defaults by specifying startup parameters on the command line.

Note: When you start dhcpdNT, it will look for a database file used to record active leases.   By default, the file is called `C:\dhcpd.leases' but you can change this with the `-b' option.   If this file does not exist, when you use the --install option, it will be created.

De-Installation for Windows NT

Tellurian DhcpdNT can be de-installed in two steps:

1. Stop the service (if it is running).

2. From the DOS command line, run:

dhcpdnt.exe --remove

This will remove all Registry entries created.   The DhcpdNT.EXE file can then be deleted with safety.

Running under Windows NT

To start Tellurian DhcpdNT under Windows NT, open the Services control panel, highlight the dhcpdNT entry and click the Start button.   You can specify startup parameters to set the location of the log file, the debug level and such.

Note: If you wish to avoid having to specify command parameters each time you run dhcpdNT, use `-s' to save your parameters into the Windows registry.

Consult the Windows NT Workstation Help files on starting and stopping services for information on general operating procedures.   Issues specific to Tellurian DhcpdNT follow:

In DOS command mode, Tellurian DhcpdNT supports the following command arguments:

--install Install DhcpdNT as Windows NT service
--remove Remove all Registry entries related to Tellurian DhcpdNT
--help Explain all possible command parameters

Windows 95

Installation for Windows 95

There are no special installation instructions for Windows 95.   Just place the dhcpdnt.exe file in the directory you wish it to permanently reside.

De-Installation for Windows 95

Tellurian DhcpdNT can be de-installed by stopping the program (if it is running) and then re-starting it with the following DOS command line:

dhcpdnt.exe --win95 -r

to remove registry entries run with default settings.   This will remove your site-specific default configuration values.   The dhcpdnt.exe file can then be deleted with safety.

Running under Windows 95

In DOS command mode, Tellurian DhcpdNT supports the following command arguments:

--help Explain all possible command parameters
--win95 [param ...] Start the program in a DOS box.

You must use the `--win95' argument to start the program under Windows 95.

Note: If you wish to avoid having to specify command parameters each time you run dhcpdNT, use `-s' to save your parameters into the Windows registry.

Startup Parameters

When started as a Windows NT service, Tellurian DhcpdNT accepts parameters affecting it's operation and indicating the location of files.   Those parameters are entered at the bottom of the Services control panel.

When started as a Windows 95 program, the same parameters can be used, but they are typed on the command line, after the `--win95' argument.

-l<logfile> <logfile> represents the full pathname of the file to log dhcp events (default &`C:\dhcpdnt.log'.)
-d<logginglevel> <logginglevel> is a number between 0 and 9 indicating the amount of detail desired in the log file.
0 No logging is performed and a log file is not created.
2 Basic initialization messages are generated.
6 Level 1 logging PLUS Control Service events.
9 Level 6 logging PLUS Packet received/transmitted events.
-c <configfile> Configuration file for DHCP Server (default `C:\dhcpd.conf')
-b <leasefile> File containing list of current leases (default `C:\dhcpd.leases')
-p <Port number> UDP port for DHCP Server (default 67)
-s Save the current command parameters to the Registry.
-r Reset the information in the Registry to the defaults mentioned under Installation.

Long filenames are supported in the logfile, configfile and leasefile parameters, but in Windows NT Service control panel it is important that you precede all backslashes (`\') and spaces (` ') with a backslash (`\').   E.g. `c:\logs\dhcp log.txt' must be typed as

c:\\logs\\dhcp\\log.txt

In Windows 95 you must enclose filenames which contain spaces with double quotes.   E.g. `c:\logs\dhcp log.txt' must be typed as:

c:\logs\dhcp\log.txt

If you need to change the default parameters or start the service automatically at boot time, start the service once manually specifying your preferred values in the Command Parameters window and include the -s option.   This will save these parameters in the Registry, and next time the service is started it will use the values in the Registry.

Any parameters specified in the Command Parameters or command line will override entries in the Registry.

Security Issues

If the lease file is removed and the server is then re-started, it will have no way to know about any existing leases.   In this case DhcpdNT will not startup because network chaos might ensue if the server gives out addresses which are already in use.   Never delete the lease file unless you are quite sure about what you are doing.

Limited Lease Versions

Tellurian DhcpdNT is made available under a variety of licences.   Some versions restrict the number of leases which can be made available at any one time.   Please see the licence that was provided with the distribution for details of any limits applicable to you.

Copyright, Licence and Warranty

Tellurian DhcpdNT is provided under one of the following licences.   Please refer to the version appropriate for you.

See Also

Tellurian DhcpdNT Configuration, Tellurian DhcpdNT Leases, Tellurian DhcpdNT Error Messages, RFC2132 and RFC2131 and RFC951.