Create a JRF-Enabled Domain
Use Oracle WebLogic Server for OKE to create a stack that includes an Oracle WebLogic Server domain with the Java Required Files (JRF) components, network resources, Kubernetes cluster, compute instances, and load balancers.
Creating a JRF-enabled domain is similar to creating a basic domain; however, a database in Oracle Cloud Infrastructure is required. You can specify a database in Oracle Autonomous Database or Oracle Cloud Infrastructure Database (DB System). If you plan to use a DB System database, note that the DB System and the Oracle WebLogic Server for OKE compute instances must be in the same virtual cloud network (VCN).
Before you create a JRF-enabled domain, you must first perform the following tasks:
- Create an autonomous database or DB System database. See Create a Database.
- Identify the pluggable database (PDB) name. This is required only for Oracle Cloud Infrastructure Database (DB System) running Oracle Database 12c or later.
- If you use Oracle Autonomous Database or DB System, the database can be in a different compartment than the Oracle WebLogic Server for OKE compute instances. Plan to use the same compartment in which you created the autonomous database, or create a compartment for the domain resources. See Create a Compartment.
- Create an SSH key. See Create an SSH Key.
- Create the secret for the password that you want to use for the WebLogic server domain. See Create Secrets with Passwords.
- Create the secret for the auth token for a user with access to Oracle Cloud Infrastructure Registry. This is the administrator password you provided when you created the database. See Create Secrets with Passwords.
- Create the secret for DB administrator password. See Create Secrets with Passwords.
If using an autonomous database, Oracle WebLogic Server for OKE can create the VCN and subnets for you when you create your new domain. If using an existing VCN and a DB System database or autonomous database, you can create new subnets or use existing subnets.
If you want to use an existing VCN or existing subnets, then they must meet certain requirements. See:
Topics:
- Launch a Stack
- Configure Stack Information
- Configure WebLogic Server on Container Cluster
- Configure the Container Cluster
- unresolvable-reference.html#GUID-4B318FCB-0A1E-40C7-A798-32FB22C0B6FA
- Configure the Administration Instances
- Configure the Network
- Configure the Database
- Configure the File System
- Configure the Registry
- Create OCI Policies
- Configure WebLogic Authentication with Oracle Identity Cloud Service
- Create the Stack
- Use Your New Domain
Configure WebLogic Server on Container Cluster
Specify the parameters needed to configure the WebLogic Server domain in a Kubernetes cluster.
Configure the Network
Define the Virtual Cloud Network (VCN) and the subnets configuration for the JRF-enabled domain.
Note:
If you're using a database in Oracle Cloud Infrastructure Database (DB System), make sure you select Use Existing VCN. You cannot create a new VCN for a domain that uses a DB System database.Configure the Container Cluster
You can specify the parameters needed to create a container cluster or configure the WebLogic Server domain to use an existing container cluster for an existing VCN and an existing subnet only.
Configure the Administration Instances
Specify where you want to create the Oracle WebLogic Server for OKE compute instances and select the shapes to use.
Configure the Database
You must specify a database in Oracle Autonomous Database or Oracle Cloud Infrastructure Database (DB System) if you're creating a JRF-enabled domain.
Note:
If you're using a DB System database, make sure you've selected Use Existing VCN from the Virtual Cloud Network Strategy dropdown in the Network section of the Create Stack wizard. From the Existing Network dropdown, make sure also you've selected the VCN where you created the DB System.In the Database section of the Configure Variables page, select the Database Strategy for your domain, then configure the database parameters.
- For Autonomous Database strategy, select or enter the following:
- The compartment in which you've created the autonomous database.
- The autonomous database where you want to create the JRF schemas for this WebLogic domain.
- The OCID of the secret for the password for the ADMIN user to access the selected autonomous database.
- The service level that the domain should use to connect to the selected autonomous database.
- For Database System strategy, select or enter the following:
- The compartment where the DB System is found.
- The DB system to use for this JRF-enabled domain.
- The database home within the selected DB system.
- The database home version.
- The database within the DB system where you want to create the JRF schemas for this domain.
- The Pluggable database (PDB) name, only if the selected database is running Oracle Database 12c or later.
- The name of a database user with database administrator (DBA) privileges, and the OCID for the secret for the password for that database administrator.
- The database listen port (1521 by default)
Configure the Registry
Specify the credentials that Oracle WebLogic Server for OKE uses to access container images in the Oracle Cloud Infrastructure Registry (OCIR).
- In the Registry User Name field, enter a user name that Kubernetes uses to access the image in the registry.
- In the Secrets OCID for Registry Authentication Token field, enter the OCID for the secret for the auth token generated for the registry user.
Create OCI Policies
When you create a JRF-enabled domain, by default the OCI Policies check box is selected and Oracle WebLogic Server for OKE creates a dynamic group and relevant root-level (tenancy) policies for you.
If you are not an administrator, the necessary groups and policies must be in place before you can create a domain.
Before you deselect the check box, ask your administrator to create the required dynamic group and relevant policies, as described in Create a Dynamic Group and Create Policies for the Dynamic Group.
Configure WebLogic Authentication with Oracle Identity Cloud Service
You have the option to use Oracle Identity Cloud Service to authenticate application users for your domain.
To use Oracle Identity Cloud Service for authentication:
Create the Stack
After you have specified the parameters for your JRF-enabled domain, finish creating the stack.
On the Review page of the Create Stack wizard, review the information you have provided, and then click Create. This runs the stack creation job.
The Job Details page of the stack in Resource Manager is displayed. A stack creation job name has the format ormjobyyyymmddnnnnnn
. For example, ormjob20200922125850
. Periodically monitor the progress of the job until it is finished. If an email address is associated with your user profile, you will receive an email notification.
Attention:
Immediately after you create a JRF-enabled domain, the WebLogic Server pods might be still inSTARTING
state. See WebLogic Server Pods are still in Starting State.
Use Your New Domain
Access and manage your new JRF-enabled domain after creating a stack.
- View the cloud resources that were created to support your domain. See View the Cloud Resources for a Domain
- Access the WebLogic Server Administration Console. See Access the WebLogic Console.
- Access the Jenkins build engine. See Access the Jenkins Console.
- Deploy an Java Enterprise Edition (Java EE) application. See Deploy a Sample Application.
- Update the domain (for example, deploy applications and libraries, apply a patch). See Update a Domain in Oracle WebLogic Server for OKE.