Oracle Cloud Infrastructure Documentation

Fleet Management

This chapter describes the tasks to create, update, and delete a fleet of managed instances.

This chapter includes the following topics:

Creating a Fleet

When creating a fleet, you may find yourself in one of the following two scenarios:

The following sections provide the steps required for each scenario.

Using a New Management Agent Configuration

In this scenario, JMS creates a new management agent install key for you. (For more information about management agent install keys, see Install Management Agents.)
Prerequisites: You have completed Setting Up Oracle Cloud Infrastructure for Java Management Service.
  1. In the Oracle Cloud Console, open the navigation menu, click Observability & Management, and then click Java Management.
  2. Click Create Fleet. You are prompted to enter information to describe the new fleet.
    1. Enter the following information:
    2. (Optional) Click Show Advanced Options to enter an alternative name for the management agent install key, or to provide one or more tags for the new fleet.
      • (Optional) Deselect Use Fleet Name for Install Key Name then enter an alternative name for the management agent install key. (For more information about the details of the key name, see Create an Agent Install Key.)
      • In the Maximum Installs field, specify a number that indicates the maximum number of installations that can be associated with the key. The default value is 1000.
      • In the Valid For field, specify a number that indicates the period for which the key is valid. The default value is 1 Year.

      • In the Tag Fleet section, provide a list of one or more unique tag key-value pairs to describe the fleet. (You can edit these later, see Updating a Fleet.)

        To add more tags click + Another Tag, and then provide the key-value pair for an additional tag.

  3. Click Next. You are prompted to review the fleet information and management agent configuration.

    If you wish to modify your choices, click Previous.

  4. Click Create. This creates a new fleet and a new management agent install key using the information you provided.
  5. Follow the link to download the management agent software for your host(s). You can also download this software at a later date, for example when viewing the details of a fleet (see Viewing a Fleet).
  6. Click Download key to file to download the response file.
  7. Follow the instructions in Installing a Management Agent for Java Management Service to install the management agent on your host(s). Skip steps 1-3.
You can view the fleet details as described in Viewing a Fleet.

Using an Existing Management Agent Configuration

In this scenario management agents are already installed on your hosts.
Prerequisites: You have completed Setting Up Oracle Cloud Infrastructure for Java Management Service and Installing a Management Agent for Java Management Service.
  1. In the Oracle Cloud Console, open the navigation menu, click Observability & Management, and then click Java Management.
  2. Click Create Fleet. You are prompted to enter information to describe the new fleet.
    1. Enter the following information:
    2. Deselect Create New Management Agent Configuration.
    3. (Optional) Click Show Advanced Options to provide a list of one or more unique tag key-value pairs to describe the fleet. (You can edit these later, see Updating a Fleet.).

      To add more tags click + Another Tag, and then provide the key-value pair for an additional tag.

  3. Click Next. You are prompted to review the fleet information.

    If you wish to modify your choices, click Previous.

  4. Click Create. This creates a new fleet using the information you provided. You can use the link to download the management agent software and response file for installation on additional hosts. (Follow the instructions in Installing a Management Agent for Java Management Service.)
  5. Modify the tags of each of your existing managed instances so that they are contained in the new fleet. For more information, see Modifying a Management Agent's Tags.
You can view the fleet details as described in Viewing a Fleet.

Updating a Fleet

After you have created a fleet, you can update its name, description, and the compartment in which it is contained. Additionally, you can edit the tags that describe the fleet in its role as an OCI resource.

Prerequisites: You are viewing the details of a fleet. (See Viewing a Fleet.)

  • Click Edit to modify the name of the fleet and its description.
  • Click Move Fleet to move the fleet to a different compartment.
    This has no effect on the contents of the fleet.
    Note

    If you attempt move a fleet to a compartment for which you do not have authorization, you will be presented with the error message Authorization failed or requested resource not found.
  • Click Add Tags to add tag key-value pair(s) to describe the fleet in its role as an OCI resource.
    These tags describe the fleet in its role as an OCI resource and have no effect on the contents of the fleet.
  • To edit or remove a fleet's tags, select the Tags tab and click Edit Pencil Icon.
    These tags describe the fleet in its role as an OCI resource and have no effect on the contents of the fleet.

Deleting a Fleet

When you no longer require a fleet, you can delete it. This operation removes the managed instances from the fleet and marks the fleet for deletion. (A deleted fleet is kept for 90 days before it is permanently removed.) Deletion has no effect on the managed instances contained by the fleet.

Prerequisites: You are viewing the details of a fleet. (See Viewing a Fleet.)
  • Click Delete to delete the fleet.
    You are prompted to confirm your action.