This guide shows you how to configure the guest operating system (OS) on Compute Engine bare metal instances for the optimal running of SAP HANA workloads, by using Google Cloud's Agent for SAP.
To seamlessly perform the required guest OS configurations on bare metal
instances such as X4, you run the configureinstance command of
Google Cloud's Agent for SAP.
This guide is meant for SAP Basis and SAP system administrators who want to run their SAP workloads on Compute Engine bare metal instances.
Before you begin
Deploy a bare metal instance, such as X4.
For information about the Compute Engine bare metal machine types that you can use to run SAP HANA on Google Cloud, the OS versions that you can use, and information about block storage configuration, see Bare metal machine types for SAP HANA.
For information about how to deploy a bare metal instance, see Create a bare metal instance from a public image.
Make sure that version 3.6 (latest) of Google Cloud's Agent for SAP is installed on your bare metal instance.
For information about how to install the agent on a compute instance, see Install and configure Google Cloud's Agent for SAP on a Compute Engine instance.
Configure the guest OS on your bare metal instance
Connect to your bare metal instance by using SSH or your preferred method.
Check whether the OS on your bare metal instance is optimally configured to run SAP HANA workloads:
sudo /usr/bin/google_cloud_sap_agent configureinstance -check
The command output informs if any OS configurations are needed. For information about the OS packages that X4 instances need to run SAP HANA, see the following file in the agent's read-only repository on GitHub: GoogleCloudPlatform/sapagent/internal/onetime/configureinstance/configurex4.go.
If the preceding command output mentions that OS configurations are required, then apply them:
sudo /usr/bin/google_cloud_sap_agent configureinstance -apply
Restart your bare metal instance.
Optionally, to view information about the OS configurations that the agent performed on your bare metal instance, see the following log file:
/var/log/google-cloud-sap-agent/configureinstance.log
Disable hyperthreading for an X4 instance
In some scenarios, you can improve the performance of OLTP based SAP HANA workloads by disabling hyperthreading on the underlying X4 instances. For more information, see Hyperthreading.
To disable hyperthreading for your X4 instance by using Google Cloud's Agent for SAP, complete the following steps:
Connect to your X4 instance by using SSH or your preferred method.
Disable hyperthreading for your X4 instance:
sudo /usr/bin/google_cloud_sap_agent configureinstance -apply -hyperThreading="off"
Restart your X4 instance.