Home

ADIC Time Clock 6-00028-01 Rev A User's Manual

1. Options usr amass bin volcomp uvy volumenumber Option Description u Usage statement V Enable progress reporting y Suppress interactive messages volumenumber Enter the unique volume number to volcomp Example Step 1 Log in as either amass or root su root Step 2 In the following example we used the volspace command to list all volumes that have more than one third 33 dead space The output shows that volume number 2 meets this requirement volspace 33 VOLGRP JUKE POS LABEL VOLFGS USERID AVAIL DEAD ERRS 4 0 OA03 386 0 33 0 3 136 Command Reference 6 00028 01 Rev A Managing the 5 File System Additional Information Step 3 Run the volcomp command on specified volume number 2 as shown in the following example d volcomp 2 The few files on volume number 2 are moved to another volume in the same volume group While the original volume is being volcomped AMASS marks the volume shown in the Flag column with a C for volcomp and sets it Read Only this can be viewed in the output generated by the vollist command At the end of the process the original volume status shown in the Flag column is I for Inactive For more information on recovering dead space see Recycle a Volume on page 2 21 6 00028 01 Rev A Command Reference 3 137 Managing the AMASS File System volcopy Optional Feature Copy data
2. 1 Tools that Display Block Size and Compression The following tools display both a tape block size blksiz and compression cmpr field that allows you to view these configurations e vglist command By default both block size and compression attributes do not display unless specifically requested with the a option For more information about this command see vglist on page 3 117 e volprint utility By default both block size and compression attributes do not display unless specifically requested with the a option For more information about this utility see volprint on page 4 72 6 00028 01 Rev A Command Reference 3 165 Managing the AMASS File System volgroup Assign a volume to one of the following groups Numeric volume group numbered 1 through 2047 Space pool A volume with files on it cannot be assigned to the space pool SP When a volume group runs out of space AMASS assigns a compatible volume from the space pool to the out of space volume group so archiving can continue without interruption Consequently if your site uses different types of media the space pool should contain a mixture of media Cleaning group Cleaning cartridges are assigned to the cleaning group CL If a library automatically performs drive cleaning do not configure a cleaning volume group in AMASS Media verification group A volume assigned to the media verification MV v
3. he Ghee Et 3 196 3 196 3 198 OpHONS ating Ua aito Vea A ge oe eae dna 3 198 Change Slot Assignment epa E REPRE 3 199 PM Ps 3 201 OBUONS ea oder neq EUR dw eai 3 201 Example ud ed xr oie tary aes NEA E E ET dp nei 3 202 state esa stot Actas ete tate ero atate dcdit edits v 3 206 Name Contention 244 4 seat d duo Matos b do ol te doe s 3 206 ODBOLDS ue bone od Ree 3 206 Activate New 3 207 vol s ge sei a eee EEE ET 3 209 MISSE A 3 209 Example oo oput ta e vis aes heen MS 3 209 Utility Reference 4 eT 4 3 Scripts in ust amass fools casio cx o Pres EN pev Ne RI EE ES 4 4 amassatbOOL cuui eese Sed ee 4 5 ce Perm odor Cea acr Nisi aN 4 5 Example a EE rte 4 5 SUAS M M M E EM otek 4 7 When to Use Script reed sare Hale pd 4 7 xviii Contents 6 00025 01 Rev A Accessing Storage Devices JDHOIS tii ght thease NUN EE SA CCS e SEES 4 7 amass ud S ba t e E dra oT aW Lepage d 4 9 When to Use DODDE eset TWIN EX TE e E EPA Een iem
4. 3 198 volspace Command 3 201 volstat Command 3 206 Volume also see 2 21 backup ioco Son SE eh eee 1 3 efe s 2 21 Volume Group INX 6 Index add space tO 241244 2 29 assign 1 19 cleaning 1 14 1 20 defrieds 22253 RP ORENSE RS 1 13 1 14 1 16 TOSS Ipfc alise 2 31 space 1 1 15 2 30 Volume Number delete from database 2 18 volusage Command 3 209 Web Secured ST as P 7 MABdOWS 93 cosas Eua imen rud 5 5 Windows ood crater 5 5 writecachemru Utility 4 77 6 00028 01
5. 3 44 Manually Load New Volumes 3 45 da der Ap ROREM hob rd d cV eal as Ae REMO 3 47 Tasks Lr 3 47 xii Contents 6 00025 01 Rev A Accessing Storage Devices JOHODS ENTIS TALES Rages 3 47 Outlet Volume cov eos ara eR Rd ERE RS ELE E Re 3 48 Unsuccessful Elects opor oco or Op br en POESIE d DIS 3 49 Schein bees TOREM eique uh tee DN sabe daten 3 50 Optional Feature ssc keene voe eae Een aa pdt Rare ES 3 50 Prevent Mount of Internal CD Drive 3 50 og acd peat cast ay Maki 3 52 Example axes taeda RE 3 53 esas Tu PRORA GRAAL aA EE 3 56 essai aes so ia eoque aai equ swa dau dd 3 56 Verbose more eer eb hel e dH ees 3 57 Nonverbose Example bein eter yet wee tates oes 3 57 Practical Application i iam pad ea says seas pct sees ees 3 59 driyecledti od wee Meath dot 3 61 Prerequisites drca OO ws ae kak tees Wawa Baca deae Oto ga 3 61 ODBOlS sia ut ee pex pp TUM pP NUT AM DUM KP ES 3 62 Sake oracio bokeh orto mais bide pte lee DI Id qi 3 62 Automatic o a
6. Option Description drivenumber Enter the drive number where the media is mounted startblock Start at this block address endblock Erase data until you reach e specified block address End of tape jukeboxnumber Enter the AMASS library number defaults to 1 Example Step 1 Login as root su root Step 2 erase data a standalone drive and stop at the end of the media enter the path utility and options similar to what is shown in the following example cd usr amass utils d mediaerase dev rst12 6 1 6 00028 01 Rev A Utility Reference 4 31 Managing the AMASS File System where Value Description dev rst12 Drive number for a standalone drive where the media is mounted 6 Start at this block address 1 Erase data until you reach the end of the media Step 3 If a hardware error occurs refer to your hardware manuals 4 32 Utility Reference 6 00028 01 Rev A Managing the 5 File System medialist Performs the following tasks e Read the library s database not the AMASS File System Database Display the status of elements Options usr amass utils medialist j jukeboxnumber S element Option Description j jukeboxnumber Enter the AMASS library number defaults to 1 element Enter one of the following elements XXXX Home storage slot or barcode Drive number mor M Mailbox TX Transp
7. sure the Backup Volume is in the correct drive in the library If there is another volume in the drive return it to its home slot by using the following utility The user must be amass Use this utility only when AMASS is not running su amass Password usr amass daemons amassrecovery s where Option Description s Performs the following Prevents system startup Performs file recovery Returns media to its home storage slot Step 5 Restore the File System Database and Journal by entering the following options amassrestore v d dev rst12 L 12N6J 3 22 Command Reference 6 00028 01 Rev A Managing the 5 File System where Value Description Verbose messages d dev rst12 Backup Volume is on this standalone drive L 12N6J Preprinted barcode 6 00028 01 Rev A Command Reference 3 23 Managing the AMASS File System amassstat View and change the current status Active or Inactive of AMASS After a system reboot AMASS comes up in an Active state regardless of the status before the reboot Shutdown Tasks Prior to shutting down AMASS performs the following tasks Prevents new files from being opened Waits five minutes default to allow all files to close this time expires and there still are open files AMASS remains Active but sends a warning message unless the option was used e Updat
8. 3 37 3 170 setcblist C 3 SetcbwBlit coy cee es C 7 setdrverr 3 86 setvolerr 3 87 setvolgrp Command 3 88 Shutdown 3 24 Space Pool media DE Lote D s CURES 1 15 Standalone Drives PCT ACS 3 93 StorageTek define Redwood tape length 3 103 cuneus Sy Cine aka eek 3 42 StorageTek Redwood 1 6 sysdbchk Utility coi uds 4 68 sysop Command 3 3 3 93 syspert Command 3 97 System Pane 5 23 I Tape Block Size COHLIPUIB EE S 3 164 Cox S RSS B 3 VIEW bw deem 3 117 6 00028 01 Rev A Managing the AMASS File System Tape Drives tape 4 46 tapelength Command 3 103 Technical 5 32 Messages e Aia ee ee is 5 30 prepare to contact 5 32 U UNIX utilities for backup 2 14 Utility AMASS aaee enis 4 3 amassrecovery 4 52 ADCHECK as sitio deiade 4 55 Hleineaclie 2s sss 4 57 filep th bv SERE 4 59 uero dert edat leto des 4 61 for AMASS database 4 51 for hardware connected to AMASS 4 25 ini 4 26 4 64 initjournal 62 5 vee cede Pare 4 65 RO VUNG oso steel 4
9. fullpath filename Specify the full path to the file you want status on 4 58 Utility Reference 6 00028 01 Rev A Managing the 5 File System filepath Display the full path for the file indicated by the record ID rid If the rid appears in an AMASS error message use this utility to view the full path for the file Options usr amass utils filepath u rid Option Description u Usage statement rid Enter the AMASS File System Database record ID number Example Step 1 Login as root su root Step 2 Enter the record ID number as shown in the following example usr amass utils filepath 52696 6 00028 01 Rev A Utility Reference 4 59 Managing the AMASS File System Step3 AMASS returns the file s full path as shown in the following example archive swpubs amass chap2 fm6 4 60 Utility Reference 6 00028 01 Rev A Managing the 5 File System fileprint Options Print the AMASS File System Database entry information for one of the following e File Directory e Symbolic link The File System Database information includes type of entry field values start of logical block address start of device block address and if appropriate multivolume and append record information usr amass utils fileprint u h filename rid rid Option Description h Display the start of the file s block address
10. links and soft links are not exported If the volume group being exported contains these file types a warning message appears but the export continues e Only volumes formatted with AMASS Version 4 7 1 and later can be exported Run one vgexport or vgimport on the system at a time Name Contention HP UX only Because AMASS and HP UX both have a vgexport command make sure you use the full path to differentiate which command you want to use For example to use the AMASS command enter it as shown in the following example su root cd usr amass bin vgexport Or make sure your PATH variable has usr amass bin before the HP UX usr sbin vgexport Options usr amass bin vgexport 6 00028 01 Rev A Command Reference 3 107 Managing the AMASS File System uy dgq f metafilepath volumegroup Option Description d Remove all entries associated with the exported volume group from the Database on the source server 9 Ignore volume verification q Do not mount and verify the volume header defaults to mount volumes for header for each volume associated with the specified volume group verification u Usage statement y Suppress interactive messages metafilepath Enter a user defined path for the metadata you are exporting NOTE The metadata file is useless without the accompanying volumegroup volumegroup Enter the volume gr
11. Field Description Dead Blocks Amount of previously written space on the volume that is no longer referenced by files This is expressed as a percentage of the total volume space the higher the percentage the greater the amount of dead space NOTE Volumes with high percentages are good candidates for the volcomp process Errors Number of errors on this volume Volume Label The user assigned volume label or preprinted barcode Field Description The following two fields are valid if you use the a option Block Size Tape s block size Compression Data compression Valid values are On default compression ON Off 2 compression OFF Dflt compression is undetermined because media is un formatted 4 76 Utility Reference 6 00028 01 Rev A Managing the 5 File System writecachemru Allow AMASS to use WRITE cache blocks before READ cache blocks Consequently READ cache blocks are used last Options usr amass bin writecachemru de u Option d default Description AMASS reuses non dirty or empty data has already been written to media cache blocks on a least recently used basis AMASS reuses the empty WRITE cache blocks before READ cacheblocks Usage statement 6 00028 01 Rev A Utility Reference 4 77 Managing the AMASS File System 4 78 Utility Reference 6 00028 01 Rev A 9 Trouble
12. d Eget peo Debe eo acne e obe dp b mei vt 3 88 OPHONS Cee te ae quels ad ne QU toto aoa quinis d 3 88 File iau be UR RC aH EIER o 3 90 SYSOP Sable hod oad Ee 3 93 OPHONS Sus NOD oram ano voco uie ad 3 93 Tasks su I b Sw ext 3 94 Running the Interface tt iot ti errit 3 95 cw aeia E a wah 3 97 OPHOUS io d es oa ie E mi E e De ios 3 97 Example ait sd oai uu eM etes 3 98 lapeleriglli sansa EAR shaw Re pu REP bee bead et Eee 3 103 ODHOLDS PER 3 103 Template Due ueste dovete ed ac N ad edd 3 104 VBOXDOPE Sawa Voci DO VICO E EEE 3 106 Optional Feature ii 40252 pad nied Stasi eee edi QA EA Sed ead 3 106 Disable Volume Verification 3 106 IB sicui mcm 3 107 Name COM TOT us s iratos una c a at Re e undated 3 107 xiv Contents 6 00025 01 Rev A Accessing Storage Devices OHNE See tata Sete DA SETA ILE E RE RS 3 107 AV REDE ERE DRE LR I EE URP ees 3 109 VEHHDDED oti aventi am ide pees eerie earls ex dx 3 111 O
13. Product Alerts Informs customers of technical problems and solutions Product Bulletins Conveys technical information not problems to customers Secured Web To receive access to the secured site on the ADIC home page Site containing technical product information Release Notes Product Alerts Product Bulletins FAQs visit http partners adic com and follow the password request procedure In return ADIC will send instructions and a password 6 00028 01 Rev A Preface P 7 Managing the AMASS File System NOTES P 8 Preface 6 00028 01 Rev A Contents Preface Purpose of This Book oso oos d KE ave E Es P 3 Who should Bead This Book ies op pda ta tr s e e ord e kt den POR P 3 How book 15 Organized itecto x vit EA P 3 CONVENMONS a i ERAS ba A bea ates d LEAL ba Nes LA EMI P 5 BOURS uo Nu P 6 Contact Pu D HO HOTIS de oua o ioa NU P 6 R l ted Publications ermesine ore ne Kt ep S ee Save aite aot P 7 Secured WebSite os oi tat de dn p LESE ADU dete RERBA PA DA Ted mcd P 7 Initial Setup Tasks 1 Prepare Media to be the Backup 1 3 Slot POSIION Vsus oues uda edd cales dett d 1 3 Create Dile System Organizatora cen bu es raton sa PET DR 1 8 Create Entries in Database for Your Media 1
14. Tip If all the tests are run depending on the size of your system it may take several minutes to complete Options usr amass bin healthcheck uv icCsw path 1 jukeboxnumber drivenumber volumenumber 6 00028 01 Rev A Command Reference 3 81 Managing the AMASS File System Option Description Test integrity of the Database using the dbcheck utility For information on this utility see dbcheck on page 4 55 To prevent requests from using the Database while AMASS is running this test the Database is locked AMASS tries for one minute to lock the Database if it is unsuccessful the test fails Verify the cache partitions by reading the first and last block in each partition defaults to stop testing If a test fails continue testing S View a summary report of the tests on the console NOTE Unless you use this option AMASS does not display any messages informing you that a test passed or failed Usage statement Verbose messages Analyze write resources by checking cache blocks and FNODES using the sysperf k command 3 82 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description path Test the file transfer procedure Enter the absolute path beginning with the mount point of the file you want AMASS to use for this test For example archive
15. filename w wait time Option Description Display cache block queue information k Display kernel information u Usage statement 6 00028 01 Rev A Command Reference 3 93 Managing the AMASS File System Option Description l Enable external program f filename Log information to specified filename as well as to the screen NOTE This file output is suitable for importing the I O data into most spreadsheet programs w wait time Enter how long in seconds AMASS should display the mount information A zero wait time means zero minutes consequently the message will not display Tasks Use the Standalone Interface for the following tasks All management operations for the AMASS file system e requests e Back up File System Database with amassbackup You cannot restore the File System Database with the Standalone Interface 3 94 Command Reference 6 00028 01 Rev A Managing the AMASS File System Running the Interface Run the Standalone Interface from either a standard shell tool window or basic ASCII terminal Normally the interface is run from one window or terminal while AMASS is run from another window or terminal Tip Do not use the UNIX abort command with the Standalone Interface to stop the AMASS volcopy process To run the Standalone Interface perform the following steps Step 1 Login as
16. e Read the drive manufacturers published data on your drive s performance and block size Some of these parameters are described below Correlate with File To improve performance on file systems with large files it is Size generally better to have AMASS write to a tape with a large block size On the other hand on file systems with smaller files it is generally better to have AMASS write to a tape with a smaller block size This concept is illustrated below Tape Media DIDS Writing large files to a tape with a large block size Writing smaller files to a tape with a smaller block takes less time thus improves performance size does not waste space on the tape Correlate with Calculating a block size for tape media must be correlated with MAXIOSZ the MAXIOSZ parameter The MAXIOSZ is defined when installing AMASS and is the maximum size in bytes that AMASS uses to transfer data to and from the cache The MAXIOSZ value varies depending on the operating system AMASS is installed on For more information on MAXIOSZ refer to MAXIOSZ in Installing AMASS If you change the MAXIOSZ value after using AMASS you may not be able to read or write to previous volumes that were formatted with the old MAXIOSZ parameter At the very least you will see a significant decrease in throughput B 4 Fine tune Block Size 6 00028 01 Rev A Managing the 5 File S
17. 3 UnAvailable InUse Writing astats c Output Fields Defined ConfigBlkSiz ConfigComprs SIO OK Fields State Description Drive Flags ConfigBlkSiz device block size is configurable ConfigComprs device compression is configurable Non LBA device block address type is vendor specific No SpaceEOD tape does not support SPACE end of data SIO OK device type is supported by streaming tape enhancements The following output is generated when the astats command is run with the j option su root astats j Library Drive Type Volume State JH 1 Tape AsyncEjectSupport 3 UnAvailable InUse Writing 3 30 Command Reference 6 00028 01 Rev A Managing the 5 File System astats j Output Fields Defined Fields State Description Library System Flags e AsyncEjectSupport support for asynchronous eject BackingUp a backup is in progress NoRWBuffers ran out of buffers QueuedRW jobs have been added to the queues QueuedVolBject queued for tape effect The following output is generated when the astats command is run with the v option su root d astats v Library Drive Type Volume State 1 1 rape 3 FullVol 6 00028 01 Rev A Command Reference 3 31 Managing the AMASS File System astats v Output Fields Defined Fields Description State Volume System Flags e AsyncEjectDone eject of volume
18. Library or Drive is Nonfunctional A library or drive does not function as expected To correct perform the following steps Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Ensure that power is ON for the library and the communications cables are securely attached to the library and to the server where AMASS is installed If the library control panel has a display area check for an error code Refer to the User s or Operator s manual for the specific library having the problem for instructions for handling error conditions Log in as root If AMASS is active run the command shown below For command information see amassstat on page 3 24 su root amassstat f Run install tests This script will test library operation and provide information on specific failures For more information see install tests on page 4 16 If the problem cannot be resolved contact your hardware technical support representative 28 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System Power Failure After a system is rebooted because of a power failure AMASS attempts to automatically run the amassrecovery utility which starts AMASS and recovers any files in the cache Instead AMASS displays an filename has append record flags set but no append records message Run usr amass utils sysdbchk to verify the consistency of the file system and repair the incorrect flag
19. eblk 0x0000264e tp iocc 0x01000000 The stat field is the current state of the streaming cache block The cbq cbdata field is an I O descriptor cbq stat PEND containing the device number block address J cbq cbdata offset byte count and file offset of the cache c blno 0x00230010 device data being copied to tape 0x01000000 boff 0 2 7000000 block number blno 0x00230010 cbq ptr 0x0403 Ocb8 is pending physical completion UNADJ cbque flink 0x04030c UNADJ cbque blink 0x04030c tp sblk 0x0000264f tp eblk 0x00000000 LOCC v 0x00e00000 cbq_stat QUED Cache block 0x40230010 is currently cbq_cbdata being copied This can be deduced from blno 0x40230010 cbq stat QUED 88 tp iocc gt 0 amp amp c bcnt 0x01000000 tp iocc lt bcnt 4 4 48 Utility Reference 6 00028 01 Rev A Managing the 5 File System 5 logger The 1 1ogger utility allows you to redirect messages to a location other than to the system log Options usr amass utils 1 logger u n pathname filename p priority t location Option Description u Usage statement n pathname Specify path to the redirected 1ogs directory defaults to Cmp filename Specify a name for the redirected file p priority Specify the priority level of message you want to redir
20. Make sure the Backup Volume is in the correct drive in the library If there is another volume in the drive return it to its home slot by using the following utility The user must be amass Use this utility only when AMASS is not running su amass Password usr amass daemons amassrecovery s where Option Description Performs the following actions Prevents system startup Performs file recovery Returns media to its home storage slot Step 12 Restore the AMASS File System Database and journal by entering the following command usr amass bin amassrestore u Step 13 dbcheck utility again as described above 6 00028 01 Rev A Troubleshooting Tools 15 Managing the AMASS File System AMASS Does Not Start AMASS does not start To correct perform the following steps Step 1 Loginas root Step 2 Use amass script to display the system log messages For more information on this script see log on page 4 7 Make sure the messages being looked at are for the current time period Review prior messages to determine if any errors indicate the cause of the problem For additional information regarding messages refer to Errors and Corrective Action Step 3 After performing corrective action start AMASS using amass start For more information on this script see amass start on page 4 10 Step 4 Ifthe problem persists or
21. Partial backup with the verbose option Check the system log for a Backup was successful message 2 8 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Replace a Full Backup Volume AMASS issues a warning message when the Backup Volume is almost full If you receive a 95 full message before a backup starts initialize a new Backup Volume and perform a full backup as described in the following table However if you receive a 953 full message while a backup is in progress the backup procedure may fail in which case you must rerun the procedure with a new Backup Volume For detailed information on the commands used in these steps see the Command Reference chapter Command Description Log in as amass Or root After you have unloaded a full Backup Volume by entering the following command store the backup volume in a safe place The volume number of a Backup Volume must be number 1 voloutlet 1 Step 3 Command Description To continue see Prepare Media to be the Backup Volume on Page 1 3 6 00028 01 Rev A Operational Tasks 2 9 Managing the AMASS File System Restore AMASS Database To restore the AMASS File System Database and journal if the original files on the UNIX server becomes lost or corrupt use the procedure in the following table To recover the AMASS File System Databas
22. aa eds Ls 3 150 Verbose Sumas M as viis 3 151 Nonverbose Example 2226s ost pst ped ee bs 3 152 Iniode Example se vb ERR VIRI Bae Sa ea Spee ea E ees 3 154 File Names Last Example Ie E DUNS ESO ERR eh 3 155 Practical Application ed o ed oc Nr ek ease 3 156 tq eee Past ute Casos e M d ded Ne Ac paw dr ete carte tao 3 158 Ea OUS Pa doa dei Bate eq ed dad bodie 3 158 ODEHOPS Les ee C Sota wh uie uat C aaa 3 159 Format New Volume 3 162 Block SIZE nated aca E E 3 164 xvi Contents 6 00025 01 Rev A Accessing Storage Devices Configure Compression 3 164 VOIGTOUD 2 id eh fees etos che du etu CE Voies Ti VERE eee 3 166 OPUONS da e P Pe vrbes rb were is 3 167 Change Volume Group Number 3 168 Assign Volume to Space 1 3 169 Voineasa e Gack a 3 170 e Kat ee mek OVE e a Bc dd 3 170 Load a Vol m irem etie on Oe e EOE 3 171 vollabel Sind cid n xod t Sha EGON DE d PAARE AC RB nS 3 173 OOUONS Sd e Ce esu batur Sa qb 3 173 Change Volume L
23. filename Enter the full path to file you want information on For example archive directorylfilename 6 00028 01 Rev A Command Reference 3 79 Managing the AMASS File System File States A file in the AMASS file system can have the following states State Description Located The file is totally stored on media there are no dirty cache blocks in the AMASS IO cache NOTE The file may also be completely or partially residing in the AMASS cache because of a read or write IO request Not The file has one or more dirty cache blocks in the Located AMASS IO cache NOTE Overwrites or appends will cause a file to be considered not located because there will be dirty cache blocks associated with the file Examples Following are examples of the output generated by using the fileonmedia command fileonmedia v archive amass412 getstart fm6 getstart fm6 is NOT LOCATED on media fileonmedia v archive amass412 sitetasks fm6 Sitetasks fm6 is LOCATED on media 3 80 Command Reference 6 00028 01 Rev A Managing the AMASS File System healthcheck Test several AMASS components The command does not correct any malfunction that it encounters it just advises you that a test failed Run the healthcheck command on a quiescent system otherwise the tests may fail because of a lack of available drives lack of write resources or the inability to exclusively lock the File System Database
24. 6 00028 01 Rev A Utility Reference 4 3 Managing the AMASS File System Scripts in usr amass tools The following AMASS scripts help to identify and resolve operation problems Operation Script Page amass atboot 4 5 amass log 4 7 amass snap 4 9 55 start 4 10 amass tests 4 12 install tests 4 16 killdaemons 4 22 4 4 Utility Reference 6 00028 01 Rev A Managing the 5 File System amass atboot Define status of AMASS startup commands Options usr amass tools amass atboot de Option Description no option View current status of AMASS at reboot d Do not start AMASS upon reboot e Enable AMASS upon reboot Example Step 1 Login root su root 6 00028 01 Rev A Utility Reference 4 5 Managing the AMASS File System Step2 If AMASS is hung disable AMASS at reboot by entering the following path script name and option cd usr amass tools 4 amass atboot d Step 3 Reboot the system 4 6 Utility Reference 6 00028 01 Rev A Managing the 5 File System amass log Redirect the AMASS system log messages to the console AMASS sends messages to the system log For a numerical list of AMASS system log messages and corrective action refer to Errors and Corrective Action When to Use Script For an example of when to use this script see e AMASS Appears Hung on Page 3
25. HighSierra ISO 9660 e Rockridge an ISO 9660 format with extensions Space pool SP and cleaning CL volumes cannot be imported AMASS does not support writable CDs Optional Feature Optional Feature Enable this optional feature with an authorization string obtained from ADIC To request a string refer to the Site Specific Tasks chapter in nstalling AMASS Prevent Mount of Internal CD Drive To prevent the server from mounting an internal CD drive perform the following steps 3 50 Command Reference 6 00028 01 Rev A Managing the 5 File System Solaris Step 1 Use the UNIX vi editor or a similar product to edit the etc vold conf file Step2 Comment out the internal CD drive entry as shown in the following illustration The entry with the asterisk in the name identifies the internal CD drive Replace that entry with an entry for a supported external CD drive name Devices to use fuse cdrom drive dev rdsh c s3 dev cdrom so cdrom d use cdrom drive dev rdsh dev cdrom so use floppy drive dev rdiskette 0 9 dev floppy so floppy d Use a pound sign to comment wiidcard name c s2 with out the line containing the the specific name of the internal CD wildcard name with the asterisk drive for example cOt6d0s2 Step3 Reboot the Sun machine for the changes to take effect IRIX Step 1 Use the UNIX editor vi or a si
26. Managing AMASS File System 3494 interface c eps 3 42 init element Utility 23 2 22222 42445 4 26 initamass 4 64 initjournal Utility 4 65 install_tests 5 4 16 Internal CD drive prevent mounting 3 50 ISSUB S nce cheeses d 5 5 J Journal backup d Qo M ERAS 2 3 K keybuild A705 Ae acier ROVS 4 66 killdaemons 4 22 L Library function not as expected 5 28 Library Manager LMCPD interface rub 3 42 M Macintosh 5 5 MAXIOSZ EN 2 37 Media also see Volume os to vas 2 2 back up oce Rex 2 14 backup sve ear 1 3 database entry 1 9 Index INX 3 Managing the AMASS File System Offline 4i o5 pe ERE UBEYOIB oot ota ito redundant for backup remove from library return to ere ee oo RS mediaeject mediaerase Utility medialist mediamove Utility c2 s mediaread Utility os mediawrite Utility eae a Sa Modify Backup Schedule N Network attached Library load 3 34 Numeric Volume Group Media Taco e roter oe pios Offline Operation ISSUES 2 oot UR aded pb Optional Feature a
27. d RD Nu we eed Sees 3 27 Examples aca 5d pute du pasa dta 3 28 astats Output Fields Defined 3 28 astats se Output Fields Defined a2 2a n ed rea yet iio 3 30 astats j Output Fields Defined 3 31 astats v Output Fields Defined 3 32 astats w Output Fields Defined 3 33 gh 3 34 Network Libres a Nae f qud ts t 3 34 das So ortus du eic utra d Mer 3 34 Options De ee bo EO eo ale nci dm PA fen wince 3 35 Load New Volumes s teo Xam PUR wm Eoo etes 3 36 opatulusior Eibraries SS IPEA ERR we a te RO EIE 3 37 Uns ccesstul loads ee a DEAS 3 38 Options Sap osa e epu au o ie adus ted d a 3 38 Reload Existing Volumes ove oes Eit d er road wie ERU 3 39 Dalblosu Mesh mp LAM d fc em t 3 41 Supported Network Libraries 3 41 PED PERDER E 3 41 Library s custos pd veto exe ed dete mo oa isla icut s 3 42 ODBIOTIS s oL ots eal UH LCS ERU GP Mew Kaos vex C uM 3 42 Create Entries for Existing Volumes
28. touch filename the file is not associated with a volume or volume group This command will ignore such files However a zero length file i e a non zero length file that was written to tape and then truncated to zero length will be recognized 3 146 Command Reference 6 00028 01 Rev A Managing the 5 File System Options usr amass bin voldelete uy volumenumber Option u Description Usage statement Suppress interactive messages volumenumber Unique number of volume to be deleted Additional Information For more information on deleting a volume see Delete Files and Volume Number on page 2 18 6 00028 01 Rev A Command Reference 3 147 Managing the AMASS File System voldir View All files on a volume Files that span media are marked with an asterisk e Time and date the file was last accessed If you create a zero length file within an AMASS directory ex touch filename the file is not associated with a volume or volume group This command will ignore such files However a zero length file i e a non zero length file that was written to tape and then truncated to zero length will be recognized Options usr amass bin voldir u volumenumber 3 148 Command Reference 6 00028 01 Rev A Managing the 5 File System Example Option Description u Usage statement volumenumber Enter th
29. 5 File System Step 2 Enter the path and script name cd usr amass tools amass tests Step 3 Because the utilities are operator interactive they use standard in stdin and standard error stderr Lists are written to standard out stdout which you can redirect to either a file or a printer 6 00028 01 Rev A Utility Reference 4 15 Managing the AMASS File System install tests Performs the following tasks e Test storage device hardware Modify AMASS startup script to automatically start AMASS at bootup uses the amass atboot script Runtheamass start script e tests script When to Use Script For an example of when to use this script see e AMASS Does Not Start on Page 16 e Library or Drive is Nonfunctional on Page 28 Options 4 16 Utility Reference 6 00028 01 Rev A Managing the 5 File System Prerequisites Option Description u show usage b do not enable AMASS at boot See AMASS at Boot description d bypass drive load tests WARNING this should only be used if no drive changes have been made n do not start AMASS upon completion Before running this script the following conditions must be met e AMASS must not be running when you run install tests The drives must be empty but Active e At least one tape or optical platter must be in a home storage slot this volume should be the Backup
30. AMASS gives each piece of media a unique volume number for example 33 cdimport Import a CD that already has data on it volinlet Load volume 33 through the mailbox 6 00028 01 Rev A Initial Setup Tasks 1 9 Managing the AMASS File System Step Command Description For example volinlet 33 NOTE Not applicable for volumes destined for libraries without a mailbox vgimport Import metadata file for volume that already has data on it NOTE Must have used vgexport to export metadata file volloc Mark the volume 33 ONLINE n in the AMASS File System Database For example volloc n 33 NOTE Not applicable for volumes destined for libraries without a mailbox 1 10 Initial Setup Tasks 6 00028 01 Rev A Managing the 5 File System Step 2B Command Description For network attached libraries bulkinlet For example bulkinlet 4 Create an entry in the AMASS File System Database for each volume If desired assign a volume to a volume group 4 Load multiple volumes through the mailbox AMASS Gives each volume a unique volume number for example 34 Marks all volumes ONLINE in the AMASS File System Database vgimport NOTE Must have used vgexport to export metadata file Import metadata file for volume that already has data on it vollabel For example vollabel 1264
31. Amount of space in MB available on the volume NOTE AMASS assumes a compressed capacity of 2 1 ratio but some newer drives may have a compressed capacity of 3 1 Consequently the capacity displayed by the vollist command after a volformat will currently show a 2 1 native GB capacity Dead Amount of space no longer referenced by files Expressed as a percentage of the total volume space the higher the percentage the greater the amount of dead space NOTE Volumes with high percentages are good candidates for the volcomp process Errors Number of errors on this volume Field For volumes in the cleaning group CL Description Current Usage Number of times a cleaning volume has been used Max Usage Maximum number of times a cleaning volume may be used Clean Time Amount of time in seconds a cleaning volume will remain in a drive 3 182 Command Reference 6 00028 01 Rev A Managing the 5 File System Flags Defined The following table describes the Active Inactive Online and Offline values a volume can have in the Flag field Active Online Volume is in library AMASS can read and write to volume O Offline Volume is not in library AMASS can read and write to volume with Offline Media Manager OMM For OMM information see Read Offline Volume on page 2 25 l Inactive Volume is in library
32. CL for the volume group vollist g CL NUM JUKE POS LABEL 49 1 NET clean 1 volumes in volume group FLAGS USED AVAIL DEAD IU CL Cleaning volumes always have the flags I inactive and U unformatted ERRS 0 0 0 0 3 64 Command Reference 6 00028 01 Rev A Managing the 5 File System Step 5 Step 6 Step 7 Standalone drive only Because we are using a standalone drive we need to run the Standalone Operator Interface so enter the command in the following illustration For more information about this interface Interface to Standalone Drives chapter in Accessing Storage Devices To manually start drive cleaning process enter driveclean V 49 1 where Value Description V 49 Cleaning volume number 1 Dirty drive number Standalone drive only The sysop interface returns the following message that prompts you to load the cleaning volume OPERATOR LOAD VOLUME REQUEST Please load VOLUME NUMBER 49 LABEL cleaner into JUKEBOX 1 DRIVE 1 after cleaner has been loaded press return or IF INCORRECT VOLUME enter eject or TO ABORT REQUEST enter abort 6 00028 01 Rev A Command Reference 3 65 Managing the AMASS File System The drive ejects the cleaning volume after the specified amount of time 120 seconds in our example has elapsed To exit the sysop interface use lt Control C gt Step8 After cleaning use
33. Managing the AMASS File System AMASS Version 5 3 August 2002 6 00028 01 Rev A Trademark Notice ADIC AMASS CentraVision DAS DataMgr FileServ and VolServ are either trademarks or registered trademarks of ADIC Advanced Digital Information Corporation other product names and identifications are trademarks or registered trademarks of their respective owners Copyright Notice Copyright 1996 2002 by Advanced Digital Information Corporation rights reserved This document is the property of ADIC No part of this document may be reproduced transmitted transcribed stored in a retrieval system or translated into any language or computer language in any form or by any means electronic mechanical magnetic optical chemical manual or otherwise without the express written permission of ADIC 11431 Willows Road NE PO Box 97057 Redmond WA 98073 9757 USA Phone 425 881 8004 FAX 425 881 2296 U S Government Rights Restricted Use duplication or disclosure of either the software or documentation is subject to restrictions set forth by the U S Government in FAR 52 227 19 c 2 and subparagraph 1 1 of the Rights in Technical Data and Computer Software clause at DFARS 52 227 7013 and or in similar or following clauses in the FAR DoD or NASA FAR Supplement Technical Assistance ADIC Technical Assistance Center Inthe USA and Canada call 1 800 827 3822 e Outside the USA and Canada call 303 874
34. TREAT VO 1 date time errnumber gid length date time mode name filename prid rid size uid volnumber volgroup 6 00028 01 Rev A Command Reference 3 13 Managing the AMASS File System Option Description no options Generate formatted report d Only list directories f Only list files P List files with an absolute path starting from mount point For example archive pubs amass v49 fileA R Generate raw report S Displays in the Last Accessed field and in the Last Modified field the time in seconds since 1970 a date time a date time a date time time defaults to midnight Only list files with a timestamp that shows when file was modified Ona specific date and time Enter for example a 01 01 1998 13 30 00 to select all files modified on January 1 1998 at precisely 1 30 p m earlier or later timestamp Enter a string that contains before or after gt relationship operator enclosed in quotes For example a 01 01 1998 13 30 00 selects all files modified before January 1 1998 at 1 30 p m Format for date is MM DD YYYY and the format for time is hh mm ss The date is required The date is required The time defaults to midnight For example a 01 01 1998 selects all files befo
35. e ADIC AML IBM 3494 Storage Technology Tasks The following tasks are valid for network attached libraries with multislot mailboxes Load multiple volumes through the mailbox Create entries in the File System Database for new volumes e Mark volumes Online in the Database 3 34 Command Reference 6 00028 01 Rev A Managing the AMASS File System Options For tracking purposes AMASS assigns each new volume a unique volume number Tip To create File System Database entries for volumes already residing in the library bypass the mailbox use the bulkload command usr amass bin bulkinlet uy volumegroup jukeboxnumber Option Description no option Load new media u Usage statement y Suppress interactive messages 6 00028 01 Rev A Command Reference 3 35 Managing the AMASS File System Option Description volumegroup Enter the volume group assignment for the media defaults to 0 you are loading Valid assignments are Anumeric value 1 through 2047 SP space pool A volume with files on it cannot be assigned to the space pool e CL cleaning group media verification group for the optional Infinite File Life feature jukeboxnumber Enter the library number where new volumes will defaults to 1 reside Load New Volumes Step 1 Log in as either amass or root su root Step 2 Place volumes in
36. usr filesysdb the AMASS journal home filesysdb jo urnal and the AMASS program files usr amass 2 12 Operational Tasks 6 00028 01 Rev A Managing the 5 File System Step Command usr amass utils initamass Description Change directory and reinitialize the File System Database CAUTION All file and directory entries as well as library drive and media information are deleted 6 00028 01 Rev A Operational Tasks 2 13 Managing the AMASS File System Back Up Media in Library Use UNIX Utilities There are a variety of ways to back up the data residing in the library Even though a library is involved the backup issues are fundamentally the same as for hard disks The main difference is the amount of data contained in the library The solution depends on the available system resources and the backup requirements of your specific environment The correct solution could even be a combination of the methods described below For that reason a step by step procedure is not included here Three ways of backing up media are described below One solution is to use conventional UNIX backup utilities for your media The practicality of doing this depends on the amount of data being written and the overall size of the library Performing a full backup against a large library takes a long time so incremental backups may be appropriate Use Both
37. 6 00028 01 Rev A Command Reference 3 91 Managing the 5 File System The option is used because there are existing files underthe amass unix directory and we want to force all new files to belong to volume group 1 The following figure illustrates that aix file a new file created after the setvolgrp assignment is assigned to volume group 1 The old hpux and sunos files remain assigned to volume group 0 Volume Group 0 archive Volume Group 1 projects Volume Group 2 amass unix Any new files created under archive or archive projects are assigned to volume group 1 as illustrated in the following figure Volume Group 0 archive Volume Group 1 E Volume Group 2 en projects datamgr amass unix 3 92 Command Reference 6 00028 01 Rev A Managing the 5 File System sysop Options System administrators must use the Standalone Operator Interface to have full read access and write access to media in standalone drives The standalone drive must be daisy chained to a library AMASS considers multiple standalone drives as one virtual library The Standalone Interface was automatically installed when you installed AMASS and is located in the usr amass bin directory Specify this directory in the system administrator s login PATH variable usr amass bin Sysop ckul
38. Command Reference 6 00028 01 Rev A Managing the AMASS File System Disable Feature for A Drive Succeeds In the following example we set the drive to zero timeout the idle eject feature will be disabled for the specified drive This example assumes the global IDLETIME parameter has been set to zero also drivestat e 0 1 Setting Idle Eject value for drive 1 juke 1 from 480 to 0 seconds OK y n y Drive 1 in juke 1 will not eject idle volumes feature disabled Disable Feature for A Drive Fails In the following example we set the drive to zero timeout but the idle eject feature will not be disabled This example assumes the global IDLETIME parameter has been set to 31 seconds drivestat e 0 1 Setting Idle Eject value for drive 1 juke 1 from 480 to 0 seconds OK y nl y Drive 1 in juke 1 will eject idle volumes after 31 seconds global idletime 6 00028 01 Rev A Command Reference 3 77 Managing the AMASS File System View Current Values To view a list of current values enter a question mark d drivestat e all DRIVE JUKE IDLETIME 1 1 480 2 1 0 3 78 Command Reference 6 00028 01 Rev A Managing the 5 File System fileonmedia Reports whether a file has been completely stored on media Options usr amass bin fileonmedia uv filename Option Description Usage statement V Verbose messages
39. Estimate 1 mb per 15 000 files This script uses the day of the month to index the appropriate file to be stored and must be executed every day HHH FSH HH ie S 2 J then echo Usage abackup vol group num num of MB exit fi DAYTYPE date d DAYTYPE 1 VOLGRP 1 NMEGS 2 NVOLUME 0 TEMPFILE tmp FILESSS MOUNTPT mount grep amassdev awk Cus COUNT 0 FILEINDEX 1 A 8 Backup Scripts for HP UX 6 00028 01 Rev A Managing the 5 File System gt TEMPFILE tmp BACKUPFILES cdi cd MOUNTPT if f etc archivedate then find newer etc archivedate print gt tmp BACKUPFILES echon 7 else gt etc archivedate iE aL iE 1 then bin mv etc archivedate etc archivedate AMASS gt etc archivedate rm tmp AMASSOUT usr amass bin vollist awk 2 VOLGRP print 1 7 while read disk megs do usr amass bin volfilelist Sdisk gt gt TEMPFILE COUNT expr COUNT megs if couNT ge NMEGS then COUNT 0 cat TEMPFILE sort 1n 2n awk prine I gt tmp AMASSOUTS FILEINDEX rm TEMPFILE FILEINDEX expr FILEINDEX 1 fi 6 00028 01 Rev A Backup Scripts for HP UX A 9 Managing the AMASS File System done if f TEMPFILE then cat TEMPFILE sort 11 2n awk print 1 gt tmp AMASSOUT FILEINDEX rm TEMPFILE fi el
40. For more information about IFL see the Infinite File Life manual Anumeric group through 2047 A space pool SP Acleaning group CL 6 00028 01 Rev A Initial Setup Tasks 1 13 Managing the AMASS File System The following figure illustrates these volume groups Numeric Volume Group volumes can be assigned to a numeric volume group The group can be a number from 1 through 2047 Volumes can be assigned to the space pool SP Space Pool These are formatted volumes with specific attributes When a numeric volume group runs out of space and it has been enabled to use the space pool AMASS automatically takes a volume with the same attributes from the space pool and assigns it to the numeric group that ran out of space Thus AMASS can continue to write data to the numeric volume group Cleaning cartridges are assigned to the cleaning group CL When drive needs cleaning AMASS selects the appropriate cleaning volume from this Cleaning Group d i Th Media verification group A volume assigned to the Media Verification media verification MV volume group consists of media verified as good for the AMASS Infinite File Life IFL optional feature P Uniform Media in Numeric and Cleaning Groups Both numeric volume groups and the cleaning group must contain a homogeneous type of media At a site using both WORM and erasable optical platters for exa
41. Return codes are described in the following table 6 00028 01 Rev A Command Reference 3 3 Managing the AMASS File System Return Code 1 error Description all other values success 3 4 Command Reference 6 00028 01 Rev A Managing the 5 File System adf Options View statistics for all volume groups in the AMASS File defaults to list the System Database usr amass bin adf u hrV Option Description h Display a message describing the output r View all relative paths for this volume group first path encountered in the Database u Usage statement V Do not print and underline the column defaults to print and underline column titles titles in the output Non printed column titles are useful if you generate reports with UNIX utilities like awk sort and sed 6 00028 01 Rev A Command Reference 3 5 Managing the AMASS File System Example Step 1 Log in as either amass or root su root Step 2 See an example of the output in the following illustration The r option lists 2 directories techpubs and swtest assigned to volume group 100 adf r Volume Group Size Used Avail Volumes Rooted On 128795 128700 48823 1 100 128795 11412 16274 3 3 101 39006 894 236529 1 104 78012 4426 57869 2 support Output Fields Defined The following fields are generated by this command Field D
42. When AMASS asks if you want to toggle the status type y for yes and n for no r Mark a specified volume group as Read Only u Usage statement wW Mark a specified volume group for both Reads and Writes y Suppress interactive messages volumegroup Enter the numerical volume group Valid values are 1 through 2047 3 126 Command Reference 6 00028 01 Rev A Managing the 5 File System vgroot View the directories assigned to a volume group If you have assigned more than one directory to the same volume group AMASS returns the relative paths for all the directories The path is relative to the AMASS mount point the default is archive Options usr amass bin vgroot uy volumegroup Option Description u Usage statement y Suppress interactive messages volumegroup Enter the numerical volume group Valid values are 1 through 2047 6 00028 01 Rev A Command Reference 3 127 Managing the AMASS File System Example Step 1 Step 2 Step 3 Log in as either amass or root 4 su root To view the relative paths for files assigned to volume group 674 enter the command as shown in the following example The following output shows that two directories have been assigned to volume group 674 vgroot 674 techpubs mrktpubs The total count of roots for volume group 674 is 2 To assign the techpubs directory to another volume use the setvolgrp comma
43. it must be 352 bytes large Drive Inactive Checks for inactive drives Active Checks if all active volumes have a cartridge in their assigned home storage slot Messages Syslog Makes sure syslog daemon is running on the machine so AMASS messages are recorded Syslogconf Makes sure AMASS messages are sent to syslog Picker Getty Checks for gettys on RS 232 libraries 6 00028 01 Rev A Utility Reference 4 13 Managing the AMASS File System Group Test Name Definition System Amassuserid Makes sure AMASS user ID and group ID are in the password and group file Configdump Dumps configuration for debugging Daemons Checks to see if correct daemons are running Development Makes sure there is a C compiler and make function available Devicefiles Checks AMASS device files Fnodes Checks for a minimum number of fnodes Notmounted Checks to see if AMASS is mounted Null Makes sure dev null is a character device file Outoffnodes Checks to see if system is out of fnodes Owners Checks ownership of files in usr amass bin Volumes Compress Checks to see if data is being compressed Inactive Checks for INACTIVE volumes in volume volumes group Novgpaths Makes sure each volume group has a root path assigned to it Spaceavail Makes sure all volume groups have space available in them Example Step 1 Log in as root su root 4 14 Utility Reference 6 00028 01 Rev A Managing the
44. restore user files to an AMASS system Warning This process can take a very long time tmp BACKUPFILES and tmp TEMPFILE can be very large files cb dH cb cb HE Hb H day date w MOUNTPT mount grep amassdev 4 awk print 1 TEMPFILE VOLGRP 1 cd MOUNTPT ates eda 5 A 4 Backup Scripts for HP UX 6 00028 01 Rev A Managing the 5 File System then if f etc archivedate then bin mv etc archivedate 1221 gt etc archivedate TEMPFILE tmp FILESSS for disk in usr amass bin vollist awk 2 VOLNUM print 1 7 do usr amass bin volfilelist Sdisk done cat tmp TEMPFILE sort 1 2n awk print 1 gt gt tmp BACKUPFILES rm tmp TEMPFILE else find newer etc archivedate print V tmp BACKUPFILES 12 21 cat tmp BACKUPFILES ftio gt dev null end of Example script 1 6 00028 01 Rev A Backup Scripts for HP UX 5 Managing the AMASS File System Backup Example for Large File Systems The following script backs up data on large file systems Consequently a full backup completes over an extended period of time usually one month Step 1 Step 2 Step 3 On the first day of the month day 1 the script generates two lists Acomplete list of files list of files that have changed since the last complete backup The shell variable NMEGS determi
45. ssbackup fv 03 1 6 usr amass bin ama ssbackup v Description In our example we edit the file so The first line runs a full backup at 3 a m every Sunday The second line runs a partial backup at 3 a m all other days Monday through Saturday The edits are shown in bold 5 Save your edits 2 6 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Manual Backup Manually back up the Database and Journal under the following conditions prior to updating your operating system updating AMASS making any major change to your system replacing the hard disk on the UNIX server How to Use Backup Command To perform a backup with the AMASS command use the procedure in the following table For detailed information on the commands used in these steps see the Command Reference chapter Step Command Description 1 Log in as amass Or root 2 Make sure the Backup Volume is formatted and is the last home storage slot in the first library Moreover the Backup Volume must be volume number 1 and have an INACTIVE status 3 usr amass utils sysd make sure there has been bchk no database corruption 6 00028 01 Rev A Operational Tasks 2 7 Managing the AMASS File System Step Command amassbackup u Description As appropriate perform either 8 Full f backup with the verbose v option
46. this utility After running dchain rerun dbcheck on the affected database to make sure that all problems are fixed If successful reboot the system so AMASS can start To resolve 907 TAF log file errors database will not lock follow the suggestion in this step When you ran the 1m ip daemon in Step 3 it should have opened up a database lock file that looks similar to the following example Depending on your platform the permissions will vary ls la usr amass fslockl 1 amass other 0 Feb 4 08 42 usr amass fslock1 If the database lock file is missing manually start a lock manager daemon with the following command usr amass daemon 1lm a fslockl u 50 f 40 q 80 nd 10 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System Verify that the lock has been set by using the ls 1 usr amass fslockl command After the problem has been resolved rerun dbcheck on the affected database to make sure that all problems are fixed If successful reboot the system so AMASS can start Step 9 resolve 925 network layer errors follow the suggestions in this step Changing network settings on the machine running AMASS can affect AMASS ability to lock the database If this happens an error similar to the following example will be generated Raima Data Manager Version 3 21A Database Consistency Check Utility Copyright C 1985 1992 Raima Corporation All Rights
47. volprint a 6 VOL POS FLGS LASTPBN VOLSZ DEAD BLKSZ ERRS LABEL 6 B NET T 124 24821 0 512 0 Pics Output Fields Defined The following fields are generated by this utility Field Description Volume Number Unique volume number Volume Group Volume group assignment Position The home storage slot number Valid values are An alphanumeric value n a is valid for standalone drives NET is valid for network attached drives 4 74 Utility Reference 6 00028 01 Rev A Managing the 5 File System Field Flags Description Status of volume not volume group Volume is Active C Volume is being volcompressed or a volcompress procedure has aborted After volcompression completes the volume is marked Inactive Volume is Inactive e Reserved To clear bring AMASS down and back up O Volume is Offline Volume has been quick formatted NOTE This is valid only for optical media R Volume is marked as Read only This occurs as a result of either a write error that makes the media unwritable or a user has forced the media to be read only with the volreadonly command U Volume not formatted W Media type is WORM Last PBN Last physical block number used on the media Volume Size The number of blocks available 6 00028 01 Rev A Utility Reference 4 75 Managing the AMASS File System
48. 00028 01 Rev A Preface 5 Managing the AMASS File System Books The CD contains the AMASS books formatted as PDF documents The books described below are part of the technical documentation set AMASS Overview An introduction to AMASS Archival Management and Storage System Contains a glossary Accessing Storage Devices Alphabetically lists supported libraries and drives and provides AMASS specific operating information Describes how to use AMASS with standalone drives Installing AMASS Describes server requirements installation and troubleshooting procedures and configuration parameters Managing the AMASS File System Perform system administrative tasks with AMASS commands and troubleshoot problems with AMASS utilities and scripts Errors and Corrective Action Provides corrective action for system log errors Quick Reference Guide Summarizes commands and utilities To make corrections or to comment on AMASS publications please contact Technical Publications at techdocs adic com Contact Publications P 6 Preface 6 00028 01 Rev A Managing the 5 File System Related The publications described in the following table are created Publications and distributed on an as needed basis Related Publications Description Release Notes For each version of AMASS the Release Notes contain Summary of enhancements Describes Fixed problems Known problems
49. 0188 or toll free 00800 9999 3822 e Send e mail to support adic com Documentation Although the material contained herein has been carefully reviewed ADIC does not warrant it to be free of errors or omissions We reserve the right to make corrections updates revisions or changes to the information contained herein READER COMMENT FORM 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 response to ADIC Technical Publications 8560 Upland Drive Englewood CO 80112 FAX 303 792 2465 Email techdocs 9 adic com Question Circle One Information was complete Agree Disagree Information was easy to find Agree Disagree Information was easy to follow Agree Disagree Is there anything you especially ike or dislike about the organization presentation or writing in this manual Book Title Document Number Customer Name Telephone E mail Address Company Name Address City State Zip NOTES Preface Managing the AMASS File System NOTES P 2 Preface 6 00028 01 Rev A Managing the 5 File System Purpose of This Book Who Should Read This Book How This Book is Organized This book describes the management tasks commands utilities and troubleshooting tools used to operate AMASS and manage the AMASS file system This boo
50. 23 Managing the AMASS File System Step Command Description 5C If for some reason you manually remove a volume from the library volloc o volumenumber Mark the volume OFFLINE o in the AMASS File System For example Database volloc o 47 2 24 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Read Offline Volume Offline Media Manager OMM provides read access to volumes that have been removed from the library These volumes have a status of ACTIVE but OFFLINE in the AMASS File System Database AMASS supports only one stand alone drive configured for OMM AMASS does not support two stand alone drives configured for OMM Optional Feature Optional Feature Enable this optional feature with an authorization string obtained from ADIC To request a string refer to the refer to the Site Specific Tasks chapter in nstalling AMASS Prerequisites To access offline media the following items are required e Standalone drive daisy chained to a library Enable Offline Media Manager with an authorization string e When installing AMASS use the timeout parameter For information on this parameter refer to in Installing AMASS 6 00028 01 Rev A Operational Tasks 2 25 Managing the AMASS File System e Use the Standalone Operator Interface to monitor load requests For information on this interfac
51. 338652 There is 338 652 KB of space remaining on this volume 3 176 Command Reference 6 00028 01 Rev A Managing the AMASS File System vollist Options View attributes for One volume volumes volume group If you think there may be a discrepancy between what is in your library and the File System Database or if you want to verify what is actually in the home storage slots use the medialist utility For instructions on using this utility see the Troubleshooting Tools chapter By default the view will not include cleaning attributes unless specifically requested with the g CL option usr amass bin vollist uy g volumegroup volumenumber 6 00028 01 Rev A Command Reference 3 177 Managing the 5 File System Option no options Description View attributes for all volumes TUE Usage statement pA Suppress interactive messages g volumegroup View attributes for the specified volume group Valid volume groups are Numeric value 1 through 2047 SP space pool e CL cleaning group NOTE By default cleaning attributes will not display unless specifically requested by entering g CL media verification group for the optional Infinite File Life feature volumenumber View attributes for specified volume Reset to Zero Use the setvolerr command to reset the error counts reported by the vollist comma
52. 4 9 Examples doge tier pus ve dE DASS oe be dator Deu 4 9 amasssStatb ca soar et Ea Ae RR EC pue E aeo ER 4 10 When to Use ie Sele E EATER 4 10 1 4 10 amass tests Pea e este pe dad aaa ES PNE 4 12 Prerequisites RES ThE DX IHE qeu DARE PASE Dad eias 4 12 When to Use script sacos arre tad tee a 4 12 install tests 6 koe arses eich tse rue dot cea ctae 4 16 When to Use Script S eiat ove vies qi et red edat 4 16 ODHOLS d bap e Or pedet dec do epi o a v ael a do s 4 16 Dl tetequisiles i o La Gn Sc Fe oe 4 17 List of Hardware Tests 4 18 User Defined Test Volume Capability lad RES 4 20 KU ACTORS P oo ete ta iaren BE aa vio S4 4 22 Whendo Use 4 24264 ond etu se Se etwaige 4 22 OPHONS v eds peior dn C ERI IIIS ad wee Ieee Sats 4 22 Pxample xe 244648 cesi add esconde tub 4 23 Hardware Utilities in usr amass Utils 4 25 init element e at RD ods SEAS Dares 4 26 DEGrequistl6s kad niin 8 orca avin aces oo gala ad 4 26 ODUONS 0 euam doe PX CP
53. 52696 Log in as root su root Enter the path and utility as shown in the following example cd usr amass utils quedisplay For help in reading the output see Prepare to Contact Technical Support on page 32 The output looks similar to the example shown in the following example Record is located on volume 3 fptr 0xf0227c5c fnode flags 0x110 VOLUME vid 7 num reads 0 num writes 30 WRITEO rid 79 fptr 0xcOOeff54 1 5 fnode flags 0x8048844 RESCHEDQ rid xx fptr xxxxxx vol x fnode flags xxxxx ADMIN JUKEBOX gt JUKEBOX was issued on volume 32 flags 0x6 v01 32 juke 1 DRIVE 1 19 324 vfilag 0x100 DRIVE 2 no volume in drive A volformat command cmd 1 ftype z0 err 0 pid 1047 atus 0 Process ID The last two entries are a list of libraries drives and corresponding volume 105 6 00028 01 Rev A Utility Reference 4 47 Managing the AMASS File System Output for streaming tape I O quedisplay c looks similar to the example shown in the following example quedisplay c VOLUME vid 7 num reads 0 num writes 30 The tp sblk and tp eblk fields are the start WRITEQO rid 27931 and eno archivo nevica bioos locations EDD ML fnode flags 0xb040804 equest Cache blocks The tp iocc field is the byte count associated with the cache block 0x04030c90 UNADJ cbque flink 0x04030c UNADJ cbque blink 0x04030c tp_sblk 0x0000260f
54. 55 Managing the 5 File System Option Description a databasename Check integrity of the AMASS File System defaults to usr filesysdb Database filesvN Enter one of the following vgdvN e filesvN Checks the files in the File System Database vgdvN Checks the volumes in the File System Database N Current version number of the AMASS File System Database NOTE Do not use the dbd file extension when running this utility Example Step 1 Login as root su root Step 2 From the AMASS File System Database directory enter the path utility and options similar to what is shown in the following example usr amass utils dbcheck a usr filesysdb filesv49 usr amass utils dbcheck a usr filesysdb vgdv49 4 56 Utility Reference 6 00028 01 Rev A Managing the 5 File System fileincache Report on the status of a specified file in the AMASS cache Exit codes follow Exit Code Description 1 Specified file is completely resident in cache 2 Specified file is partially resident in cache 3 Specified file is not resident in cache but volumes are online 4 Specified file is not resident in cache but volumes are offline 1 Error with a message to stderr Options usr amass bin fileincache uv fullpath filename 6 00028 01 Rev A Utility Reference 4 57 Managing the 5 File System Usage statement Description Verbose messages
55. 66 RAS 4 28 Inediderase ss eso etc 4 30 Are otra are Cum 4 33 MECIAMOVE asd iex anes 4 36 m diatead 4 30 4 41 piintjo rnal oues ded 4 43 1 4 45 s ende 4 68 VOI PRG iioc edet es 3 165 4 72 wrltecachemr 4 T Index INX 5 Managing the AMASS File System V vgexport Command 3 106 vgimport Command 3 111 vglist Command 3 117 vgpool Command 3 120 vgreadonly Command 3 125 vgroot 3 127 volclattr Command 3 129 volclean Command 3 132 volcomp Command 3 134 volcopy Command 3 138 voldelete Command 3 146 voldir Command 3 148 volfilelist Command 3 150 volformat Command 3 158 volgroup Command 3 166 volinlet Command 3 170 vollabel Command 3 173 volleft Command 3 175 vollist Command 3 177 volloc 3 184 volnew Command 3 187 volnote Command 3 191 voloutlet Command 3 194 volprint 4 72 volprint utility 3 165 volreadonly Command 3 196 volslot Command
56. 7 Transition the system to multi user mode or reboot the system Restore with Earlier AMASS Version To recover data on a Backup Volume containing a backup from an earlier version of AMASS make sure the current MAXIOSIZE parameter on AMASS is configured to the same value as when the Backup Volume was made For example your current Backup Volume was made when the MAXIOSZ value on AMASS was 256 KB This value should be physically noted on the volume Upgrade AMASS and change the MAXIOSZ value to 1024 KB Before attempting to read the Backup Volume return the MAXIOSZ parameter on AMASS to 256 KB 6 00028 01 Rev A Operational Tasks 2 11 Managing the AMASS File System Reinitialize Database To empty the existing AMASS File System Database and reinitialize it use the procedure in the following table All file and directory entries as well as library drive and media information are deleted For detailed information on the commands used in these steps see the Command Reference chapter Step Command Description 1 Log in as amass Or root 2 amassstat u INACTIVATE 1 the AMASS file system 3 Reboot AMASS using one of the following ways amass atboot Disable the automatic startup of AMASS For information on using this script see amass atboot in Chapter 4 Boot the system single user Be sure to mount the partition containing the AMASS database
57. 9 Volume Groups Defined 5 soso cies eee PATE D eae ees 1 13 Uniform Media in Numeric and Cleaning Groups 1 14 Disparate Media in the Space Pool oss ane see xen ea outa ed et 1 15 Using Numeric Volume Groups 1 15 Scenario assinet a Roa ed ee ha 1 16 Assign Directory to a Volume Group 1 19 Create a Cleaning Volume Group 2 1291 0495 eigen ewe eas San 1 20 6 00025 01 Rev A Contents ix Accessing Storage Devices Operational Tasks 2 Database and Journal Backups 2423 942595413942 tenia I EA EHE ALD eR hs 2 3 Automatic Backups Via Cron Job osse e eo ERR 2 4 ASSO Backup Vollmer rad peas veut boi 2 5 How to Modify Automated 5 2 5 Manual oe Dos T Elm pee EE HE bL ELE 2 7 How to Use Backup Command 2 7 Replacea Full Backup Volume iriser geniai aet a ne visa 2 9 Restore AMASS Database vee E NOD IUE 2 10 Restore with Earlier AMASS Version 2 11 R initialize Database iiS Ya Sog Y Vs tede Ead tr 2 12 Back Up Media Library S ier vex Et m ER win du dedi ove 2 14 Use UNIX EROS dersi S to p ed oc Ue elc e o coss 2 14 Use Both UNIX Utilities and AMASS Commands 2 14 Use Redunda
58. A LABEL user name JUKE n DRIVE nn MOUNT REQUEST VOLNO xxx SIDE A LABEL user name JUKE n DRIVE nnn 6 00028 01 Rev A Operational Tasks 2 27 Managing the AMASS File System Return Media Without Starting AMASS To return media in a drive to its home storage slot without starting AMASS perform the steps in the following table For detailed information on the commands used in these steps see the Command Reference chapter Step Command Description 1 su amass The user must be amass when running the amassrecovery Utility 2 usr amass daemons amass The s option returns recovery s media in a drive to its home storage slot 2 28 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Add Space to Volume Group To add space to a volume group so AMASS can continue to write to the volume group do one of the following Add volumes to the volume group e Create a space pool and enable the volume group to use the space pool so AMASS can automatically add volumes to the out of space volume group For volume group information see Volume Groups Defined on page 1 13 For detailed information on the commands used in these steps see the Command Reference chapter Add Volumes Step Command Description 1 Log in as amass Or root 2 volgroup Assign additional media to the For example volume group volgroup 42 121 Volume number 42 is as
59. AMASS File System Step 5 After the copy has completed AMASS returns the destination media to its original location In our example AMASS returns it to the standalone Because the copy procedure depends on the amount of data on the source volume the process can take as long as an hour to complete After starting a volcopy procedure do not attempt to kill the process with the 111 9 command If the verification process is successful unload the destination media mark it as a COPY and store it in a safe place Ifthe destination media is in the mailbox simply remove the volume However if the destination media 15 in a home storage slot use the mediamove utility to remove it from the library 6 00028 01 Rev A Command Reference 3 145 Managing the AMASS File System voldelete Delete e the files on a volume e Volume number from the File System Database Before a volume is deleted AMASS checks to see if any files exists on the volume and asks you to confirm their deletion If a file spans volumes designated by an append record AMASS deletes the whole file Before using this command mark the volume Offline with volloc and Inactive with volstat If the volume resides in the library outlet the volume use voloutlet for SCSI attached storage devices or bulkoutlet for network attached storage devices If you create a zero length file within an AMASS directory ex
60. Conventions m P 5 Core Dump 2594 conve px SP ur ae 5 23 Cron ure EN UN 2 5 scheduled 2 4 D Daemons AMASS 4 3 5 library 3 42 Database backup ait wet oa VOS Sdn 2 3 COMMPE ME X 5 6 entry 1 9 TE TWOEA ZO rev scite ento debo dona 2 12 IestOre E AI 2 10 2 11 dbcheek Uie iore EPIS ES 4 55 dicfilelist 3 56 Documentation Set P 6 6 00028 01 Rev A Drive function not as expected 5 28 Redwood tape length 3 103 return to 1 2 17 standalone interface 3 03 take out of service 2 16 Tabs aiani roaa e aede 4 46 driveclean Command 3 61 3 66 drivededicate Command 3 68 drivelist 3 70 drivestat Command 3 73 Dump Cote ete 5 23 E BHO secu eoi EBL 5 30 F File System activate and inactivate 2 33 oso Cesta lus 1 8 fileincache Utility 4 57 fileonmedia Command 3 79 filepath 4 59 fileprint 4 61 Files delete on 2 18 H healthcheck Command 3 81 HP backup script example A 3 Hung 5 3 6 00028 01
61. E EEA ER 4 74 Output Fields Defined Ri 4 74 lm PRSE D tente 4 77 OPHONS neos ad dade resent a Gate 4 77 5 5 Troubleshooting Tools 6 AMASS Appears HUNS cue E b ee oet Sede DE eg Dates ira 5 3 Cancel Outstanding Requests 4033 ay Edo a EE aO EUH FRA adr 5 4 Operating ISSUES eye CREO SA Ca QR OS Rui 5 5 AMASS Database is Bad usu uada rg ao gr Ka ER V Ge a ve Co cada 5 6 ANLASS Does Not Start v A PREX ONLINE IAN MV afe 5 16 UNIX Server s Partitions Crash DEP d EHE 5 17 It Journal Partition Crashes awe xx odit aee n Sard gees 5 17 If Database Partition Crashes 5 19 ache Partition Crashes aereo e Rt etes cirea whieh t bets 5 21 Requests Not Getting to Library S sar pd en EU S p E HE ds 5 22 System PANICS ach poe ete b oni wane ee ce e dra ods 5 23 SetUp fora Core DUMP ers sehen wesw ative 5 23 FP Na GAG LL RAY POE EGE S XXE VERAT ERE ES 5 23 MDB enda Gs eek Duce Dad Si Sey 5 24 and S n ce costoso de ede Ee a a Rohe ERE Ee e eI uA 5 24 Command Gives Unexpected Results ide tee iR ere e Re y 5 26 Library or Drive is Nonfunctional s sete taker Et 5 28 POW eb Failur
62. For more information on sysdbchk utility see sysdbchk on page 4 68 6 00028 01 Rev A Troubleshooting Tools 29 Managing the AMASS File System Messages Generated by AMASS AMASS generates the following types of messages e Operator Interactive Messages Technical Support Messages e Customer specific Messages These messages types are described below Operator Interactive Messages Because most AMASS commands and AMASS utilities are operator interactive they use standard in stdin and standard error stderr Lists are written to standard out stdout which you can redirect to either a file or a printer Technical Support Messages Technical support specific AMASS message appear under the usr amass 1ogs tac directory These messages are neither intended for customers nor are they documented for customers Customer specific Messages Customer specific AMASS daemon database kernel and operation messages appear in the usr amass logs parms file and are sent to the system log file for viewing by the AMASS system administrator They are sent to the usr amass logs tac file as well 30 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System These system log messages help you to assess system operation resolve problems check system health and monitor performance For location of the system log and corrective action for messages refer to Errors and Correcti
63. Managing the 5 File System Step 5 Check the integrity of the AMASS File System Database by running the dbcheck utility usr amass utils dbcheck usr amass utils dbcheck where usr filesysdb filesvN usr filesysdb vgdvN Option a Description Performs consistency check on Key access Key data Complete set Also performs a timestamp check for records and sets filesvN vgdvN Enter one of the following filesvN Checks the files in the File System Database e vgdvN Checks the volumes in the File System Database Current version number of the AMASS File System Database NOTE Do not use the dbd file extension when running this utility If dbcheck reports errors proceed to Step 6 Step 7 Step 8 or Step 9 Otherwise go to Step 10 6 00028 01 Rev A Troubleshooting Tools Managing the AMASS File System Step 6 To resolve database key errors run the AMASS keybuild utility Examples of these errors are illustrated in the following example key Tiele RD 15 errors slot 20 s record dba 0 30065 has invalid record id and or inconsistent dba key field RID 15 error has a missing key Run keybuild as follows usr amass utils keybuild usr filesysdb filesvN vgdvN where Option Description filesvN Enter one of the following vgdvN filesvN Checks the files in the File System Databas
64. NOTE Valid for StorageTek as a decimal value and a hexadecimal drives only value enclosed in parentheses 6 00028 01 Rev A Utility Reference 4 61 Managing the AMASS File System Option Description u Usage statement Print entry for the specified file Enter one of the following filename name Or AMASS database record ID rid number NOTE You must use the backward slash Y as an escape character so UNIX does not interpret rid asa comment r rid Or the rid number preceded by r Example Step 1 The following path and utility example displays File System Database information for a file named testplan usr amass utils fileprint archive testplan 4 62 Utility Reference 6 00028 01 Rev A Managing the 5 File System The output looks similar to the display shown in the following example FILE test plan rid amp d prid size 1048576 start blk 1 0x14000001 vol 2 Lene ES For StorageTek drives mode 8184 the start block links e t address is shown as a hexadecimal value enclosed in parentheses Step2 The following path and utility example displays the same File System Database information for the same file named testplan but instead uses its AMASS rid number usr amass utils fileprint 4 Or usr amass utils fileprint r 4 6 00028 01 Rev A Utility Reference 4
65. Not valid that includes these tasks for WORM Erases both sides of the platter because the Formats both sides of the platter volume cannot be Writes header information erased For tape Writes header information u Displays this usage statement Usage volformat b blocksize c onloff pquyd volumelist y Suppress confirmation and informational messages 6 00028 01 Rev A Command Reference 3 159 Managing the AMASS File System Option Description volumenumber Enter the unique volume number of the media you are formatting To list more than one volume separate the numbers with a space For example volformat 6 12 47 49 formats volumes 6 12 47 and 49 In addition to list more than one volume as a range separate the range of numbers with a dash For example volformat 6 12 47 49 formats volumes 6 7 8 9 10 11 12 47 48 and 49 You may combine the two ways to list single numbers and ranges For example volformat 4 6 8 10 12 47 49 53 formats volumes 4 6 7 8 10 11 12 47 48 49 and 53 Option Description For optical platters p force physical format NOTE Not valid for WORM because the volume cannot be erased q quick formats faster but writes are slower 3 160 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description For tape drives b blocksize
66. Pool Step 1 Log as either amass or root Step 2 To assign volume number 10 to the space pool enter the command as shown in the following example AMASS asks for confirmation of the process volgroup 10 SP Request to change volume group on volume 10 Old group is 1 New group is SP Is this information correct y nl y Volume 10 has been added to volume group SP 6 00028 01 Rev A Command Reference 3 169 Managing the AMASS File System volinlet Load previously defined volume through the mailbox and mark online Tip This command is valid only for SCSI attached storage devices This command is not valid for libraries without a mailbox Options usr amass bin volinlet uy volumenumber Option Description u Usage statement y Suppress interactive messages volumenumber Enter the unique volume number you want to load and mark Online in the Database 3 170 Command Reference 6 00028 01 Rev A Managing the 5 File System Load a New Volume Step 1 Log either amass or root Step 2 To make the initial entry in the File System Database and receive from AMASS a unique volume number use the volnew command Step 3 load volume number 33 in a library enter the command as shown in the following example AMASS prints instructions for putting the volume into the library This instruction line is specific to the library being used d su
67. Reserved Raima Data Manager database cues 925 errno 0 Database consistency check prematurely terminated Last db status 925 1 error was encountered in 0 records nodes 6 00028 01 Rev A Troubleshooting Tools 11 Managing the AMASS File System A Generate the PID of the 1m ip process by using the UNIX ps command ps grep 1m ip 915 1 0 3 5850c 53L 5 Os Oil usr amass daemons lm a 1 1 128 256 G 128 If the 1m ip process is running stop the process by using the kill 9 command with the pid option which is the number from the second column 915 shown in the above example kill 9 915 If the 1m ip process is not running manually remove the database lock 4 rm usr amass fslockl Recreate the lock with the 1m ip command usr amass daemons l1m ip a fslockl u 50 f 40 q 80 nd Reboot the server to reset the IPC sockets Rerun dbcheck If the problem still exists check the following items 12 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System Step 10 B Run ifconfig adapter and compare the inet address to the expected IP address Use the following table to determine the default primary Ethernet adapter Platform Adapter AIX HP UX lano IRIX eco Solaris 10 C If you are using Domain Name Service DNS is the DNS running D If you are using DNS is there a route to the DN
68. UNIX Utilities and AMASS Commands Another way to back up the media is to use AMASS commands and UNIX utilities to generate a sorted list of files contained on each volume in the library Then the sorted list can be directed to a backup An example of using volfilelist command to do this is described under Practical Application on Page 3 156 2 14 Operational Tasks 6 00028 01 Rev A Managing the 5 File System This solution provides faster backups than if the data is accessed randomly because it requires fewer volume swaps With this solution you can do full or incremental backups Use Redundant Media A third solution 15 to use a second set of media stored offline or outside of the library You can use the AMASS volcopy command to copy data from a source volume to a destination volume If the original volume is lost destroyed or damaged you can use the duplicate volume exactly like you would the original For more information on this command see volcopy on page 3 138 6 00028 01 Rev A Operational Tasks 2 15 Managing the AMASS File System Take a Drive Out of Service To take a drive out of service whether because of excessive failures or for maintenance use the procedure in the following table If all drives are out of service AMASS suspends requests until a drive 1s returned to service For detailed information on the commands used in these steps see the Comman
69. a similar command from LMCPD if you are using an IBM e StorageTek ACS run a similar command from the ACSLS Server if you are using a StorageTek ACS Run the bulkload s command to synchronize the File System Database to the library interface bulkload s 6 00028 01 Rev A Command Reference 3 45 Managing the AMASS File System Step 6 New volumes in the Database have an initial status of unformatted U and inactive I To make the new volumes usable define attributes and initialize the media with the commands listed in the following table Command Characteristic vollabel Enter the preprinted alohanumeric barcode label in the Database StorageTek Redwood tape drives only tapelength Enter the length of tape in the Database volformat Mark the volume Active Active allows AMASS to read and or write to media 3 46 Command Reference 6 00028 01 Rev A Managing the 5 File System bulkoutlet Tasks Options Eject multiple volumes to the mailbox and mark off line This command is valid for mutualist mailbox libraries only Tip This command is valid for both network attached storage devices and SCSl attached storage devices This command is valid for the following network attached libraries e ADIC AML BM 3494 Storage Technology The following tasks are valid for mutualist mailbox libraries e Eject multiple volumes e Mark volu
70. amass The user must be amass Step 2 Enter the following command sysop 6 00028 01 Rev A Command Reference 3 95 Managing the AMASS File System Step 3 The interface prompts you to load a volume into a specific drive The prompt always specifies a volume number a volume side and the volume label For example if a request requires you to load side A of volume number 2 text similar to the following appears OPERATOR LOAD VOLUME REQUEST Please load VOLUME NUMBER 2 SIDE A LABEL datavolume 2 into JUKEBOX 2 DRIVE 1 after VOLUME has been loaded press return or IF INCORRECT VOLUME enter eject or TO ABORT REQUEST enter abort Press RETURN when LOADED Step 4 exit the interface use lt Control C gt 3 96 Command Reference 6 00028 01 Rev A Managing the 5 File System sysperf View AMASS I O activity To exit this program use lt Control C gt Options usr amass bin sysperf cku filename updateinterval Option Description Display cache block queue information k Display kernel information u Usage statement f filename Log information to specified filename as well as to the screen NOTE This file output is suitable for importing the I O data into most spreadsheet programs udateinterval Enter how often in seconds AMASS defaults to 60 should update the information seconds 6 00028 01 Rev A Comm
71. cleaningtime volumenumber Option Description u Usage statement y Suppress interactive messages c currentusage Redefine how many times this cleaning volume has been used NOTE Use this option to prolong the life of a cleaning volume e errorcount Enter how many errors can be logged to this defaults to zero cleaning volume before AMASS refuses to use it NOTE Use this option to prolong the life of a cleaning volume 3 130 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description m maxusage Enter the maximum number of times this cleaning volume can be used even if the error count remains at zero t cleaningtime Enter the time in seconds that this cleaning volume should remain in the drive before AMASS stops the cleaning process and returns the volume to its home storage slot volumenumber Enter the unique volume number for this cleaning volume NOTE Only volumes previously assigned to the cleaning group can be entered 6 00028 01 Rev A Command Reference 3 131 Managing the AMASS File System volclean Prerequisites Delete the files on a volume but not the volume number from the File System Database This command is not valid for volumes in the space pool or in the cleaning group If you create a zero length file within an AMASS directory ex touch filename the file is not associated wi
72. compression values unless you request these values with the a option Name Contention hp Tru64 UNIX only Because AMASS and hp Tru64 UNIX both have a volprint utility make sure you use the full path to differentiate whose tool you want to use For example to use the AMASS utility enter it as shown in the following example su root cd usr amass utils volprint Or make sure your PATH variable has the usr amass utils volprint before the hp Tru64 UNIX usr sbin volprint 4 72 Utility Reference 6 00028 01 Rev A Managing the 5 File System Options usr amass utils volprint a u y volumenumber Option Description no options Display information for all volumes a Display both tape block size and compression values NOTE By default tape block size and compression attributes will not display unless specifically requested Usage statement y Suppress interactive messages but return a code as defined below 0 Active 1 Inactive volumenumber Enter the unique volume number 6 00028 01 Rev A Utility Reference 4 73 Managing the AMASS File System Example Step 1 Log inas root su root Step 2 display tape block size and compression values for volume six enter the path utility and options shown in the following example usr amass utils volprint a 6 The output is illustrated in the following example
73. drivenumber Inactivate AMASS will not use the specified tape drive jukeboxnumber defaults to 1 Enter the library number where the specified tape drive is located Following is an example of output generated by using no options drivestat DRIVE JUKE 1 1 2 1 STATUS ERRORS IDLETIME A 0 0 A 0 360 drivestat 2 drives configured in this system NOTE The displayed by the drivestat output is the per drive value not the global value The IDLETIME parameter configured during AMASS installation defines the length of time in seconds a drive will remain idle before AMASS will remove tape media from the drive This parameter affects all your drives For configuration information refer to IDLETIME in Installing AMASS NOTE Idleeject is not supported for optical drives 3 74 Command Reference 6 00028 01 Rev A Managing the AMASS File System The idle eject drivestat e secs drivenumber command will override the global IDLETIME setting on a per drive basis If the global IDLETIME parameter has been set to a non zero value although you can physically reset the idle eject value to zero with the drivestat command the feature will not be disabled The following figure illustrates how both the global IDLETIME parameter and the per drive drivestat command option affects your drives Per Drive drivestat e sec drive Command GlobAl IDLETIME Parameter D
74. e AMASS Database is Bad on Page 6 e AMASS Does Not Start on Page 16 e Requests Not Getting to Library on Page 22 e Command Gives Unexpected Results on Page 26 Options usr amass tools amass log w logfilepath 6 00028 01 Rev A Utility Reference 4 7 Managing the AMASS File System Option Description W Print messages to 120 characters wide defaults to 80 characters wide logfilepath Enter the pathname of the system log file The location of the system log file varies depending on the platform For the default path refer to Errors and Corrective Action Example Step 1 Login as root su root Step 2 Following the path and script name enter the path to your system log For default system log locations refer to Errors and Corrective Action cd usr amass tools amass_log var adm messages Because the log will probably have several days worth of messages Make sure the messages being looked at are for the current date and time For example on a Sun it is var adm messages 1 Step 3 Perform the action the message recommends Step 4 Ifthe problem cannot be corrected see Prepare to Contact Technical Support on page 32 4 8 Utility Reference 6 00028 01 Rev A Managing the 5 File System amass snap Collect system information after a problem occurs When to Use Script For an example of when to use this script see AMASS Ap
75. fail If you have more than one library configured for AMASS this test is done on each library Example Make sure all the libraries are connected to the system and running Step 1 Login as root su root 4 18 Utility Reference 6 00028 01 Rev A Managing the 5 File System Step 2 Step 3 Step 4 Step 5 Step 6 If AMASS is active inactivate it with the option shown in the following example For command information see amassstat on page 3 24 killdaemons f Enter the following path and script name cd usr amass tools 4 install tests The following output shows typical messages for a successful test of a new installation Script started File is typescript TESTS DRIVE TESTS PICKER TESTS PICKER Script done on Tue May 13 11 30 50 1997 Script started on Tue May 13 11 30 52 Script done on Tue May 13 11 35 00 1997 If AMASS passes these tests it automatically starts If AMASS fails these tests messages display on the console and are also sent to the system log For more information see start on page 4 10 If you do not have media in the library the script prints WARNING message indicating the library is empty Under these circumstances you can ignore this message 6 00028 01 Rev A Utility Reference 4 19 Managing the AMASS File System Step 7 For instructions on resolving other problems see amass log on pag
76. finished AsyncEjectPending eject of volume started e request to eject volume ForeignVol foreign volume FullVol volume is full e HeaderlInvalid volume is unknown to system header invalid e InactiveVol volume is not active OfflineVol temporary state used to reserve a volume before changing it state ReadonlyVol do not use the volumes for writes The following output is generated when the astats command is run with the w option su root 4 astats w Library Drive Type Volume State M 1 Tape 3 UnAvailable InUse Writing Write Verify 3 32 Command Reference 6 00028 01 Rev A Managing the 5 File System astats w Output Fields Defined Fields State Description Device I O mode flags BlankSearch search for blank write mode EraseWrite erase before write mode e FL ExtendedStatus get log sense data after each I O e FL Sup pressed Logging suppress IFL error logging WriteVerify write verify mode 6 00028 01 Rev A Command Reference 3 33 Managing the AMASS File System bulkinlet Load multiple volumes through the mailbox and mark online This command is only valid for multislot mailbox libraries Tip This command has slightly different meanings for SCSI and network connected libraries Network Libraries This command is valid for the following network attached libraries
77. is disabled reads Auto Clean If so no further action is required Press the Escape button until you reach the Status Display menu the initial screen However if the first line shows that automatic drive cleaning is enabled Auto Clean Y change the Y to an N with the navigation buttons Move to the ACCEPT N part of the screen by pressing Enter and change the N to a Y with the navigation buttons Save the changed cleaning state by pressing Enter Press Escape until you reach the Status Display menu the initial screen 6 00028 01 Rev A Command Reference 3 67 Managing the AMASS File System drivededicate Dedicate a drive s use to one of the following e Write Only e Read and Write Tip If your client applications use many write intensive applications dedicating a drive to Write Only may improve performance Options usr amass bin drivededicate uy dn drivenumber Uukeboxnumber Option Description no options View status of the specified drive When AMASS asks if you want to toggle the status type y for yes and n for no 3 68 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description d Dedicate the drive for Write Only requests NOTE If all drives in the library are marked as Write Only AMASS arbitrarily picks a drive for read requests n Mark the drive for both read and write request
78. options Start AMASS Recover files in cache it completes write operations These files were stranded in cache when AMASS was brought down Return media in drives to their home storage slots i Start AMASS Do not recover files in cache Do not start AMASS Recover files in cache Return media in drives to their home storage slots Example Step 1 Loginas root su root Step 2 If AMASS is active inactivate it as shown in the following example For command information see killdaemons killdaemons f 6 00028 01 Rev A Utility Reference 4 53 Managing the AMASS File System Step 3 Enter the path as shown the following example su amass Password usr amass daemons amassrecovery 4 54 Utility Reference 6 00028 01 Rev A Managing the AMASS File System dbcheck Test integrity of the AMASS File System Database This test can be time consuming because the following components are checked e Volume tables e Data tables e Key tables e Timestamp for records and database When to Use Utility Options For an example of when to use this utility see AMASS Database is Bad on page 6 AMASS must be shut down before this utility is run otherwise the tests will fail because of the inability to exclusively lock the AMASS File System Database usr amass utils dbcheck databasename filesvN vgdvN 6 00028 01 Rev A Utility Reference 4
79. root d volinlet 33 Place volume into inlet with side A up Step 4 After placing the volume in the mailbox AMASS asks for confirmation of the process d volinlet 33 Place volume into inlet with side A up Ready y n y Inlet operation completed If you are using the Standalone Operator Interface AMASS prompts you to put the volume in the mailbox 6 00028 01 Rev A Command Reference 3 171 Managing the AMASS File System Step 5 further prepare the volume so AMASS can read or write to it use the commands listed in the following table Command Description volloc Mark the volume Online in the Database NOTE Not valid for Online 2 media is in storage device libraries without a mailbox StorageTek Redwood tape drives only tapelength Enter the length of tape in the Database volformat Format the volume volstat Mark the volume Active in the Database Active allows AMASS to read and write to media 3 172 Command Reference 6 00028 01 Rev A Managing the 5 File System vollabel Reassign AMASS volume to media with a different label or change the volume label r Options usr amass bin vollabel uyr volumenumber newvolumelabel Option Description Change volume label after it was physically replaced on media Usage statement Suppress interactive messages volumenumber Enter the unique volume number whose label
80. s interface Besides creating entries and marking multiple volumes Online in the Database based on an inventory of the library AMASS synchronizes both the Database and the library s interface Because of the synchronization process this task takes longer to complete than using no options The status of a volume in the Database is based on an inventory of the library regardless of the entry in the library s interface For example if media is marked On line in the library s interface but the volume is not in the library AMASS marks the volume Off line in the Database volumegroup defaults to 0 Enter the volume group assignment for the media Valid assignments are A numeric value 1 through 2047 SP space pool A volume with files on it cannot be assigned to the space pool CL cleaning group media verification group for the optional Infinite File Life feature NOTE You cannot change assignments with this command To change an assignment use the AMASS volgroup command 6 00028 01 Rev A Command Reference 3 43 Managing the AMASS File System Create Entries for Existing Volumes You have just installed AMASS but your library already contains media known to your library s interface DAS You must introduce this existing media to the File System Database by performing the following procedure Step 1 Step 2 Step 3 Step 4 Log in as either amass o
81. shooting Tools Managing the AMASS File System NOTES 2 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System AMASS Appears Hung There is no AMASS activity including e drives in all libraries are inactive volumes are inactive To correct perform the following steps Step 1 Loginas root Step 1 amass_tests script to identify storage device hardware problems or AMASS problems For more information see amass tests on page 4 12 Step2 tests hangs or if a problem was not identified change to the tools directory and print the usr amass tools typescript file su root cd usr amass tools Also print the output for the following two scripts amass log amass snap For information on these scripts see the Utility Reference chapter Step 3 For help in reading these files see Prepare to Contact Technical Support on page 32 6 00028 01 Rev A Troubleshooting Tools 3 Managing the AMASS File System Cancel Outstanding Requests You can cancel an outstanding READ or WRITE request to the AMASS file system by using Control C which is the standard UNIX interrupt signal This can be used during normal AMASS operation When there has been a fatal error in AMASS the system administrator can cancel outstanding requests gracefully bring AMASS down and restart AMASS run amass_start without rebooting by using usr ama
82. test jasonfile The volume where the file resides must be Online and Active in the Database AMASS must be able to read the volume within 10 minutes or the test fails Option Description 1jukeboxnumber Test library components drivenumber e Fnter the library number volumenumber Enter the drive number Or enter O to test all drives Drive must be marked Active in the Database To prevent requests from using the drive while AMASS is running this test the drive is marked Inactive If all drives will be tested only one drive ata time is marked Inactive as it is tested thereby allowing the remaining drives to service requests continued 6 00028 01 Rev A Command Reference 3 83 Managing the AMASS File System Option Description continued Enter the volume number you want AMASS to 1 jukeboxnumber use for this test During the test data will not be drivenumber written to this volume volumenumber Volume must be formatted Volume must be marked Active in the Database To prevent requests from using this volume while AMASS is running this test the volume is marked Inactive Data on the volume must not span media Example Step 1 Log in as either amass or root su root Step 2 The following example runs all of the tests If a test fails AMASS will continue running the other tests A summary report 15 returned to the screen Tests the f
83. the AMASS File System Example Step 1 Log in as root su root Step 2 Because this utility modifies the AMASS File System Database first make a copy of the AMASS database usr filesysdb Step 3 Enter the path and utility shown in the following example usr amass utils sysdbchk The sysdbchk program creates a log file after each run containing all found errors The name of the file is sysdbchk log and is created in the current directory by default Sysdbchk uses temporary files to carry out its function By default these files are created in usr filesysdb tmp Use the c option to redirect temporary files to a specified directory This can also be done by using the environment variable SYSDBCHK CACHE DIR 4 70 Utility Reference 6 00028 01 Rev A Managing AMASS File System The following figure illustrates the hierarchy that is created because AMASS found a lost file named misplaced file The mountpoint is archive root archive usr home cache test files sales files Inode Number Directory Lost File Step 4 X For help in interpreting the sysdbchk output see Prepare to Contact Technical Support on page 32 6 00028 01 Rev A Utility Reference 4 71 Managing the AMASS File System volprint Display the attributes for one of the following One volume e volumes By default the attributes will not include block size or
84. to put the files that are currently on the imported volume For example if the source path is denver by default that is the path that will be used at the destination site If the imported volume exists under multiple directories use the p option for each directory For example to import the metadata for a volume that exists in both denver and texas directories use p denver p texas to correctly import the metadata AMASS prevents you from overwriting existing files For example if the path and name at the source site is denver filename same name exists at the destination site the import process will not complete 3 112 Command Reference 6 00028 01 Rev A Managing the 5 File System Example Option v volumenumber Description Enter the volume number not the volume group associated with the metadata file To list more than one volume separate the numbers with a comma or with a hyphen For example vgimport v 2 4 imports volume numbers 2 3 and 4 vgimport v 2 4 imports volume numbers 2 and 4 metafilepath Enter the user assigned path for the metadata you are importing Make sure this file has write permission enabled for either amass or public NOTE The metadata file is useless without the accompanying v volumenumber The following steps outline the same scenario we began with the vgexport command 6 00028 01 Rev A C
85. view the queue with the sysperf command To stop sysperf command use lt Control C gt sysperf Step3 bring AMASS down immediately enter the f force option usr amass tools killdaemons f Step4 to bring AMASS down in the specified number of seconds use the t seconds option killdaemons t 60 4 24 Utility Reference 6 00028 01 Rev A Managing the 5 File System Hardware Utilities in usr amass utils The following AMASS utilities help to identify diagnose and possibly correct hardware problems Hardware Utility Page init element 4 26 mediaeject 4 28 mediaerase 4 30 medialist 4 33 mediamove 4 36 mediaread 4 39 mediawrite 4 41 printjournal 4 43 quedisplay 4 45 51 logger 4 49 6 00028 01 Rev A Utility Reference 4 25 Managing the 5 File System init element Run the element status command that physically scans the library then updates the library s database not the AMASS File System Database Prerequisites Before using this utility e nactivate AMASS Make sure all operations have ceased on the library Options usr amass utils init element jukeboxnumber Option Description jukeboxnumber Enter the AMASS library number Example Step 1 Login as root su root 4 26 Utility Reference 6 00028 01 Rev A Managing the 5 File System Step 2 Enter the f
86. 0 01Mar182007 Volume Number File Name Logical Block Address 6 00028 01 Rev A Command Reference 3 155 Managing the AMASS File System Practical Application The following example uses this command to back up files in optimized order from a volume to a tape AMASS backs up entire files even if they span media Both scenarios assumes the AMASS mount point is archive Using cpio Command Step 1 Log in as either amass or root su root Step 2 Enter the commands as shown in the following example Lists all files on volume 2 Numerically sorts files based first upon volume then based upon logical block address ed archive volfilelist 2 n 1 2 awk print 511 N cpio oc gt dev rmt 0m a Backs up the files to a tape Prints just the file names loaded in drive dev rmt Om Step 3 When AMASS backs up partialfile which starts on volume 2 and is appended onto volume 3 AMASS switches the media in the drive to back up the remainder of partialfile on volume 3 AMASS then reloads Volume 2 so it can continue the backup process 3 156 Command Reference 6 00028 01 Rev A Managing the 5 File System Using tar Command Step 1 Log in as either amass or root su root Step 2 Enter the commands as shown in the following example Backs up the files to a tape loaded in drive dev rmt Om Lists all files on volume 2 cd archive tar cvf dev rmt 0m awk p
87. 03 Output Fields Defined The following fields are generated by this command Field Description Volume Group Volume group assignment Jukebox Number Reference number 3 118 Command Reference 6 00028 01 Rev A Managing the 5 File System Field Description Flags Status of volume not volume group full 2 space on volume group is full worm Media type rw Read and Write Media type cdrom Media type e SP space pool ro Read Only Volume Number of volumes assigned to the volume group Used Amount of space in MB occupied by files on the volume group Avail Amount of space in MB available on the volume group Field Description Appears only if the a option is used Block Size Tape s block size Compression Status Valid values are On default compression ON Off compression OFF Dflt status is undetermined because volumes are unformatted 6 00028 01 Rev A Command Reference 3 119 Managing the AMASS File System vgpool Define media for an out of space volume group to one of the following Use the space pool e Use specific media rewritable WORM tape CD from space pool Look for the space pool on a specific library or on any library When a volume group runs out of space if you have enabled it to use the space pool AMASS assigns a compatible volume fr
88. 3 vollist g 33 The output lists volumes 2 and 4 in volume group 33 3 vgroot volumegroup List the root directory of all For example subdirectories assigned to the specified volume group vgroot 33 Output lists the root directory and subdirectory for volume group 33 as win nt win nt amass win nt datamgr 4 setvolgrp pathname Reassign the root directory volumegroup amass nt so any new data To reassign the is archived to a different amass nt directory to volume group 49 volume group 49 instead of 33 enter setvolgrp amass nt 49 5 volgroup volumenumber Assign a volume 5 to a volumegroup For example volgroup 5 49 volume group 49 2 32 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Activate the File System To activate the AMASS file system which allows AMASS file system files to be accessed use the procedure in the following table For detailed information on the commands used in these steps see the Command Reference chapter Step Command Description 1 Log in as amass root 2 amassstat a ACTIVATE the AMASS file system Any operations that were queued will complete Inactivate the To deactivate the AMASS file system which allows you to File System perform maintenance without intervention by users perform the procedure in the following table Step Command Description 1 Log in as amass Or ro
89. 6 00025 01 Contents xxiii Accessing Storage Devices ODD HE 6 SCLCDWENE ds aiu WA 7 Options PUE eR rab ete pice gib Cea oppi en adt er C 8 e e VERUS ee oe tut bd s icta our d C 9 ebwghtlist 2245 Ee So EIER I Edu BAN EVA ap i C 9 OULU Aad eine ee Ead EA EE are d d C 9 Index xxiv Contents 6 00025 01 Rev A Initial Setup Tasks Managing the AMASS File System NOTES 1 2 Initial Setup Tasks 6 00028 01 Rev A Managing the AMASS File System Prepare Media to be the Backup Volume Slot Position Running the installation script created a Backup Volume entry in the AMASS File System Database To prepare media to be the specified Backup Volume perform the steps in the following table The Backup Volume must be identified as volume number 1 and have an INACTIVE status in the AMASS File System Database An INACTIVE status means that AMASS cannot read or write to the volume For detailed information on the AMASS commands see the Command Reference chapter AMASS assumes the Backup Volume is in either the first or last slot depending on the library therefore no slot designation is required If you have more than one library connected to AMASS put the Backup Volume in the last slot in the first library The Backup Volume in network attached libraries c
90. 63 Managing the AMASS File System initamass Clear the existing AMASS File System Database by reinitializing it to an empty database Typically this is done only for disaster recovery All file system data as well as library drive and media configuration is destroyed Options None Example Step 1 Loginas root su root Step 2 If AMASS is active run the command with the option shown in the following example For command information refer to killdaemons killdaemons f Step 3 To re initialize the File System Database enter the following path and utility usr amass utils initamass Prior to proceeding AMASS asks if you would like to continue 4 64 Utility Reference 6 00028 01 Rev A Managing the AMASS File System initjournal Example Clear the existing transaction log by reinitializing it to an empty journal Typically this is done only for disaster recovery All transaction logs are deleted Step 1 Step 2 Step 3 Log in as root su root If AMASS is active inactivate AMASS with the option shown in the following example For command information refer to killdaemons killdaemons f To initialize the journal enter the following path and utility usr amass utils initjournal Before proceeding AMASS asks if you want to continue After the journal has been initialized the queue is empty and AMASS reads the Backup Volume to restore the File Syst
91. 7NJK 34 AMASS enter the preprinted barcode 12647NJK in the AMASS File System Database for a volume number 34 6 00028 01 Rev A Initial Setup Tasks 1 11 Managing the AMASS File System Step Command Description 2C bulkload You have just installed AMASS For example and must create many entries in the AMASS File System Database and mark them ONLINE The s option synchronizes both the AMASS File System Database and the library s interface vollabel AMASS enter the preprinted barcode in the AMASS File System Database 3 For StorageTek Redwood tape drives only tapelength Enter length of tape in the AMASS File System Database for a volume number 4 volformat Format the volume 34 For example NOTE Not applicable for CDs volformat p 34 If you are using a standalone drive you must format the volume from the sysop interface For information on this interface refer to the Interface to Standalone Drives chapter in Accessing Storage Devices 5 volstat Mark the volume 34 ACTIVE For example so AMASS can read and volstat a 34 write to it 1 12 Initial Setup Tasks 6 00028 01 Rev A Managing the 5 File System Volume Groups Defined A volume group is a method for partitioning the volumes in AMASS You can assign the following types of volume groups Media verification group MV for the optional Infinite File Life feature
92. AD ERRS 49 1 NET 1 0 0 0 1 volumes in volume group CL Output Fields Defined The following fields are generated by this command Field Description Volume Number Volume number Volume Group Volume group assignment Jukebox Number Reference number Position Home storage slot Valid values are 4 Alphanumeric designation 0A12 SCSI attached storage device n a standalone drive e NET network attached storage device 3 180 Command Reference 6 00028 01 Rev A Managing the 5 File System Field Description Volume Label Either User assigned name Preprinted barcode Field Description Flags Status of volume For more Active volume used by AMASS information see Flags Defined on page 3 183 C Volume is being volcomped or a volcomp procedure has aborted Inactive volume not currently used by AMASS Reserved O Offline volume Volume has been quick formatted e R Volume is marked as Read Only This Occurs as a result of either 1 a write error that makes the media unwritable or 2 a user has forced the media to be Read Only with the volreadonly command U Volume not formatted W Media type is WORM Used Amount of space in MB occupied by files on the volume 6 00028 01 Rev A Command Reference 3 181 Managing the AMASS File System Field Avail Description
93. AMASS File System Step Command Description 4 volformat Reformat the now empty volume volumenumber NOTE Not applicable for CDs For example volformat 3 5 volstat a ACTIVATE volume so AMASS volumenumber For example volstat a 3 can read and write to it 2 22 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Remove Media From Library The following steps describe how to remove a volume after it has been written to by AMASS For detailed information on the commands used in these steps see the Command Reference chapter Step Command Description 1 When you installed AMASS you accept the default value for the omm timeout Offline Media Management parameter which is 120 seconds 2 minutes 2 Clients wrote files to a volume for example volume number 47 Log in as amass Or root volstat i volumenumber Mark the specified volume INACTIVE in the AMASS File F le or example System Database volstat i 47 For SCSl attached libraries voloutlet volumenumber Ejects the volume from the library AMASS marks it OFFLINE in the File System Database For example voloutlet 47 5B For network attached libraries bulkoutlet u Ejects multiple volumes from For example the library bulkoutlet 47 AMASS marks them OFFLINE in the File System Database 6 00028 01 Rev A Operational Tasks 2
94. AMASS cannot read or write to volume Volume is not in library AMASS cannot read or write to volume 6 00028 01 Rev A Command Reference 3 183 Managing the AMASS File System volloc Mark a volume in the File System Database as either e n Online Inside the library e Offline Outside the library Use this command if you had to use the mediamove utility to move a volume thus the File System Database did not get updated This command is not valid for storage devices without a mailbox Options usr amass bin volloc uy no volumenumber Option Description n Mark volume Online in the Database Online media is in storage device 3 184 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description Mark volume Offline in the Database and eject the volume from the drive Offline media is stored outside storage device u Usage statement y Suppress interactive messages volumenumber Enter the unique volume number Mark New Volume Online Step 1 Log either amass or root Step 2 make the initial entry in the File System Database and receive from AMASS a unique volume number use the volnew command Step 3 load the specified volume number in a library use the volinlet command Step 4 mark volume number 33 Online in the File System Database enter the command as shown
95. OD for tape or at a specified block number for optical media This utility destroys data on optical media Do not use this utility on optical media that contains data you want to keep Options usr amass utils mediawrite b blocksize drivenumber blocknumber jukeboxnumber Option Description b blocksize Enter the blocksize value in bytes kilobytes 10K or 10K or megabytes 10M or 10m drivenumber Enter the drive number that is writing to the media blocknumber Optical Enter the starting block address Tape Enter a number to be written into the block written to tape jukeboxnumber Enter the AMASS library number defaults to 1 6 00028 01 Rev A Utility Reference 4 41 Managing the 5 File System Example Step 1 Step 2 Step 3 Step 4 Log in as root su root To have drive two write to block six enter the path utility and options similar to what is shown in the following example cd usr amass utils i mediawrite 2 6 AMASS writes the following text to block number 6 A SECTOR OF DATA FOR BLOCK 6 If a hardware error occurs refer to your hardware manuals To verify the mediawrite was successful use the mediaread utility to read block six mediaread 2 6 4 42 Utility Reference 6 00028 01 Rev A Managing the 5 File System printjournal Options Print to stdout the contents of the journal which 15 the daily transaction log f
96. ONS ee IECUR CaN eae 4 26 dtr o LR ed swede eas 4 28 Race uat da e Ww DS aur Cac dans 4 28 Examples TE em Soter a e OUI d bb 4 28 m diaerase 24 ciat A od oce XU onerat st dea ata fot ctc 4 30 6 00025 01 Rev A Contents xix Accessing Storage Devices 25091455 D EA Ib sa tien rA ae Ead d es 4 30 Example Rx EUR LS 4 31 ep Eg ER eM CR us E 4 33 ies so EL pL dct ee 4 33 View Status for Elements 4 34 eaaa aaae EE EST II VE ER aaen ae aR A 4 36 OPHONS seule Va c e ce woh a Ro 4 36 1 OE reme ot oet pm qu EI M 4 38 inecHareddl i va ast db band TD D EAR A pad qud 4 39 Whento Use Utility sso deese Udo aie psa Tad dea 4 39 DIGS soto BS ir de Dei ea d ge CA quoi nau PISO EE oh meas 4 39 PCC IA Watt eene ha publics a Rod abate ie ict oot caro doo us 4 41 ope oder SO as dos ebat a ve gt 4 41 Dxample impe beste Lev ee oats win Se ae 4 42 DEIDUGUEDA Darei d 4 43 OPHONS we Pp xs gauge EQUI Kd M bd UU pd NO RU CM
97. Poe C putei Se ae DC Pai ee ied Ree 4 59 Example A Palate lente tices RESPIRARE RE 4 59 uil E Bm 4 61 OD WONS earned ter dro e Ate quo ed Mig voire Poi opta 4 61 a v abet da Ma 4 62 Sass ER RE ded eae go dut a d dee ed S sd e Eos 4 64 Min ob Bi aet Maw cb iris Se Aor Vad 4 64 DXample es ois gals Sascha eb eof dab eas purs HE Ux 4 64 inijo rnal xus coques prece du RE PO PHA QN EREMO Se eg wee as 4 65 arcane tree Soe ee En Ju tree DA Rear teas Vids 4 65 oua sus eot 3 uius sd ta a 4 66 When to Use DUE oeste ive oronim su vete rinde i bes nis 4 66 Options watt e sete o sehe oS oM 4 66 Example Si eas pean a eT eee ea eee Mies eee 4 67 sysdbehila Seas Can p RP OX EU bat Roe CAESA T Daal 4 68 WV hen Toskse L D ED es reda acis ex ced haod Gia aus erbe e 4 68 ODBODS xem devo FR vem doe p dede ese DECOR HN e dad 4 69 Example AMAN RASA CS ER LU ERE 4 70 ete Soo petu eae 4 72 4 72 sst x ado dedito testes cate De Do et oo o acd 4 73 6 00025 01 Rev A Contents Accessing Storage Devices Example tente PARUM EAE
98. S server E If you are using Network Information Service NIS is the NIS running 15 etc hosts file corrupted After the problem has been resolved rerun dbcheck on the affected database to make sure that all problems are fixed If successful reboot the system so AMASS can start If the AMASS File System Database reflects inconsistencies in the AMASS file system use the sysdbchk y utility to automatically correct any errors Enter the following usr amass utils sysdbchk y 6 00028 01 Rev A Troubleshooting Tools 13 Managing the AMASS File System Step 11 Rerun the sysdbchk utility without the y option to make sure that all errors have been fixed Examples of errors returned by this utility are illustrated in the following example file dir 771279 has pdir 771278 which is not a directory file 417631 is marked as APR but has no append header record If the above procedures are not able to fix the database problems restore the last backup of the AMASS File System Database with the amassrestore command However before using this command make sure the following tasks have been done e You have previously performed a valid backup with the amassbackup command e Make sure you have backed up your existing AMASS File System Database using a standard utility such as tar or cpio as instructed in Step 4 4 Troubleshooting Tools 6 00028 01 Rev A Managing the AMASS File System
99. Step 2 Using the previous example we request an inventory for home storage slot 01 in library number 2 cd usr amass utils d medialist s 0A01 j 2 The output is similar to the following example SLOT 01 EMPTY Because the output says EMPTY you would assume that home storage slot 0A01 is available However the media that is normally in slot 1 is currently in drive 1 We know this because of the output from the previous example that stated DRIVE 1 SCSI ID 5 FULL FROM 0A01 INVERTED 6 00028 01 Rev A Utility Reference 4 35 Managing the AMASS File System mediamove Library Description ADIC FastStor The AMASS medialist utility output displays FULL to indicate media in a home storage slot for SCSl attached libraries However on ADIC FastStor libraries the message says FULL FROM unknown so Move volumes from and to the locations listed in the following table From To mailbox mailbox drives drive storage slots transport storage slot transport When moving media from a drive mediamove will eject the media Options usr amass utils mediamove 4 36 Utility Reference 6 00028 01 Rev A Managing the 5 File System Source destination 0 1 jukeboxnumber Option Source Description Enter one of the following elements identified on the Source library XXXX Home storage slot or barcode x Drive numb
100. TES 34 Troubleshooting Tools 6 00028 01 Rev A Scripts for HP UX Managing the AMASS File System NOTES A 2 Backup Scripts for HP UX 6 00028 01 Rev A Managing the 5 File System Backup Example for Small File Systems The script below performs A complete backup every Friday day 5 of all the files in a specified volume group A partial backup every other day of the week Monday through Thursday of the files in the specified volume group that have changed since the last complete backup on Friday The script uses the volfilelist and vollist commands to generate a list of files in volume group Then it pipes this list to a UNIX backup command To perform a complete library backup run the script for every volume group in a library The size of the AMASS File System Database determines how much time is required for this backup bin sh abackup Purpose Store AMASS file system to tape Use abackup 2 to backup volume group 2 Input tup archtrvedate control file for backup modified during every complete backup VOLGRP the volume group to be archived from SM 6 00028 01 Rev A Backup Scripts for HP UX A 3 Managing the AMASS File System Shell variables TEMPFILE temporary location for file listing MOUNTPT the directory where the amass is mounted Output A set of tapes the can be used to
101. Tasks This command is valid for the following network attached libraries e ADIC AML BM 3494 Storage Technology The following tasks are valid only for network attached libraries Create entries and mark volumes Online in the File System Database under the following circumstances There are existing volumes in a network attached library at a site where AMASS has just been installed You manually load volumes directly into a network attached library 6 00028 01 Rev A Command Reference 3 41 Managing the AMASS File System Library Interfaces For tracking purposes AMASS assigns each volume a unique volume number To load new volumes through the mailbox use the bulkinlet command AMASS manages the network attached libraries through the library interfaces listed in the following table For specific library information refer to Accessing Storage Devices Library Library Interface ADIC AML Distributed AML Server DAS IBM 3494 Library Manager LMCPD StorageTek Automatic Cartridge System Library Software ACSLS Options usr amass bin bulkload s volumegroup 3 42 Command Reference 6 00028 01 Rev A Managing the 5 File System Option no options Description Create entries and mark multiple volumes Online in the File System Database based on an inventory of the library NOTE Use this option if you have not recently updated the library
102. Volume Just make sure this volume is not a cleaning cartridge because a cleaning volume does not return a tape loaded status to AMASS and thus install tests will fail If more than one client besides AMASS is sharing a drive through DAS for an AML the drive must be allocated to AMASS for install tests to successfully complete For instructions on configuring AMASS as a DAS client refer to Using DAS as a Library Interface in Accessing Storage Devices 6 00028 01 Rev A Utility Reference 4 17 Managing the AMASS File System List of Hardware Tests The script runs the tests listed in the following table These tests can take a long time to complete if the storage device is large Test ded Group Definition Name Picker Istat Performs library inventory and sees if it has changed Move Checks if picker can move media and read barcode label Drive Configured Checks if drives are properly configured AMASS makes sure each drive can move media by loading and unloading the last volume for SCSl attached libraries or loading and unloading the last barcoded platter for network attached libraries to the drive The last volume or barcoded platter is defined as what is listed by the medialist utility This last volume should be the Backup Volume Just make sure this volume is not a cleaning volume because a cleaning volume does not return a tape loaded status to AMASS and thus install tests Will
103. a usr amass utils astats chjuvw A s seconds Option Definition no options Lists the number of libraries configured the number of drives the media supported the volume ID of the volume in the drive and its status c Display device configuration flags h Do not display headers j Display number of libraries configured and their status u Usage statement v Display volume system flags W Display device mode flags A Equivalent to cjvw S seconds Scan and display the information in a loop after sleeping for a specified number of seconds 6 00028 01 Rev A Command Reference 3 27 Managing the AMASS File System Examples The following examples show the output generated by the command with various options to obtain information and status of the libraries configured along with the drives and media supported The output indicates the number of libraries number of drives type of media supported volume ID and the state of the library as well as of the media in the drive Following is the output when astats command is run without any option 4 su root astats Library Drive Type Volume State 1 1 tape 32 UnAvailable InUse Writing astats Output Fields Defined The following fields are generated with this command Fields Description Library Reference number Drive Reference number Type Drive Mode Flags CD ROM CDROM driv
104. abel 1 252 e ner Lb heb ied e 3 174 Soo Te tete is St S ed ak dat eder eti ied 3 175 IUE set des hdi ee pe due ob 3 175 EXAM DIC scien oad e we 3 175 E ma 3 177 soie Dp x Rex VOV tQ Od THEM Ce qa VO V CU qu 3 177 Reset toa TO VIRES ean de ets E DES 3 178 View Attributes Tor One 3 179 View Attributes for All Volumes 3 179 View Attributes for Cleaning Group 3 180 MO WOE beh sa miei uh a pti Sat bou ies Nie Ai 3 184 CIDBIOLIS aiaa Sadie Gee Pats Gad Rams PE Edu ODE CAT PEOR E Erba 3 184 Mark New Volume Online 3 185 puoi TP D IC T E PS 3 187 OPHONS Aia Pad Bd Dad 3 187 Create Database Entry for New Volume 3 188 RO OLE MC ease a aa ea ae a Ie ates 3 191 ODBODS stn chat alee wen acted ees 3 191 6 00025 01 Rev A Contents xvii Accessing Storage Devices Toe UA PEDE DIR CARERS Ok Teu iE DI et 3 194 Tasks 6 02505 3 194 ed bx bere 3 194
105. about this interface refer to the Interface to Standalone Drives chapter in Accessing Storage Devices The source volume must be Marked Online and Active in the File System Database In its home storage slot at the beginning of the volcopy process The destination media must be An unknown piece of media Unknown media does not have a volume number assigned by AMASS therefore the volume does not have an entry in the Database If you need to use media previously used by AMASS make sure you use the voldelete command to delete all the files on the media and to delete the volume number from the Database 6 00028 01 Rev A Command Reference 3 139 Managing the AMASS File System e Both source and destination media must be of the same type and have the same block size and capacity Tip Manufacturing variations make equal tapes have variable lengths Consequently AMASS does not check tape lengths before allowing you to do the volcopy process The system administrator must make sure the source and destination tapes are the same types However AMASS will check MO and WORM lengths Requirements are illustrated by the following figure Read Drive Source Media Media is known to File System Database Block size and capacity is same as destination volume Inlet and outlet the volumes with either the volinlet and voloutlet commands or the bulkinlet and bulkoutlet commands dependin
106. an be in any slot so a slot designation is required Step Command Description 1 Log in as amass Or root 6 00028 01 Rev A Initial Setup Tasks 1 3 Managing the AMASS File System Step Command Description Physically designate the media as the Backup Volume in some outward way See the following examples Write the words Backup Volume on the media Color code the media so it can be identified as a Backup Volume Make a note of either the home storage slot or the preprinted barcode and prominently display it Even though the Backup Volume is in the last slot such as slot 100 if you add an expansion bay with 50 additional slots you now have a new last slot slot 150 For SCSI attached libraries volinlet NOTE Not applicable for volumes destined for libraries without a mailbox Load volume through mailbox volloc NOTE Not applicable for volumes destined for libraries without a mailbox Mark the volume ONLINE in the AMASS File System Database 1 4 Initial Setup Tasks 6 00028 01 Rev A Managing the 5 File System Step Command Description For network attached libraries bulkinlet Create an entry in the AMASS File System Database Loads volume through mailbox AMASS Gives media a unique volume number e Marks the volume ONLINE in the AMASS File System Database Gives this first
107. and 3 132 Prerequisttes iiis e Le rw Rada Fax abra d e a EE US 3 132 CIDBODS dE NER o 4 eM mend bod rd 3 133 IO Gs ice piu 3 134 6 00025 01 Rev A Contents xv Accessing Storage Devices Prereqinedless 652202 Eod Sed REIS Ibo OM eid oA us d Eta 3 135 UDHORS xia oed eve t LE Gee ded E E ped e de ESS 3 136 Examples esee iden rt ved eie t 3 136 volcopys s cba PN ved itt ax s babel 3 138 Optional Feat re iios Rea news EU MERI RP PP e Pe 3 138 ose requie ocen t nT D VID OR EA Ed aUa id 3 139 Seco er en Ac a ee deas 3 141 Standalone e vara e vie e era 3 141 verde b ano E PR A Te tA Red pde du god es 3 141 Example e ku Eua uw ien deu dons 3 143 Voldelete v3 tte date que Ici nrc deas dui a che pn 3 146 Renee iud quid a ated eh ai 3 147 Additional Informatore m prec d e Uo E SOR e 3 147 Ue r co MET TT RU AR POOLE 3 148 ODBOUS Bie ade o 3 148 Example saw gets mace pede EAS han AS M EAA 3 149 Ts 5 Spoink reed ta 3 150 OpHONS 24 2 pode ha
108. and Reference 3 97 Managing the AMASS File System Example Output from the sysperf command is shown in the following table su root sysperf 5 k c SYSTEM STATISTICS Mon Feb 2 10 04 40 UPDATE INTERVAL 5 SUC AVERAGE THROUGHPUT 9216 KBYTES SEC READ REQUESTS OF VOLUMES 0 0 WRITE REQUESTS OF VOLUME GROUPS 3 CACHE BLOCKS 2012 2006 Total Free 2 Qued 2 Pend NFNODES 128 Total 126 Free JUKE DRIVE VOLFLAG VOLUME 1 1 4 6 Dirty 0 Done 2 Used VOLGRP KBYTES SEC 801 9216 3 98 Command Reference 6 00028 01 Rev A Managing the 5 File System Output Fields Defined The following fields are generated by this command Fields Update Interval Description How often in seconds AMASS updates the screen Average Throughput Number of KB transferred since the last snapshot This value first appears as a zero Read Requests Number of outstanding read requests Fields of Volumes Description Number of volumes associated with the request Write Requests Number of outstanding write requests Juke Reference number Drive Reference number 6 00028 01 Rev A Command Reference 3 99 Managing the AMASS File System Fields VolFlags For more information see VolFlags Defined on page 3 102 Description Status of volume Active volume used by AMASS e C Volume is being
109. appropriate operating system below Operating Task System IRIX Edit the system startup etc rc2 d S48savecore file with the following entry usr etc savecore OPTIONS dir Solaris Edit the system startup etc init d sysetup file with the following entry savecore dir 24 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System Step 3 After information has been dumped enter the following cd dir ls Step 4 dir directory should contain entries similar to those shown in the following example If more than one core has been dumped there will be files with extensions greater than zero The file with the highest number represents the latest core dump Operating A System Files in dir Directory IRIX bounds unix 0 vmcore 0 comp bounds unix 0 vmcore 1 comp Solaris vmunix 0 vmcore 0 vmunix 0 vmcore 1 Step 5 After determining the cause of the panic delete any core files with the UNIX rm command 6 00028 01 Rev A Troubleshooting Tools 25 Managing the AMASS File System Command Gives Unexpected Results A command gives an unexpected result To correct perform the following steps Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Log in as root Use the quedisplay utility to make sure the command is showing up in the queue For more information on this utility see quedisplay on page 4 45 Use am
110. apter Step Command Description 1 Log in as amass Or root voldelete volumenumber Delete all files on the specified volume and delete the volume For example number from the AMASS voldelete 9 database 2B voldelete Or delete all files on the specified volume without deleting the volume number from the database For SCSl attached libraries voloutlet volumenumber Eject the volume from the library AMASS marks the media OFFLINE in the database For example voloutlet 9 2 18 Operational Tasks 6 00028 01 Rev A Managing the 5 File System Step 3B Command For network attached libraries Description bulkoutlet u For example bulkoutlet 1 2 10 21 23 Or eject multiple volumes from the library AMASS marks the media OFFLINE in the database 6 00028 01 Rev A Operational Tasks 2 19 Managing the AMASS File System Delete Volume Group To delete a Volume Group use the procedure in the following table For detailed information on the commands used in these steps see the Command Reference chapter Step Command 1 Log in as amass Or root Description volgroup 9 0 2 adf u View directories and volumes For example assigned to the volume group that you want to eventually Sue m remove Make sure there is no information in this volume group that you want to keep 3 volgro
111. ass 109 script to display the system log messages For more information on this script see amass log on page 4 7 Make sure the messages being looked at are for the current time period Review prior messages to determine if any errors indicate the cause of the problem For additional information regarding messages refer to Errors and Corrective Action After performing corrective action try the command again If the problem persists or if the cause can not be determined through the system log run the amass tests script For more information on this script see tests on page 4 12 Check the script output for recommended corrective action After performing the corrective action try the command again 26 Troubleshooting Tools 6 00028 01 Rev A Managing the AMASS File System Step 7 Step 8 If the problem persists run the script command which prints a line similar to the following Script started file is typescript Try the command again After typing exit a line similar to the following is printed Script done file is typescript A file called typescript is created in the current directory that contains all the input and output of the command that is giving the unexpected results Print this typescript file For help in reading this file see Prepare to Contact Technical Support on page 32 6 00028 01 Rev A Troubleshooting Tools 27 Managing the AMASS File System
112. ber Option Description no options View status of the specified volume When AMASS asks if you want to toggle the status type y for yes and n for no r Mark volume Read Only u Usage statement 3 196 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description w Mark volume Read and Write y Suppress interactive messages volumenumber Enter the unique volume number 6 00028 01 Rev A Command Reference 3 197 Managing the AMASS File System volslot Options Change a volume s home storage slot in the File System Database but the volume is not physically moved This command can also be used to assign an offline volume to a standalone drive if you have Offline Media Manager OMM For OMM information see Read Offline Volume on page 2 25 Before using this command the volume must be Offline use the volloc command usr amass bin volslot uy volumenumber slot jukeboxnumber Option Description u Usage statement y Suppress interactive messages 3 198 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description volumenumber Enter the unique volume number slot Enter a home storage slot where you want the media to reside Valid slot entries are e 4 alphanumeric designation 0A12 SCSI attached storage device n a standalone drive NET ne
113. ce snake toe offline media manager VEOXPOM dar eoe d 3 VEHHBOD Ds 3 NOlCOBy 3 Out of space in volume Outstanding Request a oodd ed orden es INX 4 Index P Panic SYSE fi ay Ba Pee 5 23 Path usr amass bin 3 3 usr amass daemons 4 3 usr amass tools 4 3 usr amass u ls 4 3 for AMASS commands 3 3 for AMASS daemons 4 3 for AMASS scripts 4 3 for AMASS utilities 4 3 Pathname Limit 5 5 printjournal Utility 4 43 Problems 5 5 Product Alerts 7 Product 7 Publications Dept email 55 P 6 Q quedisplay 4 45 Reinitialize File System Database 2 12 Release 5 7 Requests v esu 5 4 not going to library 5 22 Restore File System Database 2 10 S Script 6 00028 01 Rev A AMASS 4 3 amass AtbooL tos 4 5 amass log lr rea t s 4 7 Snap so 4 9 amass Salli ak 4 10 ANIASS SLOSS es 4 12 HP backup example A 3 install tests soe ERR 4 16 kalldaemQons esed 4 22 SCSI attached Library load
114. col or something similar to send the newcustomers metadata file to Texas The following figure illustrates our example to this point in time 1 Export metadata that describes specified volume group 2 Unload volumes assigned to specified volume group Step 7 To continue see the vgimport command 3 110 Command Reference 6 00028 01 Rev A Managing the 5 File System vgimport Import data and attributes metadata file for a volume group from another AMASS file system Optional Feature Optional Feature Enable this optional feature with an authorization string obtained from ADIC To request a string refer to the Site Specific Tasks chapter in nstalling AMASS Name Contention HP UX only Because AMASS and HP UX both have a vgimport command make sure you use the full path to differentiate which command you want to use For example to use the AMASS command enter it as shown in the following example su root cd usr amass bin vgimport Or make sure your PATH variable has usr amass bin before the HP UX usr sbin vgimport 6 00028 01 Rev A Command Reference 3 111 Managing the AMASS File System Options usr amass bin vgimport uy p path v volumenumber metafilepath Option Description u Usage statement y Suppress interactive messages p path Enter a path relative to the mount point where defaults to path at source site you want
115. d 0 A 10 GB default 1 B 25 GB 2 C 50 GB 3 D Cleaning 1 Length has not been established AMASS still operates correctly but 1 Reports false capacity values you see with the vollist command 2 Records to the end of the media then returns an end of media error If you use tape volumes of different lengths create a template file that imbeds a specified tape length in the barcode in the File System Database When AMASS reads the Database it knows the media length and can accurately display capacity values when the vollist command is used If required you can override the template file with the tapelength command Instructions for creating a template file follow 3 104 Command Reference 6 00028 01 Rev A Managing the 5 File System Step 1 Step 2 Step 3 Step 4 Use an editor such as vi to create a template file similar to the file shown in the following example length code in 5th position of volume label D n XXXXLXXXXXXXX The string indicates tape length value To define a 50 GB length for a tape enter a value of C as shown in the following example length code in 5th position of volume label D C XXXXLXXXXXXXX HH The xxxxLxxxxxxxx string indicates location of the tape length value imbedded on the barcode To imbed the length in the fifth position on the barcode enter an L in
116. d Reference chapter Step Command Description 1 Log in as amass Or root 2 drivelist drivenumber AMASS displays the current For example status of the specified drive drivelist 2 3 drivestat i INACTIVATE the specified drivenumber drive For example AMASS performs the following drivestat i 2 tasks f a volume is in the drive it is returned to its home storage slot All operations currently in progress complete but no further requests are queued for the soon to be inactive drive 2 16 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Return a Drive to Service To return a drive to service use the procedure in the following table For detailed information on the commands used in these steps see the Command Reference chapter Step Command Description 1 Log in as amass Or root 2 drivelist drivenumber AMASS displays the current 1 status of the specified drive For example drivelist 2 3 drivestat a drivenumber ACTIVATE the specified drive For example drivestat a 2 6 00028 01 Rev A Operational Tasks 2 17 Managing the AMASS File System Delete Files and Volume Number To delete All files on a volume e Volume number from AMASS File System Database Use the procedure in the following table For detailed information on the commands used in these steps see the Command Reference ch
117. d ed quads 4 43 Guedisplay z arrire oe T a EE EE EUR ET Dd edet ts 4 45 l ierequisites i2 a sedes SREY Ce OES eet aee ay d o et 4 45 Poo des aos vex bad eed voti 4 45 When to Use UUU oboe ees ek suis 4 46 oupported Drives ba v pese Maas 4 46 Bl a Cr baa Put teda Caau 4 49 OPHONS ears eco ccv red ne coena odi 4 49 patabase LblitiBss restek iet con ete ede Je CURE CON UOS ebur E 4 51 AINASSICCOVELY boosts die cie URL Ce Base eee eB T d PRO DE 4 52 Whento Use Utility eius Rad ed Sos are RR qu PR 4 52 ODUGEHS Aevi OE Ep d AN dici Pate trio dd 4 52 made ve erue Sh ate ncaa t a atr att 4 53 xx Contents 6 00025 01 Rev A Accessing Storage Devices om CUN SI PRA ARE TESI ALIE OOS ee 4 55 When to Pe Sine E EE eee ee 4 55 ODUONS epee eke ete epee oe Ee 4 55 Example ou duod ue sad NE sp shee eh eee ais veer ieee teks 4 56 uuo ior Oe OR ae Tr 4 57 ODUONS DSTA IA ER PSP CHI ESET 4 57 oa doen eed oos Nc red stat ales Cath me We oe NES Qut Gnesi 4 59 ODBODE Sears ct Se Er ORE Da
118. defaults are drive dependent NOTE Valid only for specified drives see Configure Block Size on page 3 164 Enter the tape s block size Valid values are f MAXIOSZ is 1024 HP IBM SGI and Solaris enter 16K 32K 64K 128K 256K 512K or 1024 f MAXIOSZ is 256 enter 16K 32K 64K 128K or 256K f MAXIOSZ is 128 enter 16K 32K 64K or 128K Sizes can be entered with upper case K lower case k as a multiple of 1024 For example 16K upper case K 16k lower case 16384 the product of 16 x 1024 32768 the product of 32 x 1024 65536 the product of 64 x 1024 and so on c on Default c off NOTE Valid only for specified drives see Configure Compression on page 3 164 Specify device compression mode d num use multiple num drives 6 00028 01 Rev A Command Reference 3 161 Managing the AMASS File System Format a New Volume Step 1 Log as either amass or root Step 2 make the initial entry in the File System Database and receive from AMASS a unique volume number use the volnew command Step 3 load the specified volume number in a library use the volinlet command This command is not valid for libraries without a mailbox Step 4 mark the specified volume number Online in the File System Database use the volloc command This command is not valid for libraries without a mailbox St
119. e vgdvN Checks the volumes in the File System Database Current version number of the AMASS File System Database NOTE Do not use the file extension when running this utility After running keybuild rerun dbcheck on the affected database to make sure that all problems are fixed If successful reboot the system so AMASS can start 8 Troubleshooting Tools 6 00028 01 Rev A Managing the AMASS File System Step 7 fix bad chain errors or deleted File System Database records run dchain Examples of these errors are illustrated in the following example record is deleted but is not on the delete chain Problems at record O0 delete chain s next pointer 131072 is out of range Run dchain as follows Follow instructions precisely or data corruption may result cd usr amass libs dd if dbudata conv swab uncompress tar xvf dchain chown amass dchain chmod 4755 dchain usr amass utils inittaf cd usr filesysdb dchain usr filesydb filesvN vgdvN HH 6 00028 01 Rev A Troubleshooting Tools 9 Managing the AMASS File System Step 8 where Option Description filesvN Enter one of the following vgdvN e filesvN Checks the files in the NOTE Do File System Database not use the e vgdvN Checks the volumes in the dbd file File System Database extension Current version number of the whenrunning AMASS File System Database
120. e MO RW drive supports REWRITABLE media Tape tape device Worm drive supports WORM media Volume Reference number of volume in the drive 3 28 Command Reference 6 00028 01 Rev A Managing the 5 File System Fields State Description Device Status Flags AdminJob do admin job pointed to by admjob Assigned next job already assigned Clean Busy sysreq is servicing a drive clean and owns the drive Clean Done drive cleaning completed CLI Clean sysreq to start cleaning drive EjectReq volume eject requested ForeignVol foreign volume in drive I O Clean start drive cleaning InUse drive servicing a request JobDone no new jobs added since last queue scan Loaded device just loaded Needs Clean drive cleaning deferred NoDbRec device database entry not found NoBEject media in drive cannot be ejected OutOfService device is out of service PendnglIO I O is pending ReadWait set if read needs to be serviced ReleaseReq request to release drive Reschedule reschedule this device VerifyLPBN verify media last pbn on 1st write WriteDed device is a dedicated write drive Writing set when drive is writing The following output is generated when the astats command is run with the c option 6 00028 01 Rev A Command Reference 3 29 Managing the AMASS File System su root astats c Library Drive Type Volume State 1 1
121. e For information on this interface Interface to Standalone Drives chapter in Accessing Storage Devices 6 Make AMASS aware of all your other media For instructions see Create Entries in Database for Your Media on Page 1 9 7 amassbackup Perform a full backup with the verbose v option of the AMASS database usr filesydb and transaction logs home filesysdb journal For instructions see Manual Backup on page 2 7 8 volstat Verify the status of the Backup Volume is INACTIVE in the AMASS File System Database An INACTIVE status means that AMASS cannot read or write to the volume This prevents AMASS from writing to this volume thus corrupting the backup data Before using the amassrestore command to restore these files change the status of the Backup Volume to ACTIVE with the volstat a command 6 00028 01 Rev A Initial Setup Tasks 1 7 Managing the AMASS File System Create File System Organization The following tasks are presented as guidelines only since the actual setup required for your specific site is unique Step 1 Decide how you want to organize AMASS file system For example what directories should be under the archive mount point Step 2 Set permissions for these directories to allow clients to access the file system AMASS supports read and write permissions only Access Control Lists ACLs are not supported Step 3 Decide if you wa
122. e group 33 When volume group 33 runs out of space AMASS automatically takes an appropriately formatted volume from the space pool because volume group 33 has been enabled to use the space pool The production directory is the root directory for volume group 6 When volume group 6 fills up AMASS does not automatically assign it a volume from the space pool because it has not been enabled to use the space pool 6 00028 01 Rev A Initial Setup Tasks 1 17 Managing the AMASS File System Instead AMASS generates an out of space message and you must assign more volumes to the volume group e directories are added under amass nt production directories they belong to those directories volume groups either volume group 33 or 6 1 18 Initial Setup Tasks 6 00028 01 Rev A Managing the AMASS File System Assign Directory to a Volume Group To assign an existing directory to a volume group and enable the volume group to use the space pool if it runs out of space perform the steps in the following table For detailed information on the AMASS commands see the Command Reference chapter Step Command Description 1 Login as amass Or root 2 1 Assign directory archive nt to a volume group 34 For example setvolgrp archive nt 34 3 vgpool Enable e the volume group 34 to use the space pool if it runs out of space For examp
123. e see sysop on page 3 93 For detailed information on the commands used in these steps see the Command Reference chapter Read Offline Volumes The following steps describe how to read an offline volume Step Command Description 1 sysop Start the Standalone Operator Interface 2 OPERATOR LOAD VOLUME AMASS receives a REQUEST request to read a file on Please load VOLUME NUMBER yolume 47 47 SIDE A LABEL pubs into JUKEBOX 42 DRIVE 1 55 checks the File S System Database and Press RETURN when LOADED finds that volume is OFFLINE so the Standalone Operator Interface prompts you to load volume 47 side A into a standalone drive 3 You have 2 minutes to load volume 47 into the mailslot on the standalone drive and press Return If the volume is not loaded within the time period the request fails and AMASS displays an error If 120 seconds is not long enough increase the omm timeout parameter with the installamass script 4 lt Control C gt Exit the interface 2 26 Operational Tasks 6 00028 01 Rev A Managing the 5 File System The sysop interface used by OMM creates a tmp sysop out file that contains entries similar to those shown in the following example customer can link their own functions into OMM to perform additional processing on each mount call by using either the sysop out file or the sysop print o file UNMOUNT VOLNO xx SIDE
124. e 4 7 Step 8 After correcting any problems run install tests again User Defined Test Volume Capability To define the volume s to use to test each library create the file usr amass juke drive test volumes or modify the supplied template file The file should contain the slot number or volume label of the media to use for the test in each library in order or use the word None for install tests to automatically determine which media to use Comments are preceded by The example template file usr amass tools TESTS PICKER drive test volumes template shows examples of valid definitions This file should contain a list of the volumes to be used by install tests and move t to test the loading of the drives in each jukebox Format One volume name per line for each automated jukebox configured in AMASS or None if the volume to use 15 to be determined by the scripts EG MLE0037 Test volume for jukebox 1 SAMOOOI1 2 01 slot 3 None No test volume for jukebox 4 dE HHH db db db 4 20 Utility Reference 6 00028 01 Rev A Managing the 5 File System None None None None None None None None None None Test volume for jukebox 1 dE dk dt db db dt db db dt 2 A tu 6 00028 01 Rev A Utility Reference 4 21 Managing the AMASS File System killdaemons Performs the following tasks e nactivate AMASS by running amas
125. e if the database becomes corrupt see AMASS Database is Bad on page 6 For detailed information on the commands used in these steps see the Command Reference chapter Step Command 1 Log in as amass Or root Description 2 amassstat u For example amassstat i t 600 INACTIVATE 1 the AMASS file system AMASS inactivates in 600 seconds 10 minutes 3 Reboot AMASS using one of the following ways amass atboot Disable the automatic startup of AMASS For information on using this script see amass atboot in Chapter 4 Boot the system single user Be sure to mount the partition containing the AMASS database usr filesysdb the AMASS journal home filesysdb journal and the AMASS program files usr amass 4 fsck Check integrity of the file system 2 10 Operational Tasks 6 00028 01 Rev A Managing the 5 File System Step Command Description 5 Create the following two directories and one file all with owner as amass e usr filesydb e home filesysdb journal home filesysdb journal dbv4jrnl This file must be a minimum of 8 bytes in size 6 amassrestore u For example amassrestore v d dev rstl2 L 12N6J Restore the AMASS File System Database from the Backup Volume Restores database with verbose messages v from a standalone drive dev rst12 The Backup Volume s barcode is 12N6J
126. e unique volume number where you want to view directories Following is an example of output generated by this command for volume 3 The default AMASS mount point is archive d voldir 3 rw r r 1 root daemon 2044 Aug 24 17 20 archive vgrp1 listl 1 amass daemon 2446 Aug 25 08 2 The asterisks indicate this archive vgrpl testfilel file started on another rw rw r 1 amass daemon 6892 Aug 25 10 0 archive dir1 listings 6 00028 01 Rev A Command Reference 3 149 Managing the AMASS File System volfilelist View all files on a volume one file per line If you create a zero length file within an AMASS directory ex touch filename the file is not associated with a volume or volume group This command will ignore such files However a zero length file i e a non zero length file that was written to tape and then truncated to zero length will be recognized Options usr amass bin volfilelist uv ahilnr volumenumber Option Description a Print absolute path starting with the AMASS mount point For example archive dir1 3 150 Command Reference 6 00028 01 Rev A Managing the 5 File System Verbose Example Option StorageTek drives Description View start of the file s block address as a hexadecimal value enclosed in parentheses Print the file s inode number Print file names a variable length fi
127. ecific list These block will only be reused if no other cache blocks are available Cache Commands 6 00028 01 Rev A Managing the 5 File System Output The example below illustrates how to set cache block list 8 for a weight factor of 100 su root d setcbwght 8 100 Changing weight factor for cache block list 8 Weight factor currenti 1 new 100 Is this information correct y n y cbwghtlist Displays the weight factor values for each cache block list Output The following example illustrates a sample output su root cbwghtlist List Weight 1 1 2 1 3 1 4 1 5 1 6 1 7 1 8 100 6 00028 01 Cache Commands C 9 Managing the AMASS File System NOTES C 10 Cache Commands 6 00028 01 Rev A Symbols usr amass bin 3 3 usr amass daemons 4 3 5 5 4 3 5 4 3 ACSLS library interface 22 2 oe 3 42 adf Command cov bes 3 5 ADIC AML TEA CC e heo ds 3 42 amass_atboot 4 5 amass log 4 7 amass SNAP 4 9 amass start Script 4 10 amass tests 4 12 amassbackup Command 3 8 amassrecovery Utility 4 52 amassreport Command 3 12 amassrestore Command 3 19 amassstat Command 3 24 3 27 Audie
128. ect Valid values are syslog 0 6 tac 0 9 history 0 9 trace 0 9 t tag tag identifies the log requester 6 00028 01 Rev A Utility Reference 4 49 Managing the AMASS File System Option Description location Specify where message should be redirected defaults to stdin 4 50 Utility Reference 6 00028 01 Rev A Managing the 5 File System Database Utilities The following AMASS utilities help diagnosis problems with the AMASS File System Database Database Utility Page amassrecovery 4 52 dbcheck 4 55 fileincache 4 57 filepath 4 59 fileprint 4 61 initamass 4 64 initjournal 4 65 keybuild 4 66 sysdbchk 4 68 volprint 4 72 writecachemru 4 77 6 00028 01 Rev A Utility Reference 4 51 Managing the AMASS File System amassrecovery Performs the following tasks e Recover the AMASS file system Initialize the checkpoint The user must be amass When to Use Utility This utility automatically runs every time the system is rebooted For an example of when to use this utility e see AMASS Database is Bad on page 6 e see Return Media Without Starting AMASS on page 2 28 Use this utility only when AMASS is not running Options usr amass daemons amassrecovery is 4 52 Utility Reference 6 00028 01 Rev A Managing the 5 File System Option Description no
129. edia to reside Valid slot entries are 4 alphanumeric designation 0A12 SCSI attached storage device n a standalone drive NET network attached storage device volumelabel Enter one of the following User assigned name that is a maximum of 13 characters long Preprinted barcode that is a maximum of 13 alphanumeric characters long NOTE For barcode reading libraries a barcode label is required jukeboxnumber defaults to 1 Enter the library number where the new volume will reside The following example illustrates how to create an entry in the File System Database for a new volume assign it to volume group 4 slot 0A64 in library number 2 and label it with a volume label of test 3 188 Command Reference 6 00028 01 Rev A Managing the 5 File System Step 1 Log as either amass or root Step 2 create an entry in the File System Database and receive a unique volume number from AMASS enter the command as shown in the following example AMASS asks for confirmation of the process New volumes have an initial status of e Inactive T e Unformatted U Offline O NOTE When volumes are destined for libraries without a mailbox their status 15 Online su root di volnew 3 0A64 test 2 Request to add a new volume Volume group will be 3 Volume position will be 0A64 Volume label will be test Volume jukebox number will be 2 Is th
130. eld last similar to the format for the UNIX Is command This option will make it easier to sort or manipulate the output in a script Il Do not list appended files defaults to relative path Print relative path For example dir1 u Usage statement v Verbose messages volumenumber Enter the unique volume number The following example illustrates output for Storage Technology drives h Absolute paths a Verbose messages v 6 00028 01 Rev A Command Reference 3 151 Managing the AMASS File System Files on volume number 2 Mode Links Size UID Zero designates a directory GID su root di volfilelist hav 2 Access time Modified time 8 19980307142206 Hex value of StorageTek file s block address Directory name File name Volume number Logical block address Nonverbose Example The following example illustrates output for e Relative paths r 3 152 Command Reference 6 00028 01 Rev A Managing the 5 File System Output Fields Defined Files on volume number 2 Logical block address Zero designates a directory Directory name su root volfilelist N dirname 0 0 dirname filename2 71 File name Volume number Logical block address The following fields are generated by this command Fields Description Name Di
131. em Requests Not Getting to Library AMASS 15 running but is not behaving as expected for example I O requests are not going to the library To correct perform the following steps Step 1 Login as root Step 2 Use amass script to display the system log messages For more information on this script see amass_log on page 4 7 Make sure the messages being looked at are for the current time period Review prior messages to determine if any errors indicate the cause of the problem For additional information regarding messages refer to Errors and Corrective Action Step If the problem persists or if the cause cannot be determined through the system log make sure the library is properly connected and run the amass tests script For more information on this script see tests on page 4 12 Check the script output for recommended corrective action Step 4 Ifthe problem persists see Prepare to Contact Technical Support on page 32 22 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System System Panics If a process causes a system panic dump information to the core memory file Save this file because it contains clues about what was going wrong when system came down To set your server to automatically dump data to the core file perform the following steps for the appropriate platform Set Up for a Core Dump HP Step 1 Step 2 Step 3 Ste
132. em Database and journal logs 6 00028 01 Rev A Utility Reference 4 65 Managing the AMASS File System keybuild Rebuild the AMASS File System Database key tables Use this utility only when AMASS is not running When to Use Utility For an example of when to use this utility see AMASS Database is Bad on page 6 Options usr amass utils keybuild databasename filesvN vgdvN Option Description databasename Enter the AMASS File System Database defaults to directory usr filesysdb 4 66 Utility Reference 6 00028 01 Rev A Managing the 5 File System filesvN vgdvN Option Description Enter one of the following e filesvN Checks the files in the File System Database e vgdvN Checks the volumes in the File System Database N Current version number of the AMASS File System Database NOTE Do not use the dbd file extension when running this utility Example Step 1 Step 2 Step 3 Log in as root su root If AMASS is active inactivate AMASS with the option shown in the following example For command information refer to killdaemons killdaemons f From the AMASS File System Database directory enter the path utility and options similar to what is shown in the following example usr amass utils keybuild usr filesysdb filesv49 usr amass utils keybuild usr filesysdb vgdv49 6 00028 01 Rev A Utilit
133. ep 5 Storage Tek Redwood tape drives Enter the length of tape in the File System Database with the tapelength command Step 6 To format volume 33 enter the command shown in the following example After you enter the list of volume numbers AMASS asks for confirmation of the process di volformat 33 3 162 Command Reference 6 00028 01 Rev A Managing the 5 File System WARNING volformat will overwrite the entire volume DO NOT FORMAT volumes which have good files on them You cannot format active volumes Do you want to continue A The following volumes will be formatted 343 1 volume s to be formatted 57 volformat format of volume 33 started volformat format of volume 33 complete volformat completed formatting all volumes Step 7 further prepare the volume so AMASS can read or write to it use the commands listed in the following table Command Description volstat Mark the volume Active in the Database Active allows AMASS to read and write to media Attributes Within Volume Groups Each volume s attributes within a numerical volume group must be uniform For example if the first volume in a numerical volume group has been formatted with compression ON and a block size of 64 KB all the volumes in that volume group will have these identical attributes If you reassign media from one volume group to another volume group with the volgroup f opti
134. er NOTE This number identifies the drive in the library not what is configured in AMASS For example drive 1 is the first drive in the library not drive 1 configured in AMASS mx or Mx Mailbox number defaults to 1 tX or Tx Transport number destination Enter one of the following elements identified on the destination library XXXX Home storage slot or barcode x Drive number NOTE This number identifies the drive in the library not what is configured in AMASS For example drive 2 is the second drive in the library not drive 2 configured in AMASS mx or Mx Mailbox number defaults to 1 tX or Tx Transport number Enter one of the following values to indicate the side of media to load 0 Media 1 Flip media to side B Assumes the media is properly loaded into the library with side A up 6 00028 01 Rev A Utility Reference 4 37 Managing the AMASS File System Option Description jukeboxnumber Enter the AMASS library number defaults to 1 Example Step 1 Loginas root su root Step 2 In the following example AMASS instructs the drive to move the media in home storage slot 0A03 to drive two and flip it to side B cd usr amass utils i mediamove 0A03 2 1 Step3 In the second example AMASS moves the media 0 from the third mailbox m3 to the first home storage slot 0A01 in library 1 cd usr amass utils d mediamo
135. erf sysop and vollist commands destjukebox Enter the library number where the destination defaults to 1 Media resides Example To perform a volume copy follow the steps below For unattended operation set up the AMASS cron file to run these commands Step 1 Log in as either amass or root su root 6 00028 01 Rev A Command Reference 3 143 Managing the AMASS File System Step 2 Step 3 Step 4 If the source volume is not in its home storage slot use the mediamove utility to move the source volume to its slot in the library When the volcopy process starts the source volume must be in its home storage slot To move the destination media to a position in the library use the nediamove utility For complete information on this utility see mediamove on page 4 36 Run the volcopy command as shown in the following example The destination media is located in a standalone drive n a Verifies v the copy c process The source volume number is 6 Force f a copy volcopy cv 6 n a 2 Library number is 2 AMASS performs the following tasks Loads the destination media from the standalone to a drive If the volume needs formatting AMASS performs this task While the source volume is being copied AMASS marks it as unavailable for both reads and writes 3 144 Command Reference 6 00028 01 Rev A Managing the
136. es regc E CR CE 5 29 xxii Contents 6 00025 01 Rev A Accessing Storage Devices Messages Generated by ANLASS 015540 06S De Ie E UAR GPL EET s 5 30 Operator Interactive 5 30 Technical support Messases isa tepihi epi NERE ORS 5 30 Customer specific 5 5 30 Prepare to Contact Technical Support acc dee ek a ea Va eb vica d CES 5 32 Backup Scripts for HP UX A Backup Example for Small Pile A 3 Backup Example for Large File A 6 Fine tune Block Size B Optimize Tape Block Size sartres ay tena ee eee reise B 3 Supported eeu o a ied pant ates T dab dM B 3 Calculating Block Size 8 B 3 Correlate with File Size cce B 4 Correlate with MAXIOSZ eee sl B 4 Correlate with READ BLOCK LIMIT B 5 Cache Commands C Cache Command xxr EY REUS eU e UR TEES C 3 SetebliSb v oor Ue pA EE MR m LE SNe hs Ree LR C 3 OPHONS qao EE ea eed at e Do ed s C 4 COUTE e eoe ded EU ERR ee be eer Saree fee re et C 5 tt e o tl heat nett he sot ates cde duo C 5 ODBHOLIS adopta be ra doe e Ped pecie og rade pubs 6
137. es the checkpoint area e Notifies clients of the impending shutdown e Gracefully shuts down AMASS Sends a failure message to clients if they request a file from the AMASS file system after it is shutdown 3 24 Command Reference 6 00028 01 Rev A Managing the 5 File System Options usr amass bin amassstat uy acfisvw t seconds Option Definition no options View the status of AMASS When AMASS asks if you want to toggle the status type y for yes and n for no a Activate AMASS View status only f Force AMASS to inactivate immediately f t seconds Inactivate AMASS after the specified defaults to 300 number of seconds expires even if files are open If files are still open AMASS seconds 5 minutes sends a message to clients i Inactivate AMASS NOTE Clients read and write to open files but not new files Suppress most messages u Usage statement View the AMASS version number 6 00028 01 Rev A Command Reference 3 25 Managing the AMASS File System Option Definition w Inactivate AMASS NOTE Clients read from open files only y Suppress interactive messages but return a code as defined below e 0 Active 1 Inactive 3 26 Command Reference 6 00028 01 Rev A Managing the 5 File System astats View the status and attributes of the library drives and medi
138. escription Volume Group Volume group assignment Valid assignments are a numeric value 1 through 2047 Size Total size of this volume group in MB Used Amount of space in MB occupied by files in this volume group 3 6 Command Reference 6 00028 01 Rev A Managing the 5 File System Field Description Avail Amount of space in MB available in this volume group Volumes Number of volumes assigned to this volume group Rooted On Directory assigned to this volume group 6 00028 01 Rev A Command Reference 3 7 Managing the AMASS File System amassbackup Back up to a Backup Volume in either a library or a standalone drive the following files File System Database usr filesysdb Journal usr filesysdb journal When an external tape device is used to backup the AMASS database with d flag amassbackup will always unload the tape from the drive after successful backup completion While the backup is being completed the Database is locked Therefore client requests cannot be satisfied Task Full Partial Backup Backup Copy files to Backup Volume in a yes yes library Copy files to Backup Volume in a yes no standalone drive Back up the Journal transaction logs yes yes located in usr filesysdb journal When backup completes AMASS truncates the Journal Back up the AMASS Database located yes no in usr filesysdb 3 8 Co
139. ess interactive messages path Enter the absolute path such as archive dir1 to the directory NOTE This directory must already exist volumegroup Enter the numerical volume group assignment defaults to 0 Valid assignments are 1 through 2047 6 00028 01 Rev A Command Reference 3 89 Managing the AMASS File System Initial File System Step 1 See following figure which illustrates an initial file system directories and files are in volume group number 0 which is the default volume group Volume Group 0 archive projects amass unix Assign New Directory to Volume Group Two Step2 Log as either amass or root su root Step 3 Create an amass nt directory under archive projects Step 4 Enter the following to assign the archive projects amass nt directory to volume group 2 4 setvolgrp archive projects amass nt 2 3 90 Command Reference 6 00028 01 Rev A Managing the AMASS File System The following figure shows that all new subdirectories or files created under the amass nt directory belong to volume group 2 Volume Group 0 archive projects Volume Group 2 amass unix Assign Any New Files to Volume Group One Step 5 assign any new files under the archive projects amass unix directory to volume group 1 enter 4 setvolgrp f archive projects amass unix 1
140. estore the daily transactions since the last Database Backup Step 3 Shut down AMASS by entering the following su root usr amass tools killdaemons Step 4 X Restore the crashed File System Database usr filesysdb partition 6 00028 01 Rev A Troubleshooting Tools 19 Managing the AMASS File System Step 5 restore the database and journal from the Backup Volume enter the following command and options amassrestore v D drivenumber P slot where Value Description v Displays a maximum amount of information For SCSl attached libraries D drivenumber Backup Volume is read by this drive P slot Backup Volume resides in this home storage slot For barcode reading libraries L label Backup Volume has this preprinted barcode For standalone drives d tapedevice Backup Volume is read by this standalone tape drive For example d dev rst12 Step 6 Copy your intact AMASS journal home filesysdb journal from Step 2 to the journal partition 20 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System Step 7 Start AMASS using amass start as shown in the following example 4 usr amass tool amass start archive If Cache Partition Crashes You have lost all write transactions that were pending in the cache when the crash occurred 6 00028 01 Rev A Troubleshooting Tools 21 Managing the AMASS File Syst
141. fileonmedia 3 79 gives unexpected results 5 26 healtheheck a8 es veo x 3 81 ipia Gesch be REA C 3 Sad 7 3 86 SELVOIGrE 3 87 SEEVOISED gs 3 68 SYSOP a T EE ERE pex 3 3 3 93 SYSDOt bL S re Ed 3 97 tapelenpthi 3 103 use Ti SCEIDIS 3 3 VBeXDOLI curii Lote oe ems pn 3 106 VElIBDOIt ers nk eden xaos 3 111 3 117 WEPOOL o bores 3 120 3 125 hi Hes tpa SA 3 127 yolclattr exa dcm ho ris 3 129 y lle ve etes es 3 132 voleomp i voe eec 3 134 NOICODV Eds ede uo S esce ed 3 138 as reU S ex 3 146 VOIR Ge tbat ES Ed 3 148 volfilelist 3 150 3 158 VO BEQOU Coetu os 3 166 cuota septo eos 3 170 WO WADE ene Soie put es 3 173 ora sweets ER SN 3 175 INX 2 Index VOUS xi REPE OVES 3 177 Lowe OE 3 184 VOlInew cepa e EIE 3 187 3 191 yoloutlet s 6 SAGT 3 194 3 196 VOISIOR tibt 3 198 VOlSpate soda 3 201 RE e dcn 3 206 VO USBBBC ti tesa 3 209 Compression COMMBULC A ob Ld teas 3 164 VIEW PESCE UR 3 117 Configuration File THOGIDV Dare ERA 2 35
142. fined The following fields are generated by this command Field Description Drive Reference number Juke Reference number 6 00028 01 Rev A Command Reference 3 71 Managing the AMASS File System Status Field Description Drive status Active drive used by AMASS e I Inactive drive not currently used by AMASS D Drive dedicated to writes requests Errors Number of errors on the drive NOTE Drives that have excessive errors should be taken offline for maintenance To inactivate a drive use the drivestat command 3 72 Command Reference 6 00028 01 Rev A Managing the AMASS File System drivestat View and change the status of drives If media is in a drive when you INACTIVATE the drive AMASS returns the volume to its home storage slot Options usr amass bin drivestat uy e secs drivenumber a drivenumber i drivenumber jukeboxnumber Option Description no options View status of all drives When AMASS asks if you want to toggle the status type y for yes and n for no Usage statement y Suppress interactive messages 6 00028 01 Rev A Command Reference 3 73 Managing the AMASS File System Output Examples IDLETIME Option e secs drivenumber Description Dynamically reset the idle eject feature on a per tape drive basis a drivenumber Activate specified drive i
143. from a source volume to a destination volume If the original volume is lost destroyed or damaged you can use the duplicate volume exactly like you would the original AMASS supports volcopy on the following media WORM e Rewritable optical MO Tape This command copies the Backup Volume as well as all other volumes known to the File System Database A volume is known to AMASS when an entry is created in the Database and AMASS assigns it a unique volume number If you write to the source volume again or use the volcomp command on it without recreating a duplicate copy data corruption may result because the duplicate is no longer exactly like the original volume Optional Feature Enable this optional feature with an authorization string obtained from ADIC To request a string refer to the Site Specific Tasks chapter in nstalling AMASS 3 138 Command Reference 6 00028 01 Rev A Managing the 5 File System Requirements Before using this command Two drives are required one drive to read the source volume and one drive to write to the destination media The drives can be either standalone or in a library Although a standalone drive can be used it is tedious because you must manually flip each volume several times If you use a standalone drive you must also use the Standalone Operator Interface which is run by using the sysop command For complete information
144. fully restore your File System Database and therefore allow you to know where data is located on what piece of media if your current File System Database gets corrupted or the hard disk crashes If the Journal usr filesysdb journal tends to fill up the available disk space before the normally scheduled full backup increase the frequency of the full backups For detailed information on making a Backup Volume see the Initial Setup Tasks chapter How to Modify Automated Schedule To change the automatic backup schedule use the procedure in the following table The defaults are shown below The first line runs a full backup at 3 a m 2 a m for IBM platforms on the first day of every month The second line runs a partial backup at 3 a m 2 a m for IBM platforms on all other days of the month The six active fields are minute hour day month day of week and command Each field except the command field may be an asterisk Step Command Description 1 Log in as root 2 cd var spool cron crontabs Change directory to where the crontab file is located 3 Edit the var spool cron crontabs amass table entry 6 00028 01 Rev A Operational Tasks 2 5 Managing the AMASS File System day of month hour month minute day of week usr amass bin amassbackup fv 31 usr amass bin amassbackup v Step Command 4 03 0 usr amass bin ama
145. g Tools 17 Managing the AMASS File System Step 5 To restore the File System Database and journal from the Backup Volume enter the following command and options d amassrestore v D drivenumber P slot Step 6 where Value Description v Displays a maximum amount of information For SCSl attached libraries D drivenumber Backup Volume is read by this drive P slot Backup Volume resides in this home storage slot For barcode reading libraries L label Backup Volume has this preprinted barcode For standalone drives d tapedevice Backup Volume is read by this standalone tape drive For example d dev rst12 Copy your intact AMASS File System Database home filesysdb from Step 2 to the database partition 18 Troubleshooting Tools 6 00028 01 Rev A Managing the AMASS File System Step 7 Start AMASS using amass start as shown in the following example usr amass tool amass start archive If Database Partition Crashes If the AMASS File System Database usr filesysdb partition crashes perform the following steps These steps assume the File System Database usr filesysdb and journal usr filesysdb journal were installed on different partitions as recommended during the installation process Step 1 Login as root Step 2 the journal home filesysdbjournal to media This transaction log is needed to r
146. g on the library connection To prevent changes to the source volume it is marked Read Only after the volcopy process begins The exception is the Backup Volume AMASS recognizes the Backup Volume and leaves its status as read write Write Drive SP Destination Media Media is unknown to File System Database it does not have a volume number Block size and capacity is same as source volume Load and unload the volumes with the mediamove utility During process destination volume is flagged as IU Inactive Unformatted and assigned to SP space pool volume group when displayed with the sysperf sysop and vollist commands 3 140 Command Reference 6 00028 01 Rev A Managing the 5 File System Name Contention Solaris and HP UX only Because AMASS Solaris and HP UX all have a 1 command make sure you use the full path to differentiate which command you want to use For example to use the AMASS command enter it as shown in the following example su root cd usr amass bin 4 volcopy Or make sure your PATH variable has usr amass bin in front of the Solaris or HP UX usr sbin volcopy Standalone Optical Drives Options Do not use the abort command with the Standalone Operator Interface run with the sysop command to stop the AMASS volcopy process usr amass bin volcopy uyl type c v ev sourcevolume destslottype dest
147. generating any messages All When AMASS lists file names it uses the metadata file from the AMASS File System Database stored on the UNIX server However Windows 95 and Windows NT operating systems use executable files with icons stored as part of the file Consequently to display these icon embedded file names that AMASS has archived AMASS must reload the file from the library IRIX 6 2 Using NFS 3 Using the UNIX xfsdumps command to transfer large files 800MB and greater in size over NFS Version 3 may degrade AMASS performance Acceptable performance is attained if the AMASS cache block size is set to 50MB with 9 or more dirty blocks and on NFS a write buffer size is set to 32KB 6 00028 01 Rev A Troubleshooting Tools Managing the AMASS File System AMASS Database is Bad An error message occurs that points to an AMASS File System Database problem To correct perform the following steps Step 1 Step 2 Step 3 Step 4 Log in as root Shut down AMASS with the killdaemon script su root usr amass tools killdaemons Lock the AMASS File System Database 4 usr amass tools lm Back up your existing AMASS File System Database using a standard utility such as tar or cpio Make sure both the usr filesysdb and usr filesysdb journal directories are backed up Do not use the AMASS amassbackup command 6 Troubleshooting Tools 6 00028 01 Rev A
148. ging the 5 File System Flags Defined The following table describes the Active Inactive Online and Offline values a volume can have in the Flags field Online O Offline Volume is in library Volume is not in library AMASS can read AMASS can read and write to A and write to volume volume with Offline Media Active Manager OMM For OMM information see Read Offline Volume on page 2 25 Volume is in library Volume is not in library AMASS cannot read AMASS cannot read or write to or write to volume volume l Inactive 6 00028 01 Rev A Command Reference 3 205 Managing the AMASS File System volstat Name Contention View and change the current status Active or Inactive of a volume hp Tru64 UNIX only Because both AMASS and hp Tru64 UNIX have a volstat command make sure you use the full path to differentiate which command you want to use For example to use the AMASS command enter it as shown in the following example su root cd usr amass bin volstat Or make sure your PATH variable has the usr amass bin before the hp Tru64 UNIX usr sbin volstat Options usr amass bin volstat uyl ai volumenumber 3 206 Command Reference 6 00028 01 Rev A Managing the AMASS File System Option Description no options View status of the specified volume When AMASS asks if you want to toggle the status type y for yes and n for
149. h verbose information enter the following options amassbackup fv 3 10 Command Reference 6 00028 01 Rev A Managing the 5 File System Additional Information For more information see Database and Journal Backups on page 2 3 6 00028 01 Rev A Command Reference 3 11 Managing the AMASS File System amassreport Report file system information The following types of reports can be generated Formatted Column titles are printed at the top of each page e Raw Although titles are not printed data appears in the same sequence as found in the formatted report and is separated by tabs A raw report is useful if you generate reports with UNIX utilities like awk sort and Generated Column Titles Both formatted reports and raw reports generate data under the topics listed in the following table The sequence of the topics cannot be changed Topics Description Name Name of file Parent Record ID of parent Last Accessed Last accessed date on timestamp Mode Permission IDs Size Size of file in MB File ID File number UID User ID GID Group ID 3 12 Command Reference 6 00028 01 Rev A Managing the 5 File System Options Topics Last Modified Description Date and time showing date the file was last modified Vol File is located on this volume number usr amass bin amassreport dfPRS OSTEN
150. he CD cdimport Identify the absolute path where you want the data to reside in the AMASS file system 3 54 Command Reference 6 00028 01 Rev A Managing the 5 File System If this operation is unsuccessful the CD may be left in the drive If this happens manually remove the CD 6 00028 01 Rev A Command Reference 3 55 Managing the AMASS File System dirfilelist View recursively files under a directory one entry per line Options usr amass bin dirfilelist uv h path Option Description StorageTek drives h View start of the file s block address as a hexadecimal value enclosed in parentheses u Usage statement v Verbose messages path Enter the path to where you want to view files The path can be either e Absolute such as archive accting e Relative to the mount point such as accting 3 56 Command Reference 6 00028 01 Rev A Managing the 5 File System Verbose Example The following example assumes we Use Storage Technology drives h e Want to see the absolute path for all the files Wantto view all files under the archive prodcode directory Mode Links Size UID GID Zero designates a directory su root dirfilelist hv archive prodcode archive prodcode 0004010 01 1 19980207114408 09980307142206 Access time Modified time archive prodcode n
151. he attributes to match If there is a discrepancy AMASS returns an error 6 00028 01 Rev A Command Reference 3 115 Managing the AMASS File System 3 116 Command Reference 6 00028 01 Rev A Managing the AMASS File System vglist View attributes for a volume group By default the view will not include block size or compression attributes unless specifically requested with the a option Options usr amass bin vglist uy volumegroup Option Description no options List all volume groups and their attributes a View both the tape block size and the compression attributes NOTE By default block size and compression attributes will not display unless you use this option u Usage statement y Suppress interactive messages 6 00028 01 Rev A Command Reference 3 117 Managing the AMASS File System Option Description volumegroup Enter the unique volume numbers you want to load in the library and mark them Online in the Database To list more than one volume separate the numbers with a space For example vglist 1 5 lists volume groups 1 and 5 Example Step 1 Log in as either amass or root su root Step 2 view attributes including tape block size and compression for volume group 801 enter the options shown in the following table vglist a 801 VOLGRP JUKE FLAGS blk comp vols used avail 801 0 full worm 256 On al 0 195
152. he current version of AMASS Immediately create a new Backup Volume with the amassbackup command Label the new Backup Volume with the new MAXIOSZ value To recover data on the old Backup Volume return the MAXIOSZ parameter on AMASS to the old setting before attempting to read the old Backup Volume 6 00028 01 Rev A Operational Tasks 2 37 Managing the AMASS File System NOTES 2 38 Operational Tasks 6 00028 01 Rev A 3 Command Reference Managing the AMASS File System NOTES 3 2 Command Reference 6 00028 01 Rev A Managing the 5 File System Commands Syntax Use in Scripts The commands described in this chapter are located in the directories listed in the following table Specify this path in the system administrator s login PATH variable Command Login Path Sysop amass all other amass usr amass bin commands root ADIC recommends that you control the execution privileges for all commands as appropriate for the desired security level at your site The command syntax is the same as standard UNIX style commands The options shown in square brackets in this chapter are optional all others are required For unattended operation set up the cron file to run the AMASS commands Similarly to automate tasks all the AMASS commands can be run from within a script Make sure you check the return codes of the messages
153. if the cause can not be determined through the system log make sure the library is properly connected and run the install tests script For more information on this script see install tests on page 4 16 Check the script output for recommended corrective action Step 5 After the corrective action has been performed start AMASS using the amass start script For more information on this script see start on page 4 10 Step 6 Ifthe problem persists see Prepare to Contact Technical Support on page 32 16 Troubleshooting Tools 6 00028 01 Rev A Managing the AMASS File System UNIX Server s Partitions Crash An AMASS partition on the UNIX server s hard disk crashes To correct perform the appropriate steps in the following procedure These steps assume the File System Database usr filesysdb and journal usr filesysdb journal were installed on different partitions as recommended during the installation process If Journal Partition Crashes If the journal home filesysdbjournal partition crashes perform the following steps Step 1 Login root Step 2 Copy the database home filesysdb to media This file is required to restore the AMASS database since the last backup Step 3 Shut down AMASS by entering the following su root usr amass tools killdaemons Step 4 Restore the crashed journal home filesysdbjournal partition 6 00028 01 Rev A Troubleshootin
154. ile Life feature Attributes Within Volume Groups Each volume s attributes within a numerical volume group must be uniform For example if the first volume in a numerical volume group has been formatted with compression ON and a block size of 64 KB all the volumes in that volume group will have these identical attributes If you reassign media from one volume group to another volume group with the volgroup f option AMASS makes sure the media attributes from the first volume group match the attributes of the second volume group If the values do not match AMASS issues an error and does not complete the reassignment For information on numerical volume groups see Volume Groups Defined on page 1 13 Change Volume Group Number Step 1 Log as either amass or root Step 2 assign volume number 23 to volume group 100 enter the command as shown in the following example 3 168 Command Reference 6 00028 01 Rev A Managing the AMASS File System AMASS asks for confirmation of the process su root volgroup 23 100 Request to change volume group on volume 23 Old group is 0 New group is 100 Is this information correct y nl y Volume 23 has been added to volume group 100 Step 3 Use setvolgrp command to update the directories and files with the new volume number This command works only six levels deep Therefore run it as many times as necessary Assign Volume to Space
155. ile in MB Mode File permissions Links Number of hard links for this file UID Numeric user ID GID Numeric group ID Access time Last time file was accessed Modified time Last time file was modified The Access time and Modified time values have the following format yyyymmddhhmmss For example the value 19980307114408 1998 March 07 11 44 08 a m This format allows you to sort by time which is useful when creating a list of files created at a specific date and time In the following example we use this command to back up files from one volume group to another Step 1 Log either amass or root su root Step 2 Enter the following commands to pipe all of the files from archive accting arewritable volume group to archive fian a write once volume group 6 00028 01 Rev A Command Reference 3 59 Managing the AMASS File System Numerically sorts files based first upon volume then based upon logical block address Prints just the file names cd archive acctihg COLE 1 2 print 1 cd archive fian cpio icdvum The cd command insures the data will go to the correct source directory Lists files Backs up the files To speed up the backup process we use two cpio p commands so AMASS can read and write data in parallel 3 60 Command Reference 6 00028 01 Rev A Managing the AMASS File System driveclean Mount a cleaning volume in a tape d
156. ile transfer procedure Tests the library components healthcheck icCsw archive test jasonfile Jukebox number Test all drives Volume number 3 84 Command Reference 6 00028 01 Rev A Managing the 5 File System Step3 example of a summary report s generated by this command is shown in the following illustration healthcheck summary dbcheck was successful library was successful file transfer was successful read 10485760 bytes in 39 seconds write resources test was successful cache blocks free 1274 total 1274 FNODES free 633 total 635 cache test was successful 6 00028 01 Rev A Command Reference 3 85 Managing the AMASS File System setdrverr Resets the error counts to zero reported by the drivelist command Options usr amass bin setdrverr uy Uukeboxnumber drivenumber Option Description u Usage statement y Suppress interactive messages jukeboxnumber Enter the library number where the drive defaults to 1 resides drivenumber Reset error counts on the specified drive 3 86 Command Reference 6 00028 01 Rev A Managing the 5 File System setvolerr Resets the error counts to zero reported by the vollist command Options usr amass bin setvolerr uy volumenumber Uukeboxnumber Option Description u Usage statement y Suppress interactive messages volumenumber Reset erro
157. in the following example volloc n 33 6 00028 01 Rev A Command Reference 3 185 Managing the AMASS File System Step 5 further prepare the volume so AMASS can read or write to it use the commands listed in the following table Command Description StorageTek Redwood tape drives only tapelength Enter the length of tape in the Database volformat Format the volume volstat Mark the volume Active in the Database Active allows AMASS to read and or write to media 3 186 Command Reference 6 00028 01 Rev A Managing the AMASS File System volnew Create an entry in the File System Database for new unknown media For tracking purposes AMASS assigns the new volume a unique volume number Options usr amass bin volnew uyl volumegroup slot volumelabel Uukeboxnumber Option Description u Usage statement y Suppresses interactive messages 6 00028 01 Rev A Command Reference 3 187 Managing the AMASS File System Create Database Entry for New Volume Option volumegroup Description Enter the volume group assignment Valid assignments are A numeric value 1 through 2047 SP space pool A volume with files on it cannot be assigned to the space pool e CL cleaning group media verification group for the optional Infinite File Life feature slot Enter a home storage slot where you want the m
158. ing the AMASS File System Option Description m mode List only those files having one of the following permission IDs Only list files that have n name Specific name Specific group of letters somewhere in the name Enter a string that contains a wildcard character enclosed in quotes For example n sales selects all files with an extension of sales Option Description o filename Direct report to a specified filename p prid Only list files with a specified parent record ID r rid Only list files with a specified record ID size Only list files with that have a size Specific size s size Smaller or larger file size Enter a string that contains less than or greater than 2 relationship operator enclosed in quotes For example 2000 selects all files with a size less than 2 000 bytes 3 16 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description u uid Only list files with a specified user ID v volnumber Only list files on a specified volume z volgroup Only list directories in a specified volume group Example Step 1 Log as either amass or root su root Step 2 Enter the following options to see file access and modification times in seconds 4 amassreport S n filename S
159. is information correct y n y Volume 33 been added status is Inactive AMASS assigned e sure jns is formatted before activatii volume a unique volume number of 33 Step 3 load the volume into the library and continue with the initialization process use the commands listed in the following table 6 00028 01 Rev A Command Reference 3 189 Managing the AMASS File System Command volinlet NOTE Not valid for libraries without a mailbox Description Load volume into the library volloc NOTE Not valid for libraries without a mailbox Mark the volume Online in the Database Online media is in storage device StorageTek Redwood tape drives only tapelength Enter the length of tape in the Database volformat Format the volume volstat Mark the volume Active in the Database Active allows AMASS to read and or write to media 3 190 Command Reference 6 00028 01 Rev A Managing the 5 File System volnote Enter a user defined 255 character description for a volume Options usr amass bin volnote uyl volumenumber volumenumber d volumenumber Option Description no options Generates a list of all volumes and their corresponding descriptions u Usage statement y Suppress confirmation messages volumenumber Display the description for the specified volume number volumenumber tex
160. jukebox 6 00028 01 Rev A Command Reference 3 141 Managing the AMASS File System Option type Definition Enter one of the following copy types Copy sourcevolume data to destslot media v Verify copy process by reading and comparing the duplicate copy with the original volume cv Copy and verify NOTE Valid only for optical media Force a copy even if the destination media contains a valid AMASS header or data Usage statement Suppress interactive messages sourcevolume Enter volume number of the source volume This volume must be in jukebox 1 online formatted and Active NOTE After the process has completed AMASS marks this original volume as Read Only to prevent it from being changed 3 142 Command Reference 6 00028 01 Rev A Managing the AMASS File System Option Definition destslottype Enter the home storage slot where the destination media resides and where it will be returned Destination media is unknown to the Database it does not have a volume number Valid slot designations are 4 alphanumeric designation 0A12 SCSI attached storage device n a standalone drive NET network attached storage device Enter the barcode as the next parameter NOTE During the process AMASS flags this duplicate volume as IU Inactive Unformatted and assigns it to SP space pool volume group when displayed with the sysp
161. k is written for the system administrators who use the command line to operate and troubleshoot AMASS It assumes the administrators have a strong familiarity with e The appropriate UNIX operating system e Applications running in their site environment This book contains the following chapters Chapter 1 Initial Setup Tasks Use AMASS commands to prepare the file system and media for use by AMASS These tasks include the following e Preparing a Backup Volume Creating an entry in the File System Database for all media e Assigning volume groups Chapter 2 Operational Tasks Use AMASS commands to manage the AMASS file system These tasks include the following e Modifying the schedule to back up the AMASS File System Database e Switching drives in and out of service 6 00028 01 Rev A Preface P 3 Managing the AMASS File System Reading offline media e Adding space to volume groups e Activating and inactivating the file system Chapter 3 Command Reference Alphabetical list of AMASS commands Chapter 4 Utility Reference Alphabetical list of AMASS utilities Chapter 5 Troubleshooting Tools Procedures scripts and utilities for diagnosing problems Appendix A HP UX Backup Scripts Examples of backup scripts for HP environments Appendix B Fine Tune Block Size Configuring site specific tape block sizes Appendix C Cache Commands Using new AMASS commands to assign cache bl
162. l to a specified date and time Format is MM DD YYYY hh mm ss The date is required The time is optional J jukeboxnumber Enter the library number where Backup defaults to 1 Volume resides D drivenumber Enter drive number that reads the Backup Volume Option Definition For SCSl attached storage devices P slot Enter the 4 alphanumeric home storage slot number where the Backup Volume resides NOTE Backup Volume should be in the last home storage slot in the library If you have more than one library daisy chained to AMASS the volume should be in the last slot in the first library The last slot for SCSI attached storage device is defined as what is listed by the medialist utility 3 20 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Definition For barcode reading libraries L label Enter the preprinted alphanumeric barcode of the Backup Volume For standalone drives d tapedevice Enter the standalone tape device that reads the Backup Volume For example dev rst12 Example Step 1 Log in as either amass or root su root Step 2 Inactivate the AMASS file system with the following command amassstat i Step 3 Check the integrity of the file system by running the UNIX sck command fsck devicename 6 00028 01 Rev A Command Reference 3 21 Managing the AMASS File System Step 4
163. label p path Enter the absolute path where you want to place the imported data For example archive cdpubs volumenumber Enter the unique volume number Step 1 Log in as either amass or root su root Step 2 Create a directory for example cdpubs under the AMASS mount point default is archive for the files on the CD mkdir archive cdpubs 6 00028 01 Rev A Command Reference 3 53 Managing the AMASS File System Step3 Use the AMASS volnew command to create an entry in the File System Database for the CD AMASS assigns the CD a unique volume number 49 and asks for confirmation of the process Your response in bold is shown in the following illustration Home storage slot number N A is valid for a standalone drive Label 7 volnew 20 fmdocs CD volume Volume group assignment SNP 9 resides in library 2 Request to add a new volume Volume group will be 20 Volume position will be N A Volume label will be fmdocs Volume jukebox number will be 2 Is this information correct y n y Volume 49 has been added status is Active AMASS assigned this CD a unique volume number of 49 Step 4 Use cdimport command as shown in the following illustration p archive cdpubs 49 Volume Step 5 verify that process worked list files 15 under archive cdpubs on the UNIX server and you should see the files previously found on t
164. le vgpool e 34 6 00028 01 Rev A Initial Setup Tasks 1 19 Managing the AMASS File System Create a Cleaning Volume Group To create a volume group used solely for cleaning cartridges use the procedure in the following table Currently the CL volume group can contain only one type of cleaning cartridge For example if you have both a DTF drive and a 3590 drive your CL volume group must contain only DTF cleaning cartridges or exclusively 3590 cleaning cartridges For detailed information on the AMASS commands see the Command Reference chapter Command Login as amass Or root Description volnew For example volnew CL A77 clean Create an entry for each cleaning volume in the AMASS File System Database Assign the volume to the cr cleaning group volume group Assign each cleaning volume to a home storage slot A77 Give each cleaning volume a user definable label clean AMASS gives each piece of media a unique volume number for example 23 1 20 Initial Setup Tasks 6 00028 01 Rev A Managing the 5 File System Step Command volclattr For example voleclattr t 6 23 Define drive specific attributes to the cleaning volume 23 Description vollist g CL View attributes for the cleaning group 6 00028 01 Rev A Initial Setup Tasks 1 21 Managing the AMASS File System NOTES 1 22 Ini
165. le System Option Description W Limit specified volume group to only use WORM optical platters from the space pool y Suppress interactive messages Enable Volume Group to use Space Pool Step 1 Log as either amass or root su root Step 2 For more information about enabling volume groups to use the space pool see Volume Groups Defined on page 1 13 Step 3 enable volume group 6 in jukebox 1 to use the space pool if it runs out of volumes enter the command as shown in the following example Your input is shown in bold vgpool 6 Volume group 6 is currently space pool Disabled Would you like to change its status y nl y Volume group 6 is now Space Pool Enabled 3 122 Command Reference 6 00028 01 Rev A Managing the 5 File System Limit Media Usage and Location of Space Pool Step 1 Log either amass or root Step 2 enable space pool use rewritable optical platter and use the space pool located on library 2 enter the command as shown in the following example Your input is shown in bold vgpool r j2 3 Volume group 3 is Would you like to Volume group 3 is Volume group 3 is Jukebox number is currently space pool disabled change its status y n y now Space Pool Enabled now Rewritable now 2 Step 3 Another way of entering the same information but without prompts from AMASS is illustrated in the following example d vg
166. lock of data waiting for to start Pending Cache block of data in the drives s buffer Done Cache blocks that have been verified as written to media 6 00028 01 Rev A Command Reference 3 101 Managing the AMASS File System VolFlags Defined The following table describes the Active Inactive Online and Offline values a volume can have in the VolFlags field A Active Online Volume is in library AMASS can read and write to volume O Offline Volume is not in library AMASS can read and write to volume with Offline Media Manager OMM For OMM information see Read Offline Volume on page 2 25 l Inactive Volume is in library AMASS cannot read or write to volume Volume is not in library AMASS cannot read or write to volume 3 102 Command Reference 6 00028 01 Rev A Managing the 5 File System tapelength Define the length of unformatted tape to the File System Database for the Storage Technology Redwood SD 3 drive Options usr amass bin tapelength uy volumenumber lengthcode Option Description u Usage statement y Suppress interactive messages volumenumber Unique volume number of the tape media being defined 6 00028 01 Rev A Command Reference 3 103 Managing the AMASS File System Create a Template File Option Description lengthcode Enter the tape length Code Redwoo
167. ls AMASS what transactions what entries have acted upon a file stored on a volume in a library It is a daily diary of logged events Both the Database and Journal can be backed up automatically and manually Both types of backups are described below If your File System Database gets corrupted or the hard disk crashes restore the Database with the full and partial backups you have taken Automatic Backups Via Cron Job Because the File System Database and the Journal are extremely important this information must be protected Consequently the amassbackup command run from a cron job regularly backs up both the Database and Journal This cron job was created when AMASS was installed The cron job backs up the Database and Journal to a Backup Volume at 3 a m using the following schedule e First day of the month Full Backup e other days Partial Backup After the backup completes AMASS truncates the Journal file If the above schedule is not suitable for your site modify the schedule by editing the crontab and changing the amassbackup entries Make sure these backup are successful Look in the system log every morning for a Backup was successful message 2 4 Operational Tasks 6 00028 01 Rev A Managing the 5 File System Assign Backup Volume The full backup backs up the Database and Journal and partial backups backs up just the Journal will allow you to success
168. m Step Command Log in as amass Or root Description sysperf updateinterval To make sure there are no pending write requests in the AMASS queue view the queue with the sysperf command Log in as root and enter the command as shown in the following steps To stop the sysperf command use lt Control C gt Run only one sysperf command at a time cd usr amass tools amass atboot d Disable AMASS at system startup Reboot the UNIX server and AMASS will not automatically start cd usr amass scripts installamass Rerun the installamass script and make the necessary configuration changes Reboot the system for the changes to take effect AMASS W 9031 AMASS configuration has been changed checkpoint area is invalid If you change any of the AMASS cache related configuration parameters this error message may appear after AMASS restarts Under these circumstances this message can be ignored 2 36 Operational Tasks 6 00028 01 Rev A Managing the 5 File System MAXIOSZ Changes If you want to change the MAXIOSZ perform the following steps Step 1 Command Log in as amass Or root 2 Remove your current Backup Volume containing a backup of the AMASS File System Database and transaction file from the library label it with the old Max1osz value and store the volume in a safe place Upgrade to t
169. mes Off line in the File System Database usr amass bin bulkoutlet uy volumenumber 6 00028 01 Rev A Command Reference 3 47 Managing the AMASS File System Option Description Usage statement Suppress interactive messages volumenumber Enter the unique volume numbers you want to unload from the library and mark Off line in the Database To list more than one volume separate the numbers with a comma or with a hyphen For example bulkoutlet 1 8 ejects volumes 1 and 8 bulkoutlet 1 8 ejects volumes 1 2 3 4 5 6 7 and 8 Outlet Volumes Step 1 Step 2 Step 3 Log in as either amass or root su root See the following example a total of 12 volumes 1 2 3 4 5 6 7 8 9 10 21 and 23 are ejected from the library d bulkoutlet 1 2 10 21 23 Remove the volumes from the mailbox 3 48 Command Reference 6 00028 01 Rev A Managing the 5 File System Unsuccessful Ejects If you attempt to eject several volumes at one time and one volume fails to eject after the first failure AMASS will not eject the remaining volumes For example if you eject volumes 1 2 3 4 and 5 and volume 3 is unsuccessful AMASS successfully ejects 1 and 2 but does not eject 3 4 and 5 6 00028 01 Rev A Command Reference 3 49 Managing the AMASS File System cdimport Import data from CDs formatted by the standards prescribed by
170. milar product to create an etc fsd auto file Step 2 Create an entry for each drive similar to the entries shown in the following illustration Drive information is obtained from the etc fsd tab file vi etc fsd auto dev scsi sc3d3l0 CDROM3 iso9660 mon off 00 6 00028 01 Rev A Command Reference 3 51 Managing the AMASS File System dev scsi sc3d5l0 CDROM iso9660 mon off 00 dev scsi sc3d4l0 CDROM2 iso9660 mon off 00 dev scsi sc3dll0 CDROMA iso9660 mon off 00 Step 3 Reboot the SGI machine for the changes to take effect Options usr amass bin cdimport uv 1LrRU n userlable p path volumenumber Option Description Use the CD header defaults to AMASS import path L Display the CD s header information to the screen Does not import any files r Replace old path with the AMASS import path 3 52 Command Reference 6 00028 01 Rev A Managing the 5 File System Example Option R defaults to Description Mark the volume group available for both Reads and Writes Read Only u Usage statement U Display file names as uppercase defaults to On ISO 9660 formatted and High lowercase Sierra formatted CDs file names are displayed as lowercase Rockridge formatted CDs allow both uppercase and lowercase v Verbose messages n userlabel defaults to volume ID Specify a user identifiable
171. mmand Reference 6 00028 01 Rev A Managing the 5 File System Prerequisites Before using this command use the vollist command to make sure the Backup Volume has the following characteristics Options Volume number 1 Formatted not marked U for unformatted Inactive status In the last home storage slot or last position in the first library The last slot for SCSI attached storage devices or the last barcode position for network attached storage devices is defined as what is listed by the medialist utility For information on this utility see medialist on page 4 33 usr amass bin amassbackup uv d tapedevice 6 00028 01 Rev A Command Reference 3 9 Managing the AMASS File System Option Definition For libraries only no options Perform a partial backup back up just the Journal file to a Backup Volume in a library f Perform a full back up of the Database and Journal files to a Backup Volume in either a library or standalone drive u Usage statement v Verbose messages For standalone drive only d tapedevice Enter the standalone tape device that will write to the Backup Volume For example d dev rstO Perform a full back up of the Database and Journal to a Backup Volume in a standalone drive Example Step 1 Log in as either amass or root su root Step 2 perform a full backup to a volume wit
172. mple volume group 47 can contain WORM platters or it can contain erasable platters but it cannot contain both media types 1 14 Initial Setup Tasks 6 00028 01 Rev A Managing the AMASS File System Likewise the cleaning group must contain volumes with uniform drive specific attributes For cleaning volume groups see Create a Cleaning Volume Group on page 1 20 Disparate Media in the Space Pool The space pool can contain volumes with a variety of formats Therefore if a site uses both WORM and erasable optical platters AMASS always has a selection of media from which to pick For example if volume group 47 runs out of space AMASS automatically takes a volume from the space pool with the appropriate attributes and reassigns it to the out of space volume group Thus AMASS continues to write data to volume group 47 and performance does not suffer Using Numeric Volume Groups You can archive a specific directory by using numeric volume groups This concept is shown in the following illustration Library AMASS archive Volume Group 2 sales pubs 5 AMASS archives pubs files to volume group 2 6 00028 01 Rev A Initial Setup Tasks 1 15 Managing the AMASS File System When a Group Runs Out of Space Scenario By allocating project files from a subdirectory to specific volumes the data generated by the project can easily be added and rem
173. n a standalone drive NET network attached storage device Mounts How often this volume has been mounted in a drive since the Database entry was created e CL Cleaning volume Volumes in the space pool SP are not represented R W This field is not implemented in this release It will MB always display a zero Errors Number of errors for this volume 3 210 Command Reference 6 00028 01 Rev A Managing the 5 File System Field Last Mounted Description Date and time this volume was last mounted in a drive Hyphen Volume has not been mounted 6 00028 01 Rev A Command Reference 3 211 Managing the AMASS File System NOTES 3 212 Command Reference 6 00028 01 Rev A 4 Utility Reference Managing the AMASS File System NOTES 4 2 Utility Reference 6 00028 01 Rev A Managing the 5 File System Utilities The utilities described in this chapter are located in the directories listed in the following table Specify these directories in the system administrator s login PATH variable Tool s Login Path scripts root usr amass tools Hardware Utilities root usr amass utils Database Utilities root usr amass utils amassrecovery amass usr amass daemons ADIC recommends that you control the execution privileges for all utilities as appropriate for the desired security level at your site
174. nce 3 Commands ba eof e 3 3 eder Ped a eder oae 1 3 3 SE ULSGHDiIS 45 39 aco eae S Rn a 3 3 LE eset doe Sak wed amp Sar AE a IR Dm x xag bx cea esu e RAS 3 5 xiii dE eine iia RIS pd Esci Sd Fir impu Vi E va bead 3 5 EXAM E eyed pedet S edendis 3 6 gnassbaeRUpe ce hes ter ib i en vits 3 8 Prerequisites d daos Sets pd UU DEN vite d ote 3 9 UDHOLS 2435 deep up p dete utar ga bd tog date d qoas 3 9 Example sonet esie dapes den PEST eM SR POM HEN REN A 3 10 55 MNT PU 3 12 Grane raced Olam MOS os Cove epo e epe e Fo t o oo tb d p S 3 12 OPHONS Secus Biche Sibi Ede ODE Od etd EAE PRI Sd aa 3 13 Examples vov esso adii ERN Eu auque Dian da 3 17 amiassrestore ir ostro dH ied ime vr eim i a dee 3 19 OPHONS vues redeat van OR cedo ae Oel No ae abi pira 3 19 Example s 14 0 Rc bees a po emp Rea Ce bale aem de ba PE 3 21 6 00025 01 Rev A Contents xi Accessing Storage Devices amassstat UM O EASIER 3 24 Shutdown Tasks ua S E ERE bs 3 24 b RP RE ECPHa KEPT lie ebd pei 3 25 ORUM
175. nce for P 3 B Back Up Media 3 2 25203244 444 2 14 Backup automatic viacron 2 4 Commands oce as Do Rg ES S 2 14 database and journal 2 3 HP script example A 3 modify automatic cron schedule 2 5 6 00028 01 Rev A volume Rer ELM 1 3 Binaries 0 0 i aa a eia 5 5 Block Size COBLIPUTE Lu die eerste Aa aa 3 164 Behold B 3 Books all titles 5 P 6 bulkinlet Command 3 34 bulkload Command 3 41 bulkoutlet Command 3 47 C Cache C 3 cblist Command C 5 cbwghtlist Command C 9 edimport Command 3 50 Cleaning Group CPE ACH oet e PD 1 20 1 14 Command adl epa NS nte es 3 5 AMASS 3 3 aimassbackup o voe RU 3 8 3 12 3 19 amassstat 3 24 3 27 b ulkirilet 3 34 DURGA cs drain 3 41 bulkoutlet 3 47 5 cbwghtlist Sox oid C 9 Index INX 1 Managing the AMASS File System 3 50 vit ese 3 56 driveclean seo s 3 61 3 66 drivededicate 3 68 sra Tess 3 70 baba oes sone SE eh E 3 73
176. nd 3 128 Command Reference 6 00028 01 Rev A Managing the AMASS File System volclattr Prerequisites Define attributes for cleaning volumes For more information on drive cleaning see the driveclean command If a library automatically performs drive cleaning do not configure a cleaning volume group in AMASS To prepare for either automatic or manual drive cleaning perform the following steps Step 1 Step 2 Assign a cleaning volume to the cleaning group with the volnew command for SCSI attached libraries or bulkinlet command for network attached libraries Define drive specific attributes to a cleaning volume with the volclattr command For the required cleaning values refer to your specific drive manual Currently the CL volume group can contain only one type of cleaning cartridge For example if you have both a DTF drive and a 3590 drive your CL volume group must contain only DTF cleaning cartridges or exclusively 3590 cleaning cartridges AMASS automatically defines the correct drive specific values for IBM 3590 drives Do not alter these values 6 00028 01 Rev A Command Reference 3 129 Managing the AMASS File System Step 3 View cleaning attributes with the vollist g CL command if desired Cleaning volumes must be unformatted U Inactive I and Online Options usr amass bin volclattr uy c currentusage e errorcount m maxusage t
177. nd to zero For syntax see setvolerr on page 3 87 3 178 Command Reference 6 00028 01 Rev A Managing the AMASS File System View Attributes for One Volume Following is an example of the output for volume number 2 su root vollist 2 VOL VOL JUKE POS VOLLA FLAGS USED AVAIL MB DEAD ERRS NUM GRP BEL MB 2 673 1 net PUBS A 0 19503 0 0 1 volumes in volume group 673 AMASS assumes a compressed capacity of 2 1 ratio but some newer drives may have a compressed capacity of 3 1 Consequently the capacity displayed by the vo11ist command after a volformat Will currently show a 2 1 native GB capacity View Attributes for Volumes Following is an example of the output for all volumes in a library vollist VOL VOL JUKE POS VOLLABEL FLAGS USED AVAIL DEAD ERRS NUM GRP MB MB d ii net BACKUPVOLUME I 23 42984 0 0 2 800 1 net datal A 29827 12012 3 0 3 net data2 A 7730 35276 0 0 4 800 1 net data3 I 820 42187 0 0 6 00028 01 Command Reference 3 179 Managing the 5 File System 5 MV 1 net data5 JE 0 43007 0 0 5 volumes in filesystem View Attributes for Cleaning Group Following is an example of status output for the volumes in the cleaning group Cleaning volumes always have e Cleaning volumes always have the flags I CL for the volume group 9 9 inactive unformatted vollist g CL NUM JUKE POS LABEL USED AVAIL DE
178. nes how much data the system can back up in one evening The amount of data can exceed the capacity of one optical platter Every day the script does a partial backup within a manageable period of time one evening of a group of volumes in a volume group Therefore if you can divide the AMASS file system into 20 parts the script can do a complete backup in 20 days Backup Scripts for HP UX 6 00028 01 Rev A Managing the 5 File System bin sh Set abackup Purpose Store AMASS file system to tape Create a complete filelist of a given volume group in units of N volumes on an amass system for any streaming backup utility peripheral that can accept filename data to stdin such as cpio ftio and tar Input VOLGRP the name of the volume that you which to archive from 1 NMEGS the number of megabytes to be extracted per filelist from 2 tmp archivedate control file for backup modified during every complete backup Shell variables TEMPFILE temporary location for file listing MOUNTPT the directory where the amass is mounted ckE cH HTH HH od 6 00028 01 Rev A Backup Scripts for HP UX 7 Managing the AMASS File System Output A set of tapes the can be used to restore user files to an amass system Warning The output filelists can be very large
179. no a Activate the volume in the Database i Inactivate the volume in the Database eject it from the drive and return the volume to its home storage slot AMASS returns I O failure for any read requests associated with this volume u Usage statement y Suppress interactive messages volumenumber Enter the unique volume number Activate New Volume Step 1 Log as either amass or root Step 2 To create an entry in the File System Database and receive from AMASS a unique volume number use volnew command Step 3 load specified the volume number in a library use the volinlet command This command is not valid for libraries without a mailbox 6 00028 01 Rev A Command Reference 3 207 Managing the AMASS File System Step 4 To mark the specified volume number Online in the Database use the volloc command This command is not valid for libraries without a mailbox Step 5 StorageTek Redwood tape drives Enter the length of tape in the Database with the tapelength command Step 6 To format the specified volume number use the volformat command Step7 In the following example AMASS displays the current status of volume number 33 before asking if we want to change it Your response is shown in bold su root d volstat 33 Volume 33 in jukebox 1 is currently Inactive Would you like to change its status y n y Volume 33 status is now Acti
180. nt 2 15 Take a Drive Out OF ada Go Y adi e niei es aba i ert 2 16 Return a Drive to Service 5 dimen eRe bs QUE ere ER CES 2 17 Delete Files and Volume Number 2 18 Delete Volume Group usu wy ette rear Each Cent Vou 2 20 Recycled ease vee 2 21 Remove Media Prom libraty etes viae dete C 2 23 Reac ae e L a Lo etd 2 25 Optional Feature 255 a8 m epe ew ep Rab un 2 25 Prerequisites aleae Sad hid 2 25 Read Offline Vol mies xo OCURRA RC NP 2 26 Return Media Without Starting AMASS 5044 o reet ER Th UR ITE EPA 2 28 x Contents 6 00025 01 Rev A Accessing Storage Devices Add Space to Volume LE EPI Ds 2 29 o Eo e ESPERE Pay EIE CES ED VE 2 29 Create space FOO ces PRERQU E 2 30 hexssign Volume Group EP DOR 2 31 Activate the File System TIERE AVE E EE SR 2 33 Inactivate the File System 2 33 Modify Configuration File iia etn ato iet tacente 2 35 MAXIOSZ CHANGES fiat teas ebore tei siete 2 37 Command Refere
181. nt to apportion media into volume groups to keep project data or department data together on a specified number of volumes For information see Volume Groups Defined Page 1 13 Step 4 Load media and create entries in the AMASS File System Database for all your media For instructions see Create Entries in Database for Your Media on Page 1 9 Step 5 See Assign Directory to a Volume Group on Page 1 19 to assign a project directory or department directory to a volume group and to enable the volume group to use the space pool if it runs out of space Step 6 Decide if you want to have a volume group for cleaning cartridges For instructions see Create a Cleaning Volume Group on Page 1 20 1 8 Initial Setup Tasks 6 00028 01 Rev A Managing the AMASS File System Create Entries in Database for Your Media Make AMASS aware of your media by creating an entry for each volume in the AMASS File System Database by performing the steps in the following table For detailed information on the AMASS commands see the Command Reference chapter Step Command Description 1 Login as amass root 2 SCSl attached libraries volnew Create an entry for each volume in the AMASS File System Database If desired assign a volume to a volume group 3 Assign each volume to a home storage slot A64 Give each volume a user definable label test For example volnew 3 A64 test
182. ock list priority values for reads and writes per volume group A system administrator can keep files for a specific volume group in cache longer and the files can consequently be accessed more quickly by client applications P 4 Preface 6 00028 01 Rev A Managing the 5 File System Conventions The conventions used throughout the AMASS technical books are listed below Convention Example The word library usually includes jukebox and standalone drive and is a generic way to reference a storage device If using HP SunSpot jukeboxes install patch 1234 Screen text file names program names and commands are in Courier font Request to add a new volume Volume group will be 20 Volume position will be A123 The root prompt is shown as a number symbol su root What you should type in is shown in Courier bold font bulkinlet 1 2 10 21 23 Site specific variables are in a Times italics font tar xvf tapedevicename A backward slash 1 denotes the input is continued onto the next line the printed page is just not wide enough to accommodate the line rsh n dd if cdrompath amass load tar bs 20b tar xvBfb 20 Type the entire command without the backward slash Pressing lt Return gt after each command is assumed A menu name with an arrow refers to a sequence of menus Edit Policy gt Add Library 6
183. ollowing cd usr amass utils init element 1 6 00028 01 Rev A Utility Reference 4 277 Managing the AMASS File System mediaeject Eject media from a specified drive Options usr amass utils mediaeject drivenumber jukeboxnumber Option Description drivenumber Enter the drive number where the media is mounted jukeboxnumber Enter the AMASS library number defaults to 1 The mediaeject option ejects the media from the drive but does not return it to a storage slot The mediamove option will eject the media and move it to the given destination Example Stepl Log in as root su root 4 28 Utility Reference 6 00028 01 Rev A Managing the 5 File System Step 2 eject media from drive 1 in library 2 cd usr amass utils d mediaeject 1 2 Step 3 If a hardware error occurs refer to your hardware manuals 6 00028 01 Rev A Utility Reference 4 29 Managing the AMASS File System mediaerase Erase media starting at a specific block address through to one of the following ending block address e end of the media This utility destroys data Do not use this utility on media that contains data you want to keep This utility only supports optical media Options usr amass utils mediaerase drivenumber startblock endblock jukeboxnumber 4 30 Utility Reference 6 00028 01 Rev A Managing the 5 File System
184. olume group consists of media verified by a third party to be good for the AMASS Infinite File Life IFL optional feature For more information about IFL refer to the Infinite File Life manual Tip For a definition of volume groups see Volume Groups Defined on page 1 13 3 166 Command Reference 6 00028 01 Rev A Managing the 5 File System Options usr amass bin volgroup uy volumenumber volumegroup Option Description f Force the assignment of a volume to a volume group even if files exist on the media NOTE This option does not change the assignment for the directories and files To change an assignment use the setvolgrp command NOTE Make sure the metadata or attributes of the volume matches the attributes of the volume group you force the assignment to If the attributes do not match AMASS issues a message and does not complete the reassignment u Usage statement y Suppress interactive messages volumenumber Enter the unique volume number 6 00028 01 Rev A Command Reference 3 167 Managing the AMASS File System Option Description volumegroup Enter the volume group assignment Valid assignments are either A numeric value 1 through 2047 SP space pool A volume with files on it cannot be assigned to the space pool e CL cleaning group media verification group for the optional Infinite F
185. om the space pool to the out of space volume group so archiving can continue without interruption Consequently if your site uses different types of media the space pool should contain a mixture of media A space pool is defined with the AMASS volgroup command Options usr amass bin vgpool uy 3 120 Command Reference 6 00028 01 Rev A Managing the 5 File System cdeirstw j jukeboxnumber volumegroup Option Description Limits the specified volume group to use only CD media d Disable space pool e Enable space pool View whether or not the specified volume group can use the space pool When AMASS asks if you want to toggle the status type y for yes or n for no j jukeboxnumber AMASS will only use the space pool located in the specified library Use this option if you want AMASS to pull media from the space pool on a specific library Consequently when that space pool media is used up no more space is left EI defaults to optical media Limit specified volume group to only use rewritable optical platters from the space pool 5 Use standard non NSR media in this volume group t Limit specified volume group to use only tape media from the space pool u Usage statement volumegroup Enter the numerical volume group Valid values are 1 through 2047 6 00028 01 Rev A Command Reference 3 121 Managing the AMASS Fi
186. ommand Reference 3 113 Managing the AMASS File System Step 1 begin see the vgexport command The following figure illustrates our example At the Destination Site Step2 For barcode reading libraries Open the usr amass juke media file jukebox number file to verify that the barcode on the imported volume 67 will appear in the identified masks group Ifit will not appear run the update mask command After modifying the juke files do the following e RIX only Reboot the server to process these changes on AMASS Other operating systems Restart AMASS to process these changes 3 114 Command Reference 6 00028 01 Rev A Managing the 5 File System Step3 network attached storage devices Use the bulkinlet command to load volume 67 into the mailbox assign it to volume group 3 mark it Online and move it to a home storage slot For SCSI attached storage devices Use the volnew volinlet and volloc commands su root bulkinlet 3 AMASS assigns this media a new volume number it is now volume number 55 Step 4 Use vgimport to import the metadata that was sent with FTP into the File System Database The options in our example Imports the tmp newcustomers metadata file The metadata information applies to volume number 55 vgimport v 55 tmp newcustomers AMASS compares the tmp newcustomers metadata with volume number 55 in the library and expects t
187. omped or a volcomp procedure has aborted After a volcomp completes the volume is marked Inactive Inactive volume not currently used by AMASS K Reserved e Offline volume Volume has been quick formatted NOTE Valid only for optical media e R Volume is marked as Read Only This Occurs as a result of either 1 a write error that makes the media unwritable or 2 a user has forced the media to be Read Only with the volreadonly command U Volume not formatted W Media type is WORM Used Amount of space in MB occupied by files on the volume Avail Amount of space in MB available on the volume 6 00028 01 Rev A Command Reference 3 203 Managing the AMASS File System Field Dead Description Amount of space no longer referenced by files Expressed as a percentage of the total volume space the higher the percentage the greater the amount of dead space NOTE Volumes with high percentages are good candidates for the volcomp process Errors Number of errors on this volume Field For volumes in the cleaning group CL Description Current Usage Number of times a cleaning volume has been used Max Usage Maximum number of times a cleaning volume may be used Clean Time Amount of time in seconds a cleaning volume will remain in a drive 3 204 Command Reference 6 00028 01 Rev A Mana
188. on AMASS makes sure the media attributes from the first volume group match the 6 00028 01 Rev A Command Reference 3 163 Managing the AMASS File System attributes of the second volume group If the values do not match AMASS issues an error and does not complete the reassignment For information on numerical volume groups see Volume Groups Defined on page 1 13 Configure Block Size Thoroughly understand what this option does before using it Use the tape block size option blocksize with care Tip For detailed information on optimizing block size see Fine tune Block Size on page B 1 Refer to the AMASS Release Notes for a list of drives that support configurable block size Configure Compression Refer to the AMASS Release Notes for a list of drives that support compression AMASS assumes a compressed capacity of 2 1 ratio but some newer drives may have a compressed capacity of 3 1 Consequently the capacity displayed by the vo11ist command after a volformat Will currently show a 2 1 native GB capacity 3 164 Command Reference 6 00028 01 Rev A Managing the 5 File System Example Configuring Block Size and Compression Step 1 Log either amass or root Step 2 The following example formats volume number 1 with a block size of 128 KB and compression is enabled Block size Compression Suppress messages volformat y Volume number
189. or the AMASS File System Database For more information about this journal refer to Journal in Installing AMASS usr amass utils printjournal d did e date f fid j fullpath 3 jukeboxnum k L label n P position s dates t v vid Option Description Print contents of journal file to stdout d did specific drive id to print e date ending date of print MM DD YYYY hh mm ss f fid specific file id to print j fullpath current on disk journal only J jukeboxnum backup volume located in this jukebox k keep journal file on disk when done printing L label backup volume with this media label 6 00028 01 Rev A Utility Reference 4 43 Managing the AMASS File System Option Description n drive drive number to use 1 relative P position backup volume is in this slot date starting date of print MM DD YYYY hh mm ss print journal directory v vid specific volume id to print 4 44 Utility Reference 6 00028 01 Rev A Managing the 5 File System quedisplay Prerequisites Options Display what is in the queues The queues consists of a snapshot of the following items e An I O queue of READ and WRITE requests e An admin queue of AMASS administration commands e List of libraries drives and what volumes they manage AMASS must be running prior to executing quedisplay usr amass util
190. ort number 6 00028 01 Rev A Utility Reference 4 33 Managing the AMASS File System View Status for All Elements Step 1 Login as root su root Step 2 display the status for all elements in library number 2 enter the path utility and options similar to what is shown in the following example cd usr amass utils medialist j 2 Step3 If you have a SCSI attached library the output is similar to the example in the following example For a network attached library TRANSPORT 1 EMPTY the output displays a bar code SLOT 0A01 EMPTY instead of the slot address SLOT 0A02 FULL S indicates there is a volume SLOT 0A03 FULL 4 in the home storage slot PLOT QAQ amp PULL On ADIC FastStor libraries the SLOT 0A05 FULL message says FULL FROM SLOT 0A06 FULL unknown so SLOT 0A07 FULL SLOT 0A08 FULL The word INVERTED indicates MAILBOX 1 EMPTY the media is B side up in the DRIVE 1 SCSI_ID 5 FULL FROM 0A01 drive assuming the media was properly loaded into the library INVERTED A side up DRIVE 2 SCSI ID 6 FULL 4 34 Utility Reference 6 00028 01 Rev A Managing the 5 File System View Status for One Element Be careful when you ask for the status for a single element because the output could be misleading as illustrated in this example To display the inventory for one element perform the following steps Step 1 Login as root su root
191. ot 6 00028 01 Rev A Operational Tasks 2 33 Managing the 5 File System Step Command amassstat u For example amassstat i t 600 AMASS inactivate in 600 seconds 10 minutes Description INACTIVATE the AMASS file system AMASS generates an error if a client attempts to access files while the file system is INACTIVE If files were waiting in the cache for more space to be added to a volume group AMASS prints a warning message and maintains these files until the file system is reactivated and space is made available 2 34 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Modify Configuration File Change the AMASS library configuration in response to the following circumstances if you e change a library s SCSI or RS 232 address upgrade or downgrade a library to a different model or vendor and you receive a new authorization string from your AMASS vendor e change the number of drives in a library e add anew library to the configuration and you receive a new authorization string from your AMASS vendor e resize or move the cache space change configuration values To modify the AMASS library configuration use the procedure in the following table For detailed information on the commands used in these steps see the Command Reference chapter 6 00028 01 Rev A Operational Tasks 2 35 Managing the AMASS File Syste
192. ou load volumes 1 through 6 and volume 3 is unsuccessful AMASS successfully loads volumes 1 and 2 but does not load volumes 3 4 5 and 6 Options usr amass bin bulkinlet uy e volumenumber volumegroup Uukeboxnumber Option Description e Loads and marks existing volumes online in the File System Database 3 38 Command Reference 6 00028 01 Rev A Managing the 5 File System Option volumenumber Description Enter the unique volume numbers you want to unload from the library and mark Online in the Database To list more than one volume separate the numbers with a comma or with a hyphen For example bulkinlet e 1 8 ejects volumes 1 and 8 bulkinlet e 1 8 ejects volumes 1 2 3 4 5 6 7 and 8 Reload Existing Volumes Step 1 Log either amass or root su root Step 2 Place several volumes in the multislot mailbox 6 00028 01 Rev A Command Reference 3 39 Managing the AMASS File System Step 3 Enter the command as shown in the following illustration In our example we reload three volumes bulkinlet e 126 134 137 The picker reads the barcode and returns the volumes to their home storage position 3 40 Command Reference 6 00028 01 Rev A Managing the 5 File System bulkload Tip This command is valid only for network attached storage devices Supported Network Libraries
193. ount request if the notation 15 at least eight bytes long and contains no unprintable characters that would corrupt the display For more information on reading offline volumes see Read Offline Volume on page 2 25 6 00028 01 Rev A Command Reference 3 193 Managing the AMASS File System voloutlet Eject volume to the mailbox and mark offline Tip This command is valid for both SCSI attached and network attached storage devices Tasks The following tasks are valid for libraries with a mailbox e Bjects a volume from home storage slot to the mailbox e Marks the volume Offline in the File System Database If media is currently in the drive AMASS returns the media to its home storage slot before outletting the specified volume to the mailbox Options usr amass bin voloutlet uyl volumenumber 3 194 Command Reference 6 00028 01 Rev A Managing the 5 File System Option Description u Usage statement y Suppress interactive messages volumenumber Enter the unique volume number you want to outlet from the library and mark Offline in the Database 6 00028 01 Rev A Command Reference 3 195 Managing the AMASS File System volreadonly Mark volume either e Read Only e Read and Write This command is not valid for volumes in the space pool or in the cleaning group Options usr amass bin volreadonly uy rw volumenum
194. oup assignment of the accompanying metadata Valid assignments are 1 through 2047 This volume group must not contain either hard links or symbolic links NOTE After the process has completed AMASS marks the volume group as Read Only to prevent it from being changed 3 108 Command Reference 6 00028 01 Rev A Managing the AMASS File System Example This example assumes we have two AMASS installations one in Denver and one in Texas that need to share data The Denver site collects data used by the Texas site At the Source Site Step 1 Step 2 Step 3 Step 4 In Denver collect data and write it to volume group 3 in AMASS file system Every Friday afternoon log in as either amass or root For SCSI attached storage devices Use the voloutlet command to unload volume 67 which is assigned to volume group 3 from the library For network attached storage devices Use the bulkoutlet command su root d voloutlet 67 Use the vgexport command as shown in the following example User defined metadata path vgexport f tmp newcustomers 3 Volume Group This metadata file is useless without the accompanying volume 67 assigned to a volume group 3 6 00028 01 Rev A Command Reference 3 109 Managing the AMASS File System Step5 AMASS marks the volume group Read Only to prevent the files from being changed Step 6 Use FTP File Transfer Proto
195. oved from the library without affecting data generated by other projects Or you can mark the volumes OFFLINE and remove them from the library for offsite storage When you assign a subdirectory to a numeric volume group only writes from that subdirectory are written to the specified volume group No other data is placed in that volume group To continue writing to an out of space volume group you have two options e Assign more volumes to the numeric volume group e Allow AMASS to automatically take volumes from space pool and reassign them to the out of space volume group However to allow AMASS to do this you must enable the volume group to use the space pool The following figure illustrates how directories can be defined under the AMASS mount point and how volume groups can be used to consign directories 1 16 Initial Setup Tasks 6 00028 01 Rev A Managing the 5 File System archive production reports amass_nt Volume number 5 5 Volume Group 6 Volume numbers 2 amp 4 client 2 4 server Volume numbers 3 6 amp 9 Volume Group 33 X9 Space pool is enabled Volume Group 0 for this volume group The projects directory is the root directory for volume group 0 If new files or new directories are added under archive they belong to volume group 0 unless you assign them to a specific volume group e The amass_nt directory is the root directory for volum
196. p 4 By default a core file is dumped to the etc rc file After information has been dumped enter the following cd etc rc ls The rc directory should contain entries similar to those shown in the following example If more than one core has been dumped there will be files with extensions greater than zero The file with the highest number represents the latest core dump bounds hp ux 0 hp core 0 bounds hp ux 0 hp core 1 bounds hp ux 0 hp core 2 After determining the cause of the panic delete any core files with the UNIX rm command 6 00028 01 Rev A Troubleshooting Tools 23 Managing the AMASS File System IBM Step 1 When AIX operating system was installed a dump device is automatically configured The default on most models is dev hd7 Step 2 When the system panics it automatically dumps information to the core file and the LEDs on the front of the processor display Oc9 Step 3 After information has been dumped the LEDs flash 888 For additional information on system initiated dumps refer to the IBM Problem Solving Guide and Reference manual SGI and Sun Step 1 Create a directory called dir where the core files can reside Make sure there is plenty of disk space to contain this directory because the size of the dump depends on the amount of memory in the system and can be quite large Step 2 Modify the system startup file with a call to savecore as described for the
197. pears Hung on page 3 Example Step 1 Step 2 Log in as root su root Following the path and script name enter the process ID 4 cd usr amass tools amass snap processID The output looks similar to the following amassconfig this file was generated by config prod vlk data size 2698 vlk nochash vlk maxch 40 arch dsectsz 512 3 gine 6 1 kilobytes 4097786 mes 79 vlk sendbcount 5 6 00028 01 Rev A Utility Reference 4 9 Managing the AMASS File System amass start Performs the following tasks Start the AMASS daemons Mount the AMASS file system When to Use Script For an example of when to use this script see e AMASS Does Not Start on Page 16 e UNIX Server s Partitions Crash on Page 17 Example Step 1 Login as root su root Step 2 Following the path and script name enter your AMASS mount point 4 usr amass tool amass start archive 4 10 Utility Reference 6 00028 01 Rev A Managing the 5 File System List of Startup Daemons The startup daemons are located in usr amass daemons and are listed in the following table Daemon Description amassmain AMASS database manager and parent of other daemons amassrecovery AMASS startup and recovery program Im ip AMASS database lock controller qset Schedules both read and write request including automatic dri
198. pool re j2 3 Volume group 3 is now Space Pool Enabled Volume group 3 is now Rewritable Jukebox number is now 2 6 00028 01 Rev A Command Reference 3 123 Managing the AMASS File System Enable Volume Group to use Tape Media Step 1 Log in as either amass or root Step 2 define media for an out of space volume group that currently is without volumes in it AMASS defaults to optical media If you want tape you must use the option with the vgpool command vpgool t 3 124 Command Reference 6 00028 01 Rev A Managing the AMASS File System vgreadonly Characteristics Options Define a volume group as one of the following e Read Only Read and Write A volume group identified as the space pool SP or cleaning group CL cannot be marked Read Only A volume group with Read Only media has the following characteristics e Volume group is not available for writes deletes volcomps or volcleans e New directories cannot be added to the volume group and existing directories cannot be deleted A file in the volume group cannot be removed or renamed and its metadata file attributes such as access time user id etc cannot be changed usr amass bin vgreadonly 6 00028 01 Rev A Command Reference 3 125 Managing the AMASS File System uy rw volumegroup Option Description no options View status for the specified volume group
199. ption Description y Suppress interactive messages Enter a value between 0 and 99 percent defaults to 0 6 00028 01 Rev A Command Reference 3 201 Managing the AMASS File System Example Following is an example of output generated with a dead space percentage greater than or equal to 33 percent AMASS asks for confirmation of the process su root volspace 33 Retrieving all volumes with dead space 33 LS baig Correct hy y NUM GRP JUKE POS LABEL FLAGS USED AVAIL DEAD ERRS 2 1 il NET TEST A EOE OSS 310 33 0 2 19 1 NET PUBS 5 195033 10 45 0 67 673 1 NET ENG A C 195033 0 317 0 3 volumes have dead space 33 Output Fields Defined The following fields are generated by this command Field Description Volume Number Volume number Volume Group Volume group assignment Jukebox Number Reference number 3 202 Command Reference 6 00028 01 Rev A Managing the 5 File System Field Position Description Home storage slot Valid entries are e 4 alphanumeric designation SCSI attached storage device n a standalone drive NET network attached storage device Volume Label Either User assigned name Preprinted barcode Flags For more information see Flags Defined on page 3 205 Status of volume not volume group e Active volume used by AMASS e C Volume is being volc
200. ptional Feature Save sere SEINS ADU 3 111 Name ONS Los eta dauid vs ps ex T gai SE REY 3 111 CODBODS otar iwi PENTE SS hid PER E ER bed debe eb ew 3 112 oe ahead Mee aaa eas 3 113 3 117 ODHONS Tub eA PLAT td PADRES TEES 3 117 Examples Part eet ae ws Deu 3 118 orarie 3 120 ODBOLS senio vt es ve etes een rat qi ade A qu Mute affa utat dta 3 120 Enable Volume Group to use Space 1 3 122 Limit Media Usage and Location of Space Pool 3 123 Enable Volume Group to use Tape Media Suse aea 3 124 vgreadonly syi war susie AEE Mak OTE EER MEE 3 125 Characteristics eos Side ion Sud bar deg de t eS AED RE PRES 3 125 OPHONS sient near oa oce 3 125 bend ode pei eder e bb vex bia m ode vette 3 127 Options ueste este Velo osea itus sitit sata pies 3 127 Example iss VEN Mey eae as Sabena Gees be nA 3 128 belle ia AR RT DSH DAE RG DOWER 3 129 Prerequisites yetgoni Gel rag ORG a GU vel ace ee end 3 129 d es vem ire ebd uel EN OU CLE RP E ed dr 3 130 VOSA s eo ba duet nba ds o dea Piet
201. r counts on the specified volume jukeboxnumber Enter the library number where the defaults to 1 volume resides 6 00028 01 Rev A Command Reference 3 87 Managing the AMASS File System setvolgrp Options Assign directories and subdirectories to a specified volume group This assignment allows you to restrict the allocation of space for the directory and its subdirectories to a specified set of volumes The AMASS file system must be mounted and running prior to using this command This command is not valid for volumes in the space pool or in the cleaning group The process recursively descends through the specified path assigning the terminating directory and any of its subdirectories whose original volume group matched that of the parent directory to the volume group Because new directories and files are always put into the volume group of their parent directory this assignment creates a logical UNIX mount point where all files stored in this tree are placed usr amass bin setvolgrp uy 3 88 Command Reference 6 00028 01 Rev A Managing the 5 File System path volumegroup Option Description f Force the assignment of new files to a specified volume group even if there are existing files under the path tree NOTE This option works only six levels deep Therefore run it as many times as necessary u Usage statement y Suppr
202. r root su root Use the bulkinlet command to create the initial entries in the File System Database and receive unique volume numbers from AMASS for each volume Run bulkload s to synchronize the Database that is based on an inventory of the library and the library s interface New volumes in the File System Database have an initial status of unformatted U and inactive I To make the new volumes usable change the characteristics of the volumes with the commands listed in the following table Command Characteristic vollabel Enter the preprinted alohanumeric barcode label in the File System Database StorageTek Redwood tape drives only tapelength Enter the length of tape in the Database volformat Format the volumes 3 44 Command Reference 6 00028 01 Rev A Managing the 5 File System Manually Load New Volumes Introduce new volumes to both the File System Database and to the library interface by performing the following procedure Step 1 Step 2 Step 3 Step 4 Step 5 Make sure the power is off Power off the library before opening the library door Log in as either amass or root su root Manually load media directly into a home storage slot or remove media from a slot Run the appropriate command from the following list to update the library interface e AML run the inventory command from DAS if you are using an AML e IBM run
203. re midnight on January 1 1998 3 14 Command Reference 6 00028 01 Rev A Managing the 5 File System Option e errnumber e lt errnumber e gt serrnumber Description Only list files that have a Specified error number Enter for example e 49 to select all files with an error of 49 Lower or higher error number Enter a string that contains less than or greater than gt relationship operator enclosed in quotes For example e 220 selects all files with an error number greater than 20 Option g gid Description Only list files with a specified group ID L length Only list files with a specified page length 1 date time 1 date time 1 date time time defaults to midnight Only list files with a timestamp that shows when file was accessed Ona specific date and time On earlier or later timestamp Enter a string that contains before or after gt relationship operator enclosed in quotes For example 1 gt 12 06 1998 08 00 00 selects all files accessed after gt December 6 1998 at 8 00 a m Format for date is MM DD YYYY and the format for time is hh mm ss The date is required The time defaults to midnight For example 1 gt 12 06 1998 selects all files after gt midnight on December 6 1998 6 00028 01 Rev A Command Reference 3 15 Manag
204. re the defaults to 1 specified drive resides Example Step 1 Log as either amass or root su root 3 62 Command Reference 6 00028 01 Rev A Managing the 5 File System Step2 Assign a cleaning volume to the cleaning group For SCSI attached storage devices use the volnew command volnew CL n a cleanme For network attached storage devices use the bulkinlet command where Value Description CL Assign to the cleaning volume group n a Designate a home storage slot n a standalone drive cleanme Enter a user defined name for this volume AMASS assigns this media a unique volume number for example 49 Step 3 Define drive specific attributes to this cleaning volume with the volclattr command For the required cleaning values refer to your specific drive manual i volclattr m 106 t 120 49 6 00028 01 Rev A Command Reference 3 63 Managing the 5 File System where Value m 106 Description Number of times this cleaning volume can be used t 120 Number of seconds drive will be cleaned 49 Cleaning volume number Step 4 To view the current attributes of our cleaning volume and verify that we have done this exercise correctly use vollist with the g option to view the attributes of the cleaning group Cleaning volumes must be unformatted U Inactive 1 and Online Cleaning volumes always have
205. rectory name or file name on the specified volume Directory Zero directory Logical block Start of file s block address in logical format address Size Size of the file in MB Mode File permissions Links Number of hard links for this file UID Numeric user ID GID Numeric group ID Access time Last time file was accessed Modified time Last time file was modified 6 00028 01 Rev A Command Reference 3 153 Managing the AMASS File System TIME Format Inode Example Fields Description StorageTek drives Displays only if the option is used Start of the file s block address appears as a hexadecimal number enclosed in parentheses Device block address The Access time and Modified time values have the following format yyyymmddhhmmss For example the value 19980307114408 1998 March 07 11 44 08 a m This format allows you to sort by time which is useful when creating a list of files created at a specific date and time The following output shows an example of the inode output for volume number 2 volfilelist i 2 vg800 bg1 6 2 204801 vg800 01Mar182007 15 2 977033 File Name Volume Number Inode Logical Block Address 3 154 Command Reference 6 00028 01 Rev A Managing the 5 File System File Names Last Example The following output shows an example of the file names in the last field position volfilelist 2 2 204801 vg800 bg1 2 977033 vg80
206. rin volfilelist 2 sort n 1 2 Numerically sorts files based Prints just the file names first upon volume then based upon logical block address Step 3 back up the files on volume 2 to your magnetic disk substitute mydir vol2 tar for dev xmt 0m 6 00028 01 Rev A Command Reference 3 157 Managing the AMASS File System volformat Prerequisites Format media with specified attributes Tip Optical platters only Because a full format can take a long time more than 40 minutes ADIC recommends that you format these volumes during off hours If you create a zero length file within an AMASS directory ex touch filename the file is not associated with a volume or volume group This command will ignore such files However a zero length file i e a non zero length file that was written to tape and then truncated to zero length will be recognized Before using this command the volume must have the following characteristics BeOnline Use the volloc command to view and toggle status Contain no data that you want to keep e Not assigned to the cleaning volume group CL 3 158 Command Reference 6 00028 01 Rev A Managing the 5 File System Options usr amass bin volformat uy pq b blocksize c on off d num volumenumber Option Description no options For optical platters Perform a full format NOTE
207. rive clean the drive and eject the cleaning volume Prerequisites To prepare for tape drive cleaning perform the following steps Step 1 Step 2 Step 3 Assign a cleaning volume to the cleaning group CL with the volnew command for SCSI attached libraries or the bulkinlet command for network attached libraries Use the volclattr command to define drive specific attributes Currently the CL volume group can contain only one type of cleaning cartridge For example if you have both a DTF drive and a 3590 drive your CL volume group must contain only DTF cleaning cartridges or exclusively 3590 cleaning cartridges e For appropriate cleaning attributes refer to your drive manual e Accept the AMASS generated default values for IBM 3590 drives Do not alter these values View cleaning attributes with the vollist g CL command if desired 6 00028 01 Rev A Command Reference 3 61 Managing the AMASS File System Options usr amass bin driveclean uy V volumenumber drivenumber Uukeboxnumber Option Description u Usage statement y Suppress interactive messages V volumenumber Enter the unique volume number that represents a cleaning volume If this option is not used AMASS selects an appropriate cleaning volume from the CL cleaning volume group drivenumber Enter the drive number that needs cleaning jukeboxnumber Enter the library number whe
208. rive1 1 Drive2 Drive3 The drivestat command configured any time during AMASS operation affects The IDLETIME parameter behavior on a specified drive configured during AMASS installation affects all drives To disable the idle eject feature for all your drives both the global IDLETIME parameter and the per drive drivestat command must be set to zero The following table summarizes the correlation between the global and per drive values Behavior Global Per Drive Per Drive value takes affect N A 50 Global value takes affect 50 0 Feature disabled 0 0 6 00028 01 Rev A Command Reference 3 75 Managing the AMASS File System Output Examples Eject Value for A Drive Eject Value for All Drives Following are examples of output generated by the idle eject option In the following example we set the tape drive to eject idle volumes after 480 seconds drivestat e 480 1 Setting Idle Eject value for drive 1 juke 1 from 0 to 480 seconds OK y n y Drive 1 in juke 1 will eject idle volumes after 480 seconds In the following example we set the drive to zero timeout the idle eject feature will be disabled for all drives This example assumes the global IDLETIME parameter has been set to zero also drivestat e 0 all Setting Idle Eject value on all drives from 480 to 0 seconds OK y n y Drives will not eject idle volumes feature disabled 3 76
209. s quedisplay Option Description View streaming tape I O cache blocks NOTE Valid only for specific tape drives q Displays the volume number and the number of read and write requests in the queue for that volume 6 00028 01 Rev A Utility Reference 4 45 Managing the AMASS File System When to Use Utility Use this utility to diagnose the following problems You write to a file but the drive light does not come on The system is slowing down An AMASS command does not complete Supported Drives The following table lists tape drives that support streaming I O Tip To obtain the current list contact your AMASS sales representative Tape Drives IBM 3570 Quantum DLT 8000 IBM 3590 B1A Sony GY 2120 DTF 2 Requires FW level 1 10 IBM 3590B1 A ultra StorageTek Redwood SD 3 IBM 3590E1A StorageTek 9840 Quantum DLT 7000 Sony SDX 500 DLT customers ADIC recommends that you enable the Tape Streaming feature Using tape streaming IO will eliminate start stop cycles on these drives which leads to better tape handling For instructions on configuring AMASS for tape streaming refer to the Optional Parameters appendix in the Installing AMASS book 4 46 Utility Reference 6 00028 01 Rev A Managing the AMASS File System Example Step 1 Step 2 Step 3 Displays with the q option A read request Record ID rid
210. s u Usage statement y Suppress interactive messages drivenumber Enter the drive number jukeboxnumber Enter the library number where the specified defaults to 1 drive resides 6 00028 01 Rev A Command Reference 3 69 Managing the AMASS File System drivelist View condition and errors for drives Options usr amass bin drivelist uy drivenumber Uukeboxnumber Option no options Description View condition of all drives in all libraries Usage statement y Suppress interactive messages drivenumber View condition and errors of specified drive jukeboxnumber defaults to 1 Enter the library number where the specified drive resides 3 70 Command Reference 6 00028 01 Rev A Managing the 5 File System Reset to Zero Use the setdrverr command to reset the error counts reported by the drivelist command to zero For syntax see setdrverr on page 3 86 Example Following is an example of output generated by this command to obtain status on library number 3 which has two drives The output indicates that drive 1 of library 3 is Active and marked as dedicated write and drive 2 of library 3 is Inactive None of the drives have any errors su root drivelist 1 3 4 drivelist 2 3 DRIVE JUKE STATUS ERRORS 1 3 AD 0 DRIVE JUKE STATUS ERRORS 2 3 I 0 drivelist 2 drives configured in this system Output Fields De
211. s per volume group If you do not use the Enhanced Cache Control feature AMASS reuses the cache block at the head of the free list which is the oldest cache block in the system However by using both the setcblist and setcbwght commands AMASS will instead reuse the cache block list with the highest weight factor score Therefore a system administrator can keep files for a specific volume group in cache longer and the files can consequently be accessed more quickly by client applications These new cache control commands are located in usr amass bin Command Page setcblist C 3 cblist C 5 setcbwght C 7 cbwghtlist C 9 setcblist Assigns a read and write cache block list value for a specific volume group The values are separate for reads and writes within the volume group 6 00028 01 Rev A Cache Commands C 3 Managing the AMASS File System Options usr amass bin setcblist r read list volumegroup w write list volumegroup Option Description u Usage statement y Suppress confirmation and informational messages r read list volumegroup Assign the specified volume group a read cache block list value Values faults to 1 he list detaulis to T caene lis can be from 1 through 8 value w write list volumegroup Assign the specified volume group a write cache block list value Values faults to 1 he list can be from 1 through 8 val
212. se find newer etc archivedate print gt tmp BACKUPFILES if tmp AMASSOUTS DAYTYPE then cat tmp AMASSOUTS gt gt tmp BACKUPFILES fi cat tmp BACKUPFILES ftio oxpp gt dev null End of example 2 A 10 Backup Scripts for HP UX 6 00028 01 Rev A Fine tune Block Size Managing the AMASS File System NOTES B 2 Fine tune Block Size 6 00028 01 Rev A Managing the 5 File System Optimize Tape Block Size Supported Drives Overall system performance is generally improved by configuring the block size that AMASS uses to write to a tape drive Tape block size is configured with the volformat b blocksize command You cannot change block size on existing volumes only on new volumes For a description of this command see volformat on page 3 158 Thoroughly understand what this option does before making any configuration changes Use the tape block size option with care Refer to the AMASS Release Notes for a list of drives that support configurable block size Calculating Block Size Several factors must be considered when arriving at a value for your tape block size e Your typical file size your media utilization capacity and your expected site performance throughput e Your system s MAXIOSIZE value e Your drive s READ BLOCK LIMIT 6 00028 01 Rev A Fine tune Block Size B 3 Managing the AMASS File System
213. sh bu etes ap pu Va e e ey beds 3 66 HONS uod ne nr Se oe INI m eR es wid es ope dud ra 3 66 sat 4 ct fats ed s 3 68 UJDHOLIS hir dera bel au ads bue bag pa o PEU pa qe bad 3 68 PRU S DOSES bur de soir 3 70 OpHONS sesto axi chara bacis Dy abe acis boi e And reca Rote 3 70 Zeto Pr CN ee PUE CPU CIE eS 3 71 Examples LER AMAN RES ER 3 71 CY SIA ES et a Re a 3 73 OPUONS AM 3 4 2M TA qa rid 3 73 IDELETIM E tete So aceto a c foe atia dta bol etat 3 74 6 00025 01 Rev A Contents xiii Accessing Storage Devices fileonmedid iss t PERI Oe Tag hee E CMS e 3 79 OpHODS a2 od E aiu CELERE as A e ex Re REY 3 79 File places ys oe a aaa pee aoa PO Rees 3 80 healiheheck fen pee duces ce kad amare Oe ae S oed vec oes 3 81 dos Sat Sakis pae atit eL eua nee 3 81 Pxampleusasoeebe tedete CL boas 3 84 SELCIEVODPT agens erac ak ROE Notes ao aed x 3 86 iet euge E ec o t o Eau dan Kore Pad 3 86 setVole eT PAGG APR Duda det ies vnius Sud 3 87 ceca we Rd ud Cos oeque tors CCS Ew 3 87
214. signed to volume group 121 6 00028 01 Rev A Operational Tasks 2 29 Managing the 5 File System Create Space Pool Step Command Description 1 Log in as amass root 2 volgroup volumenumber Assign a formatted volume to SP the space pool For example Volume numbers 24 and 25 are voler up 24 25 SP assigned to the space pool 3 vgpool e volumegroup Enable a volume group to use For example the space pool If volume group 31 runs out of space it takes a volume from the space pool and writes continue vgpool e 31 2 30 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Reassign Volume Group To reassign new files in the amass nt directory as illustrated in the following figure to another volume group use the procedure in the following table archive unix amass datamgr Volume numbers 3 6 amp 9 67 9 Volume Group 0 production Volume numbers 2 amp 4 Volume Group 33 Volume number 5 5 Volume Group 6 Space pool is enabled for this volume group For detailed information on the commands used in these steps see the Command Reference chapter 6 00028 01 Rev A Operational Tasks 2 31 Managing the AMASS File System Step Command Description 1 Log in as amass Or root 2 vollist g volumegroup List the volumes in a volume For example group 3
215. ss tools killdaemons f t seconds which brings AMASS down in the specified number of seconds As a result of using killdaemons the system administrator may notice that flag states flags such as A active C volcomped inactive K reserved O offline Q quick formatted U unformatted may be affected For example a volume might show a flag state of both Q and U formatted and unformatted To display the correct flags you must rerun the AMASS administrative command that manipulates the flag for example rerun the volformat command Internal ADIC testing has found this to affect the volformat volinlet and voloutlet commands 4 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System Operating Issues The following table lists operating issues Operating System All Issues AMASS supports a file pathname limit of 1023 characters For example if files are going under archive oursitefiles on AMASS then the length of this string 21 characters must be subtracted from 1023 1023 21 1002 Consequently succeeding file pathnames can be a total of 1002 characters in length All AMASS does not support running binaries in the AMASS file system All The Macintosh operating system uses a separate data stream called a resource fork to store icons and other resource information When AMASS archives this file the UNIX system truncates this resource fork without
216. sstat i command e Unmount AMASS file system e Kill the AMASS daemons When to Use Script For an example of when to use this script see e AMASS Database is Bad on Page 6 e UNIX Server s Partitions Crash on Page 17 Options usr amass tools killdaemons t seconds 4 22 Utility Reference 6 00028 01 Rev A Managing the AMASS File System Option Description no options Brings AMASS down if there are no outstanding IO requests f Forces AMASS down cancels all outstanding IO requests t seconds AMASS will come down in the specified number of seconds As a result of using killdaemons the system administrator may notice that flag states flags such as A active C volcomped inactive K reserved O offline Q quick formatted U unformatted may be affected For example a volume might show a flag state of both Q and U formatted and unformatted To display the correct flags you must rerun the AMASS administrative command that manipulates the flag for example rerun the volformat command Internal ADIC testing has found this to affect the volformat volinlet and voloutlet commands Example To run killdaemons perform the following steps Step 1 Login as root su root 6 00028 01 Rev A Utility Reference 4 23 Managing the AMASS File System Step 2 make sure there are no pending write requests in the AMASS queue
217. st values for volume groups 121 through123 su root di cblist 121 123 VOLGRP Read Write 1 6 122 3 2 IQS 2 2 setcbwght Assigns weight factor values to the cache block list numbers AMASS uses this weight factor to determine which cache block to reuse next and reuses the cache block with the highest score The score is calculated by the weight factor defined with the setcbwght command associated with the list the cache block is on defined with setcblist command multiplied by the age of the cache block weight factor age of cache block score Age of cache block current time MINUS time cache block was put on free list When the cache block is reused it is taken off the free list and put back on when processing has completed When it is put back on AMASS creates a new timestamp for the block The oldest block is the one that has not been accessed for the longest period of time in seconds 6 00028 01 Rev A Cache Commands C 7 Managing the AMASS File System Options usr amass bin setcbwght uy cachelist number weight factor Option Description Usage statement y Suppress confirmation and informational messages cachelist number Enter a cache block list value from 1 through 8 weight factor defaults to 1 Enter a weight factor value This value is a positive 32 bit number 0 zero Provides a way to prioritize blocks that reside on a sp
218. t Enter a 255 character user defined description for the specified volume Enclose the string in quotes d volumenumber Delete the description for the specified volume 6 00028 01 Rev A Command Reference 3 191 Managing the AMASS File System The following example generates a list of all volumes and their descriptions su root di volnote VOLNUM DESCRIPTION 1 Backup volume 2 This is a Cleaning volume 3 Project Y2k for accounting dept The following example generates the description for volume 2 volnote 2 This is a Cleaning volume The following example allows you to create the description for volume 4 Using the y option suppresses the confirmation message You can also change the description by using this combination of options volnote y 0004 This volume contains information about our super duper new product that is extremely important to the whole wide world The following example allows you to delete the description for volume number 3 Using the y option suppresses the confirmation message volnote y d 3 3 192 Command Reference 6 00028 01 Rev A Managing the 5 File System Tip To remove the volume description as well as all other information pertaining to the volume use the AMASS voldelete command For offline volumes the Offline Media Manager run with the sysop command displays the volume description as part of the m
219. t was written to tape and then truncated to zero length will be recognized Volcomp will not move the file and will exit with These are files left after volcomp Dead space is space that has been previously written to by AMASS A volume that contains scattered files separated by great expanses of dead space is a waste of media This command helps you to recycle this wasted space 3 134 Command Reference 6 00028 01 Rev A Managing the AMASS File System After the volcomp process completes the original volume is without data so AMASS marks it Inactive in the File System Database To reuse the volume format it with the volformat command Dead Space Dead Space Volume number 49 has a lot of dead space Source Volume 49 AMASS rewrites File2 to volume number 50 which is in the same volume group as volume 49 Target Volume 50 Prerequisites Before using this command Mark the target volume Active with the volstat command Mark the volume group for Reads and Writes with the vgreadonly w volumegroup command There must be enough free space in the volume group to rewrite all data from the source volume e You must have at least one available drive e Run volcomp during off hours For better performance run this command on a volume group when no other activity is taking place on the specified volume group 6 00028 01 Rev A Command Reference 3 135 Managing the AMASS File System
220. tep3 See example of the output for the LAST MODIFIED and LAST ACCESSED in seconds since 1970 in the following illustration LAST MODIFIED LAST ACCESSED MODE VOL SIZE 937493088 937493088 sijecam 4 85899345 Step 4 Enter the following options to see file access and modification time dates NAME FILEID PARENT UID GID fname 6084 3 0 1 amassreport n filename 6 00028 01 Rev A Command Reference 3 17 Managing the AMASS File System Step 5 See an example of the dates output in the following illustration NAME FILEID PARENT GID LAST MODIFIED 6084 3 0 1 LAST ACCESSED Sept 16 08 44 MODE VOL SIZE 4 85899345 Sept 16 08 44 3 18 Command Reference 6 00028 01 Rev A Managing the 5 File System amassrestore Options Restore from a Backup Volume located in either a library or a standalone drive the following files File System Database e Journal AMASS Do not use this command when AMASS is running To shutdown AMASS refer to Site Specific Tasks chapter in Installing usr amass bin amassrestore uv 6 00028 01 Rev A Command Reference 3 19 Managing the AMASS File System Option Definition t View files on the Backup Volume Does not restore any files u Usage statement v Verbose messages e date time Restore files from the Backup Volume with a timestamp equa
221. th a volume or volume group This command will ignore such files However a zero length file i e a non zero length file that was written to tape and then truncated to zero length will be recognized Prior to using this command make sure the volume is in its home storage slot The volume must be Online volloc n readable writable and Inactive volstat i If AMASS determines files exist on this volume it prompts you to confirm their deletion If a file is appended spans to another volume AMASS deletes the entire file After volclean completes make the volume available for reuse by using the volformat command 3 132 Command Reference 6 00028 01 Rev A Managing the 5 File System Options usr amass bin volclean uy volumenumber Option Description u Usage statement y Suppress interactive messages volumenumber Enter the unique volume number 6 00028 01 Rev A Command Reference 3 133 Managing the AMASS File System volcomp Recover dead space by rewriting remaining data on a volume to a different volume in the same volume group This command is not valid for volumes in the space pool or in the cleaning group If you create a zero length file within an AMASS directory ex touch filename the file is not associated with a volume or volume group This command will ignore such files However a zero length file i e a non zero length file tha
222. the AMASS drivestat a drivenumber command to reactivate the drive AMASS Will Not Clean AMASS will not clean drives under the following conditions if a cleaning volume e exceeds the maximum number of errors exceeds its usage count e is not available Automatic Cleaning AMASS supports automatic drive cleaning Refer to the AMASS Release Notes for a list of drives that support automatic drive cleaning Exceptions Drive cleaning exceptions are noted below ADIC AML with DAS Before using AMASS driveclean command comment out all cleaning related configuration data in the das etc config file on the OS 2 server 3 66 Command Reference 6 00028 01 Rev A Managing the 5 File System ADIC Scalar 1000 AMASS does not support automatic drive cleaning on the ADIC Scalar 1000 with firmware earlier than level 2 10 Consequently the Cleaning Mode must be disabled as follows Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Step 7 From the operator panel enter the Main menu by pressing Escape Scroll the Main menu using navigation buttons A ly Select the Setup menu by pressing Enter Scroll the Setup menu using the navigation buttons and select the Cleaning menu by pressing Enter Scroll the Cleaning menu using the navigation buttons and select the Drives dialog box by pressing Enter Determine if the first line in the box that shows if automatic drive cleaning
223. the fifth position as shown in the following example length code in 5th position of volume label 4 D C 1R34L5M891734 Save and name the template file usr amass BarcodeTemplate 6 00028 01 Rev A Command Reference 3 105 Managing the AMASS File System vgexport Optional Feature Export data and attributes metadata file for a volume group to another AMASS file system The metadata file contains the directory structure and media attributes such as media type ownership and timestamp for a volume group The metadata is part of the File System Database and is located in usr amass filesysdb It is exported as standard ASCII text Optional Feature Enable this optional feature with an authorization string obtained from ADIC To request a string refer to the Site Specific Tasks chapter in nstalling AMASS Disable Volume Verification As part of the export process AMASS mounts the volumes assigned to the volume group and verifies the header on each media with the volume label found in the File System Database If you have for example 10 volumes assigned to volume group 124 AMASS mounts all 10 volumes in a drive to read their header This can take some time To speed up the process you can use the q option to skip this step 3 106 Command Reference 6 00028 01 Rev A Managing the 5 File System Limitations The following limitations apply to the export process e
224. the mailbox Step 3 Enter the command as shown in the following illustration In our example all the volumes are assigned to volume group 101 bulkinlet 101 AMASS assigns a unique volume number to each volume 3 36 Command Reference 6 00028 01 Rev A Managing the 5 File System Step 4 new volumes in the File System Database have an initial status of unformatted U and inactive 1 To further prepare the volumes so AMASS can read or write to them use the commands listed in the following table Command Description vollabel Enter the preprinted alphanumeric barcode label in the File System Database StorageTek Redwood tape drives only tapelength Enter the length of tape in the Database volformat Format the volumes volstat Mark the volumes Active in the Database Active allows AMASS to read and write to media SCSI Multislot Libraries The following tasks are valid for SCSI attached libraries with multislot mailboxes bulkinlet volumenumber loads and marks existing volumes online in the File System Database e bulkinlet volumegroup assigns multiple volumes to a specified volume group 6 00028 01 Rev A Command Reference 3 37 Managing the 5 File System Unsuccessful Loads If you attempt to load several volumes at one time and one volume fails to load AMASS will not load the remaining volumes after the first failure For example if y
225. tial Setup Tasks 6 00028 01 Rev A 2 Operational Tasks Managing the AMASS File System NOTES 2 2 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Database and Journal Backups The File System Database contains metadata which includes the directory structure file attributes media information and storage information File System Database The File System Database contains tables of attributes or metadata representing the directory structure and media mounted under the AMASS file system The metadata includes media ID media type media location ownership and timestamp The default location of the Database is in usr filesysdb The File System Database tells AMASS where data is located on the media archived in your library or where data is located on offline media The following figure illustrates the concept of how the Database maps the file system to the volumes in the library Volumes contain real data Inodes map the metadata to real data found on the media UNIX Server Journal The Journal is a transaction log for the AMASS Database The default location of the Journal is in usr filesysdb journal Typically this is a symbolic link pointing to a separate physical disk to keep the Journal on a different disk from the File System Database 6 00028 01 Rev A Operational Tasks 2 3 Managing the AMASS File System The Journal tel
226. tsave 2 71 0x021001e6 10 010770 10 1 19980207114408 19980307142206 Directory name Hex value of StorageTek file s block address File name Volume number Logical block address Nonverbose Example The following example assumes we Want to see the relative path for all the files 6 00028 01 Rev A Command Reference 3 57 Managing the AMASS File System e Want to view all the files under the prodcode directory Logical block address Zero designates a directory su root dirfilelist prodcode prodcode 0 0 prodcode ntsave 2 7i File name Volume number Logical block address Directory name Output Fields Defined The following fields are generated by the verbose option Field Description Name File names f you enter an absolute path archive accting the list will begin with the AMASS mount point f you enter a relative path accting the list will be relative to the mount point Directory Zero directory Logical block address Start of file s block address in logical format StorageTek drives Displays only if the h option is used Device block address Start of the file s block address appears as a hexadecimal number enclosed in parentheses 3 58 Command Reference 6 00028 01 Rev A Managing the 5 File System TIME Format Practical Application Field Description Size Total size of the f
227. twork attached storage device Enter the barcode as the next parameter jukeboxnumber Enter the library number where the defaults to 1 specified volume resides Change Slot Assignment To change the home storage slot number for volume number 15 from slot 0402 to 0A56 in library number 1 perform the following steps Step 1 Log as either amass or root Step 2 Outlet volume number 15 as shown in the following example Use voloutlet for SCSI attached storage devices and bulkoutlet for network attached storage devices d su root voloutlet y 15 6 00028 01 Rev A Command Reference 3 199 Managing the AMASS File System Step 3 Change the volume s home storage slot number to 0A56 with the following options and values d volslot y 15 0 56 Step 4 Insert the volume into the mailbox and enter the following option and values volinlet y 15 The library moves volume number 15 to slot 0456 3 200 Command Reference 6 00028 01 Rev A Managing the AMASS File System volspace View all volumes with a specified percentage of dead space Dead space is space that has been previously written to by AMASS A volume that contains scattered files separated by great expanses of dead space is a waste of media See the volcomp command This command does not report information on volumes in the cleaning group Options usr amass bin volspace uy deadspace O
228. ue 4 Cache Commands 6 00028 01 Rev A Managing the 5 File System Output The example below illustrates how to assign volume group 126 both a read and write cache block list value of 2 su root d setcblist r 2 w 2 126 Changing cache block list assignment for volume group 126 Read list current 1 new 2 Write list current 1 new 2 Is this information correct y n y The following example illustrates how to assign volume group 52 a write cache block list value of 6 su root setcblist w 6 52 Changing cache block list assignment for volume group 52 Write list current 1 new 6 Is this information correct y nl y cblist Displays the read and write cache block list values for a specific volume group 6 00028 01 Rev A Cache Commands C 5 Managing the AMASS File System Options usr amass bin cblist uy volumegroup Option Description u Usage statement y Suppress confirmation and informational messages volumegroup Enter a specific volume group Separate a range of volume groups with a space For example 52 55 will display values for volume groups 52 53 54 and 55 Output The example below illustrates how to display cache block list values for volume group 52 su root cblist 52 VOLGRP Read Write 52 1 6 6 Cache Commands 6 00028 01 Rev A Managing the 5 File System The example below illustrates how to display cache block li
229. up oldvolumenumber Change the volume group newvolumegroup from 9 to zero For example 4 vgroot volumegroup For example vgroot 9 View directories assigned to this volume group It should return zero directories 5 However if directories still remain for the volume group setvolgrp path volumegroup For example setvolgrp techpubs 27 Reassign any remaining directories techpubs to another volume group 27 2 20 Operational Tasks 6 00028 01 Rev A Managing the AMASS File System Recycle a Volume To perform the following tasks use the procedure described in the table Move non contiguous data onto other volumes Recycle volumes For detailed information on the commands used in these steps see the Command Reference chapter Step Command Description 1 Log in as amass Or root 2 volspace deadspace List all volumes with a specified percentage of dead space Media with scattered or randomly volspace 80 located data contains a lot of dead space For example Lists all volumes with 8096 dead space 3 volcomp volumenumber Rewrite data to another volume At the end of this process the For example NS original volume is marked volcomp 3 INACTIVE volfilelist u See if any data remains on the original volume If it does rerun the volcomp command 6 00028 01 Rev A Operational Tasks 2 21 Managing the
230. values multiply the minimum block size which is 16 KB by 2 until you reach the value of your MAXIOSZ Additionally the calculated value is also less than your drive s READ BLOCK LIMIT This concept is illustrated below Fine tune Block Size 6 00028 01 Rev A Managing the AMASS File System Each tape block can be configured as Minimum 16 B 16 x 2 32 Drive s READ BLOCK LIMITS 350 KB MAXIOSZ 256 KB 16 KB 16 KB 16 KB 16 KB 32 KB 32 KB 32 KB 32 KB 32x2264KB gt 64 KB 64 KB 64 KB 64 KB 64 x 2 128 KB 128 x 2 256 KB N Any of these values are valid for b blocksize because they are 128 KB 128 KB 128 KB 128 KB a multiple of MAXIOSZ less than the READ BLOCK LIMIT 256 KB 256 KB 256 KB 256 KB To arrive at a value consider the following e your media usage capacity your expected site performance e your typical file size 6 00028 01 Rev A Fine tune Block Size Managing the AMASS File System NOTES B 8 Fine tune Block Size 6 00028 01 Rev A Commands Managing the AMASS File System NOTES C 2 Cache Commands 6 00028 01 Rev A Managing the 5 File System Cache Commands Using new AMASS commands you can now assign cache block list values for reads and write
231. ve Step 8 following example illustrates the status for a volume used for drive cleaning volstat 4 Volume 4 in jukebox 1 is in the cleaning volume group 3 208 Command Reference 6 00028 01 Rev A Managing the 5 File System volusage View statistics for all volumes in the AMASS file system Options usr amass bin volusage u hHV Option Description h Display a message describing the output H Do not print and underline the column defaults to print and titles in the output underline column Non printed column titles are useful if you titles generate reports with UNIX utilities like awk sort and sed u Usage statement V Verify the volume number and display any inconsistencies between the Database entry and volume header Example Step 1 Log in as either amass or root 6 00028 01 Rev A Command Reference 3 209 Managing the AMASS File System Step2 example of the output is shown in the following illustration su root volusage Vol Slot Mounts R W MB Err Last Mounted 1 NET 1 0 0 Fri Aug 29 03 00 15 1998 2 NET 0 0 0 eae 3 NET 15 0 Wa Sep LL 1 22 1998 Output Fields Defined The following fields are generated by this command Field Description Volume Volume number Slot Home storage slot where this volume resides Valid entries are 4 alphanumeric slot designation 0A12 SCSI attached storage device
232. ve Action 6 00028 01 Rev A Troubleshooting Tools 31 Managing the AMASS File System Prepare to Contact Technical Support Depending on how you purchased technical support telephone support is provided either through your reseller or directly through ADIC The ADIC Technical Assistance Center in Denver Colorado provides world wide service and support Inthe USA and Canada call 1 800 827 3822 e Outside the USA and Canada call 303 874 0188 or toll free 00800 9999 3822 e Send e mail to support adic com Before contacting ADIC technical support perform the following steps Step 1 Step 2 Step 3 Print the following files e usr amass tools typescript usr amass tools install config out This file may not exist if the test scripts cannot detect an error Print the output from the amass script making sure the correct system log file is scanned To run this script see log on page 4 7 Run the amass snap script to collect system information To run this script see snap on page 4 9 32 Troubleshooting Tools 6 00028 01 Rev A Managing the 5 File System Step 4 Step 5 Obtain the following information AMASS Serial Number Site ID Contact technical support and be prepared to supply the above information to them 6 00028 01 Rev A Troubleshooting Tools 33 Managing the AMASS File System NO
233. ve cleaning libsched Subset of qset Schedules library transport One 1ibsched is required for each library managed by AMASS libio Subset of qset Schedules drive One libio is required for each drive managed by AMASS 6 00028 01 Rev A Utility Reference 4 11 Managing the AMASS File System amass tests AMASS must be running prior to executing the test e Storage device hardware e AMASS File System Database volumes system files and message files e No output means that amass_tests was successful Prerequisites AMASS must be running prior to executing amass_tests When to Use Script For an example of when to use this script see e AMASS Appears Hung on Page 3 e Requests Not Getting to Library on Page 22 e Command Gives Unexpected Results on Page 26 4 12 Utility Reference 6 00028 01 Rev A Managing the 5 File System List of Tests The script runs the tests listed in the following table Group Test Name Definition Backup Scheduled Makes sure that backups are scheduled in cron Volume Makes sure a Backup Volume exists and is formatted another volume is assigned to that home storage slot and a backup has been run Database Check Runs database checks dbcheck and Journalsize Makes sure journal is not too large Permissions Checks ownership and permissions of database files Taf Checks if taf file is correct size
234. ve m3 0 1 Third cH Home Storage Slot Media Step 4 If a hardware error occurs refer to your hardware manuals 4 38 Utility Reference 6 00028 01 Rev A Managing the 5 File System mediaread Performs the following tasks e Read a specific block of data e Write the data to tmp mediaread When to Use Utility Use this utility to e Read corrupted data blocks Verify that a mediawrite has been successful Options usr amass utils mediaread drivenumber blocknumber jukeboxnumber 6 00028 01 Rev A Utility Reference 4 39 Managing the AMASS File System Option drivenumber Description Enter the drive number that is reading the media blocknumber Enter the starting block address jukeboxnumber defaults to 1 Enter the AMASS library number Example Step 1 Login as root su root Step 2 To read block six on drive 2 enter the path utility and options similar to what is shown in the following example cd usr amass utils mediaread 2 6 AMASS writes the data in block six to tmp mediaread Step 3 display the output to the screen enter the UNIX concatenate command cat tmp mediaread Step 4 If a hardware error occurs refer to your hardware manuals 4 40 Utility Reference 6 00028 01 Rev A Managing the 5 File System mediawrite Write a predetermined line beginning at E
235. volcomped or a volcomp procedure has aborted Inactive volume not currently used by AMASS Reserved e Offline volume Volume has been quick formatted e R Volume is marked as Read Only This occurs as a result of either 1 a write error that makes the media unwritable or 2 a user has forced the media to be Read Only with the volreadonly command U Volume not formatted W Media type is WORM Volume Volume number Volgrp Volume group assignment Fields Kbytes Sec Description Average I O rate for specified drive since the last snapshot NOTE The value displayed by sysperf and sysop is a transfer rate on the other hand the value logged in the file is the number of Kbytes transferred since the last entry These values will not agree in real time 3 100 Command Reference 6 00028 01 Rev A Managing the 5 File System Fields Description Appears only if the option is used Cache Blocks Total total number of cache blocks Free lt number of cache blocks available DIRTY BLOCKS number of cache blocks filled with data that has not yet written to the media NFNODES Total total number of files that can be opened at one time Free lt number of closed files Used number of files currently opened Fields Description Appears only if the c option is used Queued Cache b
236. volume a BACKUP VOLUME label Barcode volumes must have their preprinted number in the Volume Label field instead of the words BACKUP VOLUME This field is displayed by the vollist command shown in the following table d vollist VOL VOL JUKE POS VOL FLAGS USED AVAIL DEAD ERRS NUM GRP NUM LABEL MB MB 3 1 0 1 backup 0 20000 0 0 Step Command Description Change the Volume Label field from to the preprinted media number with the vollabel command shown below In our example the preprinted number is 112102 6 00028 01 Rev A Initial Setup Tasks 1 5 Managing the AMASS File System Volume number assigned by bulkinlet Volume label printed on media vollabel 1 112102 Step Command Description Now the Volume Label field displays the preprinted number 112102 d vollist VOL VOL JUKE POS VOL FLAGS USED AVAIL DEAD ERRS NUM GRP NUM LABEL MB MB 5 1 0 1 112102 0 20000 0 0 Step Command Description 4 For StorageTek Redwood tape drives only tapelength Enter length of tape lengthcode in the AMASS File System Database 1 6 Initial Setup Tasks 6 00028 01 Rev A Managing the 5 File System Step Command volformat NOTE Not applicable for CDs Description Format the Backup Volume If you are using a standalone drive you must format the volume from the sysop interfac
237. y Reference 4 67 Managing the AMASS File System sysdbchk Sysdbchk is an AMASS utility that verifies the consistency of the AMASS file system and either Displays errors e Corrects errors Run this utility on a quiescent system otherwise the tests may fail because of the inability to exclusively lock the AMASS File System Database When to Use Utility For an example of when to use this utility see AMASS Database is Bad on page 6 4 68 Utility Reference 6 00028 01 Rev A Managing the 5 File System Options usr amass utils sysdbchk c dir d h i 1 dir q y Option Description no option Check only do not correct errors c dir Set directory for temporary cache files to dir specified directory new option d Check file names duplicates very slow h show this help i Use interactive mode to repair errors new NOTE ADIC recommends against using the i option as it requires an in depth understanding of AMASS filesystem organization Use of this option can cause data loss I dir Set directory for log files to new option q Do not print to the screen new option quiet mode all log information is in the logfile sysdbchk log y Repair all single choice correction errors use preferred correction for errors with multiple choice 6 00028 01 Rev A Utility Reference 4 69 Managing
238. you are changing 6 00028 01 Rev A Command Reference 3 173 Managing the AMASS File System Option Description newvolumelabel Enter one of the following User assigned name that is a maximum of 13 characters long Preprinted barcode that is a maximum of 13 alphanumeric characters long NOTE For barcode reading libraries a barcode label is required Change Volume Label Step 1 Log as either amass or root Step 2 change a volume label on volume number 2 to pubsvolume enter the command as shown in the following example AMASS asks for confirmation of the process su root vollabel 2 pubsvolume Request to change volume label on volume 2 Old label is volume2 New label is pubsvolume Is this information correct y nl y New Volume label is pubsvolume Volume 2 label has been changed 3 174 Command Reference 6 00028 01 Rev A Managing the 5 File System volleft Write how much space in kilobytes remains on a volume to standard out stdout Options usr amass bin volleft uy volumenumber Option Description u Usage statement y Suppress interactive messages volumenumber Enter the unique volume number you want space information on Example Following is an example of output generated by this command for volume 2 su root volleft 2 6 00028 01 Rev A Command Reference 3 175 Managing the AMASS File System
239. ystem Tip The configurable b blocksize should evenly divide into the MAXIOSZ value This concept is illustrated below 1 4 1 4 1 4 1 4 Tape Tape Tape Tape Size of each tape block Block Block Block Block divides evenly into MAXIOSZ Size Size Size Size yee MAXIOSZ MAXIOSZ Correlate with A SCSI drive writes to tape in a fixed block segment determined READ BLOCK by the READ BLOCK LIMIT of the drive This means that at the LIMIT end of every write the last block segment may hold less than one full block of data Although this may not at first impact performance it does waste tape resources if the average file size is small and the b blocksize has been configured for larger file sizes This concept is illustrated below a a Last segment may be less than full of Subsequent writes start in this contiguous segment client s data If many partially filled segments exist space is wasted on the tape 6 00028 01 Rev A Fine tune Block Size B 5 Managing the AMASS File System To determine the READ BLOCK LIMIT value refer to your drive s manual Your goal is to have a complete file fit into a tape block segment without having partially filled segments as illustrated above Tip The configurable b blocksize must be equal to or less than your drive s READ BLOCK LIMIT value To calculate valid block size

ADIC Time Clock 6-00028-01 Rev A User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents