Ce contenu n'est pas disponible dans la langue sélectionnée.
Chapter 4. Configuring a Red Hat High Availability cluster on AWS
To redistribute workloads automatically in case of node failure, you can create Red Hat High Availability (HA) clusters on Amazon Web Services (AWS). Even on AWS, you can host these HA clusters.
Creating RHEL HA clusters on AWS is similar to creating HA clusters in non-cloud environments. For details on image options for AWS, see Red Hat Enterprise Linux Image Options on AWS.
4.1. Benefits of using high-availability clusters on public cloud platforms Copier lienLien copié sur presse-papiers!
A high-availability (HA) cluster is a set of computers, also known as nodes, linked together to run a specific workload. The purpose of HA clusters is to offer redundancy in case of a hardware or software failure. If a node in the HA cluster fails, the Pacemaker cluster resource manager distributes the workload to other nodes. No noticeable downtime occurs in the services that are running on the cluster.
You can also run HA clusters on public cloud platforms. In this case, you would use virtual machine (VM) instances in the cloud as the individual cluster nodes. Using HA clusters on a public cloud platform has the following benefits:
- Improved availability: In case of a VM failure, the workload is quickly redistributed to other nodes, so running services are not disrupted.
- Scalability: You can start additional nodes when demand is high and stop them when demand is low.
- Cost-effectiveness: With the pay-as-you-go pricing, you pay only for nodes that are running.
- Simplified management: Some public cloud platforms offer management interfaces to make configuring HA clusters easier.
To enable HA on your Red Hat Enterprise Linux (RHEL) systems, Red Hat offers a High Availability Add-On. The High Availability Add-On provides all necessary components for creating HA clusters on RHEL systems. The components include high availability service management and cluster administration tools.
4.2. Creating the AWS Access Key and AWS Secret Access Key Copier lienLien copié sur presse-papiers!
Before installing the AWS CLI, you must create an AWS Access Key and AWS Secret Access Key. The fencing and resource agent APIs use the AWS Access Key and Secret Access Key to connect to each node in the cluster.
Prerequisites
- You have a Red Hat Customer Portal account.
- You have created an AWS account and set up AWS resources. See Setting Up with Amazon EC2 for more information.
- Your IAM user account must have Programmatic access. See Setting up the AWS Environment for more information.
Procedure
- Launch the AWS Console.
- Click on your AWS Account ID to display the drop-down menu and select My Security Credentials.
- Click Users.
- Select the user and open the Summary screen.
- Click the Security credentials tab.
- Click Create access key.
-
Download the
.csvfile (or save both keys). You need to enter these keys when creating the fencing device.
4.3. Creating an HA EC2 instance Copier lienLien copié sur presse-papiers!
To ensure High Availability (HA) for your Red Hat Enterprise Linux (RHEL) cluster nodes and applications in Amazon Web Services (AWS), you can create HA EC2 instances configured as cluster nodes.
For details about obtaining RHEL images, see Image options on AWS.
Prerequisites
- You have a Red Hat Customer Portal account.
- You have created an AWS account and set up AWS resources. See Setting Up with Amazon EC2 for more information.
Procedure
- From the AWS EC2 Dashboard, select Images and then AMIs.
- Right-click the image you want to use and select Launch.
Choose an Instance Type that meets or exceeds the requirements of your workload. Depending on your HA application, each instance requires different capacity.
See Amazon EC2 Instance Types for information about instance types.
Click Next: Configure Instance Details.
Enter the Number of instances you want to create for the cluster. This example procedure uses three cluster nodes.
NoteDo not launch into an Auto Scaling Group.
- For Network, select the virtual private cloud (VPC) you created in Set up the AWS environment. Select the subnet for the instance to create a new subnet.
Select Enable for Auto-assign Public IP. These are the minimum selections you need to make for Configure Instance Details. Depending on your specific HA application, you can make additional selections.
NoteThese are the minimum configuration options necessary to create a basic instance. Review additional options based on your HA application requirements.
- Click Next: Add Storage and verify that you have required storage for your HA application. You do not need to change these settings, unless your HA application requires other storage options.
- Click Next: Configure Security Group. Select the existing security group you created in Setting up the AWS environment.
- Click Review and Launch and verify your selections.
- Click Launch. Select an existing key pair or create a new key pair. For selecting a key pair, see Setting up the AWS environment.
- Click Launch Instances.
Click View Instances. You can name the instance(s).
NoteAlso, you can launch instances by using the AWS CLI. See Launching, Listing, and Terminating Amazon EC2 Instances in the Amazon documentation for more information.
4.4. Configuring the private key Copier lienLien copié sur presse-papiers!
Before using the the private SSH key file (.pem) for SSH communication, you need to configure permissions of the private key.
Prerequisites
- Sign up for a Red Hat Customer Portal account.
- Sign up for AWS and set up your AWS resources. See Setting Up with Amazon EC2 for more information.
Procedure
-
Move the key file from the
Downloadsdirectory to yourHomedirectory or to your~/.sshdirectory. Change the permissions of the key file so that only the root user can read it:
# chmod 400 KeyName.pem
4.5. Connecting to an EC2 instance Copier lienLien copié sur presse-papiers!
Using the AWS Console on all nodes, you can connect to an EC2 instance.
Prerequisites
- You have a Red Hat Customer Portal account.
- You have created an AWS account and set up AWS resources. See Setting Up with Amazon EC2 for more information.
Procedure
- Launch the AWS Console and select the EC2 instance.
- Click Connect and select A standalone SSH client.
-
From your SSH terminal session, connect to the instance by using the AWS example provided in the pop-up window. Add the correct path to your
KeyName.pemfile if the path is not shown in the example.
4.6. Installing the High Availability packages and agents Copier lienLien copié sur presse-papiers!
Before configuring a Red Hat High Availability cluster on AWS, you must install the High Availability packages and agents on each of the nodes.
Prerequisites
- You have a Red Hat Customer Portal account.
- You have created an AWS account and set up AWS resources. See Setting Up with Amazon EC2 for more information.
Procedure
Remove the AWS Red Hat Update Infrastructure (RHUI) client.
$ sudo -i # yum -y remove rh-amazon-rhui-client*Register the VM with Red Hat.
# subscription-manager registerDisable all repositories.
# subscription-manager repos --disable=*Enable the RHEL 8 Server HA repositories.
# subscription-manager repos --enable=rhel-8-for-x86_64-highavailability-rpmsUpdate the RHEL AWS instance.
# yum update -yInstall the Red Hat High Availability Add-On software packages, along with the AWS fencing agent from the High Availability channel.
# yum install pcs pacemaker fence-agents-awsThe user
haclusterwas created during thepcsandpacemakerinstallation in the previous step. Create a password forhaclusteron all cluster nodes. Use the same password for all nodes.# passwd haclusterAdd the
high availabilityservice to the RHEL Firewall iffirewalld.serviceis installed.# firewall-cmd --permanent --add-service=high-availability # firewall-cmd --reloadStart the
pcsservice and enable it to start on boot.# systemctl start pcsd.service # systemctl enable pcsd.service-
Edit
/etc/hostsand add RHEL host names and internal IP addresses. For more information, see the Red Hat Knowledgebase solution How should the /etc/hosts file be set up on RHEL cluster nodes?.
Verification
Ensure the
pcsservice is running.# systemctl status pcsd.service pcsd.service - PCS GUI and remote configuration interface Loaded: loaded (/usr/lib/systemd/system/pcsd.service; enabled; vendor preset: disabled) Active: active (running) since Thu 2018-03-01 14:53:28 UTC; 28min ago Docs: man:pcsd(8) man:pcs(8) Main PID: 5437 (pcsd) CGroup: /system.slice/pcsd.service └─5437 /usr/bin/ruby /usr/lib/pcsd/pcsd > /dev/null & Mar 01 14:53:27 ip-10-0-0-48.ec2.internal systemd[1]: Starting PCS GUI and remote configuration interface… Mar 01 14:53:28 ip-10-0-0-48.ec2.internal systemd[1]: Started PCS GUI and remote configuration interface.
4.7. Creating a cluster Copier lienLien copié sur presse-papiers!
Create a Red Hat High Availability cluster on a public cloud platform by configuring and initializing the cluster nodes.
Procedure
On one of the nodes, enter the following command to authenticate the pcs user
hacluster. In the command, specify the name of each node in the cluster.# pcs host auth <hostname1> <hostname2> <hostname3>Example:
[root@node01 clouduser]# pcs host auth node01 node02 node03 Username: hacluster Password: node01: Authorized node02: Authorized node03: AuthorizedCreate the cluster.
# pcs cluster setup <cluster_name> <hostname1> <hostname2> <hostname3>Example:
[root@node01 clouduser]# pcs cluster setup new_cluster node01 node02 node03 [...] Synchronizing pcsd certificates on nodes node01, node02, node03... node02: Success node03: Success node01: Success Restarting pcsd on the nodes in order to reload the certificates... node02: Success node03: Success node01: Success
Verification
Enable the cluster.
[root@node01 clouduser]# pcs cluster enable --all node02: Cluster Enabled node03: Cluster Enabled node01: Cluster EnabledStart the cluster.
[root@node01 clouduser]# pcs cluster start --all node02: Starting Cluster... node03: Starting Cluster... node01: Starting Cluster...
4.8. Configuring fencing on a RHEL AWS cluster Copier lienLien copié sur presse-papiers!
Fencing configuration automatically isolates a malfunctioning node on your Red Hat Enterprise Linux (RHEL) Amazon Web Services (AWS) cluster to prevent the node from compromising functionality and consuming the resources of the cluster.
To configure fencing on an AWS cluster, use one of the following methods:
- A standard procedure for default configuration.
- An alternate configuration procedure for more advanced configuration, focused on automation.
4.8.1. Configuring fencing with default settings Copier lienLien copié sur presse-papiers!
Fencing isolates malfunctioned or unresponsive nodes for data integrity and cluster availability by using Amazon Web Services (AWS) resources and cluster management tools for automated node management. A standard approach for configuring fencing with default settings in a Red Hat Enterprise Linux (RHEL) high availability cluster on Amazon Web Services (AWS).
Prerequisites
-
You have installed the
resource-agentspackage on nodes to enable thefence_awsfencing agent in the cluster. - You have set up your AWS Access Key and AWS Secret Access Key. See link: Creating the AWS Access Key and AWS Secret Access Key for more information.
Procedure
Enter the following AWS metadata query to get the Instance ID for each node. You need these IDs to configure the fence device. See Instance Metadata and User Data for additional information.
# echo $(curl -s http://169.254.169.254/latest/meta-data/instance-id)Example:
[root@ip-10-0-0-48 ~]# echo $(curl -s http://169.254.169.254/latest/meta-data/instance-id) i-07f1ac63af0ec0ac6Enter the following command to configure the fence device. Use the
pcmk_host_mapcommand to map the RHEL hostname to the Instance ID. Use the AWS Access Key and AWS Secret Access Key that you earlier set up.# pcs stonith \ create <name> fence_aws access_key=access-key secret_key=<secret-access-key> \ region=<region> pcmk_host_map="rhel-hostname-1:Instance-ID-1;rhel-hostname-2:Instance-ID-2;rhel-hostname-3:Instance-ID-3" \ power_timeout=240 pcmk_reboot_timeout=480 pcmk_reboot_retries=4Example:
[root@ip-10-0-0-48 ~]# pcs stonith \ create clusterfence fence_aws access_key=AKIAI123456MRMJA secret_key=a75EYIG4RVL3hdsdAslK7koQ8dzaDyn5yoIZ/ \ region=us-east-1 pcmk_host_map="ip-10-0-0-48:i-07f1ac63af0ec0ac6;ip-10-0-0-46:i-063fc5fe93b4167b2;ip-10-0-0-58:i-08bd39eb03a6fd2c7" \ power_timeout=240 pcmk_reboot_timeout=480 pcmk_reboot_retries=4- To ensure immediate and complete fencing, disable ACPI Soft-Off on all cluster nodes. For information about disabling ACPI Soft-Off, see Testing a fence device
4.8.2. Configuring fencing for a VPC cluster Copier lienLien copié sur presse-papiers!
An alternate approach for configuring fencing for a virtual private cloud (VPC) cluster in a Red Hat Enterprise Linux (RHEL) high availability cluster on Amazon Web Services (AWS). Fencing isolates malfunctioned or unresponsive nodes to keep data integrity and cluster availability, using AWS resources and cluster management tools for automated node management.
Prerequisites
-
You have installed the
resource-agentspackage on nodes to enable thefence_awsfencing agent in the cluster. - You have set up your AWS Access Key and AWS Secret Access Key. See Creating the AWS Access Key and AWS Secret Access Key for more information.
Procedure
Obtain the VPC ID of the cluster.
$ aws ec2 describe-vpcs --output text --filters "Name=tag:Name,Values=<clustername>-vpc" --query 'Vpcs[*].VpcId' vpc-06bc10ac8f6006664By using the VPC ID of the cluster, obtain the VPC instances.
$ aws ec2 describe-instances --output text --filters "Name=vpc-id,Values=vpc-06bc10ac8f6006664" --query 'Reservations[*].Instances[*].{Name:Tags[?Key==Name]|[0].Value,Instance:InstanceId}' | grep "\-node[a-c]" i-0b02af8927a895137 <clustername>-nodea-vm i-0cceb4ba8ab743b69 <clustername>-nodeb-vm i-0502291ab38c762a5 <clustername>-nodec-vmUse the obtained instance IDs to configure fencing on each node on the cluster. For example, to configure a fencing device on all nodes in a cluster:
[root@nodea ~]# CLUSTER=<clustername> && pcs stonith create fence${CLUSTER} fence_aws access_key=XXXXXXXXXXXXXXXXXXXX pcmk_host_map=$(for NODE \ in node{a..c}; do ssh ${NODE} "echo -n \${HOSTNAME}:\$(curl -s http://169.254.169.254/latest/meta-data/instance-id)\;"; done) \ pcmk_reboot_retries=4 pcmk_reboot_timeout=480 power_timeout=240 region=xx-xxxx-x secret_key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXFor information about specific parameters for creating fencing devices, see the
fence_awsman page or the Configuring and managing high availability clusters guide.- To ensure immediate and complete fencing, disable ACPI Soft-Off on all cluster nodes. For information about disabling ACPI Soft-Off, see Disabling ACPI for use with integrated fence device.
Verification
Display the configured fencing devices and their parameters on your nodes:
[root@nodea ~]# pcs stonith config fence${CLUSTER} Resource: <clustername> (class=stonith type=fence_aws) Attributes: access_key=XXXXXXXXXXXXXXXXXXXX pcmk_host_map=nodea:i-0b02af8927a895137;nodeb:i-0cceb4ba8ab743b69;nodec:i-0502291ab38c762a5; pcmk_reboot_retries=4 pcmk_reboot_timeout=480 power_timeout=240 region=xx-xxxx-x secret_key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Operations: monitor interval=60s (<clustername>-monitor-interval-60s)Test the fencing agent for one of the cluster nodes.
# pcs stonith fence <awsnodename>NoteThe command response might take several minutes to display. If you check the active terminal session for the fencing node, you might see the connection to the terminal drop immediately after you enter the fence command.
Example:
[root@ip-10-0-0-48 ~]# pcs stonith fence ip-10-0-0-58 Node: ip-10-0-0-58 fencedCheck the status of the fenced node:
# pcs statusExample:
[root@ip-10-0-0-48 ~]# pcs status Cluster name: newcluster Stack: corosync Current DC: ip-10-0-0-46 (version 1.1.18-11.el7-2b07d5c5a9) - partition with quorum Last updated: Fri Mar 2 19:55:41 2018 Last change: Fri Mar 2 19:24:59 2018 by root via cibadmin on ip-10-0-0-46 3 nodes configured 1 resource configured Online: [ ip-10-0-0-46 ip-10-0-0-48 ] OFFLINE: [ ip-10-0-0-58 ] Full list of resources: clusterfence (stonith:fence_aws): Started ip-10-0-0-46 Daemon Status: corosync: active/disabled pacemaker: active/disabled pcsd: active/enabledStart the fenced node from the earlier step:
# pcs cluster start <awshostname>Check the status to verify the node started.
# pcs statusExample:
[root@ip-10-0-0-48 ~]# pcs status Cluster name: newcluster Stack: corosync Current DC: ip-10-0-0-46 (version 1.1.18-11.el7-2b07d5c5a9) - partition with quorum Last updated: Fri Mar 2 20:01:31 2018 Last change: Fri Mar 2 19:24:59 2018 by root via cibadmin on ip-10-0-0-48 3 nodes configured 1 resource configured Online: [ ip-10-0-0-46 ip-10-0-0-48 ip-10-0-0-58 ] Full list of resources: clusterfence (stonith:fence_aws): Started ip-10-0-0-46 Daemon Status: corosync: active/disabled pacemaker: active/disabled pcsd: active/enabled
4.9. Installing the AWS CLI on cluster nodes Copier lienLien copié sur presse-papiers!
Earlier, you installed the AWS CLI on your host system. You need to install the AWS CLI on cluster nodes to configure the network resource agents. The following steps are applicable to each node in the cluster.
Prerequisites
- You have a Red Hat Customer Portal account.
- You have created an AWS account and set up AWS resources. See Setting Up with Amazon EC2 for more information.
- You have created AWS Access Key and Secret Key.
- You have set up the AWS CLI. For details, see Installing the AWS CLI.
Procedure
Verify that the AWS CLI is configured correctly where the instance IDs and instance names should be displayed:
Example:
[root@ip-10-0-0-48 ~]# aws ec2 describe-instances --output text --query 'Reservations[*].Instances[*].[InstanceId,Tags[?Key==Name].Value]' i-07f1ac63af0ec0ac6 ip-10-0-0-48 i-063fc5fe93b4167b2 ip-10-0-0-46 i-08bd39eb03a6fd2c7 ip-10-0-0-58
4.10. Setting up IP address resources on AWS Copier lienLien copié sur presse-papiers!
To ensure that clients that use IP addresses to access resources managed by the cluster over the network can access the resources if a failover occurs, the cluster must include IP address resources, which use specific network resource agents.
The RHEL HA Add-On provides a set of resource agents, which create IP address resources to manage various types of IP addresses on AWS. To decide which resource agent to configure, consider the type of AWS IP addresses that you want the HA cluster to manage:
-
To manage an IP address exposed to the internet, use the
awseipnetwork resource. -
To manage a private IP address limited to a single AWS Availability Zone (AZ), use the
awsvipandIPaddr2network resources. -
To manage an IP address that can move across multiple AWS AZs within the same AWS region, use the
aws-vpc-move-ipnetwork resource.
If the HA cluster does not manage any IP addresses, the resource agents for managing virtual IP addresses on AWS are not required. If you need further guidance for your specific deployment, consult with your AWS provider.
4.10.1. Creating an IP address resource to manage an IP address exposed to the internet Copier lienLien copié sur presse-papiers!
Configure an Amazon Web Services (AWS) Secondary Elastic IP Address (awseip) resource. Use an elastic IP address for public-facing internet connections on Red Hat Enterprise Linux (RHEL) High Availability (HA) cluster nodes.
Prerequisites
- You have a Red Hat Customer Portal account.
- You have created an AWS account and set up AWS resources. See Setting Up with Amazon EC2 for more information.
- Your cluster nodes have access to the RHEL HA repositories. For details, see Installing the High Availability packages and agents.
- You have configured a cluster.
- You have set up the AWS CLI.
Procedure
Install the
resource-agentspackage.# yum install resource-agentsUsing the AWS command-line interface (CLI), create an elastic IP address.
[root@ip-10-0-0-48 ~]# aws ec2 allocate-address --domain vpc --output text eipalloc-4c4a2c45 vpc 35.169.153.122Optional: Display the description of
awseip. This shows the options and default operations for this agent.# pcs resource describe awseipCreate a resource group which has the secondary elastic IP address and allocated IP address that you earlier specified using the AWS CLI:
# pcs resource create <resource_id> awseip elastic_ip=<elastic_ip_address> allocation_id=<elastic_ip_association_id> --group <resource_group_name>
Verification
Display the status of the cluster to verify that the required resources are running.
# pcs statusThe following output shows an example running cluster where the
vipandelasticresources are part of thenetworking-groupresource group:[root@ip-10-0-0-58 ~]# pcs status Cluster name: newcluster Stack: corosync Current DC: ip-10-0-0-58 (version 1.1.18-11.el7-2b07d5c5a9) - partition with quorum Last updated: Mon Mar 5 16:27:55 2018 Last change: Mon Mar 5 15:57:51 2018 by root via cibadmin on ip-10-0-0-46 3 nodes configured 4 resources configured Online: [ ip-10-0-0-46 ip-10-0-0-48 ip-10-0-0-58 ] Full list of resources: clusterfence (stonith:fence_aws): Started ip-10-0-0-46 Resource Group: networking-group vip (ocf::heartbeat:IPaddr2): Started ip-10-0-0-48 elastic (ocf::heartbeat:awseip): Started ip-10-0-0-48 Daemon Status: corosync: active/disabled pacemaker: active/disabled pcsd: active/enabledLaunch an SSH session from your local workstation to the elastic IP address that you created earlier:
$ ssh -l <user_name> -i ~/.ssh/<keyname>.pem <elastic_ip_address>Example:
$ ssh -l ec2-user -i ~/.ssh/cluster-admin.pem 35.169.153.122
Verification
- Verify that the SSH connected host is the same host as the one associated with the elastic resource created.
4.10.2. Creating an IP address resource to manage a private IP address limited to a single AWS availability zone Copier lienLien copié sur presse-papiers!
Configure an Amazon Web Services (AWS) secondary private IP address (awsvip) resource on a node of a Red Hat High Availability (HA) cluster. Use awsvip to limit the IP address to a single availability zone and HA clients.
You can connect and access HA clients to a Red Hat Enterprise Linux (RHEL) node that uses the private IP address.
Prerequisites
- You have a Red Hat Customer Portal account.
- You have created an AWS account and set up AWS resources. See Setting Up with Amazon EC2 for more information.
- You have configured a cluster.
- Your cluster nodes have access to the RHEL HA repositories. For details, see Installing the High Availability packages and agents.
- You have set up the AWS CLI. For instructions, see Installing the AWS CLI.
Procedure
Install the
resource-agentspackage.# yum install resource-agentsOptional: View the
awsvipdescription. This shows the options and default operations for this agent.# pcs resource describe awsvipCreate a secondary private IP address with an unused private IP address in the virtual private cloud (VPC) classless inter-domain routing (CIDR)
VPC CIDRblock. In addition, create a resource group for the secondary private IP address:# pcs resource create <example_resource_id> awsvip secondary_private_ip=<example_unused_private_IP_address> --group <example_group_name>Example:
[root@ip-10-0-0-48 ~]# pcs resource create privip awsvip secondary_private_ip=10.0.0.68 --group networking-groupCreate a virtual IP resource. This is a VPC IP address that can be rapidly remapped from the fenced node to the failover node, masking the failure of the fenced node within the subnet. Ensure that the virtual IP belongs to the same resource group as the Secondary Private IP address you created in the earlier step:
# pcs resource create <example_resource_id> IPaddr2 ip=<example_secondary_private_IP> --group <example_group_name>Example:
root@ip-10-0-0-48 ~]# pcs resource create vip IPaddr2 ip=10.0.0.68 --group networking-groupVerification
Display the status of the cluster to verify that the required resources are running.
# pcs statusThe following output shows an example running cluster where the
vipandprivipresources are active in a thenetworking-groupresource group:[root@ip-10-0-0-48 ~]# pcs status Cluster name: newcluster Stack: corosync Current DC: ip-10-0-0-46 (version 1.1.18-11.el7-2b07d5c5a9) - partition with quorum Last updated: Fri Mar 2 22:34:24 2018 Last change: Fri Mar 2 22:14:58 2018 by root via cibadmin on ip-10-0-0-46 3 nodes configured 3 resources configured Online: [ ip-10-0-0-46 ip-10-0-0-48 ip-10-0-0-58 ] Full list of resources: clusterfence (stonith:fence_aws): Started ip-10-0-0-46 Resource Group: networking-group privip (ocf::heartbeat:awsvip): Started ip-10-0-0-48 vip (ocf::heartbeat:IPaddr2): Started ip-10-0-0-58 Daemon Status: corosync: active/disabled pacemaker: active/disabled pcsd: active/enabled
4.10.3. Creating an IP address resource to manage an IP address that can move across multiple AWS Availability Zones Copier lienLien copié sur presse-papiers!
Configure an aws-vpc-move-ip resource to use an elastic IP address. You can use this resource to ensure high-availability (HA) clients on Amazon Web Services (AWS) can access a Red Hat Enterprise Linux (RHEL) node that can be moved across multiple AWS Availability Zones within the same AWS region.
Prerequisites
- You have a Red Hat Customer Portal account.
- You have created an AWS account and set up AWS resources. See Setting Up with Amazon EC2 for more information.
- You have configured a cluster.
- Your cluster nodes have access to the RHEL HA repositories. For more information, see Installing the High Availability packages and agents.
- You have set up the AWS CLI. For instructions, see Installing the AWS CLI.
An Identity and Access Management (IAM) user is configured on your cluster and has the following permissions:
- Modify routing tables
- Create security groups
- Create IAM policies and roles
Procedure
Install the
resource-agentspackage.# yum install resource-agentsOptional: View the
aws-vpc-move-ipdescription. This shows the options and default operations for this agent.# pcs resource describe aws-vpc-move-ipSet up an
OverlayIPAgentIAM policy for the IAM user.-
In the AWS console, navigate to Services
IAM Policies Create OverlayIPAgentPolicy Input the following configuration, and change the <region>, <account-id>, and <ClusterRouteTableID> values to correspond with your cluster.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "Stmt1424870324000", "Effect": "Allow", "Action": "ec2:DescribeRouteTables", "Resource": "*" }, { "Sid": "Stmt1424860166260", "Action": [ "ec2:CreateRoute", "ec2:ReplaceRoute" ], "Effect": "Allow", "Resource": "arn:aws:ec2:<region>:<account-id>:route-table/<ClusterRouteTableID>" } ] }
-
In the AWS console, navigate to Services
In the AWS console, disable the
Source/Destination Checkfunction on all nodes in the cluster.To do this, right-click each node
Networking Change Source/Destination Checks. In the pop-up message that appears, click Yes, Disable. Create a route table for the cluster. To do so, use the following command on one node in the cluster:
# aws ec2 create-route --route-table-id <ClusterRouteTableID> --destination-cidr-block <NewCIDRblockIP/NetMask> --instance-id <ClusterNodeID>In the command, replace values as follows:
-
ClusterRouteTableID: The route table ID for the existing cluster VPC route table. -
NewCIDRblockIP/NetMask: A new IP address and netmask outside of the VPC classless inter-domain routing (CIDR) block. For example, if the VPC CIDR block is172.31.0.0/16, the new IP address/netmask can be192.168.0.15/32. -
ClusterNodeID: The instance ID for another node in the cluster.
-
On one of the nodes in the cluster, create a
aws-vpc-move-ipresource that uses a free IP address that is accessible to the client. The following example creates a resource namedvpcipthat uses IP192.168.0.15.# pcs resource create vpcip aws-vpc-move-ip ip=192.168.0.15 interface=eth0 routing_table=<ClusterRouteTableID>On all nodes in the cluster, edit the
/etc/hosts/file, and add a line with the IP address of the newly created resource. For example:192.168.0.15 vpcip
Verification
Test the failover ability of the new
aws-vpc-move-ipresource:# pcs resource move vpcipIf the failover succeeded, remove the automatically created constraint after the move of the
vpcipresource:# pcs resource clear vpcip