[Name]
stphanet - Inactivation of virtual interfaces
[Synopsis]
/opt/FJSVhanet/usr/sbin/stphanet [inet | inet6 | dual] [-n devicename1[,devicename2,...]]
[Feature description]
The stphanet command makes it possible to deactivate a virtual interface.
[Option]
It is possible to specify the following options:
Specify an IP address form assigned to a virtual interface to be deactivated.
inet | : IPv4 address |
When omitted, virtual interfaces of all forms are to be dealt with. IPv4 and IPv6 addresses are deactivated at the same time in a virtual interface of dual stack configuration. It is not possible to deactivate only an IPv4 address or only an IPv6 address respectively. Dual stack configuration in this case does not mean IPv4 and IPv6 addresses are set on each of the stacked physical interfaces, but they are set to one virtual interface defined in a Redundant Line Control Function. This option is valid only in Fast switching mode (operation mode is "t") or NIC switching mode (operation mode is "d").
Specify a virtual interface name to be inactivated. Multiple virtual interfaces can be specified by delimiting them with a comma (,). Virtual interface names specified here must have been activated by using the strhanet command. If this option is not specified, all active virtual interfaces are inactivated.
[Related commands]
strhanet dsphanet
[Notes]
Virtual interfaces used in a cluster system cannot be inactivated with this command.
Only logical virtual interfaces cannot be inactivated. By terminating virtual interfaces, related logical virtual interfaces are automatically terminated.
When inactivating virtual interfaces and logical virtual interfaces, a high-level application must be terminated first.
It is possible to specify this command to a virtual interface of Fast switching mode (operation mode is "t"), NIC switching mode ("d" or "e"), GS linkage mode("c"). It is not possible to specify to a virtual interface of a standby patrol function ("p" or "q"). A Standby patrol function ("p" or "q") is automatically deactivated when deactivated a virtual interface of the corresponding NIC switching mode ("d" or "e").
Be sure to use a stphanet command to deactivate a virtual interface. Do not use an ifconfig command to do the operation.
A virtual interface of standby patrol set after activated NIC switching mode and activated by strptl command is not deactivated. Use stpptl command to deactivate.
When a virtual interface of NIC switching mode is deactivated and only a virtual interface of standby patrol is activated, use stpptl command to deactivate the virtual interface of standby patrol.
When deactivating a virtual interface, if stacked physical interfaces are not used at all, deactivate them as well.
When using Fast switching mode on IPv6 environment, it takes maximum 30 seconds to complete stphanet command. The following message might be output to /var/log/messages, but it is not an error.
"kernel: unregister_netdevice: waiting for shaX to become free."
If you want to inactivate a virtual interface using Fast switching mode or GS linkage mode, wait at least 1 minute to execute the command to activate after deactivating it.
For execution of this command for a virtual interface of NIC switching mode, if physical interfaces bundled by a virtual interface are not used in any other virtual interfaces, physical IP is also deactivated in addition to virtual IP.
If a virtual bridge is connected to a virtual interface used in Virtual NIC mode, the virtual interface cannot be deactivated. Execute this command after disconnecting the virtual bridge.
[Examples]
The following is an example in which all virtual interfaces (excluding virtual interfaces in cluster operation) defined in the configuration information for Redundant Line Control Function are inactivated.
# /opt/FJSVhanet/usr/sbin/stphanet |
The following is an example in which only the virtual interface sha2 defined in the configuration information for Redundant Line Control Function is inactivated.
# /opt/FJSVhanet/usr/sbin/stphanet -n sha2 |
The following shows an example to deactivate all virtual interfaces of Fast switching mode or NIC switching mode and also in dual stack configuration.
# /opt/FJSVhanet/usr/sbin/stphanet dual |