Enable OS Management for Oracle SOA Suite on Marketplace Instances

To assist you with managing patches, Oracle SOA Suite on Marketplace supports the Oracle Cloud Infrastructure OS Management service.

OS Management offers the capability to view and install the available CPU fixes, security patches, and bug fixes on your compute instances. You can create instance groups and add all the nodes of a SOA cluster to a group and manage all the patches and updates of all the instances in the group. This can be done through the OS Management tab in the Oracle Cloud Infrastructure Console. For more information, see OS Management in the Oracle Cloud Infrastructure documentation.

Prerequisites

To prepare for enabling OS Management:

Create a dynamic group and add all your existing Oracle SOA Suite on Marketplace instances to this dynamic group. See Managing Dynamic Groups in the Oracle Cloud Infrastructure documentation.
Add the appropriate rules to add the Oracle SOA Suite on Marketplace instances to the dynamic group.

Create policies to grant the instances of the dynamic group to use OS Management:

ALLOW dynamic-group <dynamic_group_name> to use osms-managed-instances in compartment <compartment_name>
ALLOW dynamic-group <dynamic_group_name> to read instance-family in compartment <compartment_name>

(Optional) Create the following policy to grant OS Management to emit metrics:
```
ALLOW service osms to read instances in tenancy
```
To use the OS Management service on Oracle Linux 8 instances provisioned before 9 September 2020, you must manually install the OS Management Service Agent (osms-agent) using the following command:
```
sudo yum install osms-agent
```
For more information, see To install the Agent in Oracle Linux 8 instances in the Oracle Cloud Infrastructure documentation.

Enable OS Management

To enable OS Management on Oracle SOA Suite on Marketplace instances:

If the Oracle SOA Suite on Marketplace instances were created before the policies under Prerequisites were added, you must restart the Oracle Cloud Agent on the VM:
1. Use the ssh command to connect to the Linux VM as the opc user:
```
ssh -i private_key opc@VM_IP_address
```
2. Enter the following command to restart the Oracle Cloud Agent:
```
sudo systemctl restart oracle-cloud-agent.service
```
Create managed instance groups as described in Administering Managed Instance Groups in the Oracle Cloud Infrastructure documentation.

Add all the compute instances of the SOA cluster in the managed instance group. You can apply patches and updates on all the nodes of the cluster in a single click, which ensures all the nodes of the cluster are in synch.

Manage an Oracle SOA Suite on Marketplace Instance in Oracle Cloud Infrastructure

You can install and remove packages and software on the Linux operating system from the OS Management tab in the Oracle Cloud Infrastructure Console. You can install new patches and upgrades on individual SOA compute instances or an entire instance group (cluster) that you created.

You can schedule the upgrades to be run daily, weekly, or monthly to keep the operating system up to date.