Cluster I/O Protocols (CIP) Configuration and Management Manual (H06.16+, J06.05+)

NOTE: Do not use the SWITCH command to fail over interfaces you plan to delete. The interface
remains in the UP state when you use the SWITCH command. Before deleting an interface, use
ifstop. The ifstop command deactivates the interface, preventing autoconfigured IPv6 addresses
and link local addresses from being created in the interim.
NOTE: The storage subsystem ($ZZSTO) also supports a SWITCH CLIM command. For syntax
and display examples, see the SCF Reference Manual for the Storage Subsystem.
SWITCH CLIM Command Syntax
SWITCH CLIM $ZZCIP.clim-name
{,FAILOVER | ,RESTORE }
{ [,INTF intf-name] | [, PROVIDER prov-name ] }
[,FORCED]
clim-name
Is the name of the CLIM containing the interface(s) upon which to perform failover. Wildcard
characters are not allowed.
FAILOVER
Moves all resources off the specified interface(s) to the alternate failover location(s).
RESTORE
Moves the home resources of the specified interface(s) back to the home interface(s).
INTF intf-name
Specifies the name of a single interface for the failover operation. The CLIM name part of the
interface name must not be specified. Wildcard characters are not allowed. If this option and
the PROVIDER option are omitted, then all interfaces on the CLIM are specified.
PROVIDER prov-name
Specifies the name of a single IPDATA provider for the failover operation. All interfaces
associated with the specified IPDATA provider on that CLIM are affected by this failover
operation. Wildcard characters are not allowed. If this option and the INTF option are omitted,
all interfaces on the CLIM are specified.
FORCED
Indicates that no warning should be issued and confirmation is assumed.
Example 84 migrates all interface resources off of N1002532 to prepare for maintenance.
Example 84 SWITCH CLIM
> SWITCH CLIM $ZZCIP.N1002532,FAILOVER
Open connections still exist, okay to continue? Y
Example 85 manually restores interface clim2.eth3 back to N1003741.
Example 85 SWITCH CLIM RESTORE
> SWITCH CLIM $ZZCIP.N1003741,RESTORE, INTF ETH3
Open connections still exist, okay to continue? Y
SWITCH CLIM Guidelines
• For each specified interface, the interface must be up, a failover interface must be defined
and valid, the destination CLIM must be in the STARTED state, and the destination interface
must be up. No error is generated for interface resources that have already been migrated,
but an error is given if interface resources cannot be migrated.
• Before migrating interface resources, each destination CLIM checks whether the migrating
addresses already exist on the IP network. If any do, CIP issues an error and does not switch
the interface. This behavior helps synchronize IP-address migration between the CLIMs involved.
274 SCF Reference for CIP