JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual     Sun QFS and Sun Storage Archive Manager 5.3 Information Library
search filter icon
search icon

Document Information

Preface

1.  User Commands (Man Pages Section 1)

2.  Maintenance Commands (Man Pages Section 1M)

archive_audit(1M)

archive_mark(1M)

archiver(1M)

archiver.sh(1M)

arcopy(1M)

arfind(1M)

auditslot(1M)

backto(1M)

build_cat(1M)

chmed(1M)

cleandrive(1M)

clri(1M)

damage(1M)

dev_down.sh(1M)

dmpshm(1M)

dump_cat(1M)

dump_log(1M)

exarchive(1M)

export(1M)

fsmadm(1M)

fsmdb(1M)

fsmgmtd(1M)

fsmgr(1M)

fsmgr_setup(1M)

fsmupd(1M)

generic(1M)

gnutar(1M)

HAStoragePlus_samfs(1M)

import(1M)

itemize(1M)

load(1M)

load_notify.sh(1M)

log_rotate.sh(1M)

mccfg(1M)

mount_samfs(1M)

move(1M)

nrecycler.sh(1M)

odlabel(1M)

qfsdump(1M)

qfsrestore(1M)

rearch(1M)

recover.sh(1M)

recycler(1M)

recycler.sh(1M)

releaser(1M)

reserve(1M)

restore.sh(1M)

robots(1M)

rpc.sam(1M)

sam-amld(1M)

sam-archiverd(1M)

sam-arcopy(1M)

sam-arfind(1M)

sam-catserverd(1M)

sam-clfsd(1M)

sam-clientd(1M)

sam-dbupd(1M)

sam-fsalogd(1M)

sam-fsd(1M)

sam-ftpd(1M)

sam-genericd(1M)

sam-grau_helper(1M)

sam-ibm3494d(1M)

sam-nrecycler(1M)

sam-recycler(1M)

sam-releaser(1M)

sam-rftd(1M)

sam-robotsd(1M)

sam-rpcd(1M)

sam-scannerd(1M)

sam-serverd(1M)

sam-sharefsd(1M)

sam-shrink(1M)

sam-sony_helper(1M)

sam-sonyd(1M)

sam-stagealld(1M)

sam-stagerd(1M)

sam-stagerd_copy(1M)

sam-stk_helper(1M)

sam-stkd(1M)

samadm(1M)

sambcheck(1M)

samchaid(1M)

samcmd(1M)

samcrondump(1M)

samcronfix(1M)

samd(1M)

samdb(1M)

samexplorer(1M)

samexport(1M)

samfsck(1M)

samfsconfig(1M)

samfsdump(1M)

samfsinfo(1M)

samfsrestore(1M)

samfstyp(1M)

samgetmap(1M)

samgetvol(1M)

samgrowfs(1M)

samimport(1M)

samload(1M)

sammkfs(1M)

samncheck(1M)

samquota(1M)

samquotastat(1M)

samset(1M)

samsharefs(1M)

samsnoop(1M)

samstorade(1M)

samtrace(1M)

samu(1M)

samunhold(1M)

save_core.sh(1M)

scanner(1M)

scsi_trace_decode(1M)

sefreport(1M)

sendtrap(1M)

set_admin(1M)

set_state(1M)

showqueue(1M)

stageall(1M)

stageback.sh(1M)

star(1M)

tapealert(1M)

tarback.sh(1M)

tplabel(1M)

tpverify(1M)

trace_rotate(1M)

umount_samfs(1M)

unarchive(1M)

undamage(1M)

unload(1M)

unrearch(1M)

unreserve(1M)

3.  Library Functions (Man Pages Section 3)

4.  Library Functions (Man Pages Section 3X)

5.  File Formats (Man Pages Section 4)

6.  Standards, Environment, and Macros (Man Pages Section 5)

7.  Device and Network Interfaces (Man Pages Section 7)

samfsconfig(1M)

NAME
     samfsconfig - Recovers configuration information

SYNOPSIS
     /opt/SUNWsamfs/sbin/samfsconfig [-b] [-d] [-h] [-s] [-v]
     device [device] ...

AVAILABILITY
     SUNWqfs
     SUNWsamfs

DESCRIPTION
     The samfsconfig utility opens the device(s) listed on the
     command line, attempts to read the Sun QFS file system
     superblock on each, and generates output in a format similar
     to an editable mcf(4) file.  A Sun QFS file system
     superblock is a record that the sammkfs(1M) utility writes
     to the beginning of every device in a Sun QFS file system.
     This record identifies the devices to the file system.

     By default, the output is written to stdout, but the output
     can be redirected to a file and edited to regenerate the
     file system portions of the mcf file in the event of a
     system reconfiguration or disaster.

     samd buildmcf executes samfsconfig to build the mcf file.
     samd config must be executed to reconfigure the changes
     after the samd buildmcf has built the mcf file.

OPTIONS
     This command accepts the following options:

     -b        Lists the size of the associated partition,
               according to its superblock, in the last output
               column.  This may be useful when multiple disk
               partitions of different sizes start at the same
               offset.

     -d        Generates detailed information about all the Sun
               QFS superblocks found, including the content of
               each superblock.

     -h        Generates a usage message and exits.

     -s        Print the host file contents of QFS shared
               filesystems.

     -v        Generates messages regarding the disposition of
               each device.

     device    One or more device identifiers from which
               configuration information is to be recovered.  Use
               a space character to separate multiple device
               identifiers on the command line.

               It can be desireable to save a list of device
               identifiers to a file and use this file for
               command line input to the program.

     The samfsconfig utility generates information about all the
     Sun QFS file systems and file system components it finds.
     The file system name, creation time, generation, devices
     count, and metadata devices count are listed.  The
     samfsconfig utility flags irregularities as follows:

     o For any incomplete devices that have superblocks, but are
       in an file system where all the devices are not present,
       it prefixes a pound sign (#) to indicate problems.

     o For any duplicate devices that have the same superblock
       information with the same file system generation number,
       it prefixes a greater-than sign (>).  This is common if,
       for instance, multiple paths exist or whole disk
       partitions are specified on the command line.

     o For devices, one /dev/did/dsk and the other device
       /dev/dsk, which have the the same superblock information
       with the same file system generation number, it prefixes a
       greater-than sign (>) for the /dev/dsk devices.  This
       occurs for did file systems.  This line is only generated
       when the -v option is specified.

     o For any duplicate devices that have the same superblock
       information but have different file system generation
       numbers, it prefixes a less-than sign (<).  This can occur
       if a device has been removed from the file system and a
       new device has been added to the same file system in the
       same ordinal position. Note, the file system generation
       number is incremented when a device is added to the file
       system.  This line is only generated when the -v option is
       specified.

EXAMPLES
     Example 1.

     ceres# samfsconfig /dev/dsk/*
     #
     # Family Set 'samfs5' Created Fri Aug 29 12:05:15 2008
     # Generation 0 Eq count 7 Eq meta count 3
     #
     # zoned-off or missing metadata device
     #
     # Missing slices
     # nodev        11    mm   samfs5  -
     # Ordinal 1
     # /dev/dsk/c6t600A0B80002AC18A000006A048A1A0BEd0s1    12    mr   samfs5  -

     #
     # Family Set 'samfs5' Created Wed Sep 17 01:56:27 2008
     # Generation 0 Eq count 7 Eq meta count 3
     #
     # zoned-off or missing metadata device
     #
     # Missing slices
     # nodev        12    mm   samfs5  -
     # nodev        13    mm   samfs5  -
     # Ordinal 0
     # /dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s2    11    mm   samfs5  -

     #
     # Family Set 'samfs5' Created Fri Dec 19 20:17:48 2008
     # Generation 0 Eq count 2 Eq meta count 1
     #
     # zoned-off or missing metadata device
     #
     # Missing slices
     # nodev        501    mm   samfs5  -
     # Ordinal 9

     #
     # Family Set 'samfs5' Created Tue Dec 23 16:41:07 2008
     # Generation 1 Eq count 5 Eq meta count 1
     #
     # Missing slices
     # Ordinal 0
     # /dev/dsk/c6t600A0B80002AC18A000006A048A1A0BEd0s6    501    mm   samfs5  -
     # Ordinal 1
     # /dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s6    502    mr   samfs5  -
     # Ordinal 2
     # /dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s6    503    mr   samfs5  -
     # Ordinal 3
     # /dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s6    504    mr   samfs5  -

     #
     # Family Set 'samfs1' Created Sat Dec 27 19:56:26 2008
     # Generation 0 Eq count 4 Eq meta count 1
     #
     # Foreign byte order (super-blocks byte-reversed).
     #
     # Missing slices
     # Ordinal 0
     # /dev/dsk/c6t600A0B80002AC18A000006A048A1A0BEd0s0    101    mm   samfs1  -

     #
     # Family Set 'samfs5' Created Sun Jan  4 11:15:00 2009
     # Generation 2 Eq count 7 Eq meta count 2
     #
     # zoned-off or missing metadata device
     #
     # Missing slices
     # nodev        501    mm   samfs5  -
     # Ordinal 5
     # /dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s4    506    mr   samfs5  -
     # Ordinal 7
     # /dev/dsk/c6t600A0B80002AC18A000006A048A1A0BEd0s2    508    mr   samfs5  -

     #
     # Family Set 'stand' Created Thu Jan  8 20:23:11 2009
     # Generation 0 Eq count 1 Eq meta count 0
     #
     stand 100 ms stand -
     /dev/dsk/c6t600A0B80002AC18A000006A048A1A0BEd0s3    101    md   stand  -

     #
     # Family Set 'samfs6' Created Fri Jan  9 21:27:48 2009
     # Generation 0 Eq count 1 Eq meta count 0
     #
     samfs6 600 ms samfs6 -
     > /dev/dsk/c0t1d0s2    601    md   samfs6  -
     > /dev/dsk/c0t1d0s5    601    md   samfs6  -

     #
     # Family Set 'samfs5' Created Fri Jan  9 21:32:28 2009
     # Generation 2 Eq count 7 Eq meta count 2
     #
     samfs5 500 ma samfs5 - shared
     /dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s5    501    mm   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s5    502    mr   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s5    503    mm   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s3    504    mr   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s3    505    mr   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s4    506    mr   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s4    507    mr   samfs5  -

     Example 2.  Another example, this from a saved list of
     devices:

     ceres# samfsconfig -v `cat /tmp/dev_files`
     Device '/dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s5' has a QFS superblock.
     Device '/dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s5' has a QFS superblock.
     Device '/dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s5' has a QFS superblock.
     Device '/dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s3' has a QFS superblock.
     Device '/dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s3' has a QFS superblock.
     Device '/dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s3' has a QFS superblock.
     Device '/dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s4' has a QFS superblock.
     Device '/dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s4' has a QFS superblock.
     Device '/dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s2' has a QFS superblock.

     Device '/dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s4' has a QFS superblock.
     10 QFS devices found.
     #
     # Family Set 'samfs5' Created Fri Dec 19 20:17:48 2008
     # Generation 2 Eq count 7 Eq meta count 2
     #
     # zoned-off or missing metadata device
     #
     # Missing slices
     # nodev        501    mm   samfs5  -
     # Ordinal 9
     < /dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s2    512    g7   samfs5  -

     #
     # Family Set 'samfs5' Created Sun Jan  4 11:15:00 2009
     # Generation 2 Eq count 7 Eq meta count 2
     #
     # zoned-off or missing metadata device
     #
     # Missing slices
     # nodev        501    mm   samfs5  -
     # Ordinal 5
     # /dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s4    506    mr   samfs5  -

     #
     # Family Set 'samfs5' Created Fri Jan  9 21:32:28 2009
     # Generation 2 Eq count 7 Eq meta count 2
     #
     samfs5 500 ma samfs5 - shared
     /dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s5    501    mm   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s5    502    mr   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s5    503    mm   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s3    504    mr   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A000006A648A1A0F6d0s3    505    mr   samfs5  -
     < /dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s3    506    mr   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A000006A348A1A0DAd0s4    506    mr   samfs5  -
     /dev/dsk/c6t600A0B80002AC18A0000069D48A1A0A2d0s4    507    mr   samfs5  -

SEE ALSO
     sammkfs(1M) samd(1M)

     mcf(4)