Oracle Cloud Infrastructure Documentation

Switching Management Stations

Change which management station an instance is associated with in OS Management Hub.

  • Bulk switch multiple instances

    1. On the Management station list page, select the name of the station currently associated with the instances. If you need help finding the list page, see Listing Management Stations.
    2. Under Resources, select Associated instances.
    3. Select instances in the list, and then select Switch management station.
    4. Update the instance settings with the new station information.

    Switch a single instance

    1. On the Instances list page, select the name of the instance. If you need help finding the list page, see Listing Instances.
    2. Next to the Management station field, select Edit.
    3. Select a new management station to associate with the instance.
    4. Select Save Changes.
    5. Update the instance settings with the new station information.

    Update the instance settings

    1. On the Management station list page, select the name of the newly associated station. If you need help finding the list page, see Listing Management Stations.
    2. On the management station details page, select the Configuration tab.
    3. Record the Hostname and Proxy listening port values for use with the setup script.
    4. Log in to the instance as a user with sudo privileges
    5. Use the instance-setup.sh script to update the station settings on each instance. 
      sudo /opt/oracle/mgmt_agent/plugins/osmh/bin/instance-setup.sh --proxy-host <STATION_HOSTNAME> --proxy-port <STATION_PROXY_PORT>
      Note

      If you're switching between high availability (HA) peer stations, you don't need to run the script. The hostname and proxy settings are identical for the HA stations. See Configuring High Availability for Management Stations.

  • Use the oci os-management-hub managed-instance associate-managed-instances-with-management-station command and required parameters to switch the associated management station on multiple instances.

    oci os-management-hub managed-instance associate-managed-instances-with-management-station --managed-instances instance-ocids.json --management-station-id ocid [OPTIONS]

    Use the oci os-management-hub managed-instance update command and required parameters to switch the associated management station on a single instance.

    oci os-management-hub managed-instance update --managed-instance-id ocid --primary-station-id ocid [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Run the UpdateManagedInstance operation to switch the management station associated with the instance.