Skip to content

Installing generated stand alone binaries

Bjørn Engsig edited this page Dec 9, 2024 · 2 revisions

If your only interest is to execute some of the standard .rwl utilities such as ociping or awrdump, you can perform a very simple installation using a .tgz files with generated Stand Alone binaries. These only allow calling those specific utilities and do not allow you to run the complete rwloadsim and therefore not to create any rwl scripts yourself.

To install these stand alone binaries on Linux, follow these steps:

  • Download and install the latest Instant Client Basic Lite. The zip version is recommended rather than the rpm version.
  • Unzip the file somewhere and set both of LD_LIBRARY_PATH and PATH to include the directory that was unzipped. You need to set the two environment variables even if you decided to download and install the rpm version.
  • Download and install the latest stand alone distribution from github rwloadsim releases; the file will be called something like generated-linux-x86_64-bin-3.2.0.tgz.
  • Run tar -zxvf on the downloaded file. You can either do it into an existing directory that is in your PATH or in a new directory created for the purpose that you subsequently include in PATH.
  • If you have the ability to do so, you can very well put both instant client and the the stand alone binaries into directories that are shared to multiple systems e.g. via NFS.
  • An Oracle 19 (or newer) client environment and Oracle Linux 7 (or other distribution with glibc 2.14 or newer) is required. If you are using an older systems, use the file with a name like generated-11-linux-x86_64-bin-3.2.0.tgz, which only requires Oracle 11 and glibc 2.7. In that file, the executables are called ociping11 etc. as they are compiled and linked in an Oracle Client version 11.2.
  • Note that while the tgz (or zip on Windows) file contains a number of generated binaries, you can simply remove those you don't need, or you can copy those of your interest to other systems (that have the necessary Oracle Client).

On Microsoft Windows, you will similarly need to have an Oracle Instant Client environment release 19 or newer. See the Windows Installation wiki for details.