This operation installs a Gateway Node on endpoints configured with the resource 'Oracle API Platform Node Server' on the environment instance. The operation requires a gateway-props.json file for configuration. See the special considerations below for more information on the gateway-props.json file.
...
| Property Name | Property Code | Required | Description |
|---|---|---|---|
| Oracle API Platform Account | FDOAP_CLOUD_ACCOUNT_CODE | Y | The Oracle API Platform cloud account to use for this operation. |
| Oracle Gateway Install Home | FDOAP_GATEWAY_INSTALL_HOME | Y | Absolute location of where to install the gateway node configuration. This is where the executable and libraries will be located. This should be empty prior to running this operation. Note that this is different compared to the 'nodeInstallDir' property in the gateway-props.json |
| Node Weblogic User | FDOAP_NODE_WL_ADMIN_USER | Y | Weblogic admin user to configure when creating the node. Oracle API Platform Nodes are weblogic servers and this is your admin user. |
| Node Weblogic Password | FDOAP_NODE_WL_ADMIN_PASSWORD | Y | Weblogic admin password to configure when creating the node. |
...
| Property Key | Description | Required | Example Value | Recommendation |
|---|---|---|---|---|
| logicalGatewayId | Logical Gateway Id to join the Node to. Only required if using the default Node install action. | Sometimes | 117 | FlexDeploy property ${{FDOAP_GATEWAY_ID}}. |
| logicalGateway | Logical Gateway Name to create during installation. Only required when running 'install-configure-start-create-join' | Sometimes | Development | Either create your own FD property or some variation on FD_ENVIRONMENT_NAME |
| gatewayNodeName | The name of the Gateway Node to create. | Yes | Node MyDevServer | Node ${{FD_ENDPOINT_NAME}} |
| gatewayNodeDescription | The description you see when inspecting the node. | Yes | Created through FlexDeploy | Include ${{FD_PROJECT_VERSION}} somewhere |
| listenIpAddress | The internal IP used for configuration | Yes | yourinternalhost | Could potentially use ${{FD_ENDPOINT_ADDRESS}} |
| publishAddress | The public IP used for configuration | Yes | yourhost | Could potentially use ${{FD_ENDPOINT_ADDRESS}} |
| nodeInstallDir | Directory where to install the node. This is different than 'Oracle Gateway Install Home' above. | Yes | /opt/apiplatform/node | Keep this the same across Nodes for consistency. |
| gatewayExecutionMode | Development|Production. Development has certain networking security disabled. | Yes | Development | Create a user defined input |
Derived Properties
The following fields are dynamically added and removed from the file. If you do not wish to change the values then you can safely ignore this section. If you want to set custom values for any of the below fields you can simply set them in your gateway-props.json file and they will take precedence.
| Property Key | Derived Value |
|---|---|
| gatewayadminName | Node Weblogic User Environment Instance Property |
| gatewayadminPassword | Node Weblogic Password Environment Instance Property |
| gatewayManagerUser | Oracle API Username Cloud Account Property |
| gatewayManagerPassword | Oracle API Password Cloud Account Property |
| clientId | Oracle API Client Id Cloud Account Property |
| clientSecret | Oracle API Client Secret Cloud Account Property |
| gatewayRuntimeUser | Oracle API Username Cloud Account Property |
| gatewayRuntimePassword | Oracle API Password Cloud Account Property |
| managementServiceUrl | Oracle API Platform Url Cloud Account Property |
| idcsUrl | Oracle Identity Url Cloud Account Property |
| requestScope | Combination of Audience and Scope Cloud Account Properties. Also adds 'offline_access'. |
One file with FlexDeploy Properties or one file per environment
...