PreviousNext

Unconfiguring Client and Server Machines

The UNCONFIGURE function is used to reverse the effects of configuring a client or server machine. This function unconfigures machines by removing their entries from the cell namespace and Security registry.

The UNCONFIGURE function only unconfigures CDS servers and Security replica servers. It does not unconfigure the Security master server.

To completely unconfigure a machine, you must also run the REMOVE function. The REMOVE function will delete any files created during the machine's configuration.

Before you can run the UNCONFIGURE function, all the DCE daemons on the machine must be running. If you need to restart daemons, run the START function.

If the configuration of a Security and CDS client did not complete successfully, you must unconfigure the machine from some other machine in the cell.

The UNCONFIGURE function invokes the /etc/dce.unconfig component script and, if DFS is installed on the machine, the /etc/dfs.unconfig component script. You can invoke these component scripts directly. (The component scripts are described in Customizing the dce_config Processing.)

Unlike other dce_config functions, you can run the UNCONFIGURE function remotely.

The steps to unconfigure either a server or client machine are the following:

1. At the DCE Main Menu, type 5 and press <Return>.

The dce_config script displays the following message:

S:****** Attempting to unconfigure a node from the cell name space...

Then, dce_config prompts for the name of the machine to unconfigure:

Enter hostname of node to be unconfigured: (host_name)

2. Type the name of the machine to be unconfigured and press <Return>.

The dce_config script displays the following prompt:

Unconfiguring a node will remove the node's ability
to operate in the cell. A reconfiguration of the node
will be required.
Do you wish to continue (y/n)? (n)

3. Type y to continue and press <Return>.

If you continue, dce_config prompts:

Enter the Cell Administrator's principal name: (cell_admin)

Type the name of the principal who was defined to be the initial privileged user of the registry database during the configuration of the master Security server and press <Return>.

The dce_config script prompts:

Enter password:

4. Type the password for the initial privileged user's account and press <Return>. Note that this password is not displayed as you type it.

The dce_config script deletes the entries in the registry and the CDS namespace for the machine.

When it completes the unconfigure, dce_config displays the DCE Main Menu.

Note if you are unconfiguring a client or server on a host, the dce_config script automatically runs the dce_shutdown component script to shutdown all the DCE daemons.