You are here: Reference Information > Command Line Tools > NuoDB Manager > Remove Host

Remove Host

This is a NuoDB Manager command. See NuoDB Manager.


Instructs all transaction engines in the domain to hang up any sockets that are open with the transaction engine connected to the specified database on the specified host. NuoDB terminates the transaction engine that is connected to the specified database on the specifed host and removes that process from the durable domain configuration.

The broker on the host on which the evicted process was running continues to be a peer in the domain. If enforcement is enabled and the termination of the evicted process causes the database's template requirements to be unmet, then the enforcer starts a new process to replace the evicted process. If you do not want the terminated process to be replaced then you can stop the database or disable enforcement before issuing the remove host command. See Disable Enforcer.


remove host address broker_address database database_name


Interactive Example

Database: mydb1, (unmanaged), processes [2 TE, 2 SM], ACTIVE
[TE] nuodb1/ (DEFAULT_REGION) [ pid = 165 ] [ nodeId = 4 ] RUNNING
[SM] nuodb2/ (DEFAULT_REGION) [ pid = 413 ] [ nodeId = 1 ] RUNNING
[TE] nuodb2/ (DEFAULT_REGION) [ pid = 429 ] [ nodeId = 2 ] RUNNING
[SM] nuodb3/ (DEFAULT_REGION) [ pid = 276 ] [ nodeId = 3 ] RUNNING

nuodb [domain] > remove host address database mydb1
Evicted nodes:
[TE] nuodb1/ (DEFAULT_REGION) [ pid = 165 ] [ nodeId = 4 ] RUNNING

Scripting Example

The same remove host command can be executed with --command as follows:

nuodbmgr --broker host --password password \
    --command "remove host address database mydb1"