Apache Geode CHANGELOG

Disk Store File Names and Extensions

Disk store files include store management files, access control files, and the operation log, or oplog, files, consisting of one file for deletions and another for all other operations.

The next tables describe file names and extensions; they are followed by example disk store files.

File Names

File names have three parts: usage identifier, disk store name, and oplog sequence number.

First Part of File Name: Usage Identifier

Values Used for Examples
OVERFLOW Oplog data from overflow regions and queues only. OVERFLOWoverflowDS1_1.crf
BACKUP Oplog data from persistent and persistent+overflow regions and queues. BACKUPoverflowDS1.if, BACKUPDEFAULT.if
DRLK_IF Access control - locking the disk store. DRLK_IFoverflowDS1.lk, DRLK_IFDEFAULT.lk

Second Part of File Name: Disk Store Name

Values Used for Examples
<disk store name> Non-default disk stores. name=“overflowDS1” DRLK_IFoverflowDS1.lk, name=“persistDS1” BACKUPpersistDS1_1.crf
DEFAULT Default disk store name, used when persistence or overflow are specified on a region or queue but no disk store is named. DRLK_IFDEFAULT.lk, BACKUPDEFAULT_1.crf

Third Part of File Name: oplog Sequence Number

Values Used for Examples
Sequence number in the format _n Oplog data files only. Numbering starts with 1. OVERFLOWoverflowDS1_1.crf, BACKUPpersistDS1_2.crf, BACKUPpersistDS1_3.crf

File Extensions

File extension Used for Notes
if Disk store metadata Stored in the first disk-dir listed for the store. Negligible size - not considered in size control.
lk Disk store access control Stored in the first disk-dir listed for the store. Negligible size - not considered in size control.
crf Oplog: create, update, and invalidate operations Pre-allocated 90% of the total max-oplog-size at creation.
drf Oplog: delete operations Pre-allocated 10% of the total max-oplog-size at creation.
krf Oplog: key and crf offset information Created after the oplog has reached the max-oplog-size. Used to improve performance at startup.

Example files for disk stores persistDS1 and overflowDS1:

bash-2.05$ ls -tlr persistData1/
total 8
-rw-rw-r--   1 person users        188 Mar  4 06:17 BACKUPpersistDS1.if
-rw-rw-r--   1 person users          0 Mar  4 06:18 BACKUPpersistDS1_1.drf
-rw-rw-r--   1 person users         38 Mar  4 06:18 BACKUPpersistDS1_1.crf

bash-2.05$ ls -tlr overflowData1/
total 1028
-rw-rw-r--   1 person users          0 Mar  4 06:21 DRLK_IFoverflowDS1.lk
-rw-rw-r--   1 person users          0 Mar  4 06:21 BACKUPoverflowDS1.if
-rw-rw-r--   1 person users 1073741824 Mar  4 06:21 OVERFLOWoverflowDS1_1.crf

Example default disk store files for a persistent region:

bash-2.05$ ls -tlr
total 106
-rw-rw-r--   1 person users       1010 Mar  8 15:01 defTest.xml
drwxrwxr-x   2 person users        512 Mar  8 15:01 backupDirectory
-rw-rw-r--   1 person users          0 Mar  8 15:01 DRLK_IFDEFAULT.lk
-rw-rw-r--   1 person users  107374183 Mar  8 15:01 BACKUPDEFAULT_1.drf
-rw-rw-r--   1 person users  966367641 Mar  8 15:01 BACKUPDEFAULT_1.crf
-rw-rw-r--   1 person users        172 Mar  8 15:01 BACKUPDEFAULT.if