Configure DNS alias to Oracle WebLogic Server

This page documents how to configure an existing deployment of Oracle WebLogic Server with a custom DNS alias.

Prerequisites

Environment for Setup

Azure CLI, use az --version to test if az works.

WebLogic Server Instance

The DNS Configuration ARM template will be applied to an existing Oracle WebLogic Server instance. If you don’t have one, please create a new instance from the Azure portal, by following the link to the offer in the index.

Registered Domain Name

You need to buy a domain name to create a custom DNS alias.

Azure DNS Zone

If you create the DNS alias on an existing Azure DNS Zone, make sure you have performed the Azure DNS Delegation. After you have completed the delegation, you can verify it with nslookup. For example, assuming your domain name is contoso.com, this output shows a correct delegation.

$ nslookup -type=SOA contoso.com
Server:         172.29.80.1
Address:        172.29.80.1#53

Non-authoritative answer:
contoso.com
        origin = ns1-01.azure-dns.com
        mail addr = azuredns-hostmaster.microsoft.com
        serial = 1
        refresh = 3600
        retry = 300
        expire = 2419200
        minimum = 300
Name:   ns1-01.azure-dns.com
Address: 40.90.4.1
Name:   ns1-01.azure-dns.com
Address: 2603:1061::1

We strongly recommend you create an Azure DNS Zone for domain management and reuse it for other purpose. Follow the guide to create an Azure DNS Zone.

Prepare the Parameters

We provide an automation shell script for DNS configuration. You must specify the information of the existing Oracle WebLogic Server. This section shows how to obtain the values for the following required properties.

Parameter Name	Explanation
`--admin-vm-name`	Required. Name of virtual machine that hosts Oracle WebLogic Server admin server. Must be the same value provided at initial deployment time.
`--admin-console-label`	Required. Label for Oracle WebLogic Server admin console. Used to generate subdomain of admin console.
`--artifact-location`	Required. See below for details.
`--resource-group`	Required. Name of resource group that has an Oracle WebLogic Server cluster deployed.
`--location`	Required. Must be the same region into which the server was initially deployed.
`--zone-name`	Required. Azure DNS Zone name.
`--zone-resource-group`	Optional. Name of resource group that has Azure DNS Zone deployed. The parameter is only required if you are creating DNS alias on an existing DNS Zone.
`--help`	Help.

Artifacts location

This value must be the following.

https://raw.githubusercontent.com/oracle/weblogic-azure/2024-02-29-1-Q1/weblogic-azure-vm/arm-oraclelinux-wls-admin/src/main/arm/

Invoke the Automation Script

We provide an automation script to configure a custom DNS alias. The script lets you do the following:

If you have an Azure DNS Zone, it will create a DNS alias for the admin console on the existing DNS Zone.
If you don’t have an Azure DNS Zone, it will create the DNS Zone in the same resource group as the Oracle WebLogic Server cluster, then create the DNS alias for the admin console.

Configure DNS Alias on an Existing Azure DNS Zone

To configure a DNS alias on an existing Azure DNS Zone, in addition to the required parameters, you must also specify an Azure user-assigned managed identity ID and the resource group name in which your DNS Zone is deployed.

This is an example to create a DNS alias admin.contoso.com for the admin console in an existing Azure DNS Zone.

$ curl -fsSL https://raw.githubusercontent.com/oracle/weblogic-azure/2024-02-29-1-Q1/weblogic-azure-vm/arm-oraclelinux-wls-admin/cli-scripts/custom-dns-alias-cli.sh \
  | /bin/bash -s -- \
  --resource-group `yourResourceGroup` \
  --admin-vm-name adminVM \
  --admin-console-label admin \
  --artifact-location https://raw.githubusercontent.com/oracle/weblogic-azure/2024-02-29-1-Q1/weblogic-azure-vm/arm-oraclelinux-wls-admin/src/main/arm/ \
  --location eastus \
  --zone-name contoso.com \
  --zone-resource-group `yourDNSZoneResourceGroup`

An example output:

Done!

Custom DNS alias:
    Resource group: contoso-dns-doc
    WebLogic Server Administration Console URL: http://admin.contoso.com:7001/console
    WebLogic Server Administration Console secured URL: https://admin.contoso.com:7002/console

Configure DNS Alias on a New Azure DNS Zone

To configure a DNS alias on a new Azure DNS Zone, you must specify the required parameters.

This is an example of creating an Azure DNS Zone, then creating a DNS alias admin.contoso.com for the admin console.

$ curl -fsSL https://raw.githubusercontent.com/oracle/weblogic-azure/2024-02-29-1-Q1/weblogic-azure-vm/arm-oraclelinux-wls-admin/cli-scripts/custom-dns-alias-cli.sh \
  | /bin/bash -s -- \
  --resource-group `yourResourceGroup` \
  --admin-vm-name adminVM \
  --admin-console-label admin \
  --artifact-location https://raw.githubusercontent.com/oracle/weblogic-azure/2024-02-29-1-Q1/weblogic-azure-vm/arm-oraclelinux-wls-admin/src/main/arm/ \
  --location eastus \
  --zone-name contoso.com

An example output:

DONE!
  

Action required:
  Complete Azure DNS delegation to make the alias accessible.
  Reference: https://aka.ms/dns-domain-delegation
  Name servers:
  [
  "ns1-02.azure-dns.com.",
  "ns2-02.azure-dns.net.",
  "ns3-02.azure-dns.org.",
  "ns4-02.azure-dns.info."
  ]

Custom DNS alias:
    Resource group: contoso-dns-doc
    WebLogic Server Administration Console URL: http://admin.contoso.com:7001/console
    WebLogic Server Administration Console secured URL: https://admin.contoso.com:7002/console

Note: The DNS aliases are not accessible now, you must perform Azure DNS delegation after the deployment. Follow Delegation of DNS zones with Azure DNS to complete the Azure DNS delegation.

Verify the Custom Alias

Access the URL from output to verify if the custom alias works.