ADIC Time Clock 6-00028-01 Rev A Manuel d'utilisateur

Managing theAMASS® File SystemAMASS Version 5.3August 20026-00028-01 Rev A

Managing the AMASS File SystemP-6 Preface 6-00028-01 Rev ABooks The CD contains the AMASS books formatted as PDF documents. The books described below

Managing the AMASS File System3-12 Command Reference 6-00028-01 Rev AamassreportReport file system information. The following types of reports can be

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-13OptionsLast Modified Date and time showing date the file was last modifiedVol F

Managing the AMASS File System3-14 Command Reference 6-00028-01 Rev AOption Descriptionno options Generate formatted report-d Only list directories-f

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-15-e errnumber-e “<errnumber”-e “>errnumber”Only list files that have a:• Spe

Managing the AMASS File System3-16 Command Reference 6-00028-01 Rev A-m mode List only those files having one of the following permission IDs: • rwxrw

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-17ExampleStep 1. Log in as either amass or root. Step 2. Enter the following option

Managing the AMASS File System3-18 Command Reference 6-00028-01 Rev AStep 5. See an example of the dates output in the following illustration: NAME FI

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-19amassrestoreRestore from a Backup Volume located in either a library or a standal

Managing the AMASS File System3-20 Command Reference 6-00028-01 Rev AOption Definition-t View files on the Backup VolumeDoes not restore any files-u U

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-21ExampleStep 1. Log in as either amass or root. Step 2. Inactivate the AMASS file

Managing the AMASS File System6-00028-01 Rev A Preface P-7Related PublicationsThe publications described in the following table are created and distri

Managing the AMASS File System3-22 Command Reference 6-00028-01 Rev AStep 4. Make sure the Backup Volume is in the correct drive in the library. If th

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-23where: Value Description-v Verbose messages-d /dev/rst12 Backup Volume is on thi

Managing the AMASS File System3-24 Command Reference 6-00028-01 Rev AamassstatView and change the current status—Active or Inactive—of AMASS. Shutdown

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-25Options/usr/amass/bin./amassstat[-uy][-acfisvw][-f -t seconds]Option Definitionno

Managing the AMASS File System3-26 Command Reference 6-00028-01 Rev A-w Inactivate AMASSNOTE: Clients read from open files, only.-y Suppress interacti

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-27astatsView the status and attributes of the library, drives, and media. /usr/amas

Managing the AMASS File System3-28 Command Reference 6-00028-01 Rev AExamplesThe following examples show the output generated by the command with vari

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-29The following output is generated when the astats command is run with the -c opti

Managing the AMASS File System3-30 Command Reference 6-00028-01 Rev Aastats -c Output Fields DefinedThe following output is generated when the astats

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-31astats -j Output Fields DefinedThe following output is generated when the astats

Managing the AMASS File SystemP-8 Preface 6-00028-01 Rev ANOTES

Managing the AMASS File System3-32 Command Reference 6-00028-01 Rev Aastats -v Output Fields DefinedThe following output is generated when the astats

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-33astats -w Output Fields DefinedFields DescriptionState Device I/O mode flags:• Bl

Managing the AMASS File System3-34 Command Reference 6-00028-01 Rev AbulkinletLoad multiple volumes through the mailbox and mark online. This command

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-35OptionsNoteFor tracking purposes, AMASS assigns each new volume a unique volume n

Managing the AMASS File System3-36 Command Reference 6-00028-01 Rev ALoad New Volumes Step 1. Log in as either amass or root. Step 2. Place volumes in

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-37Step 4. All new volumes in the File System Database have an initial status of unf

Managing the AMASS File System3-38 Command Reference 6-00028-01 Rev AUnsuccessful LoadsIf you attempt to load several volumes at one time and one volu

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-39Reload Existing Volumes Step 1. Log in as either amass or root. Step 2. Place sev

Managing the AMASS File System3-40 Command Reference 6-00028-01 Rev AStep 3. Enter the command as shown in the following illustration. In our example,

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-41bulkloadSupported Network LibrariesThis command is valid for the following networ

6-00025-01 Rev A Contents ixContentsPrefacePurpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-42 Command Reference 6-00028-01 Rev AFor tracking purposes, AMASS assigns each volume a unique volume number.Library I

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-43Option Descriptionno options Create entries and mark multiple volumes Online in t

Managing the AMASS File System3-44 Command Reference 6-00028-01 Rev ACreate Entries for Existing VolumesYou have just installed AMASS but your library

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-45Manually Load New Volumes Introduce new volumes to both the File System Database

Managing the AMASS File System3-46 Command Reference 6-00028-01 Rev AStep 6. New volumes in the Database have an initial status of unformatted (U) and

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-47bulkoutletEject multiple volumes to the mailbox and mark off-line. This command i

Managing the AMASS File System3-48 Command Reference 6-00028-01 Rev AOutlet VolumesStep 1. Log in as either amass or root. .Step 2. See the following

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-49Unsuccessful EjectsIf you attempt to eject several volumes at one time and one vo

Managing the AMASS File System3-50 Command Reference 6-00028-01 Rev AcdimportImport data from CDs formatted by the standards prescribed by:• High Sier

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-51SolarisStep 1. Use the UNIX vi editor or a similar product to edit the /etc/vold.

Accessing Storage DevicesxContents 6-00025-01 Rev AOperational Tasks 2Database and Journal Backups . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-52 Command Reference 6-00028-01 Rev AStep 3. Reboot the SGI machine for the changes to take effect.Options# /dev/scsi/

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-53ExampleStep 1. Log in as either amass or root. Step 2. Create a directory (for ex

Managing the AMASS File System3-54 Command Reference 6-00028-01 Rev AStep 3. Use the AMASS volnew command to create an entry in the File System Databa

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-55If this operation is unsuccessful, the CD may be left in the drive. If this happe

Managing the AMASS File System3-56 Command Reference 6-00028-01 Rev AdirfilelistView, recursively, files under a directory, one entry per line.Options

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-57Verbose ExampleThe following example assumes we:• Use Storage Technology drives (

Managing the AMASS File System3-58 Command Reference 6-00028-01 Rev A• Want to view all the files under the /prodcode directoryOutput Fields DefinedTh

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-59TIME FormatThe Access_time and Modified_time values have the following format: yy

Managing the AMASS File System3-60 Command Reference 6-00028-01 Rev A# cd /archive/accting# dirfilelist . | sort -n +1 +2 | awk ’ {print $1} ’ |\ c

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-61drivecleanMount a cleaning volume in a tape drive, clean the drive, and eject the

Accessing Storage Devices6-00025-01 Rev A Contents xiAdd Space to Volume Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-62 Command Reference 6-00028-01 Rev AOptionsExampleStep 1. Log in as either amass or root. /usr/amass/bin./driveclean[

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-63Step 2. Assign a cleaning volume to the cleaning group.For SCSI-attached storage

Managing the AMASS File System3-64 Command Reference 6-00028-01 Rev Awhere:Step 4. To view the current attributes of our cleaning volume and verify th

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-65Step 5. Standalone drive only: Because we are using a standalone drive, we need t

Managing the AMASS File System3-66 Command Reference 6-00028-01 Rev AThe drive ejects the cleaning volume after the specified amount of time (120 seco

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-67ADIC Scalar 1000AMASS does not support automatic drive cleaning on the ADIC Scala

Managing the AMASS File System3-68 Command Reference 6-00028-01 Rev AdrivededicateDedicate a drive’s use to one of the following:• Write-Only• Read an

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-69-d Dedicate the drive for Write-Only requestsNOTE: If all drives in the library a

Managing the AMASS File System3-70 Command Reference 6-00028-01 Rev AdrivelistView condition and errors for drives.Options/usr/amass/bin./drivelist[-u

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-71Reset to ZeroUse the setdrverr command to reset the error counts reported by the

Accessing Storage Devicesxii Contents 6-00025-01 Rev Aamassstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-72 Command Reference 6-00028-01 Rev AStatus Drive status:• A = Active drive used by AMASS• I = Inactive drive not curr

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-73drivestatView and change the status of drives.OptionsNoteIf media is in a drive w

Managing the AMASS File System3-74 Command Reference 6-00028-01 Rev AOutput ExamplesFollowing is an example of output generated by using no options:ID

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-75The idle eject drivestat -e secs drivenumber command will override the global IDL

Managing the AMASS File System3-76 Command Reference 6-00028-01 Rev AOutput ExamplesFollowing are examples of output generated by the idle eject optio

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-77Disable Feature for A Drive-SucceedsIn the following example, we set the drive to

Managing the AMASS File System3-78 Command Reference 6-00028-01 Rev AView Current ValuesTo view a list of current values, enter a question mark ( ? ):

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-79fileonmediaReports whether a file has been completely stored on media.Options/usr

Managing the AMASS File System3-80 Command Reference 6-00028-01 Rev AFile StatesA file in the AMASS file system can have the following states:Examples

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-81healthcheckTest several AMASS components. The command does not correct any malfun

Accessing Storage Devices6-00025-01 Rev A Contents xiiiOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-82 Command Reference 6-00028-01 Rev AOption Description-i Test integrity of the Database using the dbcheck utility. Fo

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-83Option Description-f path Test the file transfer procedure.• Enter the absolute p

Managing the AMASS File System3-84 Command Reference 6-00028-01 Rev AExampleStep 1. Log in as either amass or root. Step 2. The following example runs

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-85Step 3. An example of a summary report (-s) generated by this command is shown in

Managing the AMASS File System3-86 Command Reference 6-00028-01 Rev AsetdrverrResets the error counts to zero reported by the drivelist command.Option

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-87setvolerrResets the error counts to zero reported by the vollist command.Options/

Managing the AMASS File System3-88 Command Reference 6-00028-01 Rev AsetvolgrpAssign directories and subdirectories to a specified volume group. This

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-89 [-f]pathvolumegroupOption Description-f Force the assignment of new files to a s

Managing the AMASS File System3-90 Command Reference 6-00028-01 Rev AInitial File SystemStep 1. See the following figure, which illustrates an initial

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-91The following figure shows that all new subdirectories or files created under the

Accessing Storage Devicesxiv Contents 6-00025-01 Rev Afileonmedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-92 Command Reference 6-00028-01 Rev AThe -f option is used because there are existing files under the amass_unix direc

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-93sysopSystem administrators must use the Standalone Operator Interface to have ful

Managing the AMASS File System3-94 Command Reference 6-00028-01 Rev ATasksUse the Standalone Interface for the following tasks:• All management operat

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-95Running the InterfaceRun the Standalone Interface from either a standard shell to

Managing the AMASS File System3-96 Command Reference 6-00028-01 Rev AStep 3. The interface prompts you to load a volume into a specific drive. The pro

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-97sysperfView AMASS I/O activity.To exit this program, use <Control-C>.Option

Managing the AMASS File System3-98 Command Reference 6-00028-01 Rev AExampleOutput from the sysperf command is shown in the following table: # su root

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-99Output Fields DefinedThe following fields are generated by this command:Fields De

Managing the AMASS File System3-100 Command Reference 6-00028-01 Rev AVolFlagsFor more information, see “VolFlags Defined” on page 3-102.Status of vol

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-101Fields DescriptionAppears only if the -k option is used:Cache Blocks • Total = t

Accessing Storage Devices6-00025-01 Rev A Contents xvOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-102 Command Reference 6-00028-01 Rev AVolFlags DefinedThe following table describes the Active, Inactive, Online, and

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-103tapelengthDefine the length of unformatted tape to the File System Database for

Managing the AMASS File System3-104 Command Reference 6-00028-01 Rev ACreate a Template FileIf you use tape volumes of different lengths, create a tem

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-105Step 1. Use an editor, such as vi, to create a template file similar to the file

Managing the AMASS File System3-106 Command Reference 6-00028-01 Rev AvgexportExport data and attributes (metadata file) for a volume group to another

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-107LimitationsThe following limitations apply to the export process:• Hard links an

Managing the AMASS File System3-108 Command Reference 6-00028-01 Rev A[-uy][-dgq]-f metafilepathvolumegroupOption Description-d Remove all entries ass

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-109ExampleThis example assumes we have two AMASS installations, one in Denver and o

Managing the AMASS File System3-110 Command Reference 6-00028-01 Rev AStep 5. AMASS marks the volume group Read-Only to prevent the files from being c

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-111vgimportImport data and attributes (metadata file) for a volume group from anoth

Trademark NoticeADIC, AMASS, CentraVision, DAS, DataMgr, FileServ, and VolServ are either trademarks or registered trademarks of ADIC, Advanced Digita

Accessing Storage Devicesxvi Contents 6-00025-01 Rev APrerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-112 Command Reference 6-00028-01 Rev AOptions/usr/amass/bin./vgimport[-uy][-p path]-v volumenumber metafilepath Option

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-113ExampleThe following steps outline the same scenario we began with the vgexport

Managing the AMASS File System3-114 Command Reference 6-00028-01 Rev AStep 1. To begin, see the vgexport command. The following figure illustrates our

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-115Step 3. For network-attached storage devices: Use the bulkinlet command to load

Managing the AMASS File System3-116 Command Reference 6-00028-01 Rev A

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-117vglistView attributes for a volume group. OptionsNoteBy default, the view will n

Managing the AMASS File System3-118 Command Reference 6-00028-01 Rev AExampleStep 1. Log in as either amass or root. Step 2. To view attributes, inclu

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-119Flags Status of volume, not volume group:• full = space on volume group is full•

Managing the AMASS File System3-120 Command Reference 6-00028-01 Rev AvgpoolDefine media for an out-of-space volume group to one of the following:• Us

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-121[-cdeirstw][-j jukeboxnumber]volumegroupOption Description-c Limits the specifie

Accessing Storage Devices6-00025-01 Rev A Contents xviiConfigure Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-122 Command Reference 6-00028-01 Rev AEnable Volume Group to use Space PoolStep 1. Log in as either amass or root. Ste

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-123Limit Media Usage and Location of Space PoolStep 1. Log in as either amass or ro

Managing the AMASS File System3-124 Command Reference 6-00028-01 Rev AEnable Volume Group to use Tape MediaStep 1. Log in as either amass or root.Step

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-125vgreadonlyDefine a volume group as one of the following:•Read-Only• Read and Wri

Managing the AMASS File System3-126 Command Reference 6-00028-01 Rev A[-uy][-rw]volumegroupOption Descriptionno options View status for the specified

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-127vgrootView the directories assigned to a volume group.If you have assigned more

Managing the AMASS File System3-128 Command Reference 6-00028-01 Rev AExampleStep 1. Log in as either amass or root. Step 2. To view the relative path

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-129volclattrDefine attributes for cleaning volumes. For more information on drive c

Managing the AMASS File System3-130 Command Reference 6-00028-01 Rev AStep 3. View cleaning attributes with the vollist -g CL command, if desired. Cle

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-131-m maxusage Enter the maximum number of times this cleaning volume can be used,

Accessing Storage Devicesxviii Contents 6-00025-01 Rev Avoloutlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-132 Command Reference 6-00028-01 Rev AvolcleanDelete:All the files on a volume, but not the volume number from the Fil

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-133Options/usr/amass/bin./volclean[-uy]volumenumberOption Description-u Usage state

Managing the AMASS File System3-134 Command Reference 6-00028-01 Rev AvolcompRecover dead space by rewriting remaining data on a volume to a different

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-135After the volcomp process completes, the original volume is without data so AMAS

Managing the AMASS File System3-136 Command Reference 6-00028-01 Rev AOptionsExampleStep 1. Log in as either amass or root. Step 2. In the following e

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-137Step 3. Run the volcomp command on specified volume number (2) as shown in the f

Managing the AMASS File System3-138 Command Reference 6-00028-01 Rev AvolcopyCopy data from a source volume to a destination volume. If the original v

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-139RequirementsBefore using this command:• Two drives are required—one drive to rea

Managing the AMASS File System3-140 Command Reference 6-00028-01 Rev A• Both source and destination media must be of the same type and have the same b

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-141Name ContentionSolaris and HP-UX only: Because AMASS, Solaris, and HP-UX all hav

Accessing Storage Devices6-00025-01 Rev A Contents xixOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-142 Command Reference 6-00028-01 Rev AOption Definitiontype Enter one of the following copy types:• -c = Copy sourcevo

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-143ExampleTo perform a volume copy, follow the steps below.Step 1. Log in as either

Managing the AMASS File System3-144 Command Reference 6-00028-01 Rev AStep 2. If the source volume is not in its home storage slot, use the mediamove

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-145• After the copy has completed, AMASS returns the destination media to its origi

Managing the AMASS File System3-146 Command Reference 6-00028-01 Rev AvoldeleteDelete:• All the files on a volume• Volume number from the File System

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-147OptionsAdditional InformationFor more information on deleting a volume, see “Del

Managing the AMASS File System3-148 Command Reference 6-00028-01 Rev AvoldirView:• All files on a volume(Files that span media are marked with an aste

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-149ExampleFollowing is an example of output generated by this command for volume 3.

Managing the AMASS File System3-150 Command Reference 6-00028-01 Rev AvolfilelistView all files on a volume, one file per line.OptionsNoteIf you creat

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-151Verbose ExampleThe following example illustrates output for:• Storage Technology

Accessing Storage Devicesxx Contents 6-00025-01 Rev AOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-152 Command Reference 6-00028-01 Rev A• Files on volume number 2Nonverbose ExampleThe following example illustrates ou

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-153• Files on volume number 2Output Fields DefinedThe following fields are generate

Managing the AMASS File System3-154 Command Reference 6-00028-01 Rev ATIME FormatThe Access_time and Modified_time values have the following format: y

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-155File Names Last ExampleThe following output shows an example of the file names i

Managing the AMASS File System3-156 Command Reference 6-00028-01 Rev APractical Application The following example uses this command to back up files,

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-157Using tar CommandStep 1. Log in as either amass or root. Step 2. Enter the comm

Managing the AMASS File System3-158 Command Reference 6-00028-01 Rev Avolformat Format media with specified attributes.PrerequisitesBefore using this

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-159Options/usr/amass/bin./volformat[-uy][-pq][-b blocksize][-c {on|off}][-d num][vo

Managing the AMASS File System3-160 Command Reference 6-00028-01 Rev Avolumenumber Enter the unique volume number of the media you are formattingTo li

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-161Option DescriptionFor tape drives: -b blocksize(defaults are drive-dependent)NOT

Accessing Storage Devices6-00025-01 Rev A Contents xxidbcheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-162 Command Reference 6-00028-01 Rev AFormat a New VolumeStep 1. Log in as either amass or root.Step 2. To make the in

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-163Step 7. To further prepare the volume so AMASS can read or write to it, use the

Managing the AMASS File System3-164 Command Reference 6-00028-01 Rev Aattributes of the second volume group. If the values do not match, AMASS issues

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-165Example Configuring Block Size and CompressionStep 1. Log in as either amass or

Managing the AMASS File System3-166 Command Reference 6-00028-01 Rev AvolgroupAssign a volume to one of the following groups:• Numeric volume group nu

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-167Options/usr/amass/bin./volgroup[-uy][-f]volumenumbervolumegroupOption Descriptio

Managing the AMASS File System3-168 Command Reference 6-00028-01 Rev AAttributes Within Volume GroupsEach volume’s attributes within a numerical volum

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-169AMASS asks for confirmation of the process.Step 3. Use the setvolgrp command to

Managing the AMASS File System3-170 Command Reference 6-00028-01 Rev AvolinletLoad previously defined volume through the mailbox and mark online. Opti

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-171Load a New VolumeStep 1. Log in as either amass or root.Step 2. To make the init

Accessing Storage Devicesxxii Contents 6-00025-01 Rev AExample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-172 Command Reference 6-00028-01 Rev AStep 5. To further prepare the volume so AMASS can read or write to it, use the

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-173vollabelReassign AMASS volume to media with a different label or change the volu

Managing the AMASS File System3-174 Command Reference 6-00028-01 Rev AChange Volume LabelStep 1. Log in as either amass or root.Step 2. To change a vo

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-175volleftWrite how much space—in kilobytes—remains on a volume to standard out (st

Managing the AMASS File System3-176 Command Reference 6-00028-01 Rev AThere is 338,652 KB of space remaining on this volume.338652

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-177vollistView attributes for:• One volume• All volumes• A volume groupIf you think

Managing the AMASS File System3-178 Command Reference 6-00028-01 Rev AReset to ZeroUse the setvolerr command to reset the error counts reported by the

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-179View Attributes for One VolumeFollowing is an example of the output for volume n

Managing the AMASS File System3-180 Command Reference 6-00028-01 Rev AView Attributes for Cleaning GroupFollowing is an example of status output for t

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-181Volume Label Either:• User-assigned name• Preprinted barcodeField DescriptionFie

Accessing Storage Devices6-00025-01 Rev A Contents xxiiiMessages Generated by AMASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-182 Command Reference 6-00028-01 Rev AAvail Amount of space, in MB, available on the volumeNOTE: AMASS assumes a compr

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-183Flags DefinedThe following table describes the Active, Inactive, Online, and Off

Managing the AMASS File System3-184 Command Reference 6-00028-01 Rev AvollocMark a volume in the File System Database as either:• -n (Online) = Inside

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-185Mark New Volume OnlineStep 1. Log in as either amass or root.Step 2. To make the

Managing the AMASS File System3-186 Command Reference 6-00028-01 Rev AStep 5. To further prepare the volume so AMASS can read or write to it, use the

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-187volnewCreate an entry in the File System Database for new, unknown media. Option

Managing the AMASS File System3-188 Command Reference 6-00028-01 Rev ACreate Database Entry for New VolumeThe following example illustrates how to cre

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-189Step 1. Log in as either amass or root.Step 2. To create an entry in the File Sy

Managing the AMASS File System3-190 Command Reference 6-00028-01 Rev ACommand DescriptionvolinletNOTE: Not valid for libraries without a mailbox.Load

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-191volnoteEnter a user-defined 255-character description for a volume.Options/usr/a

Accessing Storage Devicesxxiv Contents 6-00025-01 Rev AOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing the AMASS File System3-192 Command Reference 6-00028-01 Rev AThe following example generates a list of all volumes and their descriptions: Th

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-193For offline volumes, the Offline Media Manager, run with the sysop command, disp

Managing the AMASS File System3-194 Command Reference 6-00028-01 Rev AvoloutletEject volume to the mailbox and mark offline.TasksThe following tasks a

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-195Option Description-u Usage statement-y Suppress interactive messagesvolumenumber

Managing the AMASS File System3-196 Command Reference 6-00028-01 Rev AvolreadonlyMark volume either:•Read-Only• Read and WriteOptionsNoteThis command

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-197-w Mark volume Read and Write-y Suppress interactive messagesvolumenumber Enter

Managing the AMASS File System3-198 Command Reference 6-00028-01 Rev AvolslotChange a volume’s home storage slot in the File System Database, but the

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-199Change Slot AssignmentTo change the home storage slot number for volume number 1

Managing the AMASS File System3-200 Command Reference 6-00028-01 Rev AStep 3. Change the volume’s home storage slot number to 0A56 with the following

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-201volspaceView all volumes with a specified percentage of dead space.Dead space is

1Initial SetupTasks

Managing the AMASS File System3-202 Command Reference 6-00028-01 Rev AExampleFollowing is an example of output generated with a dead space percentage

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-203Position Home storage slot. Valid entries are:• 4-alphanumeric designation = SCS

Managing the AMASS File System3-204 Command Reference 6-00028-01 Rev AField DescriptionDead Amount of space no longer referenced by files Expressed as

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-205Flags DefinedThe following table describes the Active, Inactive, Online, and Off

Managing the AMASS File System3-206 Command Reference 6-00028-01 Rev AvolstatView and change the current status—Active or Inactive—of a volume.Name Co

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-207Activate New Volume Step 1. Log in as either amass or root.Step 2. To create an

Managing the AMASS File System3-208 Command Reference 6-00028-01 Rev AStep 4. To mark the specified volume number Online in the Database, use the voll

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-209volusageView statistics for all volumes in the AMASS file system.OptionsExampleS

Managing the AMASS File System3-210 Command Reference 6-00028-01 Rev AStep 2. An example of the output is shown in the following illustration. Output

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-211Last MountedDate and time this volume was last mounted in a drive• Hyphen (—) =

ADIC includes this Form in an effort to provide the best possible documentation to our customers. Please take a few moments to mail or FAX your respon

Managing the AMASS File System1-2 Initial Setup Tasks 6-00028-01 Rev ANOTES

Managing the AMASS File System3-212 Command Reference 6-00028-01 Rev ANOTES

4UtilityReference

Managing the AMASS File System4-2 Utility Reference 6-00028-01 Rev ANOTES

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-3UtilitiesThe utilities described in this chapter are located in the directories li

Managing the AMASS File System4-4 Utility Reference 6-00028-01 Rev AScripts in /usr/amass/toolsThe following AMASS scripts help to identify and resolv

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-5amass_atbootDefine status of AMASS startup commands.OptionsExampleStep 1. Log in a

Managing the AMASS File System4-6 Utility Reference 6-00028-01 Rev AStep 2. If AMASS is hung, disable AMASS at reboot by entering the following path,

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-7amass_logRedirect the AMASS system log messages to the console.AMASS sends message

Managing the AMASS File System4-8 Utility Reference 6-00028-01 Rev AExampleStep 1. Log in as root.Step 2. Following the path and script name, enter th

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-9amass_snapCollect system information after a problem occurs.When to Use ScriptFor

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-3Prepare Media to be the Backup VolumeRunning the installation script created a B

Managing the AMASS File System4-10 Utility Reference 6-00028-01 Rev Aamass_start Performs the following tasks:• Start the AMASS daemons.• Mount the AM

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-11List of Startup DaemonsThe startup daemons are located in /usr/amass/daemons and

Managing the AMASS File System4-12 Utility Reference 6-00028-01 Rev Aamass_testsAMASS must be running prior to executing the test:• Storage device har

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-13List of TestsThe script runs the tests listed in the following table:Group Test N

Managing the AMASS File System4-14 Utility Reference 6-00028-01 Rev AExampleStep 1. Log in as root.Group Test Name DefinitionSystem Amassuserid Makes

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-15Step 2. Enter the path and script name. Step 3. Because the utilities are operato

Managing the AMASS File System4-16 Utility Reference 6-00028-01 Rev Ainstall_testsPerforms the following tasks:• Test storage device hardware.• Modify

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-17PrerequisitesBefore running this script, the following conditions must be met: •

Managing the AMASS File System4-18 Utility Reference 6-00028-01 Rev AList of Hardware TestsThe script runs the tests listed in the following table. Th

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-19Step 2. If AMASS is active, inactivate it with the option shown in the following

Managing the AMASS File System1-4 Initial Setup Tasks 6-00028-01 Rev A2 Physically designate the media as the Backup Volume in some outward way. See t

Managing the AMASS File System4-20 Utility Reference 6-00028-01 Rev AStep 7. For instructions on resolving other problems, see “amass_log” on page 4-7

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-21None # Test volume for jukebox 1None # " " " "

Managing the AMASS File System4-22 Utility Reference 6-00028-01 Rev AkilldaemonsPerforms the following tasks:• Inactivate AMASS by running the amassst

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-23ExampleTo run killdaemons, perform the following steps:Step 1. Log in as root.Opt

Managing the AMASS File System4-24 Utility Reference 6-00028-01 Rev AStep 2. To make sure there are no pending write requests in the AMASS queue, view

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-25Hardware Utilities in /usr/amass/utilsThe following AMASS utilities help to ident

Managing the AMASS File System4-26 Utility Reference 6-00028-01 Rev Ainit_elementRun the element_status command that physically scans the library then

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-27Step 2. Enter the following: # cd /usr/amass/utils# init_element 1

Managing the AMASS File System4-28 Utility Reference 6-00028-01 Rev AmediaejectEject media from a specified drive.OptionsExampleStep 1. Log in as root

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-29Step 2. To eject media from drive 1 in library 2: Step 3. If a hardware error occ

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-5For network-attached libraries:bulkinletCreate an entry in the AMASS File System

Managing the AMASS File System4-30 Utility Reference 6-00028-01 Rev AmediaeraseErase media starting at a specific block address through to one of the

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-31ExampleStep 1. Log in as root.Step 2. To erase data on a standalone drive and sto

Managing the AMASS File System4-32 Utility Reference 6-00028-01 Rev Awhere: Step 3. If a hardware error occurs, refer to your hardware manuals.Value

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-33medialistPerforms the following tasks:• Read the library’s database (not the AMAS

Managing the AMASS File System4-34 Utility Reference 6-00028-01 Rev AView Status for All ElementsStep 1. Log in as root.Step 2. To display the status

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-35View Status for One ElementBe careful when you ask for the status for a single el

Managing the AMASS File System4-36 Utility Reference 6-00028-01 Rev AmediamoveMove volumes from and to the locations listed in the following table:Opt

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-37 source destination [0|1][jukeboxnumber]Option Descriptionsource Enter one of the

Managing the AMASS File System4-38 Utility Reference 6-00028-01 Rev AExampleStep 1. Log in as root.Step 2. In the following example, AMASS instructs t

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-39mediareadPerforms the following tasks:• Read a specific block of data.• Write the

Managing the AMASS File System1-6 Initial Setup Tasks 6-00028-01 Rev A Step Command DescriptionNow, the Volume Label field displays the preprinted num

Managing the AMASS File System4-40 Utility Reference 6-00028-01 Rev AExampleStep 1. Log in as root.Step 2. To read block six on drive 2, enter the pat

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-41mediawriteWrite a predetermined line beginning at EOD for tape or at a specified

Managing the AMASS File System4-42 Utility Reference 6-00028-01 Rev AExampleStep 1. Log in as root.Step 2. To have drive two write to block six, enter

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-43printjournalPrint to stdout the contents of the journal, which is the daily trans

Managing the AMASS File System4-44 Utility Reference 6-00028-01 Rev A-n drivedrive number to use (1 relative)-P positionbackup volume is in this slot-

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-45quedisplayDisplay what is in the queues. The queues consists of a snapshot of the

Managing the AMASS File System4-46 Utility Reference 6-00028-01 Rev AWhen to Use UtilityUse this utility, to diagnose the following problems:• You wri

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-47ExampleStep 1. Log in as root.Step 2. Enter the path and utility as shown in the

Managing the AMASS File System4-48 Utility Reference 6-00028-01 Rev AOutput for streaming tape I/O (quedisplay -c) looks similar to the example shown

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-49sl_loggerThe sl_logger utility allows you to redirect messages to a location othe

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-75volformatNOTE: Not applicable for CDs.Format the Backup Volume.If you are using

Managing the AMASS File System4-50 Utility Reference 6-00028-01 Rev Alocation(defaults to stdin)Specify where message should be redirectedOption Descr

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-51Database UtilitiesThe following AMASS utilities help diagnosis problems with the

Managing the AMASS File System4-52 Utility Reference 6-00028-01 Rev AamassrecoveryPerforms the following tasks:• Recover the AMASS file system.• Initi

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-53ExampleStep 1. Log in as root. Step 2. If AMASS is active, inactivate it as show

Managing the AMASS File System4-54 Utility Reference 6-00028-01 Rev AStep 3. Enter the path as shown in the following example:# su amassPassword:# /us

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-55dbcheckTest integrity of the AMASS File System Database.This test can be time con

Managing the AMASS File System4-56 Utility Reference 6-00028-01 Rev AExampleStep 1. Log in as root. Step 2. From the AMASS File System Database direct

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-57fileincacheReport on the status of a specified file in the AMASS cache. Exit code

Managing the AMASS File System4-58 Utility Reference 6-00028-01 Rev AOption Description-u Usage statement-v Verbose messagesfullpath_filenameSpecify

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-59filepathDisplay the full path for the file indicated by the record ID (rid). If t

Managing the AMASS File System1-8 Initial Setup Tasks 6-00028-01 Rev ACreate File System OrganizationThe following tasks are presented as guidelines o

Managing the AMASS File System4-60 Utility Reference 6-00028-01 Rev AStep 3. AMASS returns the file’s full path as shown in the following example:# /a

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-61fileprintPrint the AMASS File System Database entry information for one of the fo

Managing the AMASS File System4-62 Utility Reference 6-00028-01 Rev AExampleStep 1. The following path and utility example displays File System Databa

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-63The output looks similar to the display shown in the following example: Step 2. T

Managing the AMASS File System4-64 Utility Reference 6-00028-01 Rev Ainitamass Clear the existing AMASS File System Database by reinitializing it to a

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-65initjournal Clear the existing transaction log by reinitializing it to an empty j

Managing the AMASS File System4-66 Utility Reference 6-00028-01 Rev AkeybuildRebuild the AMASS File System Database key tables. When to Use UtilityFor

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-67ExampleStep 1. Log in as root.Step 2. If AMASS is active, inactivate AMASS with t

Managing the AMASS File System4-68 Utility Reference 6-00028-01 Rev AsysdbchkSysdbchk is an AMASS utility that verifies the consistency of the AMASS f

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-69Options/usr/amass/utils./sysdbchk[-c dir][-d][-h][-i][-l dir][-q][-y]Option Descr

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-9Create Entries in Database for Your MediaMake AMASS aware of your media by creat

Managing the AMASS File System4-70 Utility Reference 6-00028-01 Rev AExampleStep 1. Log in as root.Step 2. Because this utility modifies the AMASS Fil

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-71The following figure illustrates the hierarchy that is created because AMASS foun

Managing the AMASS File System4-72 Utility Reference 6-00028-01 Rev AvolprintDisplay the attributes for one of the following:• One volume• All volumes

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-73Options/usr/amass/utils./volprint[-a][-u][-y]volumenumberOption Descriptionno opt

Managing the AMASS File System4-74 Utility Reference 6-00028-01 Rev AExampleStep 1. Log in as root.Step 2. To display tape block size and compression

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-75Flags Status of volume, not volume group:• A = Volume is Active• C = Volume is be

Managing the AMASS File System4-76 Utility Reference 6-00028-01 Rev AField DescriptionDead Blocks Amount of previously written space on the volume tha

Managing the AMASS File System6-00028-01 Rev A Utility Reference 4-77writecachemruAllow AMASS to use WRITE cache blocks before READ cache blocks. Cons

Managing the AMASS File System4-78 Utility Reference 6-00028-01 Rev A

5Trouble-shootingTools

Managing the AMASS File System1-10 Initial Setup Tasks 6-00028-01 Rev AFor example: volinlet 33NOTE: Not applicable for volumes destined for libraries

Managing the AMASS File System-2 Troubleshooting Tools 6-00028-01 Rev ANOTES

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -3AMASS Appears HungThere is no AMASS activity, including:• All drives in all lib

Managing the AMASS File System-4 Troubleshooting Tools 6-00028-01 Rev ACancel Outstanding RequestsYou can cancel an outstanding READ or WRITE request

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -5Operating IssuesThe following table lists operating issues: Operating SystemIss

Managing the AMASS File System-6 Troubleshooting Tools 6-00028-01 Rev AAMASS Database is BadAn error message occurs that points to an AMASS File Syste

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -7Step 5. Check the integrity of the AMASS File System Database by running the db

Managing the AMASS File System-8 Troubleshooting Tools 6-00028-01 Rev AStep 6. To resolve database key errors, run the AMASS keybuild utility. Example

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -9Step 7. To fix bad chain errors or deleted File System Database records, run dc

Managing the AMASS File System-10 Troubleshooting Tools 6-00028-01 Rev Awhere: After running dchain, rerun dbcheck on the affected database to make su

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -11Verify that the lock has been set by using the ls -la /usr/amass/fslock1 comma

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-112B For network-attached libraries:bulkinletFor example:bulkinlet 4Create an ent

Managing the AMASS File System-12 Troubleshooting Tools 6-00028-01 Rev AA) Generate the PID of the lm_ip process by using the UNIX ps command. If the

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -13B) Run ifconfig adapter and compare the inet address to the expected IP addres

Managing the AMASS File System-14 Troubleshooting Tools 6-00028-01 Rev ARerun the sysdbchk utility without the -y option to make sure that all errors

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -15• Make sure the Backup Volume is in the correct drive in the library. If there

Managing the AMASS File System-16 Troubleshooting Tools 6-00028-01 Rev AAMASS Does Not StartAMASS does not start.To correct, perform the following ste

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -17UNIX Server’s Partitions CrashAn AMASS partition on the UNIX server’s hard dis

Managing the AMASS File System-18 Troubleshooting Tools 6-00028-01 Rev AStep 5. To restore the File System Database and journal, from the Backup Volum

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -19Step 7. Start AMASS using amass_start as shown in the following example: If Da

Managing the AMASS File System-20 Troubleshooting Tools 6-00028-01 Rev AStep 5. To restore the database and journal from the Backup Volume, enter the

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -21Step 7. Start AMASS using amass_start as shown in the following example: If Ca

NOTES

Managing the AMASS File System1-12 Initial Setup Tasks 6-00028-01 Rev A2CbulkloadFor example:bulkload -sYou have just installed AMASS and must create

Managing the AMASS File System-22 Troubleshooting Tools 6-00028-01 Rev ARequests Not Getting to LibraryAMASS is running but is not behaving as expecte

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -23System PanicsIf a process causes a system panic, dump information to the core

Managing the AMASS File System-24 Troubleshooting Tools 6-00028-01 Rev AIBM Step 1. When the AIX operating system was installed, a dump device is auto

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -25Step 3. After information has been dumped, enter the following:Step 4. The /di

Managing the AMASS File System-26 Troubleshooting Tools 6-00028-01 Rev ACommand Gives Unexpected ResultsA command gives an unexpected result.To correc

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -27Step 7. If the problem persists, run the script command, which prints a line s

Managing the AMASS File System-28 Troubleshooting Tools 6-00028-01 Rev ALibrary or Drive is NonfunctionalA library or drive does not function as expec

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -29Power FailureAfter a system is rebooted because of a power failure, AMASS atte

Managing the AMASS File System-30 Troubleshooting Tools 6-00028-01 Rev AMessages Generated by AMASSAMASS generates the following types of messages:• O

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -31These system log messages help you to: assess system operation, resolve proble

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-13Volume Groups DefinedA volume group is a method for partitioning the volumes in

Managing the AMASS File System-32 Troubleshooting Tools 6-00028-01 Rev APrepare to Contact Technical SupportDepending on how you purchased technical s

Managing the AMASS File System6-00028-01 Rev A Troubleshooting Tools -33Step 4. Obtain the following information:• AMASS Serial Number: ______________

Managing the AMASS File System-34 Troubleshooting Tools 6-00028-01 Rev ANOTES

ABackupScripts forHP-UX

Managing the AMASS File SystemA-2 Backup Scripts for HP-UX 6-00028-01 Rev ANOTES

Managing the AMASS File System6-00028-01 Rev A Backup Scripts for HP-UX A-3Backup Example for Small File SystemsThe script below performs:• A complete

Managing the AMASS File SystemA-4 Backup Scripts for HP-UX 6-00028-01 Rev A## Shell variables:# TEMPFILE - temporary location for# file listing#

Managing the AMASS File System6-00028-01 Rev A Backup Scripts for HP-UX A-5then if [ -f /etc/archivedate ] then /bin/mv /etc/archivedate \ ŽŽŽ

Managing the AMASS File SystemA-6 Backup Scripts for HP-UX 6-00028-01 Rev ABackup Example for Large File SystemsThe following script backs up data on

Managing the AMASS File System6-00028-01 Rev A Backup Scripts for HP-UX A-7#!/bin/shset -a# abackup## Purpose:# Store AMASS file system to tape.# Crea

Managing the AMASS File System1-14 Initial Setup Tasks 6-00028-01 Rev AThe following figure illustrates these volume groups. Uniform Media in Numeric

Managing the AMASS File SystemA-8 Backup Scripts for HP-UX 6-00028-01 Rev A## Output:# A set of tapes the can be used to# restore user files to a

Managing the AMASS File System6-00028-01 Rev A Backup Scripts for HP-UX A-9>${TEMPFILE}>/tmp/BACKUPFILEScd /cd ${MOUNTPT}if [ -f /etc/archivedat

Managing the AMASS File SystemA-10 Backup Scripts for HP-UX 6-00028-01 Rev Adone if [ -f ${TEMPFILE} ] then cat ${TEMPFILE} | sort +1n +2n | \

BFine-tuneBlock Size

Managing the AMASS File SystemB-2 Fine-tune Block Size 6-00028-01 Rev ANOTES

Managing the AMASS File System6-00028-01 Rev A Fine-tune Block Size B-3Optimize Tape Block SizeOverall system performance is generally improved by con

Managing the AMASS File SystemB-4 Fine-tune Block Size 6-00028-01 Rev A• Read the drive manufacturers published data on your drive’s performance and b

Managing the AMASS File System6-00028-01 Rev A Fine-tune Block Size B-5Correlate with READ-BLOCK LIMITA SCSI drive writes to tape in a fixed block seg

Managing the AMASS File SystemB-6 Fine-tune Block Size 6-00028-01 Rev ATo determine the READ-BLOCK LIMIT value, refer to your drive’s manual. Your goa

Managing the AMASS File System6-00028-01 Rev A Fine-tune Block Size B-7Each tape block can be configured as: MAXIOSZ = 256 KB16 KB16 KB16 KB16 KB32 KB

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-15Likewise, the cleaning group must contain volumes with uniform, drive-specific

Managing the AMASS File SystemB-8 Fine-tune Block Size 6-00028-01 Rev ANOTES

CCacheCommands

Managing the AMASS File SystemC-2 Cache Commands 6-00028-01 Rev ANOTES

Managing the AMASS File System6-00028-01 Rev A Cache Commands C-3Cache CommandsUsing new AMASS commands, you can now assign cache block list values fo

Managing the AMASS File SystemC-4 Cache Commands 6-00028-01 Rev AOptions/usr/amass/bin./setcblist-uy[-r read_list volumegroup][-w write_list volumegro

Managing the AMASS File System6-00028-01 Rev A Cache Commands C-5OutputThe example below illustrates how to assign volume group 126 both a read and wr

Managing the AMASS File SystemC-6 Cache Commands 6-00028-01 Rev AOptionsOutputThe example below illustrates how to display cache block list values for

Managing the AMASS File System6-00028-01 Rev A Cache Commands C-7The example below illustrates how to display cache block list values for volume group

Managing the AMASS File SystemC-8 Cache Commands 6-00028-01 Rev AOptions/usr/amass/bin./setcbwght-uycachelist_numberweight_factorOption Description-u

Managing the AMASS File System6-00028-01 Rev A Cache Commands C-9OutputThe example below illustrates how to set cache block list 8 for a weight factor

Managing the AMASS File System1-16 Initial Setup Tasks 6-00028-01 Rev ABy allocating project files from a subdirectory to specific volumes, the data g

Managing the AMASS File SystemC-10 Cache Commands 6-00028-01 Rev ANOTES

6-00028-01 Rev A Index INX-1IndexSymbols/usr/amass/bin . . . . . . . . . . . . . . . . . . 3-3/usr/amass/daemons . . . . . . . . . . . . . . 4-3/us

Managing the AMASS File SystemINX-2 Index 6-00028-01 Rev Acdimport . . . . . . . . . . . . . . . . . . . 3-50dirfilelist. . . . . . . . . . . . . . .

Managing the AMASS File System6-00028-01 Rev A Index INX-3Drivefunction not as expected . . . . . . 5-28Redwood tape length . . . . . . . . 3-103re

Managing the AMASS File SystemINX-4 Index 6-00028-01 Rev Aoffline. . . . . . . . . . . . . . . . . . . . . 2-25recycle . . . . . . . . . . . . . . .

Managing the AMASS File System6-00028-01 Rev A Index INX-5AMASS path . . . . . . . . . . . . . . . . 4-3amass_atboot . . . . . . . . . . . . . . . .

Managing the AMASS File SystemINX-6 Index 6-00028-01 Rev AVvgexport Command . . . . . . . . . . . . 3-106vgimport Command . . . . . . . . . . . . 3-

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-17• The projects directory, is the root directory for volume group 0.- If new fil

Managing the AMASS File System1-18 Initial Setup Tasks 6-00028-01 Rev AInstead, AMASS generates an out-of-space message, and you must assign more volu

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-19Assign Directory to a Volume GroupTo assign an existing directory to a volume g

Managing the AMASS File System1-20 Initial Setup Tasks 6-00028-01 Rev ACreate a Cleaning Volume GroupTo create a volume group used solely for cleaning

Managing the AMASS File System6-00028-01 Rev A Initial Setup Tasks 1-213volclattrDefine drive-specific attributes to the cleaning volume (23).For exam

PPreface

Managing the AMASS File System1-22 Initial Setup Tasks 6-00028-01 Rev ANOTES

2OperationalTasks

Managing the AMASS File System2-2 Operational Tasks 6-00028-01 Rev ANOTES

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-3Database and Journal BackupsFile System Database—The File System Database contains

Managing the AMASS File System2-4 Operational Tasks 6-00028-01 Rev AThe Journal tells AMASS what transactions—what entries—have acted upon a file stor

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-5The “full backup” (backs up the Database and Journal) and “partial backups” (backs

Managing the AMASS File System2-6 Operational Tasks 6-00028-01 Rev A0 3 1 * * /usr/amass/bin/amassbackup -fv0 3 2-31 * * /usr/amass/bin/amassbackup -v

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-7Manual BackupManually back up the Database and Journal under the following conditi

Managing the AMASS File System2-8 Operational Tasks 6-00028-01 Rev A4amassbackup -uAs appropriate, perform either a:• Full (-f) backup with the verbos

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-9Replace a Full Backup VolumeAMASS issues a warning message when the Backup Volume

Managing the AMASS File SystemP-2 Preface 6-00028-01 Rev ANOTES

Managing the AMASS File System2-10 Operational Tasks 6-00028-01 Rev ARestore AMASS DatabaseTo restore the AMASS File System Database and journal if th

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-11Restore with Earlier AMASS VersionTo recover data on a Backup Volume containing a

Managing the AMASS File System2-12 Operational Tasks 6-00028-01 Rev AReinitialize DatabaseTo empty the existing AMASS File System Database and reiniti

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-134 # cd # /usr/amass/utils/initamassChange directory and reinitialize the File Sys

Managing the AMASS File System2-14 Operational Tasks 6-00028-01 Rev ABack Up Media in LibraryThere are a variety of ways to back up the data residing

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-15This solution provides faster backups than if the data is accessed randomly becau

Managing the AMASS File System2-16 Operational Tasks 6-00028-01 Rev ATake a Drive Out of ServiceTo take a drive out of service — whether because of ex

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-17Return a Drive to ServiceTo return a drive to service, use the procedure in the f

Managing the AMASS File System2-18 Operational Tasks 6-00028-01 Rev ADelete Files and Volume NumberTo delete:• All files on a volume• Volume number fr

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-193B For network-attached libraries:bulkoutlet -u For example:bulkoutlet 1,2-10,21,

Managing the AMASS File System6-00028-01 Rev A Preface P-3Purpose of This BookThis book describes the management tasks, commands, utilities, and troub

Managing the AMASS File System2-20 Operational Tasks 6-00028-01 Rev ADelete Volume GroupTo delete a Volume Group, use the procedure in the following t

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-21Recycle a VolumeTo perform the following tasks, use the procedure described in th

Managing the AMASS File System2-22 Operational Tasks 6-00028-01 Rev A4 volformat volumenumberFor example:volformat 3Reformat the now-empty volume.NOTE

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-23Remove Media From LibraryThe following steps describe how to remove a volume afte

Managing the AMASS File System2-24 Operational Tasks 6-00028-01 Rev A5C If — for some reason — you manually remove a volume from the library:volloc -o

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-25Read Offline VolumeOffline Media Manager (OMM) provides read-access to volumes th

Managing the AMASS File System2-26 Operational Tasks 6-00028-01 Rev A• Use the Standalone Operator Interface to monitor load requests. For information

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-27The sysop interface used by OMM creates a /tmp/sysop.out file that contains entri

Managing the AMASS File System2-28 Operational Tasks 6-00028-01 Rev AReturn Media Without Starting AMASSTo return media in a drive to its home storage

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-29Add Space to Volume Group To add space to a volume group so AMASS can continue to

Managing the AMASS File SystemP-4 Preface 6-00028-01 Rev A• Reading offline media• Adding space to volume groups• Activating and inactivating the file

Managing the AMASS File System2-30 Operational Tasks 6-00028-01 Rev ACreate Space PoolStep Command Description1 Log in as amass or root.2volgroup volu

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-31Reassign Volume GroupTo reassign new files in the amass_nt directory, as illustra

Managing the AMASS File System2-32 Operational Tasks 6-00028-01 Rev AStep Command Description1Log in as amass or root.2vollist -g volumegroupFor examp

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-33Activate the File SystemTo activate the AMASS file system, which allows AMASS fil

Managing the AMASS File System2-34 Operational Tasks 6-00028-01 Rev A2 amassstat -uFor example:amassstat -i -t 600AMASS inactivate in 600 seconds, 10

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-35Modify Configuration FileChange the AMASS library configuration in response to th

Managing the AMASS File System2-36 Operational Tasks 6-00028-01 Rev AStep Command Description1Log in as amass or root.2sysperf [updateinterval] To mak

Managing the AMASS File System6-00028-01 Rev A Operational Tasks 2-37MAXIOSZ ChangesIf you want to change the MAXIOSZ, perform the following steps: St

Managing the AMASS File System2-38 Operational Tasks 6-00028-01 Rev ANOTES

3CommandReference

Managing the AMASS File System6-00028-01 Rev A Preface P-5ConventionsThe conventions used throughout the AMASS technical books are listed below: Conve

Managing the AMASS File System3-2 Command Reference 6-00028-01 Rev ANOTES

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-3CommandsThe commands described in this chapter are located in the directories list

Managing the AMASS File System3-4 Command Reference 6-00028-01 Rev AReturn Code Description-1 errorall other values success

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-5adfView statistics for all volume groups in the AMASS File System Database.Options

Managing the AMASS File System3-6 Command Reference 6-00028-01 Rev AExampleStep 1. Log in as either amass or root. Step 2. See an example of the outpu

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-7Avail Amount of space, in MB, available in this volume groupVolumes Number of volu

Managing the AMASS File System3-8 Command Reference 6-00028-01 Rev AamassbackupBack up to a Backup Volume in either a library or a standalone drive th

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-9PrerequisitesBefore using this command, use the vollist command to make sure the B

Managing the AMASS File System3-10 Command Reference 6-00028-01 Rev AExampleStep 1. Log in as either amass or root. Step 2. To perform a full backup t

Managing the AMASS File System6-00028-01 Rev A Command Reference 3-11Additional InformationFor more information, see “Database and Journal Backups” on