1. Using Oracle API Platform Cloud Service - Classic
  2. Managing Gateways
  3. Creating a Logical Gateway

Creating a Logical Gateway

Use the Management Portal or the createGateway action in the gateway installer to create a logical gateway.

This task describes how to create a logical gateway. See Understanding Gateways and Gateway Nodes for a description of the relationship between logical gateways and gateway nodes. To install a gateway node, see Installing a Gateway Node.

Tip:

You can also create a logical gateway with the REST API for the Management Service in Oracle API Platform Cloud Service.

Option 1: Create a Logical Gateway in the Management Portal

Perform these steps in the Management Portal UI with a user with the Administrator or the Gateway manager role:

  1. From the Gateways tab, click Create Gateway.

  2. In the Gateway Name field, enter a name for the logical gateway.

  3. (Optional) In the Description field, describe the logical gateway you’re creating.

  4. Click Create.

    The logical gateway is created. It appears on the Gateway List page. The user who created the gateway is issued the Manage Gateway grant for it.

  5. Click the logical gateway you just created. The gateway’s Settings page, which displays the gateway’s ID and other details, appears.

  6. Provide the following details about your gateway, as applicable:

    • Load Balancer URL: If gateway nodes registered to this logical gateway are or will be placed behind a load balancer, provide HTTP and HTTPS URLs for the load balancer in the following format: http://<hostname or IP>:<port>/ for HTTP; https://<hostname or IP>:<port>/ for HTTPS.

    • Location: Describe the location of the nodes registered to this logical gateway.

    • Firewall: Configure firewall properties for nodes registered to this logical gateway.

      See Configuring Gateway Firewall Properties.

Option 2: Create a Logical Gateway with the Gateway Node Installer

Perform these steps from a machine you’ve installed a gateway node to:

  1. Edit or add the following properties in the gateway-props.json file with details describing the gateway and the management tier:

    • nodeInstallDir

    • logicalGateway

    • gatewayNodeName

    • managementServiceUrl

    Note:

    Note that you may also need to provide values for the managementServiceConnectionProxy property and other properties depending on your environment. See gateway-props.json File

  2. Run the creategateway action.

    When you run this action, you are prompted for the following user credentials:

    • weblogic user: the WebLogic administrator user of the gateway node. These credentials are created when you run any of the install actions.

    • gateway manager user: the Gateway Manager user that is responsible for managing this gateway. You must provide the user’s name and password. This user must already exist on the Management Portal. This user is issued the Manage Gateway grant when the gateway is created.

    • gateway runtime user: the Gateway Runtime user that is used to download configuration from and upload statistics to the gateway. You must provide the user’s name and password. This user must already exist on the Management Portal. This user is issued the Node Service Account grant when the gateway is created.

    See creategateway.

The logical gateway is created on the Management Portal. The Gateway Manager user you specified is issued the Manage Gateway grant for the gateway and the Gateway Runtime user you specified is issued the Node Service Account for the gateway.