Oracle Berkeley DB Upgrade Guide 11g Release 2

Welcome to Berkeley DB (DB). This document describes how to upgrade from previous versions of Berkeley DB. This document reflects Berkeley DB 11g Release 2, which provides DB library version 11.2.5.1.

More PDF Content

Oracle Berkeley DB Upgrade Guide 11g Release 2
Preface … xi
Conventions Used in this Book … xi
For More Information … xi
Contact Us … xii
1. Introduction … 1
Library version information … 1
2. Upgrading from previous versions of Berkeley DB … 2
3. Upgrading Berkeley DB 4.6 applications to Berkeley DB 4.7 … 6
Introduction … 6
Run-time configuration … 6
Replication API … 6
Tcl API … 6
DB_ENV->set_intermediate_dir … 7
Log configuration … 7
Upgrade Requirements … 7
Berkeley DB 4.7.25 Change Log … 7
Database or Log File On-Disk Format Changes: … 7
New Features: … 7
Database Environment Changes: … 8
Concurrent Data Store Changes: … 8
General Access Method Changes: … 8
Btree Access Method Changes: … 9
Hash Access Method Changes: … 9
Queue Access Method Changes: … 9
Recno Access Method Changes: … 9
C-specific API Changes: … 9
Java-specific API Changes: … 9
Direct Persistence Layer (DPL), Bindings and Collections API: … 10
Tcl-specific API Changes: … 10
RPC-specific Client/Server Changes: … 11
Replication Changes: … 11
XA Resource Manager Changes: … 12
Locking Subsystem Changes: … 12
Logging Subsystem Changes: … 12
Memory Pool Subsystem Changes: … 13
Mutex Subsystem Changes: … 13
Transaction Subsystem Changes: … 13
Utility Changes: … 13
Configuration, Documentation, Sample Application, Portability and Build
Changes: … 14
4. Upgrading Berkeley DB 4.5 applications to Berkeley DB 4.6 … 15
Introduction … 15
C API cursor handle method names … 15
DB_MPOOLFILE->put … 15
B_MPOOLFILE->set … 15
Replication Events … 16
DB_REP_FULL_ELECTION … 16
Verbose Output … 16
DB_VERB_REPLICATION … 17
Windows 9X … 17
Upgrade Requirements … 17
Berkeley DB 4.6.21 Change Log … 17
4.6.21 Patches: … 17
4.6.19 Patches … 18
Database or Log File On-Disk Format Changes: … 18
New Features: … 18
Database Environment Changes: … 19
Concurrent Data Store Changes: … 20
General Access Method Changes: … 20
Btree Access Method Changes: … 21
Hash Access Method Changes: … 21
Queue Access Method Changes: … 21
Recno Access Method Changes: … 21
C++-specific API Changes: … 21
Java-specific API Changes: … 21
Java collections and bind API Changes: … 22
Tcl-specific API Changes: … 22
RPC-specific Client/Server Changes: … 22
Replication Changes: … 22
XA Resource Manager Changes: … 24
Locking Subsystem Changes: … 24
Logging Subsystem Changes: … 24
Memory Pool Subsystem Changes: … 24
Transaction Subsystem Changes: … 24
Utility Changes: … 24
Configuration, Documentation, Portability and Build Changes: … 25
5. Upgrading Berkeley DB 4.4 applications to Berkeley DB 4.5 … 26
Introduction … 26
deprecated interfaces … 26
DB->set_isalive … 26
DB_ENV->rep_elect … 26
Replication method naming … 27
Replication events … 27
Memory Pool API … 27
DB_ENV->set_paniccall … 27
DB->set_pagesize … 27
Collections API … 28
–enable-pthread_self … 28
Recno backing text source files … 28
Application-specific logging … 28
Upgrade Requirements … 29
Berkeley DB 4.5.20 Change Log … 29
Database or Log File On-Disk Format Changes: … 29
New Features: … 29
Database Environment Changes: … 29
Concurrent Data Store Changes: … 30
General Access Method Changes: … 30
Btree Access Method Changes: … 30
Hash Access Method Changes: … 31
Queue Access Method Changes: … 31
Recno Access Method Changes: … 31
C++-specific API Changes: … 31
Java-specific API Changes: … 31
Java collections and bind API Changes: … 31
Tcl-specific API Changes: … 31
RPC-specific Client/Server Changes: … 32
Replication Changes: … 32
XA Resource Manager Changes: … 32
Locking Subsystem Changes: … 32
Logging Subsystem Changes: … 32
Memory Pool Subsystem Changes: … 33
Transaction Subsystem Changes: … 33
Utility Changes: … 34
Configuration, Documentation, Portability and Build Changes: … 34
6. Upgrading Berkeley DB 4.3 applications to Berkeley DB 4.4 … 35
Introduction … 35
DB_AUTO_COMMIT … 35
DB_DEGREE_2, DB_DIRTY_READ … 35
DB_JOINENV … 35
mutexes … 36
DB_MPOOLFILE->set_clear_len … 36
lock statistics … 37
Upgrade Requirements … 37
Berkeley DB 4.4.16 Change Log … 37
Database or Log File On-Disk Format Changes: … 37
New Features: … 37
Database Environment Changes: … 38
Concurrent Data Store Changes: … 38
General Access Method Changes: … 39
Btree Access Method Changes: … 39
Hash Access Method Changes: … 40
Queue Access Method Changes: … 40
Recno Access Method Changes … 40
C++-specific API Changes: … 40
Java-specific API Changes: … 40
Java collections and bind API Changes: … 41
Tcl-specific API Changes: … 42
RPC-specific Client/Server Changes: … 42
Replication Changes: … 42
XA Resource Manager Changes: … 43
Locking Subsystem Changes: … 43
Logging Subsystem Changes: … 43
Memory Pool Subsystem Changes: … 44
Transaction Subsystem Changes: … 44
Utility Changes: … 45
Configuration, Documentation, Portability and Build Changes: … 45
Berkeley DB 4.4.20 Change Log … 46
Changes since Berkeley DB 4.4.16: … 46
7. Upgrading Berkeley DB 4.2 applications to Berkeley DB 4.3 … 47
Introduction … 47
Java … 47
DB_ENV->set_errcall, DB->set_errcall … 48
DBcursor->c_put … 48
DB->stat … 48
DB_ENV->set_verbose … 48
Logging … 49
DB_FILEOPEN … 49
ENOMEM and DbMemoryException … 49
Replication … 49
Run-time configuration … 50
Upgrade Requirements … 50
Berkeley DB 4.3.29 Change Log … 50
Database or Log File On-Disk Format Changes: … 50
New Features: … 50
Database Environment Changes: … 50
Concurrent Data Store Changes: … 52
General Access Method Changes: … 52
Btree Access Method Changes: … 53
Hash Access Method Changes: … 53
Queue Access Method Changes: … 54
Recno Access Method Changes … 54
C++-specific API Changes: … 54
Java-specific API Changes: … 55
Tcl-specific API Changes: … 55
RPC-specific Client/Server Changes: … 56
Replication Changes: … 56
XA Resource Manager Changes: … 57
Locking Subsystem Changes: … 57
Logging Subsystem Changes: … 58
Memory Pool Subsystem Changes: … 58
Transaction Subsystem Changes: … 58
Utility Changes: … 59
Configuration, Documentation, Portability and Build Changes: … 60
8. Upgrading Berkeley DB 4.1 applications to Berkeley DB 4.2 … 62
Introduction … 62
Java … 62
Queue access method … 63
DB_CHKSUM_SHA1 … 64
DB_CLIENT … 64
DB->del … 64
DB->set_cache_priority … 64
DB->verify … 64
DB_LOCK_NOTGRANTED … 65
Replication … 65
Replication initialization … 65
Database methods and replication clients … 65
DB_ENV->rep_process_message() … 66
Client replication environments … 66
Tcl API … 66
Upgrade Requirements … 66
Berkeley DB 4.2.52 Change Log … 66
Database or Log File On-Disk Format Changes: … 66
New Features: … 66
Database Environment Changes: … 67
Concurrent Data Store Changes: … 69
General Access Method Changes: … 69
Btree Access Method Changes: … 70
Hash Access Method Changes: … 71
Queue Access Method Changes: … 71
Recno Access Method Changes: … 72
C++-specific API Changes: … 73
Java-specific API Changes: … 73
Tcl-specific API Changes: … 74
RPC-specific Client/Server Changes: … 75
Replication Changes: … 75
XA Resource Manager Changes: … 78
Locking Subsystem Changes: … 78
Logging Subsystem Changes: … 79
Memory Pool Subsystem Changes: … 80
Transaction Subsystem Changes: … 80
Utility Changes: … 81
Configuration, Documentation, Portability and Build Changes: … 81
9. Upgrading Berkeley DB 4.0 applications to Berkeley DB 4.1 … 84
Introduction … 84
DB_EXCL … 84
DB->associate, DB->open, DB->remove, DB->rename … 84
DB_ENV->log_register … 86
st_flushcommit … 86
DB_CHECKPOINT, DB_CURLSN … 86
DB_INCOMPLETE … 87
DB_ENV->memp_sync … 87
DB->stat.hash_nelem … 87
Java exceptions … 87
C++ exceptions … 87
Application-specific logging and recovery … 88
Upgrade Requirements … 88
Berkeley DB 4.1.24 and 4.1.25 Change Log … 88
Database or Log File On-Disk Format Changes: … 88
Major New Features: … 88
General Environment Changes: … 89
General Access Method Changes: … 90
Btree Access Method Changes: … 91
Hash Access Method Changes: … 91
Queue Access Method Changes: … 92
Recno Access Method Changes: … 92
C++-specific API Changes: … 92
Java-specific API Changes: … 93
Tcl-specific API Changes: … 93
RPC-specific Client/Server Changes: … 93
Replication Changes: … 93
XA Resource Manager Changes: … 93
Locking Subsystem Changes: … 94
Logging Subsystem Changes: … 94
Memory Pool Subsystem Changes: … 94
Transaction Subsystem Changes: … 95
Utility Changes: … 95
Configuration, Documentation, Portability and Build Changes: … 95
Berkeley DB 4.1.25 Change Log … 97
10. Upgrading Berkeley DB 3.3 applications to Berkeley DB 4.0 … 98
Introduction … 98
db_deadlock … 98
lock_XXX … 98
log_XXX … 98
memp_XXX … 99
txn_XXX … 100
db_env_set_XXX … 101
DB_ENV->set_server … 102
DB_ENV->set_lk_max … 102
DB_ENV->lock_id_free … 102
Java CLASSPATH environment variable … 102
C++ ostream objects … 103
application-specific recovery … 103
Upgrade Requirements … 104
4.0.14 Change Log … 104
Major New Features: … 104
General Environment Changes: … 104
General Access Method Changes: … 105
Btree Access Method Changes: … 105
Hash Access Method Changes: … 105
Queue Access Method Changes: … 105
Recno Access Method Changes: … 105
C++ API Changes: … 105
Java API Changes: … 105
Tcl API Changes: … 105
RPC Client/Server Changes: … 106
XA Resource Manager Changes: … 106
Locking Subsystem Changes: … 106
Logging Subsystem Changes: … 106
Memory Pool Subsystem Changes: … 106
Transaction Subsystem Changes: … 107
Utility Changes: … 107
Database or Log File On-Disk Format Changes: … 107
Configuration, Documentation, Portability and Build Changes: … 107
11. Upgrading Berkeley DB 3.2 applications to Berkeley DB 3.3 … 109
introduction … 109
DB_ENV->set_server … 109
DB->get_type … 109
DB->get_byteswapped … 109
DB->set_malloc, DB->set_realloc … 109
DB_LOCK_CONFLICT … 110
memp_fget, EIO … 110
txn_prepare … 111
–enable-dynamic, –enable-shared … 111
–disable-bigfile … 111
Upgrade Requirements … 111
12. Upgrading Berkeley DB 3.1 applications to Berkeley DB 3.2 … 112
introduction … 112
DB_ENV->set_flags … 112
DB callback functions, app_private field … 112
Logically renumbering records … 112
DB_INCOMPLETE … 113
DB_ENV->set_tx_recover … 113
DB_ENV->set_mutexlocks … 113
Java and C++ object reuse … 114
Java java.io.FileNotFoundException … 114
db_dump … 114
Upgrade Requirements … 114
13. Upgrading Berkeley DB 3.0 applications to Berkeley DB 3.1 … 115
introduction … 115
DB_ENV->open, DB_ENV->remove … 115
DB_ENV->set_tx_recover … 115
DB_ENV->set_feedback, DB->set_feedback … 115
DB_ENV->set_paniccall, DB->set_paniccall … 116
DB->put … 116
identical duplicate data items … 117
DB->stat … 117
DB_SYSTEM_MEM … 117
log_register … 118
memp_register … 118
txn_checkpoint … 118
environment configuration … 118
Tcl API … 119
DB_TMP_DIR … 119
log file pre-allocation … 119
Upgrade Requirements … 120
14. Upgrading Berkeley DB 2.X applications to Berkeley DB 3.0 … 121
introduction … 121
environment open/close/unlink … 121
function arguments … 124
DB_ENV structure … 125
database open/close … 126
db_xa_open … 127
DB structure … 127
DBINFO structure … 128
DB->join … 129
DB->stat … 130
DB->sync and DB->close … 130
lock_put … 130
lock_detect … 130
lock_stat … 130
log_register … 130
log_stat … 130
memp_stat … 131
txn_begin … 131
txn_commit … 131
txn_stat … 131
DB_RMW … 131
DB_LOCK_NOTHELD … 131
EAGAIN … 132
EACCES … 132
db_jump_set … 132
db_value_set … 133
DbEnv class for C++ and Java … 133
Db class for C++ and Java … 135
additional C++ changes … 135
additional Java changes … 135
Upgrade Requirements … 136
15. Upgrading Berkeley DB 1.85 or 1.86 applications to Berkeley DB 2.0 … 137
Introduction … 137
System Integration … 137
Converting Applications … 138
Upgrade Requirements … 139

Download Oracle Berkeley DB Upgrade Guide 11g Release 2 pdf from download.oracle.com, 152 pages, 1043.18KB.
Related Books

Leave a Reply