Update a Domain Configuration

Use the Jenkins job to update a domain that you created with Oracle WebLogic Server for OKE.

When you run the update domain job, the primordial domain created using the create domain job is used as the base domain, and updates are applied to this domain.

Therefore, if you run the update domain job for the first time and deploy an application-A in this job, the resulting primordial domain will have application-A deployed. Then, if you run the update domain job for the second time and deploy only application-B in the job, the resulting primordial domain will have only application-B deployed. That is, the state on top of the primordial domain is not stored within the image and this allows you to use the source control system to store WebLogic Deploy Tooling (WDT) model to persist any configuration changes on top of the primordial domain.

To know about the primordial domain, see Mutate the Domain Layer in WebLogic Kubernetes Operator documentation.

You can extend your model Yaml file with new definitions using the update domain job. For model Yaml file, see About WebLogic Deploy Tooling.

Tip:

To deploy and undeploy an application, see Tutorial iconTutorial.

To update the WebLogic domain you can provide a WDT model file, a WDT properties file, or an archive file. The archive file can contain applications, libraries, model file along with other artifacts. For the structure of the archive file, see archive file in WebLogic Deploy Tooling documentation.

When you are updating the domain, if you provide a model through the WDT model field and within the archive, the model specified in the field takes precedence.

You can use one of the following sources to specify the location of the archive zip file, domain model Yaml file, and variables properties file:
  • File Upload - Uploads the file from the local system.

  • Object Storage - Uses the pre-authenticated URL on the Object Storage.

  • Shared File System - Uses the path of the shared file storage.

    The NFS shared file system path is mounted on /u01/shared location on the administration host.

To update the domain configuration:

  • The model Yaml file must contain the required secrets like WebLogic Admin Password, runtime encryption secret, and Repository Schema Utility (RCU) schema user password.
  • In case of Oracle Cloud Infrastructure Database (DB system), the model Yaml file must include the datasource secret and in case of Oracle Autonomous Database, the model Yaml file must include the datasource secret and wallet with the keystore passwords. See About Data Sources.

See RCU Connection Information in WebLogic Deploy Tooling documentation.

To update a domain and deploy applications, shared libraries, and resources to the domain:

Note:

Every time you update a domain, you have to provide a model containing all the resources (applications, libraries, and so on) you want your domain to have. If your domain currently have application-A installed, and you update your domain with a model with application-B, then the domain will have only application-B. If you want to have both applications, you have to use a model with both application-A and application-B.
  1. Sign in to the Jenkins console for your domain. See Access the Jenkins Console.
  2. On the Dashboard page, click update domain.
  3. Click Build with Parameters.
  4. From Domain_Name, select the domain that you want to update.
  5. Select the source of the archive zip file from the Archive_Source list.

    Note:

    In case of files larger than one MB, use the Object Storage or Shared File System option.
  6. For Archive_File_Location, either browse to select the zip file, specify the http pre-authenticated URL, or specify the path of the zip file on the shared file system.

    For the structure of the archive file, see archive file in WebLogic Deploy Tooling documentation.

  7. Select the source of the domain model Yaml file from the Domain_Model_Source list.

    If the archive zip file contains the domain model Yaml file, you can skip this step.

  8. For Model_File_Location, either browse to select the Yaml file, specify the http pre-authenticated URL, or specify the path of the Yaml on the shared file system.

    See model YAML file in WebLogic Deploy Tooling documentation.

  9. Select the source of the variable properties file from the Variable_Source list.
  10. For Variable_File_Location, either browse to select the file, specify the http pre-authenticated URL, or specify the path of the properties file on the shared file system.
  11. Deselect the Rollback_On_Failure check box if you do not want to rollback to the previous working domain image (optional).

    If you deselected this check box, you can rollback to the previous image later from the backup.

    Note:

    The Rollback_On_Failure check box is selected by default.
  12. Optional: Configure the Registry.
    If you want to use another user credentials, other than the one specified when creating a stack, then specify the credentials that Oracle WebLogic Server for OKE must use to access container images in the Oracle Cloud Infrastructure Registry (OCIR).
    1. In the Registry_Username field, enter a user name that Kubernetes uses to access the image in the registry.
    2. In the Registry_Authentication_Token field, enter the OCID for the secret for the auth token generated for the registry user.
  13. Click Build to run the Pipeline job.

You can use the WebLogic Server Administration Console to verify that the domain is updated with all the specified parameters. See Access the WebLogic Console.