Sun N1 Service Provisioning System ユーザーズガイドおよびリリースノート(WebLogic 8 Plug-In 2.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.1 システム管理者ガイド』の第 3 章「アクセス許可を使用したアクセスの制御」を参照してください。

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

処理の概要

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

WebLogic 8 プラグインをインポートします。

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

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

WebLogic 8 プラグインには、プロビジョニングシステム内のすべてのホストに配布する必要がある新しいシステムサービスが含まれています。『Sun N1 Service Provisioning System 5.1 システム管理者ガイド』の「物理ホストの準備」を参照してください。
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.1 プランとコンポーネントの開発者ガイド』の第 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 ポートです。
    
    ドメインが作成される前には、このポートが使用可能であるかチェックされます。
    
    secureConnect
    
    任意。True 管理サーバーの接続に SSL ポートが使用可能であることを指定します。
    
    production
    
    必須。この変数は、管理対象サーバーを稼働モードで実行するかどうかを決定します。稼働モードのデフォルト値は false です。この変数は、true または false に設定できます。
    
    更新される頻度が少ない変数には、次のような構成変数が含まれます。
    
    adminManagedServer
    
    必須。ドメイン管理コンソールをホストする管理対象サーバーの名前。デフォルト値は myserver です。markOnly インストールを実行している場合は、この変数を、WebLogic インストール中に使用されるサーバー名に設定します。
    
    adminHost
    
    必須。管理対象サーバーが管理サーバーに接続するために使用するホスト名または IP アドレス。デフォルト値は、管理サーバーが常駐しているリモートエージェントのホスト名です。
    
    targetRefName
    
    必須。この変数は、ドメインの仮想ホストの名前になります。代入変数は、ホスト名とドメイン名の値に基づきます。この変数は、:[target:sys.hostName]_weblogic_admin_ :[domainName] という書式になります (例: sqa-420_weblogic_admin_wls)。
  - 別のコンポーネントから変数コンポーネントを使用するには、「Import Set」をクリックします。
    
    変数セットのインポートについての詳細は、『Sun N1 Service Provisioning System 5.1 オペレーションとプロビジョニングガイド』の「プランを実行する」を参照してください。

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

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

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

「Target Host Set 」チェックボックスをオフにします。

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

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

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

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

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

手順

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

「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 コンポーネント変数を設定することにより変更できます。
    
    serverPort
    
    SSL を使用しない場合は必須。この変数のデフォルト値は 7010 です。このポートが使用できない場合、管理対象サーバーは起動せず、エラーメッセージが表示されます。ポートを解放したあと、管理対象サーバーの「component Details」ページで Start コンポーネントプロシージャーを実行することで管理対象サーバーを起動できます。
    
    serverSslPort
    
    SSL を使用する場合は必須。この変数のデフォルト値は 7020 です。このポートは使用可能である必要があります。使用できない場合、管理対象サーバーは起動せず、エラーメッセージが表示されます。ポートを解放したあと、管理対象サーバーの「component Details」ページで Start コンポーネントプロシージャーを実行することで管理対象サーバーを起動できます。
    
    production
    
    必須。この変数は、管理対象サーバーを稼働モードで実行するかどうかを決定します。稼働モードのデフォルト値は false です。この変数は、true または false に設定できます。
  - 別のコンポーネントから変数コンポーネントを使用するには、「Import Set」をクリックします。
    
    変数セットのインポートについての詳細は、『Sun N1 Service Provisioning System 5.1 オペレーションとプロビジョニングガイド』の「プランを実行する」を参照してください。

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

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

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

「Target Host Set 」チェックボックスをオフにします。

プロビジョニングシステム内で既存の 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
    
    この変数は、クラスタメンバーが相互通信に使用できるアドレスを提供します。
  - 別のコンポーネントから変数コンポーネントを使用するには、「Import Set」をクリックします。
    
    変数セットのインポートについての詳細は、『Sun N1 Service Provisioning System 5.1 オペレーションとプロビジョニングガイド』の「プランを実行する」を参照してください。

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

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

「Target Host Set 」チェックボックスをオフにします。

プロビジョニングシステム内で既存の 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」ページが表示されます。

クラスタに追加する管理対象サーバーを選択します。
- 管理対象サーバーの名前を入力するか、リストから選択して、ターゲットホストを選択します。
  
  注 –
  「Target Host Set」オプションは自動的に選択されます。1 つの管理対象サーバーを選択する場合は、「Target Host Set」チェックボックスをオフにします。
- メニューからターゲットホストセットを選択します。

プラン変数 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」をクリックします。

「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」フィールドで、クラスタをホストするドメインを選択します。

「Target Host Set 」チェックボックスをオフにします。

「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」ページが表示されます。

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

「Target Host Set 」チェックボックスをオフにします。

プロビジョニングシステムから 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 管理対象サーバーを作成する」を参照してください。

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

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

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

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

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

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

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

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

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

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

接続プールのブラウズ

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

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

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

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

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

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

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

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

「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 と呼ばれるデフォルトの接続プールコンポーネントも含まれています。このデフォルトコンポーネントにより、ブラウズの必要がなくなります。「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 をアンインストールできます。

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

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

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

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

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

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

メールセッション名
JNDI 名

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

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

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

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.1 コマンド行インタフェース(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 管理対象サーバーの管理

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

始める前に

手順

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

始める前に

手順

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

手順

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

手順

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

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

手順

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

手順

WebLogic JAR ファイルを取得する

手順

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

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

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

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

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

エラー状態

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

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

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

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

エラー状態

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

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

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

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

エラー状態

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

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

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

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

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

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