Data Retrieval Fails | ADIC FileServ Version 4.0 600716 Rev A

Administrative Tasks

Data Retrieval Fails

If a data retrieval operation fails, the returned status message usually provides information to determine the cause of the failure.

Reissuing the request usually corrects the problem.

However, if a message appears indicating one of the reasons below is responsible for the failure, additional troubleshooting is needed before reissuing the request.

•A database access error.

•An abnormal process failure (a process abnormally terminates or is killed).

•A communication message is not received.

•Resources are not allocated (no resources available).

•The FileServ software terminates (either abnormally or intentionally).

•A file or media access problem.

600716 Rev A

Trouble- shooting Tools

4-3

Troubleshooting Tools

Image 155

ADIC FileServ Version 4.0 600716 Rev A manual Data Retrieval Fails

Contents

FileServ Version February Rev a Administrative Tasks East Peakview Ave Englewood, CO 80111 USA Phone FAX Trademark Notice Reader Comment Form Page Contents Administrative Tasks Operating Tasks Administrative Tasks Utilities Index Preface Preface Troubleshooting Tools Troubleshoot operating problems Su root ConventionsConventions used throughout the FileServ technical books Are listed below Online Books Books Publications described in the table below are created RelatedPublications Contact Publications Department Secured Web Site System Tasks Topic Refer To Chapter Roadmap FileServ Access the Host Server Drive Pools Interface to VolServ Library AssociateMediaClass with Define DataClass Groups Associate Directories These files are stored using the fsstore command Media Under FileServ Management Tape CreateMigration Policies Part of the FileServ system routine processing includes Routine Processing Chkpoint.pl Script checkpoints the Raima database database recovery isFaster and more reliable when regular checkpoints are taken CheckDBALL # $FSHOME/util/checkDBAll tempfilename DailyMonthly Bi-weekly KeyBuildAll Utilities that operate on specific file systems are Mode Command Line Options Description Frequency of Use # su root # $FSHOME/util/fsrecover Trashcan Cleanup System Tasks Normal Startup Startup and Shutdown Contingency Startup RecoveryProcessing FileServ -c Run the FileServ -ccommand Shutdown Normal # ps -elf grep fs # ps -elf grep fsadm System Tasks Managing System Configuration Parameters AdministrationGeneral Parameters System Filelblfmttape DLT Maximum number of drives allowed Parameters can be tuned, if Maximum number of retries for any Maxtapetotapeallocti Threshold value when equalled or YES None Default media type D2S, D2M, D2L Comment keyword search and file expiration processes. To Retry the commandFile Retention Following list shows parameters that are used by the file Following parameters are specific to the VolServ system VolServ-specific Following list shows the system parameters that are to be InstallationInstallation script for this purpose Completely reinitialized and reinstalled Default component ID only for Software Maintenance Following list shows parameters that can be modified, as Media StatsLogging Parameters Fsfacility FileServ system parameters $FSHOME/fssysparm file Configurable system parameters are modified by editingEdit the fssysparm file using a text editor Edit System An example for the Classmtime parameter is shown below Recycle FileServ by running the command below Administrative Tasks Add a Library Delete a Device Edit Device Generate Report Run the fsconfig commandFsconfig Fsconfig command can configure various drives. Drive Names Supported Drives Supported Media Media Types Change Component State Unavail Maint OFF Unknown Tasks Add and Delete Drives Cshrc Located in the $FSHOME/sysparms directory Using a text editor, open the fssysparm fileFine-tune Parameters Reallocate Drives Identified in the table below Modify any of the default tape utilization parametersModify Tape Usage Applications Redirect Policy Administrative Tasks Operating Tasks Topic Refer To Special DataClass Management Topic DataClass Groups Fsaddclass prodclass To create a DataClass group, follow the steps below Group parameter. Then either change the class Run the fsmodclass command and specify aDataClass group name Use fsclassinfo to compare each DataClass Remove Group with fsrmclass Command Fsclassinfo lowtwr6 -l Table below describes the report’s fields Operaitng Tasks Relation is added with the fsaddrelation operation Add Relations with fsaddrelation CommandManipulate Relations Associate New Data with New Relations Associate New Directories with Files Dir1 Directory to be associated already exists Use the Unix ls command to verify that Fsdump -f /arch1/site1production.dumpfile /site1/production Fsaddrelation production -c england Fsrmrelation production Run the fsrmrelation commandSpecify the name of the directory to disassociate Change Relation Points Roll Up DataClass Groups Dir1 Dir2 Dir6 Fsrollup production Fsrolldown production Dir7 Fsdirclass /production FileServ supports hard links and soft links File ManagementPathname Links Spanning Clustering Operaitng Tasks Modify File Attributes Fschfiat -i test1 Generate Report Operaitng Tasks Data Migration File Cleanup Time parameters does not establish the DataClass migration Rather, the planned execution of migration and disk cleanupPolicies as well as the DataClass characteristics provide Cleanup policies using the fspolicy command with various Storage Policy ######################################################## Example only Cleanup Policy Overflow Policy Running as a cron Event Minutes hours day-of-month month day-of-week command 1,15 AdministrativeTasks Store Files Storing Retrieving Data Operaitng Tasks Name Clean Up Data from DiskCleanup by File DataClass Cleanup byCopy Secondary Files General Storage Processing Operaitng Tasks Retrieve Files Operaitng Tasks For more information on the fsundelete command, refer to Operaitng Tasks AdministrativeTasks Files Retrieve Partial Delayed Dismount Operaitng Tasks Libraries and movement of media Media ServicesVolServ performs media services to manage the physical Media Management Media Class Type Definition Load and Unload Media Add Blank Media Remove Media Run the fsmedin command with the -boption Marred when the media is entered, the media isMedia are entered by the VolServ operator using Import command and the MediaClass Media Fsmedout command allows the removal of blank mediaRemove Blank Remove Blank Media Format Media Media Duplication Copy Media Copy Files Media States State Description Storage Limit Generate Media Reports Fsmedinfo -l feu002 Fsmedlist -c testclass Media ListFor media in all DataClass groups and media in the general Blank pool Options are specified, all of the media identifiers -loption generates a longer report shownBelow that includes the identifiers of the media for Each of the categories previously described. If no AdministrativeTasks Utilities Utilities Scripts UtilitiesFspic Autostart Dbcheck Extension To determine the name of the databaseDirectory for files ending with the .dbd Keybuild Trouble- shooting Tools Trouble- shooting Tools Data Retrieval Fails Disaster Recovery Commands that ID Problems Status Messages Messages Syslog Messages Extract Syslog Messages Log File Maintenance Logging Set Up FileServ Run the fsextlog command specifying the log Issue the Unix tail command of the fileDetermine the log file where you can extract Change directory cd to the directory where the log Recover Data Xfscheck /dev/dsk/dks2d6s7 Restore Data Xfsrestore -f /dev/rmt/tps0d3 /arch3 Data restored from tape by using the Unix dfCommand /arch3 file system is used throughout this Example Run the xfsrestore command Run the keyBuildAll utility to update the key Use the Unix mkdir command to create the parentRerun the fsaudit -r -f command If the procedure fails, call technical support Add home add mrktg add junk Run the xfsrestore -i command Extract Cd ../trunccandidates File System Recovery Fsaudit command serves two purposesRecovery of file systems Database maintenance compares Unix file system Running fsaudit CommandDatabase Rev a Trouble- shooting Tools Troubleshoot System Performance Report Reports Class Media Fragmentation Report Fsmoverpt Media Movement Report Fsqueue Table below lists the Request Types and State fields History Report Fshistrpt -h V0, 10, V0, 11, V0, 12, V0, 13, V0 Component Statistics Report Fschstate Hardware Configuration Report Drive Contact Technical Support Administrative Tasks Index INX-2 INX-3 Commandextractheader Commandinfodetail -43 Commandlogging Deffileretentionperiod Connectretries -32 Connectsleeptime Percentfulltomigrate