Previous Next

Changing the Network Address of a DCE Machine

Occasionally, a machine running DCE will need to change its network address. DCE stores the network address in several files which need to be updated. To change a DCE machine's network address, you must perform the following procedure:

1. Shutdown DCE (by selecting option 4 in the dce_config Main Menu).

2. Change the machine's network address and reboot the operating system, as needed.

3. Remove the machine's CDS cache:
rm /opt/dcelocal/var/adm/directory/cds/cds_cache*

4. Update the network address in the /opt/dcelocal/etc/security/pe_site file.

5. Update the network address in the /opt/dcelocal/etc/cds_config file.

6. Restart DCE (by selecting option 3 in the dce_config Main Menu).

7. If necessary, update the following CDS objects:
/.:/hosts/hostname/self
/.:/hosts/hostname/dts-entity

These CDS objects contain bindings that are exported when the cell is configured by the dce_config script, but are not checked when daemons are restarted.

To ensure that the self and dts_entity objects have the proper updated address, run the dcecp program's object show command for each object:
dcecp> object show /.:/hosts/hostname/object

If the network address listed in the Tower attribute is incorrect, change it to an appropriate one.

To update the network address of the self object, use the dcecp program's rpcentry unexport command to unexport the object's binding:
dcecp> rpcentry unexport /.:/hosts/hostname/object -interface interface_id \
-object if_uuid

The UUID value if_uuid for the object can be obtained by running the following command:
dcecp> rpcentry show /.:/hosts/hostname/object -interface interface_id\
-object if_uuid

Now update the object with the correct (new) network address. The command you enter to this is the following:
dcecp> rpcentry export /.:/hosts/hostname/object -interface interface_id \
-binding protocol_sequence -object if_uuid

The procedure for updating the dts-entity object's network address differs from that for other CDS objects. First, you must stop the dtsd process on the target host. Then, you must delete the /.:/hosts/hostname/dts-entity object (by using the dcecp program's object delete command). Finally, you must restart the dtsd process (using dce_config).

8. If DFS is used in a DCE cell, you must also issue the following command for every DFS server (flserver) that has undergone a network address change:
> fts edserver -server old.ip.addr -changeaddr new.ip.addr

You can then restart all of the DFS servers in the cell so that they recognize the new address. You may also have to stop and restart DCE (using dce_config), as well, and remove the CDS cache before restarting the servers. For instructions on how to remove the CDS cache, see the OSF DCE Administration Guide - Core Components.