Creating release 3.0.6

Author: bengsig

CHANGELOG.md

@@ -11,7 +11,7 @@
 * Various improvements for connectionpool
 * Double values are assigned to integer using trunc
 * Add statisticsonly attribue
-* Default branch is now named "development"
+* This will be the last 3.0 release
 
 ## 3.0.5
 

README.md

@@ -17,18 +17,21 @@ Release 3.0 includes these major new features:
  * Formatting of output using printf.
  * You can generate a single executable with an included rwl script.
  * New syntax for file open for read, append or pipe (added in 3.0.3)
+ * Release 3.0.6 will be the last 3.0 release, in 3.1 the new file open syntax will be enforced
 
 In addition, there are several minor update, 
 a number of bug fixes and updates to the standard oltp workload
 as shown in [CHANGELOG.md](CHANGELOG.md).
 
-Note that there is an update to the repository in 3.0.4 and that you _must_ apply
-the rwl304.sql script before using the new version.
+Note that there was an update to the repository in 3.0.4 and that you _must_ apply
+the rwl304.sql script if you are upgrading from version 3.0.3 or earlier.
+There is also a repository upgrade in 3.0.6 and you _must_ apply the rwl306.sql script
+before using release 3.0.6.
 See [docs/INSTALL.md](docs/INSTALL.md) for details.
 
 ## Branches
 
-The branches that should be used by ordinary users are named after the release, e.g. 3.0.3.
+The branches that should be used by ordinary users are named after the release, e.g. 3.0.6.
 The branch named "development" is getting frequent commits
 and may as such contain intermediate code.
 The master branch receives occasional pull request from the development branch.
@@ -37,7 +40,7 @@ unless you are developing the rwloadsim code or always want the latest.
 If you use the development or master branch, you _must_ do compilation yourself;
 no binaries are released.
 
-At present, branch 3.0.5 is the release branch.
+At present, branch 3.0.6 is the release branch.
 
 Please see [CHANGELOG.md](CHANGELOG.md) for details.
 

docs/INSTALL.md

@@ -8,7 +8,7 @@ There are three types of binary distributions available at github releases:
 
 ### Using complete binaries
 
-Complete binaries distributed in a file such rwloadsim-linux-x86_64-bin-3.0.5.tgz
+Complete binaries distributed in a file such rwloadsim-linux-x86_64-bin-3.0.6.tgz
 can be used as is, i.e. without getting a clone or pull from github.
 It should be used if you simply want a full run time environment
 and it contains the following directories:
@@ -27,7 +27,7 @@ and it contains the following directories:
 If you prefer to have access to source code, but avoid building the executables,
 you can clone or pull from github (which would allow you to potentially compile
 rwloadsim yourself), and then 
-use a file like rwloadsim-linux-x86_64-binonly-3.0.5.tgz.
+use a file like rwloadsim-linux-x86_64-binonly-3.0.6.tgz.
 This file contains little more than the compiled binaries of the rwloadsim program,
 and you can simply un-tar this file
 directly into your cloned or pulled directory; the result will be as if you had
@@ -46,7 +46,7 @@ On the system where you are going to run rwloadsim,
 create a (possibly shared) directory where you simply
 use a command like
 ```
-tar -zxvf rwloadsim-linux-x86_64-bin-3.0.5.tgz
+tar -zxvf rwloadsim-linux-x86_64-bin-3.0.6.tgz
 ```
 One install can be shared between several users as long as all have access to the directory.
 If appropriate, you can put the directory on an NFS (or some other) share and make it available to multiple systems.
@@ -65,7 +65,7 @@ You can use Oracle Instant Client or a full client (or even server) install.
 Start by doing a pull or clone of the sources from github 
 as if you would do your own compile, and then use a command like
 ```
-tar -zxvf rwloadsim-linux-x86_64-binonly-3.0.5.tgz
+tar -zxvf rwloadsim-linux-x86_64-binonly-3.0.6.tgz
 ```
 to extract little more than the compiled rwloadsim binaries into your already existing pull or clone.
 
@@ -156,6 +156,26 @@ If you are sharing the repository between many different users/projects, having
 the grants are set to only allow the needed access to the various repository tables.
 For most tables, this is insert and select.
 
+### Updating the repository to version 3.0.6
+
+In version 3.0.6, there are new columns added to
+the ashdata table, and any existing repository need to be updated
+to reflect this. 
+This update must be done _before_ you attept using the new
+rwloadsim executable,
+as you will otherwise get ORA- errors during execution of the oltpworkload.
+
+If you have an existing repository created earlier than version 3.0.6
+and you are upgrading to a version
+3.0.6 or later, you must execute the file rwl306.sql (which includes an
+update to the persec table) logged in using sqlplus to your primary
+repository schema.
+The rwl306.sql file is found in the admin directory of your distribution.
+
+The rwlviews.sql file is updated to reflect this change and you
+also need to execute this
+file against your repository and potentially secondary schema.
+
 ### Updating the repository to version 3.0.4
 
 In version 3.0.4, there are new columns added to

docs/NEWS30.md

@@ -14,6 +14,11 @@ end;
 ```
 will return sysdate from the database into the variable outdate.
 
+The $pre31fileassign:warn is now set implying any use of the old syntax
+for opening files will emit a warning.
+If you have not yet changed your code, you will need to do so before 
+the upcoming release 3.1, which will have $pre31fileassign:off in effect.
+
 ## Changed behavior in version 3.0.5 of the RWP\*Load Simulator
 
 The utility to create awr reports has been renamed to awrreport.

docs/ORACLENET.md

@@ -52,7 +52,7 @@ or ```rwlman nettest```.
 
 In addition to being part of the full rwloadsim distribution,
 the three utilities are distributed together with other as completely stand-alone
-executables in the file generated-linux-x86_64-bin-3.0.5.tgz.
+executables in the file generated-linux-x86_64-bin-3.0.6.tgz.
 It only contains the executable files, and they can be used without a complete installation
 of rwloadsim, as long as there is an Oracle client environment that can be an ordinary
 installation or an Instant Client installation.
@@ -63,7 +63,7 @@ with Instant Client it is the top directory of the installation.
 
 After download, simply execute
 ```
-tar -zxvf generated-linux-x86_64-bin-3.0.5.tgz
+tar -zxvf generated-linux-x86_64-bin-3.0.6.tgz
 ```
 and possibly move the executables to one of the directories in your PATH.
 To get help for either, call it with the -h option.

docs/refman/controlloop.html

@@ -13,6 +13,7 @@
  *
  * History
  *
+ * bengsig  19-jun-2023 - Release 3.0.6
  * bengsig  25-may-2023 - make rwlprogram known to tags/cscope
  * bengsig  15-may-2023 - statisticsonly
  * bengsig   1-may-2023 - $hostname: directive
@@ -1986,13 +1987,13 @@ extern const char rwlexecbanner[];
 
 #define RWL_VERSION_MAJOR 3
 #define RWL_VERSION_MINOR 0
-#define RWL_VERSION_RELEASE 5
+#define RWL_VERSION_RELEASE 6
 #if RWL_OCI_VERSION == 23
 // 23 is not yet ready
 # define RWL_VERSION_TEXT "Beta/Development" 
 # undef RWL_WORKAROUND_34952567 // remove when bug 34952567 is fixed
 #else
-# define RWL_VERSION_TEXT "Development" RWL_EXTRA_VERSION_TEXT
+# define RWL_VERSION_TEXT "Production" RWL_EXTRA_VERSION_TEXT
 #endif
 #define RWL_VERSION_DATE // undef to not include compile date 
 extern ub4 rwlpatch;