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 -f
The
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.