Skip to content

Commit c2cce0b

Browse files
rjeberhardrjeberhard
committed
Update documentation
1 parent 79d1bd4 commit c2cce0b

File tree

6 files changed

+220
-56
lines changed

6 files changed

+220
-56
lines changed

‎documentation/3.3/content/_index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ using the operator to deploy and run a WebLogic domain container-packaged web ap
3131
#### Current production release
3232

3333
The [current release of the operator](https://github.com/oracle/weblogic-kubernetes-operator/releases) is {{< latestVersion >}}.
34-
This release was published on November 1, 2021. See the [operator prerequisites]({{< relref "/userguide/prerequisites/introduction.md" >}}) and [supported environments]({{< relref "/userguide/platforms/environments.md" >}}).
34+
This release was published on November 9, 2021. See the [operator prerequisites]({{< relref "/userguide/prerequisites/introduction.md" >}}) and [supported environments]({{< relref "/userguide/platforms/environments.md" >}}).
3535

3636
***
3737

@@ -63,3 +63,4 @@ See [Get help]({{< relref "userguide/introduction/get-help.md" >}}).
6363
* [WebLogic Monitoring Exporter](https://github.com/oracle/weblogic-monitoring-exporter)
6464
* [WebLogic Logging Exporter](https://github.com/oracle/weblogic-logging-exporter)
6565
* [WebLogic Remote Console](https://github.com/oracle/weblogic-remote-console)
66+
* [WebLogic Kubernetes Toolkit UI](https://oracle.github.io/weblogic-toolkit-ui/)

‎documentation/3.3/content/samples/azure-kubernetes-service/_index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,12 @@ description: "Sample for using the operator to set up a WLS cluster on the Azure
2020

2121
This sample demonstrates how to use the [WebLogic Kubernetes Operator]({{< relref "/_index.md" >}}) (hereafter "the operator") to set up a WebLogic Server (WLS) cluster on the Azure Kubernetes Service (AKS). After going through the steps, your WLS domain runs on an AKS cluster. You have several options for managing the cluster, depending on which [domain home source type]({{< relref "/userguide/managing-domains/choosing-a-model/_index.md" >}}) you choose. With Domain in PV, you can manage your WLS domain by accessing the WebLogic Server Administration Console or WLST. With Model in Image, you use the operator to perform WLS administrative operations.
2222

23+
**Note:** For an alternative approach to this sample,
24+
see the [Oracle WebLogic Server on AKS from the Azure Marketplace]({{<relref "/userguide/aks/_index.md">}})
25+
offering which automates the provisioning of
26+
AKS cluster, AKS resources, the Azure Container Registry (ACR),
27+
WebLogic Kubernetes Operator, and WebLogic Server images.
28+
2329
#### Azure Kubernetes Service cluster
2430

2531
{{< readfile file="/samples/azure-kubernetes-service/includes/aks-value-prop.txt" >}}

‎documentation/3.3/content/userguide/platforms/environments.md

Lines changed: 102 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -8,51 +8,103 @@ weight: 4
88
### Contents
99

1010
- [Supported environments](#supported-environments)
11-
- [Kubernetes, WebLogic, and operating system prerequisites](#kubernetes-weblogic-and-operating-system-prerequisites)
11+
- [Kubernetes, WebLogic Server, and operating system prerequisites](#kubernetes-weblogic-server-and-operating-system-prerequisites)
1212
- [Pricing and licensing](#pricing-and-licensing)
13+
- [WebLogic Kubernetes Operator](#weblogic-kubernetes-operator)
14+
- [WebLogic Server](#weblogic-server)
15+
- [Oracle Linux and WebLogic Server Images](#oracle-linux-and-weblogic-server-images)
16+
- [Reference](#reference)
1317
- [Important notes about specific environments](#important-notes-about-specific-environments)
1418
- [Oracle Cloud Infrastructure (OCI)](#oracle-cloud-infrastructure-oci)
1519
- [Oracle Linux Cloud Native Environment (OLCNE)](#oracle-linux-cloud-native-environment-olcne)
1620
- [Oracle Private Cloud Appliance (PCA) and Oracle Private Cloud at Customer (OPCC)](#oracle-private-cloud-appliance-pca-and-oracle-private-cloud-at-customer-opcc)
17-
- [Microsoft Azure Kubernetes Service (AKS)](#microsoft-azure-kubernetes-service-aks)
21+
- [Microsoft Azure](#microsoft-azure)
1822
- [VMware Tanzu Kubernetes Grid (TKG)](#vmware-tanzu-kubernetes-grid-tkg)
1923
- [OpenShift](#openshift)
2024
- [Development-focused Kubernetes distributions](#development-focused-kubernetes-distributions)
2125

2226
### Supported environments
2327

24-
WebLogic Server and the operator are supported on
25-
Oracle cloud environments such as
26-
Oracle Cloud Infrastructure (OCI),
27-
Oracle Linux Cloud Native Environment (OLCNE),
28-
Oracle Private Cloud Appliance (PCA),
29-
or Oracle Private Cloud at Customer (OPCC),
30-
and on "Authorized Cloud Environments" as defined in
31-
[this Oracle licensing policy](https://www.oracle.com/assets/cloud-licensing-070579.pdf)
32-
for [this list of eligible products](http://www.oracle.com/us/corporate/pricing/authorized-cloud-environments-3493562.pdf).
28+
WebLogic Server and the operator are supported on Oracle Cloud offerings, such as:
29+
- Oracle Cloud Infrastructure (OCI)
30+
- Oracle Container Engine for Kubernetes (OKE)
31+
- Oracle Linux Cloud Native Environment (OLCNE)
32+
- Oracle Private Cloud Appliance (PCA)
33+
- Oracle Private Cloud at Customer (OPCC)
3334

34-
The official document that defines the supported configurations
35-
is [here](https://www.oracle.com/middleware/technologies/ias/oracleas-supported-virtualization.html)
36-
(search for keyword 'Kubernetes').
35+
WebLogic Server and the operator are certified on offerings, such as:
36+
- Amazon Elastic Compute Cloud (EC2)
37+
- Microsoft Azure Platform
38+
- Microsoft Azure Kubernetes Service (AKS)
39+
- OpenShift Container Platform
40+
- VMWare Tanzu
41+
- VMware Tanzu Kubernetes Grid (TKG)
42+
43+
WebLogic Server and the operator are also supported on service offerings which
44+
deploy the WebLogic Server and the operator for you. These include:
45+
- Oracle WebLogic Server for OKE (WLS for OKE)
46+
- Oracle WebLogic Server on AKS from the Azure Marketplace (WLS on AKS Marketplace)
47+
48+
[Development-focused Kubernetes distributions](#development-focused-kubernetes-distributions) are also supported.
49+
50+
For detailed virtualization and cloud licensing descriptions, see:
51+
- [Supported Virtualization Technologies for Oracle Fusion Middleware](https://www.oracle.com/middleware/technologies/ias/oracleas-supported-virtualization.html) (search for keyword 'Kubernetes')
52+
- [Running and Licensing Oracle Programs in Containers and Kubernetes](https://www.oracle.com/a/tech/docs/running-and-licensing-programs-in-containers-and-kubernetes.pdf)
3753

3854
Some supported environments have additional help or samples that are specific
3955
to the operator, or are subject to limitations and restrictions: see
4056
[Important notes about specific environments](#important-notes-about-specific-environments).
4157

42-
### Kubernetes, WebLogic, and operating system prerequisites
58+
### Kubernetes, WebLogic Server, and operating system prerequisites
4359

44-
The operator is subject to Kubernetes, WebLogic, and operating system versioning prerequisites:
60+
The operator is subject to Kubernetes, WebLogic Server, and operating system versioning prerequisites:
4561
see [Operator prerequisites]({{< relref "/userguide/prerequisites/introduction.md" >}}).
4662

4763
### Pricing and licensing
4864

65+
The WebLogic Kubernetes Operator and Oracle Linux are open source and free;
66+
WebLogic Server requires licenses unless used in a single developer desktop development environment.
67+
In detail:
68+
69+
#### WebLogic Kubernetes Operator
70+
4971
The WebLogic Kubernetes Operator (the "operator") is open source and free,
5072
licensed under the Universal Permissive license (UPL), Version 1.0.
73+
For support details, see [Get help]({{< relref "userguide/introduction/get-help.md" >}}).
74+
75+
#### WebLogic Server
5176

5277
WebLogic Server is not open source.
5378
Licensing is required for each running WebLogic Server instance in Kubernetes,
5479
just as with any deployment of WebLogic Server.
5580
Licensing is free for a single developer desktop development environment.
81+
For more information, see the [Fusion Middleware Licensing Information User Manual - Application Server Products](https://docs.oracle.com/en/middleware/fusion-middleware/fmwlc/application-server-products-new-structure.html).
82+
83+
#### Oracle Linux and WebLogic Server images
84+
85+
Oracle Linux is under open source license
86+
and is completely free to download and use.
87+
88+
In addition, with WebLogic Server licenses and support,
89+
customers have access to:
90+
- The latest WebLogic Server images
91+
which bundle Java SE and the latest slim Oracle Linux images.
92+
- Oracle Linux support.
93+
Note that WebLogic Server licenses and support do not include customer entitlements
94+
for direct access to Oracle Linux support or Unbreakable Linux Network
95+
(to access the standalone Oracle Linux patches).
96+
97+
Oracle supplies two types of WebLogic Server images, patched (CPU) and unpatched.
98+
New WebLogic Server images are released when security fixes
99+
are released for Oracle Linux, WebLogic Server, or Java. In addition,
100+
patched images are rebuilt every CPU cycle, which is quarterly.
101+
Customer support for WebLogic Server images is handled by Oracle support.
102+
103+
Using the [WebLogic Image Tool](https://github.com/oracle/weblogic-image-tool)
104+
customers can also build their own WebLogic Server images with
105+
the latest Oracle Linux images, Java updates, and WebLogic Server patches.
106+
107+
#### Reference
56108

57109
The Oracle [Global Pricing and Licensing site](https://www.oracle.com/corporate/pricing/specialty-topics.html)
58110
provides details about licensing practices and policies.
@@ -103,11 +155,18 @@ Oracle Exalogic Elastic Cloud systems can be migrated to this infrastructure wit
103155
changes, enabling you to preserve your application investment as you adopt modern cloud
104156
native infrastructure.
105157

106-
#### Microsoft Azure Kubernetes Service (AKS)
158+
#### Microsoft Azure
159+
160+
There are three different approaches for deploying the operator to Microsoft Azure:
161+
- Microsoft Azure Platform
162+
- Microsoft Azure Kubernetes Service (AKS)
163+
- Oracle WebLogic Server on AKS from the Azure Marketplace (WLS on AKS Marketplace)
164+
165+
##### Microsoft Azure Kubernetes Service (AKS)
107166

108167
[Azure Kubernetes Service (AKS)](https://docs.microsoft.com/en-us/azure/aks/) is a hosted Kubernetes environment. The WebLogic Kubernetes
109-
Operator, Oracle WebLogic Sever 12c, and Oracle Fusion Middleware Infrastructure 12c are fully supported and certified on Azure Kubernetes Service (as per the documents
110-
referenced in [Supported environments](#supported-environments)).
168+
Operator, Oracle WebLogic Server 12c, and Oracle Fusion Middleware Infrastructure 12c are fully supported and certified on Azure Kubernetes Service (as per the documents
169+
referenced in [Supported environments](#supported-environments)). In this environment, it is the customer's responsibility to install the operator and supply WebLogic Server images.
111170

112171
AKS support and limitations:
113172

@@ -121,10 +180,26 @@ AKS support and limitations:
121180

122181
See also the [Azure Kubernetes Service sample]({{<relref "/samples/azure-kubernetes-service/_index.md">}}).
123182

183+
##### Oracle WebLogic Server on AKS from the Azure Marketplace (WLS on AKS Marketplace)
184+
185+
The WebLogic Server on AKS Azure Marketplace
186+
offer lets you embrace cloud computing by providing greater choice
187+
and flexibility for deploying your WLS domains and applications.
188+
The offer leverages the WebLogic Kubernetes Toolkit to automate
189+
the provisioning of WebLogic Server and Azure resources so that you can easily move WLS workloads to AKS.
190+
The automatically provisioned resources include an AKS cluster,
191+
the WebLogic Kubernetes Operator, WebLogic Server images, and the Azure Container Registry (ACR).
192+
It is possible to use an existing AKS cluster or ACR instance with the offer if desired.
193+
The offer also supports configuring load balancing with Azure App Gateway or the Azure Load Balancer,
194+
DNS configuration, SSL/TLS configuration, easing database connectivity,
195+
publishing metrics to Azure Monitor as well as mounting Azure Files as Kubernetes Persistent Volumes.
196+
197+
For details, see [WebLogic Server on AKS Marketplace]({{<relref "/userguide/aks/_index.md">}}).
198+
124199
#### VMware Tanzu Kubernetes Grid (TKG)
125200

126-
Tanzu Kubernetes Grid (TKG) is a managed Kubernetes Service that lets you quickly deploy and manage Kubernetes clusters. The WebLogic Kubernetes
127-
Operator and Oracle WebLogic Sever are fully supported and certified on VMware Tanzu Kubernetes Grid Multicloud 1.1.3 (with vSphere 6.7U3).
201+
Tanzu Kubernetes Grid (TKG) is a managed Kubernetes Service that lets you quickly deploy and manage Kubernetes clusters.
202+
The WebLogic Kubernetes Operator and Oracle WebLogic Server are fully supported and certified on VMware Tanzu Kubernetes Grid Multicloud 1.1.3 (with vSphere 6.7U3).
128203

129204
TKG support and limitations:
130205

@@ -144,7 +219,7 @@ Operator 2.0.1+ is certified for use on OpenShift Container Platform 3.11.43+, w
144219
Operator 2.5.0+ is certified for use on OpenShift Container Platform 4.3.0+ with Kubernetes 1.16.2+.
145220

146221
To accommodate OpenShift security requirements:
147-
- For security requirements to run WebLogic in OpenShift, see the [OpenShift chapter]({{<relref "/security/openshift.md">}}) in the Security section.
222+
- For security requirements to run WebLogic Server in OpenShift, see the [OpenShift chapter]({{<relref "/security/openshift.md">}}) in the Security section.
148223
- Beginning with operator version 3.3.2, specify the `kubernetesPlatorm` Helm chart property with value `OpenShift`. For more information, see [Operator Helm configuration values]({{<relref "/userguide/managing-operators/using-helm#operator-helm-configuration-values">}}).
149224

150225
#### Development-focused Kubernetes distributions
@@ -154,12 +229,12 @@ Often these run Kubernetes in a virtual machine on your development machine. We
154229
present some extra challenges in areas like:
155230

156231
* Separate container image caches, making it necessary to save/load images to move them between Docker file systems
157-
* Default virtual machine file sizes and resource limits that are too small to run WebLogic or hold the necessary images
158-
* Storage providers that do not always support the features that the operator or WebLogic rely on
159-
* Load balancing implementations that do not always support the features that the operator or WebLogic rely on
232+
* Default virtual machine file sizes and resource limits that are too small to run WebLogic Server or hold the necessary images
233+
* Storage providers that do not always support the features that the operator or WebLogic Server rely on
234+
* Load balancing implementations that do not always support the features that the operator or WebLogic Server rely on
160235

161-
As such, we *do not* recommend using these distributions to run the operator or WebLogic, and we do not
162-
provide support for WebLogic or the operator running in these distributions.
236+
As such, we *do not* recommend using these distributions to run the operator or WebLogic Server, and we do not
237+
provide support for WebLogic Server or the operator running in these distributions.
163238

164239
We have found that Docker for Desktop does not seem to suffer the same limitations, and we do support that as a
165240
development/test option.

‎documentation/staging/content/_index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ using the operator to deploy and run a WebLogic domain container-packaged web ap
3131
#### Current production release
3232

3333
The [current release of the operator](https://github.com/oracle/weblogic-kubernetes-operator/releases) is {{< latestVersion >}}.
34-
This release was published on November 1, 2021. See the [operator prerequisites]({{< relref "/userguide/prerequisites/introduction.md" >}}) and [supported environments]({{< relref "/userguide/platforms/environments.md" >}}).
34+
This release was published on November 9, 2021. See the [operator prerequisites]({{< relref "/userguide/prerequisites/introduction.md" >}}) and [supported environments]({{< relref "/userguide/platforms/environments.md" >}}).
3535

3636
***
3737

@@ -63,3 +63,4 @@ See [Get help]({{< relref "userguide/introduction/get-help.md" >}}).
6363
* [WebLogic Monitoring Exporter](https://github.com/oracle/weblogic-monitoring-exporter)
6464
* [WebLogic Logging Exporter](https://github.com/oracle/weblogic-logging-exporter)
6565
* [WebLogic Remote Console](https://github.com/oracle/weblogic-remote-console)
66+
* [WebLogic Kubernetes Toolkit UI](https://oracle.github.io/weblogic-toolkit-ui/)

‎documentation/staging/content/samples/azure-kubernetes-service/_index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,12 @@ description: "Sample for using the operator to set up a WLS cluster on the Azure
2020

2121
This sample demonstrates how to use the [WebLogic Kubernetes Operator]({{< relref "/_index.md" >}}) (hereafter "the operator") to set up a WebLogic Server (WLS) cluster on the Azure Kubernetes Service (AKS). After going through the steps, your WLS domain runs on an AKS cluster. You have several options for managing the cluster, depending on which [domain home source type]({{< relref "/userguide/managing-domains/choosing-a-model/_index.md" >}}) you choose. With Domain in PV, you can manage your WLS domain by accessing the WebLogic Server Administration Console or WLST. With Model in Image, you use the operator to perform WLS administrative operations.
2222

23+
**Note:** For an alternative approach to this sample,
24+
see the [Oracle WebLogic Server on AKS from the Azure Marketplace]({{<relref "/userguide/aks/_index.md">}})
25+
offering which automates the provisioning of
26+
AKS cluster, AKS resources, the Azure Container Registry (ACR),
27+
WebLogic Kubernetes Operator, and WebLogic Server images.
28+
2329
#### Azure Kubernetes Service cluster
2430

2531
{{< readfile file="/samples/azure-kubernetes-service/includes/aks-value-prop.txt" >}}

0 commit comments

Comments
 (0)