「Liberty プロファイル・リソースのアンインストール」ジョブをサブミットして、1 つ以上のターゲット・ホストから Liberty・リソースを削除することができます。
始める前に
Liberty・リソースは、ジョブ・マネージャーに登録されている 1 つ以上のターゲットに存在している必要があります。
ジョブ・マネージャーを開始して、リソースがターゲット上で使用中でないことを確認します。
ジョブをサブミットするには、ジョブ・マネージャーで使用する ID に、管理者ロール
またはオペレーター・ロールの権限が付与されている必要があります。
ターゲット・ホストをジョブ・マネージャーに登録する際、オペレーティング・システムのセキュリティー情報を保存することができます。
セキュリティー情報を保存していない 1 つ以上のターゲットにジョブをサブミットする場合、許可されたオペレーティング・システム・ユーザー名と、そのユーザー名に対するパスワードまたは公開/秘密鍵情報のいずれかを指定する必要があります。
セキュリティー・クレデンシャルは、すべてのジョブ・ターゲットで有効でなければなりません。
このタスクについて
ジョブ・マネージャーまたはデプロイメント・マネージャーの管理コンソールを
使用して、1 つ以上のホスト・ターゲットから Liberty・リソースを
アンインストールできます。各ジョブごとに、1 つの liberty リソース・タイプを
アンインストールできます。
- プロジェクト
- ランタイム環境
- Software Development Kit (SDK)
- サーバー
- アプリケーション・バイナリー・ファイル
コンソールから「Liberty プロファイル・リソース
のアンインストール」ジョブを選択し、リソース
およびジョブ・オプションを指定し、サマリーを確認してからジョブをサブミットします。
コンソールを使用する代わりに、AdministrativeJobs コマンド・グループ内の uninstallLibertyProfileResources ジョブ・スクリプトを実行することもできます。管理ジョブのタイプに関するトピックを参照してください。
手順
- 管理コンソールのナビゲーション・ツリーから、の順でクリックします。
- liberty リソースをアンインストールするジョブを選択します。
- リストから「Liberty プロファイル・リソース
のアンインストール」ジョブ・タイプを選択します。
- オプションでジョブの説明を指定します。
- 「次へ」をクリックします。
- リソースを削除するジョブ・ターゲットを選択します。
- リストからターゲットのグループを選択するか、または「ターゲット名」を選択します。
選択したジョブ・タイプに有効なターゲットのグループのみが、ターゲット・グループの
リストに表示されます。
- 「ターゲット名」を選択した後は、ターゲット名を指定して「追加」をクリックするか、「検索」をクリックして、「ターゲットの検索」ページで選択したターゲットを指定します。
- ジョブ・マネージャーへのターゲット・ホストの登録の際に、セキュリティー認証情報を保存することを選択しなかった場合は、ターゲット・ホストへのアクセスのために、オペレーティング・システム・ユーザー名と、パスワードまたは公開/秘密鍵情報のいずれかを指定します。
セキュリティー・クレデンシャルは、すべてのジョブ・ターゲットで有効でなければなりません。
- 「次へ」をクリックします。
- Liberty・リソースをアンインストールするジョブのパラメーターを指定します。
- リソース・タイプを 1 つだけ指定してください。「ジョブ・パラメーターの指定」ページ
では、1 つのリソースを複数のフィールドに指定しないでください。
- リソース名またはリソース ID を指定できます。1 つのリソース名が、同名の複数のリソースに
解決される場合、エラーが戻され、そのリソース
は削除されません。
- アンインストールするよう指定したサーバーが稼働中の場合、
リソースを削除する前にサーバーは停止されます。
- プロジェクトまたはランタイムをアンインストールするよう指定すると、すべての
サーバーでそのプロジェクトまたはランタイムが検索されます。特定された稼働中の各サーバーごとに、サーバーが停止された後でリソースの削除が試行されます。
- 1 つのリソース・タイプについてリソース名または
リソース ID を指定します。
ターゲット上の既存の liberty リソースの
名前を参照するには、「ジョブ・パラメーターの指定」ページでリソース・タイプの「検索」を
クリックします。
リソース ID を検出するには、「ターゲット・リソースの検索」ページで「検索」を
クリックします。削除するリソースを選択します。
例えば、DefaultWebApplication.war アプリケーション・バイナリー・リソースを wlp ランタイムの defaultServer サーバーからアンインストールするとします。
「アンインストールするアプリケーション・バイナリー・ファイル」に、
リソース ID を次のように指定します。
runtime/wlp/liberty_server/defaultServer/application_binary/DefaultWebApplication.war
- 「強制的にリソースを削除する」では、リソースの状況を検出できなくてもリソースを削除するかどうかをオプションで指定します。
デフォルトでは、リソースを強制的に削除しません。
このオプション
が選択されている場合、サーバー・リソースの状況が検出できないか、サーバーを停止できない場合でも、
サーバー・リソースは削除されます。
サーバーの状況が検出できない場合、「強制的にリソースを削除する」が選択されていなければ、「Liberty プロファイル・リソースのアンインストール」ジョブは失敗します。
- 「次へ」をクリックします。
- ジョブをスケジュールします。
指定する日時は
ジョブ・マネージャーに関連しています。
- オプションで、ジョブの終了時に通知を送信する宛先の電子メール・アドレスを 1 つ以上指定します。
複数の電子メール・アドレスを指定する場合は、コンマで区切ります。
- ジョブがサブミットに対して利用可能になる時間を選択します。
- ジョブの有効期限を選択します。
- オプションで、ジョブが再帰する間隔、間隔の開始日時、および間隔の
終了日時を指定します。
- 「次へ」をクリックします。
- サマリーを確認して「終了」をクリックし、ジョブをサブミットします。
タスクの結果
ターゲットがジョブを実行し、指定された Liberty・リソースの削除を試行します。
トラブルの回避 (Avoid trouble): ジョブが失敗すると、関連ファイルの一部はそのまま残り、リソースは破損状態になります。
リソース・ファイルを手動で変更して問題を修正した場合は、ファイルの変更後に、
「インベントリー」ジョブを実行してジョブ・マネージャー内のターゲット・リソースのインベントリーを更新してください。
gotcha
次のタスク
「ジョブ状況」ページで、
「Liberty プロファイル・リソースのアンインストール」ジョブの ID をクリックして、ジョブ状況を表示します。
状況のリフレッシュ・アイコン
をクリックして、表示されている状況をリフレッシュします。
ジョブが正常に完了していない場合は、ジョブの実行の結果発生したエラー・メッセージを確認して、エラー条件を修正し、ジョブを再度サブミットします。
ジョブが正常に
実行された場合は、をクリックし、
liberty リソースがリソース・リストに含まれなくなったことを検証します。