Administering the Recoverable File System on UNIX
Total Page:16
File Type:pdf, Size:1020Kb
C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\RFS\ARFSTITL.fm March 8, 2010 4:20 pm Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta UniData Administering the Recoverable File System on UNIX UDT-720-RFSU-1 C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\RFS\ARFSTITL.fm March 8, 2010 4:20 pm Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Notices Edition Publication date: June 2008 Book number: UDT-720-RFSU-1 Product version: UniData 7.2 Copyright © Rocket Software, Inc. 1988-2008. All Rights Reserved. Trademarks The following trademarks appear in this publication: Trademark Trademark Owner Rocket Software™ Rocket Software, Inc. Dynamic Connect® Rocket Software, Inc. RedBack® Rocket Software, Inc. SystemBuilder™ Rocket Software, Inc. UniData® Rocket Software, Inc. UniVerse™ Rocket Software, Inc. U2™ Rocket Software, Inc. U2.NET™ Rocket Software, Inc. U2 Web Development Environment™ Rocket Software, Inc. wIntegrate® Rocket Software, Inc. Microsoft® .NET Microsoft Corporation Microsoft® Office Excel®, Outlook®, Word Microsoft Corporation Windows® Microsoft Corporation Windows® 7 Microsoft Corporation Windows Vista® Microsoft Corporation Java™ and all Java-based trademarks and logos Sun Microsystems, Inc. UNIX® X/Open Company Limited ii Administering the Recoverable File System on UNIX The above trademarks are property of the specified companies in the United States, other countries, or both. All other products or services mentioned in this document may be covered by the trademarks, service marks, or product names as designated by the companies who own or market them. License agreement This software and the associated documentation are proprietary and confidential to Rocket Software, Inc., are furnished under license, and may be used and copied only in accordance with the terms of such license and with the inclusion of the copyright notice. This software and any copies thereof may not be provided or otherwise made available to any other person. No title to or ownership of the software and associated documentation is hereby transferred. Any unauthorized use or reproduction of this software or documentation may be subject to civil or criminal liability. The information in the software and documentation is subject to change and should not be construed as a commitment by Rocket Software, Inc. Restricted rights notice for license to the U.S. Government: Use, reproduction, or disclosure is subject to restrictions as stated in the “Rights in Technical Data- General” clause (alternate III), in FAR section 52.222-14. All title and ownership in this computer software remain with Rocket Software, Inc. Note This product may contain encryption technology. Many countries prohibit or restrict the use, import, or export of encryption technologies, and current use, import, and export regulations should be followed when exporting this product. Please be aware: Any images or indications reflecting ownership or branding of the product(s) documented herein may or may not reflect the current legal ownership of the intellectual property rights associated with such product(s). All right and title to the product(s) documented herein belong solely to Rocket Software, Inc. and its subsidiaries, notwithstanding any notices (including screen captures) or any other indications to the contrary. Contact information Rocket Software 275 Grove Street Suite 3-410 Newton, MA 02466-2272 USA Tel: (617) 614-4321 Fax: (617) 630-7100 Web Site: www.rocketsoftware.com Administering the Recoverable File System on UNIX iii Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Table of Contents Table of Contents Chapter 1 Introduction to the Recoverable File System (RFS) RFS System Requirements . 1-3 Disk Space . 1-3 Memory . 1-4 Recommended Knowledge Base . 1-6 Overview of RFS . 1-7 ACID Qualities . 1-7 System Failures . 1-8 Media Failures . 1-9 Enabling RFS. 1-9 RFS Architecture . 1-10 RFS Components . 1-11 Logging . 1-12 Log Files . 1-12 Log File Overflow . 1-13 Archiving . 1-15 Archive Files . 1-15 Automatic Backup of Archive Files . 1-15 Synchronizing Backups with Archive Files . 1-16 Archive Configuration Table . 1-16 Creating and Converting Recoverable Files . 1-17 Creating a Recoverable File . 1-17 Converting to a Recoverable File . 1-18 Crash Recovery. 1-19 Recovering from a Media Crash . 1-19 Monitoring and Tuning RFS. 1-21 Chapter 2 RFS Commands and Daemons cntl_install Command. 2-3 Creating a Recoverable File . 2-6 :\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\RFS\ARFSTOC.fm (bookTOC.template) March 8 2010 4:16 pm Disabling a Recoverable File. 2-7 forcecp Command . 2-8 mediarec Command . 2-9 startud Command . 2-12 Example . 2-13 udfile Command . 2-14 Daemons for the Recoverable File System . 2-15 sm . 2-15 tm . 2-16 bimglog. 2-16 aimglog. 2-16 archive . 2-16 ar_backupd . 2-16 sync . 2-17 Chapter 3 Configuration Steps for Logging How Logging Works . 3-3 About Log Files . 3-3 About Checkpoints . 3-4 How to Turn On and Configure Logging . 3-6 Chapter 4 Configuration Steps for Archiving How Archiving Works. 4-3 How to Turn On and Configure Archiving . 4-4 Managing Archive Backup . 4-16 Backing Up Archives Manually . 4-16 Backing Up Archives Automatically . 4-17 Chapter 5 Creating and Configuring Recoverable Files Converting Nonrecoverable Files to Recoverable Files . 5-3 Creating New Recoverable Files . 5-6 Creating a List of Recoverable Files . 5-8 Special Considerations for Recoverable Files . 5-9 Chapter 6 System Crash Recovery System Crash Recovery . 6-3 Chapter 7 Media Crash Recovery Media Crash Recovery . 7-3 Data Lost, Logs, and Archives Unaffected . 7-4 Table of Contents v Data and Archive Files Unaffected, Logs Lost. 7-11 Data and Log Files Unaffected, Archives Lost. 7-13 Data and Logs Lost, Archives Unaffected . 7-15 Data and Archives Lost, Logs Unaffected . 7-22 Logs and Archives Lost, Data Unaffected . 7-29 Disk Containing /usr/ud72/include Lost . 7-30 Chapter 8 RFS Configuration Parameters UniData Configuration Parameters . 8-3 Modifying udtconfig Parameters . 8-7 RFS Configuration Parameters . 8-10 Chapter 9 Monitoring and Tuning The sysmon Utility . 9-3 sysmon Fields and Values . 9-4 Performance Tips . 9-11 Tuning N_PUT and N_BIG . 9-12 Adjusting the Log Files . 9-13 Adjusting the Archive Files . 9-13 Tuning CM_SLEEP . 9-14 RFS File Open Performance . 9-15 How RFS Tracks Open Files. 9-15 Tuning RFS Open File Performance . 9-15 Chapter 10 Troubleshooting RFS Possible Errors . 10-4 Failure of UniData to Start . 10-4 File Log Size Too Small . 10-4 Inadequate Number of Message Queues Defined . 10-5 Value of SYS_PV Changed in udtconfig . 10-6 Process Errors . 10-7 Values of N_TMQ and N_PGQ Are Zero. 10-7 UniData Daemon Killed . 10-8 Errors During Processing . 10-9 Archive Files Are Full. 10-9 aimglog and bimglog Executables Have Been Removed . 10-9 Parameter Limits Exceeded. 10-10 MAX_OPEN_FILE . 10-10 N_AFT . 10-10 BPF_NFILES . 10-10 vi Administering the Recoverable File System on UNIX Files Are Not Being Treated as Recoverable . 10-11 File is Not Defined as Recoverable . 10-11 SB_FLAG Turned Off . 10-11 Recoverable File System Not Licensed . 10-12 Warning Messages . 10-13 Log Files Are Too Small . 10-13 Table of Contents vii Chapter Introduction to the Recoverable File System 1 (RFS) RFS System Requirements. 1-3 Disk Space . 1-3 Memory . 1-4 Recommended Knowledge Base . 1-6 Overview of RFS. 1-7 ACID Qualities . 1-7 System Failures . 1-8 Media Failures . 1-9 Enabling RFS . 1-9 RFS Architecture. 1-10 RFS Components . 1-11 Logging . 1-12 Log Files . 1-12 Log File Overflow . 1-13 Archiving . 1-15 Archive Files . 1-15 Automatic Backup of Archive Files . 1-16 Synchronizing Backups with Archive Files . 1-16 Archive Configuration Table. 1-16 Creating and Converting Recoverable Files . 1-17 Creating a Recoverable File . 1-17 Converting to a Recoverable File . 1-18 Crash Recovery . 1-20 Recovering from a Media Crash . 1-20 Monitoring and Tuning RFS . 1-22 This document describes the Recoverable File System (RFS). RFS functions and utilities are designed to protect UniData files against system or media failures. RFS also supports UniData Transaction Processing semantics to provide the ACID properties (atomicity, consistency, isolation, and durability). This document does not cover the use of Transaction Processing semantics. For information on Transaction Processing, see Developing UniBasic Applications. For step-by-step information on configuration and use of RFS, see the chapters following this introduction. The purpose of this chapter is to describe the concepts associated with RFS. This chapter contains the following: RFS Requirements Overview of RFS RFS Architecture (graphic) RFS Components 1-2 RFS System Requirements If you plan to run the Recoverable File System, you need additional space and memory. The amount of additional space and memory depends on the type of platform you are running. UniData can only provide initial recommendations. The initial recommendations are based on baseline tests on a variety of platforms, with 20 users, record sizes ranging from 70 to 2,500 bytes, modulo 200, block size multiplier 3, and hash type 0. The recommendations discussed in the following sections are based on the test results. Check your installation media and make sure it matches your UNIX version. Refer to Installing and Licensing UniData Products for detailed information about installing UniData. Disk Space On most systems, you must have at least 125 MB of free disk space under one mount point for the UniData installation to run. Depending on the type of installation, some space—as much as 10 MB —may be released after installation.