manageprofiles コマンド
manageprofiles コマンドを使用して、ランタイム環境を定義するプロファイルの作成、削除、バックアップ、およびリストアを行います。 複数の製品をインストールする代わりに プロファイルを使用すれば、ディスク・スペースを節約できるうえに、コア・プロダクト・ファイルの単一セット だけを保守すればよいため、製品の更新が簡素化されます。
manageprofiles コマンドおよびそのグラフィカル・ユーザー・インターフェースであるプロファイル管理ツールは、ランタイム環境を作成する唯一の手段です。
コマンド・ファイルは、 app_server_root/bin ディレクトリーにあります。 コマンド・ファイルは、manageprofiles という名前のスクリプトです。
構文
-help
パラメーターを使用します。 以下の例では、Windows オペレーティング・システムで manageprofiles -augment
コマンドに help パラメーターを使用しています。app_server_root\bin\manageprofiles.bat -augment -help
-create
コマンドを使用します。app_server_root/bin/manageprofiles.sh -create
-profileName profile_name
-profilePath profile_root
-templatePath template_path
パラメーター
manageprofiles コマンドで使用可能なオプションは、以下のとおりです。
-adminUserName
パラメーターで指定された管理セキュリティー・ユーザー ID のパスワードを指定します。- 管理セキュリティーに使用されるユーザー ID を指定します。
- アプリケーション・サーバーが実行される環境のタイプに最も近いパフォーマンス・チューニング設定を指定します。
このパラメーターは、デフォルト・プロファイル・テンプレートの場合に限り有効です。
-applyPerfTuningSetting パラメーターでオプションを指定しない場合のデフォルト値は、
standard
です。-isDeveloperServer パラメーターと -applyPerfTuningSetting パラメーターの両方を指定すると、-applyPerfTuningSetting に選択されたオプションによっては、-applyPerfTuningSetting が -isDeveloperServer をオーバーライドすることがあります。
- 拡張テンプレートで既存のプロファイルを変更するには、augment パラメーターを使用します。 augment パラメーターを使用すると、manageprofiles コマンドは、
-templatePath
パラメーターのテンプレートを使用して、-profileName
パラメーターで示されたプロファイルを更新または拡張します。 使用できる拡張テンプレートは、ご使用の環境にどの IBM® 製品およびバージョンがインストールされているかによって決まります。重要: WebSphere Application Server 基本 製品に組み込まれているテンプレートは、プロファイルの作成にのみ使用できます。製品に付属しているのはテンプレートの作成のみであるため、既存のプロファイルを拡張するために使用することはできません。また、install_dir/ profileTemplates ディレクトリー内にあるファイルを手動で変更しないでください。 例えば、プロファイル作成中にポートを変更する場合、 プロファイル・テンプレート・ディレクトリー内のファイルを変更するのではなく、manageprofiles コマンド に対して -startingPort 引数または -portsFile 引数を使用します。
-templatePath
に完全修飾ファイル・パスを指定します。 以下に例を示します。manageprofiles(.bat)(.sh) -augment -profileName profile_name -templatePath template_path
プロファイル・テンプレートが app_server_root/profileTemplates ディレクトリーからの相対パスである場合は、-templatePath
パラメーターに相対パスを指定できます。 それ以外の場合は、完全修飾テンプレート・パスを指定します。 以下に例を示します。manageprofiles -augment -profileName profile_name -templatePath template_path
-unaugment
パラメーターも参照してください。 - プロファイル・レジストリー・ファイルを、指定したファイルにバックアップします。 backupFile_name の完全修飾ファイル・パスを提供する必要があります。
- プロファイル・フォルダー、およびプロファイル・レジストリー・ファイルからのプロファイル・メタデータのファイル・システム・バックアップを実行します。
-backupProfile
オプションを指定して manageprofiles コマンドを呼び出す前に、バックアップするプロファイルを使用するすべてのサーバーをまず停止する必要があります。-backupProfile
パラメーターは、-backupFile
パラメーターおよび-profileName
パラメーターと一緒に使用する必要があります。以下に例を示します。manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name
-backupProfile
オプションを使用してプロファイルをバックアップする場合は、まずサーバーとバックアップしたいプロファイルの実行中プロセスを停止する必要があります。 - プロファイルのセル名を指定します。 各プロファイルごとに固有のセル名を使用します。問題の回避: セル名は固有でなければなりません。 セル名が重複している場合、セル間のリモート通信 (リモート Enterprise JavaBeans 呼び出しなど) で問題が発生する可能性があります。
これはオプション・パラメーターです。 このパラメーターを省略すると、デフォルトのセル名が割り当てられます。
このパラメーターのデフォルト値は、短いホスト名、定数セル、および末尾番号の組み合わせに基づいています。このパラメーターの値には、スペースまたは *、?、"、<、>、,、/、\、|、などの無効な文字を含めることができません。
- プロファイルを作成します。プロファイルの作成に関する特定の情報を見るためには、manageprofiles -create -templatePath fully_qualified_file_path_to_template -help を指定してください。 使用可能なテンプレートには、以下のようなものがあります。
- manageprofiles コマンドで使用する Ant ユーティリティーのデバッグ機能をオンにします。 詳細 Ant 出力は、
app_server_root/logs/directory
ディレクトリー内の manageprofiles 名で始まるログ・ファイル内の manageprofiles コマンドからのロギングと結合されます。 - デフォルトの個人証明書の有効期間を年単位で指定するオプション・パラメーター。
-personalCertDN
パラメーターを指定するときに、このパラメーターを一緒に指定しなければ、デフォルトの個人証明書の有効期間は 1 年になります。 - デフォルトまたは基本のポート値をプロファイルに割り当てます。
-startingPort
または-portsFile
パラメーターを使用する場合は、このパラメーターを使用しないでください。-startingPort
パラメーター、-defaultPorts
パラメーター、または-portsFile
パラメーターを指定しない場合、プロファイル作成時に、 manageprofiles コマンドは自動的に生成された推奨ポートのセットを使用します。 推奨されるポート値は、デフォルト・ポートの可用性に基づくデフォルト・ポート値とは異なっている場合があります。注意: 管理対象プロファイル・テンプレートを使用している場合は、このパラメーターを使用しないでください。 - プロファイルを削除します。
プロファイルを削除しても、プロファイル・ディレクトリーは削除されません。 例えば、/usr/WebSphere/AppServer/profiles/managedProfile ディレクトリーにプロファイルを作成するとします。 ディレクトリーはプロファイルの削除後も残ります。
ディレクトリーは、削除することも残すことも可能です。 ただし、profile_root/logs ディレクトリーには、プロファイルのアンインストールに関する情報が含まれます。 例えば、アンインストール・プロシージャー中に問題が起こったときにその原因を判別するために、_nodeuninst.log ファイルを残しておくことができます。
プロファイル・レジストリーで拡張テンプレートが登録されているプロファイルを削除する場合、拡張解除アクションが自動的に実行されます。
- すべての登録済みプロファイルを削除します。
プロファイルを削除しても、プロファイル・ディレクトリーは削除されません。 例えば、/usr/WebSphere/AppServer/profiles/managedProfile ディレクトリーにプロファイルを作成するとします。 ディレクトリーはプロファイルの削除後も残ります。
ディレクトリーは、削除することも残すことも可能です。 ただし、profile_root/logs ディレクトリーには、プロファイルのアンインストールに関する情報が含まれます。 例えば、アンインストール・プロシージャー中に問題が起こったときにその原因を判別するために、_nodeuninst.log ファイルを残しておくことができます。
プロファイル・レジストリーで拡張テンプレートが登録されているプロファイルを削除する場合、拡張解除アクションが自動的に実行されます。
- 管理セキュリティーを使用可能にします。 有効な値は、
true
またはfalse
です。 デフォルト値はfalse
です。 Linux サービスの作成を有効にします。 有効な値は、
true
またはfalse
です。 このパラメーターのデフォルト値はfalse
です。-enableService
オプションをtrue
に設定して manageprofiles コマンドを実行すると、root ユーザーがこのコマンドを実行したときに、プロファイルを使用して Linux サービスが作成されます。 非 root ユーザーが manageprofiles コマンドを実行すると、プロファイルは作成されますが、 Linux サービスは作成されません。 非 root ユーザーにはサービスをセットアップするための十分な権限がないため、 Linux サービスは作成されません。 プロファイル作成の最後にINSTCONPARTIALSUCCESS
結果が表示され、現行ユーザーに Linux サービスをセットアップするための十分な権限がないことを示すメッセージがプロファイル作成ログapp_server_root/logs/manageprofiles_create_profilename.log
に記録されます。- デフォルト・プロファイルの名前を戻します。
- 特定の名前のプロファイルのファイル・システム・ロケーションを取得します。
-profileName
パラメーターが必要です。 - 特定の
-profilePath
パラメーターで登録済みのプロファイル名を取得します。 - コマンド構文を表示します。
- プロファイルを作成するホストの名前を指定します。 初期製品のインストール中に指定したホスト名と一致している必要があります。 このパラメーターのデフォルト値は、 ドメイン名システムの長い形式です。 このパラメーターの値は、有効な IPv6 ホスト名である必要があり、それにはスペースまたは *、?、"、<、>、,、/、\、|、などの無効な文字を含めることができません。
- -templatePath パラメーターと併用するオプション・パラメーターで、特定の拡張済みプロファイルを拡張解除するために使用します。 -unaugment パラメーターを参照してください。
- プロファイルの作成時に個人証明書をインポートするために使用する鍵ストア・ファイルのパスを指定します。 その個人証明書は、サーバーのデフォルトの個人証明書になります。ベスト・プラクティス: 個人証明書をデフォルトの個人証明書としてインポートする場合は、個人証明書に署名したルート証明書をインポートします。 インポートしない場合は、manageprofiles コマンドにより個人証明書の公開鍵が trust.p12 ファイルに追加され、ルート署名証明書が作成されます。
-importPersonalCertKS
パラメーターは、-personalCertDN
と相互排他のパラメーターです。 個人証明書を明示的に作成またはインポートしない場合は、デフォルトで個人証明書が作成されます。-importPersonal で始まるいずれかのパラメーターを指定する場合は、-importPersonal で始まるすべてのパラメーターを指定する必要があります。
-importPersonalCertKS
パラメーターで指定する鍵ストア・ファイルに含まれている証明書の別名を指定します。 その証明書は、サーバーのデフォルトの鍵ストア・ファイルに追加され、サーバーのデフォルトの個人証明書として使用されます。-importPersonal で始まるいずれかのパラメーターを指定する場合は、-importPersonal で始まるすべてのパラメーターを指定する必要があります。
-importPersonalCertKS
パラメーターで指定する鍵ストア・ファイルのパスワードを指定します。-importPersonal で始まるいずれかのパラメーターを指定する場合は、-importPersonal で始まるすべてのパラメーターを指定する必要があります。
-importPersonalCertKS
パラメーターで指定した鍵ストア・ファイルのタイプを指定します。 値は、JCEKS
、CMSKS
、PKCS12
、PKCS11
、およびJKS
です。 ただし、このリストは、java.security ファイルで記述されているプロバイダーによって変わる場合があります。-importPersonal で始まるいずれかのパラメーターを指定する場合は、-importPersonal で始まるすべてのパラメーターを指定する必要があります。
- プロファイルの作成時にルート証明書をインポートするために使用する鍵ストア・ファイルのパスを指定します。 そのルート証明書は、サーバーのデフォルトのルート証明書として使用する証明書です。
-importSigningCertKS
パラメーターは、-signingCertDN
と相互排他のパラメーターです。 ルート証明書を明示的に作成またはインポートしない場合は、デフォルトでルート証明書が作成されます。-importSigning で始まるいずれかのパラメーターを指定する場合は、-importSigning で始まるすべてのパラメーターを指定する必要があります。
-importSigningCertKS
パラメーターで指定する鍵ストア・ファイルに含まれている証明書の別名を指定します。 その証明書は、サーバーのデフォルトのルート鍵ストアに追加され、サーバーのデフォルトのルート証明書として使用されます。-importSigning で始まるいずれかのパラメーターを指定する場合は、-importSigning で始まるすべてのパラメーターを指定する必要があります。
-importSigningCertKS
パラメーターで指定する鍵ストア・ファイルのパスワードを指定します。-importSigning で始まるいずれかのパラメーターを指定する場合は、-importSigning で始まるすべてのパラメーターを指定する必要があります。
-importSigningCertKS
パラメーターで指定した鍵ストア・ファイルのタイプを指定します。 有効な値は、JCEKS
、CMSKS
、PKCS12
、PKCS11
、およびJKS
です。 ただし、このリストは、java.security ファイルで記述されているプロバイダーによって変わる場合があります。-importSigning で始まるいずれかのパラメーターを指定する場合は、-importSigning で始まるすべてのパラメーターを指定する必要があります。
- 付随する
-profileName
パラメーターによって識別されたプロファイルが、登録されるとデフォルト・プロファイルになることを指定します。 デフォルト・プロファイルを処理するコマンドを発行するときには、コマンドの-profileName
属性を使用する必要はありません。 - サーバーが開発のみを目的としていることを指定します。 このパラメーターは、実動アプリケーション・サーバーにアプリケーションをデプロイする前に、非実動サーバーでそのアプリケーションを検査するためのプロファイル作成時に役立ちます。
このパラメーターは、デフォルト・プロファイル・テンプレートの場合に限り有効です。
-isDeveloperServer パラメーターと -applyPerfTuningSetting パラメーターの両方を指定すると、-applyPerfTuningSetting に選択されたオプションによっては、-applyPerfTuningSetting が -isDeveloperServer をオーバーライドすることがあります。
- プロファイルの作成時に作成するすべての鍵ストア・ファイルで使用するパスワードを指定します。 デフォルトの個人証明書とルート署名証明書のために鍵ストア・ファイルを作成します。
- プロファイル・レジストリーに登録されているプロファイルの引数のリストを表示します。 -listAugments パラメーターと一緒に -profileName パラメーターを指定する必要があります。
- プロファイル・レジストリー内のプロファイルをリストします。
- 新規プロファイルを使用して作成されたノードのノード名を指定します。 マシンで固有値を使用してください。 製品バイナリーの同じセットを共用する各プロファイルは、
固有のノード名を持つ必要があります。このパラメーターのデフォルト値は、短いホスト名、プロファイル・タイプ、末尾番号に基づいています。
このパラメーターの値には、スペースまたは *、?、"、<、>、,、/、\、|、などの無効な文字を含めることができません。
- プロファイル機能を除外するオプション・パラメーター。それぞれのプロファイル・テンプレートには特定のオプション機能が事前定義されています。 以下のオプション機能は、以下のプロファイル・テンプレートに関して
-omitAction
パラメーターで使用できます。 - プロファイルの作成時に作成する個人証明書の識別名を指定します。 指定する識別名は引用符で囲みます。 そのデフォルトの個人証明書は、サーバーの鍵ストア・ファイルに配置されます。
-importPersonalCertKSType
パラメーターは、-personalCertDN
と相互排他のパラメーターです。-personalCertValidityPeriod
パラメーターと-keyStorePassword
パラメーターを参照してください。問題の回避:プロファイルの作成時に、サブジェクト代替名 (SAN) フィールドに確実にデータが取り込まれるようにするには、証明書のサブジェクト識別名に英字、数字、ハイフンのみを使用する必要があります。 その他の文字を使用すると、プロファイルを作成できません。 この基準は、フィックスパック、バージョン 9.0.5.5 からバージョン 9.0.5.7に適用されます。
フィックスパック、バージョン 9.0.5.8+ の場合、この基準を満たさない証明書所有者 DN を指定できますが、これを指定すると、プロファイル作成時に空の SAN フィールドが作成されます。
- 新規プロファイル用のポート設定を定義するファイルへのパスを指定するオプション・パラメーター。
-startingPort
または-defaultPorts
パラメーターを使用する場合は、このパラメーターを使用しないでください。-startingPort
パラメーター、-defaultPorts
パラメーター、または-portsFile
パラメーターを指定しない場合、プロファイル作成時に、 manageprofiles コマンドは自動的に生成された推奨ポートのセットを使用します。 推奨されるポート値は、デフォルト・ポートの可用性に基づくデフォルト・ポート値とは異なっている場合があります。 - プロファイルの名前を指定します。 プロファイル作成時には、固有値を使用します。 製品バイナリーの同じセットを共用する各プロファイルは、
固有の名前を持つ必要があります。 デフォルト・プロファイル名はプロファイル・タイプおよび末尾番号に基づいています。例えば、次のとおりです。
ここで、<profile_type><profile_number>
このパラメーターの値に、スペース文字や、*、?、"、<、>、,、/、\、|、などの無効な文字を組み込むことはできません。
選択するプロファイル名は、使用中のものであってはなりません。
- プロファイルへの完全修飾パスを指定します。このパスは、profile_root と呼ばれます。
完全修飾パスにスペースが含まれている場合は、 その値を引用符で囲んでください。
デフォルト値は、 app_server_root ディレクトリー、profiles サブディレクトリー、およびプロファイルの名前に基づいています。
デフォルトの例を以下に示します。
WS_WSPROFILE_DEFAULT_PROFILE_HOME エレメントは、WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
app_server_root/properties
ディレクトリーのwasprofile.properties
ファイルで定義されます。注:wasprofile.properties
ファイルには、以下のプロパティーが含まれています。- WS_CMT_PI_MODPERMS
- このプロパティーは、インストール後プログラムが、作成したファイルのアクセス権を変更する必要があるかどうかを指定します。 有効な値は true または falseです。 他のすべての値では、デフォルトで false になります。 このプロパティーをファイルから削除した場合も、デフォルトで false になります。 この値が false に設定されている場合、インストール後プログラムが作成したすべてのファイルのアクセス権が、システムの umask 設定に基づくものになります。
このパラメーターの値は、 ターゲット・システムを指す有効なパスである必要があり、また、現在、使用中であって はなりません。
ディレクトリーに書き込む権限が必要です。
- 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、ギガバイトの値を指定する場合。
トラブルの回避: 指定された値は大/小文字が区別されるため、指定された値に含まれる文字は大文字でなければなりません。 - インストール後プログラムでログを保持する時間の長さを指定できます。 指定される値は、1 から 999 までの任意の整数にすることができ、次が続きます。
- D。日の値を指定する場合。
- W。週の値を指定する場合。
- M。月の値を指定する場合。
- Y。年の値を指定する場合。
トラブルの回避: 指定された値は大/小文字が区別されるため、指定された値に含まれる文字は大文字でなければなりません。 - 特定の日付を指定して、その後でログが削除されるようにすることができます。 値は数値を使用して指定し、ダッシュで区切って 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 コマンド呼び出しが発生し、偶発的な障害が発生している場合に役立ちます。
- コマンド行から 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
- 応答ファイル内でブランク行を指定しないでください。 指定すると、エラーが発生する可能性があります。
Windows オペレーティング・システムのパス・ステートメントでは、スラッシュ (/) または円記号 (¥) を使用できます。 パス・ステートメントが円記号を使用している場合、応答ファイルがパスを正しく理解するには、応答ファイルに二重の円記号が必要です。 以下は、二重の円記号を使用する、作成操作のための応答ファイルの例です。
create templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
ベスト・プラクティス: プラットフォーム間の切り替え時にエラーが発生する可能性を減らすために、スラッシュを使用してください。
- 値を指定する場合には、値の先頭または末尾に二重引用符 (") 文字を指定しないでください (値にスペースが含まれている場合でも同様です)。
- 重要: manageProfilesプロファイルのバックアップを復元します。
-restoreProfile
コマンドは、 同じ フィックスパック・レベルで作成されたバックアップでのみサポートされます。-backupFile
パラメーターとともに使用する必要があります。例えば、次のようにします。manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
プロファイルを復元するには、以下のステップを実行します。重要:manageProfiles -restoreProfile
は、同じマシン、ホスト、またはインストール済み環境にプロファイルをリストアする場合に最適です。 ただし、 WebSphere Application Server がソース・マシンと同じサービス・レベルである別のマシンで -restoreProfile を使用することができます。 この場合は、2 番目のマシンのディレクトリー構造が、manageProfiles -restoreProfile
コマンドが使用されたときにソース・マシンに存在していたディレクトリー構造と同じであることを確認してください。 - サーバーの名前を指定します。 このパラメーターを指定するのは、デフォルト・テンプレートとセキュア・プロキシー・テンプレートの場合に限られます。 デフォルト・テンプレートとセキュア・プロキシー・テンプレートを使用する場合にこのパラメーターを指定しないと、デフォルトのサーバー名として、デフォルト・プロファイルでは server1、セキュア・プロキシー・プロファイルでは proxy1 が使用されます。
- 管理プロファイルのタイプを指定します。 管理エージェント・サーバーの場合は、
ADMIN_AGENT
を指定します。 管理プロファイルを作成する場合は、このパラメーターが必須になります。 Linux サービスがこのユーザー ID から実行されるように、 Linux サービスの作成時に使用するユーザー ID を指定します。 Linux サービスは、ユーザー ID がログオンするたびに実行されます。
- 既存のプロファイルの 1 つをデフォルト・プロファイルに設定します。
-profileName
パラメーターとともに使用する必要があります。例えば、次のようにします。manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
- プロファイルの作成時に作成するルート署名証明書の識別名を指定します。 指定する識別名は引用符で囲みます。 そのデフォルトの個人証明書は、サーバーの鍵ストア・ファイルに配置されます。
-importSigningCertKS
パラメーターは、-signingCertDN
と相互排他のパラメーターです。 ルート証明書を明示的に作成またはインポートしない場合は、デフォルトでルート証明書が作成されます。-signingCertValidityPeriod
パラメーターと-keyStorePassword
パラメーターを参照してください。 - ルート署名証明書の有効期間を年単位で指定するオプション・パラメーター。
-signingCertDN
パラメーターと合わせてこのパラメーターを指定しない場合、ルート署名証明書の有効期間は 15 年になります。 - プロファイル用のすべてのポートを生成および割り当てするための開始ポート番号を指定します。
ポートの値は、
-startingPort
値から順番に (使用中のポートを除いて) 割り当てられます。 システムは、現在使用中のポートを認識して、解決し、ポートの競合を回避するためにポート割り当てを決定します。-defaultPorts
または-portsFile
パラメーターを使用する場合には、このパラメーターを使用しないでください。-startingPort
パラメーター、-defaultPorts
パラメーター、または-portsFile
パラメーターを指定しない場合、プロファイル作成時に、 manageprofiles コマンドは自動的に生成された推奨ポートのセットを使用します。 推奨されるポート値は、デフォルト・ポートの可用性に基づくデフォルト・ポート値とは異なっている場合があります。重要: 管理対象プロファイル・テンプレートを使用している場合は、このパラメーターを使用しないでください。 - インストール・ルート・ディレクトリー内のテンプレート・ファイルへのディレクトリー・パスを指定します。 profileTemplates ディレクトリー内には、さまざまなプロファイル・タイプに対応し、インストールされた製品のタイプに応じて異なる、さまざまなディレクトリーがあります。 プロファイル・ディレクトリーは、
-templatePath
オプションを使用しているときに指定するパスです。 インストール・ルートの外にプロファイル・テンプレートがある場合、それらを指定できます。プロファイル・テンプレートが app_server_root
/profileTemplates
ディレクトリーからの相対パスである場合は、-templatePath
パラメーターに相対パスを指定できます。 それ以外の場合は、完全修飾テンプレート・パスを指定します。 F使用可能なテンプレートは、『プロファイルの概念』のトピックに記載されています。
- 「拡張」とは、拡張テンプレートを持つ既存のプロファイルを変更する能力です。 拡張済みのプロファイルを拡張解除するには、-unaugment パラメーターおよび -profileName パラメーターを指定してください。 一連の manageprofiles の拡張処理が実行済みで、この 2 つのパラメーターのみを指定してプロファイルを拡張解除する場合、拡張解除のアクションは、まず、最新の拡張アクションを元に戻します。
拡張済みの特定のプロファイルを拡張解除する場合は、さらに -templatePath パラメーターと一緒に -ignoreStack パラメーターを指定してください。 通常は、プロファイル・テンプレートの依存性に違反しないようにするため、特定のプロファイルを拡張解除することはありません。
-templatePath パラメーターを使用するときは、パラメーターに完全修飾ファイル・パスを指定します。
拡張パラメーターも参照してください。
- 特定の拡張テンプレートで拡張されたすべてのプロファイルを拡張解除します。 -unaugmentAll パラメーターを指定する場合は、-templatePath パラメーターが必須になります。
-templatePath パラメーターを使用するときは、パラメーターに完全修飾ファイル・パスを指定します。
オプションで、-unaugmentDependents パラメーターを -unaugmentAll パラメーターと一緒に指定して、拡張解除するプロファイルの前提条件であるすべてのプロファイルを拡張解除します。
注: プロファイル・テンプレートで拡張されたプロファイルがない場合にこのパラメーターを使用すると、エラーが送信される可能性があります。拡張パラメーターも参照してください。
- このパラメーターを指定した場合、-unaugmentAll パラメーターで拡張解除するプロファイルの前提条件になっている、すべての拡張済みプロファイルが拡張解除されます。 指定しない場合、拡張解除するプロファイルの前提条件になっている、拡張済みプロファイルは拡張解除されません。
-unaugmentDependents パラメーターは -unaugmentAll パラメーターと一緒に指定してください。
- プロファイルがファイル・システム上に存在するかどうかを確認するため、プロファイル・レジストリーに リストされたすべてのプロファイルをチェックします。 レジストリーから、すべての欠落プロファイルを除去します。 レジストリーから削除された欠落プロファイルのリストを戻します。
- ポートをチェックして、それらが予約済みでも使用中でもないことを確認します。 このパラメーターによって、使用されていないポートを識別できます。 ポートが使用中であると判断された場合、プロファイル作成は停止し、エラー・メッセージが表示されます。 このパラメーターは、create コマンド行でいつでも使用できます。 このパラメーターは
-portsFile
パラメーターとともに使用することをお勧めします。 - プロファイルがファイル・システム上に存在するかどうかを確認するため、プロファイル・レジストリーに リストされたすべてのプロファイルをチェックします。 欠落プロファイルのリストを戻します。
- Web サーバー定義をセットアップするかどうかを指示します。 有効な値は、
true
またはfalse
です。 このパラメーターのデフォルト値はfalse
です。 - サーバーのホスト名。 このパラメーターのデフォルト値は、 ローカル・マシンの長いホスト名です。
- Web サーバーのローカルまたはリモートのインストール・パス。 このパラメーターのデフォルト値は、
ローカル・マシンのオペレーティング・システム、および
webServerType
パラメーターの値に依存します。 以下に例を示します。 - Web サーバーの名前。 このパラメーターのデフォルト値は webserver1 です。
- Web サーバーが置かれるオペレーティング・システム。 有効な値には、windows、linux、solaris、aix、hpux、os390、および os400 が含まれます。 このパラメーターは、webServerType パラメーターとともに使用してください。
- Web サーバーが使用するプラグインへのパス。 このパラメーターのデフォルト値は WAS_HOME/plugins です。
- Web サーバーへのアクセス元になるポートを示します。 このパラメーターのデフォルト値は 80 です。
- Web サーバーのタイプ。 有効な値には、IHS、SUNJAVASYSTEM、IIS、DOMINO、APACHE、および HTTPSERVER_ZOS が含まれます。 このパラメーターは、webServerOS パラメーターとともに使用してください。
プロファイル用に作成された Windows サービスの所有者アカウントのタイプ。 有効な値は、specifieduser または localsystem です。 localsystem 値は、プロファイルを作成したユーザーのローカル・アカウントで Windows サービスを実行します。 このパラメーターのデフォルト値は localsystem です。
specifieduser の値を指定する場合は、winservicePassword パラメーターが必須になります。 winserviceUserName パラメーターを指定しない場合は、デフォルトで環境ユーザー名値が使用されます。
値は、true または false のいずれかです。 プロファイル内に作成されるサーバー・プロセス用の Windows サービスを作成するには、 true を指定します。 Windows サービスを作成しない場合は、 false を指定します。 このパラメーターのデフォルト値は
false
です。重要: カスタム・プロファイルでは、このパラメーターを使用して Windows サービスを作成することはできません。 WASService コマンドを使用してサービスを別途作成する必要があります。指定されたユーザーのパスワード、または Windows サービスを所有するローカル・アカウントのパスワードを指定します。
指定可能な startup_type の値は、以下のとおりです。
Windows サービスについて詳しくは、 WASService コマンドに関する記事をお読みください 。
このパラメーターのデフォルト値は automatic です。
Windows オペレーティング・システムが Windows サービスを作成できる ID としてユーザーを検証できるように、ユーザー ID を指定します。 管理者グループに属し、以下の拡張ユーザー権限を持つユーザー ID を使用する必要があります。
重要: 指定されたユーザーとパスワードを使用して Windows サービスでプロファイルを作成し、そのユーザーがドメイン・ユーザーである場合は、以下の例に示すように 二重円記号 を使用する必要があります。winServiceUserName=DOMAIN\\DOMAINUSER winServicePassword=DOMAINUSERPASSWORD
使用のシナリオ
以下は、正しい構文の例です。 以下の例のいずれかのコマンドを 1 行で発行します。 それぞれの例は、分かりやすくするために複数の行でコマンドを表示しています。
ログ
例: 開始点からのデフォルト・ポート番号の増分
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
以下の例は、manageprofiles コマンドの startingPort パラメーターを使用して、前の例に示されていた内容で、20002 という初期値から開始してポートを作成します。
manageprofiles.bat -create
-profileName shasti
-profilePath G:\shasti\WebSphere
-templatePath G:\shasti\WebSphere\profileTemplates\default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
app_server_root/bin/manageprofiles.sh -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 コマンドは初期のポート値を推奨します。 代わりに、事前定義されたポート値を使用することができます。
-defaultPorts
、 -startingPort
、または -portsFile
のオプションが指定されていない場合、 manageprofiles コマンドはポート値を推奨します。プロファイル | ファイル・パス |
---|---|
アプリケーション・サーバー | app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props |
管理エージェント・サーバーの管理プロファイル | app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.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
ユーザー定義のポート値を使用してプロファイルを作成するために manageprofiles コマンドを実行した後で、成功または失敗の結果が表示されます。
manageprofiles コマンドは、現在の portdefs.props
ファイルのコピーを profile_root\properties
ディレクトリーに作成します。
manageprofiles コマンドでは、3 つのポート値パラメーター -startingPort
、 -defaultPorts
、または -portsFile
のいずれか 1 つのみを使用してください。 この 3 つのパラメーターは互いに排他的です。