NAME

       ocf_heartbeat_powervs-subnet - Manages moving a Power Virtual Server subnet

SYNOPSIS

       powervs-subnet [start | stop | monitor | meta-data | validate-all]

DESCRIPTION

       Resource Agent to move a Power Virtual Server subnet and its IP address from one virtual server instance
       to another. The prerequisites for the use of this resource agent are as follows:

       1. Red Hat Enterprise Linux 9.2 or higher: Install with @server group to ensure that NetworkManager
       settings are correct. Verify that the NetworkManager-config-server package is installed.

       2. A two-node cluster that is distributed across two different Power Virtual Server workspaces in two
       data centers in a region.

       3. IBM Cloud API Key: Create a service API key that is privileged for both Power Virtual Server
       workspaces. Save the service API key in a file and copy the file to both cluster nodes. Use same filename
       and directory location on both cluster nodes. Reference the path to the key file in the resource
       definition.

       For comprehensive documentation on implementing high availability for SAP applications on IBM Power
       Virtual Server, visit https://cloud.ibm.com/docs/sap?topic=sap-ha-overview.

SUPPORTED PARAMETERS

       ip
           IP address within the subnet. The IP address moves together with the subnet.

           (required, string, no default)

       cidr
           Classless Inter-Domain Routing (CIDR) of the subnet.

           (required, string, no default)

       subnet_name
           Name of the subnet. If not specified, CIDR is used as name.

           (optional, string, no default)

       api_type
           Connect to Power Virtual Server regional endpoints over a public or private network (public|private).

           (optional, string, default "private")

       region
           Region that represents the geographic area where the instance is located. The region is used to
           identify the Cloud API endpoint.

           (required, string, no default)

       api_key
           API Key or @API_KEY_FILE_PATH for IBM Cloud access. The API key content or the path of an API key
           file that is indicated by the @ symbol.

           (required, string, no default)

       crn_host_map
           Map the hostname of the Power Virtual Server instance to the CRN of the Power Virtual Server
           workspaces hosting the instance. Separate hostname and CRN with a colon ':', separate different
           hostname and CRN pairs with a semicolon ';'. Example:
           hostname01:CRN-of-Instance01;hostname02:CRN-of-Instance02

           (required, string, no default)

       vsi_host_map
           Map the hostname of the Power Virtual Server instance to its instance id. Separate hostname and
           instance id with a colon ':', separate different hostname and instance id pairs with a semicolon ';'.
           Example: hostname01:instance-id-01;hostname02:instance-id-02

           (required, string, no default)

       proxy
           Proxy server to access IBM Cloud API endpoints.

           (optional, string, no default)

       jumbo
           Create a Power Virtual Server subnet with an MTU size of 9000 (true|false).

           (optional, string, default "false")

       route_table
           ID of the route table for the interface. Default is 500.

           (optional, string, default "500")

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

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

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

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

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

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

EXAMPLE CRM SHELL

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

           primitive p_powervs-subnet ocf:heartbeat:powervs-subnet \
             params \
               ip=string \
               cidr=string \
               region=string \
               api_key=string \
               crn_host_map=string \
               vsi_host_map=string \
             op monitor timeout="60s" interval="60s" depth="0"

EXAMPLE PCS

       The following is an example configuration for a powervs-subnet resource using pcs(8)

           pcs resource create p_powervs-subnet ocf:heartbeat:powervs-subnet \
             ip=string \
             cidr=string \
             region=string \
             api_key=string \
             crn_host_map=string \
             vsi_host_map=string \
             op monitor timeout="60s" interval="60s" OCF_CHECK_LEVEL="0"

SEE ALSO

       http://clusterlabs.org/

AUTHOR

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

resource-agents 4.16.0-2ubuntu                     02/19/2025                            OCF_HEARTBEAT_POWERV(7)