rmtcpip command
Purpose
Removes the Virtual I/O Server TCP/IP configuration.
Syntax
rmtcpip [-f] [-nextboot] {-all | [-hostname] [-routing] [-interface ifnameList [-family Family]]}
rmtcpip [-f] {-all | [-namesrv] [-hostname] [-routing] [-interface ifnameList [-family Family]]}
Description
The rmtcpip command removes Virtual I/O Server (VIOS) TCP/IP settings, such as name server information, network interface configuration, routing information, and host name.
Flags
| Flag name | Description |
|---|---|
| -all | Removes all TCP/IP settings, effectively resetting it to a newly installed system. |
| -f | Executes the command with out prompting for user confirmation. |
| -family | Removes a specific TCP/IP family from an interface. Supported values are inet and inet6. |
| -interface | Removes TCP/IP configuration from listed interfaces. |
| -hostname | Resets the hostname to ioserver. |
| -namesrv | Removes DNS information and clears the hosts file. |
| -nextboot | Removes the specified information from the configuration files, leaving the current network parameters intact (all except DNS information and hosts file). |
| -routing | Removes static routing tables. |
Note: If a shared storage pool is active on the server,
you cannot use the -all, -hostname, -namesrv, or -routing flag
because these flags could affect the cluster membership. You cannot
remove the IP configuration that is used for a shared storage pool
communication by using the -interface flag.
Exit Status
Examples
- To remove all Virtual I/O Server TCP/IP
configuration, type the command as follows:
Answer yes when promptedrmtcpip -all - To unconfigure a network interface en0 without confirmation, type
the command as follows:
rmtcpip -f -interface en0 - To cleanup the static routing table, type the command as follows:
rmtcpip -f -routing - To remove IP information from a network interface on the next
boot keeping the current configuration running, type the command as
follows:
rmtcpip -f -interface en0 -nextboot - To remove only IPv6 configuration from an interface,
type the command as follows:
rmtcpip -interface en0 -family inet6 - To remove only IPv4 configuration from an interface,
type the command as follows:
rmtcpip -interface en0 -family inet
Note: If you attempt to remove an interface
when it is in use for the cluster communication, by typing the following
command, the system displays an error message:
rmtcpip -interface en0 -fThe
system displays the following error message with return code 78:
The requested operation is not allowed because partition is a member of "chanda_cluster" cluster.
Interface being used is "en0" ("inet" Family) for cluster communication.