options:
  debug:
    type: boolean
    default: False
    description: Enable debug logging
  prefer-ipv6:
    type: boolean
    default: False
    description: |
      If True enables IPv6 support. The charm will expect network interfaces
      to be configured with an IPv6 address. If set to False (default) IPv4
      is expected.
      .
      NOTE: these charms do not currently support IPv6 privacy extension. In
      order for this charm to function correctly, the privacy extension must be
      disabled and a non-temporary address must be configured/available on
      your network interface.
  corosync_transport:
    type: string
    default: "unicast"
    description: |
      Two supported modes are multicast (udp) or unicast (udpu)
  corosync_mcastaddr:
    type: string
    default: 226.94.1.1
    description: |
      Multicast IP address to use for exchanging messages over the network.
      If multiple clusters are on the same bindnetaddr network, this value
      can be changed. Only used when corosync_transport = multicast.
  corosync_bindiface:
    type: string
    default:
    description: |
      Default network interface on which HA cluster will bind to communication
      with the other members of the HA Cluster. Defaults to the network
      interface hosting the units private-address. Only used when
      corosync_transport = multicast.
  corosync_mcastport:
    type: int
    default:
    description: |
      Default multicast port number that will be used to communicate between
      HA Cluster nodes. Only used when corosync_transport = multicast.
  corosync_key:
    type: string
    default: "64RxJNcCkwo8EJYBsaacitUvbQp5AW4YolJi5/2urYZYp2jfLxY+3IUCOaAUJHPle4Yqfy+WBXO0I/6ASSAjj9jaiHVNaxmVhhjcmyBqy2vtPf+m+0VxVjUXlkTyYsODwobeDdO3SIkbIABGfjLTu29yqPTsfbvSYr6skRb9ne0="
    description: |
      This value will become the Corosync authentication key. To generate
      a suitable value use:
      .
        sudo corosync-keygen
        sudo cat /etc/corosync/authkey | base64 -w 0
      .
      This configuration element is mandatory and the service will fail on
      install if it is not provided. The value must be base64 encoded.
  service_start_timeout:
    type: int
    default: 180
    description: |
      Systemd override value for corosync and pacemaker service start timeout
      in seconds. Set value to -1 turn off timeout for the services.
  service_stop_timeout:
    type: int
    default: 60
    description: |
      Systemd override value for corosync and pacemaker service stop timeout
      seconds. Set value to -1 turn off timeout for the services.
  stonith_enabled:
    type: string
    default: 'False'
    description: |
      Enable resource fencing (aka STONITH) for every node in the cluster.
      This requires MAAS credentials be provided and each node's power
      parameters are properly configured in its inventory.
  maas_url:
    type: string
    default:
    description: MAAS API endpoint (required for STONITH).
  maas_credentials:
    type: string
    default:
    description: MAAS credentials (required for STONITH).
  maas_source:
    type: string
    default: ppa:maas/stable
    description: |
      PPA for python3-maas-client:
      .
        - ppa:maas/stable
        - ppa:maas/next
      .
      The last option should be used in conjunction with the key configuration
      option. Used when service_dns is set on the primary charm for DNS HA.
  cluster_count:
    type: int
    default: 3
    description: |
      Number of peer units required to bootstrap cluster services.
      .
      If less that 3 is specified, the cluster will be configured to
      ignore any quorum problems; with 3 or more units, quorum will be
      enforced and services will be stopped in the event of a loss
      of quorum. It is best practice to set this value to the expected
      number of units to avoid potential race conditions.
  monitor_host:
    type: string
    default:
    description: |
      One or more IPs, separated by space, that will be used as a safety check
      for avoiding split brain situations. Nodes in the cluster will ping these
      IPs periodically. Node that can not ping monitor_host will not run shared
      resources (VIP, shared disk...).
  monitor_interval:
    type: string
    default: 5s
    description: |
      Time period between checks of resource health. It consists of a number
      and a time factor, e.g. 5s = 5 seconds. 2m = 2 minutes.
  netmtu:
    type: int
    default:
    description: |
      Specifies the corosync.conf network mtu. If unset, the default
      corosync.conf value is used (currently 1500). See 'man corosync.conf' for
      detailed information on this config option.
  # Monitoring config
  nagios_context:
    type: string
    default: "juju"
    description: |
      Used by the nrpe-external-master subordinate charm.
      A string that will be prepended to instance name to set the host name
      in nagios. So for instance the hostname would be something like:
      .
         juju-postgresql-0
      .
      If you're running multiple environments with the same services in them
      this allows you to differentiate between them.
  nagios_servicegroups:
    type: string
    default: ""
    description: |
      A comma-separated list of nagios servicegroups. If left empty, the
      nagios_context will be used as the servicegroup.