diff --git a/DocBook/docs.xml b/DocBook/docs.xml index f9834558..f513c33d 100644 --- a/DocBook/docs.xml +++ b/DocBook/docs.xml @@ -22,7 +22,7 @@
Release Notes - The following are the release notes for HammerDB v4.3. + The following are the release notes for HammerDB v4.4.
Nomenclature Change @@ -73,23 +73,16 @@ configuration has been modified to use the InnoDB storage engine instead of MyISAM and to remove additional indexes on the LINEITEM table not compliant with the TPC-H specification. Consequently - performance of TPROC-H on MySQL and MariaDB in version 4.3 is not - comparable with version 4.2 and earlier. + performance of TPROC-H on MySQL and MariaDB in version 4.3 and above + is not comparable with version 4.2 and earlier.
- sslmode support for PostgreSQL - - From version 4.3 PostgreSQL connections support SSL - connections this requires OpenSSL on client and server and - needs to be enabled in PostgreSQL at compilation. When enabled - HammerDB uses the "prefer" option as default meaning that when - selected if SSL is supported and available HammerDB will use it. When - unselected "disable" is used and SSL is not used even if supported. - Where SSL is enabled and used performance should not be directly - compared to HammerDB v4.2 and earlier where SSL is not - supported. + PostgreSQL Citus Data Support + + From version 4.4 the PostgreSQL TPROC-C workloads support Citus Data distributed + PostgreSQL environments.
@@ -162,7 +155,7 @@ DIAG_DDE_ENABLED=FALSE
Documentation License and Copyright - Copyright (C) 2021 Steve Shaw. + Copyright (C) 2022 Steve Shaw. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version @@ -173,24 +166,30 @@ DIAG_DDE_ENABLED=FALSE
- HammerDB v4.3 New Features + HammerDB v4.4 New Features - HammerDB v4.3 New Features are all referenced to HammerDB v4.4 New Features are all referenced to GitHub Issues and Pull Requests, where more details for each new feature - and related pull requests can be found here: + and related pull requests can be found here: + + [TPC-Council#306] Fix getcols can return zero, resulting in + divide-by-zero + + [TPC-Council#303] readline: only catch signals when using + interact - [TPC-Council#279] Add performance metrics for PostgreSQL + [TPC-Council#302] Add optional Citus support - [TPC-Council#278] Add CLI to Web Service with SQLite repository - for output, timing and transactions + [TPC-Council#301] Build dataset using COPY instead of multi-row + inserts for TPROC-C - [TPC-Council#274] Update for #264 [TPROC-H] MySQL create FKs after - table load + [TPC-Council#298] Make Linux hammerdb executable work with spaces + in PATH - [TPC-Council#271] Add sslmode support for PostgreSQL - database + [TPC-Council#295] Optimize MakeAlphaString + + [TPC-Council#292] Standardize indentation of tcl files
@@ -280,14 +279,14 @@ DIAG_DDE_ENABLED=FALSE MariaDB - 10.2 / 10.3 / 10.4 / 10.5 / 10.6 + 10.2 / 10.3 / 10.4 / 10.5 / 10.6 / 10.8 PostgreSQL (EnterpriseDB) (Amazon Redshift) (Greenplum) - 10.2 / 10.3 / 11 / 12 / 13 + 10.2 / 10.3 / 11 / 12 / 13 / 14 @@ -305,12 +304,12 @@ DIAG_DDE_ENABLED=FALSE which can be downloaded at no cost from Microsoft and run as follows: - fciv -both HammerDB-4.3-Win-x86-64-Setup.exe + fciv -both HammerDB-4.4-Win-x86-64-Setup.exe and on Linux with md5sum and sha1sum as shown: - md5sum HammerDB-4.3-Linux.tar.gz -sha1sum HammerDB-4.3-Linux.tar.gz + md5sum HammerDB-4.4-Linux.tar.gz +sha1sum HammerDB-4.4-Linux.tar.gz
@@ -508,10 +507,10 @@ sha1sum HammerDB-4.3-Linux.tar.gz To install from the tar.gz run the command - tar -zxvf HammerDB-4.3.tar.gz + tar -zxvf HammerDB-4.4.tar.gz This will extract HammerDB into a directory named - HammerDB-4.3. + HammerDB-4.4.
@@ -558,8 +557,8 @@ sha1sum HammerDB-4.3-Linux.tar.gz and type librarycheck. - HammerDB CLI v4.3 -Copyright (C) 2003-2021 Steve Shaw + HammerDB CLI v4.4 +Copyright (C) 2003-2022 Steve Shaw Type "help" for a list of commands The xml is well-formed, applying configuration hammerdb>librarycheck @@ -581,8 +580,8 @@ hammerdb> librarycheck is also provided in the HammerDB Web Service. - HammerDB Web Service v4.3 -Copyright (C) 2003-2021 Steve Shaw + HammerDB Web Service v4.4 +Copyright (C) 2003-2022 Steve Shaw Type "help" for a list of commands The xml is well-formed, applying configuration Initialized SQLite on-disk database C:/Users/Steve/AppData/Local/Temp/hammer.DB using existing tables @@ -881,7 +880,7 @@ Driver=/opt/microsoft/msodbcsql/lib64/libmsodbcsql-17.0.so.1.1 UsageCount=1}}

MySQL - HammerDB version 4.3 (4.2/4.1/4.0 and version 3.3) has been + HammerDB version 4.4 (4.3/4.2/4.1/4.0 and version 3.3) has been built and tested against a MySQL 8.0 client installation, hammerDB version 3.0-3.2 has been built against MySQL 5.7. On Linux this means that HammerDB will require a MySQL client library called @@ -895,7 +894,7 @@ Driver=/opt/microsoft/msodbcsql/lib64/libmsodbcsql-17.0.so.1.1 UsageCount=1}}

MariaDB - HammerDB version 4.3 has been built and tested against MariaDB + HammerDB version 4.4 has been built and tested against MariaDB 10.5.10 client installation. On Linux this means that HammerDB will require a MariaDB client library called libmariadb.so.3. This client library needs to be referenced in the LD_LIBRARY_PATH as shown @@ -2205,18 +2204,22 @@ MariaDB [(none)]> EnterpriseDB produce an enhanced version of the PostgreSQL database termed Postgres Plus Advanced Server. This version of PostgreSQL in particular includes compatibility features with the Oracle database - such as PL/SQL support. For this reason the Hammer OLTP workload for - PostgreSQL can operate in 2 modes. Firstly Oracle compatible mode uses + such as PL/SQL support. Also Citus Data have produced a distributed + PostgreSQL extension. For this reason the Hammer OLTP workload for + PostgreSQL can operate in 3 modes. Firstly Oracle compatible mode uses PL/SQL and additional Postgres Plus Advanced Server features (such as DRITA snapshots) that will only operate against Enterprise DB Postgres - Plus Advanced Server. Secondly by not selecting Oracle compatibility - HammerDB can continue to operate against Postgres Plus Advanced Server - but additionally against a regular PostgreSQL build using native - PostgreSQL features. You must ensure before proceeding with OLTP that - you are aware of the version of PostgreSQL you have installed and the - features available, if you wish to test Oracle compatibility then you - must use Postgres Plus Advanced Server from EnterpriseDB and install - in Oracle compatible mode. + Plus Advanced Server. Secondly Citus compatible mode supports + distributed PostgreSQL with the Citus Data extension. Finally by not + selecting Citus or Oracle compatibility HammerDB can continue to + operate against a regular PostgreSQL build using native PostgreSQL + features. You must ensure before proceeding with OLTP that you are + aware of the version of PostgreSQL you have installed and the features + available, if you wish to test Oracle compatibility then you must use + Postgres Plus Advanced Server from EnterpriseDB and install in Oracle + compatible mode, if you wish to use Citus Data you must be running + against a Citus enabled installation either installed or in the cloud. + During the installation make a note of your postgres superuser password, you will need it for the test schema creation. You must be @@ -3226,6 +3229,13 @@ GO PostgreSQL stored procedures instead of functions. + + Citus Compatible + + Installs a schema into a PostgreSQL database with the + Citus Data Distributed PostgreSQL extension. + + Prefer PostgreSQL SSL Mode diff --git a/DocBook/docs/images/ch1-10.PNG b/DocBook/docs/images/ch1-10.PNG index 2873520d..ae461c9b 100644 Binary files a/DocBook/docs/images/ch1-10.PNG and b/DocBook/docs/images/ch1-10.PNG differ diff --git a/DocBook/docs/images/ch1-11.PNG b/DocBook/docs/images/ch1-11.PNG index 0db9a671..8bf44004 100644 Binary files a/DocBook/docs/images/ch1-11.PNG and b/DocBook/docs/images/ch1-11.PNG differ diff --git a/DocBook/docs/images/ch1-12.PNG b/DocBook/docs/images/ch1-12.PNG index 8521b5cd..0f89b7e5 100644 Binary files a/DocBook/docs/images/ch1-12.PNG and b/DocBook/docs/images/ch1-12.PNG differ diff --git a/DocBook/docs/images/ch1-4a.PNG b/DocBook/docs/images/ch1-4a.PNG index ddbba572..ff79193a 100644 Binary files a/DocBook/docs/images/ch1-4a.PNG and b/DocBook/docs/images/ch1-4a.PNG differ diff --git a/DocBook/docs/images/ch1-6.PNG b/DocBook/docs/images/ch1-6.PNG index 46f3d10c..698c60c0 100644 Binary files a/DocBook/docs/images/ch1-6.PNG and b/DocBook/docs/images/ch1-6.PNG differ diff --git a/DocBook/docs/images/ch1-8.PNG b/DocBook/docs/images/ch1-8.PNG index 8d70f80a..92d5c77f 100644 Binary files a/DocBook/docs/images/ch1-8.PNG and b/DocBook/docs/images/ch1-8.PNG differ diff --git a/DocBook/docs/images/ch1-9.PNG b/DocBook/docs/images/ch1-9.PNG index 95603cad..ef9d2f70 100644 Binary files a/DocBook/docs/images/ch1-9.PNG and b/DocBook/docs/images/ch1-9.PNG differ diff --git a/DocBook/docs/images/ch4-8.PNG b/DocBook/docs/images/ch4-8.PNG index 0e7bab05..00b2e25c 100644 Binary files a/DocBook/docs/images/ch4-8.PNG and b/DocBook/docs/images/ch4-8.PNG differ