JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
man pages section 1M: System Administration Commands     Oracle Solaris 11.1 Information Library
search filter icon
search icon

Document Information

Preface

Introduction

System Administration Commands - Part 1

System Administration Commands - Part 2

luxadm(1M)

mail.local(1M)

makedbm(1M)

makemap(1M)

masfcnv(1M)

mdlogd(1M)

mdmonitord(1M)

mdnsd(1M)

medstat(1M)

metaclear(1M)

metadb(1M)

metadetach(1M)

metadevadm(1M)

metahs(1M)

metaimport(1M)

metainit(1M)

metaoffline(1M)

metaonline(1M)

metaparam(1M)

metarecover(1M)

metarename(1M)

metareplace(1M)

metaset(1M)

metassist(1M)

metastat(1M)

metasync(1M)

metattach(1M)

mib2mof(1M)

mibiisa(1M)

mkbootmedia(1M)

mkdevalloc(1M)

mkdevmaps(1M)

mkfifo(1M)

mkfile(1M)

mkfs(1M)

mkfs_pcfs(1M)

mkfs_udfs(1M)

mkfs_ufs(1M)

mknod(1M)

mkntfs(1M)

mkpwdict(1M)

modinfo(1M)

modload(1M)

modunload(1M)

mofcomp(1M)

mofreg(1M)

monacct(1M)

monitor(1M)

mount(1M)

mountall(1M)

mountd(1M)

mount_hsfs(1M)

mount_nfs(1M)

mount_pcfs(1M)

mount_smbfs(1M)

mount_tmpfs(1M)

mount_udfs(1M)

mount_ufs(1M)

mpathadm(1M)

mpstat(1M)

msgid(1M)

mvdir(1M)

named(1M)

named-checkconf(1M)

named-checkzone(1M)

named-compilezone(1M)

ncaconfd(1M)

ncheck(1M)

ncheck_ufs(1M)

ndd(1M)

ndmpadm(1M)

ndmpd(1M)

ndmpstat(1M)

netadm(1M)

netcfg(1M)

netcfgd(1M)

netservices(1M)

netstat(1M)

netstrategy(1M)

newaliases(1M)

newfs(1M)

newkey(1M)

nfs4cbd(1M)

nfsd(1M)

nfslogd(1M)

nfsmapid(1M)

nfsref(1M)

nfsstat(1M)

nscadm(1M)

nscd(1M)

nscfg(1M)

nsdb-list(1M)

nsdb-nces(1M)

nsdbparams(1M)

nsdb-resolve-fsn(1M)

nsdb-update-nci(1M)

nslookup(1M)

nsupdate(1M)

ntfscat(1M)

ntfsclone(1M)

ntfscluster(1M)

ntfscmp(1M)

ntfscp(1M)

ntfsfix(1M)

ntfsinfo(1M)

ntfslabel(1M)

ntfsls(1M)

ntfsprogs(1M)

ntfsresize(1M)

ntfsundelete(1M)

nulladm(1M)

nwamd(1M)

obpsym(1M)

oplhpd(1M)

pageout(1M)

parted(1M)

pbind(1M)

pcitool(1M)

pfedit(1M)

pginfo(1M)

pgstat(1M)

picld(1M)

ping(1M)

pkg2du(1M)

pkgadd(1M)

pkgadm(1M)

pkgask(1M)

pkgchk(1M)

pkgcond(1M)

pkg.depotd(1M)

pkgrm(1M)

pkg.sysrepo(1M)

plockstat(1M)

pntadm(1M)

polkit-is-privileged(1M)

pooladm(1M)

poolbind(1M)

poolcfg(1M)

poold(1M)

poolstat(1M)

ports(1M)

poweradm(1M)

poweroff(1M)

powertop(1M)

pppd(1M)

pppoec(1M)

pppoed(1M)

pppstats(1M)

praudit(1M)

prctmp(1M)

prdaily(1M)

projadd(1M)

projdel(1M)

projmod(1M)

prstat(1M)

prtacct(1M)

prtconf(1M)

prtdiag(1M)

prtdscp(1M)

prtfru(1M)

prtpicl(1M)

prtvtoc(1M)

psradm(1M)

psrinfo(1M)

psrset(1M)

pwck(1M)

pwconv(1M)

quot(1M)

quota(1M)

quotacheck(1M)

quotaoff(1M)

quotaon(1M)

rad(1M)

raidctl(1M)

ramdiskadm(1M)

rarpd(1M)

rcapadm(1M)

rcapd(1M)

rctladm(1M)

rdate(1M)

rdisc(1M)

reboot(1M)

rem_drv(1M)

remove_allocatable(1M)

removef(1M)

reparsed(1M)

repquota(1M)

restricted_shell(1M)

rexd(1M)

rexecd(1M)

rlogind(1M)

rmmount(1M)

rmt(1M)

rmvolmgr(1M)

rndc(1M)

rndc-confgen(1M)

roleadd(1M)

roledel(1M)

rolemod(1M)

root_archive(1M)

route(1M)

routeadm(1M)

routed(1M)

rpcbind(1M)

rpc.bootparamd(1M)

rpcinfo(1M)

rpc.mdcommd(1M)

rpc.metad(1M)

rpc.metamedd(1M)

rpc.metamhd(1M)

rpc.rexd(1M)

rpc.rstatd(1M)

rpc.rusersd(1M)

rpc.rwalld(1M)

rpc.smserverd(1M)

rpc.sprayd(1M)

rpc.yppasswdd(1M)

rpc.ypupdated(1M)

rquotad(1M)

rsh(1M)

rshd(1M)

rstatd(1M)

rtc(1M)

rtquery(1M)

runacct(1M)

rusersd(1M)

rwall(1M)

rwalld(1M)

rwhod(1M)

sa1(1M)

sa2(1M)

sadc(1M)

sar(1M)

sasinfo(1M)

savecore(1M)

sbdadm(1M)

sched(1M)

sckmd(1M)

scmadm(1M)

sconadm(1M)

sendmail(1M)

sftp-server(1M)

shadowd(1M)

shadowstat(1M)

share(1M)

shareall(1M)

sharectl(1M)

share_nfs(1M)

share_smb(1M)

showmount(1M)

shutacct(1M)

shutdown(1M)

slpd(1M)

smattrpop(1M)

smbadm(1M)

smbd(1M)

smbiod(1M)

smbiod-svc(1M)

smbios(1M)

smbstat(1M)

smrsh(1M)

smtp-notify(1M)

sndradm(1M)

sndrd(1M)

sndrsyncd(1M)

snmpdx(1M)

snmp-notify(1M)

snmpXwbemd(1M)

snoop(1M)

soconfig(1M)

soladdapp(1M)

soldelapp(1M)

solstice(1M)

sppptun(1M)

spray(1M)

sprayd(1M)

srptadm(1M)

sshd(1M)

ssh-keysign(1M)

startup(1M)

statd(1M)

stclient(1M)

stmfadm(1M)

stmsboot(1M)

strace(1M)

strclean(1M)

strerr(1M)

sttydefs(1M)

su(1M)

sulogin(1M)

suriadm(1M)

svadm(1M)

svcadm(1M)

svcbundle(1M)

svccfg(1M)

svc.configd(1M)

svc.ipfd(1M)

svc.startd(1M)

swap(1M)

sxadm(1M)

sync(1M)

syncinit(1M)

syncloop(1M)

syncstat(1M)

sysconfig(1M)

sysdef(1M)

syseventadm(1M)

syseventconfd(1M)

syseventd(1M)

syslogd(1M)

talkd(1M)

tapes(1M)

telnetd(1M)

tftpd(1M)

th_define(1M)

th_manage(1M)

tic(1M)

tncfg(1M)

tnchkdb(1M)

tnctl(1M)

tnd(1M)

tninfo(1M)

tpmadm(1M)

traceroute(1M)

trapstat(1M)

ttymon(1M)

tunefs(1M)

turnacct(1M)

txzonemgr(1M)

tzreload(1M)

tzselect(1M)

uadmin(1M)

ucodeadm(1M)

ufsdump(1M)

ufsrestore(1M)

umount(1M)

umountall(1M)

System Administration Commands - Part 3

mpathadm

- multipath discovery and administration

Synopsis

mpathadm subcommand direct-object [options] [operand]

Description

The mpathadm command enables multipathing discovery and management. The mpathadm command is implemented as a set of subcommands, many with their own options, that are described in the section for that subcommand. Options not associated with a particular subcommand are described under OPTIONS. The mpathadm subcommands operate on a direct-object. These are described in this section for each subcommand. The direct-objects, initiator-port, target-port, andlogical-unit in the subcommands are consistent with SCSI standard definitions.

The mpathadm command supports the following subcommands, which are described in detail in subsections that follow.

list

Display a list of discovered instances for a given object.

show

Display information about a given object instance.

modify

Modify properties of an object.

enable

Enable an object.

disable

Disable an object.

failover

Cause target port group failover for a logical-unit.

override

Set a path to be used over other paths on a logical-unit.

The mpathadm subcommands operate on a direct-object. These are described in this section for each subcommand.

list Subcommand

The syntax for the list subcommand is:

# mpathadm list direct-object [operands...]

The list subcommand displays data for following direct-objects:

mpath-support [mpath-support-name, ...]

List the multipathing support that can be administered by this CLI. This presents itself in the form of a library name registered through the MPAPI framework. If no mpath-support name mpath-support-name is specified, all registered multipathing support libraries will be displayed.

initiator-port [initiator-port-name, ...]

List the initiator ports that are discovered on this system. If no initiator-port-name is specified, all discovered initiator ports are displayed.

{logical-unit | lu} [options] [logical-unit-name, ...]

List the information on multipath logical units. If no logical-unit-name is specified, all discovered logical-units will be displayed.

Options for list logical-unit are as follows:

-n, --name name

Return the logical unit name that is associated with the given name string. This name can be extracted from the output of the mpathadm show lu command.

-t, --target-port target-port-name

Return the list of logical units names that are associated with the given target-port-name.

show Subcommand

The syntax for the show subcommand is:

# mpathadm show direct-object [operands...]

The show subcommand displays detailed information for following the direct-objects:

mpath-support [mpath-support-name, ...]

Show the detailed information on the given mpath-support-name if the name exists. If the given mpath-support-name supports only a limited set of device products, the list of device products will be listed as part of the output.

initiator-port initiator-port-name[,initiator-port-name, ...]

Show the detailed information for the given initiator-port-name.

{logical-unit | lu} [logical-unit-name, ...]

Display the detailed information on multipath logical unit(s), including path and target port group information. Note that the name property in the logical unit information represents the identifier for this LUN, derived from the hardware, and used by this system. If the name is derived from SCSI Inquiry Vital Product Data (VPD) page 83h, the name type property represents an associated identifier type defined by the SCSI standards.

modify Subcommand

The syntax for the modify subcommand is:

# mpathadm modify direct-object [options] [operands...]

The modify subcommand modifies characteristics of the following direct-objects:

mpath-support [options] mpath-support-name, ...

Configuration management of an mpath-support. Options to modify mpath-support are as follows:

-a, --autofailback on | off

Set autofailback. Applicable only when mpath-support provides auto failback support.

-p, --autoprobe on | off

Set autoprobing. Applicable only when mpath-support provides auto probing support.

-b, --loadbalance loadbalance-type

Change the default load balance type. The loadbalance type is one of the supported types listed in the show mpath-support output.

{logical-unit | lu} [options] logical-unit-name, ...

Configuration management of a logical unit. Options to modify logical-unit are as follows:

-a, --autofailback on | off

Set autofailback. Applicable only when mpath-support provides auto failback support

-p, --autoprobe on | off

Set autoprobing. Applicable only when mpath-support provides auto probing support.

-b, --loadbalance loadbalance-type

Set load balance type for the logical unit. Applicable only when load balance configuration is supported at the logical unit level.

enable Subcommand

The syntax for the enable subcommand is:

# mpathadm enable [options]

The enable subcommand supports the following direct-objects to be enabled:

path -i initiator-port-name -t target-port-name
-l logical-unit-name

The path that consists of the specified initiator port, target port, and logical unit will be enabled.

disable Subcommand

The syntax for the disable subcommand is:

# mpathadm disable [options]

The disable subcommand supports the following direct-objects to be disabled:

path -i initiator-port-name -t target-port-name
-l logical-unit-name

The path that consists of the specified initiator port, target port, and logical unit will be disabled.

failover Subcommand

The syntax for the failover subcommand is:

# mpathadm failover direct-object [operand]

The failover subcommand supports failover for the following direct-objects:

{logical-unit | lu} logical-unit-name

The target port group will failover when the given logical-unit is asymmetric and supports explicit state change. The currently active target port group will be changed to the standby state and the standby target port group will be active.

override Subcommand

The syntax for the override subcommand is:

# mpathadm override [options]

The override subcommand controls whether or not the following direct-objects override another:

path {-i initiator-port-name -t target-port-name | -c}
-l logical-unit-name

Cause a path that consists of the specified initiator port, target port, and logical unit to override other paths on the logical unit. Once a path overrides other paths, the mpath-support uses only that path regardless of any other path selection configuration. The -c option cancels the setting. The path that consists of the specified initiator port, target port, and logical unit will be disabled.

Options for override path are as follows:

-i, --initiator-port initiator-port-name

Represent the initiator port element of a path. Options -t and -l must also be included.

-t, --target-port target-port-name

Represent the target port element of a path. Options -i and -l must also be included.

-l, --logical-unit logical-unit

Represent the logical unit element of a path. Options -i and -t must also be included.

-c, --cancel

Cancels overriding setting for the given logical unit. Option -l must also be included.

Options

The following options are supported:

-V, --version

Display the version information.

-?, --help

Display context help. Can be used following an mpathadm command with no arguments, following a subcommand, or following a subcommand direct-object combination. Responds with help information appropriate for your entry. For example, if you enter:

# mpathadm add mpath-support-help

... mpathadm responds with a display of the options available for that combination of subcommand and direct-object.

Examples

Example 1 Obtaining a List of Multipathing Support

The following command uses the list subcommand to list all currently registered mpath-support libraries.

# mpathadm list mpath-support
mpath-support: libmpscsi_vhci.so

Example 2 Displaying the Properties of a Particular Multipathing Support

The following command uses the show subcommand to display the properties for a currently registered mpath-support library.

# mpathadm show mpath-support libmpscsi_vhci.so
mpath-support:    libmpscsi_vhci.so
       Vendor:  Sun Microsystems
       Driver Name:  scsi_vhci
       Default Load Balance:  round-robin
       Supported Load Balance Types:
              round-robin
          logical-block
Allows To Activate Target Port Group Access:  yes
Allows Path Override:  no
Supported Auto Failback Config:     1
Auto Failback:    on
Failback Polling Rate (current/max):  0/0
Supported Auto Probing Config:    0
Auto Probing:  NA
Probing Polling Rate (current/max):  NA/NA
Supported Devices:
       Vendor:     SUN
       Product:  T300
       Revision:
       Supported Load Balance Types:
              round-robin
       Vendor:     SUN
       Product:  T4
       Revision:
       Supported Load Balance Types:
              round-robin

Example 3 Obtaining a List of Initiator Ports Discovered Through the mpath-support Libraries

The following command uses the list initiator-port subcommand to display a list of initiator ports discovered by the currently registered mpath-support libraries.

# mpathadm list initiator-port
Initiator-Port: iqn.1986-03.com.sun:01:080020b7ac2b.437a3b3e,4000002a0000
Initiator-Port: 2000000173018713
Initiator-Port: 2000000173818713

Example 4 Displaying the Properties of a Particular Initiator Port

The following command uses the show initiator-port subcommand to display the properties of a particular initiator port discovered using the list initiator-port subcommand in an example above.

# mpathadm show initiator-port 2000000173018713
initiator-port:     2000000173018713
        Transport Type:     Fibre Channel
        OS device File:     devices/pci@1f,4000/pci@2/SUNW,qlca@5/fp@0,0:fc

Example 5 Displaying the Properties of a Particular Logical Unit

The following command uses the show logical-unit subcommand to display the properties of the logical unit with the specified name.

# mpathadm show lu /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2
Logical Unit: /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2
           mpath-support libmpscsi_vhci.so
           Vendor: SUN
           Product: T4
           Revision: 0301
    Name Type: SCSI Inquiry VPD Page 83 type 3
    Name: 60003ba27d2120004204ac2b000dab00
    Asymmetric: yes
    Current Load Balance: round-robin
    Logical Unit Group ID: NA
    Aauto Failback: on
    Auto Probing: NA

Paths:
    Initiator Port Name: 2000000173818713
    Target Port Name: 20030003ba27d212
    Override Path: NA
    Path State: OK
    Disabled: no

    Initiator Port Name: 2000000173018713
    Target Port Name: 20030003ba27d095
    Override Path: NA
    Path State: OK
    Disabled: no

Target Port Group:
    ID: 2
    Explicit Failover: yes
    Access State: standby
    Target Ports:
            Name: 20030003ba27d212
           Relative ID: 0

    ID: 5
    Explicit Failover: yes
    Access State: active
    Target Ports
            Name: 20030003ba27d095
           Relative ID: 0

Example 6 Enabling a Path

The following command uses the enable path subcommand to enable the path with the specified initiator port, target port, and logical unit.

# mpathadm enable path -i 2000000173018713 -t 20030003ba27d095     \
-l /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2

Example 7 Modifying mpath-support To Turn On autofailback

# mpathadm modify mpath-support -a on libmpscsi_vhci.so

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/storage/multipath-utilities
system/library/storage/libmpapi (exec_attr(4) entry)
Interface Stability
Committed

See Also

stmsboot(1M), libMPAPI(3LIB), exec_attr(4), attributes(5)