Sun N1 Service Provisioning System ユーザーズガイド (BEA WebLogic 8 Plug-In 3.0)

Previous: 第 3 章 WebLogic 8 プラグインのインストールと構成

第 4 章 WebLogic 8 プラグインの使用法

WebLogic 8 プラグインは複数の特別なコンポーネントタイプを提供し、BEA WebLogic 8 アプリケーションを使用した作業に便利な機能に簡単にアクセスできるようにします。この章では、次の内容について説明します。

Sun N1 Service Provisioning System を使用した WebLogic 8 環境のインストール法および使用法

プラグインの規定

プロビジョニングシステムを使用すると、アプリケーションのプロビジョニングと管理を行うことができます。

プランとコンポーネントプロシージャー

WebLogic 8 プラグインは、タスクを実行するためのツールとしてプランとコンポーネントプロシージャーの両方を提供します。プランを使用することで、目的の機能に直接リンクすることができます。コンポーネントプロシージャーを使用することで、実行できるタスクの数がさらに多くなります。

タスク名

WebLogic 8 プラグインでは、タスクを 4 つのカテゴリ、つまりアプリケーションタスク、インフラストラクチャータスク、構成タスク、および高度なタスクに分類しています。これらのタスクカテゴリは、実行する必要があるタスクを記述する際に同じ規則に従います。

表 4–1 共通のタスク名


タスク名	説明
View Installations、View Configurations、View Clusters、View Cluster Members	特定のタイプのすべてのコンポーネントがインストールされている場所のリストを表示します。
View All	指定のフォルダ内の特定のタイプのすべてのコンポーネントを表示します。
Create	このタイプの新しいコンポーネントをプロビジョニングシステムに追加できる「component Details」ページへのリンクです。既存の WebLogic Admin Server からインポートすることで、またはファイルシステムをブラウズすることで、新しいコンポーネントを作成できます。
Start または Stop	Start または Stop コンポーネントプロシージャーを実行する「component Details」ページへのリンク。
Install、Uninstall、Remove、Join、Leave	記述された機能を作成するプランを表します。

グローバルな必要条件

本書で説明されている各タスクに関しては、2 つの必要条件が存在します。

WebLogic 管理サーバーは、数多くの処理の実行または確認に使用されます。そのため、WebLogic 8 環境を変更するタスクを実行するには、正しい接続情報が動作するプロビジョニングシステム内で管理サーバーを構成する必要があります。

注 –
WebLogic ソフトウェアのインストール時、WebLogic Domain の作成時、またはエンタープライズアプリケーション (EAR)、Web アプリケーション (WAR)、および Java アーカイブ (JAR) ファイルの作成時には、管理サーバーはオンラインである必要はありません。
プロビジョニングシステム内のすべてのタスクでは、ユーザーが特定のアクセス権を持っていることが必要になります。WebLogic プラグインを使用してタスクを実行するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

アクセス権の詳細については、『Sun N1 Service Provisioning System 5.2 システム管理者ガイド』の第 3 章「アクセス許可を使用したアクセスの制御」を参照してください。

グループメンバーシップの更新方法についての詳細は、『Sun N1 Service Provisioning System 5.2 システム管理者ガイド』の「ユーザーのグループメンバーシップを変更する」を参照してください。

処理の概要

プロビジョニングシステム内に WebLogic 8 環境を作成する作業は、プロビジョニングシステムを使用せずに環境を作成する処理に似ています。

(任意) 参照サーバーに WebLogic 8 アプリケーションをインストールします。

参照サーバーをインストールおよび構成すると、構成が正しく機能するかどうかを確認してから、その構成を複数のホストに複製することができます。
WebLogic 8 プラグインをインポートします。

『Sun N1 Service Provisioning System 5.2 システム管理者ガイド』の「プラグインのインポート」を参照してください。
WebLogic セッション変数 WL_DEFAULT_PASSWORD と WL_DEFAULT_USER を設定します。

『Sun N1 Service Provisioning System 5.2 プランとコンポーネントの開発者ガイド』の第 5 章「セッション変数」を参照してください。
すべてのホストを準備します。

WebLogic 8 プラグインには、プロビジョニングシステム内のすべてのホストに配布する必要がある新しいシステムサービスが含まれています。『Sun N1 Service Provisioning System 5.2 システム管理者ガイド』の「物理ホストの準備」を参照してください。
WebLogic ソフトウェアをインストールします。

「WebLogic ソフトウェアをインストールする」を参照してください。
Administrative Server をインストールすることで WebLogic ドメインを作成します。

「WebLogic 8 ドメインと管理サーバーを作成する」を参照してください。
新しい WebLogic ドメインで管理対象サーバーを作成します。

「WebLogic 管理対象サーバーを作成する」を参照してください。
WebLogic ライセンスコンポーネントを作成し、インストールします。

「ライセンスコンポーネントを作成する」および「ライセンスコンポーネントをインストールする」を参照してください。
(任意) WebLogic 8 クラスタを作成します。

「WebLogic クラスタを作成する」を参照してください。
(任意) 既存の管理対象サーバーをクラスタに割り当てることにより、クラスタメンバーを追加します。

「クラスタメンバーを作成する」を参照してください。
必要に応じて、データベースへのアプリケーションの接続を構成します。
1. 接続プールを構成します。
  
  「接続プールのコンポーネントタイプ」を参照してください。
2. (任意) マルチプールを構成します。
  
  「マルチプールコンポーネントタイプ」を参照してください。
3. データソースまたはトランザクションデータソースを構成します。
  
  「データソースおよびトランザクションデータソースのコンポーネントタイプ」を参照してください。
アプリケーションが Java Messaging Service を使用している場合、JMS サーバーを構成します。

「JMS Server コンポーネントタイプ」を参照してください。
アプリケーションファイル (EAR、JAR、および WAR) を取得します。

「WebLogic アプリケーションの取得と編集」を参照してください。
ターゲットホスト、ホストセット、またはクラスタにアプリケーションを配備します。

アプリケーションは、クラスタまたは管理対象サーバーのいずれかをターゲットとすることができます。

「エンタープライズアプリケーションのインストール」、「Web アプリケーションのインストール」、または「JAR または EJB ファイルのインストール」を参照してください。

WebLogic インフラストラクチャーの作成

「WebLogic 8 Common Tasks」ページを起点として、WebLogic サーバーおよびクラスタの作成と管理を行います。

WebLogic 8 ドメインと管理サーバーを作成する

アプリケーションをホストする管理対象サーバーを設定する前に、ドメインおよび管理サーバーを作成する必要があります。ドメインは、管理サーバーにより管理される一連の WebLogic サーバーです。ドメインに関するすべての情報は、管理サーバー上に格納される構成ファイルに含まれています。

AdminServer コンポーネントをインストールして新しいドメインを作成する場合は、次の作業も行います。

ドメインの構成
Admin Server の仮想ホストの作成

この手順で新しいドメインを作成したり、また「markOnly」オプションを選択することでプロビジョニングシステム内で既存のドメインを登録することもできます。

注 –

本書では、AdminServer と管理サーバーという類似した用語を使用します。事前にパッケージされた Sun N1 Service Provisioning System WebLogic 8 コンポーネントは、AdminServer コンポーネントと呼ばれます。AdminServer はプロビジョニングシステムコンポーネントを表し、管理サーバーは WebLogic 8 環境上で動作するインストール済みアプリケーションを表します。

始める前に

WebLogic 8 ドメインを作成するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

WebLogic セッション変数 WL_DEFAULT_USER および WL_DEFAULT_PASSWORD が設定されていることを確認します。

WebLogic セッション変数は、長さが 7 文字で、数字を含んでいる必要があります。

セッション変数の詳細については、『Sun N1 Service Provisioning System 5.2 プランとコンポーネントの開発者ガイド』の第 5 章「セッション変数」を参照してください。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Domain Management: Create」リンクをクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

「Run」ページが表示されます。

「Plan Parameters」領域で、配備する AdminServer コンポーネントの変数設定を選択します。
- このコンポーネントに対して変数設定が指定されている場合、メニューから適切な設定を選択します。
- メニューから設定が使用できない場合は、「Select From List」をクリックします。
  
  「Select Variable Settings From List」ウィンドウが表示されます。
  - 変数設定の新しいセットを作成するには、「Create Set」を選択します。
    
    次のリストに、AdminServer コンポーネントの変数のうち、更新する可能性が高い変数を示します。
    
    domainName
    
    必須。WebLogic のドメイン名です。
    
    adminPort
    
    必須。AdminServer の仮想ホストが使用するデフォルトの TCP ポートです。
    
    ドメインが作成される前に、このポートが使用可能であるかチェックされます。このエラーを解消するには、ポートを解放し、AdminServer の「component Details」ページにある startAdminServer コンポーネントプロシージャーを実行します。
    
    secureConnect
    
    任意。True 管理サーバーの接続に SSL ポートが使用可能であることを指定します。
    
    startScriptWindows
    
    Windows では必須。Windows システム用のドメイン起動スクリプトの名前を指定します。この変数の値は .cmd ファイルにする必要があります。
    
    production
    
    必須。この変数は、管理対象サーバーを稼働モードで実行するかどうかを決定します。稼働モードのデフォルト値は false です。この変数は、true または false に設定できます。
    
    更新される頻度が少ない変数には、次のような構成変数が含まれます。
    
    adminManagedServer
    
    必須。ドメイン管理コンソールをホストする管理対象サーバーの名前。デフォルト値は myserver です。markOnly インストールを実行している場合は、この変数を、WebLogic インストール中に使用されるサーバー名に設定します。
    
    adminHost
    
    必須。管理対象サーバーが管理サーバーに接続するために使用するホスト名または IP アドレス。デフォルト値は、管理サーバーが常駐しているリモートエージェントのホスト名です。
    
    targetRefName
    
    必須。この変数は、ドメインの仮想ホストの名前になります。代入変数は、ホスト名とドメイン名の値に基づきます。この変数の形式は、:[target:sys.hostName]_weblogic_admin_ :[domainName] になります。たとえば、sqa-420_weblogic_admin_wls。
    
    「Select Variable Settings From List」ウィンドウが表示されます。
    1. 表の最上部のテキストフィールドに、新しい変数設定セットの名前を入力します。
    2. WebLogic ドメイン名を変更するには、domainName 行を選択して新しいドメイン名を入力します。
    3. 管理サーバーのポート番号をデフォルト値の 7001 以外に変更するには、adminPort 行を選択して新しいポート番号を入力します。
    4. 管理サーバーへの接続に、セキュリティー保護された HTTP を使用するように指定するには、secureConnect 行を選択し、テキストフィールドに True と入力します。
    5. WebLogic のインストール先のパスを変更するには、beaHome 行を選択して正しいパスを入力します。
      
      installPath 変数、beaHome 変数、および WebLogic BEAHome of installation プラン変数には、同じ値を格納する必要があります。
      
      この 3 つの変数のデフォルト値は /usr/local/bea です。
      
      注 –
      installPath 変数の値は、/opt や c:\mydir などの絶対パスを指定しないかぎり、デフォルトのリモートエージェントディレクトリの相対パスとして扱われます。たとえば、Windows リモートエージェントで installPath 変数を c\mydir に設定し、デフォルトのホームディレクトリ c:\Program Files\N1 Service Provisioning System\agent でエージェントにファイルを配備すると、ファイルは c:\Program Files\N1 Service Provisioning System\agent\c\mydir に配備されます。
    6. 必要に応じて、そのほかの定義済み変数の値も修正します。
      
      targetRefName は使用環境に合わせて事前定義されていますが、必要であれば修正できます。targetRefName は、ホスト名の値とドメイン名の値に基づいて作成されます。この変数の形式は、:[target:sys.hostName]_admin_:[domainName] になります。
  - 別のコンポーネントから変数コンポーネントを使用するには、「Import Set」をクリックします。
    
    変数セットのインポートの詳細については、『Sun N1 Service Provisioning System 5.2 オペレーションとプロビジョニングガイド』の「プランを実行する」を参照してください。
    
    「Import Variable Settings」ウィンドウが表示されます。
    1. 必要に応じ、インポートする変数設定がなされているコンポーネントが入ったフォルダに移動します。
    2. コンポーネントのバージョンを選択します。
      
      注 –
      コンポーネントのバージョンが異なると、変数設定も異なる可能性があります。
    3. 「Import Variable Settings」をクリックします。
      
      インポートされた変数設定が表に追加されます。
    4. 「Select」をクリックします。

ターゲットホストを選択します。

WebLogic ソフトウェアをインストールした時に作成された仮想ホストをターゲットとします。「WebLogic ソフトウェアをインストールする」の手順を参照してください。

注 –
ターゲットホストは、com.sun.weblogic#InstallHS ホストセットのメンバーである必要があります。

プロビジョニングシステム内の既存の WebLogic ドメインを取得する場合は、「markOnly」オプションを選択します。

「Run Plan (includes preflight)」をクリックします。

異なるパスワードを使用して複数のドメインを作成する

同じユーザーとパスワードを使用して複数のドメインを作成できます。ただし、各ドメインに異なるパスワードを使用する場合は、各ドメインのインストール後に WebLogic ユーザーおよびパスワードセッション変数を更新する必要があります。

新しいドメインを作成するプランは、必ずデフォルトセッション変数名 WL_DEFAULT_USER および WL_DEFAULT_PASSWORD を使用します。

デフォルトの WebLogic セッション変数 WL_DEFAULT_USER および WL_DEFAULT_PASSWORD を使用して、新しいドメインと AdminServer をインストールします。

「WebLogic 8 ドメインと管理サーバーを作成する」を参照してください。

ブラウザインタフェースの最上部の「Session Variables」をクリックして、「Session Variables」ページにアクセスします。

新しくインストールされた AdminServer の新しいセッション変数を作成します。

これらの新しいセッション変数の値は、AdminServer のインストールに使用したデフォルトの変数と同じ値です。

属性名	デフォルトのセッション変数名	新しいセッション変数名
`adminUser`	`WL_DEFAULT_USER`	`WL_TEST_USR`
`adminPassword`	`WL_DEFAULT_PASSWORD`	`WL_TEST_PWD`

手順 1 で作成した AdminServer の「host Details」ページにアクセスし、「Edit」をクリックします。

AdminServer のホストタイプ属性を更新します。

たとえば、adminUser 値を :[session:WL_TEST_USR] に置き換えます。

別のドメインをインストールする場合は「Session Variables」ページに戻り、デフォルトの WebLogic セッション変数を、インストールする次のドメインに使用する新しい値で更新します。

WebLogic 管理対象サーバーを作成する

各ドメインで複数の管理対象サーバーを実行し、アプリケーションをホストすることができます。WebLogic 管理対象サーバーは Server コンポーネントにより取得され、プロビジョニングシステム内に表示されます。本書全体を通じて、「Server」はプロビジョニングシステムコンポーネントを指しますが、「管理対象サーバー」は WebLogic 8 環境で動作する管理対象サーバーのインストール済みインスタンスを指します。

この手順で新しい管理対象サーバーを作成したり、また「markOnly」オプションを選択することでプロビジョニングシステム内で既存の管理対象サーバーを登録することもできます。

注 –

クラスタを作成する場合、クラスタを作成する「前」に、そのクラスタに属する管理対象サーバーを作成する必要があります。

始める前に

WebLogic 管理対象サーバーを作成する前に、次の条件が満たされている必要があります。

管理対象サーバーを含むドメインが存在する必要がある。

詳細は、「WebLogic 8 ドメインと管理サーバーを作成する」を参照してください。
ドメインの AdminServer が実行中である必要がある。

AdminServer を手動で起動するには、AdminServer の「component Details」ページから startAdminServer コンポーネントプロシージャーを実行します。
WebLogic ソフトウェアが、管理対象サーバーのインストール先ホストにインストールされている必要がある。

「WebLogic ソフトウェアをインストールする」を参照してください。
ユーザーは、コンポーネントを含むフォルダ上に Run Component Procedures アクセス権を有するユーザーグループに属する必要がある。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Application Server Management: Create」リンクをクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

「Run」ページが表示されます。

「Plan Parameters」領域で、配備する ManagedServer コンポーネントの変数設定を選択します。

Server コンポーネントは、WebLogic 8 環境内の管理対象サーバーインスタンスを表します。
- このコンポーネントに対して変数設定が指定されている場合、メニューから適切な設定を選択します。
- メニューから設定が使用できない場合は、「Select From List」をクリックします。
  
  「Select Variable Settings From List」ウィンドウが表示されます。
  - 変数設定の新しいセットを作成するには、「Create Set」を選択します。
    
    次のリストに、ManagedServer コンポーネントの変数のうち、更新する可能性が高い変数を示します。
    
    変数セット名
    
    必須。ユーザーが作成する新しい変数設定セットの名前
    
    adminServerHostName
    
    必須。新しい管理対象サーバーをホストする AdminServer 仮想ホストの名前。この値の形式は、 remoteAgentName_weblogic_admin_ domainName です。
    
    仮想ホストは「Hosts」ページにあります。仮想ホストのタイプは、com.sun.weblogic8#AdminServerHS です。
    
    targetName
    
    必須。新しい管理対象サーバーの名前。この名前は、管理対象サーバー仮想ホストを作成するため targetRefName 変数で使用されます。
    
    startupScriptName
    
    必須。管理対象サーバーの起動スクリプトの名前。
    
    起動スクリプトのデフォルトの場所は /usr/local/bea/user_projects/servers/ domainName/ targetName です。この場所は、altServerRoot コンポーネント変数を設定することにより変更できます。
    
    startupScriptNameWindows
    
    Windows では必須。Windows システム用のドメイン起動スクリプトの名前を指定します。この変数の値は .cmd ファイルにする必要があります。
    
    serverPort
    
    SSL を使用しない場合は必須。この変数のデフォルト値は 7010 です。このポートが使用できない場合、管理対象サーバーは起動せず、エラーメッセージが表示されます。ポートを解放したあと、管理対象サーバーの「component Details」ページで Start コンポーネントプロシージャーを実行することで管理対象サーバーを起動できます。
    
    serverSslPort
    
    SSL を使用する場合は必須。この変数のデフォルト値は 7020 です。このポートは使用可能である必要があります。使用できない場合、管理対象サーバーは起動せず、エラーメッセージが表示されます。ポートを解放したあと、管理対象サーバーの「component Details」ページで Start コンポーネントプロシージャーを実行することで管理対象サーバーを起動できます。
    
    production
    
    必須。この変数は、管理対象サーバーを稼働モードで実行するかどうかを決定します。稼働モードのデフォルト値は false です。この変数は、true または false に設定できます。
    
    webLogicUser
    
    必須。 WebLogic インストールを実行する UNIX ユーザー。このユーザーはインストール先ホストに存在し、beaHome ディレクトリの書き込みアクセス権を有する必要があります。この変数のデフォルト値は、WebLogic ソフトウェアのインストールコンポーネントから取得されます。
    
    listenAddress
    
    必須。管理対象サーバーが待機に使用する IP アドレス。
    
    serverRoot
    
    必須。管理対象サーバー用に使用されるディレクトリ。
  - 別のコンポーネントから変数コンポーネントを使用するには、「Import Set」をクリックします。
    
    変数セットのインポートの詳細については、『Sun N1 Service Provisioning System 5.2 オペレーションとプロビジョニングガイド』の「プランを実行する」を参照してください。

ターゲットホストまたはターゲットホストセットを選択します。

管理対象サーバーはターゲットとするリモートエージェントに常駐します。

注 –
ターゲットホストは、com.sun.weblogic#AdminServer ホストセットのメンバーである必要があります。

WebLogic ソフトウェアをインストールした時に作成された仮想ホストをターゲットとします。「WebLogic ソフトウェアをインストールする」の手順を参照してください。

注 –
ターゲットホストは、com.sun.weblogic#InstallHS ホストセットのメンバーである必要があります。

プロビジョニングシステム内で既存の WebLogic 管理対象サーバーを取得している場合は、「markOnly」オプションを選択します。

「Run Plan (includes preflight)」をクリックします。

ライセンスコンポーネントを作成する

この手順では、ライセンスコンポーネントの作成方法を説明します。ライセンスコンポーネントを作成したあとは、「ライセンスコンポーネントをインストールする」を参照してライセンスをインストールしてください。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「License Management: Create」リンクをクリックします。

コンポーネントの「Edit」ページが表示されます。

新しいライセンスコンポーネントの名前を入力します。

(省略可能) コンポーネントのラベルと説明を入力します。

ファイルシステム上に BEA ライセンスのコピーがあるホストを選択します。

ホストのファイルシステムをナビゲートし、ライセンスファイルを選択します。

「Check In Selected Item」をクリックします。

コンポーネントの「Check In」ページが表示されます。

編集アクセス権を持っているフォルダを選択します。

「Continue to Check In」をクリックします。

ライセンスコンポーネントをインストールする

始める前に

ライセンスコンポーネントをインストールするには、プロビジョニングシステム内にライセンスコンポーネントが存在する必要があります。「ライセンスコンポーネントを作成する」を参照してください。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「License Management: View All」リンクをクリックします。

「Components」ページが表示されます。

インストールするライセンスコンポーネントの行で「Details」をクリックします。

コンポーネントの「Details」ページが表示されます。

「Component Procedures」テーブルで「Default: Install」プロシージャーを選択し、「Run」をクリックします。

プランの「Run」ページが表示されます。

ターゲットホストを選択します。

AdminServer の仮想ホストをターゲットにします。

注 –
ライセンスのインストール用にコンポーネント変数を変更する必要はありません。

(省略可能) 既存のライセンスを置き換える場合は、「Plan Variables」セクションで、「Replace Rather Than Merge With Existing License」オプションを選択します。

注 –
既存のライセンスを置き換えることを選択した場合、新しいライセンスを有効にするには、WebLogic ドメインを再起動する必要があります。

「Run Plan (includes preflight)」をクリックします。

WebLogic クラスタを作成する

次のような理由により、クラスタを作成しなければならない場合があります。

サーバーのフェイルオーバー機能を使用してアプリケーションの可用性を高める
複数のサーバーでアプリケーションをスケーリングすることでスループットを高める

クライアントに対してはクラスタは 1 つの WebLogic 管理対象サーバーインスタンスとして表示されます。クラスタを構成するサーバーインスタンスは、同一マシン上で実行したり、複数のマシンに配置することができます。クラスタ内の各クラスタメンバーは、同じバージョンの WebLogic を実行する必要があります。

この手順で新しいクラスタを作成したり、また「markOnly」オプションを選択することでプロビジョニングシステム内で既存のクラスタを登録することもできます。

始める前に

WebLogic クラスタを作成する前に、クラスタ内で使用する WebLogic ドメイン、管理サーバーおよび管理対象サーバーを作成する必要があります。

WebLogic クラスタを作成するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Cluster Management: Create」リンクをクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

「Run」ページが表示されます。

「Plan Parameters」領域で、配備する Cluster コンポーネントの変数設定を選択します。
- このコンポーネントに対して変数設定が指定されている場合、メニューから適切な設定を選択します。
- メニューから設定が使用できない場合は、「Select From List」をクリックします。
  
  「Select Variable Settings From List」ウィンドウが表示されます。
  - 変数設定の新しいセットを作成するには、「Create Set」を選択します。
    
    次のリストに、ManagedServer コンポーネントの変数のうち、更新する可能性が高い変数を示します。
    
    変数セット名
    
    必須。ユーザーが作成する新しい変数設定セットの名前
    
    targetName
    
    必須。新しいクラスタの名前。
    
    clusterAddress
    
    任意。この変数には、複数の IP アドレスに対応する DNS ホスト名、またはシングルアドレスホスト名や IP アドレスのコンマ区切りリストを使用できます。この変数には値は必要ありません。
    
    multicastAddress
    
    この変数は、クラスタメンバーが相互通信に使用できるアドレスを提供します。
    
    multicastPort
    
    この変数は、クラスタメンバーが相互通信に使用できるポート番号を提供します。
    
    「Select Variable Settings From List」ウィンドウが表示されます。
    1. 表の最上部のテキストフィールドに、新しい変数設定セットの名前を入力します。
    2. 新しいクラスタの名前を変更するには、targetName 行を選択して新しい名前を入力します。
    3. クラスタインスタンスのアドレスを指定するには、clusterAddress 行を選択してアドレスを入力します。
      
      この変数には、複数の IP アドレスに対応する DNS ホスト名、またはシングルアドレスホスト名や IP アドレスのコンマ区切りリストを使用できます。この変数には値は必要ありません。
    4. クラスタのマルチキャストアドレスを変更するには、multicastAddress 行を選択して新しいアドレスを入力します。
      
      この変数は、クラスタメンバーが相互通信に使用できるアドレスを提供します。デフォルト値は 237.0.0.1 です。
    5. クラスタのマルチキャストポートを変更するには、 multicastPort 行を選択して新しいポート番号を入力します。
      
      この変数は、クラスタメンバーが相互通信に使用できるポート番号を提供します。デフォルト値は 7001 です。
    6. 必要に応じて、そのほかの定義済み変数の値も修正します。
      - installPath は、AdminServer の仮想ホスト名、ドメイン名、およびクラスタ名に基づいて作成されます。
      - targetRefName は、ホスト名の値とドメイン名の値に基づいて作成されます。この変数の形式は、:[target:sys.hostName]_admin_:[domainName] になります。
    7. 「Save」をクリックします。
      
      新しい変数設定が表に追加されます。
    8. 「Select」をクリックします。
  - 別のコンポーネントから変数コンポーネントを使用するには、「Import Set」をクリックします。
    
    変数セットのインポートの詳細については、『Sun N1 Service Provisioning System 5.2 オペレーションとプロビジョニングガイド』の「プランを実行する」を参照してください。

ターゲットホストを選択します。

Administrative Server にはクラスタのみをインストールできるため、ターゲットホストは AdminServer 仮想ホストです。

プロビジョニングシステム内で既存の WebLogic クラスタを取得している場合は、「markOnly」オプションを選択します。

「Run Plan (includes preflight)」をクリックします。

クラスタメンバーを作成する

クラスタノードは、クラスタに割り当てられる管理対象サーバーです。アプリケーションの可用性とスケーラビリティーを高めるために、クラスタメンバーを作成できます。

管理対象サーバーがクラスタに参加すると、現在管理対象サーバーがターゲットであるアプリケーションは引き続きそのサーバーをターゲットとし、アプリケーションの配備状態は保存されます。クラスタメンバーを作成するプランは、自動的に管理対象サーバーを停止し、それをクラスタに追加します。管理対象サーバーが追加されたあと、プランは管理対象サーバーを再起動します。

この手順で新しいクラスタメンバーを作成したり、また「markOnly」オプションを選択することでプロビジョニングシステム内で既存のクラスタメンバーを登録することもできます。

始める前に

クラスタメンバーを作成する前に、次の条件が満たされている必要があります。

クラスタメンバーに変換する管理対象サーバーが存在する必要がある。

詳細は、「WebLogic 管理対象サーバーを作成する」を参照してください。
ノードの追加先のクラスタが存在する必要がある。

詳細については、「WebLogic クラスタを作成する」を参照してください。

クラスタメンバーを作成するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Cluster Member Management: Join」リンクをクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

プランの「Run」ページが表示されます。

クラスタに追加する管理対象サーバーを選択します。
- 管理対象サーバーの名前を入力するか、リストから選択して、ターゲットホストを選択します。
- メニューからターゲットホストセットを選択します。

プラン変数 WebLogic Cluster Name に正しいクラスタ名が含まれていることを確認します。

サーバーが再起動されたことを確認する前にプロビジョニングシステムが待機する期間を指定するには、「Seconds to Wait Before Failing Verify Step」フィールドに秒数を入力します。

プロビジョニングシステム内で既存の WebLogic クラスタメンバーを取得している場合は、「markOnly」オプションを選択します。

「Run Plan (includes preflight)」をクリックします。

WebLogic ドメイン、サーバー、およびクラスタの管理

この節では、WebLogic サーバーをインストールしたあとに WebLogic サーバーおよびクラスタで一般に実行するタスクを説明します。

ドメインと Administrative Server

「WebLogic ドメインと管理サーバーを削除する」

クラスタ

管理対象サーバー

WebLogic ドメインと管理サーバーの管理

この節では、WebLogic ドメインと管理サーバーを管理する手順を説明します。

WebLogic ドメインと管理サーバーを削除する

プロビジョニングシステムを介して WebLogic ドメインを削除することで、自動的に次のタスクを実行します。

WebLogic AdminServer コンポーネントおよび仮想ホストのアンインストール。

このタスクは管理サーバーを削除します。「markOnly」オプションを選択した場合、AdminServer 仮想ホストだけが削除されます。
ドメイン内に属するすべての管理対象サーバーコンポーネントおよび仮想ホストのアンインストール。

この操作を行うと、「markOnly」オプションを選択している場合を除き、WebLogic 環境内の管理対象サーバーも削除されます。
ドメイン内に属するすべてのクラスタコンポーネントおよび仮想ホストのアンインストール。

この操作を行うと、「markOnly」オプションを選択している場合を除き、WebLogic 環境内のクラスタも削除されます。
アプリケーションコンポーネント、ライセンス構成、およびアプリケーションの削除。

注 –

WebLogic 仮想ホストは、プラグインに属さないコンポーネントを含むことはできません。WebLogic ドメインを正しく削除するには、ドメインアンインストールプランを実行する前に、プラグインに属さないすべてのコンポーネントを削除する必要があります。

始める前に

WebLogic ドメインを削除するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Domain Management: Remove」リンクをクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

プランの「Run」ページが表示されます。

ターゲットホストを選択します。

WebLogic ソフトウェアをインストールした時に作成された仮想ホストをターゲットとします。「WebLogic ソフトウェアをインストールする」の手順を参照してください。

注 –
ターゲットホストは、com.sun.weblogic#InstallHS ホストセットのメンバーである必要があります。

「WebLogic Domain Name」フィールドに WebLogic ドメインの名前を入力します。

プロビジョニングシステムから WebLogic ドメイン、管理サーバー、クラスタ、および管理対象サーバーを削除し、WebLogic 環境でドメインを動作させ続ける場合は、「markOnly 」オプションを選択します。

「Run Plan (includes preflight)」をクリックします。

WebLogic ドメインまたは管理サーバーを起動する

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Domain Management: Start」リンクをクリックします。

「component Details」ページが表示されます。

「Component Procedures」リストで、StartAdminServer プロシージャーを含む行を選択し、「Run」をクリックします。

プランの「Run」ページが表示されます。

起動する必要がある管理サーバーを選択します。

管理対象サーバーは host (install-path) の形式に従います。host は物理ホストとドメインの名前を表し、install-path はを表します。管理サーバー名は server_wls_ managedServerName と表示されます (たとえば server_weblogic (admin_wls))。

「Run Selected Installations」をクリックします。

プランの「Run」ページが表示されます。

プラン変数を設定します。
1. (省略可能) Java に渡される標準メモリー引数をオーバーライドするには、「VmArgs」フィールドに名前を入力します。
  
  「vmArgs」フィールドに使用される形式は、—virtualMachineName です。たとえば -Xms32m -Xmx200m のようになります。
2. サーバーが起動したことを確認する前にプロビジョニングシステムが待機する期間を指定するには、「Seconds to Wait Before Failing Verify Step」フィールドに秒数を入力します。

「Run Plan (includes preflight)」をクリックします。

WebLogic クラスタの管理

次の節では、クラスタを起動、停止、および削除する方法を説明します。

クラスタを起動または停止する

クラスタを起動または停止すると、クラスタ内のすべてのクラスタメンバーを起動または停止することになります。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Cluster Management: Start or Stop」リンクをクリックします。

「component Details」ページが表示されます。

「Component Procedures」リストで、Start または Stop プロシージャーを含む行を選択し、「Run」をクリックします。

プランの「Run」ページが表示されます。

起動または停止するクラスタを選択します。

クラスタ名は installPath の一部です。

「Run Selected Installations」をクリックします。

プランの「Run」ページが表示されます。

「Run Plan (includes preflight)」をクリックします。

WebLogic クラスタを削除する

クラスタを削除すると、そのクラスタに関連付けられたすべてのクラスタメンバーも削除されます。

管理対象サーバーの役割に戻るクラスタメンバーの動作の詳細については、「WebLogic クラスタメンバーを削除する」を参照してください。

注 –

管理対象サーバーをクラスタから削除すると、管理対象サーバーは停止されます。引き続き管理対象サーバーを使用する場合は、管理対象サーバーを再起動する必要があります。「管理対象サーバーを起動する」を参照してください。

始める前に

クラスタを削除するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Cluster Management: Remove」リンクをクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

プランの「Run」ページが表示されます。

「Target Host」フィールドで、クラスタをホストするドメインを選択します。

「Plan Variables」セクションの「WebLogic Cluster Name」フィールドで、WebLogic インタフェースに表示されるクラスタ名を入力します。

プロビジョニングシステムから WebLogic クラスタを削除するが、そのクラスタを WebLogic 環境で動作させ続ける場合は、「markOnly」オプションを選択します。

「Run Plan (includes preflight)」をクリックします。

WebLogic クラスタメンバーを削除する

クラスタメンバーを削除すると、クラスタメンバーコンポーネントが管理対象サーバーから削除され、クラスタメンバーとして動作していた管理対象サーバーが元の状態に戻ります。クラスタをターゲットとしていたアプリケーション、およびクラスタメンバーは、再起動後、管理対象サーバーによりホストされなくなります。管理対象サーバーを直接ターゲットとしていたアプリケーションは、引き続き管理対象サーバーをターゲットとします。

クラスタから管理対象サーバーが削除されると、管理対象サーバーは停止状態のままになります。引き続き管理対象サーバーを使用する場合は、管理対象サーバーを再起動する必要があります。「管理対象サーバーを起動する」を参照してください。

始める前に

クラスタメンバーを削除するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Clusters Member Management: Leave」リンクをクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

プランの「Run」ページが表示されます。

削除する管理対象サーバーを選択します。

プロビジョニングシステムから WebLogic クラスタメンバーを削除するが、WebLogic 環境でクラスタメンバーを動作させ続ける場合は、「markOnly」オプションを選択します。

「Run Plan (includes preflight)」をクリックします。

WebLogic 管理対象サーバーの管理

管理対象サーバーを起動する

始める前に

管理対象サーバーを起動するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Application Server Management: Start」リンクをクリックします。

「component Details」ページが表示されます。

「Component Procedures」リストで、Start プロシージャーを含む行を選択し、「Run」をクリックします。

プランの「Run」ページが表示されます。

起動する必要がある管理対象サーバーを選択します。

管理対象サーバーは host (install-path) の形式に従います。host は物理ホストの名前を表し、install-path は管理対象サーバーの名前を表します。管理対象サーバー名は server_wls_ managedServerName と表示されます。たとえば、server_wls_Server-One となります。

「Run Selected Installations」をクリックします。

プランの「Run」ページが表示されます。

プラン変数を設定します。
1. (省略可能) Java に渡される標準メモリー引数をオーバーライドするには、「VmArgs」フィールドに名前を入力します。
  
  「vmArgs」フィールドに使用される形式は、—virtualMachineName です。たとえば -Xms32m -Xmx200m のようになります。
2. サーバーが起動したことを確認する前にプロビジョニングシステムが待機する期間を指定するには、「Seconds to Wait Before Failing Verify Step」フィールドに秒数を入力します。

「Run Plan (includes preflight)」をクリックします。

管理対象サーバーを停止する

始める前に

管理対象サーバーを停止するには、ユーザーは、コンポーネントが含まれるフォルダ上の Run Component Procedures アクセス権を有するユーザーグループに属する必要があります。また、コンポーネントの配備先のホストセットに関しては、Allow on Host Set アクセス権も必要です。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Application Server Management: Stop」リンクをクリックします。

「component Details」ページが表示されます。

「Component Procedures」リストで、Stop プロシージャーを含む行を選択し、「Run」をクリックします。

プランの「Run」ページが表示されます。

起動する必要がある管理対象サーバーを選択します。

管理対象サーバーは host (install path) の形式に従います。host は物理ホストの名前を表し、install path は管理対象サーバーの名前を表します。管理対象サーバー名は server_domainName_managedServerName と表示されます。たとえば、server_wls_Server-One のようになります。

「Run Selected Installations」をクリックします。

プランの「Run」ページが表示されます。

「Run Plan (includes preflight)」をクリックします。

管理対象サーバーを削除する

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Application Server Management: Remove」リンクをクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

プランの「Run」ページが表示されます。

削除する管理対象サーバーを選択します。

必要に応じてプラン変数を変更します。
1. WebLogic 管理対象サーバーの名前を入力します。
2. 管理対象サーバーが登録されている WebLogic ドメインの名前を入力します。
3. プロビジョニングシステムから WebLogic 管理対象サーバーを削除するが、WebLogic 環境で管理対象サーバーを動作させ続ける場合は、「markOnly」オプションを選択します。

「Run Plan (includes preflight)」をクリックします。

管理対象サーバーに追加 `CLASSPATH` 要素を追加する

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Application Server Management: Start」リンクをクリックします。

「component Details」ページが表示されます。

「Component Procedures」リストで、setAdditionalClasspath プロシージャーを含む行を選択し、「Run」をクリックします。

プランの「Run」ページが表示されます。

更新する管理対象サーバーを選択します。

管理対象サーバーは host (install path) の形式に従います。host は物理ホストの名前を表し、install path は管理対象サーバーの名前を表します。管理対象サーバー名は server_domainName_managedServerName と表示されます。たとえば、server_wls_Server-One のようになります。

「Run Selected Installations」をクリックします。

プランの「Run」ページが表示されます。

追加 CLASSPATH 要素を入力します。

追加 CLASSPATH 要素は、WebLogic 管理対象サーバー起動スクリプトで定義されているデフォルトの CLASSPATH に加えられます。この起動スクリプトは、管理対象サーバーが作成された時に定義されたものです。「WebLogic 管理対象サーバーを作成する」を参照してください。

Windows システムでは、追加 CLASSPATH 要素の区切りにセミコロン (;) を使用し、バックスラッシュ文字 (\) をファイルセパレータとして使用します。たとえば、c:/files/a1.jar; c:/files/a2.jar;c:/files/b1.jar となります。

(省略可能) 追加 classpath 要素をただちに有効にするには、「Restart Server」を選択します。

「Run Plan (includes preflight)」をクリックします。

WebLogic アプリケーションの取得と編集

「WebLogic Common Tasks」ページでは、WebLogic Enterprise、EJB テクノロジー、および Web アプリケーションの取得、構成、および配備を行うことができます。

次の節で説明する、複数の特別なタスクを実行できます。

注 –

Sun N1 Service Provisioning System の外部では、WebLogic アプリケーションの配備や管理を行わないでください。プロビジョニングソフトウェアを使用する場合、プロビジョニングソフトウェアのみを使用して WebLogic アプリケーションを管理する必要があります。

WebLogic エンタープライズアプリケーションまたは EAR ファイルを取得する

ブラウザインタフェースの「Common Tasks」セクションで、「WebLogic」をクリックします。

「Enterprise Applications (EAR): Create」リンクをクリックします。

(省略可能) このコンポーネントのラベルを入力します。

(省略可能) このコンポーネントの説明を入力します。

アプリケーションをどのようにインポートするかを選択します。

詳細については、「エンタープライズアプリケーションのブラウズ」を参照してください。
- AdminServer からインポートする場合は、「WebLogic Admin Server」を選択し、 EAR ファイルのインポート元である WebLogic Admin Server を選択します。
- ファイルシステムからインポートする場合は、「File System」を選択し、EAR ファイルのインポート元であるホストを選択します。

階層をナビゲートして、取得するエンタープライズアプリケーションを検索します。

「Check-in Selected Item」をクリックします。

「check-in」ページの情報を確認して、「Continue to Check-in」をクリックします。

WebLogic Web アプリケーションまたは WAR ファイルを取得する

ブラウザインタフェースの「Common Tasks」セクションで、「WebLogic」をクリックします。

「WebLogic Common Tasks」ページの「Web Applications (WAR)」セクションで「Create」をクリックします。

(省略可能) このコンポーネントのラベルを入力します。

(省略可能) このコンポーネントの説明を入力します。

アプリケーションをどのようにインポートするかを選択します。

詳細については、「Web アプリケーションのブラウズ」を参照してください。
- AdminServer からインポートする場合は、「WebLogic Admin Server」を選択し、 WAR ファイルのインポート元である WebLogic Admin Server を選択します。
- ファイルシステムからインポートする場合は、「File System」を選択し、WAR ファイルのインポート元であるホストを選択します。

階層をナビゲートして、取得する Web アプリケーションを検索します。

「Check-in Selected Item」をクリックします。

「check-in」ページの情報を確認して、「Continue to Check-in」をクリックします。

WebLogic JAR ファイルを取得する

ブラウザインタフェースの「Common Tasks」セクションで、「WebLogic」をクリックします。

「WebLogic Common Tasks」ページの「Java Archives Containing EJBs (JAR)」セクションで「Create」をクリックします。

このコンポーネントのラベルを入力します。

このコンポーネントの説明を入力します。

JAR ファイルをどのようにインポートするかを選択します。

詳細については、「JAR または EJB ファイルのブラウズ」を参照してください。
- AdminServer からインポートする場合は、「WebLogic Admin Server」を選択し、 JAR ファイルのインポート元である WebLogic Admin Server を選択します。
- ファイルシステムからインポートする場合は、「File System」を選択し、JAR ファイルのインポート元であるホストを選択します。

階層をナビゲートして、取得する JAR ファイルを検索します。

「Check-in Selected Item」をクリックします。

「check-in」ページの情報を確認して、「Continue to Check-in」をクリックします。

コンポーネントタイプを使用した WebLogic アプリケーションの配備

WebLogic 8 プラグインには WebLogic に固有の複数のコンポーネントタイプが含まれています。これらのコンポーネントタイプを使用すると、最も一般的な WebLogic アプリケーションコンポーネントの多くを素早くモデル化し、特定のリソースとインストール、アンインストール、エクスポート、およびスナップショット動作を自動的に関連付けることができます。サーバーやクラスタを作成、管理する際には、コンポーネントタイプの多くがソフトウェアにより使用されます。その結果、通常は少数のコンポーネントタイプのみで作業を行います。

ただし、アプリケーションのニーズに応じて、アプリケーションコンポーネントを配備する前に WebLogic サービスを構成しなければならない場合があります。サービスを構成するには、次の節で説明されているコンポーネントタイプに依存しなければならない場合があります。

これらの構成コンポーネントタイプが必要であるのは、アプリケーションで必要とされる場合のみです。たとえば、Web アプリケーションがデータベースを使用して情報の取得と格納を行う場合、接続プールとデータソースあるいはトランザクションデータソースを構成する必要があります。

これらの構成コンポーネントタイプを使用するには、実行するタスクを選択し、関連付けられたコンポーネントプロシージャーを実行します。ファイルシステムのほかの場所に存在する既存のコンポーネントに基づいて新しいコンポーネントを作成およびチェックインする必要がある場合は、「Create」をクリックします。新しいコンポーネントをチェックインしたあと、適切なコンポーネントプロシージャーを実行し、アプリケーションのニーズに従って WebLogic 環境を構成します。

通常は、アプリケーションを配備する前にこれらの構成コンポーネントタイプの構成と配備を行います。ただし、構成が完了したあとでアプリケーションを再起動することによってアプリケーションコンポーネントが配備されたあとに、WebLogic 環境を構成できます。アプリケーションを再起動するにはアプリケーションを再配備します。

これらの構成オブジェクトの構成についての詳細は、BEA's Administration Console Online Help を参照してください。

エンタープライズアプリケーション (EAR) コンポーネントタイプ

このタイプのコンポーネントは、エンタープライズアプリケーションをモデル化します。このコンポーネントは、エンタープライズアプリケーションアーカイブ (EAR) またはパッケージとして EAR の拡張版を含むことができます。

エンタープライズアプリケーションのブラウズ

次のブラウザのいずれかを使用して、このコンポーネントタイプのエンタープライズアプリケーションを選択できます。

インストールされたアプリケーションのいずれかとその関連設定を選択できる WebLogic 管理サーバーブラウザ。管理サーバーブラウザは、管理サーバー上のエンタープライズアプリケーションのアルファベット順リストを提供します。あるコンポーネント用に 1 つのエンタープライズアプリケーションを選択できます。
EAR ファイルを選択して、設定が含まれないコンポーネントを作成できる、ファイルシステムブラウザ。ファイルシステムブラウザは、ユーザーが選択できるファイルとディレクトリのリストを提供します。これらのファイルまたはタイプ *.ear のみをブラウザに表示させることを選択できます。

エンタープライズアプリケーションのインストール

エンタープライズアプリケーションコンポーネントをインストールするには、ターゲットホストとして WebLogic 管理対象サーバーまたはクラスタを使用する必要があります。インストールプロセスにより、次の 3 つの主要タスクが実行されます。

ターゲットへの EAR ファイルのインストール。
WebLogic 管理サーバーへの EAR の登録。
ドメインのブラウズで以前に取得されたプロパティーの適用。

アプリケーションの「component Details」ページにナビゲートし、 Install コンポーネントプロシージャーを実行することにより、エンタープライズアプリケーションをインストールできます。

エンタープライズアプリケーションのアンインストール

エンタープライズアプリケーションコンポーネントをアンインストールすると、エンタープライズアプリケーションは仮想ホストをターゲットとはしなくなります。ほかの場所でもエンタープライズアプリケーションがターゲットとされていない場合、管理サーバーから登録コンポーネントが削除されます。

アプリケーションの「component Details」ページにナビゲートし、 Uninstall コンポーネントプロシージャーを実行することにより、エンタープライズアプリケーションをアンインストールできます。

エラー状態

表 4–2 WebLogic エンタープライズアプリケーションのエラー状態


アクション	条件	結果
インストール	トポロジが正しく構成されていない (ターゲットホストが正しいドメインホストをポイントしていない)	ターゲット化が失敗する
インストール	ターゲットホストが有効な WebLogic ターゲットではない	インストールが禁止される
ブラウズ/インストール/アンインストール	資格が適切に構成されていない	操作が失敗する
ブラウズ	ドメインホストでパスが正しく構成されていない	ブラウズが失敗する

Web アプリケーション (WAR) コンポーネントタイプ

このタイプのコンポーネントには Web アプリケーションが含まれます。コンポーネントには、関連する設定を持つ Web アプリケーション、または設定を持たない Web アプリケーションのいずれかが含まれます。

Web アプリケーションのブラウズ

次のブラウザのいずれかを使用して、このコンポーネントタイプの Web アプリケーションを選択できます。

インストールされたアプリケーションのいずれかとその関連設定を選択できる WebLogic 管理サーバーブラウザ。管理サーバーブラウザは、管理サーバー上の Web アプリケーションのアルファベット順リストを提供します。1 つのコンポーネントに対して 1 つの Web アプリケーションを選択できます。
WAR ファイルを選択して、設定が含まれないコンポーネントを作成できる、ファイルシステムブラウザ。ファイルシステムブラウザは、ユーザーが選択できるファイルとディレクトリのリストを提供します。これらのファイルまたはタイプ *.war のみをブラウザに表示させることを選択できます。

Web アプリケーションのインストール

Web アプリケーションコンポーネントをインストールするには、ターゲットホストとして WebLogic 管理対象サーバーまたはクラスタを使用する必要があります。インストールプロセスでは、そのターゲットにコンポーネントがインストールされ、ターゲットの管理サーバーには包含される登録コンポーネントがインストールされます。

アプリケーションの「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、Web アプリケーションをインストールできます。

Web アプリケーションのアンインストール

Web アプリケーションコンポーネントをアンインストールすると、Web アプリケーションは仮想ホストをターゲットとはしなくなります。ほかの場所でも Web アプリケーションがターゲットとされていない場合、管理サーバーから登録コンポーネントが削除されます。

アプリケーションの「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、Web アプリケーションをアンインストールできます。

エラー状態

表 4–3 WebLogic Web アプリケーションのエラー状態


アクション	条件	結果
インストール	トポロジが正しく構成されていない (ターゲットホストが正しいドメインホストをポイントしていない)	ターゲット化が失敗する。
インストール	ターゲットホストが有効な WebLogic ターゲットではない。	インストールが禁止される。
ブラウズ/インストール/アンインストール	資格が適切に構成されていない。	操作が失敗する。
ブラウズ	ドメインホストでパスが正しく構成されていない。	ブラウズが失敗する。

EJB コンポーネントタイプを含む Java アーカイブファイル

JAR または EJB ファイルのブラウズ

次のブラウザのいずれかを使用して、このコンポーネントタイプの JAR または EJB ファイルを選択できます。

インストールされたアプリケーションのいずれかとその関連設定を選択できる WebLogic 管理サーバーブラウザ。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。1 つのコンポーネントに対して 1 つの EJB を選択できます。
JAR ファイルを選択して、設定が含まれないコンポーネントを作成できる、ファイルシステムブラウザ。ファイルシステムブラウザは、ユーザーが選択できるファイルとディレクトリのリストを提供します。これらのファイルまたはタイプ *.jar のみをブラウザに表示させることを選択できます。

JAR または EJB ファイルのインストール

このタイプのコンポーネントをインストールすると、インストールパスに基づいてファイルまたはディレクトリがファイルシステムにコピーされます。コピーが完了すれば、ファイルまたはディレクトリは WebLogic 管理サーバーに登録されます。

アプリケーションの「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、JAR または EJB ファイルをインストールできます。

JAR または EJB ファイルのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、JAR または EJB ファイルをアンインストールできます。

エラー状態

表 4–4 WebLogic EJB コンテナのエラー状態


アクション	条件	結果
アンインストール	依存する WebLogic EJB が依然としてインストールされている。	依存関係を示し、アンインストールが失敗する。

接続プールのコンポーネントタイプ

接続プールのブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザから接続プールおよびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJDBCConnectionPoolConfig と呼ばれるデフォルトの接続プールコンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

接続プールのインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、接続プールをインストールできます。

接続プールをインストールする前に、次の必須変数を設定する必要があります。

プール名
URL
ドライバ
データベース名
ユーザー
パスワード

接続プールのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、接続プールをアンインストールできます。

データソースおよびトランザクションデータソースのコンポーネントタイプ

データソースまたはトランザクションデータソースのブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザからデータソースまたはトランザクションデータソースおよびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインにはデフォルトのデータソースおよびトランザクションデータソースも含まれているため、ブラウズする必要がありません。「Common Tasks」ページから「View All」を選択することにより、/com/sun/webLogic8 フォルダでデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。デフォルトのコンポーネントの名前を次に示します。

WLDataSourceConfig – データソースコンポーネント
WLTxDataSourceConfig – トランザクションデータソースコンポーネント

データソースまたはトランザクションデータソースのインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することで、データソースまたはトランザクションデータソースをインストールできます。

注 –

データソースまたはトランザクションデータソースコンポーネントをインストールするには、その前に接続プールコンポーネントがインストールされている必要があります。

データソースまたはトランザクションデータソースをインストールする前に、次の必須変数を設定する必要があります。

データソースまたはトランザクションデータソースの名前
Java Naming and Directory Interface™ (JNDI™) の名前
プール名

データソースまたはトランザクションデータソースのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することで、データソースまたはトランザクションデータソースをアンインストールできます。

マルチプールコンポーネントタイプ

マルチプールのブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザからマルチプールおよびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJDBCMultiPoolConfig と呼ばれるデフォルトのマルチプールコンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

マルチプールのインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、マルチプールをインストールできます。

マルチプールをインストールする前に、次の必須変数を設定する必要があります。

マルチプール名
アルゴリズムタイプ
プールリスト – パイプで区切られた (|) 接続プールのリスト

マルチプールのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、マルチプールをアンインストールできます。

スレッドプールコンポーネントタイプ

スレッドプールの構成

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、スレッドプールをインストールできます。

プランのパラメータ変数設定を編集できます。

スレッドプールのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、スレッドプールをアンインストールできます。

トランザクションサービスコンポーネントタイプ

トランザクションサービスの構成

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、トランザクションサービスをインストールできます。

プランのパラメータ変数設定を編集できます。

トランザクションサービスのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、トランザクションサービスをアンインストールできます。

JMS Server コンポーネントタイプ

JMS Server のブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザから JMS Server およびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJMSServerConfig と呼ばれるデフォルトの JMS サーバーコンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

JMS Server のインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、JMS Server をインストールできます。

JMS Server をインストールする前に、JMS Server の必須の名前変数を設定する必要があります。

JMS Server のアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、JMS Server をアンインストールできます。

JMS Queue コンポーネントタイプ

JMS Queue のブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザから JMS Queue およびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJMSQueueConfig と呼ばれるデフォルトの JMS Queue コンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

JMS Queue のインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、JMS Queue をインストールできます。

注 –

JMS Queue コンポーネントをインストールするには、その前に JMS Server コンポーネントがインストールされている必要があります。

コンポーネントをインストールする前に、次の必須変数を設定する必要があります。

jmsDestName
jmsserverName
jndiName

JMS Queue のアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、JMS Queue をアンインストールできます。

JMS Topic コンポーネントタイプ

JMS Topic のブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザから JMS Topic およびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJMSTopicConfig と呼ばれるデフォルトの JMS Topic コンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

JMS Topic のインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、接続プールをインストールできます。

注 –

JMS Topic コンポーネントをインストールするには、その前に JMS Server コンポーネントがインストールされている必要があります。

コンポーネントをインストールする前に、次の必須変数を設定する必要があります。

jmsDestName
jmsserverName
jndiName

JMS Topic のアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、JMS Topic をアンインストールできます。

JMS File Store コンポーネントタイプ

JMS File Store のブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザから JMS File Store およびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJMSFileStoreConfig と呼ばれるデフォルトの JMS File Store コンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

JMS File Store のインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、JMS File Store をインストールできます。

コンポーネントをインストールする前に、次の必須変数を設定する必要があります。

jmsFileStoreName

JMS File Store のアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、JMS File Store をアンインストールできます。

JMS JDBC Store コンポーネントタイプ

JMS JDBC Store のブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザから JMS JDBC Store およびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJMSJDBCStoreConfig と呼ばれるデフォルトの JMS JDBC Store コンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

JMS JDBC Store のインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、JMS JDBC Store をインストールできます。

コンポーネントをインストールする前に、次の必須変数を設定する必要があります。

jmsJDBCStoreName

JMS JDBC Store のアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、JMS JDBC Store をアンインストールできます。

JMS Connection Factory コンポーネントタイプ

JMS Connection Factory は接続構成情報をカプセル化し、JMS アプリケーションがメッセージングシステムと通信できるようにします。

JMS Connection Factory のブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザから JMS Connection Factory およびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJMSConnectionFactoryConfig と呼ばれるデフォルトの JMS Connection Factory コンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

JMS Connection Factory のインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、JMS Connection Factory をインストールできます。

コンポーネントをインストールする前に、次の必須変数を設定する必要があります。

jmsConnectionFactoryName
jndiName

JMS Connection Factory のアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、JMS Connection Factory をアンインストールできます。

JMS Destination Key コンポーネントタイプ

JMS Destination Key のブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザから JMS Destination Key およびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインには、WLJMSDestinationKeyConfig と呼ばれるデフォルトの JMS Destination Key コンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「Common Tasks」ページで「View All」を選択することにより、/com/sun/webLogic8 フォルダ内のデフォルトのコンポーネントを検索できます。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

JMS Destination Key のインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、JMS Destination Key をインストールできます。

コンポーネントをインストールする前に、次の必須変数を設定する必要があります。

jmsDestinationKeyName

JMS Destination Key のアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、JMS Destination Key をアンインストールできます。

メールセッションコンポーネントタイプ

メールセッションのブラウズ

WebLogic 管理サーバーブラウザを使用すると、このブラウザからメールセッションおよびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

メールセッションのインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、メールセッションをインストールできます。

メールセッションをインストールする前に、次の必須変数を設定する必要があります。

msName
jndiName
メールセッションプロパティー – この変数は WebLogic 8 プラグインで生成され、WebLogic コンソールでメールセッションのプロパティーとして設定した値に設定されます。たとえば、mail.user。

メールセッションのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、メールセッションをアンインストールできます。

コンポーネントタイプによる WebLogic の構成

既存の構成設定とインフラストラクチャーオブジェクトのブラウズ

WebLogic 管理サーバーブラウザを使用すると、アプリケーションサーバー構成オブジェクトおよびその関連設定を選択できます。管理サーバーブラウザは、管理サーバー上のアプリケーションのアルファベット順リストを提供します。

WebLogic プラグインにはデフォルトのコンポーネントも含まれ、ブラウズの必要がありません。デフォルトのコンポーネントは /com/sun/webLogic8 フォルダにあります。または、「Common Tasks」ページの「Configuration Tasks」セクションで「View All」を選択します。デフォルトのコンポーネントは、Default: Install コンポーネントプロシージャーを使用することで、「component Details」ページからインストールできます。

次のリストは、コンポーネントタイプとしてモデル化された各 WebLogic 構成オブジェクトを示しています。このリストには、デフォルトのコンポーネント名、およびカスタム値が必要なコンポーネント変数も示してあります。

データソースのコンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLDataSourceConfig です。必須コンポーネント変数は、データソース名 (dataSourceName)、JNDI 名 (jndiName)、プール名 (poolName) です。

トランザクションデータソースのコンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLTxDataSourceConfig です。必須コンポーネント変数は、トランザクションデータソース名 (dataSourceName)、JNDI 名 (jndiName)、プール名 (poolName) です。

接続プールのコンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJDBCConnectionPoolConfig です。必須コンポーネント変数は、プール名 (name)、URL (url)、ドライバ (driverName)、データベース名 (databaseName)、ユーザー (user)、パスワード (password) です。

マルチプールコンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJDBCMultiPoolConfig です。必須コンポーネント変数は、マルチプール名 (multiPoolName)、アルゴリズムタイプ (algorithmType)、プールリスト – 接続プールのパイプ区切り (|) リスト (poolList) です。

スレッドプールコンポーネントタイプ

既存のスレッドプールはブラウズできません。

トランザクションサービスコンポーネントタイプ

既存のスレッドプールはブラウズできません。

JMS Server コンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJMSServerConfig です。必須コンポーネント変数は、JMS サーバー名 (jmsServerName) です。

JMS Queue コンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJMSQueueConfig です。必須コンポーネント変数は、JMS 接続先名 (jmsDestName)、JMS サーバー名 (jmsserverName)、JMS 接続先の JNDI 名 (jndiName) です。

JMS Topic コンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJMSTopicConfig です。必須コンポーネント変数は、JMS 接続先名 (jmsDestName)、JMS サーバー名 (jmsserverName)、JMS 接続先の JNDI 名 (jndiName) です。

JMS File Store コンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJMSFileStoreConfig です。必須コンポーネント変数は、JMS ファイルストアの名前 (jmsFileStoreName) です。

JMS JDBC Store コンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJMSJDBCStoreConfig です。必須コンポーネント変数は、JMS JDBC ストアの名前 (jmsJDBCStoreName) です。

JMS Connection Factory コンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJMSConnectionFactoryConfig です。必須コンポーネント変数は、JMS 接続ファクトリの名前 (jmsConnectionFactoryName)、JNDI 名 (jndiName) です。

JMS Destination Key コンポーネントタイプ

このコンポーネントタイプのデフォルトコンポーネントは WLJMSDestinationKeyConfig です。必須コンポーネント変数は、JMS 接続先キーの名前 (jmsDestinationKeyName) です。

メールセッションコンポーネントタイプ

このコンポーネントタイプにはデフォルトのコンポーネントはありません。

必須コンポーネント変数は、メールセッション名 (msName)、JNDI 名 (jndiName)、およびメールセッションプロパティーの WebLogic 値から生成された変数です。

WebLogic 構成コンポーネントのインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、コンポーネントをインストールできます。多くのコンポーネントでは、一部のコンポーネント変数を編集する必要があります。カスタム値が必要な変数については、WebLogic 構成コンポーネントタイプのリストを参照してください。

WebLogic 構成コンポーネントのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、構成コンポーネントをアンインストールできます。

ライセンスコンポーネントタイプ

ライセンスのブラウズ

ファイルシステムブラウザを使用し、ライセンスを選択することができます。ファイルシステムブラウザは、ユーザーが選択できるファイルとディレクトリのリストを提供します。

ライセンスのインストール

「component Details」ページにナビゲートし、Install コンポーネントプロシージャーを実行することにより、ライセンスをインストールできます。

ライセンスのアンインストール

このタイプのコンポーネントをアンインストールすると、マスターサーバーからファイルまたはディレクトリが削除されます。

「component Details」ページにナビゲートし、Uninstall コンポーネントプロシージャーを実行することにより、ライセンスをアンインストールできます。

Solaris: WebLogic 8 デモアプリケーションの実行: Avitek Medical Records

Avitek Medical Records デモは WebLogic 8 プラグインに含まれ、BEA WebLogic 8 およびカスタムアプリケーションのプロビジョニング方法を示しています。このデモを実行できるのは Solaris OS だけです。デモ関連のすべてのプランとコンポーネントは、/com/sun/weblogic8/demo/ フォルダにあります。

サンプルアプリケーションのインストール

デモアプリケーションをインストールするには、installDemoAppPlan プランを実行します。このプランではデータベースが設定され、管理対象サーバー用の JMS および JDBC リソースが構成されます。JMS および JDBC コンポーネントは、既存のコンポーネントタイプから作成されます。

InstallDemoAppPlan では次の作業が実行されます。

PointBase データベースを起動する。
サンプル JDBC 接続プールをインストールする。
サンプル JDBC データソースをインストールする。
サンプル JMS JDBC ストアをインストールする。
サンプル JMS サーバーをインストールする。
サンプル JMS キューをインストールする。
サンプル JMS 接続ファクトリをインストールする。
サンプルアプリケーションにメール機能を追加する。
デモアプリケーションへのログインに必要な認証機能を構成する。

サンプルアプリケーションをコンパイルする

Avitek Medical Records サンプルアプリケーションをインストールするには、その前にアプリケーションをコンパイルする必要があります。次の手順に従ってください。

サンプルアプリケーション用にドメインを作成した場合は、サンプルアプリケーションのドメインディレクトリにある環境スクリプトを取得します。
# BEA-InstallDirectory/user_projects/domains/medrec/setMedRecEnv.sh
この例では、BEA-InstallDirectory は BEA WebLogic のホームディレクトリを示しています。たとえば、/export/home/bea となります。

サンプルアプリケーションの src ディレクトリに移動します。
# BEA-InstallDirectory/weblogic81/samples/server/medrec/src

ant 構築ユーティリティーを使用してサンプルアプリケーションのソースを構築します。
# ant

次のような内容の、package.xml という名前の XML ファイルを作成します。

<project name="tutorial" default="package">
         <target name="package">
            <wlpackage srcdir="/export/home/bea/weblogic81/samples/server/medrec/src/medrecEar"
                       destdir="/export/home/bea/weblogic81/samples/server/medrec/build/medrecEar"
                       toFile="/export/home/bea/weblogic81/samples/server/medrec/dist/medrecEar.ear" />
         </target>
     </project>

wlpackage 要素で、システム上の正しいディレクトリを示すよう srcdir、destdir、および toFile のパスを変更します。

このファイルをBEA-InstallDirectory/weblogic81/samples/server/medrec/src/medrecEar ディレクトリに保存します。

手順 4 と手順 5 を繰り返し、physicianEar および startupEar ディレクトリ用の package.xml ファイルを作成します。

正しい physicianEar および startupEar ディレクトリを示すよう、srcdir、destdir、および toFile のパスを変更します。それぞれの package.xml ファイルを、BEA-InstallDirectory /weblogic81/samples/server/medrec/src ディレクトリの該当するサブディレクトリに保存します。

各 EAR ディレクトリで ant 構築ユーティリティーを使用し、package.xml ファイルの内容で構築を更新します。
# cd BEA-InstallDirectory/weblogic81/samples/server/medrec/src/EAR-dir # ant -f package.xml
この例では、EAR-dir は medrecEar、physicianEar、または startupEar ディレクトリになります。

medrecEar.ear、physicianEar.ear、startupEar.ear の各ファイルは、BEA-InstallDirectory/weblogic81/samples/server/medrec/dist に作成されます。

サンプルアプリケーションをインストールする

始める前に

Avitek Medical Records デモを実行するには、その前に次の手順を実行しておく必要があります。

WebLogic 8 プラグインバージョン 3.0 のインストール後、またはバージョン 3.0 へのアップグレード後は、これらの手順を実行する必要があります。

WebLogic デモの展開された EAR ディレクトリを .ear ファイルに変換します。

WebLogic デモファイルは BEA-InstallDirectory/weblogic81/samples/server/medrec/dist/ にあります。変換しなければならないのは、medrecEar、physicialEar、および startupEar ディレクトリです。
1. 各ディレクトリ内で .ear ファイルを作成します。
  
  使用するコマンド構文は、jar cvf jar-file input-files です。
  startupEar ディレクトリで、次のコマンドを実行します。 # jar cvf startupEar.ear .

作成された .ear ファイルからコンポーネントを作成します。

詳細については、「WebLogic エンタープライズアプリケーションまたは EAR ファイルを取得する」を参照してください。

注 –
コンポーネントは、WebLogic 8 プラグインに所有権のあるフォルダ以外のフォルダに保存する必要があります。

WebLogic アプリケーションのセッション変数を作成します。

次のセッション変数を作成します。

WL_POINTBASE_PORT

WebLogic アプリケーション用に使用するポートを指定する。WL_POINTBASE_PORT の値には、未使用の任意のポート番号を指定できます。デフォルト値は 9092 です。

「Common Tasks」ページで「Demo Application Configuration: Configure」をクリックします。

プランの「Details」ページが表示されます。

「Run」をクリックします。

プランパラメータのコンポーネント変数は、デフォルト値に設定されたままにします。

管理対象サーバーをターゲットホストとして選択します。

デモアプリケーションの EAR コンポーネントをインストールします。
1. WebLogic プラグインの「Common Tasks」ページで、「Enterprise Application (EAR)」セクションの「Create」をクリックします。
2. medrecEar.ear コンポーネントをインストールしたフォルダに移動します。
3. コンポーネントの「Default:Install」コンポーネントプロシージャーを実行します。
4. physicianEar.ear および startupEar.ear コンポーネントに対して、手順 b から手順 c を繰り返します。

Avitek Medical Records デモアプリケーションを表示します。

次の URL で、3 つのデモアプリケーションが表示されます。
- http://RA-hostname:7010/patient
- http://RA-hostname:7010/admin
- http://RA-hostname:7010/physician

CLI を使用した WebLogic の作業

プロビジョニングシステムを介して WebLogic で作業を行う場合、Sun N1 Service Provisioning System コマンド行と WebLogic コマンド行の 2 つのコマンド行を使用できます。

Sun N1 Service Provisioning System コマンド行インタフェースの使用法

デフォルトでは、プロビジョニングシステムのコマンド行インタフェースは次のディレクトリにあります。/opt/SUNWn1sps/N1_Service_Provisioning_system_5.1/cli/bin/cr_cli

BEA WebLogic 8 プラグインオブジェクトは、/com/sun/weblogic8 フォルダにあります。

ほかのカスタムコンポーネントやプランとほぼ同じように、プラグインコンポーネントやプランを操作できます。ただし、コンポーネントまたはプランに変更を加える場合、コンポーネントまたはプランを新しいフォルダに保存し、そのフォルダで変更を行う必要があります。プロビジョニングシステムのコマンド行インタフェースの使用方法についての詳細は、『Sun N1 Service Provisioning System 5.2 コマンド行インタフェース (CLI) リファレンスマニュアル』の第 1 章「コマンド行インタフェースの使用」を参照してください。

WebLogic コマンド行インタフェースの使用法

WebLogic コマンド行は、「WebLogic 8 Common Task」ページからアクセスできます。WebLogic 8 コマンド行インタフェースの詳細は、BEA の Web サイトにある WebLogic Server Command Referenceを参照してください。

Sun N1 Service Provisioning System を介して WebLogic コマンド行インタフェースを使用する

任意の管理サーバーまたは管理対象サーバーで WebLogic コマンドを実行できます。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

管理サーバーと管理対象サーバーのどちらでコマンドを実行するかを選択します。
- 管理サーバーでコマンドを実行する場合は、「Domain Management: Start」をクリックします。
- 管理対象サーバーでコマンドを実行する場合は、「Application Server Management: Start」をクリックします。
「component Details」ページが表示されます。

「Run-cli」コンポーネントプロシージャーを選択し、「Run」をクリックします。

プランの「Run」ページが表示されます。

CLI を実行する AdminServer 仮想ホストまたは管理対象サーバー仮想ホストを選択し、「Run Selected Installations」をクリックします。

プラン変数のフィールドに必要な情報を入力します。

多くのプラン変数には情報が必要ないため、空白のままにしておくことができます。次の表で、オプション変数を説明します。

コマンドの SSL 引数

サーバーへの接続に SSL を使用しない場合、この変数は無視しても構いません。

コマンドのターゲットを表示または修正する適切なアクセス権が必要なユーザーの名前

これはユーザー名の変数です。ユーザー名とパスワードの変数は、ユーザー構成ファイルおよびキーファイル変数と相互に排他的です。ユーザー名およびパスワードと、ユーザー構成ファイルおよびキーファイル位置のどちらかを指定します。

ユーザー名と関連付けられたパスワード

これらはパスワード変数です。ユーザー名とパスワードの変数は、ユーザー構成ファイルおよびキーファイル変数と相互に排他的です。ユーザー名およびパスワードと、ユーザー構成ファイルおよびキーファイル位置のどちらかを指定します。

暗号化されたユーザー名とパスワードが含まれる、ユーザー構成ファイルの名前と位置

これはユーザー構成ファイル変数です。ユーザー名とパスワードの変数は、ユーザー構成ファイルおよびキーファイル変数と相互に排他的です。ユーザー名およびパスワードと、ユーザー構成ファイルおよびキーファイル位置のどちらかを指定します。

キーファイルの名前と位置

これはキーファイル変数です。ユーザー名とパスワードの変数は、ユーザー構成ファイルおよびキーファイル変数と相互に排他的です。ユーザー名およびパスワードと、ユーザー構成ファイルおよびキーファイル位置のどちらかを指定します。

「Run Plan (includes preflight)」をクリックします。

例 4–1 コマンド行インタフェースの使用法

次の例では WebLogic FORCESHUTDOWN コマンドを使用して、各 Run-cli プラン変数の入力を説明します。

実行する Weblogic CLI (weblogic.Admin または weblogic.Deployer):	weblogic.Admin
コマンドの SSL 引数:
コマンドを実行するサーバーインスタンスの待機アドレス:	sun03 「これは AdminServer の名前です。」
コマンドを実行するサーバーインスタンスの待機ポート:	7001
コマンドのターゲットを表示または修正する適切なアクセス権が必要なユーザーの名前:	admin
ユーザー名と関連付けられたパスワード:	xxxxx
暗号化されたユーザー名とパスワードが含まれる、ユーザー構成ファイルの名前と位置:
キーファイルの名前と位置:
実行するコマンドの名前:	FORCESHUTDOWN
コマンドの引数:	Server-one

Sun N1 Service Provisioning System 内での WebLogic Server Scripting Tool の使用法

プロビジョニングシステムのブラウザインタフェースからは WebLogic Server Scripting Tool (WLST) を使用できます。WLST を使用して管理タスクと構成変更を行う方法の詳細は、BEA の WebLogic Server の Using the WebLogic Server Scripting Tool を参照してください。

WebLogic スクリプトコンポーネントを作成する

まず WebLogic スクリプトコンポーネントを作成してから、それをインストールする必要があります。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Command Line Interface: Create」リンクをクリックします。

コンポーネントの「Edit」ページが表示されます。

新しい WebLogic スクリプトコンポーネントの名前を入力します。

(省略可能) コンポーネントのラベルと説明を入力します。

ファイルシステム上の WebLogic スクリプトファイルのコピーがあるホストを選択します。

ホストのファイルシステムをナビゲートし、ファイルを選択します。

「Check In Selected Item」をクリックします。

コンポーネントの「Check In」ページが表示されます。

編集アクセス権を持っているフォルダを選択します。

「Continue to Check In」をクリックします。

WebLogic スクリプトコンポーネントをインストールする

始める前に

WebLogic スクリプトコンポーネントをインストールするには、プロビジョニングシステム内にスクリプトコンポーネントが存在する必要があります。「WebLogic スクリプトコンポーネントを作成する」を参照してください。

ブラウザインタフェースの「Common Tasks」セクションで「WebLogic 8」をクリックします。

「Command Line Interface: View All」リンクをクリックします。

「Components」ページが表示されます。

インストールする WLScript コンポーネントの行で「Details」をクリックします。

コンポーネントの「Details」ページが表示されます。

「Component Procedures」テーブルで「Default: Install」プロシージャーを選択し、「Run」をクリックします。

プランの「Run」ページが表示されます。

ターゲットホストを選択します。

AdminServer の仮想ホストをターゲットにします。

注 –
ライセンスのインストール用にコンポーネント変数を変更する必要はありません。

(省略可能) ソフトウェアをインストールした WebLogic ユーザーの名前をを「RunAs」フィールドに入力します。

このユーザーは、ソフトウェアインストールプランで使用される webLogicUser 変数によって表されます。

「Run Plan (includes preflight)」をクリックします。

プランの使用法

WebLogic 8 プラグインは、管理サーバー、管理対象サーバー、およびクラスタのインストールと削除に関連する数多くのタスクの実行を、プランに依存しています。

BEA WebLogic 8 プラグインのプランは /com/sun/weblogic8 フォルダにあり、「Common Tasks」ページからリンクされています。

障害追跡

プロビジョニングソフトウェアを介して WebLogic を管理する際に問題が発生した場合、通常は画面にメッセージが表示され、問題が存在することが通知されます。

Problems encountered during plan run or preflight
The plan (or preflight) "/com/sun/weblogic8/InstallAdminServerPlan" 
finished with 1 failed host(s). (017034)
Unable to find session variable "WL_DEFAULT_PASSWORD" (Unresolved 
session variable WL_DEFAULT_PASSWORD. This session variable was 
automatically created when the system was unable to find it.). 
Add this session variable and try the operation again. (040111)

この例のメッセージは理解しやすいものですが、すべてのメッセージがこのように分かりやすいものとは限りません。

次のメッセージは、管理サーバー上の JMX インタフェースが使用不可能であったか、ログイン情報が正しくないことを意味しています。

Admin Server adminHost JMX interface
 running on port portNumber is not available;
Admin Server must be running for this operation.

特定の問題に関する詳細な情報を調べるには、最終的なエラーブロックに到達するまで「Run History Details」リンクをたどります。エラー状態の詳細については、stderr および stdout の出力を表示します。

WebLogic のインストールのエラーメッセージの例

この節では、WebLogic のインストール時に表示される可能性があるエラーメッセージの例を示します。

例 4–2 不正なユーザーのメッセージ

The user specified is not a valid system users: weblogic (017056)

システムユーザー「weblogic」を作成するか、Install 変数 weblogicUser を既存のユーザーに変更する必要があります。

例 4–3 ターゲットホストのエラーメッセージ

Specified target(s) "sol01" were not in the required host set
 "com.sun.weblogic8#SupportedHS". (017087)

このエラーメッセージには 2 つの原因が考えられます。

ホストは、プラグインと互換性があるオペレーティングシステムをサポートしていない。

この場合は、プラグインによりサポートされているオペレーティングシステムを使用するホストを選択します。
ホストの準備ができていない。

この場合は、「Hosts」ページにアクセスし、ホストの準備を行います。

例 4–4 起動ステップでのエラーメッセージ

Error: Installation could not be preformed check the deployment details
 for more information.

最終的な execNative コントロールの配備の詳細をチェックし、WebLogic インストーラからの情報を調べる必要があります。

次のメッセージは、stdout の出力に含まれている可能性があるメッセージの例です。

SilentBEAHomeTask – Access to the directory is denied: [/usr/local/bea]

このメッセージが表示された場合、インストールプランで指定されている WebLogic ユーザーは、beaHome ディレクトリの作成アクセス権または書き込みアクセス権を持っていません。ディレクトリのアクセス権を変更するか、プロビジョニングシステムのディレクトリコンポーネントを使用して beaHome ディレクトリを作成できます。
SilentBEAHomeTask – At least one item must be selected.

このメッセージが表示された場合、WebLogic のインストールがすでにこのパスに存在しています。パスを変更するか、既存の WebLogic インストールをアンインストールする必要があります。

Previous: 第 3 章 WebLogic 8 プラグインのインストールと構成

第 4 章 WebLogic 8 プラグインの使用法

Sun N1 Service Provisioning System を使用した WebLogic 8 環境のインストール法および使用法

プラグインの規定

プランとコンポーネントプロシージャー

タスク名

グローバルな必要条件

処理の概要

WebLogic インフラストラクチャーの作成

WebLogic 8 ドメインと管理サーバーを作成する

始める前に

異なるパスワードを使用して複数のドメインを作成する

WebLogic 管理対象サーバーを作成する

始める前に

ライセンスコンポーネントを作成する

ライセンスコンポーネントをインストールする

始める前に

WebLogic クラスタを作成する

始める前に

クラスタメンバーを作成する

始める前に

WebLogic ドメイン、サーバー、およびクラスタの管理

WebLogic ドメインと管理サーバーの管理

WebLogic ドメインと管理サーバーを削除する

始める前に

WebLogic ドメインまたは管理サーバーを起動する

WebLogic クラスタの管理

クラスタを起動または停止する

WebLogic クラスタを削除する

始める前に

WebLogic クラスタメンバーを削除する

始める前に

WebLogic 管理対象サーバーの管理

管理対象サーバーを起動する

始める前に

管理対象サーバーを停止する

始める前に

管理対象サーバーを削除する

管理対象サーバーに追加 CLASSPATH 要素を追加する

WebLogic アプリケーションの取得と編集

WebLogic エンタープライズアプリケーションまたは EAR ファイルを取得する

WebLogic Web アプリケーションまたは WAR ファイルを取得する

WebLogic JAR ファイルを取得する

コンポーネントタイプを使用した WebLogic アプリケーションの配備

エンタープライズアプリケーション (EAR) コンポーネントタイプ

エンタープライズアプリケーションのブラウズ

エンタープライズアプリケーションのインストール

エンタープライズアプリケーションのアンインストール

エラー状態

Web アプリケーション (WAR) コンポーネントタイプ

Web アプリケーションのブラウズ

Web アプリケーションのインストール

Web アプリケーションのアンインストール

エラー状態

EJB コンポーネントタイプを含む Java アーカイブファイル

JAR または EJB ファイルのブラウズ

JAR または EJB ファイルのインストール

JAR または EJB ファイルのアンインストール

エラー状態

接続プールのコンポーネントタイプ

接続プールのブラウズ

接続プールのインストール

接続プールのアンインストール

データソースおよびトランザクションデータソースのコンポーネントタイプ

データソースまたはトランザクションデータソースのブラウズ

データソースまたはトランザクションデータソースのインストール

データソースまたはトランザクションデータソースのアンインストール

マルチプールコンポーネントタイプ

マルチプールのブラウズ

マルチプールのインストール

マルチプールのアンインストール

スレッドプールコンポーネントタイプ

スレッドプールの構成

スレッドプールのアンインストール

トランザクションサービスコンポーネントタイプ

トランザクションサービスの構成

トランザクションサービスのアンインストール

JMS Server コンポーネントタイプ

JMS Server のブラウズ

JMS Server のインストール

JMS Server のアンインストール

管理対象サーバーに追加 `CLASSPATH` 要素を追加する