manageprofiles コマンド

manageprofiles コマンドを使用して、ランタイム環境を定義するプロファイルの作成、削除、バックアップ、およびリストアを行います。 複数の製品をインストールする代わりに プロファイルを使用すれば、ディスク・スペースを節約できるうえに、コア・プロダクト・ファイルの単一セット だけを保守すればよいため、製品の更新が簡素化されます。

コマンドファイルは app_server_root/bin ディレクトリにあります。 コマンド・ファイルは、manageprofiles という名前のスクリプトです。

注: z/OS では、直接 manageprofiles.sh 実行によるプロファイルの作成はサポートされていません。
注意： このコマンドをマネージドプロファイルテンプレートと併用した場合、アプリケーションサーバーは作成されません。 ただし、ノードをフェデレートしている場合、ポートは引き続き使用されます。
重要: のデフォルト動作 manageprofiles は、システム全体の umask を無視して、権限 755 のファイルを作成することです。 このアクセス権を変更したい場合は、あるユーザーから別のユーザーにプロファイルを渡すたびに chmod コマンドを使用してください。

構文

manageprofiles コマンドは、以下の操作を実行するために使用します。
  • プロファイルを作成する (-create)
  • プロファイルを削除する (-delete)
  • プロファイルを拡張する (-augment)
  • プロファイルを拡張解除する (-unaugment)
  • 特定の拡張テンプレートで拡張されたすべてのプロファイルを拡張解除する (-unaugmentAll)
  • すべてのプロファイルを削除する (-deleteAll)
  • すべてのプロファイルをリストする (-listProfiles)
  • プロファイルの拡張部分をリストする (-listAugments)
  • プロファイル名を取得する (-getName)
  • プロファイル・パスを取得する (-getPath)
  • プロファイル・レジストリーを確認する (-validateRegistry)
  • プロファイル・レジストリーを確認し、更新する (-validateAndUpdateRegistry)
  • デフォルト・プロファイル名を取得する (-getDefaultName)
  • プロファイルをバックアップする (-backupProfile)
  • プロファイルをリストアする (-restoreProfile)
  • 応答ファイルに含まれている manageprofiles コマンド・タスクを実行する (-response)
manageprofiles コマンドで達成された各タスクの必須パラメーターを含む詳細なヘルプを見るためには、-help パラメーターを使用します。 次の例は、Windows オペレーティングシステムで コマンド -augmentmanageprofiles にヘルプ パラメーターを使用するものです:
app_server_root\bin\manageprofiles.bat -augment -help

manageprofiles コマンドで実行したい操作に応じ、以下のパラメーターの 1 つ以上を提供する必要があります。 コマンド行ツールは、必須パラメーターが提供されているかどうか、またそれらのパラメーターに入力された値が有効であるかどうかを確認します。 コマンド行ツールはパラメーター名の大文字と小文字の区別を検証しないため、パラメーターの名前は、大文字と小文字を正確に区別して入力してください。 パラメーターの大/小文字が正しく入力されないと、誤った結果が生じる場合があります。

  • -adminPassword adminPassword
  • -adminUserName adminUser_ID
  • -applyPerfTuningSetting standard | peak | development
  • -appServerNodeName アプリケーションサーバーノード名
  • -augment
  • -backupFile backupFile_name
  • -backupProfile
  • -cellName cell_name (オプション・パラメーター)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -dmgrAdminPassword パスワード
  • -dmgrAdminUserName ユーザー名
  • -dmgrHost dmgr_host_name (オプション・パラメーター)
  • -dmgrPort dmgr_ポート番号
  • -dmgrProfilePath dmgr_profile_path
  • -enableAdminSecurity true | false
  • -federateLater true | false
  • -getDefaultName
  • -getPath
  • -getName
  • -help
  • -hostName ホスト名
  • -ignoreStack (オプション・パラメーター)
  • -importPersonalCertKS キーストアのパス
  • -importPersonalCertKSAlias キーストアエイリアス
  • -importPersonalCertKSPassword キーストアのパスワード
  • -importPersonalCertKSType キーストアの種類
  • -importSigningCertKS キーストアのパス
  • -importSigningCertKSAlias キーストアエイリアス
  • -importSigningCertKSPassword キーストアのパスワード
  • -importSigningCertKSType キーストアの種類
  • -isDefault
  • -isDeveloperServer
  • -keyStorePassword キーストアのパスワード
  • -listAugments
  • -listProfiles
  • -nodeDefaultPorts
  • -nodeName ノード名
  • -nodePortsFile ノードポートファイルパス
  • -node ProfilePathnode_profile_path
  • -omitAction feature1 feature2... featureN (オプションのパラメータ)
  • -personalCertDN 区別名
  • -personalCertValidityPeriod validity_period (オプション・パラメーター)
  • -portsFile file_path (オプション・パラメーター)
  • -profileName プロフィール名
  • -profilePath プロファイルルート
  • -応答 応答ファイル
  • -restoreProfile
  • -securityLevel セキュリティレベル
  • -serverName サーバー名
  • -serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
  • -setDefaultName
  • -signingCertDN 区別名
  • -signingCertValidityPeriod validity_period (オプション・パラメーター)
  • -startingPort starting_port | -portsFile ports_file_path | -defaultPorts
  • -supportedProtocols サポートされているプロトコル
  • -templatePath テンプレートパス
  • -unaugment
  • -unaugmentAll
  • -unaugmentDependents
  • -validateAndUpdateRegistry
  • -validatePorts
  • -validateRegistry
  • -webServerCheck true | false
  • -web サーバーホスト名webserver_host_name
  • -webServerInstallPath ウェブサーバーインストールパス名
  • -webServerName ウェブサーバー名
  • -webServerOS ウェブサーバーのオペレーティングシステム
  • -webServerPluginPath ウェブサーバープラグインパス
  • -webServerPort ウェブサーバーポート
  • -webServerType ウェブサーバーの種類
以下の例は、 AIX® や Linux® などのオペレーティングシステムで コマンド -createmanageprofiles を使用しています:
app_server_root/bin/manageprofiles.sh -create 
   -profileName profile_name 
   -profilePath profile_root 
   -templatePath template_path

パラメーター

manageprofiles コマンドで使用可能なオプションは、以下のとおりです。

-adminPassword adminPassword
-adminUserName パラメーターで指定された管理セキュリティー・ユーザー ID のパスワードを指定します。
-adminUserName adminUser_ID
管理セキュリティーに使用されるユーザー ID を指定します。
-applyPerfTuningSetting オプション
アプリケーション・サーバーが実行される環境のタイプに最も近いパフォーマンス・チューニング設定を指定します。

このパラメーターは、デフォルト・プロファイル・テンプレートの場合に限り有効です。

standard
standard 設定は、汎用目的で使用するために最適化された、標準的な出来合いのデフォルト構成設定です。
ピーク (peak)
peak パフォーマンス設定は、アプリケーションの変更がほとんど行われず、最適なランタイム・パフォーマンスが重要である実稼働環境に合わせて最適化されています。
development
development 設定は、アプリケーションの更新が頻繁に行われ、システム・リソースが最小限である開発環境に最適化されています。
重要： 本番サーバーでは開発設定を使用しないでください。

-applyPerfTuningSetting パラメーターでオプションを指定しない場合のデフォルト値は、standard です。

-isDeveloperServer パラメーターと -applyPerfTuningSetting パラメーターの両方を指定すると、-applyPerfTuningSetting に選択されたオプションによっては、-applyPerfTuningSetting が -isDeveloperServer をオーバーライドすることがあります。

-appServerNodeName アプリケーションサーバーノード名
セルに統合しているアプリケーション・サーバーのノード名を指定します。 セルのデプロイメント・マネージャー部分、およびアプリケーション・サーバー部分を作成するときには、このパラメーターを指定します。
-augment
拡張テンプレートで既存のプロファイルを変更するには、augment パラメーターを使用します。 augment パラメーターを使用すると、manageprofiles コマンドは、-templatePath パラメーターのテンプレートを使用して、-profileName パラメーターで示されたプロファイルを更新または拡張します。 使用可能な拡張テンプレートは、環境内にインストールされている IBM® 製品およびバージョンによって決定されます。
重要：WebSphere Application Server ネットワーク展開製品に同梱されているテンプレートは、プロファイルの作成にのみ使用でき、既存のプロファイルを拡張することはできません。これは、製品には作成専用テンプレートのみが含まれているためです。

また、install_dir/ profileTemplates ディレクトリー内にあるファイルを手動で変更しないでください。 例えば、プロファイル作成中にポートを変更する場合、 プロファイル・テンプレート・ディレクトリー内のファイルを変更するのではなく、manageprofiles コマンド に対して -startingPort 引数または -portsFile 引数を使用します。

プロファイルテンプレートが app_server_root/profileTemplates ディレクトリを基準としている場合は、パラメータ -templatePath に対して相対パスを指定できます。 それ以外の場合は、完全修飾テンプレート・パスを指定します。 例:
 manageprofiles -augment -profileName profile_name -templatePath template_path

-unaugment パラメーターも参照してください。

-backupFile backupFile_name
プロファイル・レジストリー・ファイルを、指定したファイルにバックアップします。 backupFile_name の完全修飾ファイル・パスを提供する必要があります。
-backupProfile
プロファイル・フォルダー、およびプロファイル・レジストリー・ファイルからのプロファイル・メタデータのファイル・システム・バックアップを実行します。 バックアップ対象のプロファイルを使用しているサーバーは、`` -backupProfile オプション付きで` manageprofiles `コマンドを実行する前に、必ず停止させてください。 この -backupProfile パラメータは、および -profileName-backupFile パラメータと組み合わせて使用する必要があります。例：
manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name

-backupProfile オプションを使用してプロファイルをバックアップする場合は、まずサーバーとバックアップしたいプロファイルの実行中プロセスを停止する必要があります。

-cellName cell_name (オプション・パラメーター)
プロファイルのセル名を指定します。 各プロファイルごとに固有のセル名を使用します。
トラブルを回避するには： カスタムプロファイルまたはスタンドアロンプロファイルをデプロイメントマネージャーセルにフェデレーションする予定であっても、一意の名前を使用してください。 統合によってデプロイメント・マネージャー・セルのノード部分を作成する前に、固有のセル名を指定する必要があります。 セル名は、同じ物理マシンまたはマシンのクラスター (SYSPLEX など) 上の、製品が稼働する環境では、どこでも固有でなければなりません。 またセル名は、エンティティー間のネットワーク接続が、セル間で、または各セルとの通信が必要なクライアントから要求されるような環境では、どこでも固有でなければなりません。 さらに、 セル名の名前空間が統合される場合も、セル名が固有である必要があります。 セル名が固有でないと、javax.naming.NameNotFoundException エラーのような症状が起こり、 その場合には、固有名を持つセルを作成する必要があります。

これはオプション・パラメーターです。 このパラメーターを省略すると、デフォルトのセル名が割り当てられます。

デフォルトのセル名は、以下のとおりです。
  • dmgr テンプレート: profilenameNetwork
  • デフォルトのテンプレート: shorthostname_profilename
  • managed テンプレート: shorthostname_profilename
  • セル・テンプレート: 作成される 2 つのプロファイルに関して前に示した dmgr の例と同じです。

このパラメーターの値には、スペースまたは *、?、"、<、>、,、/、\、|、などの無効な文字を含めることができません。

-create
プロファイルを作成します。
プロファイルの作成に関する特定の情報を見るためには、manageprofiles -create -templatePath fully_qualified_file_path_to_template -help を指定してください。 使用可能なテンプレートには、以下のようなものがあります。
  • cell - デプロイメント・マネージャー・セル (dmgr および default)
  • management - Management. -serverType パラメーターを合わせて使用することで、 管理プロファイルのタイプを指定します。
  • secureproxy- Secure proxy
  • default - アプリケーション・サーバー
  • managed - カスタム
-debug
manageprofiles コマンドで使用する Ant ユーティリティーのデバッグ機能をオンにします。 詳細なAntの出力は、ディレクトリ app_server_root/logs/directorymanageprofiles 内の名前で始まるログファイル内の manageprofiles コマンドからのログと結合されます。
-personalCertValidityPeriod validity_period (オプション・パラメーター)
デフォルトの個人証明書の有効期間を年単位で指定するオプション・パラメーター。 -personalCertDN パラメーターを指定するときに、このパラメーターを一緒に指定しなければ、デフォルトの個人証明書の有効期間は 1 年になります。
-defaultPorts
デフォルトまたは基本のポート値をプロファイルに割り当てます。

-startingPort または -portsFile パラメーターを使用する場合は、このパラメーターを使用しないでください。

プロファイル作成時、`-p` -startingPort パラメータ、`-p` -defaultPorts パラメータ、または `-p` -portsFile パラメータを指定しない場合、`-p` manageprofiles コマンドは自動的に生成された推奨ポートのセットを使用します。 推奨されるポート値は、デフォルト・ポートの可用性に基づくデフォルト・ポート値とは異なっている場合があります。

注意： マネージド プロファイル テンプレートを使用している場合は、このパラメーターを使用しないでください。
-delete
プロファイルを削除します。

手動でディレクトリーを削除しなくても、再作成するためにプロファイルを削除すると、プロファイル・ディレクトリーが削除されます。

プロファイル・レジストリーで拡張テンプレートが登録されているプロファイルを削除する場合、拡張解除アクションが自動的に実行されます。

トラブルを回避するには： 移行済みの古いノードを削除する場合、古いノードを削除する前に、新しく移行されたデプロイメントマネージャーをシャットダウンしてください。 これにより、マイグレーションされた新規ノードが、マイグレーションされた新規セルから誤って削除されることがなくなります。
-deleteAll
すべての登録済みプロファイルを削除します。

再作成時に古くなった情報を管理しなくても済むようにするためプロファイルを削除すると、プロファイル・ディレクトリーが削除されます。

プロファイル・レジストリーで拡張テンプレートが登録されているプロファイルを削除する場合、拡張解除アクションが自動的に実行されます。

-dmgrAdminPassword パスワード
ノードを統合するときに、デプロイメント・マネージャーで管理セキュリティーが有効になっている場合は、そのデプロイメント・マネージャーの有効なユーザー名を指定します。 このパラメーターは、-dmgrAdminUserName パラメーター、-federateLater パラメーターと一緒に使用します。
-dmgrAdminUserName ユーザー名
ノードを統合するときに、デプロイメント・マネージャーで管理セキュリティーが有効になっている場合は、そのデプロイメント・マネージャーの有効なパスワードを指定します。 このパラメーターは、-dmgrAdminPassword パラメーター、-federateLater パラメーターと一緒に使用します。
-dmgrHost dmgr_host_name (オプション・パラメーター)
デプロイメント・マネージャーが稼働しているマシンを識別します。 カスタム・プロファイルを作成時に統合する場合は、このパラメーターと dmgrPort パラメーターを指定します。

ホスト名は、デプロイメント・マネージャー・マシンのロングまたはショートの DNS 名か、 IP アドレスです。

このオプション・パラメーターを指定すると、manageprofiles コマンドは、managed の -templatePath パラメーターに基づいてカスタム・プロファイルを作成するときに、デプロイメント・マネージャー・セルにカスタム・ノードを統合しようとします。 デプロイメント・マネージャー・プロファイルまたはアプリケーション・サーバー・ プロファイルを作成する際には、-dmgrHost パラメーターは無視されます。

セキュリティーが有効になっているなどの理由で、デプロイメント・マネージャーが稼働していないか、または使用不可である場合に、カスタム・ノードを統合すると、ログのインストール・インディケーターは INSTCONFFAIL となり、完全な失敗を示します。 結果として、カスタム・プロファイルは使用することができません。 同じプロファイル名で他のカスタム・プロファイルを作成する前に、 カスタム・プロファイル・ディレクトリーをプロファイル・リポジトリー (プロファイル・ インストール・ルート・ディレクトリー) から移動する必要があります。

セキュリティーが使用可能になっていたり、 デフォルトの JMX コネクター・タイプが変更されていたりする場合は 、manageprofiles コマンドで統合することができません。 代わりに 、addNode コマンドを使用してください。

このパラメーターのデフォルト値は localhost です。 このパラメーターの値は、適切な形式のホスト名でなければならず、スペース、および *、?、"、<、>、,、/、&#xa5;、| などの無効の文字を含んでいてはなりません。 また、デプロイメント・マネージャーへの接続も dmgrPort パラメーターとともに使用可能になっていなければなりません。

-dmgrPort dmgr_ポート番号
デプロイメント・マネージャーの SOAP ポートを識別します。 カスタム・プロファイルを作成時に統合する場合は、このパラメーターと dmgrHost パラメーターを指定します。 デプロイメント・マネージャーは稼働中で、かつアクセス可能な状態に なっている必要があります。

セキュリティを有効化している場合、またはデフォルトの Java™ Management Extensions （ JMX ）コネクタの種類を変更している場合、`federate` manageprofiles コマンドによるフェデレーションは実行できません。 代わりに 、addNode コマンドを使用してください。

このパラメーターのデフォルト値は 8879 です。 ユーザーが指示するポートは正整数でなければならず、デプロイメント・マネージャーへの接続が dmgrHost パラメーターとともに使用可能になっていなければなりません。

-dmgrProfilePath dmgr_profile_path
セルのデプロイメント・マネージャー部分へのプロファイル・パスを指定します。 セルのアプリケーション・サーバー部分を作成するときには、このパラメーターを指定します。
-enableAdminSecurity true | false
管理セキュリティーを使用可能にします。 有効な値は、true または false です。 デフォルト値はfalseです。
enableAdminSecurity を true に設定する場合、これらのパラメーターの値とともに -adminUserName および -adminPassword パラメーターも指定する必要があります。

-enableAdminSecurity パラメーターを使用して、カスタム・プロファイルの管理セキュリティーを有効にすることはできません。 カスタム・プロファイルでセキュリティーを有効にするには、カスタム・プロファイルをデプロイメント・マネージャーに統合する必要があります。 統合したカスタム・プロファイルでセキュリティーを有効にするには、デプロイメント・マネージャーで管理セキュリティーが有効になっていなければなりません。

-federateLater true | false
管理対象プロファイルがプロファイル作成中に統合されるのか、または後で addNode コマンドを使用して統合するのかを示します。 dmgrHost、dmgrPort、dmgrAdminUserName および dmgrAdminPassword パラメーターが値を持っていない場合、 このパラメーターのデフォルト値は true です。 有効な値は、true または false です。
-getDefaultName
デフォルト・プロファイルの名前を戻します。
-getPath
特定の名前のプロファイルのファイル・システム・ロケーションを取得します。 -profileName パラメーターが必要です。
-getName
特定の -profilePath パラメーターで登録済みのプロファイル名を取得します。
-help
コマンド構文を表示します。
-hostName ホスト名
プロファイルを作成するホストの名前を指定します。 初期製品のインストール中に指定したホスト名と一致している必要があります。 このパラメーターのデフォルト値は、 ドメイン名システムの長い形式です。 このパラメーターの値は、有効な IPv6 ホスト名である必要があり、それにはスペースまたは *、?、"、<、>、,、/、\、|、などの無効な文字を含めることができません。
-ignoreStack (オプション・パラメーター)
-templatePath パラメーターと併用するオプション・パラメーターで、特定の拡張済みプロファイルを拡張解除するために使用します。 -unaugment パラメーターを参照してください。
-importPersonalCertKS キーストアのパス
プロファイルの作成時に個人証明書をインポートするために使用する鍵ストア・ファイルのパスを指定します。 その個人証明書は、サーバーのデフォルトの個人証明書になります。
ベストプラクティス: 個人証明書をデフォルトの個人証明書としてインポートする際は、その個人証明書に署名したルート証明書もインポートしてください。 インポートしない場合は、manageprofiles コマンドにより個人証明書の公開鍵が trust.p12 ファイルに追加され、ルート署名証明書が作成されます。
-importPersonalCertKS パラメーターは、-personalCertDN と相互排他のパラメーターです。 個人証明書を明示的に作成またはインポートしない場合は、デフォルトで個人証明書が作成されます。

-importPersonal で始まるいずれかのパラメーターを指定する場合は、-importPersonal で始まるすべてのパラメーターを指定する必要があります。

-importPersonalCertKSAlias キーストアエイリアス
-importPersonalCertKS パラメーターで指定する鍵ストア・ファイルに含まれている証明書の別名を指定します。 その証明書は、サーバーのデフォルトの鍵ストア・ファイルに追加され、サーバーのデフォルトの個人証明書として使用されます。

-importPersonal で始まるいずれかのパラメーターを指定する場合は、-importPersonal で始まるすべてのパラメーターを指定する必要があります。

-importPersonalCertKSPassword キーストアのパスワード
-importPersonalCertKS パラメーターで指定する鍵ストア・ファイルのパスワードを指定します。

-importPersonal で始まるいずれかのパラメーターを指定する場合は、-importPersonal で始まるすべてのパラメーターを指定する必要があります。

-importPersonalCertKSType キーストアの種類
-importPersonalCertKS パラメーターで指定した鍵ストア・ファイルのタイプを指定します。 値は、JCEKS、CMSKS、PKCS12、PKCS11、および JKS です。 ただし、このリストは、java.security ファイルで記述されているプロバイダーによって変わる場合があります。

-importPersonal で始まるいずれかのパラメーターを指定する場合は、-importPersonal で始まるすべてのパラメーターを指定する必要があります。

-importSigningCertKS キーストアのパス
プロファイルの作成時にルート証明書をインポートするために使用する鍵ストア・ファイルのパスを指定します。 そのルート証明書は、サーバーのデフォルトのルート証明書として使用する証明書です。 -importSigningCertKS パラメーターは、-signingCertDN と相互排他のパラメーターです。 ルート証明書を明示的に作成またはインポートしない場合は、デフォルトでルート証明書が作成されます。

-importSigning で始まるいずれかのパラメーターを指定する場合は、-importSigning で始まるすべてのパラメーターを指定する必要があります。

-importSigningCertKSAlias キーストアエイリアス
-importSigningCertKS パラメーターで指定する鍵ストア・ファイルに含まれている証明書の別名を指定します。 その証明書は、サーバーのデフォルトのルート鍵ストアに追加され、サーバーのデフォルトのルート証明書として使用されます。

-importSigning で始まるいずれかのパラメーターを指定する場合は、-importSigning で始まるすべてのパラメーターを指定する必要があります。

-importSigningCertKSPassword キーストアのパスワード
-importSigningCertKS パラメーターで指定する鍵ストア・ファイルのパスワードを指定します。

-importSigning で始まるいずれかのパラメーターを指定する場合は、-importSigning で始まるすべてのパラメーターを指定する必要があります。

-importSigningCertKSType キーストアのパス
-importSigningCertKS パラメーターで指定した鍵ストア・ファイルのタイプを指定します。 有効な値は、JCEKS、CMSKS、PKCS12、PKCS11、および JKS です。 ただし、このリストは、java.security ファイルで記述されているプロバイダーによって変わる場合があります。

-importSigning で始まるいずれかのパラメーターを指定する場合は、-importSigning で始まるすべてのパラメーターを指定する必要があります。

-isDefault
付随する -profileName パラメーターによって識別されたプロファイルが、登録されるとデフォルト・プロファイルになることを指定します。 デフォルト・プロファイルを処理するコマンドを発行するときには、コマンドの -profileName 属性を使用する必要はありません。
-isDeveloperServer
サーバーが開発のみを目的としていることを指定します。 このパラメーターは、実動アプリケーション・サーバーにアプリケーションをデプロイする前に、非実動サーバーでそのアプリケーションを検査するためのプロファイル作成時に役立ちます。

このパラメーターは、デフォルト・プロファイル・テンプレートの場合に限り有効です。

-isDeveloperServer パラメーターと -applyPerfTuningSetting パラメーターの両方を指定すると、-applyPerfTuningSetting に選択されたオプションによっては、-applyPerfTuningSetting が -isDeveloperServer をオーバーライドすることがあります。

-keyStorePassword キーストアのパスワード
プロファイルの作成時に作成するすべての鍵ストア・ファイルで使用するパスワードを指定します。 デフォルトの個人証明書とルート署名証明書のために鍵ストア・ファイルを作成します。
-listAugments
プロファイル・レジストリーに登録されているプロファイルの引数のリストを表示します。 -listAugments パラメーターと一緒に -profileName パラメーターを指定する必要があります。
-listProfiles
プロファイル・レジストリー内のプロファイルをリストします。
-nodeDefaultPorts
セル・テンプレートとともにプロファイルを作成するとき、ポートのセットを定義します。 このオプションを指定する場合、-nodePortsFile オプションまたは nodeStartingPort オプションを同時に指定することはできません。
-nodeName ノード名
新規プロファイルを使用して作成されたノードのノード名を指定します。 セルまたはマシンで固有の値を使用します。 製品バイナリーの同じセットを共用する各プロファイルは、 固有のノード名を持つ必要があります。
以下のデフォルト・ノード名があります。
  • デプロイメント・マネージャー、管理エージェント、ジョブ・マネージャーの管理テンプレート: profilenameManager
  • デフォルトのテンプレート: shorthostname_profilename
  • managed テンプレート: shorthostname_profilename
  • セル: 前の管理とデフォルト・テンプレートの例を参照し、作成される 2 つのプロファイルに適切に適用します。
  • secureproxy テンプレート: shorthostname_profilename

このパラメーターの値には、スペースまたは *、?、"、<、>、,、/、\、|、などの無効な文字を含めることができません。

-nodePortsFile ノードポートパス
作成しているセルのノード部分のポートを指定します。 このオプションを指定する場合、-nodeDefaultPorts または -nodeStartingPort オプションを同時に指定することはできません。
-nodeProfilePath ノードプロファイルパス
セルのノード部分へのプロファイル・パスを指定します。 セルのデプロイメント・マネージャー部分を作成するときには、このパラメーターを指定します。
-omitAction feature1 feature2... featureN (オプションのパラメータ)
プロファイル機能を除外するオプション・パラメーター。
それぞれのプロファイル・テンプレートには特定のオプション機能が事前定義されています。 以下のオプション機能は、以下のプロファイル・テンプレートに関して -omitAction パラメーターで使用できます。
  • default - アプリケーション・サーバー
    • deployAdminConsole
    • defaultAppDeployAndConfig
    • deployIVTApplication
  • 管理 - デプロイメントマネージャー、管理エージェント、またはジョブマネージャーの管理プロファイル
    • deployAdminConsole
  • cell - dmgr とデフォルト・プロファイル・テンプレートの両方で構成されるデプロイメント・マネージャー・セル
    • cell_dmgr (セル・プロファイルの作成中に作成された dmgr)
      • deployAdminConsole
      • defaultAppDeployAndConfig
-personalCertDN 区別名
プロファイルの作成時に作成する個人証明書の識別名を指定します。 指定する識別名は引用符で囲みます。 そのデフォルトの個人証明書は、サーバーの鍵ストア・ファイルに配置されます。 -importPersonalCertKSType パラメーターは、-personalCertDN と相互排他のパラメーターです。 -personalCertValidityPeriod パラメーターと -keyStorePassword パラメーターを参照してください。
トラブルを避ける：
  • [9.0.5.5 以降]プロファイルの作成時に、サブジェクト代替名 (SAN) フィールドに確実にデータが取り込まれるようにするには、証明書のサブジェクト識別名に英字、数字、ハイフンのみを使用する必要があります。 その他の文字を使用すると、プロファイルを作成できません。 この基準は、修正プログラムパック、バージョン 9.0.5.5 からバージョン 9.0.5.7 まで適用されます。
  • [9.0.5.8 以降]Fix Pack バージョン 9.0.5.8 以降では、この基準を満たさない証明書のサブジェクトDNを指定することも可能ですが、その場合、プロファイル作成時にSANフィールドが空になります。
-portsFile file_path (オプション・パラメーター)
新規プロファイル用のポート設定を定義するファイルへのパスを指定するオプション・パラメーター。

-startingPort または -defaultPorts パラメーターを使用する場合は、このパラメーターを使用しないでください。

プロファイル作成時、`-p` -startingPort パラメータ、`-p` -defaultPorts パラメータ、または `-p` -portsFile パラメータを指定しない場合、`-p` manageprofiles コマンドは自動的に生成された推奨ポートのセットを使用します。 推奨されるポート値は、デフォルト・ポートの可用性に基づくデフォルト・ポート値とは異なっている場合があります。

-profileName プロフィール名
プロファイルの名前を指定します。 プロファイル作成時には、固有値を使用します。 製品バイナリーの同じセットを共用する各プロファイルは、 固有の名前を持つ必要があります。 デフォルト・プロファイル名はプロファイル・タイプおよび末尾番号に基づいています。例えば、次のとおりです。
<profile_type><profile_number>
各部の意味は、次のとおりです。
  • <プロフィールタイプ> は、次のような値である AppSrv, Dmgr, AdminAgent, JobMgr, または Custom
  • <profile_number> は、一意のプロファイル名を作成する連番です

このパラメーターの値に、スペース文字や、*、?、"、<、>、,、/、\、|、などの無効な文字を組み込むことはできません。

選択するプロファイル名は、使用中のものであってはなりません。

-profilePath プロファイルルート
プロファイルへの完全修飾パスを指定します。このパスは、profile_root と呼ばれます。
絶対パスを指定するのは、Ant スクリプト制限を回避するためです。 この制限は、プロファイルをセルに統合する場合の失敗の原因となることがあります。 例:
-profilePath profile_root

デフォルト値は、user_data_root ディレクトリー、プロファイルのサブディレクトリー、およびプロファイルの名前に基づいています。

デフォルトの例を以下に示します。
WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
WS_WSPROFILE_DEFAULT_PROFILE_HOME 要素は、 app_server_root/properties ディレクトリ内の ファイル wasprofile.properties で定義されています。
注記: この wasprofile.properties ファイルには以下のプロパティが含まれています:
WS_CMT_PI_MODPERMS
このプロパティーは、インストール後プログラムが、作成したファイルのアクセス権を変更する必要があるかどうかを指定します。 有効な値は true または falseです。 他のすべての値では、デフォルトで false になります。 このプロパティーをファイルから削除した場合も、デフォルトで false になります。 この値が false に設定されている場合、インストール後プログラムが作成したすべてのファイルのアクセス権が、システムの umask 設定に基づくものになります。

このパラメーターの値は、 ターゲット・システムを指す有効なパスである必要があり、また、現在、使用中であって はなりません。

QEJBSVR プロファイルには、ディレクトリーへの書き込み権限が必要です。

WS_CMT_PI_LOGS
このプロパティーは、インストール後プログラムが各製品について PROFILE_HOME/logs/service/productDir ディレクトリーにあるそのログをクリーンアップする条件および時点を指定します。 このプロパティーの設定で、以下のログのクリーンアップ基準を指定することができます。
  • 各製品について PROFILE_HOME/logs/service/productDir ディレクトリー内に保持したいログの数を指定できます。 1 から 999 の範囲のどの整数でも指定できます。 例えば、WS_CMT_PI_LOGS=5 を指定すると、インストール後プログラムは各製品の五つの最新のログを保持します。
  • ログが占有できるストレージの最大量を指定することができます。 指定される値は、1 から 999 までの任意の整数にすることができ、次が続きます。
    • KB。キロバイト単位で値を指定する場合。
    • MB、メガバイト単位で値を指定する場合。
    • GB、ギガバイトの値を指定する場合。
    例えば、WS_CMT_PI_LOGS=10MB を指定し、ログが占有するストレージの量が 10 メガバイトを超える場合、インストール後プログラムは、最も古いログの削除を開始します。
    トラブルを避けるため： 指定された値は大文字小文字を区別するため、指定値に含まれる文字は大文字でなければなりません。
  • インストール後プログラムでログを保持する時間の長さを指定できます。 指定される値は、1 から 999 までの任意の整数にすることができ、次が続きます。
    • D。日の値を指定する場合。
    • W。週の値を指定する場合。
    • M。月の値を指定する場合。
    • Y。年の値を指定する場合。
    例えば、 WS_CMT_PI_LOGS=2W を指定すると、各ログが 2 週間保持されます。
    トラブルを避けるため： 指定された値は大文字小文字を区別するため、指定値に含まれる文字は大文字でなければなりません。
  • 特定の日付を指定して、その後でログが削除されるようにすることができます。 値は数値を使用して指定し、ダッシュで区切って DD-MM-YYYY 形式にする必要があります。 例えば、WS_CMT_PI_LOGS=12-31-2013 を指定すると、すべてのログが 2013 年 12 月 31 日で削除されます。
    トラブルを避けるため： 指定された形式（ダッシュで区切られた数値）で値を指定しない場合、このプロパティ設定は無視されます。
WS_WSPROFILE_USE_CHANNEL_FILELOCKS
このプロパティーは、ProfilesMutex クラスへのロック要求/アンロック要求がどのように処理されるのかを指定します。 JavaのノンブロッキングI/O（NIO）APIは、リクエストの同期制御に使用されます。 有効値はtrueまたはfalseです。 他のすべての値では、デフォルトで false になります。 このプロパティーを wasprofile.properties ファイルから削除すると、プロパティーはデフォルトで false になります。

このプロパティーは、多数の非同期 manageprofiles コマンド呼び出しが発生し、偶発的な障害が発生している場合に役立ちます。

-response 応答ファイル
コマンド行から manageprofiles コマンドを使用して、すべての API 関数にアクセスします。

コマンド行インターフェースは、プロパティー・ファイルにキーおよび値の形式で特定のコマンドの入力引数を含んでいる、応答ファイルによって駆動されます。 さまざまな種類のプロファイル・テンプレートとアクションで必要とされる入力引数を判断するには、-help パラメーターを指定して manageprofiles コマンドを使用してください。

作成操作を実行するときに使用できる応答ファイルの例を以下に示します。
create
profileName=testResponseFileCreate
profilePath=profile_root
templatePath=app_server_root/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1,myOptionalAction2
応答ファイルを作成する際には、以下の一連のガイドラインを考慮してください。
  • 値を指定する場合には、値の先頭または末尾に二重引用符 (") 文字を指定しないでください (値にスペースが含まれている場合でも同様です)。
    注： これはコマンドラインで値を指定する場合とは異なるルールです。
  • コンマ文字を含む単一の値を指定する場合 (personalCertDN パラメーターおよび signingCertDN パラメーターの識別名など)、コンマ文字の前に 2 つの円記号を使用してください。 例えば、以下に signingCertDN 値に識別名を指定する方法を示します。
    signingCertDN=cn=testserver.ibm.com\\,ou=Root Certificate\\,
   ou=testCell\\,ou=testNode01\\,o=IBM\\,c=US
  • 複数の値を指定する場合、コンマ文字で区切ってください。2 つの円記号を使用しないでください。 例えば、以下に omitAction パラメーターに複数の値を指定する方法を示します。
    omitAction=deployAdminConsole,defaultAppDeployAndConfig
  • 応答ファイル内でブランク行を指定しないでください。 指定すると、エラーが発生する可能性があります。
-restoreProfile
重要: ` -restoreProfilemanageProfiles ` コマンドは、同じフィックスパックレベルで作成されたバックアップでのみサポートされます。
プロファイルのバックアップを復元します。 -backupFile パラメーターとともに使用する必要があります。例えば、次のようにします。
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
プロファイルを復元するには、以下のステップを実行します。
  1. サーバーおよび復元したいプロファイルの実行中プロセスを停止します。
  2. ファイル・システムからそのプロファイル用のディレクトリーを手動で削除します。
  3. コマンド manageprofiles のオプション -validateAndUpdateRegistry を実行する。
  4. プロファイルを復元するには、コマンド manageprofiles-restoreProfile のオプションを使用します。
注意: 同じマシン、 manageProfiles -restoreProfile ホスト、またはインストール環境でプロファイルを復元する場合に最適です。 ただし、別のマシンでソースマシンと同じサービス -restoreProfile レベル WebSphere Application Server にある場合、を使用できます。 この場合、2台目のマシンのディレクトリ構造が、コマンド manageProfiles -restoreProfile が使用された時点でのソースマシン上に存在していたディレクトリ構造と同一であることを確認してください。
-securityLevel セキュリティレベル
セキュア・プロキシー・サーバーのセキュリティー・レベルの初期設定を指定します。 有効な値は、low、medium、およびhighです。 デフォルト値は highです。 セキュリティー・レベルは、始動時のユーザー許可、ルーティングに関する考慮事項、管理オプション、エラー処理に基づいて決定します。 セキュア・プロキシー・サーバー・プロファイルを作成してから、セキュリティー設定を変更することもできます。
-serverName サーバー名
サーバーの名前を指定します。 このパラメーターを指定するのは、デフォルト・テンプレートとセキュア・プロキシー・テンプレートの場合に限られます。 デフォルト・テンプレートとセキュア・プロキシー・テンプレートを使用する場合にこのパラメーターを指定しないと、デフォルトのサーバー名として、デフォルト・プロファイルでは server1、セキュア・プロキシー・プロファイルでは proxy1 が使用されます。
-serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
管理プロファイルのタイプを指定します。 デプロイメント・マネージャー・サーバーには DEPLOYMENT_MANAGER を指定します。 管理エージェント・サーバーには ADMIN_AGENT を、ジョブ・マネージャー・サーバーには JOB_MANAGER を指定します。 管理プロファイルを作成する場合は、このパラメーターが必須になります。
非推奨機能: ジョブマネージャーは非推奨です。 ジョブ・マネージャーの代わりに、Urban Code Deploy を使用して、製品のインストール、アプリケーションのデプロイ、およびリモート・ホストの管理を行ってください。 WebSphere Application Server のインストールを管理するには、スウィングプロファイルも使用できます。 製品インストール間のプロファイルの切り替えを参照してください。
-setDefaultName
既存のプロファイルの 1 つをデフォルト・プロファイルに設定します。 -profileName パラメーターとともに使用する必要があります。例えば、次のようにします。
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
-signingCertDN 区別名
プロファイルの作成時に作成するルート署名証明書の識別名を指定します。 指定する識別名は引用符で囲みます。 そのデフォルトの個人証明書は、サーバーの鍵ストア・ファイルに配置されます。 -importSigningCertKS パラメーターは、-signingCertDN と相互排他のパラメーターです。 ルート証明書を明示的に作成またはインポートしない場合は、デフォルトでルート証明書が作成されます。 -signingCertValidityPeriod パラメーターと -keyStorePassword パラメーターを参照してください。
-signingCertValidityPeriod validity_period (オプション・パラメーター)
ルート署名証明書の有効期間を年単位で指定するオプション・パラメーター。 -signingCertDN パラメーターと合わせてこのパラメーターを指定しない場合、ルート署名証明書の有効期間は 15 年になります。
-startingPort startingPort
プロファイル用のすべてのポートを生成および割り当てするための開始ポート番号を指定します。

ポートの値は、-startingPort 値から始めて順番に割り当てられます。

-defaultPorts または -portsFile パラメーターを使用する場合には、このパラメーターを使用しないでください。

プロファイル作成時、`-p` -startingPort パラメータ、`-p` -defaultPorts パラメータ、または `-p` -portsFile パラメータを指定しない場合、`-p` manageprofiles コマンドは自動的に生成された推奨ポートのセットを使用します。 推奨されるポート値は、デフォルト・ポートの可用性に基づくデフォルト・ポート値とは異なっている場合があります。

注意： マネージド プロファイル テンプレートを使用している場合は、このパラメーターを使用しないでください。
-supportedProtocols サポートされているプロトコル
セキュア・プロキシー・サーバーが要求を代行処理するための有効なプロトコルを指定します。 有効な値は、SIP、HTTP、およびHTTP,SIPです。
-templatePath テンプレートパス
インストール・ルート・ディレクトリー内のテンプレート・ファイルへのディレクトリー・パスを指定します。 profileTemplates ディレクトリー内には、さまざまなプロファイル・タイプに対応し、インストールされた製品のタイプに応じて異なる、さまざまなディレクトリーがあります。 プロファイル・ディレクトリーは、-templatePath オプションを使用しているときに指定するパスです。 インストール・ルートの外にプロファイル・テンプレートがある場合、それらを指定できます。
デフォルトのテンプレート・パスは、app_server_root/profileTemplates/default です。 -templatePath パラメーターに相対パスを使用できます。 パスは、現行作業ディレクトリーまたは app_server_root/profileTemplates に対して相対になるように、正確な順序で指定してください。 以下は、デフォルトのスタンドアロン・アプリケーション・サーバーに基づいてプロファイルを作成する例です。
manageprofiles -create -profileName MyProfile -startingPort 10380

使用可能なテンプレートは、『プロファイルの概念』のトピックに記載されています。

-unaugment
「拡張」とは、拡張テンプレートを持つ既存のプロファイルを変更する能力です。 拡張済みのプロファイルを拡張解除するには、-unaugment パラメーターおよび -profileName パラメーターを指定してください。 一連の manageprofiles の拡張処理が実行済みで、この 2 つのパラメーターのみを指定してプロファイルを拡張解除する場合、拡張解除のアクションは、まず、最新の拡張アクションを元に戻します。

拡張済みの特定のプロファイルを拡張解除する場合は、さらに -templatePath パラメーターと一緒に -ignoreStack パラメーターを指定してください。 通常は、プロファイル・テンプレートの依存性に違反しないようにするため、特定のプロファイルを拡張解除することはありません。

-templatePath パラメーターを使用するときは、パラメーターに相対ファイル・パスを指定してもかまいません。

拡張パラメーターも参照してください。

-unaugmentAll
特定の拡張テンプレートで拡張されたすべてのプロファイルを拡張解除します。 -unaugmentAll パラメーターを指定する場合は、-templatePath パラメーターが必須になります。

-templatePath パラメーターを使用するときは、パラメーターに相対ファイル・パスを指定してもかまいません。

オプションで、-unaugmentDependents パラメーターを -unaugmentAll パラメーターと一緒に指定して、拡張解除するプロファイルの前提条件であるすべてのプロファイルを拡張解除します。

注： プロファイルテンプレートで拡張されたプロファイルが存在しない状態でこのパラメータを使用すると、エラーが発生する可能性があります。

拡張パラメーターも参照してください。

-unaugmentDependents
このパラメーターを指定した場合、-unaugmentAll パラメーターで拡張解除するプロファイルの前提条件になっている、すべての拡張済みプロファイルが拡張解除されます。 指定しない場合、拡張解除するプロファイルの前提条件になっている、拡張済みプロファイルは拡張解除されません。

-unaugmentDependents パラメーターは -unaugmentAll パラメーターと一緒に指定してください。

-validateAndUpdateRegistry
プロファイルがファイル・システム上に存在するかどうかを確認するため、プロファイル・レジストリーに リストされたすべてのプロファイルをチェックします。 レジストリーから、すべての欠落プロファイルを除去します。 レジストリーから削除された欠落プロファイルのリストを戻します。
-validatePorts
ポートをチェックして、それらが予約済みでも使用中でもないことを確認します。 このパラメーターによって、使用されていないポートを識別できます。 ポートが使用中であると判断された場合、プロファイル作成は停止し、エラー・メッセージが表示されます。 このパラメーターは、create コマンド行でいつでも使用できます。 このパラメーターは -portsFile パラメーターとともに使用することをお勧めします。
-validateRegistry
プロファイルがファイル・システム上に存在するかどうかを確認するため、プロファイル・レジストリーに リストされたすべてのプロファイルをチェックします。 欠落プロファイルのリストを戻します。
-webServerCheck true | false
Web サーバー定義をセットアップするかどうかを指示します。 有効な値は、true または false です。 このパラメーターのデフォルト値は、false です。
-webServerHostname ウェブサーバーホスト名
サーバーのホスト名。 このパラメーターのデフォルト値は、 ローカル・マシンの長いホスト名です。
-webServerInstallPath ウェブサーバーインストールパス名
Web サーバーのローカルまたはリモートのインストール・パス。 このパラメーターのデフォルト値は、 ローカル・マシンのオペレーティング・システム、および webServerType パラメーターの値に依存します。 例:
webServerType=IHS: webServerInstallPath defaulted to “n\a”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “n\a”
webServerType=DOMINO: webServerInstallPath defaulted to “n\a”
webServerType=APACHE: webServerInstallPath defaulted to “n\a”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n\a”
-webServerName ウェブサーバー名
Web サーバーの名前。 このパラメーターのデフォルト値は webserver1 です。
-webServerOS ウェブサーバーのオペレーティングシステム
Web サーバーが置かれるオペレーティング・システム。 有効な値には、windows、linux、solaris、aix、hpux、os390、および os400 が含まれます。 このパラメーターは、webServerType パラメーターとともに使用してください。
-webServerPluginPath ウェブサーバープラグインパス
Web サーバーが使用するプラグインへのパス。 このパラメーターのデフォルト値は WAS_HOME/plugins です。
-webServerPort ウェブサーバーポート
Web サーバーへのアクセス元になるポートを示します。 このパラメーターのデフォルト値は 80 です。
-webServerType ウェブサーバーの種類
Web サーバーのタイプ。 有効な値には、IHS、SUNJAVASYSTEM、IIS、DOMINO、APACHE、および HTTPSERVER_ZOS が含まれます。 このパラメーターは、webServerOS パラメーターとともに使用してください。

使用のシナリオ

以下は、正しい構文の例です。 以下の例のいずれかのコマンドを 1 行で発行します。 それぞれの例は、分かりやすくするために複数の行でコマンドを表示しています。

  • デプロイメント・マネージャーの作成

    以下の例では、管理テンプレートを使用して、 Dmgr001 という名前のデプロイメント・マネージャーを作成します。 デプロイメント・マネージャー・ポートはポート番号 20000 から始まります。

    manageprofiles -create 
   -profileName Dmgr001
   -profilePath profile_root
   -templatePath management
   -serverType DEPLOYMENT_MANAGER
   -startingPort 20000
  • 管理エージェントの作成

    管理テンプレートを使用して、AdminAgent001 という名前の管理エージェントを作成する例を以下に示します。 管理エージェントのポートは、ポート番号 24000 から始まります。

    manageprofiles -create 
   -profileName AdminAgent001
   -profilePath profile_root
   -templatePath management
   -serverType ADMIN_AGENT
   -startingPort 24000
  • ジョブ・マネージャーの作成
    非推奨機能: ジョブマネージャーは非推奨です。 ジョブ・マネージャーの代わりに、Urban Code Deploy を使用して、製品のインストール、アプリケーションのデプロイ、およびリモート・ホストの管理を行ってください。 WebSphere Application Server のインストールを管理するには、スウィングプロファイルも使用できます。 製品インストール間のプロファイルの切り替えを参照してください。

    以下の例では、管理テンプレートを使用して、「JobMgr001」という名前のジョブ・マネージャーを作成します。 ジョブ・マネージャー・ポートはポート番号 25000 から始まります。

    manageprofiles -create 
   -profileName JobMgr001
   -profilePath profile_root
   -templatePath management
   -serverType JOB_MANAGER
   -startingPort 25000
  • セキュア・プロキシーの作成

    セキュア・プロキシー・テンプレートを使用して、SecureProxySrv001 という名前のセキュア・プロキシーを作成する例を以下に示します。 セキュア・プロキシー・ポートはポート番号 26000 から始まります。

    manageprofiles -create 
   -profileName SecureProxySrv001
   -profilePath profile_root
   -templatePath secureproxy
   -startingPort 26000
  • カスタム・プロファイルの作成

    カスタム・プロファイルを作成し、そのプロファイルをデプロイメント・マネージャー・セルに統合する例を以下に示します。

    manageprofiles -create 
   -profileName Custom01 
   -templatePath managed 
   -startingPort 22000
   -dmgrHost myhost.mycity.mycompany.com
   -dmgrPort 8879
  • アプリケーション・サーバー・プロファイルの作成

    以下のコマンドを使用して、Default01 という名のアプリケーション・サーバー・プロファイルを作成します。

    manageprofiles -create 
   -profileName Default01 
   -templatePath default 
   -startingPort 21000
   -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"   
   -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"   
   -keyStorePassword ap3n9krw
  • セル・プロファイルの作成
    セル・プロファイルを作成するには、デプロイメント・マネージャー、とセル・プロファイルのアプリケーション・サーバー部分の両方を作成する必要があります。 2 つのプロファイルはリンクしていて、いくつかのパラメーターは、デプロイメント・マネージャーの作成パラメーターとセル・プロファイルのアプリケーション・サーバー部分とで一致する必要があります。
    重要: セルプロファイルのデプロイメントマネージャー部分とアプリケーションサーバー部分の両方において、, nodeName, および appServerNodeName cellNameパラメータには同一の値を使用する必要があります。 セル・プロファイルのデプロイメント・マネージャー部分を 作成したときにこれらのパラメーターの名前を指定しなかった場合は、 最初のコマンド行呼び出しの際に割り当てられたデフォルト名を使用する必 要があります。 セル・プロファイルのデプロイメント・マネージャー部分とアプリケーション・サーバー部分で各パラメーターに同じ値を使用した場合の例を以下に示します。
    For Dmgr:                       
-cellName host01Cell01          
-nodeName host01CellManager01   
-appServerNodeName host01Node01 
                                
For AppServer:                  
-cellName host01Cell01          
-nodeName host01CellManager01   
-appServerNodeName host01Node01
    以下の例は、セル名が Default01Cell でノード名が Default01Node になっている、Dmgr001 という名前のセル・プロファイルの作成を示しています。 完全に機能するセルを作成するには、-nodeProfilePath、-cellName、-appServerNodeName、-nodeName パラメーターが、cell_dmgr プロファイルと cell_node プロファイルとで一致する必要があります。
    1. セル・プロファイルのデプロイメント・マネージャー部分を作成します。
      app_server_root/bin/manageprofiles -create 
   -templatePath app_server_root/profileTemplates/cell/dmgr
   -nodeProfilePath user_data_root/profiles/AppSrv01
   -profileName Dmgr001
   -cellName Default01Cell
   -nodeName Default01Node
   -appServerNodeName Default02Node
    2. セル・プロファイルのアプリケーション・サーバー部分を作成します。
      app_server_root/bin/manageprofiles -create
   -templatePath app_server_root/profileTemplates/cell/default
   -dmgrProfilePath user_data_root/profiles/Dmgr001
   -portsFile user_data_root/profiles/Dmgr001/properties/portdef.props
   -nodePortsFile user_data_root/profiles/Dmgr001/properties/nodeportdef.props
   -profileName AppSrv01
   -cellName Default01Cell
   -nodeName Default01Node
   -appServerNodeName Default02Node

ログ

manageprofiles コマンドは、プロファイルを作成するたびに、そのログを作成します。
  • ログは、user_data_root/profileRegistry/logs/manageprofiles ディレクトリーにあります。 ファイルは、profile_name_create.log というパターンで命名されます。
  • このコマンドは、プロファイルを削除する場合にも、その都度ログを作成します。 ログは、user_data_root/profileRegistry/logs/manageprofiles ディレクトリーにあります。 ファイルは、profile_name_delete.log というパターンで命名されます。

例: デプロイメント・マネージャー・プロファイルの作成

コア・プロダクト・ファイルをインストールした後で、デプロイメント・マネージャー・プロファイルを作成することができます。 デプロイメント・マネージャーは、1 つ以上のマシン上にある アプリケーション・サーバーの論理グループに、単一の管理インターフェースを提供します。 manageprofiles.sh -create コマンドを使用して、デプロイメント・マネージャー・プロファイルを作成します。

shasti という名前のデプロイメント・マネージャー・プロファイルを作成するには、次のように指定します。

manageprofiles -create
              -profileName shasti 
              -profilePath /shasti/WebSphere 
              -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetaix 
              -nodeName dmgr1
このコマンドは、以下のロケーションにある dmgr1 というノード名を持つセル cell1 に、デプロイメント・マネージャー・プロファイル shasti を作成します。
  • /shasti/WebSphere

プロファイル作成中にポート・オプションの 1 つを指定しない場合、推奨されるポート値のセットが使用されます。 ポート競合解決アルゴリズムがこれらのポートを判別します。 推奨されるポートのセットは、競合がないようにする必要があります。 IBM のデフォルトポートを使用したい場合は、プロファイル作成時に -defaultPorts オプションを使用してください。

例: 開始点からのデフォルト・ポート番号の増分

manageprofiles コマンドは、開始ポート値に基づいて、ポート番号を割り当てることができます。 -startingPort パラメーターを使用して、コマンド行から開始ポート値を提供することができます。 このコマンドは、開始ポート番号値から順番にポート番号を割り当てます。 ただし、シーケンス内のポート値が既存のポートの割り当てと競合する場合は、次に使用可能なポート値が使用されます。

ポート割り当ては、任意の順序で行われます。 割り当てを予測することはできません。

例えば、-startingPort 20002 と指定して作成されたポートは、次の例のように表示されます。

アプリケーション・サーバー・プロファイルに割り当てられたポート
WC_defaulthost=20002
WC_adminhost=20003
WC_defaulthost_secure=20004
WC_adminhost_secure=20005
BOOTSTRAP_ADDRESS=20006
SOAP_CONNECTOR_ADDRESS=20007
IPC_CONNECTOR_ADDRESS=20008
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20009
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20010
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20011
ORB_LISTENER_ADDRESS=20012
DCS_UNICAST_ADDRESS=20013
SIB_ENDPOINT_ADDRESS=20014
SIB_ENDPOINT_SECURE_ADDRESS=20015
SIB_MQ_ENDPOINT_ADDRESS=20016
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20017
SIP_DEFAULTHOST=20018
SIP_DEFAULTHOST_SECURE=20019
OVERLAY_UDP_LISTENER_ADDRESS=20020
OVERLAY_TCP_LISTENER_ADDRESS=20021
フェデレーテッド・アプリケーション・サーバー・プロファイルによるセルの 割り当てポート
WC_defaulthost=20002
WC_defaulthost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
DCS_UNICAST_ADDRESS=20011
SIB_ENDPOINT_ADDRESS=20012
SIB_ENDPOINT_SECURE_ADDRESS=20013
SIB_MQ_ENDPOINT_ADDRESS=20014
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20015
SIP_DEFAULTHOST=20016
SIP_DEFAULTHOST_SECURE=20017
NODE_MULTICAST_DISCOVERY_ADDRESS=20018
NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS=20019
NODE_DISCOVERY_ADDRESS=20020
NODE_DCS_UNICAST_ADDRESS=20021
NODE_BOOTSTRAP_ADDRESS=20022
NODE_SOAP_CONNECTOR_ADDRESS=20023
NODE_ORB_LISTENER_ADDRESS=20024
NODE_SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20025
NODE_CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20026
NODE_CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20027
NODE_IPC_CONNECTOR_ADDRESS=20028
OVERLAY_UDP_LISTENER_ADDRESS=20029
OVERLAY_TCP_LISTENER_ADDRESS=20030
NODE_XDAGENT_PORT=20031
NODE_OVERLAY_UDP_LISTENER_ADDRESS=20032
NODE_OVERLAY_TCP_LISTENER_ADDRESS=20033
デプロイメント・マネージャー・プロファイルによるセルの 割り当てポート
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
XDAGENT_PORT=20013
OVERLAY_UDP_LISTENER_ADDRESS=20014
OVERLAY_TCP_LISTENER_ADDRESS=20015
STATUS_LISTENER_ADDRESS=20016
デプロイメント・マネージャー・サーバーによる管理プロファイルの割り当てポート
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
XDAGENT_PORT=20014
OVERLAY_UDP_LISTENER_ADDRESS=20015
OVERLAY_TCP_LISTENER_ADDRESS=20016
STATUS_LISTENER_ADDRESS=20017
ジョブ・マネージャー・サーバーによる管理プロファイルの割り当てポート
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
STATUS_LISTENER_ADDRESS=20011
管理エージェント・サーバーによる管理プロファイルの割り当てポート
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
セキュア・プロキシー・プロファイルの割り当てポート
PROXY_HTTP_ADDRESS=20002
PROXY_HTTPS_ADDRESS=20003
PROXY_SIP_ADDRESS=20004
PROXY_SIPS_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006

以下の例は、manageprofiles コマンドの startingPort パラメーターを使用して、前の例に示されていた内容で、20002 という初期値から開始してポートを作成します。

app_server_root/bin/manageprofiles -create
               -profileName shasti 
               -profilePath app_server_root/profiles/shasti 
               -templatePath app_server_root/profileTemplates/default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002

例: セル・プロファイルの作成

manageprofiles コマンドを使用してセル・プロファイルを作成するには、2 つの別々の manageprofiles コマンド行呼び出しを使用して、デプロイメント・マネージャー・サーバーのセル管理プロファイルとセル・ノード・プロファイルの両方を作成する必要があります。 これらの 2 つのプロファイルの組み合わせがセル・プロファイルです。

セル・プロファイルを作成するためには、cell_dmgr と cell_node の 2 つのテンプレートが使用されます。 テンプレートはリンクしており、いくつかのパラメーターは、 これらの 2 回の呼び出しの creation パラメーター間で一致している必要があります。 呼び出しが一致していることを確認してください。

コマンド行から、任意の順序でいつでも、セルの両半分を作成できます。 最初にプロファイルのデプロイメント・マネージャー部分を作成するのが、最良の方法です。 作成後のセルには、デプロイメント・マネージャーと統合されたノードが含まれています。 デプロイメント・マネージャー部分とノード部分は、別のディレクトリーにあります。

作成する 2 つのプロファイルではいずれも、-profilePath パラメーターを使用して、作成するプロファイルの完全修飾パスを指定できます。 そのパラメーターを指定しない場合は、それぞれのプロファイルのパスとして、ディレクトリー、profiles サブディレクトリー、プロファイルの名前に基づくデフォルト値が使用されます。

セル・プロファイルを構成する 2 つのテンプレートは互いに依存関係を持っており、2 つの呼び出し作成でいくつかのパラメーター値が一致する必要があります。 完全に機能するセルを作成するには、-nodeProfilePath、-cellName、 -appServerNodeName、-nodeName 各パラメーターの値が、cell_dmgr プロファイルと cell_node プロファイルの両方で同じになっている必要があります。 ポート、特に動的に割り当てられたポートの場合には、セルの後半を作成する際に、セルの前半に使用されるポートを参照する必要があります。 -portsFile および -nodePortsFile 引数を使用するときには、セルの前半を表すプロファイルの以下のファイルを参照してください。

  • profile_root/properties/portdef.props
  • profile_root/properties/nodeportdef.props
こうすることにより、セルの前半と正しい相関関係を維持してセルの後半のポートが作成されるようになります。

セル・プロファイルの作成に関する詳細なヘルプを参照するには、以下のコマンドを使用します。

app_server_root/bin/manageprofiles -create
 -templatePath
app_server_root/profileTemplates/cell/dmgr
 -help

または

app_server_root/bin/manageprofiles -create
 -templatePath 
app_server_root/profileTemplates/cell/default
 -help

-help パラメーターからの出力は、セル・デプロイメント・マネージャー・プロファイルおよびセル・ノード・プロファイルを作成するときに、どのパラメーターが必須でどのパラメーターがオプションであるのかを指定します。

以下の例では、Default01Cell というセル名と Default01Node というノード名を持つ、Dmgr001 という名前のセル・プロファイルを作成します。
  1. 次のパスが使用できることを確認します。

    セルのデプロイメント・マネージャーおよびノード部分を作成するときに、それぞれの部分ごとにサブディレクトリーが追加されるように、パスを使用可能にする必要があります。

  2. セル・プロファイルのデプロイメント・マネージャー部分を作成します。
    app_server_root/bin/manageprofiles -create 
 -templatePath 
app_server_root/profileTemplates/cell/dmgr 
 -nodeProfilePath 
app_server_root/profiles/AppSrv01 
 -profileName Dmgr001 
 -cellName Default01Cell 
 -nodeName Default01Node 
 -appServerNodeName federated_node_name
  3. Dmgr001 プロファイルが存在していることを確認します。セル・プロファイルのアプリケーション・サーバー部分を作成する前に、このプロファイルが存在していなければならないためです。
  4. セル・プロファイルのアプリケーション・サーバー部分を作成します。
    重要: セルプロファイルのデプロイメントマネージャー部分で使用した値と同じ値を、 cellName,、 nodeName,、および appServerNodeName パラメータに必ず使用してください。 セル・プロファイルのデプロイメント・マネージャー部分とアプリケーション・サーバー部分の cellName、nodeName、および appServerNodeName の各パラメーターに同じ値を使用する場合の例を以下に示します。
    For Dmgr:                       
-cellName host01Cell01          
-nodeName host01CellManager01   
-appServerNodeName host01Node01 
                                
For AppServer:                  
-cellName host01Cell01          
-nodeName host01CellManager01   
-appServerNodeName host01Node01
    セル・プロファイルのデプロイメント・マネージャー部分を 作成したときにこれらのパラメーターの名前を指定しなかった場合は、 最初のコマンド行呼び出しの際に割り当てられたデフォルト名を使用する必 要があります。
    app_server_root/bin/manageprofiles -create 
 -templatePath 
app_server_root/profileTemplates/cell/default 
 -dmgrProfilePath 
app_server_root/profiles/Dmgr001 
 -portsFile 
app_server_root/profiles/Dmgr001/properties/portdef.props 
 -nodePortsFile 
app_server_root/profiles/Dmgr001/properties/nodeportdef.props 
 -profileName AppSrv01 
 -cellName Default01Cell 
 -nodeName Default01Node 
 -appServerNodeName federated_node_name

セル・プロファイルのデプロイメント・マネージャーとノードの部分を作成した後、2 つのサーバー間の同期が行われる必要があります。 デフォルトでは、2 つのサーバー間の同期が、指定された間隔で自動的に起こります。 ただし、同期が使用不可な場合、間隔が長すぎる場合、タイムリーに同期が起こらないような問題が発生する場合、syncNode コマンドを実行してデプロイメント・マネージャーおよびノードの同期を行います。

portsFile または nodePortsFile パラメーターおよび startingPort または nodeStartingPort パラメーターのどちらかを使用する必要があります。

manageprofiles コマンドを使用すると、デフォルトにしたいプロファイルを選択できます。

例: 定義済みポート番号の使用

明示的にポート値を設定しない場合は、manageprofiles コマンドは初期のポート値を推奨します。 代わりに、事前定義されたポート値を使用することができます。

オプション -defaultPorts, -startingPort, または -portsFile が指定されていない場合、コマンド manageprofiles はポート値を推奨します。
表 1. デフォルトのポート値のファイルの場所。

以下の表は、プロファイル・タイプ別にデフォルト・ポート値のファイルの場所をリストしたものです。
プロファイル ファイル・パス
アプリケーション・サーバー app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props
セル - アプリケーション・サーバー部分 app_server_root/profileTemplates/cell/dmgr/actions/portsUpdate/nodeportdef.props
セル - デプロイメント・マネージャー部分 app_server_root/profileTemplates/cell/dmgr/actions/portsUpdate/portdef.props
カスタム app_server_root/profileTemplates/managed/actions/portsUpdate/portdef.props
デプロイメント・マネージャー・サーバーの管理プロファイル app_server_root/profileTemplates/management/actions/portsUpdate/dmgr.portdef.props
管理エージェント・サーバーの管理プロファイル app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props
ジョブ・マネージャー・サーバーの管理プロファイル app_server_root/profileTemplates/management/actions/portsUpdate/jmgr.portdef.props
セキュア・プロキシー app_server_root/profileTemplates/secureproxy/actions/portsUpdate/portdef.props
お客様のプロファイルを作成する前に portdef.props ファイルのポート値をカスタマイズするには、以下のステップを実行します。 以下の例では、デフォルト・プロファイルを作成します。 他のタイプのプロファイルでは、 作成するプロファイルのファイル・パスにファイル・パスを置き換える必要があります。
  1. デフォルト・プロファイル・テンプレート・パスから、app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props ファイルをコピーし、このファイルのコピーを次のような任意の一時ディレクトリーに置きます。
    • /temp/ports
  2. 新規のファイルでは、ポート設定を変更してポート値を指定します。
  3. manageprofiles コマンドでプロファイルを作成します。 変更したポート値を使用します。 変更した portdef.props ファイルの場所を -portsFile パラメーターに指定します。 -validatePorts パラメーターを指定して、 ポートが予約済みまたは使用中でないことを確認します。 次の例を参考にしてください。
    manageprofiles 
   -create
   -profileName Wow_Profile 
   -profilePath profile_root 
   -templatePath app_server_root\profileTemplates\default 
   -nodeName Wow_node 
   -cellName Wow_cell
   -hostName lorriemb 
   -portsFile \temp\ports\portdef.props
   -validatePorts
portdef.props ファイルで以下の値が指定されているとします。
WC_defaulthost=39080
WC_adminhost=39060
WC_defaulthost_secure=39443
WC_adminhost_secure=39043
BOOTSTRAP_ADDRESS=32809
SOAP_CONNECTOR_ADDRESS=38880
IPC_CONNECTOR_ADDRESS=39633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=35558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
SIP_DEFAULTHOST=35060
SIP_DEFAULTHOST_SECURE=35061
OVERLAY_UDP_LISTENER_ADDRESS=35062
OVERLAY_TCP_LISTENER_ADDRESS=35063
STATUS_LISTENER_ADDRESS=35064

ユーザー定義のポート値を使用してプロファイルを作成するために manageprofiles コマンドを実行した後で、成功または失敗の結果が表示されます。

注： プロファイルの作成に成功すると、コンソールに成功を示すメッセージが表示され、ファイル AboutThisProfile.txt を確認するよう促されます。 ただし、IBM i 上でクライアント・プロファイルまたはプラグイン・プロファイルを作成する際、AboutThisProfile.txt ファイルは生成されません。

この manageprofiles コマンドは、現在の portdefs.props ファイルのコピーを profile_root\properties ディレクトリに作成します。

`` manageprofiles コマンドでは、3つのポート値 -portsFile パラメータ` -startingPort, -defaultPorts`、`,`、または``のいずれか1つだけを使用してください。 この 3 つのパラメーターは互いに排他的です。