© 1999-2017 Citrix Systems, Inc. All rights reserved.
p.30
https://docs.citrix.com
Using DHCP for Initial Access
Jul 15, 2013
For the initial configuration of a NetScaler Gateway appliance, Dynamic Host Configuration Protocol (DHCP) can eliminate
dependency on the console by providing an IP address at which you can access the appliance to configure it remotely. You
can also use DHCP after the initial configuration if, for example, you want to move an appliance to a different subnet.
To use DHCP, you must first specify the NetScaler Gateway vendor class identifier on a DHCP server. Optionally, you can
also specify the pool of IP addresses from which your appliance can acquire an IP address. If a pool is not specified, the
address is acquired from the general pool.
A new NetScaler Gateway appliance does not have a configuration file. When you connect a NetScaler Gateway appliance
without a configuration file to the network, its DHCP client automatically polls the DHCP server for an IP address. If you
have specified the vendor class identifier on the DHCP server, the server returns an address. You can also enable the DHCP
client on a previously configured NetScaler Gateway appliance.
Prerequisites
To use DHCP, you must:
1. Note the system ID (sysid) on the serial number sticker on the back panel of the appliance.
2. Set up a DHCP server and configure it with the vendor class identifier.
To configure a Linux or UNIX DHCP server for NetScaler Gateway
1. Specify "citrix-NS" as the vendor class identifier for the appliance by adding the following configuration to the server's
dhcpd.conf file:
subclass "citrix-1" "citrix-NS"{
vendor-option-space auto;
option auto.key "citrix-NS";
Note: The location of the dhcpd.conf file can be different in different versions and flavors of the Linux/UNIX-based
operating system (for example, in FreeBSD 6.3 the file is present in the /etc/ folder). For the location, see the
dhcpd
man
page of the DHCP server.
2. If you do not want NetScaler Gateway to use IP addresses from the general pool, specify a pool of addresses for the
appliance. For example, adding the following configuration to the dhcpd.conf file specifies a pool of IP addresses ranging
from 10.102.33.246 to 10.102.33.249.
pool {
allow members of "citrix-1";
range 10.102.33.246 10.102.33.249;
option subnet-mask 255.255.255.0;
}
3. Terminate the DHCP process and restart it to reflect the change to the configuration file. At the shell command prompt,
type:
killall dhcpd
dhcpd&
Implementing an Initial NetScaler Gateway Configuration from a Remote Computer
When a new NetScaler Gateway (or any appliance that does not have a configuration file) starts, it automatically polls the
