Command Usage: samadmin v8_1_5
samadmin autodest synch mapfile

Just having some fun...
This command is deprecated (no longer actively maintained).
Use at your own risk.

Command Description:

Synchronize reality with your new mapfile.
 
You have made changes to the mapfile. You have verified the new mapfile, and
are satisfied that any differences between the mapfile and "reality" should
be corrected, using the mapfile as the "master" information source. You are
now ready to alter pnfs space (and, if necessary, the sam
data_storage_locations) to match the new mapfile.
 
The synch mapfile command will
a. read through the mapfile and
b. create any new pnfs directories that are listed but do not yet exist;
c. modify pnfs directory tags and permissions so that they match what is in
   the map file;
d. ensure that all destinationPath entries are valid locations in the SAM
   database.
 
By default, only new entries to the autodest map will be
synchronized; entries which already exist in the master map will not be
re-synched.  Use the "--synch=all" option to override this.
 
Items to Note::
1. You should run this command from the sam account.
2. You must run this command from a node which has mounted /pnfs space.
3. This command will fail if it is not able to perform any of the required
   steps.


Usage:
       samadmin autodest synch mapfile <--requiredOptions> [--options] [-flags]

Where:

  --requiredOptions:
	             --mapfile=<value> # file containing the new autodest map to be synched

  --options:
	             --connect=<value> # oracle username/password for connecting to this database
	    --corbaCallTimeout=<value> # time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
	       --retryInterval=<value> # retry interval base in seconds; will multiply this base times retryCount (default: 5)
	         --retryJitter=<value> # retry jitter, random jitter added to base retry interval times retryCount (default: 5)
	       --retryMaxCount=<value> # number of times to retry CORBA calls for retriable exceptions (default: 25; zero implies no retries)

   -flags:
	                            -c # automatically close all servants after each method call
	                            -d # debug mode
	                            -s # retrySilently mode (do not issue messages to stderr on proxy retries)
	                            -t # time-it mode (print additional info on timings)
	                            -v # verbose mode

Synonymous Options:
	               --synch=<value> # synonym for --synch=<value>
	              --verify=<value> # synonym for --synch=<value>

Required Data Types:
	                       connect : string 
	              corbaCallTimeout : int 
	                       mapfile : string 
	                 retryInterval : int 
	                   retryJitter : int 
	                 retryMaxCount : int 

You may omit "-c" if the $SAM_PYAPI_AUTO_CLOSE_SERVANTS environmental variable is set.
You may omit "--connect=<value>" if the $SAM_ORACLE_CONNECT environmental variable is set.
You may omit "--corbaCallTimeout=<value>" if the $SAM_PYAPI_CORBA_CALL_TIMEOUT environmental variable is set.
You may omit "--retryInterval=<value>" if the $SAM_PYAPI_RETRY_INTERVAL environmental variable is set.
You may omit "--retryJitter=<value>" if the $SAM_PYAPI_RETRY_JITTER environmental variable is set.
You may omit "--retryMaxCount=<value>" if the $SAM_PYAPI_RETRY_MAX_COUNT environmental variable is set.
You may omit "-s" if the $SAM_PYAPI_RETRY_SILENTLY environmental variable is set.

UNIX ExitStatus:
	             Success :   0
	Unhandled exceptions : 127


See Also: