Rename deployment manager nodes

We can rename a deployment manager node by modifying the setupCmdLine file for the node.

Make sure that we create a backup of the deployment manager configuration including its node configurations. For more information, see the documentation about the backupConfig command.

We can use the renameNode command to modify managed nodes. However, the rename command does not modify the node name information within the deployment manager configuration. If we use the renameNode command to modify a deployment manager node, the deployment manager does not restart. This task resolves the problem by modifying the setupCmdLine file so that it references the new node name.

1. Start the deployment manager.

2. Start the wsadmin scripting tool within the dmgr profile. For more information, see the documentation about starting the wsadmin scripting client.

3. Use the renameNode command in the interactive mode to rename the managed node.

   • Jacl:
     $AdminTask renameNode {-interactive}

   • Jython string...
     AdminTask.renameNode ('[-interactive]')

   • Jython list:
     AdminTask.renameNode (['-interactive'])

4. Save the configuration changes. For more information, see the documentation about saving configuration changes with wsadmin.sh.

   At this point, the renameNode command renames the managed node, but does not modify the deployment manager node configuration. Thus, the deployment manager does not restart.

5. Modify the WAS_NODE variable in the profile_root/deployment_manager_name/bin/setupCmdLine file so that it references the new managed node name.

Results

After you save the setupCmdLine file, the deployment manager starts successfully.

Related concepts

Managed and unmanaged nodes

Node groups

Related tasks

Get started with wsadmin scripting

Start the wsadmin scripting client

Node collection

Add managed node settings

Node installation properties

backupConfig command

renameNode command

Saving configuration changes with wsadmin.sh