POWER7 information

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

See Exit status for Virtual I/O Server commands.

Examples

To remove all Virtual I/O Server TCP/IP configuration, type the command as follows:
```
rmtcpip -all
```
Answer yes when prompted
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.

Related Information

The chtcpip command and the mktcpip command.

Send feedback Rate this page

Last updated: Wed, June 03, 2015