Skip to content

Commit

Permalink
Creating release 3.0.6
Browse files Browse the repository at this point in the history
  • Loading branch information
bengsig committed Jun 19, 2023
1 parent ccc9080 commit 8f02fe1
Show file tree
Hide file tree
Showing 9 changed files with 45 additions and 16 deletions.
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
11 changes: 7 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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.

Expand Down
28 changes: 24 additions & 4 deletions docs/INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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
Expand All @@ -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.
Expand All @@ -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.

Expand Down Expand Up @@ -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
Expand Down
5 changes: 5 additions & 0 deletions docs/NEWS30.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
4 changes: 2 additions & 2 deletions docs/ORACLENET.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion docs/refman/controlloop.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion docs/refman/oltpsetup.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion docs/refman/proceduredeclaration.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 3 additions & 2 deletions src/rwl.h
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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;
Expand Down

0 comments on commit 8f02fe1

Please sign in to comment.