---
name: "ocf_heartbeat_powervs-subnet"
section: "7"
platform: "linux"
package: "resource-agents"
version: "1:4.16.0-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ocf_heartbeat_powervs-subnet"
---

# ocf\_heartbeat\_powervs-subnet(7)

Manages moving a Power Virtual Server subnet

## 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)](/crm/8.md) 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/8.md)

```
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)**