Configure OCI load balancers

Configure a load balancer, register the load balancer with DNS, and test that the load balancer works as expected.

Before you begin

Ensure that you have:

  • An Access Gateway high availability cluster that has two or more worker nodes.
  • The external domain for the load balancer (for example, oag-external.com).

Steps

  1. Connect to OCI and configure a load balancer:

    1. User a browser to sign in to Oracle cloud.
    2. Select NetworkingLoad Balancers.
    3. Click Create Load Balancer.
    4. In the Select Load Balancer type dialog, select Load Balancer. Click Create Load Balancer.
    5. In the Add Details step specify:

      Field or section

      Value

      Name

      Enter a meaningful name (for example, AccessGatewayExternalLB).

      Visibility type

      Select Public.

      Assign a public IP

      Select Ephemeral or Reserved IP, as appropriate.

      Shapes

      Modify the minimum and maximum bandwidth to support expected traffic.

      Choose networking

      For Virtual cloud network ..., select the virtual cloud network that contains the Access Gateway worker nodes.

      For subnet in ..., select the subnet assigned to the Access Gateway worker nodes.

    6. Click Next.
    7. In the Choose Backends step specify:

      Field or section

      Value

      Load balancing policy

      Select IP Hash.

      Backends

      Click Add Backends and select the appropriate instances of Access Gateway.

      You can define a load balancer without back-end resources and then assign them later.

      Assign a public IP

      Select Ephemeral or Reserved IP, as appropriate.

      Shapes

      Modify minimum and maximum bandwidth to support expected traffic.

      Choose networking

      For Virtual cloud network..., select the virtual cloud network that contains the Access Gateway worker nodes.

      For subnet in ..., select the subnet assigned to the Access Gateway worker nodes.

      Specify Health Check Policy

      For URL Path (URI), enter /status

      Leave all other values unchanged.

    8. Click Next.
    9. In the Configure listener step specify:

      Field or section

      Value

      Name

      Enter a meaningful name (for example, OAG LB listener).

      Traffic type

      Select HTTP.

    10. Click Next.
    11. In the Manage logging step, click Submit.

    Oracle Cloud Infrastructure creates the load balancer. This can take up to five minutes to complete.

  2. Register the load balancer with your DNS service provider. The following steps may vary by DNS provider:
    1. In the OCI console go to NetworkingLoad Balancers.
    2. Note the IP address of the load balancer.
    3. Connect to your DNS Service provider and add a CNAME record mapping the front end IP address to the external name. For example:

      CNAME host: www.[your external name], target: load balancer ip address

    4. Return to the OCI console.
  3. Test the load balancer using a header-based application. Complete this section if an application doesn't already exist for www.[external domain].com:
    1. Return to or sign in to the (Undefined variable: okta-feature-names.Access Gateway UI).
    2. Select the Applications tab.
    3. Click Add.
    4. Select Sample Header.
    5. In the Essentials tab, specify the following:
      FieldValue

      Name

      A meaningful name for the application (for example, Load Balancer Header Test).

      Public Domain

      www.[external domain] (for example, www.oag-external.com)

      Groups

      Everyone

    6. Click Next. The Attributes tab opens.
    7. Click Next. The Policies tab opens.
    8. Click Done.
    9. Open a new browser or a Chrome incognito window.
    10. Enter the URL associated with the application.
    11. The Access Gateway sample header app page should display.

Related resources

Load balancers

Oracle OCI Load Balancers