Sun Microsystems Sun Enterprise Server Reference Manual

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: [e-mail]

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 tran­sport. 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 alter­nate 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 infor­mation.

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