advscan man page on OSF1

Printed from http://www.polarhome.com/service/man/?qf=advscan&af=0&tf=2&of=OSF1

advscan(8)							    advscan(8)

NAME
       advscan - Locates AdvFS volumes on disk devices

SYNOPSIS
       /sbin/advfs/advscan   [-g]   [-a]   [-r]	 [-f  domain_name]  devices...
       disk_group...

OPTIONS
       Scans all devices found in any /etc/fdmns domain as well	 as  those  in
       the  command  line.   Fixes  the	 domain	 count	and  the  links in the
       /etc/fdmns directory for the named domain.  Lists the AdvFS volumes  in
       the order they are found on each disk device or Logical Storage Manager
       (LSM) disk group.  Re-creates missing domains.  The domain name is cre‐
       ated from the device names or LSM disk group names.

OPERANDS
       Specifies  the device names of disks to scan for AdvFS volumes.	Speci‐
       fies the LSM disk groups to scan for AdvFS volumes.

DESCRIPTION
       The advscan command locates AdvFS volumes (disk partitions or LSM  vol‐
       umes) that are in AdvFS domains.

       Given the AdvFS volumes, you can re-create or fix the /etc/fdmns direc‐
       tory of a named domain or LSM disk group.  For  example,	 if  you  have
       moved  disks  to	 a  new	 system,  moved disks around in a way that has
       changed device numbers, or lost track of where the AdvFS	 domains  are,
       you can use this command to locate them.

       Another	use of the advscan command is to repair AdvFS domains when you
       have broken them.  For example, if you mistakenly delete the /etc/fdmns
       directory,  delete  a  domain directory in the /etc/fdmns directory, or
       delete links from a domain directory under  the	/etc/fdmns  directory,
       you can use the advscan command to fix the problem.

       The advscan command accepts a list of disk device names and/or LSM disk
       group names and searches all the disk  partitions  to  determine	 which
       partitions are part of an AdvFS domain.

       You can run the advscan command to automatically rebuild all or part of
       your /etc/fdmns directory or you can rebuild it manually	 by  supplying
       all the names of the AdvFS volumes in a domain.

       If  the	-g option is not set, the AdvFS volumes are listed as they are
       grouped in domains. Set this option to list the AdvFS  volumes  in  the
       order they are found on each disk.

       Run  the	 advscan  command  with the -r option set to re-create missing
       domains from the /etc/fdmns directory, missing  links,  or  the	entire
       /etc/fdmns directory.

       Although	 the  advscan  command	will  rebuild the /etc/fdmns directory
       automatically, we recommend that you always keep a hard-copy record  of
       the current /etc/fdmns directory.

       To  determine if a disk partition is part of an AdvFS domain, the advs‐
       can command performs the following functions: Reads the first two pages
       of  a  partition	 to determine if it is an AdvFS volume and to find the
       domain information.  Reads the disk label to sort out overlapping  par‐
       titions.	 The  size of overlapping partitions are examined and compared
       to the domain information to determine  which  partitions  are  in  the
       domain.	These  partitions  are reported in the output.	Reads the boot
       block to determine if the partition is AdvFS root bootable.

       The advscan command displays the date the domain was created,  the  on-
       disk structure version, and the last known or current state of the vol‐
       ume.

       In order to mount an AdvFS fileset, the domain that contains the	 file‐
       set  must be consistent.	 An AdvFS domain is consistent when the number
       of physical partitions or volumes with the correct domain ID are	 equal
       to  both	 the  domain  volume  count  (which  is a number stored in the
       domain) and the number of links to  the	partitions  that  are  in  the
       /etc/fdmns directory.

       Domain  inconsistencies can occur in diverse ways. Use the -f option to
       correct domain inconsistencies.

       If you attempt to mount an inconsistent domain, a  message  similar  to
       the  following  will appear on the console: # Volume count mismatch for
       domain dmnz.  dmnz expects 2 volumes, /etc/fdmns/dmnz has 1 links.

RESTRICTIONS
       You must be the root user to use this command.

EXAMPLES
       The following are examples of the output from the advscan command.  The
       following  example  scans  devices  dsk3 and diskgroup rootdg for AdvFS
       partitions: # advscan dsk3 rootdg

       Scanning devices /dev/rdisk/dskz3 rootdg

       Found domains:

       usr_domain
	       Domain Id       30a91a42.0001e060
	       Created	       Thu Mar 16 14:37:54 2000

	       Domain volumes	       2
	       /etc/fdmns links	       2

	       Actual partitions found:
				       rz3g
				       rootdg.vol03  The   following   example
       scans devices found in /etc/fdmns. It uses the -g option to list parti‐
       tions in the order they are found on the	 disks	rather	than  grouping
       them  into  domains and matching them with the /etc/fdmns directory.  #
       advscan -a -g

       scanning disks  /dev/rdisk/dsk2 /dev/rdisk/dsk3 rootdg

       Partition	      Domain Id

       /dev/dsk2a      30a919ff.000ec470       V3, mounted, bootable
					       1 volume in domain

		       Created		       Mon Jan 11 14:36:47 1999
		       Last mount	       Fri Jun 30 16:00:04 2000

       /dev/dsk2g      30a91a32.0007c250       V4, mounted
					       1 volume in domain

		       Created		       Thu Mar 16 14:37:38 2000
		       Last mount	       Fri Mar 24 17:14:16 2000

       /dev/dsk3a      30abe160.00028eff       V3, never mounted
					       1 volume in domain

		       Created		       Thu Mar 18 17:12:00 1999

       /dev/dsk3g      30a91a42.0001e060       V3, mounted
					       1 volume in domain

		       Created		       Tue Mar 16 14:37:54 1999
		       Last mount	       Thu Mar 23 17:14:17 2000

       rootdg.vol01    30c62c74.00036750       V4, dismounted
					       2 volumes in domain

		       Created		       Fri Apr	7 15:51:16 2000
		       Last mount	       Fri Apr	7 17:16:06 2000

       rootdg.vol02    30c62c74.00036750       V3, dismounted

		       Created		       Wed Apr 7 15:51:16 1999
		       Last mount	       Wed Apr 7 17:16:06 1999 For the
       following  example, two domains using device dsk3 and disk group rootdg
       were removed from the /etc/fdmns directory. The advscan	command	 scans
       device  dsk3  and  disk	group  rootdg  and then re-creates the missing
       domains.	 The asterisk (*) after the partition name indicates that  the
       directory  for  that  partition did not appear in the /etc/fdmns direc‐
       tory.  # advscan -r dsk3 rootdg

       Scanning disks  /dev/disk/dsk3 /dev/rvol/rootdg

       Found domains:

       *unknown*
		    Domain Id	    30a91a42.0001e060
		    Created	    Tue Mar 16 14:37:54 2000

		    Domain volumes	    1
		    /etc/fdmns links	    0

		    Actual partitions found:
					    dsk3g*

       *unknown*
		    Domain Id	    30c62c74.00036750
		    Created	    Wed Apr 7 15:51:16 2000

		    Domain volumes	    2
		    /etc/fdmns links	    0

		    Actual partitions found:
					    rootdg.vol01*
					    rootdg.vol02*

       Creating /etc/fdmns/domain_dsk3g/
	    linking dsk3g

       Creating /etc/fdmns/domain_rootdg.vol01_rootdg.vol02/
	    linking rootdg.vol01
	    linking rootdg.vol02

FILES
SEE ALSO
       Commands: disklabel(8) , showfdmn(8), showfsets(8), showfile(8)

       Files: fstab(4)

								    advscan(8)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OSF1

List of man pages available for OSF1

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net