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 |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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)