Skip to content

Commit

Permalink
Merge pull request oracle#1101 from rosemarymarano/master
Browse files Browse the repository at this point in the history
edit and format README
  • Loading branch information
mriccell authored Jan 4, 2019
2 parents d6d5397 + 6c6431f commit 8b023c7
Showing 1 changed file with 9 additions and 7 deletions.
16 changes: 9 additions & 7 deletions OracleWebLogic/samples/12213-patch-wls-for-k8s/README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,32 @@
Example of Image with WLS Domain
================================
There are two Dockerfiles which extend the Oracle WebLogic binary image and apply a necessary patch for the WebLogic Kubernetes Operator 2.0.
There are two Dockerfiles which extend the Oracle WebLogic binary image and apply a necessary patch for the WebLogic Kubernetes Operator 2.0.

1)Dockerfile.patching-ontop-12213: applies two patches `p28076014` (on top of WLS 12.2.1.3) and `p27117282` (this patch is needed only if the WebLogic binary image is created manually from this Github project).
1.) `Dockerfile.patching-ontop-12213`: applies two patches `p28076014` (on top of WLS 12.2.1.3) and `p27117282` (this patch is needed only if the WebLogic binary image is created manually from this GitHub project).

2)Dockerfile.patching-ontop-12213-psu: applies patch `p28298734` (WLS PATCH SET UPDATE 12.2.1.3.181016), patch `p28076014` (on top of WLS 12.2.1.3 October PSU), and `p28186730` (Opatch update). Before applying the WebLogic 12.2.1.3 October PSU PATCH 12.2.1.3.181016WLSPSU, Opatch needs to be updated with PATCH 28186730: OPATCH 13.9.4.0.0 FOR FMW/WLS 12.2.1.3.
2.) `Dockerfile.patching-ontop-12213-psu`: applies patch `p28298734` (WLS PATCH SET UPDATE 12.2.1.3.181016), patch `p28076014` (on top of WLS 12.2.1.3 October PSU), and `p28186730` (Opatch update). Before applying the WebLogic 12.2.1.3 October PSU PATCH 12.2.1.3.181016WLSPSU, Opatch needs to be updated with PATCH 28186730: OPATCH 13.9.4.0.0 FOR FMW/WLS 12.2.1.3.

**Notes:** Historically, OPatch was updated by unzipping and replacing the `ORACLE_HOME/OPatch` directory. For versions greater than or equal to 13.6, now it uses the OUI installation tooling. This ensures that the installer both executes the file updates and logs the components and file changes to the OUI meta-data. A pure unzip install means the OUI tooling is not aware of these changes, which has on occasion, led to upgrade-related issues.
**Note**: Historically, OPatch was updated by unzipping and replacing the `ORACLE_HOME/OPatch` directory. For versions greater than or equal to 13.6, now it uses the OUI installation tooling. This ensures that the installer both executes the file updates and logs the components and file changes to the OUI meta-data. A pure unzip install means the OUI tooling is not aware of these changes, which has on occasion, led to upgrade-related issues.

We are applying patch `p28076014` which is required for the WebLogic Kubernetes Operator to work.

## How to build
First make sure you have built **oracle/weblogic:12.2.1.3-developer**.
If you want to patch on top of WebLogic Server 12.2.1.3 download:

file [p28076014_122130_Generic.zip](http://support.oracle.com) and place it in the same directory as this README.
file [p27117282_122130_Generic.zip](http://support.oracle.com) and place it in the same directory as this README.

If you want to patch on top of WebLogic Server 12.2.1.3 October PSU download:

file [p28186730_139400_Generic.zip](http://support.oracle.com) and place it in the same directory as this README.
file [p28298734_122130_Generic.zip](http://support.oracle.com) and place it in the same directory as this README.
file [p28076014_12213181016_Generic.zip](http://support.oracle.com) and place it in the same directory as this README.

To build, run:

$ docker build -t oracle/weblogic:12213-patch-wls-for-k8s -f Dockerfile.patching-ontop-12213 .
or
or
$ docker build -t oracle/weblogic:12213-patch-wls-for-k8s -f Dockerfile.patching-ontop-12213-psu .

## Verify that the patch has been applied correctly
Expand Down Expand Up @@ -64,7 +66,7 @@ You can override the default values of the following parameters during runtime w
* `ADMINISTRATION_PORT_ENABLED` (default: `true`)
* `ADMINISTRATION_PORT` (default: `9002`)

**NOTE**: For security, the Administration port 9002 is enabled by default. If you would like to disable the Administration port, set `ADMINISTRTATION_PORT_ENABLED` to false. If you intend to run these images in production, then you must change the Production Mode to `production`. To set the `DOMAIN_NAME`, you must set both `DOMAIN_NAME` and `DOMAIN_HOME`.
**NOTE**: For security, the Administration port 9002 is enabled by default. If you would like to disable the Administration port, set `ADMINISTRTATION_PORT_ENABLED` to `false`. If you intend to run these images in production, then you must change the Production Mode to `production`. To set the `DOMAIN_NAME`, you must set both `DOMAIN_NAME` and `DOMAIN_HOME`.

```
$docker run -d -p 7001:7001 -p 9002:9002 -v HOST PATH where the domain.properties file is :/u01/oracle/properties -e ADMINISTRATION_PORT_ENABLED=true -e DOMAIN_HOME=/u01/oracle/user_projects/domains/abc_domain -e DOMAIN_NAME=abc_domain oracle/weblogic:12213-opatch-update
Expand All @@ -77,7 +79,7 @@ Run the WLS Administration Console:
In your browser, enter `https://xxx.xx.x.x:9002/console`. Your browser will request that you accept the Security Exception. To avoid the Security Exception, you must update the WebLogic Server SSL configuration with a custom identity certificate.

## Samples for WebLogic multi-server domains and cluster
To give users an idea of how to create a WebLogic domain and cluster from a custom Dockerfile which extends the WebLogic Server install image, we provide a few samples for 12c versions of the developer distribution. For an example, look at the 12213-domain-home-in-image sample.
To give users an idea of how to create a WebLogic domain and cluster from a custom Dockerfile which extends the WebLogic Server install image, we provide a few samples for 12c versions of the developer distribution. For an example, look at the `12213-domain-home-in-image` sample.

# Copyright
Copyright (c) 2018 Oracle and/or its affiliates. All rights reserved.

0 comments on commit 8b023c7

Please sign in to comment.