Repository files navigation

For background information on this repository, please read thisblog post.

• Installed the following:
  • Git
  • Curl
  • Docker (of course)

IMPORTANT

Build and execution has been tested in Linux only. It should work in Mac OS and Windows with Windows Subsystem for Linux 2.

1. Git clone this repository and set it as the working directory.
2. Download the installer files:
   • The required Oracle Database installation files fromOTN (supports versions up to 21.3.0 including Express Edition, as of September 22, 2021).Note: ForOracle Database 21c XE, you are no longer required to download the binaries (see issue #39).
   • Oracle Application Express (supports versions up 22.2 as of January 01, 2023)
   • Oracle REST Data Services (supports versions up to 23.1 as of April 01, 2023)
3. For releases after0.6.0, either choose to use the binaries fromOpenJDK, download a licensed Java runtime, or thefree to use Java 17 from Oracle. Please refer to the additonal notes sectionbelow for details about theINSTALL_FILE_JAVA parameter.
4. Place all installer files in the sub-directoryfiles.
5. Create a file that contains the required environment variables for your build. Please refer to the additonal notesbelow for more information about the various parameters that can be set. Included in this repository are two examples or templates that you can use:
   • settings.env.sample.
   • settings_db19c.env.sample.
6. Run the first script to grab the latest Dockerimages from Oracle and build the Oracle Database image. The script takes one parameter, the environment filename (mysettings.env):

   $ bash 01-build.sh mysettings.env

7. Run the final script to create and run the container, where the container name isdas:

   $ bash 02-run.sh das mysettings.env

Martinsuggested, so here it is! Now included is the thequickstart.sh script. Simply:

1. Execute the script.
2. Enter your email address for the APEX instance administrator.
3. Optionally, enter a preferred container name.
4. If all's good, note down your container name and password.
5. EnterY to continue.
6. Wait till there is minimal or no activity in the script then go tohttp://localhost:8080/ords/apex.

If you are new to APEX, then I highly recommend checking out some of the learning resourceshere.

$ ./quickstart.shEnter an email address for your APEX administrator (required): apexdev@example.comContainer name (leave empty to have one generated for you): apexiscool##### Important Information #####Your Docker container name is: apexiscoolYour password for the database and APEX internal workspace is: donotcommitWe are now ready to build the Docker image and deploy your container.Type "Y" to continue or CTRL-C to exit: y

Note

Should you forget to save your password, you can find it in the generated settings file along with any other details about the container. It is named after your container, e.g.apexiscool.env.

• Specify the Docker network to attach to using the parameterDOCKER_NETWORK_NAME. The run script will check if the network exists, and if not, create it.
• The parameterRTU_ENABLED has been introduced.It is experimental and may not work. It allows users to create containers that can be used to create an image from using Dockercommit. Set the value to "Y" if this ability is required.
• Use theFILES_DIR parameter to specify the local path to all the required installation files, e.g./path/to/my/downloads.
• Set the value ofALLOW_DB_PATCHING toY to preserve files needed to successfully patch the database software withOPatch.
• As of December 5, 2019, Oracle Machine Learning (previously known as Oracle Advanced Analytics) option is now included with all editions of Oracle Database 12c R2 and later, including 18c Express Edition (XE). Use theOML4R_SUPPORT parameter to install database support for running embedded R scripts. At the moment, this option is only valid for 18c or later.
• SQL Developer Web is now availablel with ORDS version 19.4. This feature is enabled by default. To turn it off, set the environment variableSQLDEVWEB toN. The REST-enabled SQL feature can be managed by the variableREST_ENABLED_SQL, but note that this value is ignored if SQL Developer Web is activated. For builds with earlier ORDS versions, the added configuration properties are safely ignored.
• DATABASEAPI parameter added to enable Database API support for ORDS 19.x and later.
• The variableINSTALL_FILE_JAVA accepts the following values:
  • java17 (default)
  • openjdk11
  • The filename of Java runtime tarball that you can download fromhere.
• Using the sample settings, the following are accessible:

  Port	Application	URL
  8080	APEX	http://localhost:8080
  1521	Database	N/A