Terraform 部署脚本文件

配置文件和脚本文件可在 GitHub 存储库中找到：

• Java 堆栈：https://github.com/IBM-Cloud/sap-netweaver-java-hana
• 对于 ABAP 堆栈：https://github.com/IBM-Cloud/sap-netweaver-abap-hana

input.auto.tfvars 文件允许自定义资源，并应提供变量值。

其他配置文件已提供，无需修改。

Schematics 脚本文件

配置文件和脚本文件可在 GitHub 存储库中找到：

• ABAP：https://github.com/IBM-Cloud/sap-netweaver-abap-hana/tree/main
• Java: https://github.com/IBM-Cloud/sap-netweaver-java-hana/tree/main

使用 Schematics 接口时，应提供以下信息：

• 工作区信息。
• 在 ABAP 或 Java 协议栈上为所选解决方案提供 GitHub 路径。
• Schematics 界面中的参数值。 这些参数与使用 cli 的 input.auto.tfvars 文件相同。

SAP 套件

每个 IBM Cloud 区域都有一个专门的部署服务器（堡垒服务器）用于 Terraform 环境。 您有责任将必要的 SAP 和 DB 工具包下载到您的部署 (Bastion) 服务器。 在自动部署过程中，所有文件存档都由 Ansible 解压缩。 如需了解更多信息，请参阅 GitHub 专用软件仓库中的 Readme 文件。

准备工作

使用脚本前

• 如果尚未创建，请创建一个部署服务器（bastion 服务器）来存储 SAP 工具包。 更多信息，请参阅 自动化 SAP bastion 服务器 - SAP 媒体存储库。
• 登录先前创建的部署服务器，验证 Terraform 和 Ansible 是否已安装。
• 从 SAP Portal 将 SAP 工具包下载到部署服务器。 记下下载位置。 Ansible 解压所有文件。 更多信息，请参阅 Java README 文件 或 ABAP README 文件。
• 创建或检索 IBM Cloud API 密钥。 API 密钥用于与 IBM Cloud 平台进行身份验证，并确定您使用 IBM Cloud 服务的权限。
• 创建或获取 SSH 密钥 ID。 您需要的是 SSH 密钥的 40 位 UUID，而不是 SSH 密钥名称。

在 HANA 数据库上部署 SAP NetWeaver ABAP 或 Java 堆栈之前

• 设置账户以访问 VPC。 确保您的账户已升级为 付费账户。
• 如果还没有，请创建一个部署服务器（bastion 服务器）来存储 SAP 工具包。 更多信息，请参阅 自动化 SAP bastion 服务器 - SAP 媒体存储库。 部署时需要部署服务器（堡垒服务器）的浮动 IP。
• 从 SAP Portal 下载 SAP 工具包到部署服务器（bastion 服务器）。 记下下载位置。 Ansible 解压所有压缩包，并需要路径。 更多信息，请参阅 Readme 文件：
  • ABAP：SchematicsTerraform 或 目录瓦片
  • JAVA：Schematics 和 Terraform
• 创建或检索 IBM Cloud API 密钥。 API 密钥用于与 IBM Cloud 平台进行身份验证，并确定您使用 IBM Cloud 服务的权限。
• 创建或获取 SSH 密钥 ID。 您需要的是 SSH 密钥的 40 位 UUID，而不是 SSH 密钥名称。
• 可选 - （目录瓦片）使用 Secrets Manager.

使用 Schematics 用户界面部署 SAP NetWeaver 7.x 和 SAP HANA

使用 Schematics 界面，在现有 VPC 上配置 NetWeaver ABAP 或 Java 堆栈。 脚本需要 2-3 个小时才能完成。

1. 从 IBM Cloud 菜单中选择 Schematics.

2. 单击创建工作空间。

3. 在指定模板页面：

   • 输入 Schematics 接口的 URL。
   • 选择自述文件中列出的 Terraform 版本。
   • 单击下一步。

4. 在工作区详细信息页面：

   • 输入工作区名称。
   • 选择资源组。
   • 为工作区选择一个位置。 工作区位置不必与资源位置一致。
   • 选择下一步。

5. 选择“**创建 **”来创建工作区。

6. 在工作区设置页面的“输入变量”部分，查看默认输入变量，并提供与解决方案相匹配的值。

   有关各参数的详细说明，请查阅 GitHub repo Java Readme 或 ABAP Readme 文件，“输入参数文件”一章。 此外，确保将包含密码、API 和 ssh 私钥等敏感信息的参数标记为“敏感”。 这些参数在 Readme 文件的“输入参数文件”中被标记为“敏感”参数。

7. 在工作区设置页面，单击生成计划。 等待计划完成。

8. 单击查看日志以查看 Terraform 执行计划的日志文件。

9. 单击“应用计划”应用 Terraform 模板。

10. 查看日志文件，确保在配置、修改或删除过程中不会出现错误。

通过可部署架构瓦片在 VPC 上部署 SAP NetWeaver (ABAP) Linux /HANA

使用以下步骤，通过目录瓦片界面在现有 VPC 上配置 SAP NetWeaver (ABAP) Linux /HANA。 脚本需要 2-3 个小时才能完成。

1. 从 IBM Cloud Catalog 菜单中选择 VPC for SAP HANA NetWeaver ABAP on Deployable Architecture tile。 有关此部署的更多信息，请参阅 Readme 文件。

2. 选择最新版本。

3. 选择标准变体。

4. 单击审查部署选项：

   • 添加到项目，将此部署添加到 IBM Cloud 项目，并与其他部署合并。 IBM Cloud 项目还包括其他几个流水线步骤，包括部署验证、成本计算、合规性验证和审批流程。
   • 从 CLI 创建以获取 CLI 命令。 使用此命令，您可以通过 CLI 触发部署。
   • 使用代码将代码嵌入到其他 terraform 部署中。
   • 使用 IBM Cloud Schematics 直接触发部署流程。

5. 选择使用 IBM Cloud Schematics 选项进行部署。 现在，为该安装添加输入参数。 有 3 类参数：

   • 工作区- 这些参数定义了在 Schematics 中自动创建的工作区：

     • 输入工作区名称或使用默认名称。
     • 用于创建资源的资源组。 使用默认值或创建资源组。
     • 选择一个位置来创建 Schematics 工作空间。 工作区位置不必与资源位置一致。

   • 所需输入变量- 查看默认输入变量，并提供与解决方案相匹配的值。 这些参数针对您的部署。 更多详细信息，请参阅 自述文件。

     所需变量

     参数	描述
     APP_HOSTNAME	SAP Application VSI 的主机名。 根据 SAP 的要求，主机名应不超过 13 个字符。 有关 SAP 系统主机名规则的更多信息，请查阅 SAP Note 611361：“SAP ABAP 平台服务器的主机名”。
     DB_HOSTNAME	HANA VSI 的主机名。 根据 SAP 的要求，主机名应不超过 13 个字符。 有关 SAP 系统主机名规则的更多信息，请查阅 SAP Note 611361：“SAP ABAP 平台服务器的主机名”。
     bastion_floating_ip	输入 Bastion 服务器的 FLOATING IP。
     區域	部署解决方案的云区域。 这里 列出了 VPC 的区域和分区。 在 IBM Cloud Schematics 中查看支持的地点。
     RESOURCE_GROUP	用于 VSI 和卷资源的现有资源组名称。 资源小组列表请 点击此处。
     SECURITY_GROUP	现有安全组的名称。 这里有安全组列表。
     ssh_keys	允许以根用户身份 SSH 访问 VSI 的 SSH 密钥 UUID 列表。 可以包含一个或多个标识。 这里有 SSH 密钥列表。
     SUBNET	现有子网的名称。 子网列表可 在此处获取。
     VPC	现有 VPC 的名称。 VPC 列表可 在此处获取。
     ZONE	部署解决方案的云区。
     hana_main_password	安装过程中创建的所有用户的通用密码。 请点击此处查看图片列表。
     ibmcloud_api_key	IBM Cloud API 密钥（敏感*值）。
     private_ssh_key	以 OpenSSH 格式输入 id_rsa 私钥对内容（敏感*值）。 仅应在 Terraform 配置期间使用此专用密钥，建议在 SAP 部署后进行更改。
     sap_main_password	安装过程中创建的所有用户的通用密码。 参见观察*部分。

   • 可选输入变量- 查看并更新可选参数。 更多详细信息，请参阅 自述文件。

     可选变量

     参数	描述
     应用程序图像	用于 SAP Application VSI 的操作系统映像。 参见观察*部分。 请点击此处查看图片列表。
     APP_PROFILE	SAP Application VSI 使用的实例配置文件。 请点击此处查看简介列表。 有关支持的 DB/OS 和 IBM Gen 2 虚拟服务器实例 (VSI) 的更多信息，请查阅 SAP Note 2927211：" SAP Applications on IBM Virtual Private Cloud"。
     DB_IMAGE	用于 HANA VSI 的操作系统映像。 参见观察*部分。 请点击此处查看图片列表。
     DB_PROFILE	用于 HANA VSI 的实例配置文件。 请点击此处查看简介列表。 有关支持的 DB/OS 和 IBM Gen 2 虚拟服务器实例 (VSI) 的更多信息，请查阅 SAP Note 2927211：" SAP Applications on IBM Virtual Private Cloud"。
     id_rsa_file_path	private_ssh_key 的文件路径默认为自动生成。 如果更改，则必须包含 git repo 文件夹的相对路径。
     hana_components	SAP HANA 组件 默认值：“服务器”。 有效值：“全部”、“客户端”、"es"、"ets"、"lcapps"、“服务器”、"smartda"、“流媒体”、"rdsync"、"xs"、"studio"、"afl"、"sca"、"sop"、"eml"、"rme"、"rtl"、"trp"。
     HANA_SID	SAP 系统 ID 用于标识 SAP HANA 系统。
     HANA_SYSNO	指定 SAP HANA 系统的实例编号。
     hana_system_usage	系统使用。 默认值：“自定义”。 有效值：“生产”、“测试”、“开发”、“自定义”。
     hdb_ccurent_jobs	用于向 HANA 主机加载和/或提取存档的并发作业数。
     kit_hdb_client_file	从 SAP Support Portal 下载的 HANA DB 客户端存档 (SAR) 的路径。
     kit_igsexe_file	从 SAP Support Portal 下载的 IGS 档案 (SAR) 路径。
     kit_igshelper_file	从 SAP Support Portal 下载的 IGS 助手存档 (SAR) 的路径。
     kit_nwhana_export_file	NetWeaver 安装导出 ZIP 文件的路径。 从 SAP Support Portal 下载的归档文件应存在于此路径中。
     kit_sapcar_file	从 SAP Support Portal 下载的 sapcar 二进制文件的路径。
     kit_sapexe_file	从 SAP Support Portal 下载的 SAP Kernel OS 存档 (SAR) 的路径。
     kit_sapexedb_file	从 SAP Support Portal 下载的 SAP Kernel DB 存档 (SAR) 的路径。
     kit_saphana_file	SAP HANA ZIP 文件的路径。 参见 观察*部分。 从 SAP 支持门户网站下载。
     kit_saphostagent_file	从 SAP Support Portal 下载的 SAP Host Agent 存档 (SAR) 路径。
     KIT_SWPM_FILE	从 SAP Support Portal 下载的 SWPM 存档 (SAR) 路径。
     sap_ascs_instance_number	ASCS 内部程序的技术标识符。
     sap_ci_instance_number	传播和信息内部流程的技术标识符。
     SAP_SID	SAP 系统 ID 标识整个 SAP 系统。
     HANA_TENANT	SAP HANA 租户名称。

6. 接受许可协议。

7. 选择部署。 部署开始后，您将进入 Schematics 页面，该页面显示脚本日志文件，供您监控部署进度。

使用 Terraform 部署 SAP NetWeaver 7.x 和 SAP HANA

使用这些步骤创建 VPC 资源并安装 SAP 架构。 脚本需要 2 个小时才能完成。

1. 使用 ssh 登录部署服务器（bastion 服务器）。

2. 克隆 GitHub 仓库。

   供 Java： 克隆软件源 https://github.com/IBM-Cloud/sap-netweaver-java-hana，并更改 sap-netweaver-java-hana/cli 文件夹的路径。

   git clone https://github.com/IBM-Cloud/sap-netweaver-java-hana.git
   cd sap-netweaver-java-hana/cli
   

   对于 ABAP： 克隆版本库 https://github.com/IBM-Cloud/sap-netweaver-abap-hana 并更改为 sap-netweaver-abap-hana 文件夹。

   git clone https://github.com/IBM-Cloud/sap-netweaver-abap-hana.git
   cd sap-netweaver-abap-hana
   

3. 定义现有 VPC 变量。 修改 input.auto.tfvars 文件，指定区域、VPC 组件名称、配置文件和映像。 该文件预设了建议的最小磁盘大小。 该文件需要 40 位 SSH 密钥 ID。 第二个 SSH 密钥是可选的。 有关配置文件的更多选项，请参阅 实例配置文件。 有关图像的更多选项，请参阅 图像。 有关变量的说明，请参阅 Java README 文件 或 ABAP README 文件。

   Java，应修改以下变量值：

   • REGION - VSI 的区域。 请参见自述文件。
   • ZONE - VSI 的区域。 请参见自述文件。
   • VPC - 指定区域内现有 VPC 的名称。
   • SECURITY_GROUP - 同一 VPC 中现有安全组的名称
   • RESOURCE_GROUP - 用户先前创建的现有资源组的名称。
   • SUBNET - 与 VSI 位于同一地区和区域的现有子网的名称
   • SSH_KEYS - 允许通过 SSH 连接到 VSI 的 SSH 密钥 UUID 列表
   • DB_HOSTNAME - VSI 数据库的主机名，最多 13 个字符。 更多信息，请参阅自述文件。
   • APP_HOSTNAME - 应用服务器 VSI 的主机名，最多 13 个字符。 更多信息，请参阅自述文件。

   # General VPC variables for Java stack
   REGION        = "ed-de"
   ZONE          = "eu-de-2"
   VPC           = "ic4sap"
   SECURITYGROUP = "ic4sap-securitygroup"
   SUBNET        = "ic4sap-subnet"
   SSH_KEYS      = [ "ssh key1" , "ssh key2" ]
   
   # SAP Database VSI variables:
   DB_HOSTNAME   = "sapjavadb"
   DB_PROFILE    = "mx2-16x128"
   DB_IMAGE      = "ibm-redhat-8-6-amd64-sap-hana-2" # For any manual change in the Terraform code, you have to make sure that you use a certified image based on the SAP Note: 2927211.
   
   # SAP APPs VSI variables:
   APP_HOSTNAME    = "sapjavci"
   APP_PROFILE     = "bx2-4x16"
   APP_IMAGE = "ibm-redhat-8-6-amd64-sap-applications-2" # For any manual change in the terraform code, you have to make sure that you use a certified image based on the SAP Note: 2927211.
   
   

   对于 ABAP，应修改以下变量值：

   • REGION - VSI 的区域。 请参见自述文件。
   • ZONE - VSI 的区域。 请参见自述文件。
   • VPC - 指定区域内现有 VPC 的名称。
   • SECURITY_GROUP - 同一 VPC 中现有安全组的名称
   • RESOURCE_GROUP - 用户先前创建的现有资源组的名称
   • SUBNET - 与 VSI 位于同一地区和区域的现有子网的名称
   • SSH_KEYS - 允许通过 SSH 连接到 VSI 的 SSH 密钥 UUID 列表
   • DB_HOSTNAME - VSI 数据库的主机名，最多 13 个字符。 更多信息，请参阅自述文件。
   • APP_HOSTNAME - 应用服务器 VSI 的主机名，最多 13 个字符。 更多信息，请参阅自述文件。

   # General VPC variables for ABAP stack
   REGION          = "eu-de"
   ZONE            = "eu-de-2"
   VPC             = "ic4sap"                    # EXISTING Security group name
   SECURITY_GROUP  = "ic4sap-securitygroup"      # EXISTING Security group name
   RESOURCE_GROUP  = "wes-automation"
   SUBNET          = "ic4sap-subnet"             # EXISTING Subnet name
   SSH_KEYS        = [ "r010-57bfc315-f9e5-46bf-bf61-d87a24a9ce7a" , "r010-3fcd9fe7-d4a7-41ce-8bb3-d96e936b2c7e" ]
   
   # SAP Database VSI variables:
   DB_HOSTNAME     = "sapnwhdb"
   DB_PROFILE      = "mx2-16x128"
   DB_IMAGE        = "ibm-redhat-8-6-amd64-sap-hana-6"
   
   # SAP APPs VSI variables:
   APP_HOSTNAME	= "sapnwci"
   APP_PROFILE	= "bx2-4x16"
   APP_IMAGE 	= "ibm-redhat-8-6-amd64-sap-applications-6"
   

   根据 SAP的要求，主机名最多不得超过 13 个字符。 有关适用于 SAP 系统主机名的规则的更多信息，请参阅 SAP Note 611361 - Hostnames of SAP ABAP Platform servers（ ABAP 平台服务器的主机名）

4. 自定义 SAP 系统配置。 修改 input.auto.tfvars 文件，指定 SAP 系统配置，并输入下载的 SAP 工具包的位置。 有关变量的说明，请参阅 Java README 文件 或 ABAP README 文件。

   供 Java：

   # SAP HANA DB configuration for Java stack
   HANA_SID                = "HDB"
   HANA_SYSNO              = "00"
   HANA_SYSTEM_USAGE       = "custom"
   HANA_COMPONENTS         = "server"
   
   # SAP HANA Installation kit path
   KIT_SAPHANA_FILE        = "/storage/HANADB/51055299.ZIP"
   
   # SAP system configuration
   SAP_SID                 = "JV1"
   SAP_SCS_INSTANCE_NUMBER = "01"
   SAP_CI_INSTANCE_NUMBER  = "00"
   
   # SAP JAVA APP Installation kit path
   KIT_SAPCAR_FILE = "/storage/NW75HDB/SAPCAR_1010-70006178.EXE"
   KIT_SWPM_FILE = "/storage/NW75HDB/SWPM10SP31_7-20009701.SAR"
   KIT_SAPEXE_FILE = "/storage/NW75HDB/SAPEXE_801-80002573.SAR"
   KIT_SAPEXEDB_FILE = "/storage/NW75HDB/SAPEXEDB_801-80002572.SAR"
   KIT_IGSEXE_FILE = "/storage/NW75HDB/igsexe_13-80003187.sar"
   KIT_IGSHELPER_FILE = "/storage/NW75HDB/igshelper_17-10010245.sar"
   KIT_SAPHOSTAGENT_FILE = "/storage/NW75HDB/SAPHOSTAGENT51_51-20009394.SAR"
   KIT_HDBCLIENT_FILE = "/storage/NW75HDB/IMDB_CLIENT20_009_28-80002082.SAR"
   KIT_SAPJVM_FILE = "/storage/NW75HDB/SAPJVM8_73-80000202.SAR"
   KIT_JAVA_EXPORT = "/storage/NW75HDB/export"
   

   对于 ABAP：

   # HANA DB configuration for ABAP stack
   HANA_SID                = "HDB"
   HANA_SYSNO              = "00"
   HANA_TENANT		= "NWD"
   HANA_SYSTEM_USAGE       = "custom"
   HANA_COMPONENTS 	= "server"
   
   # SAP HANA Installation kit path
   KIT_SAPHANA_FILE 	= "/storage/HANADB/SP07/Rev73/51057281.ZIP"
   
   # SAP system configuration
   SAP_SID = "NWD"
   SAP_ASCS_INSTANCE_NUMBER = "01"
   SAP_CI_INSTANCE_NUMBER 	 = "00"
   
   # Number of concurrent jobs used to load and/or extract archives to HANA Host
   HDB_CONCURRENT_JOBS 	 = "12"
   
   # SAP NW APP Installation kit path
   KIT_SAPCAR_FILE 	 = "/storage/NW75HDB/SAPCAR_1300-70007716.EXE"
   KIT_SWPM_FILE 		 = "/storage/NW75HDB/SWPM10SP42_0-20009701.SAR"
   KIT_SAPEXE_FILE 	 = "/storage/NW75HDB/KERNEL/754/SAPEXE_400-80007612.SAR"
   KIT_SAPEXEDB_FILE 	 = "/storage/NW75HDB/KERNEL/754/SAPEXEDB_400-80007611.SAR"
   KIT_IGSEXE_FILE 	 = "/storage/NW75HDB/KERNEL/754/igsexe_4-80007786.sar"
   KIT_IGSHELPER_FILE 	 = "/storage/NW75HDB/igshelper_17-10010245.sar"
   KIT_SAPHOSTAGENT_FILE 	 = "/storage/NW75HDB/SAPHOSTAGENT65_65-80004822.SAR"
   KIT_HDBCLIENT_FILE 	 = "/storage/NW75HDB/IMDB_CLIENT20_022_27-80002082.SAR"
   KIT_NWHANA_EXPORT_FILE   = "/storage/NW75HDB/ABAPEXP/51050829_3.ZIP"
   

5. 初始化 Terraform CLI。

   terraform init
   

6. 创建 Terraform 执行计划。 Terraform 执行计划总结了在账户中创建虚拟私有云实例的所有操作。 Terraform 计划会提示您输入 API 密钥以及初始 SAP 和 DB 密码。

   terraform plan --out plan1
   

   系统会要求您输入 SAP 主密码、HANA 主密码和 API 密钥。

   SAP 主密码长度必须为 10 - 14 个字符，至少包含一个数字（0-9）。 密码只能包含以下字符：a-z、A-Z、0-9、@、#、$、_。该密码不能包含! 不得以数字或下划线 ( _ ) 开头。

7. 验证计划是否显示了要创建的所有资源，名称和值是否正确。 如果计划需要调整，请编辑 input.auto.tfvars 文件以更正资源，然后再次运行 terraform plan --out plan1。

8. 在 IBM Cloud 中为 SAP 实例和 IAM 访问策略创建虚拟私有云。

    terraform apply "plan1"
   

   虚拟私有云和组件已创建，您将看到与 terraform plan 输出类似的输出。