/amazon-ec2-hibinit-agent

Primary LanguageShellApache License 2.0Apache-2.0

The Amazon Linux hibernation agent.

The purpose of this agent is to create a setup for an instance to support hibernation feature. The setup is created only on supported instance types. This agent does several things:

  1. Upon startup it checks for sufficient swap space to allow hibernate and fails if it's present but there's not enough of it.
  2. If there's no swap space, it launches a background thread to create it and touch all of its blocks to make sure that EBS volumes are pre-warmed if configured.This is configurable.
  3. It updates the offset of the swap file in the kernel using SNAPSHOT_SET_SWAP_AREA ioctl.
  4. It updates the resume offset and resume device in grub file.

Building in Red hat

1- Install Development Tools in Red Hat to build the RPM package

sudo dnf group install "Development Tools"
mkdir -p ~/rpmbuild/{BUILD,BUILDROOT,RPMS,SOURCES,SPECS,SRPMS}

2- Install required build packages for ec2-hibernate-linux-agent.

sudo yum install python3-devel
sudo yum install selinux-policy-devel

3- Download the package from github repository. You can replace 1.0.3 with any release version number.

echo '%_topdir %(echo $HOME)/rpmbuild' > ~/.rpmmacros
wget https://github.com/aws/amazon-ec2-hibinit-agent/archive/v1.0.3/ec2-hibinit-agent-1.0.3.tar.gz
tar -xf ec2-hibinit-agent-1.0.3.tar.gz 

4- Copy spec file to SPEC directory.

cd ~/rpmbuild//SPECS
cp ~/rpmbuild/SOURCES/amazon-ec2-hibinit-agent-1.0.3/packaging/rhel/ec2-hibinit-agent.spec ~/rpmbuild/SPECS/

5- Build the Spec file

nohup rpmbuild -bb --target=noarch ec2-hibinit-agent.spec

You will find the RPM package generated at ~/rpmbuild/RPMS/noarch/ directory

Building in SUSE Linux

1- Install Development Tools in Suse Linux to build the RPM package

sudo zypper install rpm-build
mkdir -p ~/rpmbuild/{BUILD,BUILDROOT,RPMS,SOURCES,SPECS,SRPMS}

2- Install required build packages for ec2-hibernate-linux-agent.

sudo zypper install python3-devel
sudo zypper install tuned
sudo zypper install python-rpm-generators

3- Download the package from github repository. You can replace 1.0.3 with any release version number.

echo '%_topdir %(echo $HOME)/rpmbuild' > ~/.rpmmacros
cd ~/rpmbuild/SOURCES
wget https://github.com/aws/amazon-ec2-hibinit-agent/archive/v1.0.3/ec2-hibinit-agent-1.0.3.tar.gz
tar -xf ec2-hibinit-agent-1.0.3.tar.gz 

4- Copy spec file to SPEC directory. You can replace 1.0.3 with any release version number.

cd ~/rpmbuild//SPECS
cp ~/rpmbuild/SOURCES/amazon-ec2-hibinit-agent-1.0.3/packaging/sles/ec2-hibinit-agent.spec ~/rpmbuild/SPECS/

5- Build the Spec file

nohup rpmbuild -bb --target=noarch ec2-hibernate-linux-agent.spec

You will find the RPM package generated at ~/rpmbuild/RPMS/noarch/ directory