Oracle Cloud Infrastructure Documentation

Configuring High Availability for Management Stations

Configure a load balancer and multiple management stations to provide higher availability of your management stations in OS Management Hub.

Understanding High Availability

Use high availability (HA) for management stations to ensure instances can continue to receive updates from OS Management Hub in the event a management station instance fails. Individual instances connect to a load balancer which has multiple management stations configured as backends. To implement HA, there are several layers that each need to be highly available: the load balancer, management stations, and mirror storage.


High availability configuration using a load balancer, two management stations, and shared NFS storage.

To create the HA setup, configure management stations as backends to a highly-available load balancer. When you create the stations, you specify the hostname, fully-qualified domain name, or IP address of the load balancer so that managed instances communicate with the station through the load balancer.

The list of mirrored software sources for a station is built dynamically based on the profiles and instances referring to the station (see Understanding Management Stations). For stations in an HA configuration, the mirror list is unified across all peer stations. A profile or instance referring to one of the HA stations updates the mirror list of all the peer stations. Therefore, if one station becomes inoperable, another station can support the managed instances and keep its mirror volume synchronized.

To reduce the amount of storage required, you can configure the stations to use shared storage for the mirror. When using shared storage, the software source mirror sync status on a management station might incorrectly show as 'Unsynced'. See Known Issue: 'Unsynced' status on stations using shared storage.

Before You Begin

Determine the networking configuration:

  • Identify the management station ports. All stations in an HA configuration must use the same ports:

    • Proxy listening port
    • Mirror listening port for HTTP
    • Mirror listening port for HTTPS
  • Identify the hostname or IP address for the management stations.
  • Identify the hostname or IP address for the load balancer.
  • Ensure the load balancer will be able to connect to the stations.
  • Ensure the managed instances will be able to connect to the load balancer.
  • Ensure the load balancer is in the station's permitted address range.
Determine the storage configuration:
  • Prepare the mirror storage volume to be highly available.
  • Identify the storage path.
  • Mount the highly-available storage volume on the storage path. For consistency, use the same mount path on all stations in the HA setup (for example /mnt/mirror).

Setting Up High Availability for a New Environment

  1. Create management stations.

    • All stations must be in the same compartment.
    • All stations must use the same settings for proxy and mirror ports.
    • For hostname, specify the load balancer hostname or IP address.

    For example, if you have two stations:

    Setting Station A Station B
    Name StationA StationB
    Description Station in HA config Station in HA config

    Hostname

    (load balancer hostname)

    		 loadbalancer.example.com loadbalancer.example.com
    Permitted address range 10.0.0.0/8 10.0.0.0/8
    Listening port 16080 16080
    Storage path /mnt/mirror /mnt/mirror
    Mirror listening port (HTTP) 17080 17080
    Mirror listening port (HTTPS) 17443 17443

  2. Register the management stations.

  3. Configure a load balancer to route traffic from the following three ports to the management stations configured for high availability. Configure the frontend and backend for three ports:

    • Proxy listening
    • HTTP mirror listening port
    • HTTPS mirror listening port

  4. Create a profile that specifies one of the management stations.

  5. Register instances using the profile you just created. Note the following exception:

    When configuring the input.rsp file in the Set Up the Management Agent section, use the load balancer hostname.

    For example:

    cat >/tmp/input.rsp <<EOF
ManagementAgentInstallKey = <MACS_KEY>
Service.plugin.osmh.download = true
GatewayServerHost = <LOAD_BALANCER_HOSTNAME>
GatewayServerPort = <SHARED_STATION_PROXY_PORT>
EOF

Reconfiguring Existing Environments for High Availability

Reconfiguring management stations

  1. Edit existing stations or create new stations as necessary.

    • All stations must be in the same compartment.
    • All stations must use the same settings for proxy and mirror ports.
    • For hostname, specify the load balancer hostname or IP address.

  2. Register any new management stations. If you changed proxy or mirror settings on existing stations, ensure you update the firewall and SElinux settings on the station.

  3. Configure a load balancer to route traffic from the following three ports to the management stations configured for high availability. Configure the frontend and backend for three ports:

    • Proxy listening
    • HTTP mirror listening port
    • HTTPS mirror listening port
Reconfiguring instances
  1. Identify existing instances that you want in the HA configuration.
  2. On each managed instance, switch the management station to point to one of the HA stations.
  3. Ensure you run the instance-setup.sh script to update the hostname and proxy information.