--- title: "Deploy an SAP system infrastructure on VMware on OVHcloud solution with Terraform" description: "This guide provides instructions for using the SAP system Terraform module developed by OVHcloud" url: https://docs.ovhcloud.com/pl/guides/hosted-private-cloud/sap-on-ovhcloud/cookbook-terraform-sap-system lang: pl lastUpdated: 2023-09-05 --- # Deploy an SAP system infrastructure on VMware on OVHcloud solution with Terraform ## Objective This guide provides instructions for using the SAP system Terraform module developed by OVHcloud to deploy an SAP system infrastructure (as Central Services, Application Servers, SAProuters and SAP HANA databases) on VMware on OVHcloud solution. ## Requirements - Access to the OVHcloud Control Panel. - [VMware on OVHcloud solution](https://www.ovhcloud.com/pl/enterprise/products/hosted-private-cloud/) deployed. - Terraform binary (version >= 1.4). ## Instructions ### Terraform user creation To be able to manage resources (create, modify, destroy) on your VMware on OVHcloud solution, we advise you to create a dedicated user with limited rights. The following rights are mandatory to use this Terraform module: | Right | Role | | ------------------------ | ---------- | | vSphere access | Read/Write | | Access to the VM Network | Operator | | Access to the V(X)LANs | Operator | ### Terraform binary This module has been written to be compatible with Terraform v1.4 or higher. To discover how to install Terraform, please refer to the [official documentation](https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli) available on Hashicorp. ### Usage of the Terraform module Several examples are available in the [GitHub repository](https://github.com/ovh/terraform-vsphere-sap-system/tree/master/examples/) to deploy an SAP system infrastructure. Three main files are required to use as expected this Terraform module: - main.tf - outputs.tf - versions.tf #### main.tf This file contains the code to call the SAP system Terraform module developed by OVHcloud. - The block "provider" is needed to be able to interact with your VMware on OVHcloud solution. - The first "block" module regroups all variables that you want to pass to the SAP Application Servers Terraform module developed by OVHcloud. - The second "block" module regroups all variables that you want to pass to the SAP HANA databases Terraform module developed by OVHcloud. ```python provider "vsphere" { vsphere_server = "pcc-xx-xx-xx-xx.ovh.com" } module "sap-application-server" { source = "github.com/ovh/terraform-vsphere-sap-application-server.git?ref=v1.0.0" sap_application_server_datastore = "ssd-xxxxxx" sap_application_servers = [ { "name" = "terraform-vm-1", "model" = "", "cpus" = "2", "cpus_per_socket" = "2", "memory" = "1024", "custom_disks" = false, "disks" = [], "networks" = ["VLAN20"], "guest_id" = "sles15_64Guest", "vsphere_content_library" = "", "template" = "", "iso_datastore" = "", "iso_path" = "", "vapp_options" = {} } ] vsphere_compute_cluster = "Cluster1" vsphere_datacenter = "pcc-xx-xx-xx-xx_datacenterxxxx" } module "sap-hana-database" { source = "github.com/ovh/terraform-vsphere-sap-hana-database.git?ref=v1.0.0" sap_hana_database_datastore = "vsanDatastore" sap_hana_database_thin_datastore_policy = "vSAN Default Storage Policy" sap_hana_database_thick_datastore_policy = "SAP HANA VM Storage Policy" sap_hana_databases = [ { "name" = "terraform-vm-hana-1", "model" = "S", "cpus" = "", "cpus_per_socket" = "24", "memory" = "", "custom_disks" = false, "scsi_controller_count" = "", "disks" = [] "networks" = ["VLAN20"], "guest_id" = "sles15_64Guest", "vsphere_content_library" = "", "template" = "", "iso_datastore" = "", "iso_path" = "", "vapp_options" = {} } ] vsphere_compute_cluster = "Cluster1" vsphere_datacenter = "pcc-xx-xx-xx-xx_datacenterxxxx" } ``` :::info Where "SAP HANA VM Storage Policy" has been previously created on vSphere interface with a thick provisioning policy. To know more about our recommendations about this VM Storage Policy, we advise you to read [this guide](/pl/guides/hosted-private-cloud/sap-on-ovhcloud/cookbook-sap-hana-template-vmware.md#configure-advanced-parameters). ::: To know all inputs that you can pass to this module, please refer to the README on [GitHub](https://github.com/ovh/terraform-vsphere-sap-system). You have also the possibility to create variables to avoid hard-coding it in your main.tf file. To do this, you must replace each value by a value with the syntax `var.` and create a file named variables.tf which contains the definition of each variable. Caution, the variable type must be the same as that of the variables in the SAP system Terraform module developed by OVHcloud. For example, you cannot set the type "string" for the variable `sap_hana_databases`, because in the SAP system Terraform module developed by OVHcloud this variable is a "list". In this case, the main.tf file could be like: ```python provider "vsphere" { vsphere_server = var.vsphere_server } module "sap-application-server" { source = "github.com/ovh/terraform-vsphere-sap-application-server.git?ref=v1.0.0" sap_application_server_datastore = var.sap_application_server_datastore sap_application_servers = var.sap_application_servers vsphere_compute_cluster = var.vsphere_compute_cluster vsphere_datacenter = var.vsphere_datacenter } module "sap-hana-database" { source = "github.com/ovh/terraform-vsphere-sap-hana-database.git?ref=v1.0.0" sap_hana_database_datastore = var.sap_hana_database_datastore sap_hana_database_thick_datastore_policy = var.sap_hana_database_thick_datastore_policy sap_hana_database_thin_datastore_policy = var.sap_hana_database_thin_datastore_policy sap_hana_databases = var.sap_hana_databases vsphere_compute_cluster = var.vsphere_compute_cluster vsphere_datacenter = var.vsphere_datacenter } ``` The variables.tf file should be similar to this: ```python variable "vsphere_server" { type = string description = "Name of the vSphere server" } variable "vsphere_datacenter" { type = string description = "Name of the datacenter in vSphere interface" } variable "sap_application_server_datastore" { type = string description = "Name of the datastore to store virtual machines of SAP Application Servers" } variable "vsphere_compute_cluster" { type = string description = "Name of the vSphere cluster" } variable "sap_application_servers" { type = list(any) description = "List of virtual machines of SAP Application Server wanted" } variable "sap_hana_database_datastore" { type = string description = "Name of the datastore to store virtual machines of SAP HANA database" } variable "sap_hana_database_thick_datastore_policy" { type = string description = "This Storage Policy must be a Thick provisioning" } variable "sap_hana_database_thin_datastore_policy" { type = string description = "This Storage Policy must be a Thin provisioning" } variable "sap_hana_databases" { type = list(any) description = "List of virtual machines of SAP HANA database wanted" } ``` Last, in order to avoid having to provide each value through your console, you have the possibility to create a file named terraform.tfvars in which you put all values needed by each variable. ```python # vSphere vsphere_datacenter = "pcc-xx-xx-xx-xx_datacenterxxxx" vsphere_compute_cluster = "Cluster1" vsphere_server = "pcc-xx-xx-xx-xx.ovh.com" # SAP Application Servers sap_application_server_datastore = "ssd-xxxxxx" sap_application_servers = [ { "name" = "terraform-vm-1", "model" = "", "cpus" = "2", "cpus_per_socket" = "2", "memory" = "1024", "custom_disks" = false, "disks" = [], "networks" = ["VLAN20"], "guest_id" = "sles15_64Guest", "vsphere_content_library" = "", "template" = "", "iso_datastore" = "", "iso_path" = "", "vapp_options" = {} } ] # SAP HANA databases sap_hana_database_datastore = "vsanDatastore" sap_hana_database_thick_datastore_policy = "SAP HANA VM Storage Policy" sap_hana_database_thin_datastore_policy = "vSAN Default Storage Policy" sap_hana_databases = [ { "name" = "terraform-vm-hana-1", "model" = "S", "cpus" = "", "cpus_per_socket" = "24", "memory" = "", "custom_disks" = false, "disks" = [], "networks" = ["VLAN20"], "guest_id" = "sles15_64Guest", "vsphere_content_library" = "", "template" = "", "iso_datastore" = "", "iso_path" = "", "vapp_options" = {} } ] ``` #### outputs.tf This file display information after running `terraform apply`, as your virtual machine IDs, anti-affinity rule(s) information or affinity group(s) information. To discover all outputs available in this module, please refer to the outputs.tf file on [GitHub](https://github.com/ovh/terraform-vsphere-sap-system). #### versions.tf This file allows fixing the version of binaries used during the execution of the code. This file must match the versions.tf file presents in the [GitHub repository](https://github.com/ovh/terraform-vsphere-sap-system) of this module for the release wanted. ### Execution Once your repository with these three files (minimum) is ready, you can run these following commands: ```bash terraform init terraform plan terraform apply ``` The output of the execution should be similar to this: ```python Plan: 2 to add, 0 to change, 0 to destroy. Changes to Outputs: + affinity_hosts_sap_application_servers_rules = {} + affinity_hosts_sap_hana_databases_rules = {} + anti_affinity_sap_application_servers_rule = {} + anti_affinity_sap_hana_databases_rule = {} + sap_application_servers_ids = { + terraform-vm-1 = (known after apply) } + sap_hana_databases_ids = { + terraform-vm-hana-1 = (known after apply) } module.sap-application-server.vsphere_virtual_machine.sap_application_server["terraform-vm-1"]: Creating... module.sap-hana-database.vsphere_virtual_machine.sap_hana_database["terraform-vm-hana-1"]: Creating... module.sap-application-server.vsphere_virtual_machine.sap_application_server["terraform-vm-1"]: Creation complete after 4s [id=4228c157-71f8-f8ab-18b0-1be3c77cd381] module.sap-hana-database.vsphere_virtual_machine.sap_hana_database["terraform-vm-hana-1"]: Creation complete after 6s [id=42286fc8-2357-08f1-17f4-e746be74ff34] Apply complete! Resources: 2 added, 0 changed, 0 destroyed. Outputs: affinity_hosts_sap_application_servers_rules = {} affinity_hosts_sap_hana_databases_rules = {} anti_affinity_sap_application_servers_rule = {} anti_affinity_sap_hana_databases_rule = {} sap_application_servers_ids = { "terraform-vm-1" = "4228c157-71f8-f8ab-18b0-1be3c77cd381" } sap_hana_databases_ids = { "terraform-vm-hana-1" = "42286fc8-2357-08f1-17f4-e746be74ff34" } ``` If the execution ran without issue, you have created your first SAP system infrastructure with all the virtual machines on your VMware on OVHcloud solution with Terraform. We suggest that you look the [examples folder](https://github.com/ovh/terraform-vsphere-sap-system/tree/master/examples) and [README](https://github.com/ovh/terraform-vsphere-sap-system) to discover all possibilities. At any moment, you have the possibility to change the configuration of the virtual machines (more vCPU, more memory or add a new disk, for example) and relaunch the Terraform execution. ## Deletion If you want to destroy these virtual machines, run the following command: ```bash terraform destroy ``` The output of the execution should be similar to this: ```python Plan: 0 to add, 0 to change, 2 to destroy. Changes to Outputs: - affinity_hosts_sap_application_servers_rules = {} -> null - affinity_hosts_sap_hana_databases_rules = {} -> null - anti_affinity_sap_application_servers_rule = {} -> null - anti_affinity_sap_hana_databases_rule = {} -> null - sap_application_servers_ids = { - terraform-vm-1 = "4228c157-71f8-f8ab-18b0-1be3c77cd381" } -> null - sap_hana_databases_ids = { - terraform-vm-hana-1 = "42286fc8-2357-08f1-17f4-e746be74ff34" } -> null module.sap-application-server.vsphere_virtual_machine.sap_application_server["terraform-vm-1"]: Destroying... [id=4228c157-71f8-f8ab-18b0-1be3c77cd381] module.sap-hana-database.vsphere_virtual_machine.sap_hana_database["terraform-vm-hana-1"]: Destroying... [id=42286fc8-2357-08f1-17f4-e746be74ff34] module.sap-application-server.vsphere_virtual_machine.sap_application_server["terraform-vm-1"]: Destruction complete after 1s module.sap-hana-database.vsphere_virtual_machine.sap_hana_database["terraform-vm-hana-1"]: Destruction complete after 1s Destroy complete! Resources: 2 destroyed. ``` ## Go further If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/pl/professional-services/?_gl=1*1vve3gg*_gcl_au*MzU3MTAzMzA5LjE2ODY1NTk4MTE.) to get a quote and ask our Professional Services experts for assisting you on your specific use case of your project. Join our community of users on [https://community.ovh.com/en/](https://community.ovh.com/en/).