ADIC FileServ Version 4.0 600716 Rev A manual

Administrative T asks FileS erv V ersion 4 .3 February , 2001 600716 Rev A[...]

Trad emark Not ice AMASS, DataMgr, EMASS, F ileServ, and VolServ are e ither trademarks or registered trademarks of ADIC, Advanced Digital Information Corporation. DAS is a trademark of Grau, an ADIC subsidiary. All other product names and identifica tions are trademarks or registered t rademarks of their r espective ma nufacturers. Copyright Notic[...]

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 Software D ocumentatio n 10949 East Peakview Ave. Englewood, CO 80111 FAX: 303-792-2465 E-mail: swpubs@adic.com Is there anything you especially like or dislik e about the organization, pr[...]

NOTES[...]

600716 R ev A Contents 5 Contents Preface P u r p o s eo fT h i sB o o k ................................................ P - 3 W h oS h o u l dR e a dT h i sB o o k ......................................... P - 3 H o wT h i s B o o ki sO r g a n i z e d ....... .................................. P - 3 C o n v e n t i o n s ........................[...]

Admi nist rativ e T as ks 6C o n t e n t s 600 716 Rev A S t o r ea n dT r u n c a t eF i l e s .......................................... 1 - 1 0 D a t a b a s eM a i n t e n a n c e ........................................... 1 - 1 0 c h k _ p o i n t . p l ................................................. 1 - 1 1 c h e c k D B A L L ............[...]

Adminis trative T asks 600716 R ev A Contents 7 Edit Devices with fsconfig Command ........................... 1 - 4 8 A d daL i b r a r y ................................................ 1 - 4 9 Edit Device .................................................. 1 - 5 0 D e l e t eaD e v i c e ............................................... 1 - 5 0 G e[...]

Admi nist rativ e T as ks 8C o n t e n t s 600 716 Rev A P o l i c i e s ......................................................... 2 - 3 1 S t o r a g eP o l i c y ................................................ 2 - 3 2 C l e a n u pP o l i c y ............................................... 2 - 3 4 O v e r f l o wP o l i c y .....................[...]

Adminis trative T asks 600716 R ev A Contents 9 M e d i aS t a t e s .................................................... 2 - 6 3 S t o r a g eL i m i t.................................................... 2 - 6 5 G e n e r a t eM e d i aR e p o r t s .......................................... 2 - 6 6 M e d i aI n f o r m a t i o n .................[...]

Admi nist rativ e T as ks 10 Contents 600716 R ev A D u m pD a t a ...................................................... 4 - 9 R e s t o r eD a t a .................................................... 4 - 1 1 A u d i tD a t a b a s e ................... ............................... 4 - 1 7 F i l eS y s t e mR e c o v e r y .....................[...]

Preface P Preface P u r p o s eo f T h i sB o o k ....................... P - 3 W h oS h o u l dR e a dT h i s B o o k ................. P - 3 H o wT h i s B o o ki sO r g a n i z e d ................ P - 3 C o n v e n t i o n s ............................... P - 4 B o o k s ..................................... P - 5 O n l i n eB o o k s ........[...]

Administrative T asks P-2 Preface 600716 Re v A NOTES[...]

Administrative T asks 600716 Rev A Prefac e P-3 Preface Purpose of This Book This book describes the management tasks, util ities, and troubleshooting tools used in operating FileServ . Who Sho uld Read This Book This book is writte n for the system administrator who is operating and troubleshooting FileServ . It assumes the ad ministrator has a st[...]

Administrative T asks P-4 Preface 600716 Re v A Conventions The c onventions used throughout the FileServ technical books are listed below: Convention Example Screen t ext, fil e names, prog ram names, and comm and s are in Courier font. FS0000 03 204773 fsme dinfo completed: Command Successful. The root prompt is s hown as a per cent sign . % su r[...]

Administrative T asks 600716 Rev A Prefac e P-5 Preface Books The books desc ribed below are part of t he technical documentation set, and are shipped on CD: Online Bo oks The documentation CD contai ns FileServ book files and Adobe ® Acrobat ® Reade r . The Reader al lows you to view and navigate the online documentation files yet prese rves the[...]

Administrative T asks P-6 Preface 600716 Re v A Related Publications The publications described in the table below are crea ted and distributed on an as-needed basis. Cont act Publications Dep artmen t T o make corrections or to comment on FileServ publications, please contact Software T echnical Publications at our email address: swpubs@adic.com. [...]

System T asks 1 System T asks G e n e r a l P a r a m e t e r s .................. 1 - 2 8 S y s t e mA d m i n i s t r a t i o nP a r a m e t e r s.... 1 - 2 8 D e f a u l tP a r a m e t e r s .................. 1 - 3 6 F i l eR e t e n t i o nP a r a m e t e r s ............ 1 - 3 9 V o l S e r v - s p e c i f i c P a r a m e t e r s .......... 1[...]

Administrative T asks 1-2 System T asks 600716 Re v A Roadma p To p i c Refer T o Chapter Initi alize Fi leServ , configu re inte rface wi th V olSer v , per form start up and sh ut down, mo dify system c onfigura tion, and t une system for b etter performanc e. 1 Manage : DataClass G roups, files , migrati on, data, and m edia. 2 Using the F ileSe[...]

Administrative T asks 600716 Rev A Syst em Tasks 1-3 System T asks Initialize FileServ Running FileServ for the first time involves the following tasks listed in the ta ble below: Access the Host Server T o access the host where FileServ has bee n installed to transfer files to or fr om the migration directories, use one of the following methods: ?[...]

Administrative T asks 1-4 System T asks 600716 Re v A Interface to Vo l S e r v After both FileSe rv and V olServ have been installed and initially configured, drive pool and association of a MediaClass group with a library must be established within V olServ for FileSe rv communica tions. Drive Pools A drive pool is composed of a single drive or g[...]

Administrative T asks 600716 Rev A Syst em Tasks 1-5 System T asks Associate MediaClass with Libra ry On SGI systems, there are fifty four MediaClass names. Each MediaClass has the following form: FileServID_mediatype_mediaclasstype There are ten possible values for FileServ ID: F0 through F9. The following mediaclasstype exist: • ADDBLANK or ADD[...]

Administrative T asks 1-6 System T asks 600716 Re v A • F0_D2S_MIGRATE • F0_D2S_REMOVE Register the Configuration Before FileSer v can operate properly , the physical configuration of the system must be defined within FileServ . This procedure is accomplished during or after FileServ instal lation. After installation, the system administrator i[...]

Administrative T asks 600716 Rev A Syst em Tasks 1-7 System T asks • T runcation policies for files and media types associated with the DataClass group. Associate Directories After a DataClass group is defined, it can be associated with directori es in a file system so that files writt en to that direc tory structure have the ir file data migrate[...]

Administrative T asks 1-8 System T asks 600716 Re v A Media Under FileSer v Management Befor e data can b e copied f rom disk t o tape, the t ape medi a must be in place. The media should be properly label ed and entered into a storage subsystem b y a V olServ operator be fore entering media into the FileServ database. The fsmedin -b command is use[...]

Administrative T asks 600716 Rev A Syst em Tasks 1-9 System T asks Create Migration Policies Migration polici es initiate movement of fi le data from disk to tape. The following types of policy can be run: • Store data to tape (base d on DataClass param eters). • Remove data from disk (based on disk space) The fspolicy -s command is used to inv[...]

Administrative T asks 1-10 System T a sks 600716 Rev A Routine Processing Part of the FileServ system routine processing includes: Sto re a n d T runcate Files Policies for storage and for data truncation are run a s part of routine system processing. The standard method of running routine operations is to have the oper ating system cron process ex[...]

Administrative T asks 600716 Rev A System Tasks 1-11 System T asks FileServ database maintenance is part of routine system processing. FileServ uses a RAIMA database to store and track information about the files under FileServ . The RAIMA database is embedded within FileServ and automatically starts when File Serv starts . Periodic database mainte[...]

Administrative T asks 1-12 System T a sks 600716 Rev A When the checkpoint script runs, it tars the entire contents of the Fil eServ dat abase to a separate f ile system . After t his process is completed, it zeros out the journal file. If the journaling file system becomes full, processing stops. Therefore, it is important to checkpoint the databa[...]

Administrative T asks 600716 Rev A System Tasks 1-13 System T asks The table below shows the suggested database maintenance intervals for each da tabase utility . Although FileSe rv must be terminated, the Lock Ma nager process must be active, to run the checkDBALL script. The script may be run by either user fsadm or user root . ADIC recommends th[...]

Administrative T asks 1-14 System T a sks 600716 Rev A keyBuildAll The $FS_HOME/uti l/keyBuildAll script rebuilds all the key files for the RAIMA database. Rebuilding the file keys is a two step process that also rebalanc es the B-tree structure of the database. T o rebuild the file keys, foll ow the steps below: St e p 1 . Reinitializ e the file. [...]

Administrative T asks 600716 Rev A System Tasks 1-15 System T asks The utilities that operate on spe cific file systems are: blockpos, dirdb, fileattr, filecmnt, filecomp and filexpir . All of the utilities, with t he exception of keytest ,h a v et w o modes: • Command Line Mode. • Interactive Mode. Both modes are described below . For both Com[...]

Administrative T asks 1-16 System T a sks 600716 Rev A First, you check the devdb table for the entry containing /test2 . Notice there i s a field c alled “ device key ” associat ed with /test2 . This is the value you will use for device specific table utilit ies that are associ ated with th e /test2 file system. St e p 3 . T o look at the file[...]

Administrative T asks 600716 Rev A System Tasks 1-17 System T asks Intera ctive Mode T o start a utility in Inte ractive Mode, incl ude the -i option on the command line. If the -i option is used, F ileServ ignores the -k key option. In Interactive Mode, a menu displays with options valid for the specified utility . The following table describes th[...]

Administrative T asks 1-18 System T a sks 600716 Rev A In addition, there is always an option to query on one or more unique keys. When entering an option, you may enter as many options on the command line as you like. However , only the very first characte r is accepted a s the command. If that is a spa ce, the command is in error and nothing is d[...]

Administrative T asks 600716 Rev A System Tasks 1-19 System T asks • Heavy storage, retrieval, modification, crea tion, or deletion of files in migra tion directories . The advantage to taking extra checkpoints is that recovery from database corruption is much faster and more reliable. H owever , a checkpoint done during hea vy system use takes l[...]

Administrative T asks 1-20 System T ask s 600716 Re v A Run this command only if the archived f ile systems are newer than t he restored databa se and the journal files have been pr eserved. The restore.pl command will not replace the old journal, so no other preparatory work should be needed if the journal file has been preserved. The journal file[...]

Administrative T asks 600716 Rev A System Tasks 1-21 System T asks Run a fsmedinfo -l report to verify all file s deleted from media. If files still exist, rerun the fsclean c ommand. The fsundelete command allows recovery of removed or modified copies of files as long as an entry exists in the trashcan. Only the primary copy is recoverable w ith t[...]

Administrative T asks 1-22 System T ask s 600716 Re v A Sta r t u p a n d Shut down The following startup modes exist for FileServ: • Normal . A normal termination allows a request to continue to a known processing state. When a normal termination is unsuccessful, contact technical support personnel to assist with the correction. If termination e[...]

Administrative T asks 600716 Rev A System Tasks 1-23 System T asks The following messages display at the command line whe re the FileServ command is run to indicate a succe ssful initiation : Recovery Processing During Fi leServ processing, software activity is continually recorded in recove ry processing files. These files are only used during a n[...]

Administrative T asks 1-24 System T ask s 600716 Re v A The recovery files cannot be used af ter a contingency start is issued. If the user needs to s ave the recover y files for review at a later time, move these files to another directory . Do not rename the recove ry files because the software deletes a ll files found in the recovery file direct[...]

Administrative T asks 600716 Rev A System Tasks 1-25 System T asks Normal Shut down T o ensure an orderly shutdown of FileServ , any processing must be terminat ed gracefully . All components must be shut down in th e sequence as follows: St e p 1 . Shut down FileServ . St e p 2 . Shut down V olServ . St e p 3 . Shut down Ingres databa se software.[...]

Administrative T asks 1-26 System T ask s 600716 Re v A Any media introduction or removal operations in progress are interrupte d. The requests resume and are completed when a subsequent normal startup is performed. The configuration states for the storage library components are not changed during termination. St e p 4 . Perform an orderly system s[...]

Administrative T asks 600716 Rev A System Tasks 1-27 System T asks Managing System Configuration For the proper execution of FileServ commands and operations, the physical storage library configuration must be maintained in the FileServ sys tem and parameter f iles. The table below list s the tasks that the FileS erv system administrator ca n perfo[...]

Administrative T asks 1-28 System T ask s 600716 Re v A Genera l Parame ters The fs_sysparm file contains parameters that control general FileServ activities. The parameters in this file are grouped into the following categories: System Administra tion Parame ters The system administration parameters in the table below can be changed to tune syste [...]

Administrative T asks 600716 Rev A System Tasks 1-29 System T asks FILE_LBL_FMT_TAPE adic00000 001 Defines t he way data labels a re w r i t t e nt ot a p ed e v i c e s . adic000 00001 is A NSI standar d and writes data with tape marks between the header labe ls and da ta, and between data and traile r labels. adic000 00002 leav es off tape marks.[...]

Administrative T asks 1-30 System T ask s 600716 Re v A DEFAULT_MEDIA_TYPE DL T Defaul t media ty pe used w ith command s with optional m edia types. DEF_MED_SPC_3480 220000000 Default tape le ngth of a 3480 c a r t r i d g ei nb y t e s . DEF_MED_SPC_3490 400000000 Default tape le ngth of a 3490 c a r t r i d g ei nb y t e s . DEF_MED_SPC_3490E 80[...]

Administrative T asks 600716 Rev A System Tasks 1-31 System T asks FS_MAX_ACTIVE_ FORMATS 1 M aximu m number of driv es allow ed to perform tape forma tting at one time. FS_MAX_ACTIVE_ MEDCHECKS 1 M aximu m number of driv es allow ed to perfor m media check ing at an y one time. STORE_LIMIT_NOTICE 1 If FileServ is started up when the storage used i[...]

Administrative T asks 1-32 System T ask s 600716 Re v A (contin ued) The FS_CALLOUT_S LEEP_INT and MAX_DMON_SUSP_ERRORS p a r a m e t e r sc a nb et u n e d ,i f recurri ng failures of multi ple copies of files ar e noted in the s ystem logs . This situ ation can o ccur in a backu p environme nt where th e primary and backup copi es of lar ge files[...]

Administrative T asks 600716 Rev A System Tasks 1-33 System T asks MAX_WRITES 100 N umber o f retrie s on IP C send fail ure. Th e MAX_RE ADS and MAX_WRI TES param eters are set to the same num ber . This i s set by the factory an d is cha nged only by technic al support pers onnel. FS_DB_RETRY_COUNT 3 Num ber of r etries o n database service s fai[...]

Administrative T asks 1-34 System T ask s 600716 Re v A STARVATION_PERCENT 50 Percen t of MAX_T AP E_TO_T AP E_ALLOC _TI ME var iabl e in wh ich r esourc es wi ll be obtained an d not rel eased unti l all resources ha ve been secured or the tim e limit h as bee n exceed ed. (V al id range is 1 through 1 00.) FS_NICE_VALUE n If enable d, the FileSe [...]

Administrative T asks 600716 Rev A System Tasks 1-35 System T asks FS_DRIVE_ERR _THRESHOLD 20 Thr eshold value when equ alled or exceede d resul ts in drives bei ng tak en offline. FS_MAX_FILES_PR_3480 2000 Maximum numbe r of files al lowed on a singl e 3480 car tridge tape. PERCENT_FULL_TO _MIGRATE 95 Pe rcentage va lue us ed to che ck again st to[...]

Administrative T asks 1-36 System T ask s 600716 Re v A Defaul t Par amet ers The FileServ de fault parameters are used with F ileServ commands that a llow defaults ( fsaddclass and fsmodclass ). T o c hange a default, modify this file, cycle FileServ , then retry the command. Review these parameters t o verify that the applicable de faults are sit[...]

Administrative T asks 600716 Rev A System Tasks 1-37 System T asks If the system administrator does not log on as root , change the CLASS_USERID to default to the user ID of the user w ho is available for mail notification of actions that ar e required by FileSe rv . Par amete r Defau lt Defi nit ion CLASS_USERID fsadm Default u serid. A ny valid u[...]

Administrative T asks 1-38 System T ask s 600716 Re v A CLASS_DEF_MEDIA_TYPE DL T D efault m edia type (D 2S, D2M, D2L , DL T , 3480 , 3490, 3490 E, 3590,85 90). Dependin g on the platform us ed or a manual s ystem, modify the defaul t to media used . The number can also be modifie d for a n existi ng clas s by usin g the fsmo dclass co mmand. CLAS[...]

Administrative T asks 600716 Rev A System Tasks 1-39 System T asks File Retention Parame ters The following list shows parameters that are used by the file comment keyword search and file expiration processes. T o change a value, modify this file, cycle the user interface, then retry the command. CLASS_FILE_CLEANUP P De fault fi le cleanu p action [...]

Administrative T asks 1-40 System T ask s 600716 Re v A A file will be retained on the disk based upon the DEF_FILE_RETION_PERIOD or t he FILE_RETENTION_PERIOD value. The lowest value will determine a file’ s true retention period. V o lServ-specific Parame ters The following parameters are specific to the V olServ system. FileServ must be cycled[...]

Administrative T asks 600716 Rev A System Tasks 1-41 System T asks Inst allation Parame ters The following list shows the system parameters that are to be established at the time of system instal lation. Use the FileServ installation script for this purpose. As a general rule , do not modify these rules unless the system is completely rei nitialize[...]

Administrative T asks 1-42 System T ask s 600716 Re v A FS_DATABASE fsdb FileSer v database name (1-20 c hars). The database mainten ance scripts use fsdb as the Fi leServ database n ame. If this paramete r is modifi ed, these scr ipts must also be mod ified. FS_CONSOLE /dev/ console Identifi es the device path for the FileServ console. FS_DEFAULT_[...]

Administrative T asks 600716 Rev A System Tasks 1-43 System T asks Software Mainte nance Parame ters The following list shows parameters that can be modified as required for software maintenance. FileServ must be cycled to affect the changes. These paramete rs are used to enable and disable dif ferent types of message logging. These logs can be use[...]

Administrative T asks 1-44 System T ask s 600716 Re v A Me d ia Stats Parame ters The following list shows parameters that can be modified as required, to coll ect media statisti c information for each site . FileServ must be cycled to pick up c hanges to these parame ters. Loggin g Par ameter s The following list shows parameters that can be modif[...]

Administrative T asks 600716 Rev A System Tasks 1-45 System T asks FS_FACILITY 1 Logging fac ility used for priorit y 0-7 message s direct ed to the s yslog. The conf iguratio n for the syslog is in th e /etc/sys log.conf file. T he foll owing fac iliti es can b e used wi th the FS_FACILITY par am et e r KEY (used to direct mes sages to files): •[...]

Administrative T asks 1-46 System T ask s 600716 Re v A Edit Syst em Parame ters Configurable system parameters are modified by editing the FileSe rv system parameters $ FS_HOME / fs_sysp arm file. St e p 1 . Edit the fs_sysparm file using a text editor and replace the existing value with a valid new value. All entries must be in the format: name =[...]

Administrative T asks 600716 Rev A System Tasks 1-47 System T asks An example for the CLASS_MTIME parameter is shown below : St e p 2 . Recycle FileServ by running the command below: Upon restart, a servi ce utility is calle d by various processes and routines to establish system parameter values within th e FileServ environme nt. This utility read[...]

Administrative T asks 1-48 System T ask s 600716 Re v A The UNIX device drivers provide th e means to reconfigure devices for the standa rd peripherals (disks and system console). T o reconfigure these components, refer to the applicable platform manual. Edit Devices with fsconfig Command After installation, the system admini strator can add or r e[...]

Administrative T asks 600716 Rev A System Tasks 1-49 System T asks When adding or deleting a drive to the system, the system parameter FS_VS_QUEUE_XX X_THRESHOLD value located under $FS_HOME / sysparms directory must be updated for each media type the dr ive supports. The entered value is thre e times the total number of drives in t he system. For [...]

Administrative T asks 1-50 System T ask s 600716 Re v A Edit Device St e p 1 . Run the fsconfig com mand with the - a option to add a new component to the ADIC system. St e p 2 . Use the appropriate options, as needed. For option information, refer to the Command Refer ence book. Delete a Devic e St e p 1 . Run the fsconfig -h componentID command w[...]

Administrative T asks 600716 Rev A System Tasks 1-51 System T asks Genera te Repor t St e p 1 . Run the fsconfig comman d. Use the -h option to show the configuration of all component. Or, use the -i option to show the configuration of a specific component. St e p 2 . An example of the generated report is shown below: % fsconfig -------------------[...]

Administrative T asks 1-52 System T ask s 600716 Re v A Drive Co mpatibili ty The fsconfig command can configure various drives. The following list shows the FileServ default drive values and the various drives each default value supports along with the media type. When adding a drive, this table should be referenc ed. The tape media that came with[...]

Administrative T asks 600716 Rev A System Tasks 1-53 System T asks Change Component St a te Component state changes a llow for timely maintenance and diagnostics of a library component. When a library component is taken from the online ( ON ) state to the offline state ( OFF ), it is not available for usual FileServ operations. After the specialize[...]

Administrative T asks 1-54 System T ask s 600716 Re v A • UNA V AIL • MAINT •O N •O F F • UNKNOWN Because FileServ and V olServ components work interactively , changes in the drive components or stora ge subsystem are reflect ed in V olServ . If a component is taken to either the offline or maintenance state, FileServ does not attempt any[...]

Administrative T asks 600716 Rev A System Tasks 1-55 System T asks St e p 2 . Use the -s option to indicate the required new state of the component. V alid state entries are : UNAVAIL , MAINT , ON , OFF ,a n d UNKNOWN . St e p 3 . T o receive a report on all configured stora ge subsystem and drive components in the syst em, run the fschstate comman[...]

Administrative T asks 1-56 System T ask s 600716 Re v A St e p 4 . Change directory to $FS_HOME (directory where FileSe rv is located). St e p 5 . Source FileServ cshrc by entering source .cshrc . St e p 6 . Execute the fsvsinstall script by entering run /util/install/fsvsinstall and respond to questions. The fsvsinstall script prompts you for the [...]

Administrative T asks 600716 Rev A System Tasks 1-57 System T asks Fine-t une Parameters The following para meters ca n be fine-tuned for bette r system performance: Reallocate Drives Drive alloca tion is af fected by the fol lowing sets parameters : • Drive deallocati on . The deallocation pa rameters det ermine when a drive is taken offline bec[...]

Administrative T asks 1-58 System T ask s 600716 Re v A St e p 2 . Modify any of the drive parameters identified in the table below: St e p 3 . Save and close the edited f ile. Modify Tape Usage The way data is writte n to tape is modifi ed by editing the appropriate system parameters that control: • Estimated tape length calculations. • Dat a [...]

Administrative T asks 600716 Rev A System Tasks 1-59 System T asks St e p 3 . Save and close the edited f ile. Red irect P oli cy Applications St e p 1 . Open the crontab file. St e p 2 . Modifying the list of DataClass groups where the policies is applied. DEF_MED_SPC_3480 De fault 3 480 t ape le ngth in by tes. DEF_MED_SPC_3490 De fault 3 490 t a[...]

Administrative T asks 1-60 System T ask s 600716 Re v A NOTES[...]

Opera ting T asks 2 Oper ating T asks D a t a C l a s sM a n a g e m e n t ..................... 2 - 3 D a t a C l a s sG r o u p s ....................... 2 - 4 M a n i p u l a t eR e l a t i o n s................... 2 - 1 0 F i l eM a n a g e m e n t .......................... 2 - 2 2 P a t h n a m e ............................. 2 - 2 2 L i n k [...]

AdministrativeT asks 2-2 Operating T asks 600716 Re v A Roadma p T opic Refer T o Chapter Initia liz e File Serv , c onfig ur e inter face w ith V olServ , perform star t up and shut down, modify system confi guratio n, and tune system for be tter per forman ce. 1 Manage: Dat aClass Grou ps, files , migrati on, data, and media. 2 Usin g the F ileS [...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-3 Opera itng T asks Dat aClass Manage ment File s controlled by FileServ are s egregated i nto DataC lass groups. A DataClass group contains a unique set of parameters that govern the migration beha vior of the directories that ar e associated with the class. The figure below depicts directory-t[...]

AdministrativeT asks 2-4 Operating T asks 600716 Re v A Migration policy parameters are configurable on a D ataClass group basis, which provides the FileServ administrator with control over the behavior of the FileServ system. The minimum time required on disk b efore migration and file clea nup action are example s of DataClass mi gration policy p[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-5 Opera itng T asks T o create a DataClass group, follow the steps be low . St e p 1 . T o verify t he param eter settings before attempting any modification, use the fsclassinfo com mand to view th e DataC lass gro up par ameter s. St e p 2 . Run the fsaddclass command and specify a DataClass g[...]

AdministrativeT asks 2-6 Operating T asks 600716 Re v A St e p 1 . Run the fsmodclass command and specify a DataClass group name. St e p 2 . Use fsclassinfo to compare eac h DataClass group parameter . Then ei ther change the class parameters f or the new c lass to allow spanning or change the clas s parameters for the old class to disallow s panni[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-7 Opera itng T asks Remove Group with fsrmcl ass Command The fsrmclass operation removes a DataClass group and its parameters from File Serv . This proced ure also delet es the direct ory-to-DataClass associations that involve the specified DataClass group. Empty all direc tories in the DataCl a[...]

AdministrativeT asks 2-8 Operating T asks 600716 Re v A If no class is specified, a short report on all DataClass groups is generated. The generat ed report is s ent to stdout but can be r edirec ted to a file or piped to a printer . The output of a long report is shown below: The tab le be low des cribe s the rep or t’ s fie lds: % fsclassinfo l[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-9 Opera itng T asks Noti fy ID E-m ail add ress w here no tifica tion is s ent when the soft lim it or hard limit is reached. Secu rity C ode Four-ch aract er D ataC lass g roup s ecur ity code. Account Number Five-cha racter Data Class group accoun t number . Drive Pool Name of drive pool assoc[...]

AdministrativeT asks 2-10 Operat ing T asks 600716 Rev A Manipulate Relations Migration directories are define d by associating directories w ith a DataClass group. A DataClass group is associated with one or more directory p aths. This association i s defined as a rela tion between the DataClass group and the directory . The directory is known as [...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-1 1 Opera itng T asks This procedure allows you to associate a DataClass group definition with a dire ctory . All files and directories beneath t he association point are included in and governed by the D ataClass group parameters. T o add a D ataClass group association to a directory , it must [...]

AdministrativeT asks 2-12 Operat ing T asks 600716 Rev A Associ ate New Dire ctories wit h Files Files can be present in a directory when t he fsaddrelation is performed. Creating a directory under a directory that is an association point automat ically associa tes the newly create d directory with the DataClass group of it s parent direc tory . Re[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-1 3 Opera itng T asks Major and minor device numbers are not necessary . Instead, use the device name of the file system as listed by the UNIX df command. /dir1 dir2 dir4 dir3 d ir5 DataClass A Legal Director y-to-DataClass Relations hip dir6 dir8 di r9 DataClass B /dir1 dir2 dir4 dir 3 dir5 Dat[...]

AdministrativeT asks 2-14 Operat ing T asks 600716 Rev A Below is an example of the df command. In the example, the numbers given by fuser are pr ocesses accessing files in /tst1 . T o get more information on the process, use ps -elf and grep for the process number . Example St e p 1 . Use the UNIX ls command to verify that the directory to be asso[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-1 5 Opera itng T asks St e p 3 . V erify that the DataClass group is define d by using the fsclassinfo command. St e p 4 . If the DataClass group is not defined, see “All GUI class operations are run from ADMIN-> Define Class ->Create Groups or w ith the fsaddclass command.” on page 2-[...]

AdministrativeT asks 2-16 Operat ing T asks 600716 Rev A Remove Rel ations wi th fsrm rela tion C omm and A directory-to-DataClass relationship is removed and the directory is made a nonmigration directory by using the fsrmrelation operation. Removing a DataClass relationship from a directory causes it to be a nonmigration directory by FileServ . T[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-1 7 Opera itng T asks Change Rel ation Points Association points are moved up or down in the file system hierarchy tree from their original definition with the fsrollup and fsrolldown commands, or Define Class/Directory Relations menu. This is a useful operation in a djusting the size and manage[...]

AdministrativeT asks 2-18 Operat ing T asks 600716 Rev A In the figure below , the fsrollup command fails to roll up to dir1 from dir2 because dir6 is not a migration direc tory . The fsrollup function is performed on only one hierarchical directory l evel at a time. Roll up o f a DataClass group to a directory that is two or more levels above an u[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-1 9 Opera itng T asks St e p 3 . Specify the nam e of the directory to be rolled up to (the new association point). Roll Down D ataClass Group s The DataCla ss association point dire ctory level is cha nged using the fsrolldown comma nd. A directory at the associ ation point of the Dat aClas s g[...]

AdministrativeT asks 2-20 Operat ing T asks 600716 Rev A FileServ does not permit you to roll down to a directory that is two or mor e levels be low an as sociati on point o f the Dat aClass group. St e p 1 . Ensure that no regular files are in the specified directory . The only nodes are subdirectories, as these each become new association points.[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-2 1 Opera itng T asks Generate Da taClass Report While DataClass relation points are listed in the long format of the Class Information Report, individual directories at any position in the file system can be checked for their DataClass relationship with the fsdirclass command or Directory to Cl[...]

AdministrativeT asks 2-22 Operat ing T asks 600716 Rev A File Manage ment File ma nagement tracks file information, requests fi le copies, and controls disk space of files under FileServ control. The table below lists file topics: Pathname The directories and subdirectories under a migration point must have a full path name less than or equal to 25[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-2 3 Opera itng T asks When hard-linked files are stored and re trieved, the common file data is stored or retrieved for all of the links, no matter which file nam e is submitted with the f sstore command. The return sta tus for the operation list s a file name of any one of the links and not nec[...]

AdministrativeT asks 2-24 Operat ing T asks 600716 Rev A File spanning is enabled or disabled for each DataClass group by the fsaddclass command. The fsmodclass allows modification of DataClass group processing parameters while the fsfileinfo command reports all the locations of the spanned file. Clustering FileServ supports file clustering. File c[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-2 5 Opera itng T asks The c luster.config file, located under the FS_HOME / sysparms directory , controls file cl ustering parameters. Each DataClass group is added to this file and the applicable file siz e values are entered (file sizes are expresse d in millions of bytes). If the DataClass gr[...]

AdministrativeT asks 2-26 Operat ing T asks 600716 Rev A Modify File Attributes Files that reside in dir ectories associ ated with a Da taClass group have two types of attributes: • Attributes that specify the number of copies of the file to store. • Attributes that design ate how policy is applied. The default setting for these a ttributes are[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-2 7 Opera itng T asks Files can then sha re DataClass group paramet ers with other files in the DataClass group. These files deviate in how poli cy is applied and in the number of copies of that file that are allowed on media. The fschfiat command allows fine tuning of the file’ s attributes w[...]

AdministrativeT asks 2-28 Operat ing T asks 600716 Rev A Gen era te Report T o view information about file location and attributes, follow the steps below: St e p 1 . Run the fsfileinfo command, specifying the names of the files you want reports on. St e p 2 . For files stored on media, this report returns an identifier for each media where the fil[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-2 9 Opera itng T asks Class T run c Iden tifies whe ther t he fil e is a candidat e for cleanup po licy applica tion. File size Size in byte s. Loca tion Ide ntif ies w hethe r file r esid es on disk, ta pe, or both. Existin g Copies Number of copies of the fil e that current ly exist. T a rget [...]

AdministrativeT asks 2-30 Operat ing T asks 600716 Rev A Dat a Migration A migra tion directory is contro lled by FileS erv (for exam ple, a directory that has a DataClass association.) Files stored under this directory , as well as any s ubsequent subdirectories, are migrated from disk to media as specified by the DataClass parameters. A DataC las[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-3 1 Opera itng T asks Minimum T ime Paramete rs The mintime is the minimum amount of time after the file is written or read before any policy action is take n. The mintime determines eligibili ty for file storage and for file remova l from disk. For the cleanup policy , mintime is calcul ated as[...]

AdministrativeT asks 2-32 Operat ing T asks 600716 Rev A Migration and disk c leanup policies are impleme nted in the following policies : S torag e Poli cy St orage policy is used to mi grate eligible file dat a to media. When the policy is initiated, a list is generated to identify the files that must be stored to media. The list contains files t[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-3 3 Opera itng T asks The filesize.config file as shown in the example below , is read each ti me a list of files i s received for storage. This f ile is dynamic and enables the system administrator to make changes without recycl ing FileServ . ################################### ###############[...]

AdministrativeT asks 2-34 Operat ing T asks 600716 Rev A Cleanup Po licy Cleanup policy is used to remove file data from disk. The number of files removed is based on the available disk space requested for a file system. When the cleanup policy is run, each file that is a disk data truncation candidate is assigned a weight. This weight is a factor [...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-3 5 Opera itng T asks Overflow Policy The HIBLK_THRESHOLD and L OBLK_THRESHOLD syst em variables are located in t he fs_sysparm file. These variables are system-wide parameter s. FileSe rv reads the new values at startup t ime. If FileServ i s running, you must recycle the system to pickup the n[...]

AdministrativeT asks 2-36 Operat ing T asks 600716 Rev A • Normal. The normal store reque st is placed in the queue for processing along with all other resource requests. •E m e r g e n c y . The fspolicy command maintains a n internal store and truncate candidate list of files. When the command is invoked, those candidates m eeting the criteri[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-3 7 Opera itng T asks Eac h line in a . crontab file must consist of six positional fields, separat ed by spaces or tabs, and format ted as follows: Any of the first five fields can be a li st of values separat ed by commas. A value is either a number , or a p air of numbers that are separated b[...]

AdministrativeT asks 2-38 Operat ing T asks 600716 Rev A The specification of days is made by two f ields (day of the month and day of the week). If both are specified as a list of elements, the policy adheres to both. If one of the fields is an asteri sk, the other field determ ines the day of the month o r week. The example below shows this e ntr[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-3 9 Opera itng T asks • The two cases where storage policy is run on groupaclass and groupbclass run at 15 minutes past 4 and at 40 minute s past 4, respectiv ely , eve ry day of the year . • The storage policy application for tempclass is run at midnight on weekdays. Finally , storage polic[...]

AdministrativeT asks 2-40 Operat ing T asks 600716 Rev A St o r i n g an d Retrieving Dat a The set of DataClass group parameters govern how FileServ processes the movement of data from disk to media. The directories controlled by DataClass group pa rameters are called migration d irectories b ecause the data is move d (migrated) from disk to media[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-4 1 Opera itng T asks In addition to provi ding an immediate store functiona lity , the fsstore command allows the user to override, on a file basi s, the default val ues for the DataClass para meters that a f fect storage pr ocessing. T wo par ameters af fect how the file data is handled during[...]

AdministrativeT asks 2-42 Operat ing T asks 600716 Rev A Clean Up Dat a from Disk C leanup is the removal of data from disk after the application of the storage policy . Cleanup is spe cified with one of the commands below: • fsstore. • fspolicy -t. • fschfiat. Y ou c an overrides the cleanup action for a specific file by changing the file’[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-4 3 Opera itng T asks Cleanup by DataClass A Dat aClas s group p aramet er speci fies th e defau lt clea nup action. A Cleanup policy can be: • Completely disabled. - Files can be excluded from clean-up. Use this only for frequently acc essed files. • Immediate truncation following the stora[...]

AdministrativeT asks 2-44 Operat ing T asks 600716 Rev A A secondary file copy is written at the time the file is stored with the fsstore command by specifying the number of copies (including the primary file) up to the maximum number of copies set for the DataClass group. The number of secondary copies specified for a file cannot exceed the Da taC[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-4 5 Opera itng T asks After a file is eligible for storage, the file data for the primary copy is written to media . A volume is chosen for stora ge as either a defaul t for the Data Class gr oup (specifi ed when t he DataClass group is defined by the system a dministrator), or as a media type s[...]

AdministrativeT asks 2-46 Operat ing T asks 600716 Rev A Retriev e Files File s that resi de only on med ia are re trieved to d isk when accessed by the user during usual oper ations. Files can also be r e t r i e v e dt od i s kb yi s s u i n ga fsretrieve command. The fsretrieve command requires the name of each file to be retrieved. Mult iple fi[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-4 7 Opera itng T asks The fsretrieve command usually retrieves the primary copy of the file requested . If the primary copy is inaccessible or corrupted, the command defaults to the secondary copy . Completion sta tus returns when the files are succ essfully copied onto disk. The fsfileinfo comm[...]

AdministrativeT asks 2-48 Operat ing T asks 600716 Rev A Retrieve Files from T rashcan FileSe rv recovers a particul ar version of a migrated file that was modified or removed from an archival directory on disk. As migrated files are modified or removed, a n entry is placed in the trashcan with in formation to recover the file. Only the primary cop[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-4 9 Opera itng T asks The fsundelete -u recovers a pre vious version of a migrated file or deleted migration directo ries. The comma nd is spec ified wit h the ful l path nam e and rest ores the Fi leServ pointer to the area of the media where the data is stored. This operat ion is successful if[...]

AdministrativeT asks 2-50 Operat ing T asks 600716 Rev A Clean up T rashca n Another command that must be routinely run is fsclean .T h e fsclean command pur ges the FileServ trashcan information. Precautions must be taken when using the fsclean command. T r ashcan serves as the reposi tory for refere nces to media da ta that is delete d from the d[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-5 1 Opera itng T asks Retrieve Partia l Files The fsretrieve command supp orts partial file c opy to disk from media. A new file name is required, as well as a start and ending byte for the file dat a. W ith these parameters, t he part of the file specified in the byte range is copied onto disk [...]

AdministrativeT asks 2-52 Operat ing T asks 600716 Rev A Retrieve Secon dary Files If a file is stored to media as both a primary and secondary copy , the secondary copy of the file can be retrieved to disk as a new file by using the fsretrieve -c comman d. This is the only command that allows access to the secondary copy of a file. Delayed Dismoun[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-5 3 Opera itng T asks Media delayed in a drive can be dismounted with the fsdismount command. The fschstate or fsstate commands can b e used to determi ne if a drive is i n a delayed-dismount status. Note For more informa tion on these comma nds, refer to the fsaddcl ass comman d in th e Command[...]

AdministrativeT asks 2-54 Operat ing T asks 600716 Rev A Media Manage ment This section describes operations required by both the V olServ operator and the Fil eServ system admini strator for each media management function. The follo wing topi cs are discuss ed: Media Serv ices V olSe rv performs media services to manage the physical libraries and [...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-5 5 Opera itng T asks MediaCla ss Grou p Defi nitions There are 54 Media Class names with the following form: FileServID_mediatype_mediaclasstype There are ten possible values for FileServ ID: F0 through F9. Six values of mediaclasstype exist: ADDBLANK or ADDBLNK, CHECKIN, IMPOR T , DA T A, MIGR[...]

AdministrativeT asks 2-56 Operat ing T asks 600716 Rev A Load and Unload Media Loading and removing media in the storage subsyst ems is a two-step process. Media are physically entered and removed from the system through the V olServ softwa re. FileServ logically en ters and removes media . All media are physically entered into the storage subsyste[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-5 7 Opera itng T asks Remove Media St e p 1 . Run the fsmedout command with the media identifiers an d the -r option for the media to be checked out. The -t labeltext option is not supported at this time. St e p 2 . The physical location of the media ( -l location) is used for tracking the media[...]

AdministrativeT asks 2-58 Operat ing T asks 600716 Rev A Each type of media supported by FileServ has a defau lt media length specifi ed in the system p arameter s; -DEF_MED_SPC_mediatype . If two media of the same type have a different length, the -l option of the fsmedin command override s the default value. For exam ple, if two libraries are use[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-5 9 Opera itng T asks Remove Blank Media The f smedout command allows the remova l of blank media. T wo ways exist to remove blank media from the FileServ domain: • Checkout blank media. • Remove blank media. Check Out Bla nk Media Checking out blank media is NOT a common practice. Checking [...]

AdministrativeT asks 2-60 Operat ing T asks 600716 Rev A Checked-out blank media can be re-entered into the FileServ system using the f smedin -r command. If the re-entry of the Checked-out media is no longer required, the fsrminfo command is used to remove a ll knowledge of the media from the F ileSer v syste m. Remove Blank Media The f smedout -b[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-6 1 Opera itng T asks Format M edia All blank media introduced into the storage subsystem can be submitted for imme diate formatting or withheld from formatting. Media withheld (-w) from formatting is automatica lly formatted when c hosen for data storage or by manually issuing the fsformat comm[...]

AdministrativeT asks 2-62 Operat ing T asks 600716 Rev A Both types of duplications are described below . Copy Media The fsmedcopy -r c o m m a n di su s e dt or e p l a c em e d i ab y moving data onto newer , better media or rec laiming the wasted space because of f ragmentation. Data on the specified media is copied onto other media (specified m[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-6 3 Opera itng T asks Copy Files The fsfilecopy -r command functions like the fsmedcopy command, except i t replaces spec ified files, instea d of the ent ire media . A single file from media or several files fr om several media can be replaced. The only restriction is that all files must be in [...]

AdministrativeT asks 2-64 Operat ing T asks 600716 Rev A The valid states for media in th e FileServ system include the following: S t ate Description Protect Reserved for re ad-only operati ons. Unprotect A vailabl e for read an d write operations. A va ilab le Erro r fre e and r eside nt in the sto rage subsyst em. Unavaila ble Not used because i[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-6 5 Opera itng T asks Storage L imit Every FileSe rv installation has a storage limit ca pacity . If the storage limit capacit y is exceed ed, E-mail is s ent to the system administrator and a message is logged in the system log file. All St orage requests fail until the system administrator del[...]

AdministrativeT asks 2-66 Operat ing T asks 600716 Rev A After the amount of used storage is under the storage limit, FileServ must be cycled to re-enable Imports and Store requests. The STORE_LIMIT_NOTICE system parame ter located in $FS_HOME /sysparm directory , defines the range , in GB that remain b efore the s torag e capac ity is exc eed ed. [...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-6 7 Opera itng T asks St e p 1 . Run the fsmedinfo command and specify one or more media identifiers to report. St e p 2 . Use the -l option to obtain a long report. An example of the output is shown below: St e p 3 . If the parent of an i ndividual file cannot be found, the report shows que sti[...]

AdministrativeT asks 2-68 Operat ing T asks 600716 Rev A Media List The fsmedlist command or Media List scree n produces a list of all the media, or the media in a particula r DataClass group. If the class is not specified, the report lists information for media in all DataClass groups and media in the general blank pool. St e p 1 . Run the fsmedli[...]

AdministrativeT asks 600716 Rev A Oper ating Ta sks 2-6 9 Opera itng T asks St e p 3 . The -l option generates a longer report shown below that includes the identifiers of the media for each of the categorie s previously described. If no options are specified, all of the media identifiers in each category are listed, as shown below . The list is se[...]

AdministrativeT asks 2-70 Operat ing T asks 600716 Rev A NOTES[...]

Utilities 3 Utilities Utilities ................................... 3 - 3 f s p i c ................................... 3 - 3 a u t o s t a r ts c r i p t s ......................... 3 - 3 d b c h e c k ................................ 3 - 4 k e y b u i l d ............................... 3 - 6[...]

Administrative T asks 3-2 Uti lities 600716 Re v A Roadma p T opic Refer T o Chapter Initia liz e File Serv , c onfig ur e inter face w ith V olServ , perform star t up and shut down, modify system confi guratio n, and tune system for be tter per forman ce. 1 Manage: D ataClass , files , migratio n, data, an d media. 2 Usin g the F ileS erv ut ilit[...]

Administrative T asks 600716 Rev A Util itie s 3-3 Utilities Utilities The $FS_HOME/util directory contains softwar e tools used to simplify various operations. An explanation of each software tool is explained in the . README files. fspic The fspic utility displays a st atus of t he FileServ system including: • Hardware components. • Media mou[...]

Administrative T asks 3-4 Uti lities 600716 Re v A FileServ an d Amass Autost art If FileServ and AMASS are on t he same platform, the FileServ processes must be started before the AMA SS processes. If the autostart scripts are enabled for both F ileServ and AMASS, the FileServ autostart script must be executed before the AMASS autostart scr ipt. A[...]

Administrative T asks 600716 Rev A Util itie s 3-5 Utilities If you experience unusual behavior when running a FileServ command, look under $FS_HOME/internal/fsdb for any data or key files that are unusually large. These files will have a a .d01 or .k0x extension, where “x” is a number be tween 1 and 5. Unusually large file size may indicate th[...]

Administrative T asks 3-6 Uti lities 600716 Re v A keybuild The keybuild uti lity will rebuild all key files for a databas e. It rebuilds the key files by first reinitializing the file, and then sequentially reading a ll records from each data file and recreating each key field from the contents of the record. St e p 1 . From the $FS_HOME/util dire[...]

TT roubleshooting To o l s 4 T rouble- shooting T ools D a t aR e t r i e v a lF a i l s ......................... 4 - 3 C o m m a n d st h a tI D P r o b l e m s ................ 4 - 4 D i s a s t e rR e c o v e r y ....................... 4 - 4 M e s s a g e s .................................. 4 - 5 S t a t u sM e s s a g e s ...................[...]

Administrative T asks 4-2 T roub le- shoot ing T ools 6007 16 Rev A Roadma p T opic Refer T o Chapter Initia liz e File Serv , co nfigu re int erfa ce wi th V olServ , perform star t up and shut down, modify system confi guratio n, and tune system for be tter per forman ce. 1 Managing : DataCla ss, files , migrati on, data, and me dia. 2 Usin g the[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-3 T roubleshooting T ools Dat a Retrieval Fails If a data retri eval operatio n fails, the retur ned status me ssage usually provides information to determine t he cause of the failure. Reissuing the request usually corrects t he problem. However , if a message appears indicating one of [...]

Administrative T asks 4-4 T roub le- shoot ing T ools 6007 16 Rev A Commands that ID Problems The commands in the ta ble below will hel p you to further troubleshoot problems. For information on these commands, refer to t he man pages. Disaster Recovery The fsdump , fsrestore ,a n d fsaudit commands provide disaster recovery in case of a FileServ d[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-5 T roubleshooting T ools Messages Messages are displayed in response to a command or when certain events occur . Messages are divided into two categor ies: • St atus messages. • Syslog messages. Every status and syslog message that results from a F ileServ command includes a reque s[...]

Administrative T asks 4-6 T roub le- shoot ing T ools 6007 16 Rev A Syslog Messages Syslog messages are sent to a logging facili ty to inform a system administrator of important system conditions, to r ecord additional information about t hese conditions, or to reco rd the occurrence of an event. Eac h message has a n associated priority that deter[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-7 T roubleshooting T ools The log_monitor script is a alternative to newfslog for log maintenance. This script can be run as ne eded to refresh log files, or call ed from cron to monitor the logs and prevent them from filling up the $FS_HOME file system. Log cleaning w ill only be trigge[...]

Administrative T asks 4-8 T roub le- shoot ing T ools 6007 16 Rev A St e p 5 . Issue the UNIX tail command of the file logfile . As host messages are generated, they are displayed in this window. St e p 6 . Determine the log file where you can extract information, for example, $FS_HOME/syslogs/logfile . St e p 7 . Change directory ( cd ) to the dir[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-9 T roubleshooting T ools Recover Dat a T o support data recovery due to a disk crash, the following tasks are required: Dump Dat a The fsdump command is used to pe rform a dump of eac h file system . Enter a -f dumpfilename to specify the fi le system to be dumped. The f sdump comm and [...]

Administrative T asks 4-10 T roub le- shoot ing T ools 6007 16 Rev A The fsdump command also supports recovery for bac kup of nonmigration file systems. A log message advises the system administrator that the file syste m is not archival. The dump continues, but the fs_dump . file does not exist a nd is not dumped to the dump tape. The fsdump comma[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-11 T roubleshooting T ools If problems are disco vered, correc t them before continui ng. St e p 6 . Mount a tape on a drive. St e p 7 . Run the fsdump command with the argume nts appropriate to the platform as specified in the man page. Enter the destination file or drive and any option[...]

Administrative T asks 4-12 T roub le- shoot ing T ools 6007 16 Rev A Restoration of the entire file system is not re quired if a dump tape is lost or bad. However , restoration is recommende d. St e p 1 . V erify the new system is large enough to contain all t h ed a t ar e s t o r e df r o mt a p eb yu s i n gt h eU N I X df command. The /arch3 fi[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-13 T roubleshooting T ools Use the UNIX mkdir comma nd to create the par ent and rerun the fsaudit -r -f command. If the proce dure fails, call technical s upport. St e p 5 . Run the keyBuildAll utility to update the key files in the database. St e p 6 . Run fsaudit -f twice on the recov[...]

Administrative T asks 4-14 T roub le- shoot ing T ools 6007 16 Rev A Restore Data in Interact ive Mode St e p 1 . V erify that the disk file system is large enough to contain all the data restored from t ape by using the UNIX df command. St e p 2 . Run the xfsrestore -i co mmand . An interactive shell is invoked with the -> prompt. St e p 3 . Ru[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-15 T roubleshooting T ools All relation points in the dumped file system are specified on the extraction list. All relation point parents must exist. If a failure occurs, add the missing relation points to the extraction list and continue. St e p 5 . Add any additional files and director[...]

Administrative T asks 4-16 T roub le- shoot ing T ools 6007 16 Rev A If the fsaudit command fails with a message tha t indicates a relation parent unknown, the relation point parents are not on the dump tape. This situation occurs if: • All files are not recovered from the dump tape (bad dump tape). • Dump is not made after a DataCla ss relatio[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-17 T roubleshooting T ools S tep 12. T o rebuild the candidate lists, run the foll owing: Audit Dat abase The fsaudit command serves two purposes: • Recovery of file systems. • Database m aintenance c ompares UN IX file system information and FileS erv database information. The fsaud[...]

Administrative T asks 4-18 T roub le- shoot ing T ools 6007 16 Rev A Dat abase Mainte nance The FileServ database contai ns UNIX file system information to track the following: • Mig rat ion f ile s yste ms. • Med ia where fi les are stor ed. • Association points in the UNIX file system. • Files in directories that are related to DataClass [...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-19 T roubleshooting T ools When using the fsaudit -r com mand, all pa rent directories of relation points must be present in the fs_dump.file . If a parent direc tory does not exist for a relation point in the fs_dump.file ,t h e fsaudit com mand fails.[...]

Administrative T asks 4-20 T roub le- shoot ing T ools 6007 16 Rev A Troubleshoo t System Performance If the Dat aClass mintime parameter for the DataClass groups and cron setting that govern the frequency of the migration policy application for a DataClass group are set to too short a time, FileServ may be invoked too frequently . This is known as[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-21 T roubleshooting T ools Report s The table below lists the reports generated by Fi leServ: Dat aClass Report T o view the parameter setti ngs for each DataC lass identifier , follow the steps below: St e p 1 . Run the fsclassinfo command. Use the names of a specified DataClass gr oup [...]

Administrative T asks 4-22 T roub le- shoot ing T ools 6007 16 Rev A Media Fragmentat ion Report T o view a list of med ia suspected as fra gmented, fo llow the steps below: St e p 1 . Run the fsmedcopy com mand . The le vel o f fragmentation is defined by options submitted with the command Use other appropriate options as ne eded. For command info[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-23 T roubleshooting T ools In the example for media 000005, the amount of wasted space is 92.46 percent, which repre sents. 81.36 percent of the total space. Media Movement Report T o view a report showing media that has been removed o r added to the storage system, follow the steps belo[...]

Administrative T asks 4-24 T roub le- shoot ing T ools 6007 16 Rev A Resource Queue Report T o view a snapshot of FileServ reque sts waiting for resources, follow the steps below: St e p 1 . T o view all resource reque sts associated with your storage system, run the fsqueue command without options as shown be low: The table below lists the Request[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-25 T roubleshooting T ools St e p 2 . Use other appropriate options as ne eded. For command information, refer to the Command Refer ence book. History Report T o view a history of media and components, follow the steps below: St e p 1 . Run the fshistrpt comma nd with the -m mediaID opti[...]

Administrative T asks 4-26 T roub le- shoot ing T ools 6007 16 Rev A St e p 2 . Or , r un the fshistrpt command with the -h option for a component history report. An example of the output is shown below: Component St atistics Report T o view a snapshot of current device states in the stora ge systems, follow the steps bel ow: St e p 1 . Run the fsc[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-27 T roubleshooting T ools An example of the output is shown below: Hardware Configuration Report T o view a report of current drives and subsystems configured into the storage systems, follow the steps below: St e p 1 . Run the fsconfig command without options to generate a repor t for [...]

Administrative T asks 4-28 T roub le- shoot ing T ools 6007 16 Rev A An example of the output is shown below: % fsconfig -------------------------------------------------------------------- Hardware Configuration Report Component ID: V0,10 Thur Feb 4 16:41:41 1999 Device pathname: user Alias: Component Type: Drive Type: Drive ID: Delay Time: /dev/e[...]

Administrative T asks 600716 Rev A Trouble- shoo ting Tools 4-29 T roubleshooting T ools Cont a ct T echnic al Support Before contacting technical support, follow the steps below: St e p 1 . Obtain the following i nformation: • FileServ Serial Number: _________________ • Host ID: ____________________ St e p 2 . Contact technical support and be [...]

Administrative T asks 4-30 T roub le- shoot ing T ools 6007 16 Rev A NOTES[...]

600716 R ev A Inde x INX- 1 Index A add relation d u m pf i l e .................. 2 - 1 5 adobe acrobat rea der ............. P - 5 AML archive a d dd r i v e s .............. 1 - 2 7 ,1 - 5 5 d e l e t ed r i v e s ................ 1 - 5 5 A T A C .................... 1 - 2 2 ,4 - 2 9 autostart a m a s s ...................... 3 - 4 f i l e s e r[...]

Admi nist rativ e T as ks INX-2 Ind ex 600716 R ev A D data m i g r a t i o n .................. 2 - 3 0 physical security ............. 2 - 4 r e s t o r e ..................... 4 - 1 1 r e t r i e v e .................... 2 - 4 0 database m a i n t e n a n c e ................ 1 - 1 0 m a i n t e n a n c es c r i p t s .......... 1 - 4 2 r e c o [...]

Adminis trative T asks 600716 R ev A Inde x INX- 3 f s _ s y s p a r m ................. 2 - 6 6 log file m a i n t e n a n c e ................. 4 - 6 n e w f s l o g .................... 4 - 6 M management d a t a c l a s s .................... 2 - 2 dataclass groups .............. 2 - 2 m e d i a ......................... 1 - 4 3480 tape cartrid[...]

Admi nist rativ e T as ks INX-4 Ind ex 600716 R ev A R reader adobe acrobat ................ P - 5 recovery processing s t a r t u pa n ds h u t d o w n ......... 1 - 2 3 relation a d d ....................... 2 - 1 0 c h a n g ep o i n t s............... 2 - 1 7 m a n i p u l a t i o n ............... 2 - 1 0 r e m o v e.................... 2 - 1 [...]

Adminis trative T asks 600716 R ev A Inde x INX- 5 C O N N E C T _ R E T R I E S ....... 1 - 3 2 C O N N E C T _ S L E E P _ T I M E .... 1 - 3 2 DEF_FILE_RETENTION_PERIOD . 1-40 DEF_MED_SPC_3480 ....... 1 - 3 0 D E F _ M E D _ S P C _ C T I I I ....... 1 - 3 0 D E F _ M E D _ S P C _ C T I V ....... 1 - 3 0 D E F _ M E D _ S P C _ D 2 L G ...... 1[...]

Admi nist rativ e T as ks INX-6 Ind ex 600716 R ev A PERCENT_FULL_TO_MIGRATE . 1-35 STARVATION_PERCENT . . . 1-34 S T O R E _ L I M I T _ N O T I C E ..... 1 - 3 1 T S C _ L O G _ M A S K .......... 1 - 4 4 U S E R _ I D .................. 1 - 3 7 V S _ D E F _ Q U A N T I T Y ....... 1 - 4 1 VS_DEFAULT_DRIVEP OOL . . 1-4, 1-41 V S _ D I R.........[...]