NAME

       ocf_heartbeat_gcp-ilb - Replies to health checks from Google Cloud

SYNOPSIS

       gcp-ilb [start | stop | monitor | meta-data | validate-all]

DESCRIPTION

       Resource Agent that wraps /usr/bin/nc or /usr/bin/socat to reply to health checks in
       Google Cloud. See https://cloud.google.com/load-balancing/docs/health-checks for more
       information.

SUPPORTED PARAMETERS

       port
           Listening port for health-check probes. Default: 60000

           (optional, string, default "60000")

       cat
           Location of netcat (default: /usr/bin/nc ) or socat (default: /usr/bin/socat ). If
           present, is used /usr/bin/socat. The recommended binary is socat, present in the
           following minimum versions if the package resource-agents: - SLES 12 SP4/SP5:
           resource-agents-4.3.018.a7fb5035-3.30.1. - SLES 15/15 SP1:
           resource-agents-4.3.0184.6ee15eb2-4.13.1.

           (optional, string, default "nc")

       log_enable
           Logging with an external application is enabled (accepts "true" or "false"). The
           defaults are configured to call "gcloud logging" (see:
           https://cloud.google.com/sdk/gcloud/reference/logging).

           (optional, string, default "false")

       log_cmd
           External logging command. The defaults are configured to call "gcloud logging" (see:
           https://cloud.google.com/sdk/gcloud/reference/logging). This parameter should only
           have the binary that can be validated (e.g., gcloud). The rest of the command is
           formed with the additional parameters and the message being logged as follows: -
           log_cmd + log_params + "The message being logged" + log_end_params Using the gcloud
           command for Stackdriver logging, the parameters would be: - log_cmd = gcloud -
           log_params = logging write GCPILB - "This is a message being sent by the app" -
           log_end_params = (nothing in this case, this is reserved for use with other tools)
           Which would result in this valid command (where GCPILB is the name of the log): gcloud
           logging write GCPILB "This is a message being sent by the app"

           NOTE: Only the binary is validated for existence and no further checks are performed.
           The assumption is that only administrators with root access can configure this tool.

           (optional, string, default "gcloud")

       log_params
           Additional input for the logging application. See explanation for log_cmd

           (optional, string, default "logging write GCPILB")

       log_end_params
           Additional input for the logging application. Placed after the message being logged.

           (optional, string, no default)

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

       start
           Starts the resource. Suggested minimum timeout: 10s.

       stop
           Stops the resource. Suggested minimum timeout: 30s.

       monitor
           Performs a detailed status check. Suggested minimum timeout: 30s. Suggested interval:
           30s.

       validate-all
           Performs a validation of the resource configuration. Suggested minimum timeout: 5s.

       meta-data
           Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

EXAMPLE CRM SHELL

       The following is an example configuration for a gcp-ilb resource using the crm(8) shell:

           primitive p_gcp-ilb ocf:heartbeat:gcp-ilb \
             op monitor depth="0" timeout="30s" interval="30s"

EXAMPLE PCS

       The following is an example configuration for a gcp-ilb resource using pcs(8)

           pcs resource create p_gcp-ilb ocf:heartbeat:gcp-ilb \
             op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="30s"

SEE ALSO

       http://clusterlabs.org/

AUTHOR

       ClusterLabs contributors (see the resource agent source for information about individual
       authors)