Oracle Cloud Infrastructure Documentation

Enabling Advanced Features

To utilize advanced features within your fleet, follow the steps:
  1. Enable advanced features using one of the following workflows:
    • Create Fleet

      In the Advanced features section, select the Advanced feature(s) that you want to enable.

    • Actions
      • Select Edit Properties under Actions.
      • In the Advanced features section, select the Advanced feature that you want to enable.
    Note

    • Advanced features should be turned on only on OCI instances and hosts covered by Java SE subscription terms. See the JMS Service Description for more details.
    • Turning on advanced features might impact the performance of running applications in your fleet as JMS collects additional data from the applications and Java Virtual Machines (JVMs) in the fleet.
  2. The Manage Advanced Features panel opens. Acknowledge and consent to the terms in the Acknowledgment section.
  3. When you agree to the terms in the Acknowledgment section, the Manage Advanced Features panel displays the Resources for advanced features section. To enable these advanced features, JMS attempts to create the following required resources:
    • Object Storage Bucket: Used for Crypto event analysis, Performance analysis, JDK Flight recorder (JFR), and Java migration analysis to store the crypto event analysis reports and JFR recordings.
    • Log Object: Used for Crypto Event Analysis, this log stores summarized crypto events collected by JMS agents.
    • Policy with Required Permissions: The following statements must be included to perform advanced features within your fleet:
      ALLOW dynamic-group JMS_DYNAMIC_GROUP to MANAGE object-family IN COMPARTMENT Fleet_Compartment
ALLOW group FLEET_MANAGERS to MANAGE object-family IN COMPARTMENT Fleet_Compartment
ALLOW resource jms SERVER-COMPONENTS to MANAGE object-family IN COMPARTMENT Fleet_Compartment

    Resource creation options:

    • Using the Wizard (For OCI Administrators)

      OCI administrators, who have the highest level of privilege in OCI, can use the wizard to automatically create these resources. The wizard will create:

      • Object Storage Bucket: Named jms_<fleet_OCID>
      • Crypto Log Object: Named <fleet_name>_Crypto_log
      • Policy: Named JMS_Advanced_Features with the permissions listed above
    • Manual Creation (For Non-Admin Users)

      If users do not have the required permissions, they must work with OCI administrators to create these resources manually. After the resources are created, non-admin users can enable the advanced features by selecting the checkbox. The policy and dynamic group are already created using the instructions in Enabling Advanced Features.

      Manual Creation Steps:

      • Associate an Object Storage Bucket: Refer to create an object storage bucket. Once created, associate it with JMS Fleets using the Update Fleet Advanced Feature Configuration Details API.
      • Associate a Log Object: Refer to create a log. After creation, associate it with JMS Fleets using the Update Fleet Advanced Feature Configuration Details API.
      • Create a Policy: Refer to create a policy to set the necessary permissions.
  4. Select Enable.