Copyright © 2011-2023 Fidelity National Information Services, Inc. and/or its subsidiaries. All rights reserved.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.
GT.M™ is a trademark of Fidelity National Information Services, Inc. Other trademarks are the property of their respective owners.
This document contains a description of GT.M and the operating instructions pertaining to the various functions that comprise the system. This document does not contain any commitment of FIS. FIS believes the information in this publication is accurate as of its publication date; such information is subject to change without notice. FIS is not responsible for any errors or defects.
December 03, 2024
| Revision History | ||
|---|---|---|
| Revision V7.1-006 | 03 December 2024 | Updated the following chapters for V7.1-006: |
| Revision V7.1-005 | 18 September 2024 | Updated the following chapters for V7.1-005: |
| Revision V7.1-004 | 27 June 2024 | Updated the following chapters for V7.1-004: |
| Revision V7.1-003 | 23 November 2023 | Updated the following chapters for V7.1-003: |
| Revision V7.1-002 | 19 September 2023 | Updated the following chapters for V7.1-002: |
| Revision V7.1-001 | 26 June 2023 | Updated the following chapters for V7.1-001: |
| Revision V7.1-000 | 04 April 2023 | Updated the following chapters for V7.1-000: |
| Revision V7.0-005 | 02 December 2022 | Updated the following chapters for V7.0-005: |
| Revision V7.0-004 | 20 September 2022 | Updated the following chapters for V7.0-004: |
| Revision V7.0-003 | 24 June 2022 | Updated the following chapters for V7.0-003: |
| Revision V7.0-002 | 29 March 2022 | Updated the following chapters for V7.0-002: |
| Revision V7.0-001 | 24 November 2021 | Updated the following chapters for V7.0-001: |
| Revision V7.0-000 | 12 February 2021 | Updated the following chapters for V7.0-000: |
| Revision V6.3-014 | 06 October 2020 | Updated the following chapters for V6.3-014: |
| Revision V6.3-013 | 30 June 2020 | Updated the following chapters for V6.3-013: |
| Revision V6.3-012 | 08 April 2020 | Updated the following chapters for V6.3-012: |
| Revision V6.3-011 | 20 December 2019 | Updated the following chapters for V6.3-011: |
| Revision V6.3-010 | 31 October 2019 | Updated the following chapters for V6.3-010: |
| Revision V6.3-009 | 27 June 2019 | Updated the following chapters for V6.3-009: |
| Revision V6.3-008 | 24 April 2019 | Updated the following chapters for V6.3-008: |
| Revision V6.3-007 | 04 February 2019 | Updated the following chapters for V6.3-007: |
| Revision V6.3-006 | 26 October 2018 | Updated the following chapters for V6.3-006: |
| Revision V6.3-005 | 03 July 2018 | Updated the following chapters for V6.3-005: |
| Revision V6.3-004 | 23 March 2018 | Updated the following chapters for V6.3-004: |
| Revision V6.3-003 | 12 December 2017 | Updated the following chapters for V6.3-003: |
| Revision V6.3-002 | 22 August 2017 | Updated the following chapters for V6.3-002: |
| Revision V6.3-001 | 20 March 2017 | Updated the following chapters for V6.3-001: |
| Revision V6.2-001 | 27 February 2015 |
|
| Revision V6.1-000/1 | 04 September 2014 |
|
| Revision V6.1-000 | 01 August 2014 |
|
| Revision V6.0-003/1 | 19 February 2014 |
|
| Revision V6.0-003 | 27 January 2014 |
|
| Revision V6.0-001/2 | 10 April 2013 |
|
| Revision V6.0-001/1 | 22 March 2013 |
|
| Revision V6.0-001 | 27 February 2013 |
|
| Revision V6.0-000/1 | 21 November 2012 |
|
| Revision V6.0-000 | 19 October 2012 |
|
Contents
- About This Manual
- 1. About GT.M
- 2. Installing GT.M
- 3. Basic Operations
- 4. Global Directory Editor
- 5. General Database Management
- 6. GT.M Journaling
- Introduction
- Journal Files
- Recovery from a Journal File
- rolled_bak* files
- Journal Files Access Authorization
- Triggers in Journal Files
- BEFORE_IMAGE Journaling
- NOBEFORE_IMAGE Journaling
- Choosing between BEFORE_IMAGE and NOBEFORE_IMAGE
- Broken Transaction File
- Lost Transaction File
- Epoch
- Journaling Benefits
- Backup Journal Files
- Select database files for Journaling
- Fencing Transactions
- Deciding Whether to Use Fencing
- VIEW Keywords
- $VIEW() Keywords
- SET
- JOURNAL
- Journal Extract Formats
- 7. Database Replication
- Introduction
- Implementing Replication and Recovery
- Procedures
- Download Replication Examples
- Setting up an A→B replication configuration with empty databases
- Setting up an A→B→C replication configuration with empty databases
- Setting up an A→P replication configuration with empty databases
- Replicating Instance Starts from Backup of Originating Instance (A→B and A→P )
- Switchover possibilities in an A→B replication configuration
- Switchover possibilities in a B←A→P replication configuration
- Switchover possibilities in a B←A→P→Q replication configuration
- Changing the global directory in an A→B replication configuration
- Rolling Software Upgrade
- Shutting down an instance
- Creating a new Replication Instance File
- Setting up a secured TLS replication connection
- Schema Change Filters
- Recovering from the replication WAS_ON state
- Rollback data from crashed (idle) regions
- Setting up a new replicating instance of an originating instance (A→B, P→Q, or A→P)
- Replacing the replication instance file of a replicating instance (A→B and P→Q)
- Replacing the replication instance file of a replicating instance (A→P)
- Setting up a new replicating instance from a backup of the originating instance (A→P)
- Setting up an A→P configuration for the first time if P is an existing instance (having its own set of updates)
- Commands and Qualifiers
- Turning Replication On/Off
- Creating the Replication Instance File
- Displaying/Changing the attributes of Replication Instance File and Journal Pool
- Starting the Source Server
- Shutting down the Source Server
- Activating a Passive Source Server
- Deactivating an Active Source Server
- Stopping the Source Filter
- Stopping the Receiver Filter
- Freezing an Instance
- Checking Server Health
- Changing the Log File
- Enabling/Disabling Detailed Logging
- Reporting the Current Backlog of Journal Records
- Processing Lost Transactions File
- Starting the Receiver Server
- Starting the Update Process
- Stopping the Receiver Server and/or the Update Process
- Checking Server Health
- Changing the Log File
- Enabling/Disabling Detailed Logging
- Reporting the Current Backlog of Journal Records
- Rolling Back a Replicated Database
- 8. M Lock Utility (LKE)
- 9. GT.M Database Structure(GDS)
- 10. Database Structure Editor
- 11. Maintaining Database Integrity
- Verifying Database Integrity
- Approaches to Database Recovery
- Repairing the Database with DSE
- Finding and Fixing Database Errors
- C1–Possible Cache Control Problems
- H1–Process Hangs
- H3–Database Access Problems
- H4–Database Cache Problems
- H5–Critical Section Problems
- H6–UNIX Problems
- H7–Disk Hardware Problems
- H8–Application Problems
- I1–MUPIP INTEG Errors
- MUPIP INTEG Error Classification Table
- I2–GT.M Version Mismatch
- I3–File Header Errors
- I4–File Size Errors
- I5–More Database Access Problems
- I6–Transient Errors
- I7–Database Rundown Problem
- I8–Repair-Induced Problems
- K1–Bad Key
- K2–Keys Misplaced
- K3–Block Doubly Allocated
- K4–Pointer Problems
- K5–Star Key Problems
- K6–Compression Count Error
- K7–Key Warning
- M1–Bitmap Errors
- M2–Bitmap Header Problems
- O1–Bad Block
- O2–Record Errors
- O3–Data Block Errors
- O4–Salvage of Data Blocks with Lost Indices
- O5–Salvage of a damaged spanning node
- O6–Block Size Errors
- P1–Process Damage
- Q1–Restricting Database Access
- R1–GT.M Run-Time Errors
- R2–Structural Database Integrity Errors
- Run-Time Database Restart Codes
- R3–Run-time Database Cache Problems
- R4–Stopped Processes
- R5–No More Room in the File
- R6–GTMASSERT and GTMCHECK Errors
- R7–Interlocked Queue Hardware Problems
- R8–Database Tree Maximum Level Exceeded
- R9–Read-only Process Blocked
- 12. Database Encryption
- 13. GT.CM Client/Server
- A. GT.M's IPC Resource Usage
- B. Monitoring GT.M
- C. Building Encryption Libraries
- D. GT.M Security Philosophy
- E. GTMPCAT - GT.M Process/Core Analysis Tool
- F. Packaging GT.M Applications
- G. Creating a $gtmcrypt_config file
- H. V6 to V7 DB Upgrade
