ocf_heartbeat_aws-vpc-move-ip - Man Page
Move IP within a VPC of the AWS EC2
Synopsis
aws-vpc-move-ip [start | stop | monitor | meta-data | validate-all]
Description
Resource Agent to move IP addresses within a VPC of the Amazon Webservices EC2 by changing an entry in an specific routing table
Credentials needs to be setup by running "aws configure", or by using AWS Policies.
See https://aws.amazon.com/cli/ for more information about awscli.
Supported Parameters
- awscli
Path to command line tools for AWS
(optional, string, default "/usr/bin/aws")
- auth_type
Authentication type "key" for AccessKey and SecretAccessKey set via "aws configure", or "role" to use AWS Policies.
(optional, string, default "key")
- profile
Valid AWS CLI profile name (see ~/.aws/config and 'aws configure')
(optional, string, default "default")
- region
Valid AWS region name (e.g., 'us-west-2')
(optional, string, no default)
- ip
VPC private IP address
(required, string, no default)
- address
Deprecated IP address param. Use the ip param instead.
(optional, string, no default)
- routing_table
Name of the routing table(s), where the route for the IP address should be changed. If declaring multiple routing tables they should be separated by comma. Example: rtb-XXXXXXXX,rtb-YYYYYYYYY
(required, string, no default)
- routing_table_role
Role to use to query/update the route table
(optional, string, no default)
- interface
Name of the network interface, i.e. eth0
(required, string, default "eth0")
- iflabel
You can specify an additional label for your IP address here. This label is appended to your interface name.
The kernel allows alphanumeric labels up to a maximum length of 15 characters including the interface name and colon (e.g. eth0:foobar1234)
(optional, string, no default)
- monapi
Enable enhanced monitoring using AWS API calls to check route table entry
(optional, boolean, default false)
- lookup_type
Name of resource type to lookup in route table. "InstanceId" : EC2 instance ID. (default) "NetworkInterfaceId" : ENI ID. (useful in shared VPC setups).
(optional, string, default "InstanceId")
- curl_retries
curl retries before failing
(optional, integer, default 3)
- curl_sleep
curl sleep between tries
(optional, integer, default 1)
Supported Actions
This resource agent supports the following actions (operations):
- start
Starts the resource. Suggested minimum timeout: 180s.
- stop
Stops the resource. Suggested minimum timeout: 180s.
- monitor
Performs a detailed status check. Suggested minimum timeout: 30s. Suggested interval: 60s.
- 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 aws-vpc-move-ip resource using the crm(8) shell:
primitive p_aws-vpc-move-ip ocf:heartbeat:aws-vpc-move-ip \ params \ ip=string \ routing_table=string \ interface="eth0" \ op monitor depth="0" timeout="30s" interval="60s"
Example PCS
The following is an example configuration for a aws-vpc-move-ip resource using pcs(8)
pcs resource create p_aws-vpc-move-ip ocf:heartbeat:aws-vpc-move-ip \ ip=string \ routing_table=string \ interface="eth0" \ op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="60s"
See Also
Author
ClusterLabs contributors (see the resource agent source for information about individual authors)