fscdsadm man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

fscdsadm(1M)							  fscdsadm(1M)

NAME
       fscdsadm	 -  perform  online  Cross-Platform Data Sharing operations on
       VxFS file systems

AVAILABILITY
       VRTSvxfs

SYNOPSIS
       /opt/VRTS/bin/fscdsadm  -o  {  add  |  remove  }	 -t  target_specifiers
       mount_point

       /opt/VRTS/bin/fscdsadm -o { list | none } mount_point

       /opt/VRTS/bin/fscdsadm -l { enforce | ignore } mount_point

       /opt/VRTS/bin/fscdsadm -s mount_point

       /opt/VRTS/bin/fscdsadm -v [ -t target_specifiers ] mount_point

DESCRIPTION
       The  fscdsadm  command performs online administration functions for the
       Veritas File System Cross-Platform Data Sharing (CDS)  feature.	 Main‐
       taining	the list of targets between which the file system is regularly
       migrated, enforcing or ignoring established CDS limits, validating  the
       file  system  to	 detect violations of these limits, and displaying the
       current CDS state of the file system are some of the tasks that can  be
       performed on VxFS file system through the fscdsadm command.

       mount_point  specifies  the  directory  on  which the file system to be
       migrated is mounted.

       target_specifiers specifies the target to which the file system is pro‐
       posed to be migrated.

NOTES
       In  the 4.0 and 4.1 releases of VxFS, the fscdstask script was provided
       to perform the various VxFS CDS administration tasks.  Starting in  the
       VxFS  5.0  release,  the fscdsadm command should be used to perform all
       online CDS tasks on VxFS file systems.  The fscdstask script is	depre‐
       cated  and  is  provided	 only for backward compatibility with previous
       releases.  The support for the fscdstask script may be discontinued  in
       future VxFS releases.

       The  VxFS  CDS  commands,  fscdsadm  and fscdsconv, use the information
       available in the CDS limits file, /opt/VRTS/bin/cdslimitstab.  The lim‐
       its  file  is  installed	 as part of the VRTSvxfs package.  Do not edit
       /opt/VRTS/bin/cdslimitstab manually.

Cluster File System Issues
       No cluster issues; command operates the same on cluster file systems.

OPTIONS
       -l	 Specifies the limit  enforcement  CDS	commands.   The	 valid
		 options are:

		 enforce   Causes the established CDs limits to be enforced on
			   mount_point.	 When the CDS limits are enforced, the
			   file	 system	 prevents the creation of any new file
			   system metadata that exceeds the  established  lim‐
			   its.	  The CDS limits that can be enforced are file
			   size, UID, and GID.	After enforcing the  CDS  lim‐
			   its,	 a  file  created that exceeds the established
			   CDS limits will have permissions 0000 in the desti‐
			   nation  directory.  You can either delete this par‐
			   tial file, or set the  appropriate  permissions  on
			   the	file.	Enforcing the CDS limits has no effect
			   on files violating the limits that already exist in
			   the	file  system  at  the time when the limits are
			   being enforced.  Use the validation	capability  of
			   fscdsadm to detect and rectify these violations.

		 ignore	   Causes  the	enforced  CDS  limits to be ignored on
			   mount_point.	  Once	the  CDS  limits   have	  been
			   ignored,  the  file	system	will no longer control
			   activities that might cause the CDS	limits	to  be
			   violated.

       -o	 Specifies the CDS commands for target list manipulation.  The
		 valid options are:

		 add	   Adds the specified target to the  list  of  targets
			   between   which   the   file	  system   mounted  at
			   mount_point will be migrated on an  ongoing	basis.
			   The	target	list is maintained by the file system.
			   The CDS limits, when enforced,  are	determined  by
			   the constituents of the target list of mount_point.
			   If the CDS limits are already enforced when	a  new
			   target  is  added,  the limits corresponding to the
			   newly  added	 target	 will  be  reflected  in   the
			   enforced limits.

		 remove	   Removes  the	 specified target from the target list
			   of mount_point.  If	the  CDS  limits  are  already
			   enforced  when a target is removed, the limits cor‐
			   responding to the  newly  removed  target  will  be
			   reflected  in  the  enforced limits.	 If the target
			   list becomes empty by removing the specified target
			   and if the CDS limits are already enforced, the CDS
			   limits will be ignored  since  the  target  is  now
			   empty.

		 none	   Removes   all  targets  from	 the  target  list  of
			   mount_point.	  If  the  CDS	limits	 are   already
			   enforced,  the CDS limits will be ignored since the
			   target list is now empty.

		 list	   Lists information regarding the targets that are in
			   the	target	list  of  mount_point.	 The following
			   information is displayed for	 each  target  in  the
			   target list:

				·  Operating system name

				·  Operating system release

				·  Architecture

				·  VxFS version

				·  Kernel bits

			   A  value of any displayed for any of the above tar‐
			   get specifiers, except operating system name, indi‐
			   cates  that	the CDS limits are the same regardless
			   of the value for this particular target specifier.

       -s	 Displays the following information regarding the CDS state of
		 mount_point:

		      ·	 Whether CDS limits been enforced on mount_point.

		      ·	 Details regarding the targets in the migration target
			 list for mount_point.

		      ·	 The limit values for file size, UID, and  GID	calcu‐
			 lated on the basis of the targets in the target list.

		      ·	 Whether  all  files are within the CDS limits for the
			 targets in the target list of mount_point.

		 If the status indicates that there might be  files  exceeding
		 the  CDS  limits established for mount_point, use the valida‐
		 tion capability of fscdsadm to detect the files violating the
		 limits.   After rectifying the violations, enforce the limits
		 to update the CDS status of the file system.

       -t target_specifiers
		 Specifies the migration target for export and validation, and
		 the  migration source for import.  Specify the migration tar‐
		 get for a file system using the  target_specifiers  argument,
		 which has the following format:

		 os_name=os_name[,os_rel=os_release][,arch=arch]
		 [,vxfs_vers=vxfs_version][,bits=bits]

		 os_name=os_name
			   Specifies the name of the target  operating	system
			   to which the file system is planned to be migrated.
			   os_name can have a value of AIX-UX,	HP-UX,	Linux,
			   or  SunOS.  os_name must be specified if the target
			   is specified.

		 os_rel=os_release
			   Specifies the operating system release  version  of
			   the target, such as 5.8, 5.9, or 5.10 for SunOS.

		 arch=arch Specifies  the  architecture of the target, such as
			   x86 or sparc for SunOS.

		 vxfs_vers=vxfs_version
			   Specifies the VxFS release version that is  in  use
			   on the target, such as 4.1 or 5.0.

		 bits=bits Specifies  the kernel bits of the target.  bits can
			   have a value of 32 or 64 to	indicate  whether  the
			   target is running a 32-bit kernel or 64-bit kernel.

		 While	os_name must be specified for all fscdsadm invocations
		 that permit the target to  be	specified,  all	 other	target
		 specifiers  are  optional  and	 are available for the user to
		 fine tune the migration target specification.	If the	values
		 for  the  optional target specifiers are not specified, fscd‐
		 sadm will choose the defaults for the specified target	 based
		 on  the  information  available  in the limits file that best
		 fits the specified target, and proceed with  the  CDS	opera‐
		 tion.	 The  chosen defaults are displayed to the user before
		 proceeding with the migration.

       -v	 Validates the file system and reports any file	 system	 enti‐
		 ties with metadata that exceed the established CDS limits for
		 the specified target.	Also reports if the file  system  must
		 be byteswapped to be migrated to the specified target.	 If no
		 target is specified, fscdsadm provides the validation	report
		 for  each  of the targets in the target list of the specified
		 mount point, provided that the target list is not empty.  For
		 each  file with metadata that exceeds CDS limits, the follow‐
		 ing information is reported:

		      ·	 Inode number.	The vxlsino command  can  be  used  to
			 find the corresponding file.

		      ·	 File size

		      ·	 UID

		      ·	 GID

		      ·	 Reason	 for  violation.   Indicates  which of the CDS
			 limits are being violated.

		      ·	 Fileset name.	The specified mount_point or the  name
			 of  the Storage Checkpoint file system where the file
			 in violation resides.

EXAMPLES
       The following command adds an HP-UX/11.23 system running	 VxFS  4.1  to
       the target list of a file system that is currently on Linux:

	      # fscdsadm -o add -t os_name=HP-UX,os_rel=11.23,vxfs_vers=4.1 /mnt1

       The  arch and bits are not specified as part of the target in the above
       example.	 This causes the command to assume the defaults in  accordance
       with the definition provided for the target in the limits file.

       The following command enforces the CDS limits:

	      # fscdsadm -l enforce /mnt1

       The following command validates the file ssytem to detect if any limits
       are violated for an HP-UX/IA target:

	      # fscdsadm -v -t os_name=HP-UX,arch=ia /mnt1

SEE ALSO
       fscdsconv(1M)

       Veritas Storage Foundation Cross-Platform Data Sharing  Administrator's
       Guide

VxFS 5.0			  7 Jan 2008			  fscdsadm(1M)
[top]

List of man pages available for HP-UX

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