Troubleshooting Interface Configuration

This section discusses common problems that you might encounter while using the ipadm command to configure IP interfaces.

The ipadm command does not work.

Manual IP interface configuration with the dladm and ipadm commands work only on fixed-type network configuration profiles (NCP), such as DefaultFixed. If the active NCP in the system is an automatic-type profile, switch to a fixed-type profile before using the dladm and ipadm commands.

# netadm list
TYPE   PROFILE        STATE
ncp    DefaultFixed   disabled
ncp    Automatic      online
loc    Automatic      offline
loc    NoNet          offline
...

# netadm enable -p ncp defaultfixed

IP address cannot be assigned with the ipadm create-addr command.

With the traditional ifconfig command, you can plumb and assign an IP address with a single command syntax. When using the ipadm create-addr command to configure an IP address, you must first create the IP interface with a separate command.

# ipadm create-ip interface
# ipadm create-addr -T addr-type -a address addrobj

The message cannot create address object: Invalid argument provided is displayed during IP address configuration.

The address object identifies a specific IP address bound to an IP interface. The address object is a unique identifier for each IP address on the IP interface. You must specify a different address object to identify a second IP address that you want to assign to the same IP interface. If you want to use the same address object name, then you must delete the first instance of the address object before assigning it to identify a different IP address.

# ipadm show-addr
ADDROBJ   TYPE     STATE   ADR
lo0       static   ok      127.0.0.1/10
net0/v4   static   ok      192.168.10.1

# ipadm create-addr -T static -a 192.168.10.5 net0/v4b

or

# ipadm show-addr
ADDROBJ   TYPE     STATE   ADR
lo0       static   ok      127.0.0.1/10
net0/v4   static   ok      192.168.10.1

# ipadm delete-addr net0/v4
# ipadm create-addr -T static -a 192.168.10.5 net0/v4

The message cannot create address: Persistent operation on temporary object during IP interface configuration

The ipadm command creates persistent configuration. If the IP interface that you are configuring was created as a temporary interface, then you cannot use the ipadm command to configure persistent settings on the interface. After you verify that an interface that you are configuring is temporary, delete that interface, re-create it as a persistent object, then resume configuring.

# ipadm show-if -o all
IFNAME   CLASS      STATE   ACTIVE   CURRENT        PERSISTENT   OVER
lo0      loopback   ok      yes      -m46-v------   46--         --
net0     ip         ok      yes      bm4---------   ----         --

The absence of the 4 flag for IPv4 configuration or 6 flag for IPv6 configuration on the PERSISTENT field indicates that net0 was created as a temporary interface.

# ipadm delete-ip net0
# ipadm create-ip net0
# # ipadm create-addr -T static -a 192.168.1.10 net0/v4