libstlemass man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

EMASS_silo_files(8)					   EMASS_silo_files(8)

NAME
       dasadmin - ADIC/EMASS/Grau silo administrative utility
       libstlemass - shared library for communication to
		ADIC/EMASS/Grau silo

SYNOPSIS
       dasadmin command [options] [parameters]
	 dasadmin.exe  command [options] [parameters]	 (NT only)
	 libstlemass.so	  (Solaris)
	 libstlemass.so.a (AIX)
	 libstlemass.sl	  (HPUX)
	 libstlemass.so.1 (SGI)
	 libstlemass.so	  (DECAXP)
	 libstlemass.dll  (NT i386)

DESCRIPTION
   dasadmin
       This  is	 not a complete listing of all possible dasadmin commands, but
       does include those commands that are of	use  with  NetWorker.	For  a
       complete	 discussion, see the DAS Installation and Administration guide
       provided by ADIC, EMASS or Grau.
	    mo[unt] [ -t type ] volser [ drive-name ]
	       Mounts the tape with the barcode label of  volser  into	either
	       the  first  available drive (if drive-name is not specified) or
	       into the drive specified by drive-name.	If the tape is not the
	       type  defined  by DAS_MEDIUM or ACI_MEDIA_TYPE, you can use the
	       -t type option to get the tape mounted.	If  the	 type  of  the
	       tape  and the defined type for the drive do not match, the silo
	       will not load the tape. Note that the drive you are  attempting
	       to  use	must be allocated for your use before you can mount or
	       dismount tapes.	See listd and allocd below.
	    dism[ount] [ -t type ] volser | -d drive-name
	       Dismounts the tape  that	 is  either  specified	by  volser  or
	       whatever	 is in the drive specified by drive-name.  If the tape
	       or drive are of a different type than your default, use the  -t
	       type  parameter.	  As  with  mount,  you	 must  have  the drive
	       allocated to you to use this command.
	    ej[ect] [ -c ] [ -t type ] volser-range area-name
	       Ejects one or more tapes to the specified eject area.  As  with
	       other  commands,	 if  the  type of the tape you are ejecting is
	       different from that defined by  DAS_MEDIUM  or  ACI_MEDIA_TYPE,
	       you  will  need	the  -t	 type  option.	 The  -c  specifies  a
	       'complete' ejection for	the  specified	volsers.   A  complete
	       ejection	 removes  the  entry  for  that	 volser	 from the silo
	       controller's internal database.	A NON-complete	ejection  will
	       eject  the  tape,  but  the volser's entry in the database will
	       remain, and the volser's state will be set to 'ejected'.	  This
	       is  useful  if  you  anticipate	replacing the tape in the silo
	       soon.
	    in[sert] area-name
	       Moves all tapes that are	 currently  in	the  specified	insert
	       area-name  from the insert area to the normal storage locations
	       for tapes.
	    inventory
	       Starts a full inventory of the silo.   USE  WITH	 CAUTION!   An
	       inventory of this sort can take a very long time!  An inventory
	       of a silo with 180 slots takes over 20 minutes.
	    view [ -t type ] volser
	       Displays the current status of volser,  including  the  volser,
	       type, attribute, and coordinate.
	    all[ocd] drive-name UP|DOWN clientname
	       The  allocd  command  is used to allocate and deallocate drives
	       for different clients.  Before you can use a  tape  drive,  the
	       drive must be allocd'ed UP for your system.  If it is currently
	       allocd'ed UP for a different client, it must first be allocd'ed
	       DOWN for that client before being allocd'ed UP for your system.
	       You cannot allocd DOWN a drive that has a tape in it.  The tape
	       must be dismounted first.
	    l[ist]d
	       listd  or  ld  shows  the  current state of all the tape drives
	       defined in the silo.  The information  presented	 will  include
	       the  drive-name,	 the  amu  drive  (the	location in the silo),
	       status (UP or DOWN), type, client the drive  is	allocated  to,
	       and the volser of any loaded tape.
	    show -op | -ac client-name
	       Shows  the  operational	or access parameters for the specified
	       client-name.  You must include either -ac if you	 wish  to  see
	       access  parameters,  or	-op  if	 you  wish  to see operational
	       parameters for  the  client-name.   Access  parameters  include
	       volser  ranges and drive ranges that the client-name is allowed
	       to use.	Operational parameters include whether the client-name
	       has  complete  access,  dismount	 privileges  along with the IP
	       address entered for client-name.
	    list client-name
	       Lists any outstanding requests that have been made  by  client-
	       name.  If there are any, they are shown, along with the request
	       number and type.
	    can[cel] request-id
	       Allows you to cancel an outstanding request, assuming that  you
	       have  the  necessary  privileges.   Use the request-id that was
	       shown by the list command.
	    qversion
	       Shows the version of the DAS server that you are	 connected  to
	       and  the	 version  of the ACI protocol you are using to talk to
	       DAS.
	    qvolsrange beginvolser endvolser count [ clientname ]
	       qvolsrange is the way to obtain a list of the volsers that  are
	       available  in  the silo.	 beginvolser and endvolser are volsers
	       of the form "123456".  To use the first available or  the  last
	       available,  you can use "".  count specifies the maximum number
	       of volsers you wish to see.

ENVIRONMENT VARIABLES
	  These environment variables affect the operation of  the  silo,  and
	  since	 the  processes	 that are using them include both the commands
	  the user will enter and the processes that are  spawned  from	 nsrd,
	  they	need  to be set in a location where they will be in place when
	  nsrd is started.  The three DAS_ variables are used by  libstlemass,
	  while dasadmin uses ACI_MEDIA_TYPE instead of DAS_MEDIUM.

	  For	 Solaris,    the    definitions	   should    be	   placed   in
	  /etc/rc.2/S95networker.

	  For AIX, the definitions should be placed in /etc/rc.nsr.

	  For	 HPUX,	  the	 definitions	should	  be	 placed	    in
	  /sbin/rc2.d/S900networker.

       DAS_SERVER
	  This is either the network name or the IP address of the system that
	  is running DAS. For a single silo, this will	usually	 be  the  silo
	  controller  system.  In larger installations, there will probably be
	  only one DAS server for the whole network.  It is case-sensitive.

       DAS_CLIENT
	  This is the network name of the system that NetWorker is running on.
	  It is case-sensitive.

       DAS_MEDIUM
	  This	variable  is  used  by	libstlemass.  It should be the same as
	  ACI_MEDIA_TYPE.
	  This is the type of tape drive you are connected to.	If this is not
	  specified, the default value of DLT will be used.

       ACI_MEDIA_TYPE
	  This	variable  is  used  by	dasadmin.   It	should	be the same as
	  DAS_MEDIUM.
	  This is the type of tape drive you are connected to.	If this is not
	  specified, the default value of DLT will be used.  Acceptable values
	  are the same as those listed under DAS_MEDIUM.

EXAMPLES
       NOTE on ranges:
	 The dasadmin utility will accept volser  ranges  for  some  commands.
	 There are three acceptable variations for these ranges:
	 single volser: "000635"
	 multiple volsers: "000635, 000789, 098732"
	 true range: "000610 - 000745"

       NOTE on area-name and drive-name:
	 area-names  usually  consist  of  a  letter and 2 digits.  The letter
	 corresponds to whether you are referring to an insert area  ("I")  or
	 an  eject  area  ("E").  You will need to get the correct values from
	 your silo administrator before using them.
	 drive-names are essentially  free-form	 labels	 created  by  whomever
	 installed  the	 silo.	 They  may  or	may  not have any relevance to
	 physical reality, so you will need to see the silo admin to  get  the
	 correct  names.   If the silo admin is not available, you can get the
	 same information using dasadmin listd along with  dasadmin  show  -op
	 client-name followed by dasadmin show -ac client-name commands.

	 To setup the environment variables necessary for silo operations:
	      setenv DAS_SERVER emask
	      setenv DAS_CLIENT aurora
	      setenv DAS_MEDIUM DLT
	      setenv ACI_MEDIA_TYPE DECDLT

	 To see a listing of all volsers available in the silo:
	      dasadmin qvolsrange "" "" 10000

	 To see the current status of the drives in the silo:
	      dasadmin listd

	 To change the allocation of a drive from client a4 to client aurora:
	      dasadmin allocd DLT1 DOWN a4
	      dasadmin allocd DLT1 UP aurora

SEE ALSO
       nsrjb(8), jbconfig(8), libstlstk(8), mini_el(8), ssi(8), libstlibm(8)

DIAGNOSTICS
	    The	 only  available diagnostic information is error messages that
	    may be printed out by dasadmin and libstlemass in  the  course  of
	    normal operations.

NetWorker 7.3.2			  Aug 23, 06		   EMASS_silo_files(8)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

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