---

HMC Manual Reference Pages  - CHNPORTLOGIN (1)

---

chnportlogin - N_Port log in and log out

CONTENTS

Synopsis
Description
Options
Exit Status
Examples
Environment
Bugs
Author
See Also

chnportlogin -o {login | logout} -m managed-system
{-p partition-name | --id partition-ID} [-n profile-name]
[-w wait-time] [-d detail-level] [-v] [--help]

chnportlogin performs N_Port login and logout operations for virtual Fibre Channel client adapters that are configured in a partition or a partition profile.

When performing a login operation, all inactive WWPNs will be activated, including the second WWPN in the pair assigned to each virtual Fibre Channel client adapter. When performing a logout operation, all WWPNs not in use will be deactivated.

To successfully log in a virtual Fibre Channel client adapter, the corresponding virtual Fibre Channel server adapter must exist and it must be mapped.

The primary intent of the login operation is to allow the system administrator to allocate, log in and zone WWPNs before the client partition is activated. With best practices, the WWPNs should be logged out after they are zoned on the Storage Area Network (SAN) and before the partition is activated. If a partition is activated with WWPNs still logged in, the WWPNs used for client access are automatically logged out so they can be logged in by the client.

The login operation can also be used to zone the inactive WWPNs in preparation for a partition mobility operation. If the login operation is performed when a partition is already active, only the inactive WWPNs are activated to the "constant login" state similar to physical Fibre Channel adapters. The WWPNs that are already in use by the virtual Fibre Channel client adapters remain in control of the virtual Fibre Channel clients and are not under the control of this command. This means that active client virtual Fibre Channel WWPNs do not achieve a "constant login" state similar to physical Fibre Channel adapters.

The login operation can interfere with partition mobility operations. Best practice is to perform a logout operation for a partition before attempting to migrate the partition to another server. If a mobility operation is attempted with WWPNs still logged in, the firmware will attempt to automatically log out the WWPNs. However, in some cases, the logouts may not complete in time and may therefore cause the mobility operation to fail.

-o	The operation to perform. Valid values are login to log in the WWPNs assigned to the virtual Fibre Channel client adapters, or logout to log out the WWPNs assigned to the virtual Fibre Channel adapters.
-m	The name of the managed system on which to perform the operation. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name.
-p	The name of the partition for which to perform the operation. You must either use this option to specify the name of the partition, or use the --id option to specify the partition’s ID. The -p and the --id options are mutually exclusive.
--id	The ID of the partition for which to perform the operation. You must either use this option to specify the ID of the partition, or use the -p option to specify the partition’s name. The --id and the -p options are mutually exclusive.
-n	The name of the partition profile for which to perform the operation. The operation will be performed for all of the virtual Fibre Channel client adapters configured in the partition profile. If this option is not specified, then the operation will be performed for all of the virtual Fibre Channel client adapters in the current configuration of the partition.
-w	The maximum time, in minutes, to wait for each Virtual I/O Server (VIOS) command issued by the HMC to complete. If a VIOS command does not complete within the time specified, the login or logout operation for the virtual Fibre Channel client adapter will be stopped. wait-time must be a whole number. If wait-time is 0, the operation will not be timed out. If this option is not specified, a default value of 3 minutes is used.
-d	The level of detail requested from VIOS commands issued by the HMC. Valid values are 0 (none) through 5 (highest). If this option is not specified, a default value of 1 is used.
-v	Specify this option to enable verbose mode. When verbose mode is enabled and this command succeeds, all warning messages are displayed. When this command partially succeeds or fails, all warning and error messages are displayed regardless of whether this option is specified.
--help	Display the help text for this command and exit.

This command has the following return codes:

0	Success
100	Partial success

Any other value means the command failed.

Log in all of the inactive WWPNs assigned to the virtual Fibre Channel client adapters in a partition’s current configuration:

chnportlogin -m 9117-MMB*1234567 -o login -p clientPartition

Log in all of the WWPNs assigned to the virtual Fibre Channel client adapters in a partition profile:

chnportlogin -m sys1 -o login -p clientPartition -n defaultProf

Log out all of the WWPNs assigned to the virtual Fibre Channel client adapters in a partition profile:

chnportlogin -m sys1 -o logout -p clientPartition -n defaultProf

None

None

IBM Austin

lsnportlogin