拡張インストールオプションの説明

コマンドライン上の hdblcm ツールは、2 つの異なる方法で使用できます。以下のオプションが示すように、どちらのメソッドもバッチモードで使用でき、ユーザ操作は必要ありません。

• コマンドラインオプション (バッチモード)

• 設定ファイル (バッチモード)

--batch オプションを使用する場合、コマンド行で指定されたパラメータが使用され、デフォルトパラメータが確認なしで受け入れられます。図に示すように、コマンド行でパスワードの必須パラメータを指定することもできます。ただし、文は Linux の履歴ファイルに保存されるため、このようにコマンド行でパスワードを指定することは避けてください。代わりに、パスワードを含め、すべての必須パラメータと値を保持する設定ファイルを登録します。または、明示的な xml ファイルにパスワードを保存し、このファイルからパスワードを読み込むパラメータを指定してバッチモードでインストールを開始するという安全策もあります。

--batch オプションを使用しない場合、SAP HANA インストールは半自動的に実行されます。コマンド行で指定されたパラメータが使用されますが、インストール担当者はデフォルトのパラメータ値を確認する必要があります。

SAP HANA Database Lifecycle Manager (HDBLCM) では、コマンド行オプションまたは設定ファイル (変更するパラメータを含む) を使用して変更しない限り、インストール時にデフォルト値が使用されます。

SAP HANA Platform Lifecycle Management ツールを使用して設定ファイルテンプレートを生成するには、以下のコマンドを実行します。

1
./hdblcm --dump_configfile_template=/root/hdblcmTemp.cfg

パラメータテンプレートファイルには、General、Server、Client などのセクションごとにパラメータが一覧表示されます。これらのセクションには、対応するパラメータが内容説明 (短) や入力可能値とともに表示されるので、ある種の入力ヘルプとして役立ちます。一部の一般的なユースケースでは、この機能で十分かもしれません。これらのパラメータは、SAP HANA サーバインストールおよびアップグレードガイドでも説明されています。

SAP HANA ライフサイクル管理 hdblcm ツールを使用して自動インストールを実行するには、設定ファイルとバッチモードを組み合わせる必要があります。

これまでは、パスワードを対話的に入力するか、コマンドラインで指定する必要がありました。バッチモードは、インストールプロセスを自動化させるべく設計されています。

バッチモードでは、確認やパラメータ入力を求めることなくインストーラが実行されます。これにより、ユーザとの対話なしで、インストールを完了まで実行することができます。設定ファイルを使用して、コマンドラインから起動できます。

設定ファイルとバッチモードでは、SAP HANA インストールはユーザとの対話なしで完全にインストールされます。これは、多数のシステムを標準設定する場合、またはシステムコピーのために週次でシステムを再デプロイする場合に役立ちます。

hdblcm および hdblcmgui はラッパツールであるため、一部のトラブルシューティングのケースでは、コンポーネントオプションを hdblcm または hdblcmgui SAP HANA ライフサイクル管理ツールの呼出と組み合わせて基礎となるコンポーネントツール (hdbinst または hdbupd) に渡すことができます。これは、インストールに問題があり、関連するコンポーネントの詳細情報が必要な場合に役立ちます。

この機能を使用することで、次のようにさまざまなユースケースに対応できます。

• インストールまたは更新の失敗の原因となったコンポーネントに関する詳細情報を取得する

• コンポーネントによって生じた問題をパラメータを使って克服する (パラメータを介してステップをスキップする、またはポートを設定するなど)

• インストールまたは更新手順において基盤となるコンポーネントによって実行された特定のステップまたはタスクを停止または無効化する (更新手順の最後に SAP HANA を起動しない、または特定のチェックをスキップするなど)

利用可能な基礎となるコンポーネントパラメータを拡張ヘルプ出力として表示するには、pass_through_helpパラメータを使用します。アクションパラメータand --helpを指定するか-h、と組み合わせてpass_through_helpを指定します。

インストールパラメータまたは更新pass_through_helpパラメータのヘルプ出力を表示するには、以下の構文を使用します。

123
--action=[install|update] --pass_through_help --help
or
--action=[install|update] --pass_through_help -h

これらのオペレーティングシステムコマンドを使用して、関連するコンポーネントの構文、説明、ユースケース (インストール、更新、製品固有の使用)、およびパスワード入力ストリームに使用される XML タグなど、インストールおよび更新手順で使用される幅広いパラメータを特定することができます。出力の最後に、トレーサを有効化したり、ログディレクトリのコピーを作成したりするための環境変数が記載されています。

デフォルトのファイルシステムにインストールされているメインコンポーネントに加えて、SAP HANA システムから一時ファイルを検索することもできます。これらは、図 "SAP HANA 一時ファイルの場所" に示すディレクトリにあります。

インストーラがクラッシュまたはループする場合は、問題が発生するまでインストーラをトレースし、CSS チケットを開き、詳細な分析のためにトレースファイルを添付することが有効な場合があります。インストーラトレースをオンにするには、環境変数HDB_INSTALLER_TRACE_FILEを<tracefilename>に設定します。トレースファイルを格納するディレクトリがすでに存在している必要があります。

SAP HANA ライフサイクル管理ツールhdblcm、およびhdblcmguiインストール時のログファイルの書込。最新のログファイルは、または/var/tmp/hdblcmgui.logで/var/tmp/hdblcm.log常に利用できます。また、ログファイルのコピーがディレクトリにhdb_<SID>_hdblcm_<action>_<timestamp>アーカイブされます。

SAP HANA ライフサイクル管理ツールhdblcmおよびhdblcmguiは、基盤となるコンポーネントインストーラのラッパであるため、コンポーネントログをチェックすることもできます。最初に、SAP HANA ライフサイクル管理ツールhdblcmおよびhdblcmguiログをレビューおよび分析することをお奨めします。問題の原因を特定のコンポーネントに絞ることができたら、コンポーネントログを使用してさらに分析します。

コンポーネントログファイルは下記のパスに格納されています。

12
/var/tmp/hdb_<SID>_hdblcm_<action>_<timestamp> 
where <action> :: = install | update | addhost | uninstall | and so on.

下記のログファイルは、<action> の実行時に書き込まれます。

• <hdbcommand>.log: テキストエディタを使用して読み込むことができます。

• <hdbcommand>.msg: GUI によるインストールツールでの表示の XML 書式

• <hostname>_tracediff.tgz: 元のトレースファイルのデルタ分析を提供し、詳細な分析を容易にします。

トレースが生成された後、トレースを開き、トレースファイルでエラーメッセージをチェックすることができます。必要に応じて SAP サポートチケットを開き、トレースファイルを添付して詳細な分析を依頼します。