N1 Grid Service Provisioning System 5.0 オペレーションとプロビジョニングガイド

付録 A エラーメッセージ

この付録では、N1 Grid Service Provisioning System ソフトウェアの一般的なエラーメッセージについて説明します。

エラーメッセージの説明

This component has not been installed on any hosts yet

説明:

アンインストールしようとしているコンポーネントがホストにインストール済みであることを、Master Server が認識しない場合に発生するエラーです。Master Server は、システム内の各コンポーネントのインストール状態を管理しています。コンポーネントがホストにインストールされたときの履歴が Master Server のデータベースに残っていないと、このコンポーネントをアンインストールすることができません。また、このコンポーネントを制御することもできません。

対処方法:

この問題を修正するには、次のようにします。

コンポーネントがホストにインストールされていることを確認します。
このコンポーネントがホストにインストールされている場合は、空のインストールブロックを使ってコンポーネントの markOnly インストールを実行し、Master Server データベースを更新します。構文は、次のとおりです。
```
<installSteps name="markOnly" />
```

017007 Plan timed out on hosts

説明:

プランのタイムアウトパラメータの設定値が小さすぎて、プランの実行に必要な時間が足りません。

例:

たとえば、プランに含まれる手順に 100 秒間の待ち時間が設定されているのに、プランのタイムアウトパラメータが 60 秒に設定されている場合、このプランは待ち時間の終了前にタイムアウトになります。

対処方法:

プランのタイムアウトパラメータには、プランの実行を完了できることを考慮しながら、適切な値を設定してください。デフォルトのタイムアウト値は 30 分です。プランの実行時間が 30 分以上になる可能性がある場合は、このプランのタイムアウトパラメータを変更してください。

017031 Unable to generate configuration file filename for host hostname

説明:

構成テンプレートに、コンポーネントの <varList> に宣言されていない変数が含まれています。

例:

たとえば、/ant/config.properties 構成テンプレートを配備するとします。この構成テンプレートに、/ant/config.properties コンポーネントの <varList> 内に宣言されていない :[port] 変数が含まれている場合、次のエラーが表示されます。

:[port] variable is undefined (040201)
Configuration file /ant/config.properties cannot be generated (017031)
Plan fails because configuration file cannot be generated (017034)

対処方法:

このエラーを防ぐには、構成テンプレートで使用する変数がコンポーネントの <varList> に宣言されていることを確認してください。構成テンプレートをチェックインすると、ファイルからプロビジョニングシステム変数が自動的にスキャンされ、コンポーネントの <varList> に追加されます。

017074 java.io.IOException:Not enough space

説明:

Remote Agent の物理メモリーが不足しているため、Remote Agent を起動できません。ディスク容量に関するエラーメッセージが表示されますが、実際には、物理メモリーの問題が原因で発生するエラーです。

例:

<execNative> 手順を 1 つ含むプランを実行した場合、Master Server ログファイル server/bin/cr_server.out に次のエラートレースが表示されます。

:NestedTrace: java.io.IOException: Not enough space
   at java.lang.UNIXProcess.forkAndExec(Native Method)
   at java.lang.UNIXProcess.(UNIXProcess.java:54)
   at java.lang.Runtime.execInternal(Native Method)
   at java.lang.Runtime.exec(Runtime.java:546)

ブラウザインタフェースには、次のエラーメッセージが表示されます。

Problems encountered during plan run or preflight

The plan (or preflight)
"/system/autogen/ldap_cmd-inst-default-1087486030740" finished with 1
failed host(s). (017034)

Error executing the exec native command "/usr/bin/pfksh". (017074)
Not enough space
plan : /system/autogen/ldap_cmd-inst-default-1087486030740
version : 1.11 version history | run history

対処方法:

物理メモリーの問題を修正するには、cr_agent スクリプトで、最小 JVM^TM [「Java 仮想マシン」と「JVM」という用語は、Java^TM プラットフォームの仮想マシンを表しています。] ヒープサイズを小さくします。次の手順を実行します。

Remote Agent の実行サーバーで、Remote Agent スクリプトが格納されているディレクトリに移動します。
# cd /N1SPS50-home/agent/bin
N1SPS50-home は、Remote Agent のインストールディレクトリです。
JVM ヒープサイズのプロパティを変更します。
CR_JVM_MEMORY=-Xms32m -Xmx256m
-Xms 32m は最小ヒープサイズ設定です。
サーバーを再起動します。

030005 Expecting "0" subplan component builds in component build array "0".

説明:

このエラーは、CLI からプランを実行しているときに発生します。cr_cli コマンドを使ってプランを実行する際、-comp + オプションや -vs + オプションを指定すると、コンポーネントはまったくインストールされず、上記のようなエラーメッセージが表示されます。

例:

たとえば、次の cr_cli プラン実行コマンドを実行したとします。

% cr_cli -cmd pe.p.run -u bmclean -p password  \ 
-PID NM:/app/Weblogic/RollingWeblogicRestart \
-tar H:NM:dev-prf30 -pto 600s -nto 600s -comp + -vs +

この場合、次のエラーが表示されます。

Expecting "0" subplan component builds in component build array "0". (030005)

プロビジョニングシステムのブラウザインタフェースを使用したときは、同じターゲットホストを指定して、同じプランを正常に実行することができました。このプランの XML コンテンツは次のとおりです。

<?xml version="1.0" encoding="UTF-8"?>
<!-- generated by N1 SPS -->
<executionPlan xmlns="http://www.sun.com/schema/SPS" 
name="RollingWeblogicRestart" version="4.1" 
description="Restart Weblogic instances on target hosts in series" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" path="/app/Weblogic" 
xsi:schemaLocation="http://www.sun.com/schema/SPS plan.xsd">


<simpleSteps executionMode="SERIES">
 <call blockName="restartAppServer">
  <installedComponent name="WeblogicUtil" path="/app/Weblogic"/>
 </call>
</simpleSteps>
</executionPlan>

このプランでは、コンポーネントはまったくインストールされません。以前にインストールされたコンポーネントに対する制御 (呼び出しブロック) が呼び出されるだけです。したがって、コンポーネントや変数セットを指定する必要はありません。

対処方法:

この問題を防ぐには、コンポーネントをインストールしないプランの実行時には、コマンド行に -comp + オプションや -vs + オプションを指定しないようにします。

040201 Substitution variable :target:port is undefined

説明:

ターゲットホストのホスト属性からコンポーネント内のターゲット属性を得ることができないときに発生するエラーです。

例:

たとえば、/ant/config.properties 構成テンプレートを配備するとします。コンポーネントの varList には、デフォルト値 :[target:port] の変数が含まれています。配備先ホストには、port 変数の値を求めるホスト属性がありません。

対処方法:

この問題を防ぐには、配備先のホストに、コンポーネント内のターゲット変数の値を求めるホスト属性セットがあることを確認してください。