Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
101 changes: 88 additions & 13 deletions LICENSE.txt
Original file line number Diff line number Diff line change
@@ -1,13 +1,88 @@
Copyright (c) 2017, 2023 Oracle and/or its affiliates. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Oracle Free Use Terms and Conditions

Definitions

"Oracle" refers to Oracle America, Inc. "You" and "Your" refers to (a) a company or organization (each an "Entity")
accessing the Programs, if use of the Programs will be on behalf of such Entity; or (b) an individual accessing the
Programs, if use of the Programs will not be on behalf of an Entity. "Program(s)" refers to Oracle software provided
by Oracle pursuant to the following terms and any updates, error corrections, and/or Program Documentation provided
by Oracle. "Program Documentation" refers to Program user manuals and Program installation manuals, if any.
If available, Program Documentation may be delivered with the Programs and/or may be accessed from
www.oracle.com/documentation.
"Separate Terms" refers to separate license terms that are specified in the Program Documentation, readmes or notice
files and that apply to Separately Licensed Technology. "Separately Licensed Technology" refers to Oracle or third
party technology that is licensed under Separate Terms and not under the terms of this license.

Separately Licensed Technology

Oracle may provide certain notices to You in Program Documentation, readmes or notice files in connection with Oracle
or third party technology provided as or with the Programs. If specified in the Program Documentation, readmes or
notice files, such technology will be licensed to You under Separate Terms. Your rights to use Separately Licensed
Technology under Separate Terms are not restricted in any way by the terms herein. For clarity, notwithstanding
the existence of a notice, third party technology that is not Separately Licensed Technology shall be deemed part
of the Programs licensed to You under the terms of this license.

Source Code for Open Source Software

For software that You receive from Oracle in binary form that is licensed under an open source license that gives
You the right to receive the source code for that binary, You can obtain a copy of the applicable source code from
https://oss.oracle.com/sources/ or http://www.oracle.com/goto/opensourcecode. If the source code for such software
was not provided to You with the binary, You can also receive a copy of the source code on physical media by
submitting a written request pursuant to the instructions in the "Written Offer for Source Code" section of the
latter website.

-------------------------------------------------------------------------------

The following license terms apply to those Programs that are not provided to You under Separate Terms.

License Rights and Restrictions

Oracle grants to You, as a recipient of this Program, a nonexclusive, nontransferable, limited license to, subject
to the conditions stated herein, (a) internally use the unmodified Programs for the purposes of developing, testing,
prototyping and demonstrating your applications, and running the Programs for your own internal business operations;
and (b) redistribute unmodified Programs and Programs Documentation, under the terms of this License, provided that
You do not charge Your end users any additional fees for the use of the Programs. You may make copies of the Programs
to the extent reasonably necessary for exercising the license rights granted herein and for backup purposes. You are
granted the right to use the Programs to provide third party training in the use of the Programs and associated
Separately Licensed Technology only if there is express authorization of such use by Oracle on the Program's download
page or in the Program Documentation.

Your license is contingent on Your compliance with the following conditions:

- You include a copy of this license with any distribution by You of the Programs;

- You do not remove markings or notices of either Oracle's or a licensor's proprietary rights from the Programs or
Program Documentation;

- You comply with all U.S. and applicable export control and economic sanctions laws and regulations that govern
Your use of the Programs (including technical data);

- You do not cause or permit reverse engineering, disassembly or decompilation of the Programs (except as allowed by law)
by You nor allow an associated party to do so.

For clarity, any source code that may be included in the distribution with the Programs is provided solely for reference
purposes and may not be modified, unless such source code is under Separate Terms permitting modification.

Ownership

Oracle or its licensors retain all ownership and intellectual property rights to the Programs.

Information Collection

The Programs' installation and/or auto-update processes, if any, may transmit a limited amount of data to Oracle
or its service provider about those processes to help Oracle understand and optimize them. Oracle does not associate
the data with personally identifiable information. Refer to Oracle's Privacy Policy at www.oracle.com/privacy.

Disclaimer of Warranties; Limitation of Liability

THE PROGRAMS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. ORACLE FURTHER DISCLAIMS ALL WARRANTIES,
EXPRESS AND IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR
A PARTICULAR PURPOSE, OR NONINFRINGEMENT.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL ORACLE BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING
BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Last updated: 9 October 2018
91 changes: 88 additions & 3 deletions OTNLicense.txt
Original file line number Diff line number Diff line change
@@ -1,3 +1,88 @@
WARNING: THIS VIRTUAL MACHINE IMAGE CONTAINS ORACLE PROPRIETARY SOFTWARE THAT IS LICENSED TO THE INDIVIDUAL THAT ORIGINALLY OBTAINED IT FROM ORACLE. IT MAY NOT BE TRANSFERRED OR DISTRIBUTED TO OTHER INDIVIDUALS, EVEN IF THOSE INDIVIDUALS ARE EMPLOYED BY THE SAME ENTITY. IF YOU DID NOT OBTAIN THIS IMAGE FROM AN ORACLE WEBSITE OR FROM AN AUTHORIZED ORACLE EMPLOYEE OR CONTRACTOR, YOU MAY NOT USE IT; VISIT WWW.ORACLE.COM/OTN TO DOWNLOAD A COPY YOU MAY USE.

IF YOU RECEIVED THIS VIRTUAL MACHINE IMAGE DIRECTLY FROM ORACLE THEN BY CONTINUING TO INSTALL THE VIRTUAL MACHINE IMAGE YOU AGREE TO THE LICENSE TERMS AT http://www.oracle.com/technetwork/licenses/vm-license-2130072.html
Oracle Free Use Terms and Conditions

Definitions

"Oracle" refers to Oracle America, Inc. "You" and "Your" refers to (a) a company or organization (each an "Entity")
accessing the Programs, if use of the Programs will be on behalf of such Entity; or (b) an individual accessing the
Programs, if use of the Programs will not be on behalf of an Entity. "Program(s)" refers to Oracle software provided
by Oracle pursuant to the following terms and any updates, error corrections, and/or Program Documentation provided
by Oracle. "Program Documentation" refers to Program user manuals and Program installation manuals, if any.
If available, Program Documentation may be delivered with the Programs and/or may be accessed from
www.oracle.com/documentation.
"Separate Terms" refers to separate license terms that are specified in the Program Documentation, readmes or notice
files and that apply to Separately Licensed Technology. "Separately Licensed Technology" refers to Oracle or third
party technology that is licensed under Separate Terms and not under the terms of this license.

Separately Licensed Technology

Oracle may provide certain notices to You in Program Documentation, readmes or notice files in connection with Oracle
or third party technology provided as or with the Programs. If specified in the Program Documentation, readmes or
notice files, such technology will be licensed to You under Separate Terms. Your rights to use Separately Licensed
Technology under Separate Terms are not restricted in any way by the terms herein. For clarity, notwithstanding
the existence of a notice, third party technology that is not Separately Licensed Technology shall be deemed part
of the Programs licensed to You under the terms of this license.

Source Code for Open Source Software

For software that You receive from Oracle in binary form that is licensed under an open source license that gives
You the right to receive the source code for that binary, You can obtain a copy of the applicable source code from
https://oss.oracle.com/sources/ or http://www.oracle.com/goto/opensourcecode. If the source code for such software
was not provided to You with the binary, You can also receive a copy of the source code on physical media by
submitting a written request pursuant to the instructions in the "Written Offer for Source Code" section of the
latter website.

-------------------------------------------------------------------------------

The following license terms apply to those Programs that are not provided to You under Separate Terms.

License Rights and Restrictions

Oracle grants to You, as a recipient of this Program, a nonexclusive, nontransferable, limited license to, subject
to the conditions stated herein, (a) internally use the unmodified Programs for the purposes of developing, testing,
prototyping and demonstrating your applications, and running the Programs for your own internal business operations;
and (b) redistribute unmodified Programs and Programs Documentation, under the terms of this License, provided that
You do not charge Your end users any additional fees for the use of the Programs. You may make copies of the Programs
to the extent reasonably necessary for exercising the license rights granted herein and for backup purposes. You are
granted the right to use the Programs to provide third party training in the use of the Programs and associated
Separately Licensed Technology only if there is express authorization of such use by Oracle on the Program's download
page or in the Program Documentation.

Your license is contingent on Your compliance with the following conditions:

- You include a copy of this license with any distribution by You of the Programs;

- You do not remove markings or notices of either Oracle's or a licensor's proprietary rights from the Programs or
Program Documentation;

- You comply with all U.S. and applicable export control and economic sanctions laws and regulations that govern
Your use of the Programs (including technical data);

- You do not cause or permit reverse engineering, disassembly or decompilation of the Programs (except as allowed by law)
by You nor allow an associated party to do so.

For clarity, any source code that may be included in the distribution with the Programs is provided solely for reference
purposes and may not be modified, unless such source code is under Separate Terms permitting modification.

Ownership

Oracle or its licensors retain all ownership and intellectual property rights to the Programs.

Information Collection

The Programs' installation and/or auto-update processes, if any, may transmit a limited amount of data to Oracle
or its service provider about those processes to help Oracle understand and optimize them. Oracle does not associate
the data with personally identifiable information. Refer to Oracle's Privacy Policy at www.oracle.com/privacy.

Disclaimer of Warranties; Limitation of Liability

THE PROGRAMS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. ORACLE FURTHER DISCLAIMS ALL WARRANTIES,
EXPRESS AND IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR
A PARTICULAR PURPOSE, OR NONINFRINGEMENT.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL ORACLE BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING
BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Last updated: 9 October 2018
92 changes: 23 additions & 69 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
Oracle Developer Day VM Builder
===============================

Welcome to the packer build for the Oracle Developer Day vm.
This will build a Oracle Linux server and install a 18.3 Oracle database on the machine. Follow the download instructions to download the software to install and follow the build instructions to build the machine. You will need around 30gb of space free to store the downloads and run the build.
Welcome to the packer build for the Oracle AI Database 26ai Free Developer vm.
This will build a Oracle Linux server and install a 26ai Free Oracle AI database on the machine. Follow the download instructions to download the software to install and follow the build instructions to build the machine. You will need around 30GB of space free to store the downloads and run the build.

There are several directories which are used in the build

Expand All @@ -14,96 +14,50 @@ Mandatory Downloads
-------------------
**These two downloads are mandatory**. If they are not here, the build will not start.

* OracleLinux-R7-U3-Server-x86_64-dvd.iso (needs to be this exactly md5 checked)
* LINUX.X64_180000_db_home.zip (183 has been verified - silent install may be incompatible with later versions)
* OracleLinux-R8-U10-x86_64-dvd.iso (needs to be this exactly md5 checked)
* oracle-ai-database-free-26ai-23.26.0-1.el8.x86_64.rpm - available from https://www.oracle.com/database/technologies/free-downloads.html
* oracle-ai-database-preinstall-26ai-1.0-1.el8.x86_64.rpm - available from https://yum.oracle.com/repo/OracleLinux/OL8/appstream/x86_64/

Optional Downloads
--------------
If these files are available in the **put_files_here** directory, the build will try and install them.

* jdk-8u\*-linux-x64.tar.gz - **Oracle JDK**
* sqldeveloper-\*-no-jre.zip - **Oracle SQL Developer**
* datamodeler-\*-no-jre.zip **Oracle SQLDeveloper Data Modeler**
* jdk-21\*_linux-x64\*.tar.gz - **Oracle JDK**
* sqlcl-\*.zip - **Oracle SQLcl**
* apex\_\*.zip - **Oracle Application Express**
* ords\*.zip - **Oracle REST Data Services**
* apex_\*.zip - **Oracle Application Express**
* ords-\*.zip - **Oracle REST Data Services**

Oracle Internal Files
---------------------
These files may not be available publicly

* demos.zip - **Oracle Hands on Labs demos**
* reset_xmldbjson ** Reset XMLdb demos**
* master.zip - **Oracle Sample Schema**
* mozillablob.zip - **firefox .mozilla for (json viewer) plugins and or bookmarks**
* storm.zip - **exp dump of non sensative material. For geo location optional demo.**

Build Instructions
------------------

>**bash start.sh "http://and_proxy_as_first_arg_if_wanted" export**

NOTE Proxy value will be in the logs from bash set -x stored in ~oracle/log
NOTE: Proxy value will be in the logs from bash set -x stored in ~oracle/log
If you are inside a VPN, the proxy settings allow the VM to contact yum
update servers. optional export to export the ova.

![packer build](images/packerbuild.png)
NOTE: The Oracle AI Database 26ai Free Developer vm has been created using VirtualBox 6.

Build Structure
--------------------

1. 1updateLinux.sh PROGRESS: 1/4 1updateLinux.sh - first script run - from plain iso. Set up second drive. Yum Updates. Reboot
2. 2afterFirstReboot.sh PROGRESS: 2/4 2afterFirstReboot.sh - after first reboot - before any oracle database software installed. install virtual box guest additions.
3. 3topLevel.sh PROGRESS: 3/4 3topLevel.sh - main kick off script e.g. yum and call subscripts
4. 3_1installDbtoolClientTools.sh PROGRESS: 3_1/4 3_1installDbtoolClientTools.sh - install dbtools client tools
5. 3_2installDatabase.sh PROGRESS: 3_2/4 3_2installDatabase.sh - install the database with silent install
6. 3_3passwordDoNotExpire.sh PROGRESS: 3_3/4 3_3passwordDoNotExpire.sh - Database post install updates - e.g. passwords do not expire.
7. 3_4enableGeoRaster.sh PROGRESS: 3_4/4 3_4enableGeoRaster.sh - post database install and patches (if required)
8. 3_5unzipLabDemos.sh PROGRESS: 3_5/4 3_5unzipLabDemos.sh - demos (labs)
9. 3_6apexInstall.sh PROGRESS: 3_6/4 3_6apexInstall.sh - apex install
10. 3_7ORDSInstall.sh PROGRESS: 3_7/4 3_7ORDSInstall.sh - ords install
11. 3_8setupDemos.sh PROGRESS: 3_8/4 3_8setupDemos.sh - set up demos and run reset scripts
12. PROGRESS: END OF SCRIPT: 4/4 for tracing information see local file log.zip
1. 1updateLinux.sh PROGRESS: 1/4 1updateLinux.sh - first script run - from plain iso. Set up second drive.
2. 2afterFirstReboot.sh PROGRESS: 2/4 2afterFirstReboot.sh - after first reboot - before any oracle database software installed. (install virtual box guest additions).
3. 3topLevel.sh PROGRESS: 3/4 3topLevel.sh - main kick off script i.e. yum and call subscripts.
4. 3_1installDbtoolClientTools.sh PROGRESS: 3_1/4 3_1installDbtoolClientTools.sh - install dbtool client tools.
5. Install database rpms happens here - log file - 3_0oracleinstall.log in log.zip.
6. 3_3passwordDoNotExpire.sh PROGRESS: 3_3/4 3_3passwordDoNotExpire.sh - minor helper - e.g. passwords do not expire.
7. 3_7ORDSInstall PROGRESS: 3_7ORDSInstall - ORDS and APEX install.
8. END OF SCRIPT PROGRESS: END OF SCRIPT: 4/4 for tracing information see local file log.zip.

Timings:

Minimum (Oracle Linux + Oracle Database)
Total time 60 mins (accounted for time + 7 mins rounding error / ignore <2 minute).

boot,8
yum update,14
reboot ,3
run database software install (not database build),3
dbca (database build),7
password and 32kvarchar2,6
shrink (fill disk with 0 for easy compression),3
1 x 3 minute reboot + shutdown + minor <1 minute stuff,10

Maximum (Including all optional extras APEX/ORDS/((internal) demos)
Total time 113.5 mins (Accounted for time + 10.5 mins rounding error / ignore <2 minute).
boot,9
yum update,14
reboot,3
run database software install (not database build),4
dbca (database build),8
password and 32kvarchar <should be same as minimum?>,18
apex install ,16
ords install ,4
set up demos and run demo reset,18
shrink (fill disk with 0 for easy compression),2
1 x 3 minute reboot + shutdown + minor <1 minute stuff - this is too long,9
Minimum (Oracle Linux + Oracle AI Database)
Total time ~60 mins.

Maximum (Including all optional extras APEX/ORDS)
Total time ~113.5 mins.

Removing the shrink.sh if not exporting - fills disk with 0 for easy compression.
Run shrink.sh over ssh if subsequently exporting to ova (brings ova file down 60% in size to under 8Gb)

## Contributing

This project is not accepting external contributions at this time. For bugs or enhancement requests, please file a GitHub issue unless it’s security related. When filing a bug remember that the better written the bug is, the more likely it is to be fixed. If you think you’ve found a security vulnerability, do not raise a GitHub issue and follow the instructions in our [security policy](./SECURITY.md).

## Security

Please consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process

## License

Copyright (c) 2017, 2023 Oracle and/or its affiliates.
Loading