You are here: CSP Developer’s Guide: Overview > 3 Getting Started > Configuring a Shared IP Address Using DHCP Server

Configuring a Shared IP Address Using DHCP Server

This procedure explains how to configure a shared IP address using the DHCP server. This procedure is required to enable SIP UA redundancy.

Important! To enable SIP UA Redundancy, you must configure a shared IP address. The shared IP address is for redundancy only. All API messages should be sent directly to the active matrix card’s IP address - not to the shared IP address.

You can also use the BOOTP server for this procedure. See Configuring a Shared IP Address Using BOOTP Server.

This procedure uses the DHCP running on the Solaris system but you can use any DHCP server running on any platform.

1 If the Solaris system is already set up as a DHCP server, then proceed to Step 6.

2 Log in as root in a shell.

3 Create the DHCP directory by typing mkdir /var/dhcp

4 Configure DHCP with the command: dhcpconfig

• Select 1 for Configure DHCP Service.

• Select Y for Would you like to stop the DHCP Service?

• Enter files for Enter datastore (files or nisplus).

• Press Enter for the default for Enter absolute path to datastore directory (/var/dhcp/).

• Select N for Would you like to specify nondefault daemon options?

• Enter 0 for Enter default DHCP lease policy (in days)?

• Select Y for Do you want to allow clients to renegotiate their leases?

• Select N for Enable DHCP/BOOTP support of networks you select.

• Select Y for Would you like to restart the DHCP service?

• Select 4 to exit.

5 Edit the /etc/init.d/dhcp file. Change the line: DHCPOPTIONS=" " to: DHCPOPTIONS="-n -b manual"

6 If the shared IP address vendor option has already been defined, proceed to Step 8.

7 Add a SharedIP macro for the shared IP address in /var/dhcp/dhcptab with the following command:
dhtadm -A -s sharedIP -d 'Site,129,IP,1,1'

Type the following command to create a common macro called call_server to define common parameters for Matrix Controller cards. Note that this command will not fit on one line in this document and is actually one continuous command. Do not press Enter until you type all three lines:
dhtadm -A -m call_server -d ':Subnet=255.255.255.0: BootSrvA=10.10.16.100:BootFile= "/tftpboot/matrix.cfg":Router=10.10.16.200:'

Parameter | Description
--- | ---
call_server | Macro name for all the rest of these parameters
Subnet | Subnet value for a Matrix Controller card. Use the required subnet value in place of the 255.255.255.0 example shown.
BootSrvA | IP address of the TFTP server, which will usually be the IP address of this Solaris system. Use the required IP address value in place of the 10.10.16.100 example shown.
BootFile | TFTP configuration file for a Matrix Controller card. Use the required file name value in place of the /tftpboot/matrix.cfg example shown.
Router | IP address of the Gateway for a Matrix Controller card. Use the required IP address value in place of the 10.10.16.200 example shown.

8 Create the DHCP network table for the 10.10.16.0 network that the Matrix Controller card uses. Type the command:
pntadm -C 10.10.16.0
Use the required value in place of the 10.10.16.0 shown in the example. The value to use is the IP address of the Matrix Controller "bit-wise anded" with the Subnet Mask of the Matrix Controller card.

9 Type the following command to add an entry for the active Matrix Controller of the redundant pair. Note that this command will not fit on one line in this document and is actually one continuous command. Do not press Enter until you type all the lines:
pntadm -A 10.10.16.2 -f 9 -m call_server -I 0100201C090733 10.10.16.0

Parameter | Description
--- | ---
10.10.16.2 | IP address of the Matrix Controller card. Use the required value in place of the 10.10.16.2 in the example.
9 | The value of the flags. The value 9 indicates the entry is permanent and BOOTP.
call_server | Use the call_server macro. This indicates that all values associated with the call_server macro will be used for this definition.
0100201C090733 | The first two digits of 01 are always used, and indicate the hardware type, which is Ethernet. Use the hardware address of the Matrix Controller card in place of the 00201C090733 example shown. Note that this value is not case sensitive.
10.10.16.0 | IP address of the Gateway for a Matrix Controller card. Use the required value in place of the 10.10.16.200 example shown. This is the same value used in Step 8.

10 Add the shared IP address for this entry as follows:
dhtadm -A -m 00201C090733 -d':sharedIP=10.10.16.9:'

Parameter | Description
--- | ---
00201C090733 | Use the hardware address of the Matrix Controller card in place of the 00201C090733 example shown. This value is the same as the value used in Step 9, except the hardware type 01 is not used here, and all hexadecimal values which are letters must be uppercase.
10.10.16.9 | IP address of the Matrix Controller card. Use the required value in place of the 10.10.16.2 example shown

11 Repeat Steps 10 and 11 for the standby Matrix Controller card of the redundant pair.

12 To restart the DHCP daemon, type the following two commands:
/etc/init.d/dhcp stop
/etc/init.d/dhcp start

13 To display the DHCP network table for the 10.10.16.0 network, use the command:
pntadm -P 10.10.16.0
Use the required value in place of 10.10.16.0 in the example. The value to use is the value used in Step 8.

14 To display the DHCP configuration table, use the command:
dhtadm -P

Internet Protocol. Part of the TCP/IP family of protocols used to route messages and tracks the addresses of nodes.
Dynamic Host Controlled Protocol
Session-Initiation Protocol. A signaling protocol used for establishing sessions in an IP network. A session could be a simple, two-way telephone call, or it could be a collaborative multi-media conference session.
Boot protocol for TCP/IP
A 32-bit address, used in IP routing, which includes a Network address identifier assigned by a central authority and a Host ID (an end station identifier assigned by a LAN administrator).
A device that translates calls between an IP network and another network, typically the PSTN.
The bits of an Internet Protocol (IP) address used for a subnetwork.
The protocol used in most local area PC networks. Typically, most Ethernet networks support data transmission speeds up to 10 Mbps, but 100 Mbps is also possible.