Red Hat Enterprise Linux System Roles for SAP
概要
多様性を受け入れるオープンソースの強化 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat では、コード、ドキュメントにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。多様性を受け入れる用語に変更する取り組みの詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。
Red Hat ドキュメントへのフィードバック (英語のみ) リンクのコピーリンクがクリップボードにコピーされました!
Red Hat ドキュメントに関するご意見やご感想をお寄せください。また、改善点があればお知らせください。
Jira からのフィードバック送信 (アカウントが必要)
第1章 概要 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Enterprise Linux (RHEL) 7 RHEA-2019:3190 で導入された RHEL System Roles for SAP は、SAP HANA または SAP NetWeaver ソフトウェアをインストールする RHEL システムのリモート設定またはローカル設定を支援するためのものです。RHEL System Roles for SAP の開発は、SAP LinuxLab アップストリームプロジェクトに基づいています。
RHEL System Roles は、管理者による RHEL システムの設定を支援する、Ansible によって実行されるロールのコレクションです。これらのロールは、RHEL AppStream リポジトリーで提供されます。一方、RHEL System Roles for SAP は、RHEL for SAP Solutions サブスクリプションで提供されます。
Red Hat Enterprise Linux for SAP Solution サブスクリプションは、Ansible Core を使用した RHEL System Roles for SAP のサポートを提供します。ただし、Ansible Core の完全なサポートが必要な場合は、別のサブスクリプションが必要です。関連情報は、Red Hat Enterprise Linux (RHEL) System Roles を参照してください。
次の RHEL System Roles for SAP は、RHEL 8.4 以降を実行しているコントロールノードで完全にサポートされています。
- sap_general_preconfigure
- sap_netweaver_preconfigure
- sap_hana_preconfigure
- sap_hana_install
次の RHEL System Roles for SAP は、RHEL 8.4 以降を実行しているコントロールノードでテクノロジープレビューとしてサポートされています。
- sap_ha_install_hana_hsr
- sap_ha_pacemaker_cluster
- sap_swpm (*)
RHEL System Roles for SAP は、RHEL System Roles と同様、コントロールノード (Ansible Automation コントローラー、Red Hat Satellite、RHEL 9 または RHEL 8 ホスト) と呼ばれる中央ノードからインストールおよび実行されます。コントロールノードは、ローカルホスト/1 つ以上のリモートホスト (Ansible のコンテキストでは、マネージドノード と呼ばれます) に接続し、それらにインストールおよび設定手順を実行します。コントロールノード (RHEL 9) で RHEL の最新のメジャーリリースを使用し、RPM rhel-system-roles-sap または Red Hat Automation Hub から最新バージョンのロールを使用することを推奨します。RHEL System Roles for SAP および Ansible パッケージは、管理/設定されているシステムにインストールする必要はありません。
このドキュメントでは、次のロールで構成される RHEL パッケージ rhel-system-roles-sap バージョン 3.3.0 (*) または Automation Hub コレクション redhat.sap_install バージョン 1.2.1 をインストールおよび使用する方法を説明します。
パッケージ rhel-system-roles-sap バージョン 3.3.0 には、ロール sap_swpm が含まれていません。このロールは、パッケージ rhel-system-roles-sap の次のバージョンでリリースされる予定です。
Purpose
| ロール名 | 説明 |
|---|---|
| sap_general_preconfigure | SAP NetWeaver と SAP HANA に共通のインストールおよび設定手順を実行する |
| sap_netweaver_preconfigure | SAP NetWeaver の追加のインストールおよび設定手順を実行する |
| sap_hana_preconfigure | SAP HANA の追加のインストールと設定を実行する |
| sap_hana_install | SAP HANA のスケールアップまたはスケールアウトインストールを実行する |
| sap_ha_install_hana_hsr | 2 つのノードで SAP HANA システムレプリケーションを設定する |
| sap_ha_pacemaker_cluster | Pacemaker をインストールし、クラスターと SAP クラスターリソースを設定する |
| sap_swpm | SWPM 経由で SAP ソフトウェアをインストールする |
サポートステータス
| ロール名 | サポートステータス | リモートホスト管理 | コントロールノード |
|---|---|---|---|
| sap_general_preconfigure | フルサポート | RHEL 7.6 以降、RHEL 8、RHEL 9 | RHEL 8、RHEL 9 |
| sap_netweaver_preconfigure | フルサポート | RHEL 7.6 以降、RHEL 8、RHEL 9 | RHEL 8、RHEL 9 |
| sap_hana_preconfigure | フルサポート | RHEL 7.6 以降、RHEL 8、RHEL 9 | RHEL 8、RHEL 9 |
| sap_hana_install | フルサポート | RHEL 7.6 以降、RHEL 8、RHEL 9 | RHEL 8、RHEL 9 |
| sap_ha_install_hana_hsr | テクノロジープレビュー | RHEL 8、RHEL 9 | RHEL 8、RHEL 9 |
| sap_ha_pacemaker_cluster | テクノロジープレビュー | RHEL 8、RHEL 9 | RHEL 8、RHEL 9 |
| sap_swpm (*) | 一部の機能はテクノロジープレビュー、その他のすべての機能はサポート対象外 | RHEL 8、RHEL 9 | RHEL 8、RHEL 9 |
* このバージョンの RHEL System Roles for SAP には、ロール
sap_swpmが含まれています。サポート範囲は、テクノロジープレビュー機能のサポート範囲で、ロールのデフォルトモードのみが対象です。また、サポート対象のデプロイメントシナリオは、x86_64 の RHEL 8.4、8.6、9.0 および ppc64le の RHEL 8.4 および 8.6 上の S/4HANA 2021 および S/4HANA 2022 単一ホストインストールです。ロール
sap_swpmの他のすべての機能はサポートされていません。
プラットフォーム
マネージドノードのサポートされているハードウェア/仮想化/クラウドプラットフォームについては、次の表を参照してください。
| ハードウェアプラットフォーム | ベアメタル/仮想化/クラウドプラットフォーム | サポートステータス |
|---|---|---|
| x86_64 | ベアメタル、Red Hat Virtualization/libvirt、VMware ESX、Red Hat 認定クラウドおよびサービスプロバイダー | 前の表のサポートステータスに従ってサポート |
| ppc64le | PowerVM LPARs | 前の表のサポートステータスに従ってサポート |
| s390x | zVM ゲスト | フルサポート: sap_general_preconfigure、sap_netweaver_preconfigure |
Directories
| インストール方法 | ロール、ドキュメント |
|---|---|
| RHEL パッケージ rhel-system-roles-sap |
|
| Automation Hub コレクション redhat.sap_install |
|
- ロールは、マネージドノードの初期インストールの直後に使用されるように設計されています。これらのロールを SAP またはその他の実稼働システムに対して実行する場合は、最初にアサーションモードで実行して、該当する SAP ノートに従って SAP の推奨事項から逸脱している設定を検出できるようにしてください。通常モードで実行すると、ロールはマネージドノードで SAP 推奨の設定を適用します。通常とは異なるシステム設定が原因で、まれにロールによる意図しない変更が発生することがあります。実稼働システムで通常モードでロールを使用する前に、まずシステムをバックアップし、テストおよび QA システムでロールをテストすることを強く推奨します。
-
マネージドノードにロールを適用する前に、マネージドノードの RHEL リリースが、インストールする予定の SAP ソフトウェアバージョンでサポートされていることを確認してください。(オーバーライド可能な) SAP HANA 検証が存在しない RHEL マイナーバージョンが使用されている場合、ロール
sap_hana_preconfigureは失敗します。
第2章 Ansible Engine と RHEL System Roles for SAP のインストール リンクのコピーリンクがクリップボードにコピーされました!
Ansible Core と RHEL System Roles for SAP パッケージまたはコレクションをインストールするには、次の手順を使用します。
Red Hat Satellite システムにパッケージをインストールするには、単純な dnf コマンドを使用せずに、Red Hat Satellite 6 でパッケージをインストールまたは更新する方法 の指示に従ってください。
手順
Ansible Core をインストールします。
dnf install ansible-core
# dnf install ansible-coreCopy to Clipboard Copied! Toggle word wrap Toggle overflow ステップ 2 に進んで RHEL パッケージ
rhel-system-roles-sapをインストールするか、ステップ 3 に進んで Automation Hub コレクションredhat.sap_installをインストールします。RHEL パッケージ
rhel-system-roles-sapをインストールする場合:Red Hat Subscription Manager を使用して、RHEL for SAP Solutions リポジトリーを有効にします。
subscription-manager repos --enable=rhel-$(rpm -E %rhel)-for-$(uname -m)-sap-solutions-rpms
# subscription-manager repos --enable=rhel-$(rpm -E %rhel)-for-$(uname -m)-sap-solutions-rpmsCopy to Clipboard Copied! Toggle word wrap Toggle overflow RHEL System Roles for SAP をインストールします。
dnf install rhel-system-roles-sap
# dnf install rhel-system-roles-sapCopy to Clipboard Copied! Toggle word wrap Toggle overflow rhel-system-roles-sapパッケージは/usr/share/ansible/roles/<role>にインストールされます。<role>は個々のロールの名前です (例:sap_hana_preconfigure)。各ロールには、すべての変数とロールの使用方法を説明するREADME.mdファイルが含まれています。
Automation Hub コレクション
redhat.sap_installをインストールするには、Automation Hub からコレクションを直接インストールするか、コレクションをダウンロードしてから、ダウンロードしたファイルからインストールします。コレクションを Automation Hub から直接インストールするには、このページ の手順に従ってください。重要な手順は次のとおりです。
- このページ からオフライントークン、サーバー URL、および SSO URL のコピーを作成し、同じページにあるサーバー URL と SSO URL をメモします。必要に応じてトークンを再作成します (トークンの有効期限が切れている場合など)。
これらの値を使用して、この章 の指示に従って、ファイル
/etc/ansible/ansible.cfgを設定します。次の例のように、変数urlにサーバー URL、変数auth_urlに SSO URL、変数tokenにオフライントークンを使用します (ダミートークンを実際のトークンに置き換えてください)。Copy to Clipboard Copied! Toggle word wrap Toggle overflow コレクションを使用するユーザー (Playbook を実行して、ソフトウェアをインストールするか、マネージドノードで設定を行うユーザー) として次のコマンドを実行して、コレクションをインストールします。
ansible-galaxy collection install redhat.sap_install
# ansible-galaxy collection install redhat.sap_installCopy to Clipboard Copied! Toggle word wrap Toggle overflow これにより、コレクションがユーザーのデフォルトの場所 (必要なディレクトリーが再帰的に作成されます) にインストールされます。これは
~/.ansible/collections/ansible_collections/redhat/sap_installです。
Automation Hub からコレクションをダウンロードおよびインストールするには、次の手順を実行します。
このページ からコレクションの tar ファイルをダウンロード (
Download tarballリンクを使用) し、コレクションを使用するユーザーとして次のコマンドを実行します。ansible-galaxy collection install ./redhat-sap_install-1.2.1.tar.gz
# ansible-galaxy collection install ./redhat-sap_install-1.2.1.tar.gzCopy to Clipboard Copied! Toggle word wrap Toggle overflow これにより、前述のように、ユーザーのデフォルトの場所にコレクションがインストールされます。
sap_installの下の各ロールのサブディレクトリーにあるファイルREADME.md(例:roles/sap_general_preconfigure) には、各ロールのドキュメントが含まれています。
第3章 新機能 リンクのコピーリンクがクリップボードにコピーされました!
Automation Hub コレクション redhat.sap_install バージョン 1.2.1 には、次の新機能があります。
-
Linux システムロール
ha_clusterとその拡張機能を使用して、1 つのロールですべての HA 関連の設定変更を実行するための新しいsap_ha_pacemaker_clusterロール -
目的の SID とインスタンス番号を持つ HANA システムが検出された場合にロールが正常に返されるように (べき等性)、ロール
sap_hana_installでの SID とインスタンスのチェックを改善 -
Linux システムロール
selinuxを使用して、事前設定および HANA インストール中に、SAP ディレクトリーの SELinux ファイルラベルを変更することが可能 -
特定の SWPM ベースのインストールを実行するための新しい
sap_swpmロール
第4章 既知の問題 リンクのコピーリンクがクリップボードにコピーされました!
4.1. 再起動要件の検出 リンクのコピーリンクがクリップボードにコピーされました!
再起動要件の検出は、プラットフォーム ppc64le の RHEL 8.5 以降では信頼できません。
再起動要件の検出に失敗すると、事前設定ロールを呼び出す Playbook の最後で、不要な再起動が実行される可能性があります。ロールのパラメーターを使用すると、再起動を回避できます。また、無条件にシステムを再起動するように、Playbook を拡張することもできます。詳細は、バグ 2166444 を参照してください。
4.2. SAP HANA 用の RHEL 9 パッケージ リンクのコピーリンクがクリップボードにコピーされました!
RHEL 9 では、一部のパッケージがインストールされず、また SAP HANA に必要のないパッケージもインストールされます。
公開済みの SAP ノート 3108316 には、このバージョンの RHEL System Roles for SAP の完成時には知られていなかった更新がいくつか含まれています。SAP HANA 用にインストールする必要がある追加パッケージは compat-openssl11 です。
インストールするパッケージのリストを迅速に定義する方法については、このコメント を参照してください。
4.3. 拡張チェック (アサート) 機能 リンクのコピーリンクがクリップボードにコピーされました!
事前設定ロールの拡張チェック (=assert) 機能を使用する場合は、注意してください。
事前設定ロールはアサートモードで実行できます。その場合、マネージドノードは変更されませんが、ノードが該当する SAP ノートに準拠しているかどうかが報告されます。通常モードで事前設定ロールを実行し、システム設定の変更にも同じコントロールノードを使用する場合は、システム設定のチェックに "通常" の Playbook が誤って使用されないように、特別な注意が必要です。まずテストおよび QA システムでロールをテストしてから、実稼働システムでロールを実行することを強く推奨します。
4.4. DNS 名前解決 リンクのコピーリンクがクリップボードにコピーされました!
DNS ドメインがマネージドノードに設定されていない場合、ロール sap_general_preconfigure は失敗します。
マネージドノードに DNS ドメインが設定されていない場合 (多くのクラウドシステムがこれに該当します)、ロール sap_general_preconfigure は、Verify that the DNS domain is set タスクで失敗します。これを回避するには、ロール変数 sap_domain を Playbook の vars セクションのマネージドノードのインベントリーファイルに設定するか、パラメーター -e "sap_domain=example.com" を指定して、ansible-playbook コマンドを実行します (example.com は独自の DNS ドメイン名に置き換えてください)。
第5章 RHEL System Roles for SAP のクイックスタートガイド リンクのコピーリンクがクリップボードにコピーされました!
SAP NetWeaver または SAP HANA をインストールするために 1 つ以上のシステムを設定または検証するには、次の手順を使用します。
5.1. コントロールノードの準備 リンクのコピーリンクがクリップボードにコピーされました!
システムメッセージを英語で表示するには、次の手順を使用します。RHEL System Roles for SAP では、Ansible コントロールノードがロケール C または en_US.UTF-8 を使用する必要があります。
手順
ローカルホストでコマンドを実行して、現在の設定を確認します。
locale
# localeCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力の
LC_MESSAGES=で始まる行にCまたはen_US.UTF-8が表示されます。コマンドで期待どおりの出力が得られない場合は、
ansible-playbookコマンドを実行する前に、ローカルホストで次のコマンドを実行してください。export LC_ALL=C
# export LC_ALL=CCopy to Clipboard Copied! Toggle word wrap Toggle overflow または、以下を実行します。
export LC_ALL=en_US.UTF-8
# export LC_ALL=en_US.UTF-8Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記これらの手順が必要なのは、デフォルトで
LC_*変数がリモートシステムに転送され (man ssh_configおよびman sshd_configを参照)、ロールがリモートシステムからの特定のコマンド出力を評価するためです。
5.2. ローカルシステムの設定 リンクのコピーリンクがクリップボードにコピーされました!
SAP NetWeaver をインストールするためにローカルシステムを準備するには、次の手順を使用します。
前提条件
- システム上で実稼働ソフトウェアが実行されていない。
- 最低 20480 MB のスワップ領域がローカルシステムに設定されている。
手順
サーバーの元の設定を保持する場合は、バックアップを作成します。
注記これらのロールは RHEL のインストール後に実行されるため、バックアップは必要ありません。
次の内容で
sap-netweaver.ymlという名前の YAML ファイルを作成します。- hosts: localhost connection: local roles: - sap_general_preconfigure - sap_netweaver_preconfigure- hosts: localhost connection: local roles: - sap_general_preconfigure - sap_netweaver_preconfigureCopy to Clipboard Copied! Toggle word wrap Toggle overflow 重要roles:の前には、正しいインデント (2 つの空白) が必要です。RHEL System Roles
sap_general_preconfigureおよびsap_netweaver_preconfigureを実行して、SAP NetWeaver のインストール用にマネージドノードを準備します。ansible-playbook sap-netweaver.yml
# ansible-playbook sap-netweaver.ymlCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Playbook の実行の終了時に、特定のパッケージがインストールされているなどの理由で、再起動が必要であると報告される可能性があります。その場合、この時点でシステムを再起動してください。
5.3. ローカルシステムの確認 リンクのコピーリンクがクリップボードにコピーされました!
RHEL System Roles for SAP を使用して、RHEL システムが正しく設定されていることを確認することもできます。次の手順を使用して、ローカルシステムが SAP NetWeaver のインストール用に正しく設定されているかどうかを確認します。
前提条件
- RHEL System Roles for SAP バージョン 3
手順
次の内容で
sap-netweaver.ymlという名前の YAML ファイルを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行します。
ansible-playbook sap-netweaver.yml
# ansible-playbook sap-netweaver.ymlCopy to Clipboard Copied! Toggle word wrap Toggle overflow よりコンパクトな出力を取得する場合は、事前設定された各ロールの tools ディレクトリーにあるシェルスクリプト
beautify-assert-output.shに出力をパイプして、各アサーションに関する重要な FAIL または PASS 情報のみを表示することができます。スクリプトをディレクトリー~/binにコピーしたと仮定すると、コマンドは次のようになります。ansible-playbook sap-netweaver-assert.yml | ./bin/beautify-assert-output.sh
# ansible-playbook sap-netweaver-assert.yml | ./bin/beautify-assert-output.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow 暗い背景色のターミナルを使用している場合は、次のコマンドシーケンスで出現するすべてのカラーコード
[30mを[37mに置き換えます。そうしないと、暗い色の背景に暗い色のフォントが表示されるため、一部の行の出力が判読不能になります。暗い背景色のターミナルで誤って上記のコマンドを実行した場合は、次のコマンドを使用して、デフォルトの白いフォントを再度有効にできます。echo -e "\033[37mResetting font color\n"
# echo -e "\033[37mResetting font color\n"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
5.4. リモートシステムの設定 リンクのコピーリンクがクリップボードにコピーされました!
SAP HANA のインストール用に 1 つ以上のリモートシステム (マネージドノード) を準備するには、次の手順を使用します。
前提条件
- Red Hat Satellite サーバーまたは Red Hat Customer Portal から Red Hat ソフトウェアパッケージをインストールできるように、マネージドノードが正しく設定されていることを確認する。
- Ansible コントロールノードから各マネージドノードへのパスワードなしの ssh アクセス。
SAP HANA でサポートされている RHEL リリース。
- SAP HANA でサポートされている RHEL リリースについては、SAP ノート 2235581 を参照してください。
手順
- サーバーの元の設定を保持する場合は、バックアップを作成します。
インベントリーファイルを作成するか、ファイル
/etc/ansible/hostsを変更します。このファイルには、ホストのグループの名前と、設定する各システム (マネージドノード) が別々の行に含まれています (例:sap_hanaという名前のホストグループ内の 3 つのホストの場合)。[sap_hana] host01 host02 host03
[sap_hana] host01 host02 host03Copy to Clipboard Copied! Toggle word wrap Toggle overflow パスワードなしで、ssh を使用して、3 つのホストすべてにログインできることを確認します。以下に例を示します。
ssh host01 uname -a ssh host02 hostname ssh host03 echo test
# ssh host01 uname -a # ssh host02 hostname # ssh host03 echo testCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下の内容で、
sap-hana.ymlという名前の YAML ファイルを作成します。- hosts: sap_hana roles: - sap_general_preconfigure - sap_hana_preconfigure- hosts: sap_hana roles: - sap_general_preconfigure - sap_hana_preconfigureCopy to Clipboard Copied! Toggle word wrap Toggle overflow 重要正しいインデント (たとえば、
roles:の前に 2 つの空白) が必要です。RHEL System Roles
sap_general_preconfigureおよびsap_hana_preconfigureを実行して、SAP HANA のインストール用にマネージドノードを準備します。ansible-playbook sap-hana.yml
# ansible-playbook sap-hana.ymlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記- ロールは、マネージドノードの初期インストールの直後に使用されるように設計されています。これらのロールを SAP またはその他の実稼働システムに対して実行する場合は、最初にアサーションモードで実行して、該当する SAP ノートに従って SAP の推奨事項から逸脱している設定を検出できるようにしてください。通常モードで実行すると、ロールはマネージドノードで SAP 推奨の設定を適用します。通常とは異なるシステム設定が原因で、まれにロールによる意図しない変更が発生することがあります。実稼働システムで通常モードでロールを使用する前に、まずシステムをバックアップし、テストおよび QA システムでロールをテストすることを強く推奨します。
- Playbook の実行の終了時に、各マネージドノードの再起動が必要であると報告されます。この時点でマネージドノードを再起動してください。
5.5. SAP ソフトウェアのインストール リンクのコピーリンクがクリップボードにコピーされました!
SAP HANA データベースまたは SAP S/4HANA を RHEL 8 または RHEL 9 にインストールする手順は、RHEL System Roles for SAP を使用した SAP HANA または SAP S/4HANA のインストール を参照してください。
第6章 追加情報 リンクのコピーリンクがクリップボードにコピーされました!
6.1. sap*preconfigure に実装された SAP ノート リンクのコピーリンクがクリップボードにコピーされました!
3 つの事前設定ロールに実装された SAP ノートは、SAP ノートバージョンとともに、各事前設定ロールの vars ファイルの _<role_name>_sapnotes_versions という名前の変数に含まれています。ファイルの名前は、たとえば /usr/share/ansible/roles/sap_general_preconfigure/vars/RedHat_8.yml などです。これらのファイルの変数 _sap_general_preconfigure_sapnotes_versions には、実装された SAP ノートとそのバージョン番号が含まれています。
6.2. ロール変数 リンクのコピーリンクがクリップボードにコピーされました!
ディレクトリー /usr/share/ansible/roles/<role> にある各ロールのファイル README.md には、すべてのユーザー設定可能な変数の目的とそのデフォルト設定が記述されています。変数は定義済みで、複数の場所 (インベントリーファイル、Playbook など) で、または ansible-playbook コマンドラインパラメーター --extra-vars または -e を使用して変更できます。