Icon indicating 6.0.1 content only

WebSphere Process Server バージョン 6.0.1 で使用できる manageprofiles コマンド

manageprofiles コマンド行ツールは、WebSphere Process Server のランタイム環境を作成または拡張するときに使用できます。このコマンドを使用すると、プロファイル (デプロイメント・マネージャーのランタイム環境を定義する一連のファイル)、カスタム・プロファイル、またはスタンドアロン・プロファイルを管理できます。このコマンドは、プロファイルの作成、削除、拡張、拡張解除、リスト作成、または検証を行うときに使用できます。

manageprofiles コマンドは、プロファイル・ウィザード (グラフィック・モードまたはサイレント応答ファイルと共に使用できる) に加えた、プロファイル作成のもう 1 つの方法です。ほとんどの場合、プロファイル作成方法として、プロファイル・ウィザードまたは応答ファイル (これもまたプロファイル・ウィザードを活動化しますが、「サイレントに」行います) を使用するだけで十分です。 しかし、上級者であれば、状況によっては manageprofiles コマンドの使用が適していることがあります。例えば、プロファイルを拡張解除した後で削除する場合は、manageprofiles コマンドを使用する必要があります。プロファイル・ウィザードはこのような機能を備えていないためです。プロファイルを削除するためには、事前にプロファイルを拡張解除する必要があることに注意してください。

最初にプロファイルを作成または拡張するために、プロファイル・ウィザード (サイレント・インストールを含む) を使用したとき、コマンド行でのプロファイル作成または拡張の処理がログ・ファイルに書き込まれます。 ログ・ファイルからこのコマンド行を抽出して、そのうちの特定の部分を慎重に変更し、これを使用して、ほかのプロファイルを作成または拡張することができます。

重要: WebSphere Process Server では、最初にプロファイル・ウィザードまたはサイレント・インストール・プロセスを使用して新規プロファイルの作成、または既存の WebSphere Application Server プロファイルの拡張を行い、manageprofiles コマンドを使用するのは、このようなプロファイルや拡張を「コピー」する場合、またはよく似たプロファイルを作成する場合に限定することを、IBM では強くお勧めしています。manageprofiles コマンドを使用したプロファイルの作成および拡張 で、この手順を段階的に説明しています。

使用法

WebSphere Process Server での manageprofiles コマンドの使用は、必ずmanageprofiles コマンドを使用したプロファイルの作成および拡張の説明に従って行ってください。
制約事項:
wasprofile コマンドを使用して、WebSphere Process Server プロセスを変更しないでください。

プロファイルのタイプ

各プロファイルのテンプレートは、install_root/profileTemplates ディレクトリー内にあります。 このディレクトリー内に、各プロファイル・タイプに対応するさまざまなディレクトリーがあります。各ディレクトリーは、manageprofiles コマンドを -templatePath オプションを指定して使用するときに指定するパスになります。 インストール・ルートの外部にプロファイル・テンプレートがある場合、このようなプロファイル・テンプレートを指定することもできます。WebSphere Process Server で使用する必要のあるテンプレートを以下に示します。
  • default.wbiserver: スタンドアロン・プロファイル用
  • managed.wbiserver: カスタム・プロファイル用
  • dmgr.wbiserver: デプロイメント・マネージャー・プロファイル用

コマンド・ファイルのロケーション

コマンド・ファイルは、install_root/bin ディレクトリー内にあります。 コマンド・ファイルは、Linux および UNIX プラットフォームでは manageprofiles.sh、Windows プラットフォームでは manageprofiles.bat という名前のスクリプトです。

ロギング

manageprofiles を起動するたびに、install_root/logs/wasprofile ディレクトリーに 2 つのログが作成されます。
  • wasprofile_<mode>_profile_name.log には、manageprofiles コマンドによって実行されたアクションの詳細が記録されます。
  • manageProfiles-<mode>-profile_name.log には、特定の起動に適用されたテンプレートおよびその戻りコードの非常に簡潔な説明が記録されます。
例えば、manageprofiles コマンド manageprofiles_create_profile1 では、次の 2 つのログ・ファイルが作成されます。
  • install_root/logs/wasprofile/wasprofile_create_profile1.log
  • install_root/logs/wasprofile/manageProfiles-create-profile1.log

manageprofiles.sh コマンド構文

Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合: プロファイルに関する情報の取得、プロファイルの削除、またはプロファイルの拡張解除を行う場合は、manageprofiles コマンドで以下の構文およびパラメーターを使用します。manageprofiles を使用してプロファイルを作成または拡張する場合は、manageprofiles コマンドを使用したプロファイルの作成および拡張の説明に従ってください。

既存プロファイルをリストする場合:
# ./manageprofiles.sh -listProfiles
                 
プロファイルの最新の拡張を削除する場合:
# ./manageprofiles.sh -unaugment
              -profileName  profile_name 
プロファイルを削除する場合:
注: プロファイルを削除する前に、プロファイルからすべての拡張を除去する必要があります。除去しないと、予期しない結果が発生することがあります。
# ./manageprofiles.sh -delete
                -profileName profile_name | -profilePath profile_path
                
既存プロファイルのパスから既存プロファイルの名前を取得する場合:
# ./manageprofiles.sh -getName
                 -profilePath profile_path
                
既存プロファイルの名前から既存プロファイルのパスを取得する場合:
# ./manageprofiles.sh -getPath
                 -profileName  profile_name                 
プロファイル・レジストリーの整合性を確認する場合:
# ./manageprofiles.sh -validateRegistry
                
プロファイル・レジストリーの整合性を確認して、見つからなかったプロファイルを除去する場合:
# ./manageprofiles.sh -validateAndUpdateRegistry
                 [-backup file_name]
                
このコマンドのヘルプを表示する場合:
# ./manageprofiles -help

# ./manageprofiles -option_name -help

manageprofiles.bat コマンド構文

Icon indicating Windows platforms Windows プラットフォームの場合: 既存プロファイルをリストする場合:
manageprofiles -listProfiles
プロファイルの最新の拡張を削除する場合:
manageprofiles -unaugment
               -profileName  profile_name 
プロファイルを削除する場合:
注: プロファイルを削除する前に、プロファイルからすべての拡張を除去する必要があります。除去しないと、予期しない結果が発生することがあります。
manageprofiles -delete
              -profileName profile_name | -profilePath profile_path
            

既存プロファイルのパスから既存プロファイルの名前を取得する場合:
manageprofiles -getName
               -profilePath fully_qualified_profile_path
             
既存プロファイルの名前から既存プロファイルのパスを取得する場合:
manageprofiles -getPath
               -profileName  profile_name              
プロファイル・レジストリーの整合性を確認する場合:
manageprofiles -validateRegistry
             
プロファイル・レジストリーの整合性を確認して、見つからなかったプロファイルを除去する場合:
manageprofiles -validateAndUpdateRegistry
             [-backup file_name]
             
このコマンドのヘルプを表示する場合:
manageprofiles -help

manageprofiles -option_name -help

パラメーター

WebSphere Process Server で manageprofiles コマンドと共に使用するパラメーターのリストと説明については、manageprofiles のパラメーターを参照してください。

コマンドの出力

各コマンドでは、完了時にコマンド行に以下のいずれかの文が出力されます (ただし、manageprofiles の呼び出し時のモードによって正確な表現は異なります)。
  • INSTCONFSUCCESS: プロファイルが正常に作成されました。(INSTCONFSUCCESS: Profile creation succeeded.)
  • INSTCONFFAILED: プロファイル作成が失敗しました。(INSTCONFFAILED: Profile creation failed.)
  • INSTCONFPARTIALSUCCESS: 一部の重要でないインストール後構成アクションが正常に実行されませんでした。(INSTCONFPARTIALSUCCESS: Some non-critical post installation configuration actions did not succeed.)
場合によっては、記述が複数回出力されることがあります。例えば、INSTCONFSUCCESS 行はコマンド行に 3 度出力されます。
関連タスク
manageprofiles コマンドを使用したプロファイルの作成および拡張
関連資料
manageprofiles のパラメーター

ご利用条件 |


(c) Copyright IBM Corporation 2005, 2006.
本製品では Eclipse テクノロジーが採用されています。(http://www.eclipse.org)