Sun Microsystems, Inc.
901 San Antonio Road
Palo Alto, CA 94303
U.S.A. 650-960-1300
Sun™ Enterprise™ Server
Alternate Pathing 2.1
Reference Manual
Part No. 805-5443-10
May 1998, Revision A
Send comments about this document to: smcc-docs@sun.com
Copyright 1997 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, California 94303 U.S.A. All rights reserved.
This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and
decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization
of Sun and its licensors, if any . Third-party softwar e, including font technology , is copyrighted and licensed fr om Sun suppliers.
Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a register ed
trademark in the U.S. and other countries, exclusively licensed through X/Open Company , Ltd.
Sun, Sun Microsystems, the Sun logo, SunSoft, SunDocs, SunExpress, Solaris, and Sun Enterprise are trademarks, register ed
trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SP ARC trademarks are used under license
and are trademarks or registered trademarks of SP ARC International, Inc. in the U.S. and other countries. Pr oducts bearing SP ARC
trademarks are based upon an architecture developed by Sun Microsystems, Inc.
The OPEN LOOK and Sun™ Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun
acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the
computer industry . Sun holds a non-exclusive license from Xerox to the Xer ox Graphical User Interface, which license also covers Sun’s
licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements.
RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions of F AR 52.227-14(g)(2)(6/87)
and FAR 52.227-19(6/87), or DFAR 252.227-7015(b)(6/95) and DFAR 227.7202-3(a).
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE
LEGALLY INVALID.
Copyright 1997 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, Californie 94303 Etats-Unis. T ous droits réservés.
Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie, la
distribution, et la décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque
moyen que ce soit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers,
et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun.
Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une
marque déposée aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company , Ltd.
Sun, Sun Microsystems, le logo Sun, SunSoft, SunDocs, SunExpress, Sun Enterprise, et Solaris sont des marques de fabrique ou des
marques déposées, ou marques de service, de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SP ARC
sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SP ARC International, Inc. aux Etats-Unis et
dans d’autres pays. Les produits portant les marques SP ARC sont basés sur une ar chitecture développée par Sun Microsystems, Inc.
L’interface d’utilisation graphique OPEN LOOK et Sun™ a été développée par Sun Micr osystems, Inc. pour ses utilisateurs et licenciés.
Sun reconnaît les efforts de pionniers de Xerox pour la recher che et le développement du concept des interfaces d’utilisation visuelle
ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xerox sur l’interface d’utilisation graphique
Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui
en outre se conforment aux licences écrites de Sun.
CETTE PUBLICATION EST FOURNIE "EN L’ETAT" ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS
DES GARANTIES CONCERNANT LA V ALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION
PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE
S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.
Please
Recycle
AP Commands Intro ( 1M )
NAME Intro–AP administration
DESCRIPTION This section describes commands, scripts, and programs executed in the Alternate
Pathing environment.
LIST OF
COMMANDS
ap(1M) alternate pathing
ap_daemon(1M) alternate pathing daemon
ap_reboot_host(1M) fast boot alternate path
ap_ssp_daemon(1M) AP SSP daemon
apboot(1M) set up system files for boot meta-disk
apcheck(1M) determine accessibility of a meta-disk
apconfig(1M) display and manage AP configuration
apdb(1M) manage AP database
apdisk(1M) manage disk pathgroups
apinst(1M) identify disk host adapter instances, /dev/dsk targets
apnet(1M) manage network pathgroups
apssp(1M) client of AP SSP daemon
AP 2.1 1M-1
ap ( 1M ) AP Commands
NAME ap–alternate pathing
DESCRIPTION Alternate Pathing (AP) enables you to define and control alternate physical paths to
peripheral devices. If a path to a device becomes unavailable, your Sun server can use
an alternate path.
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
1M-2 AP 2.1
AP Commands ap_daemon ( 1M )
NAME ap_daemon–alternate pathing daemon
SYNOPSIS ap_daemon
DESCRIPTION /usr/sbin/ap_daemon is an RPC program that provides the interface to the Alternate
Pathing (AP) driver.
Configuration
Information
The ap_daemon RPC program name is AP_SVR, its RPC program number is 300473,
and its underlying protocol is TCP. It is invoked as an inetd server via the TCP transport. The UID required for access to the daemon is ssp. This UID can be a non-login
UID.
The entry for the daemon in the /etc/inetd.conf file is:
300473/1 tli rpc/tcp wait root /usr/sbin/ap_daemon ap_daemon
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
apconfig(1M), apdb(1M), apdisk(1M), apnet(1M)
AP 2.1 1M-3
ap_reboot_host ( 1M ) AP Commands
NAME ap_reboot_host–fast boot alternate path
SYNOPSIS ap_reboot_host
AVAILABILITY Sun Enterprise 10000 servers only.
DESCRIPTION Caution: Do not execute ap_reboot_host on the command line; it is intended for use
only by other commands.
$SSPOPT/bin/ap_reboot_host is executed when a boot failure is detected. It deter-
mines the boot path of the previous boot and attempts to restart the host from an alternate path if one is available.
1M-4 AP 2.1
AP Commands ap_ssp_daemon ( 1M )
NAME ap_ssp_daemon–AP SSP daemon
SYNOPSIS ap_ssp_daemon
AVAILABILITY Sun Enterprise 10000 servers only. This command is executed in the SSP environment.
DESCRIPTION $SSPOPT/bin/ap_ssp_daemon is an RPC program that maintains an SSP-based file
that contains Alternate Pathing (AP) information for the boot disks. This file is updated
automatically by ap_daemon(1M).
ap_ssp_daemon provides its information to apssp(1M), which then passes it to
ap_reboot_host(1M). The SSP program apssp(1M) provides the interface to
ap_ssp_daemon.
The daemon’s only clients are apssp(1M) and ap_daemon(1M). apssp(1M) provides a
way to access the information the daemon keeps. ap_daemon(1M) updates the information.
SEE ALSO ap_daemon(1M), ap_reboot_host(1M), apssp(1M)
AP 2.1 1M-5
apboot ( 1M ) AP Commands
NAME apboot–set up system files for boot meta-disk
SYNOPSIS apboot [–n] [–k system-name] [–v vfstab-name] device
apboot [–m metadevice-name]
apboot [–u metadevice-name]
DESCRIPTION Use /usr/sbin/apboot to edit /etc/vfstab and /etc/system to make the system bootable
from either the boot disk file systems on an AP meta-disk or the boot disk file systems
on a disk device that is not alternately pathed; or to allow AP to coherently manage a
mirrored boot device when both that boot device and its mirror are under AP control.
OPTIONS
EXAMPLES apboot mc3t0d0
FILES /etc/system kernel patch file
–
n Print what would be done without actually doing it.
–
k system-name
Edit system-name instead of the default /etc/system file.
–
v vfstab-name
Edit vfstab-name instead of the default /etc/vfstab table of file system defaults.
–
m metadevice-name
Enable boot mirror support for the specified AP meta-device.
–
u metadevice-name
Disable boot mirror support for the specified AP meta-device.
Edits /etc/system and /etc/vfstab to specify that the boot disk file systems are
now on meta-disk mc3t0d0.
apboot c3t0d0
Edits /etc/system and /etc/vfstab to specify that the boot disk file systems are
now under the physical path /dev/dsk/c3t0d0.
apboot mc3t0d0
apboot -m mc1t0d1
These commands edit /etc/system and /etc/vfstab to specify that the boot disk
file systems are now on meta-disk mc3t0d0, with a mirror on mc1t0d1.
apboot -u mc1t0d1
Disables AP support for the mirror device created in the previous example.
/etc/vfstab table of file system defaults
SEE ALSO system(4), vfstab(4) in man Pages(4): File Formats of the SunOS Reference Manual
1M-6 AP 2.1
AP Commands apcheck ( 1M )
NAME apcheck–determine accessibility of a meta-disk
SYNOPSIS apcheck special
DESCRIPTION Caution: Do not execute apcheck on the command line; it is intended for use
only by other commands, or by authorized service providers.
/sbin/apcheck ascertains whether a meta-disk is usable. If it is able to locate dual
paths, apcheck exits with a zero status; if not, it exits with a non-zero status.
OPTION special represents the device node to be checked. This device node may reside under
/dev/ap/dsk or /dev/ap/rdsk.
AP 2.1 1M-7
apconfig ( 1M ) AP Commands
NAME apconfig–display and manage AP configuration
SYNOPSIS apconfig–D
apconfig–F
apconfig–N [–u]
apconfig–P meta_netwk_intrfc–a new_phys_path
apconfig–P primary_path–a new_phys_path
apconfig–R
apconfig–S [–u]
DESCRIPTION The /usr/sbin/apconfig command displays and helps you manage the Alternate Pathing
(AP) system configuration.
OPTIONS
–
D Display location and status information for all known copies of the
host database.
–
F Force the state (attached or detached) of every committed pathgroup
alternate to match the physical state of the system. Use this option if
the two states differ. It refreshes the Dynamic Reconfiguration (DR)
flags for every disk I/O port and physical network interface defined
for all committed pathgroups.
–
N [–u] Display network AP information only. For each pathgroup,
apconfig–N displays the meta-network interface and the correspond-
ing physical network interfaces.
If you specify the–u option, apconfig displays uncommitted path-
group information only. If you do not specify the–u option, apconfig
displays committed pathgroup information only. See Letters after
names and paths, below.
–
P meta_ntwrk_intrfc–a new_phys_path
Switch to the new physical path specified by–a for the meta-network
specified by -P.
–
P primary_path–a new_phys_path
Switch to the new physical path specified by–a for the primary path
specified by -P.
–
R Rebuild the meta-disk device nodes in /dev/ap/dsk and /dev/ap/rdsk.
apconfig creates links to /devices for all committed disk pathgroups in
the database.
Note: You must execute drvconfig–i ap_dmd before you
can execute apconfig–R. See drvconfig(1M) and
ap_dmd(7).
–
S [–u] Display alternate pathing information for disk pathgroups only. (S
stands for SCSI.) For each pathgroup, apconfig shows the names for
the meta-disk, its physical devices, and the disk I/O ports through
1M-8 AP 2.1
AP Commands apconfig ( 1M )
which each physical device is accessed.
If you specify the–u option, apconfig displays only uncommitted
pathgroup information. Otherwise, it displays only committed pathgroup information. See Letters after names and paths, below.
Letters after names
and paths
When you specify–N or–S, one or more of the following letters may be displayed
after each meta-network or meta-disk name:
D Marked for deletion. The meta-disk or meta-network remains in the data-
base and continues to be used by AP until a commit is done. See
apdb(1M).
U Uncommitted. Note that you cannot use a meta-disk or meta-network until
a commit has been done.
R Marked for use as a root device.–S only.
M Marked as the mirror for a boot device.–S only.
X The physical paths for this meta-disk lead to different disks (i.e., different
SSA’s).–S only.
When you specify–N or–S, one or more of the following letters may be displayed
after each physical network name or disk I/O port name:
A The active alternate. To select another interface, use the -P and -a options.
DR
Marked as being drained by Dynamic Reconfiguration. A switch cannot be
made to a device path in this state. See the Sun Enterprise Server Alternate
Pathing User’s Guide.
DE Marked as detached by Dynamic Reconfiguration.
P The primary path. The primary path cannot be changed.
T Path has been tried as active.
O Marked as offline. See apdisk(1M) and apnet(1M).
EXAMPLES
Example 1 The following example displays all committed disk pathgroups in the AP database:
# apconfig -S
c6 pln0 A
c2 pln3 P
metadiskname(s):
mc2t5d0
mc2t4d0 R
mc2t3d0
mc2t2d0
mc2t1d0
AP 2.1 1M-9
apconfig ( 1M ) AP Commands
mc2t0d0
Example 2 The following example displays all uncommitted network pathgroups in the AP data-
base.
# apconfig -N -u
meta-network: mqe0 U
physical devices:
qe1
qe0 P A
Example 3 The following example switches the active alternate of the disk pathgroup for which
the primary path is pln1. The new active alternate of that pathgroup is pln0.
# apconfig -P pln1 -a pln0
Example 4 The following example switches the active alternate of the network pathgroup
identified by the meta-network interface mqe0. The new active alternate of that network pathgroup is qe1.
# apconfig -P mqe0 -a qe1
Example 5 The following example displays the location and status information of all known
copies of the AP database.
# apconfig -D
path: /dev/rdsk/c3t3d0s1
major: 32
minor: 145
timestamp: Wed Sep 28 18:45:58 1994
checksum: 2636010350
default: yes
corrupt: no
inaccessible: no
path: /dev/rdsk/c3t3d0s6
major: 32
minor: 150
timestamp: Wed Sep 28 18:50:43 1994
checksum: 2636010350
default: no
synced: yes
1M-10 AP 2.1
AP Commands apconfig ( 1M )
corrupt: no
inaccessible: no
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
apdb(1M), apdisk(1M), apnet(1M), ap_dmd(7) in this reference manual
drvconfig(1M) in man Pages(1M): System Administration Commands of the SunOS Reference
Manual
AP 2.1 1M-11
apdb ( 1M ) AP Commands
NAME apdb–manage AP database
SYNOPSIS apdb–c raw_disk_slice [–k system_file] [–f]
apdb–d raw_disk_slice [–k system_file] [–f]
apdb–m major–n minor [–f]
apdb–C
apdb–Z
DESCRIPTION The /usr/sbin/apdb command helps you manage the AP database.
OPTIONS
–
c raw_disk_slice
Create a database copy on the specified raw disk slice. You can create
up to 10 copies of the database. The minimum slice size is 300KBytes.
–
d raw_disk_slice
Delete a database copy from the specified raw disk slice.
–
f Force deletion of the specified database. This option is required for
creating the first copy of the database, and when deleting each of the
last two copies of the database. If you try to delete a database copy
without this option when fewer than two database copies exist, AP
displays an error message.
–
k system_file Patch the the database copy information to the kernel file system_file,
rather than the default file, /etc/system.
–
m major–n minor
Remove a database copy by specifying its location as a major-minor
pair. Use–m to specify the major and–n for the minor. This option
pair is useful when there is no path to the database because the device
no longer exists.
–
C Commit all uncommitted entries within the database.
–
Z Copy the database in memory to all database copies. Note that all
database copies are in sync with memory and are automatically
updated at system shutdown.–Z lets you update the database copies
at your discretion.
EXAMPLE The following example creates a copy of the AP system database on
/dev/rdsk/c2t0d0s1.
# apdb -c /dev/rdsk/c2t0d0s1
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
apconfig(1M), apdisk(1M), apnet(1M)
1M-12 AP 2.1
AP Commands apdisk ( 1M )
NAME apdisk–manage disk pathgroups
SYNOPSIS apdisk–c–p primary_path–a alternate_path
apdisk–d primary_path
apdisk–z primary_path
apdisk–f io_port
apdisk–n io_port
apdisk–u–p primary_path–a alternate_path
apdisk–w io_port
DESCRIPTION The /usr/sbin/apdisk command helps you manage disk pathgroups in the Alternate
Pathing (AP) system.
OPTIONS
–c–
p primary_path–a alternate_path
Create database entries for disks (i.e., a SPARCStorage Arrays) connected to two I/O ports. Give the I/O port names (e.g., pln0 and
pln1) as the primary_path and alternate_path.
–
d primary_path
Delete AP information for the specified disk pathgroup. If the existing
information is uncommitted, apdisk removes it immediately. If the
existing information is already committed, it is only marked for deletion and existing meta-devices continue to function until a commit is
done, at which time the information is removed.
–
z primary_path
Undelete AP information for the specified disk pathgroup. This option
cancels a previous apdisk–d request that marked committed information for deletion.
–
f io_port Mark the I/O port as offline. Corresponding meta-disks can still be
used if the other I/O port in the pathgroup is functioning properly.
Note that you cannot mark an I/O port offline if it is currently the
active alternate.
–
n io_port Mark the I/O port as online. Note that this operation does not
automatically cause the I/O port to become the active alternate.
–u–
p primary_path–a alternate_path
Update existing database entries for the disk pathgroup identified by
the primary path (e.g., pln0). Disk targets that are no longer accessible
through one or more paths are removed, and new disk targets are
added. To update the meta-disk device nodes execute
drvconfig–i ap_dmd and apconfig–R. See apconfig(1M) in this docu-
ment and drvconfig (1M) in man Pages(1M): System Administration Com-
mands of the SunOS Reference Manual.
AP 2.1 1M-13
apdisk ( 1M ) AP Commands
–
w io_port Clear the tried flag for the specified I/O port.
EXAMPLES
Example 1 The following example creates meta-disk device nodes and AP database entries for
disks reachable through pln0 and pln1, with pln0 specified as the primary path.
# apdisk -c -p pln0 -a pln1
# apdb -C
# drvconfig -i ap_dmd
# apconfig -R
Example 2 The following example deletes the AP database entries for disks with sf1 specified as
the primary path.
# apdisk -d sf1
# apdb -C
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
apdb(1M), apconfig(1M), apinst(1M), apnet(1M) in this reference manual
devlinks(1M), drvconfig(1M) in man Pages(1M): System Administration Commands of the
SunOS Reference Manual
1M-14 AP 2.1
AP Commands apinst ( 1M )
NAME apinst–identify disk host adapter instances, /dev/dsk targets
SYNOPSIS apinst
DESCRIPTION The /usr/sbin/apinst program identifies all disk host bus adapters and provides the
name, instance number and /dev/dsk targets attached to each.
EXAMPLE % apinst
isp0
/dev/dsk/c0t0d0
/dev/dsk/c0t1d0
/dev/dsk/c0t2d0
pln0
/dev/dsk/c1t0d0
/dev/dsk/c1t1d0
/dev/dsk/c1t2d0
/dev/dsk/c1t3d0
/dev/dsk/c1t4d0
/dev/dsk/c1t5d0
pln1
/dev/dsk/c2t0d0
/dev/dsk/c2t1d0
/dev/dsk/c2t2d0
/dev/dsk/c2t3d0
/dev/dsk/c2t4d0
/dev/dsk/c2t5d0
sf0
/dev/dsk/c3t0d0
/dev/dsk/c3t1d0
/dev/dsk/c3t2d0
/dev/dsk/c3t3d0
/dev/dsk/c3t4d0
/dev/dsk/c3t5d0
sf1
/dev/dsk/c4t0d0
/dev/dsk/c4t1d0
/dev/dsk/c4t2d0
/dev/dsk/c4t3d0
/dev/dsk/c4t4d0
/dev/dsk/c4t5d0
AP 2.1 1M-15
apnet ( 1M ) AP Commands
NAME apnet–manage network pathgroups
SYNOPSIS apnet–c -p ntwk_intrfc [–a ntwk_intrfc]
apnet–d meta_ntwk_intrfc
apnet–z meta_ntwk_intrfc
apnet–f ntwk_intrfc
apnet–n ntwk_intrfc
apnet–m meta_ntwk_intrfc–a ntwk_intrfc
apnet–m meta_ntwk_intrfc–r ntwk_intrfc
apnet–t meta_ntwk_intrfc
apnet–w meta_ntwk_intrfc
DESCRIPTION The /usr/sbin/apnet command helps you manage network pathgroups in the Alternate
Pathing (AP) system.
OPTIONS Note: The parameters meta_ntwk_intrfc and ntwk_intrfc are strings of the form
type instance_#, but with no space between them; for example, mle0 and mle1.
–
c -p ntwk_intrfc [–a ntwk_intrfc]
Create a meta-network interface and network pathgroup for the
specified network. If–a is given, apnet designates the specified network interface as the alternate for the meta-network interface. (If you
initially create a network pathgroup with only one path, you can later
add an additional path using apnet -m.)
–
d meta_ntwk_intrfc
Delete the specified meta-network interface and corresponding network pathgroup. If the pathgroup is currently uncommitted, apnet
removes the interface and the pathgroup immediately. If the pathgroup
is committed, the interface and pathgroup are only marked for deletion, and the interface continues to function until a commit is performed.
–
z meta_ntwk_intrfc
Undelete the specified meta-network interface and pathgroup. This
option cancels a previous apnet–d request that marked a committed
pathgroup for deletion.
–
f ntwk_intrfc Mark the specified network interface as offline and therefore inaccessi-
ble through its meta-network interface.
Note: An interface cannot be marked as offline if it is active.
–
n ntwk_intrfc Mark the specified network interface as online and therefore accessible
through its meta-network interface.
1M-16 AP 2.1
AP Commands apnet ( 1M )
–
m meta_ntwk_intrfc–a ntwk_intrfc
Add the specified network interface as the alternate for the specified
network pathgroup. You can use this option only if the network pathgroup currently contains exactly one path.
–
m meta_ntwk_intrfc–r ntwk_intrfc
Remove the specified network interface from the specified network
pathgroup.
Note: When an alternate is added (–a) or removed (–r) from a com-
mitted network pathgroup, a commit operation must be done
for the change to take effect. In practice, the existing metanetwork interface is marked for deletion and a new one is
created without affecting current usage of the interface.
–
t meta_ntwk_intrfc
Make the next alternate path in sequence (after the primary) the temporary active path. This option is intended for scripts that are trying
alternate paths in sequence until a working path is found. The command returns an error if the sequencing wraps back to the original primary.
–
w meta_ntwk_intrfc
Make the current temporary active path the actual active path.
EXAMPLES
Example 1 The following example creates a network pathgroup and a meta-network interface,
mle0, which has le0 as its primary physical network interface and le1 as its alternate
physical network interface.
# apnet -c -p le0 -a le1
# apdb -C
Example 2 The following example deletes the network pathgroup and meta-network interface
mle0:
# apnet -d mle0
# apdb -C
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
apconfig(1M), apdb(1M), apdisk(1M)
AP 2.1 1M-17
apssp ( 1M ) AP Commands
NAME apssp–client of AP SSP daemon
SYNOPSIS apssp
AVAILABILITY Sun Enterprise 10000 servers only.
DESCRIPTION Caution: Do not execute apssp on the command line; it is intended for use only
by other commands.
apssp is a client of the Alternate Pathing SSP daemon, ap_ssp_daemon(1M). It takes
information from ap_ssp_daemon and passes it to ap_reboot_host(1M).
SEE ALSO ap_ssp_daemon(1M), ap_reboot_host(1M)
1M-18 AP 2.1
AP Special Files Intro ( 7 )
NAME Intro–AP special files
DESCRIPTION This section describes AP files for your Sun server.
LIST OF
FUNCTIONS
ap(7) alternate pathing librarian driver, /dev/ap
ap_dmd(7) AP disk meta-driver
ap_nmd(7) AP network meta-driver group
mhme(7) Sun FastEthernet 2.0; see ap_nmd(7)
mle(7) Lance Ethernet special character device; see ap_nmd(7)
mnf(7) FDDI 3.0.x and 4.x special character device; see ap_nmd(7)
mqe(7) Quad Ethernet special character device; see ap_nmd(7)
mqfe(7) Quad Fast Ethernet special character device; see ap_nmd(7)
mvge(7) Sun Gigabit Ethernet special character device; see ap_nmd(7)
AP 2.1 7-1
ap ( 7 ) AP Special Files
NAME ap–alternate pathing librarian driver, /dev/ap
SYNOPSIS ap
DESCRIPTION The AP driver provides a pseudo-driver interface to the kernel Alternate Pathing (AP)
Librarian features.
FILES /kernel/drv/ap AP driver module
/kernel/drv/ap.conf AP driver configuration file
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
ap(1M), ap_daemon(1M)
7-2 AP 2.1
AP Special Files ap_dmd ( 7 )
NAME ap_dmd–AP disk meta-driver
SYNOPSIS ap_dmd@target,lun:partition
DESCRIPTION The ap_dmd driver works with the AP software to support Alternate Pathing for phy-
sical devices handled by the ssd SCSI disk driver. See ssd(7) in man Pages(7): Device
and Network Interfaces of the SunOS Reference Manual.
The AP feature lets you configure alternate SCSI paths to a physical device. These
paths are associated with a meta-disk device, which is one of the file system special
nodes associated with a particular meta-driver.
ap_dmd allows the AP Librarian, ap(7), to configure or unconfigure physical paths to a
SCSI device via an interface that allows APSET, APUNSET, and APSWITCH commands. These commands are issued by ap(7) at the behest of the user-invoked AP
commands and AP daemon. To change the SCSI path information associated with a
particular ap_dmd device, use apconfig(1M), apdb(1M) and apdisk(1M). For more
information, see the Sun Enterprise Server Alternate Pathing User’s Guide.
All device operations supported by the ssd driver are also valid on ap_dmd devices
that have been created via AP commands. See the other AP commands for details
regarding other components of AP software, and ssd(7) man page for information
about block/character file accesses, I/O requests, disk partitioning schemes, CD-ROM
support, and ioctls.
ERRORS ENXIO No physical SCSI path to the target device exists.
Other For information on other errors, see sd(7).
FILES apdmd.conf driver configuration file
/dev/ap/dsk/mncntndnsn block files
/dev/ap/rdsk/mncntndnsn raw files
where m identifies the device as a meta-device and:
cn Controller number
tn Target number
dn Logical unit number
sn Slice (partition) number
DIAGNOSTICS See ssd(7) in man Pages(7): Device and Network Interfaces of the SunOS Reference Manual.
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
apconfig(1M), apdb(1M), apdisk(1M), apnet(1M), ap_daemon(1M), ap(7), ap_nmd(7) in
this reference manual
ssd(7) in man Pages(7): Device and Network Interfaces of the SunOS Reference Manual
AP 2.1 7-3
ap_nmd ( 7 ) AP Special Files
NAME ap_nmd, mhme, mle, mnf, mqe, mqfe, mvge–AP network meta-driver group
SYNOPSIS /devices/pseudo/clone@0:mhme
/devices/pseudo/clone@0:mle
/devices/pseudo/clone@0:mnf
/devices/pseudo/clone@0:mqe
/devices/pseudo/clone@0:mqfe
/devices/pseudo/clone@0:mvge
DESCRIPTION ap_nmd is a group of multi-threaded, loadable, clonable, STREAMS meta-network
device drivers that support the connectionless Data Link Provider Interface, dlpi(7), for
hme(7) (Sun FastEthernet 2.0), le(7) (Lance Ethernet), nf(7) (FDDI 5.x), qe(7) (Quad
Ethernet), qfe (Quad FastEthernet), and vge (Sun Gigabit Ethernet).
Note: SunOS man pages that describe drivers for optional packages, such as
FDDI and Sun FastEthernet, are available only on systems that have those
packages installed.
ap_nmd works with the AP software to support Alternate Pathing for physical net-
work devices.
Device operations of ap_nmd are an extension of the operations of the underlying network drivers. ap_nmd normally operates as a transparent pass-through module; it neither interprets nor modifies any of the STREAMS DLPI type messages. However, it
does intercept and modify the DL_ATTACH_REQ and DL_INFO_ACK messages.
DL_ATTACH_REQ messages are captured and used to drive the initial connection
between logical and physical devices. DL_INFO_ACK messages are captured and
responded to with a prebuilt response to eliminate the possibility of the message
response timing out due to induced message delays.
The cloning character-special device /dev/m xx is used to access all device-specific
instances of the ap_nmd within the system.
ap_nmd and AP The ap_nmd driver provides an interface to support Alternate Pathing. The APSET
interface allows a user to provide a mapping between physical path and logical path.
The APUNSET provides an interface to remove a physical-to-logical path mapping and
APSWITCH provide a mechanism to switch a logical path from its existing physical
path to a new physical path. For a more complete description of the AP capability, see
the Sun Enterprise Server Alternate Pathing User’s Guide.
ap_nmd and DLPI The ap_nmd driver is a "style 2" Data Link Service provider. All DLPI processing is
handled by the underlying physical device driver. See the man page that corresponds
to each underlying driver.
ERRORS EBUSY An attempt was made to unload a busy device, or to APUNSET an
active device
7-4 AP 2.1
AP Special Files ap_nmd ( 7 )
EEXIST An attempt was made to APSET an existing logical-to-physical map-
ping and a logical path when the system was out of memory
EIO An attempt to switch between physical devices failed
ENODEV No physical mapping exists
ENOMEM System memory was exhausted during an attempt to create a mapping
between a physical path and a logical path
FILES mhme.conf Driver configuration file
mle.conf Driver configuration file
mnf.conf Driver configuration file
mqe.conf Driver configuration file
mqfe.conf Driver configuration file
mvge.conf Driver configuration file
/dev/mhme hme special character device
/dev/mle le special character device
/dev/mnf nf special character device
/dev/mqe qe special character device
/dev/mqfe qfe special character device
/dev/mvge vge special character device
DIAGNOSTICS See le(7) and qe(7) in man Pages(7): Device and Network Interfaces of the SunOS Reference
Manual.
SEE ALSO Sun Enterprise Server Alternate Pathing User’s Guide
ap_daemon(1M), apconfig(1M), apdb(1M), apnet(1M), ap(7), ap_dmd(7), in this refer-
ence manual
driver.conf(4) in man Pages(4): File Formats of the SunOS Reference Manual
man Pages(7): Device and Network Interfaces of the SunOS Reference Manual and other
optional reference manuals (for example, FDDI Reference Manual), as appropriate
AP 2.1 7-5
Loading...