Removing or Modifying an IP Interface Configuration

Language:

The ipadm delete-addr command deletes a specific address configuration from an IP interface. This command is useful when you simply want to remove an IP address from the system or as part of changing an IP address that is configured on an interface. If you want to change the IP address that is configured on an interface, then you must first remove the original address configuration before assigning a new address configuration. See How to Modify an Existing IP Address.

For instructions on creating an IP address for an interface, see How to Configure an IPv4 Interface.

Note - An interface can have multiple IP addresses. Each address is identified by an address object. To ensure that you are removing the correct address, you must know the address object. Use the ipadm show-addr command to display the IP addresses that are configured on an interface. For an explanation of the address object, see How to Configure an IPv4 Interface. For more information about displaying IP addresses, see Obtaining Information About IP Addresses.

How to Modify an Existing IP Address

The following procedure describes the steps for reconfiguring a system's existing IP address.

Become an administrator.
Delete the address object that represents the IP address that you want to reconfigure.
```
# ipadm delete-addr addrobj
```
Assign a new IP address by using the same address object name.
```
# ipadm create-addr -a IP-address addrobj
```
To add another interface to the system, see How to Configure an IPv4 Interface in Configuring and Managing Network Components in Oracle Solaris 11.3.
(Optional) If necessary, modify the system's host name as follows:
```
# hostname new-hostname
```
(Optional) If the subnet mask has changed, modify the subnet entries.
(Optional) If the subnet address has changed, change the IP address of the default router.
See Creating Persistent (Static) Routes for instructions.
Reboot the system for the changes to take effect.