この資料中では、直近でリリース予定の GlassFish v2.1.1, v3.0.1の他、GlassFish v3.1 、v3.2 、v4 についても触れらてています。

この資料の中で特に興味深いのは、GlassFish v4 という名前が初登場した事で、次期 Java EE である Java EE 7 に対応する製品になるようです。資料中に記載されているスケジュールはあくまでも予定ですので（今までの経験から）今後変更される事が予想できますが、今後も GlassFish が継続してオープンソースのアプリケーションサーバとして提供されていく事をご確認いただけるかと思います。
ぜひ、この資料をご確認ください。

Java EE 6 には非常にたくさんの技術が含まれているので一度に全てを理解することは大変だと思いますが、まずはこのサンプルを通じて、JSF,JPA,EJB にどのような変更が加わったのか、またどのような点が楽になったのか等を理解して頂ければと思います。

（上記は別途インストールしておいてください。）

サンプルアプリケーションの概要：

コードを書く前にこれから作成するサンプルアプリケーションの概要について説明します。このアプリケーションはとても簡単なアプリケーションでユーザ（データ）を登録して参照するだけという、いたってかんたんなアプリケーションです。また処理フローもとてもシンプルです。

アプリケーションの完成予想イメージは下記です。ユーザ登録画面で「作成」ボタンを押下しデータを登録した後、一覧表示画面が表示されます。また一覧表示画面中の「新規作成」のリンクを押下すると登録画面に遷移します。

１．新規プロジェクトの作成

それでは早速プロジェクトを作成していきます。今回作成するアプリケーションは、EJBを含んでいますが新規プロジェクトの作成時「Web アプリケーション」を選択して作成することにします。

それでは、メニューから「ファイル」→「新規プロジェクト(W)…」→「Java Web」→「Web アプリケーション」を選択し、「次へ＞」ボタンを押下してください。

プロジェクト名に「PersonManagement」を入力し「次へ＞」ボタンを押下します。

次に、「サーバと設定」で配備するアプリケーションサーバとJava EE のバージョンを選択します。ここでは、「GlassFish v3 ドメイン」と「Java EE 6 Web」を選択し「次へ＞」ボタンを押下します。

次に、使用するフレームワークを選択します。今回は、「JavaServer Fcaces」を使用しますのでこれにチェックを付け「完了(F)」ボタンを押下します。

プロジェクトを作成すると下記のような画面が表示されます。

２． JPA 2.0：Entity Bean の作成

新規プロジェクトを作成後、Entity Bean を作成します。Java EE 5 から Entity CMP 2.x に代わり JPA 1.0 が登場し、DBに対する持続性のコード記述がかなり楽になりました。JPA 2.0 ではさらに扱いやすくなり、機能面でも改善が施されています。（JPA 2.0 の新機能の詳細は別途記載する予定です。また今回はとても簡単なサンプルのためJAP 2.0の新機能はあまり使用していません。JPA 1.0と同等レベルの記述内容）

それでは、実際に Entity Bean を作成してみましょう。メニューから「ファイル」→「新規ファイル(N)…」→「持続性」を選択してください。

NetBeans を利用すると既存のデータベースのテーブルから Entity クラスを自動的に生成する事ができます。既に DB テーブルを作成している場合は「データベースからのエンティティークラス」を選択して作成してください。NetBeans を使う上で、この機能は大変便利です。私も普段は先に DB のテーブルを作成して、Entity クラスは NetBeans で自動生成しますので一から Entity クラスを作成する事はあまりしません。是非お試しください。

今回、私は DB のテーブルが作成されていない状態で新規にエンティティークラスを生成しますので「エンティティークラス」を選択し「次へ＞」ボタンを押下します。この方法では、エンティティークラスを先に作成した後、エンティティクラスに該当するテーブルを DB 上に後から構築します（Entity クラスを元にテーブルを自動生成することもできます）。

ここで新しいエンティティークラス名「Person」、パッケージ名「ent」を入力します。「主キー型」はこのテーブルの主キーの型を選択します。Person を ID で管理しますので、そのまま、「Long」型を設定します。

「完了(F)」ボタンを押下する前に１点注意してください。ワーニングで「プロジェクトに持続性ユニットがありません。エンティティークラスを持続さ…」というメッセージが表示されています。これはこのエンティティクラスに対する持続性ユニットが存在していない事を意味しています。そこで「持続性ユニットを作成…」ボタンを押下し、このエンティティクラスに紐づく持続性ユニットを作成します。ボタンを押下すると下記の画面が表示されます。

持続性プロバイダとして JPA 2.0 の参照実装である「EclipseLink(JPA 2.0)(デフォルト)」と、データソースを選択します。また表生成の方針ですが、「作成」を選択すると自動的に DB にテーブルを作成します。全ての入力が完了した後、最後に「作成」ボタンを押下します。
この時、後のプログラミング時に使用しますので、入力した持続性ユニット名（PersonManagementPU）を覚えておいてください。

「作成」ボタンを押下すると、「新規エンティティ作成画面」に戻ってきますが、持続性ユニットに関するワーニングが消えたことを確認した後、最後に「完了(F)」ボタンを押下してください。ボタンを押下すると入力された情報を元に ID のみを持つ Person エンティティのひな形が自動生成されます。また同時に、構成ファイル配下に、持続性ユニットの設定ファイル persistence.xmlが自動生成されます。

作成された Entity クラス(Person)のひな形を編集していきます。

ソースコードを確認すると @Entity のアノテーションが自動的に付加されている事に気づきます。このアノテーションを付加することによりコンパイラや、EJB コンテナが本クラスをエンティティクラスと解釈してくれるようになります。

名前、住所、電話番号、年齢をあつかえるようにフィールドを追加し、それぞれに対するセッタ、ゲッタメソッドを記載してください。また、@NamedQuery で JPQL を記載し、DBに登録されている全ての Person を取得できるようにします。

package ent;
import java.io.Serializable;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.NamedQuery; 

@Entity
@NamedQuery(name="findAllPerson", query="SELECT p FROM Person p")
public class Person implements Serializable {
    private static final long serialVersionUID = 1L;
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    @Column(nullable=false,length=256)
    private String name;

    @Column(nullable=false,length=256)
    private String address1;

    @Column(nullable=false,length=12)
    private String telephone;

    @Column(nullable=false)
    private Long age;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    @Override
    public int hashCode() {
        int hash = 0;
        hash += (id != null ? id.hashCode() : 0);
        return hash;
    }

    @Override
    public boolean equals(Object object) {
        if (!(object instanceof Person)) {
            return false;
        }
        Person other = (Person) object;
        if ((this.id == null && other.id != null) || (this.id != null && !this.id.equals(other.id))) {
            return false;
        }
        return true;
    }

    @Override
    public String toString() {
        return "entity.Person[id=" + id + "]";
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getAddress1() {
        return address1;
    }

    public void setAddress1(String address1) {
        this.address1 = address1;
    }

    public String getTelephone() {
        return telephone;
    }

    public void setTelephone(String telephone) {
        this.telephone = telephone;
    }

    public Long getAge() {
        return age;
    }

    public void setAge(Long age) {
        this.age = age;
    }
}

以上で、このサンプルアプリケーションに必要なエンティティクラスはできました。

３．EJB 3.1：ステートレスセッション Bean の作成

エンティティクラスを生成したので、次に EJB (ステートレス・セッション Bean) を作成します。「ファイル」→「新規ファイル(N)…」→「Java EE」→「セッション Bean」を選択し、「次へ＞」ボタンを押下してください。

ボタンを押下すると下記の画面が表示されます。ここで「EJB 名(N)」、「パッケージ(K)」を入力し「完了(F)」ボタンを押下します。

public interface Hello {
    public String sayHello();
}

@Stateless
public class HelloBean implements Hello {
    public String sayHello() { return "hello"; }
}

EJB の利用時

@EJB Hello helloRef;
    ...
    helloRef.sayHello();

それではコードを編集していきましょう。今回は、データの検索と追加を行いますので、それぞれの処理を行う２つのメソッドを実装しています。まず、@PersistenceContextのアノテーションで、（JPA Entity クラスを作成した時に作成した持続性ユニット名。persistence.xml に記載されている。）持続性ユニット名(“PersonManagementPU”)を記載します。これにより持続機能を持った EntityManager のオブジェクト(em)がセットされます。

package pejb;

import ent.Person;
import java.util.List;
import javax.ejb.Stateless;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import javax.persistence.Query;

@Stateless
public class PersonEJB {

    @PersistenceContext(unitName="PersonManagementPU")
    private EntityManager em;

    public List<Person> findAllPersons(){
    //Entity(Person)クラスの @NamedQuery の記載に基づき検索
        Query query = em.createNamedQuery("findAllPerson");
        return (List<Person>) query.getResultList();
    }

    public Person createPerson(Person person){
        em.persist(person);
        return person;
    }
}

４．JSF：Managed Bean の作成

EJBと、Entity を作成したので、JSF から利用する Managed Bean を作成しましょう。「ファイル」→「新規ファイル(N)…」→「JavaServer Faces」→「JSF 管理対象 Bean」を選択し「次へ＞」ボタンを押下してください。

「クラス名(N)」、「パッケージ(K)」を入力し「完了(F)」ボタンを押下します。

コードを編集していきましょう。作成するクラスが Managed Bean であることをコンテナに理解させるため、@ManagedBean のアノテーションを利用します。アノテーションを指定する際、”name” 属性は必須で Managed Bean を識別する名前を入力します。

package mbean;

import ent.Person;
import pejb.PersonEJB;
import java.util.ArrayList;
import java.util.List;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.RequestScoped;
import javax.ejb.EJB;

@ManagedBean(name="PersonController")
@RequestScoped
public class PersonController {

    public PersonController() {
    }

    @EJB
    private PersonEJB personEJB;

    private Person person = new Person();
    private List<Person> personList = new ArrayList<Person>();

    //Facelets の action="#{PersonController.doNew} により画面遷移
    public String doNew(){
        return "createPerson.xhtml";
    }

    //Facelets の action="#{PersonController.doCreatePerson} により画面遷移
    public String doCreatePerson(){
        //画面から入力された Person を DB に登録
        setPerson(personEJB.createPerson(getPerson()));
        //DB に登録されている全 Person を personList に設定
        setPersonList(personEJB.findAllPersons());
        return "listPersons.xhtml";
    }

    public Person getPerson() {
        return person;
    }

    public void setPerson(Person person) {
        this.person = person;
    }

    public List<Person> getPersonList() {
        return personList;
    }

    public void setPersonList(List<Person> personList) {
        this.personList = personList;
    }
}

５．JSF 2.0: ベージの作成

最後に、表示画面を作成します。JSF 2.0 から facelet を xhtml で記載できるようになりました。

「ファイル」→「新規ファイル(N)…」→「JavaServer Faces」を選択し「次へ＞」ボタンを
押下してください。

ファイル名 (createPerson.xhtml) を入力すると自動的に .xhtml の拡張子が付加されます、最後に「完了(F)」ボタンを押下します。

自動生成されたひな形を編集して下記のコードを記載してください。Facelets で扱えるタグ等は別途紹介する予定ですが、みていただければわかるとおり、HTML も記載する事ができますし、スタイルシート等を記載することも可能です。また、JSF 2.0 から Ajax をサポートしていますので、Ajax のコードを利用してサーバと通信する事もできるようになります。

<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://java.sun.com/jsf/html">
      <h:head>
        <title>Facelet Title</title>
    </h:head>
    <h:body>
        <h:form>
            <table>
                <tr>
                    <td>
                <h:outputLabel value="名前："/>
                </td>
                <td>
                <h:inputText value="#{PersonController.person.name}"/>
                </td>
                </tr>
                <tr>
                    <td>
                <h:outputLabel value="住所"/>
                </td>
                <td>
                <h:inputText value="#{PersonController.person.address1}"/>
                </td>
                </tr>
                <tr>
                    <td>
                <h:outputLabel value="電話番号"/>
                </td>
                <td>
                <h:inputText value="#{PersonController.person.telephone}"/>
                </td>
                </tr>
                <tr>
                    <td>
                <h:outputLabel value="年齢"/>
                </td>
                <td>
                <h:inputText value="#{PersonController.person.age}"/>
                </td>
                </tr>
            </table>
            <h:commandButton value="作成" action="#{PersonController.doCreatePerson}"/>
        </h:form>
    </h:body>
</html>

最後に、登録された一覧を表示する画面を作成します。
「ファイル」→「新規ファイル(N)…」→「JavaServer Faces」を選択し「次へ＞」ボタンを
押下してください。

ファイル名(listPersons)を入力し「完了(F)」ボタンを押下します。

<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:f="http://java.sun.com/jsf/core">
      <h:head>
        <title>Facelet Title</title>
    </h:head>
    <h:body> 

        <h:dataTable value="#{PersonController.personList}" var="psn" border="1">
            <h:column>
                <f:facet name="header">
                    <h:outputText value="名前"/>
                </f:facet>
                <h:outputText value="#{psn.name}"/>
            </h:column>

            <h:column>
                <f:facet name="header">
                    <h:outputText value="住所"/>
                </f:facet>
                <h:outputText value="#{psn.address1}"/>
            </h:column>

            <h:column>
                <f:facet name="header">
                    <h:outputText value="電話番号"/>
                </f:facet>
                <h:outputText value="#{psn.telephone}"/>
            </h:column>

            <h:column>
                <f:facet name="header">
                    <h:outputText value="年齢"/>
                </f:facet>
                <h:outputText value="#{psn.age}"/>
            </h:column>
        </h:dataTable>
        <h:form>
            <h:commandLink action="#{PersonController.doNew}">
                新規作成</h:commandLink>
        </h:form>
    </h:body>
</html>

以上で、このアプリケーションの実装は完了です。

NetBeans のメニューより「実行(R)」→「主プロジェクトを実行(R)」を選択してください。実行すると自動的にブラウザがオープンしアプリケーションのデフォルトのコンテンツが表示されます。

コンテキストルートでアクセスされた時のデフォルトページを変更したい場合は、web.xml ファイルを編集する必要があります。下記のように welcome-file-list を編集してください。

web.xml の編集

設定を変更した後、もう一度プロジェクトを実行してください。すると下記のように自動的に登録画面が表示されるようになります。

データを入力して「作成」ボタンを押下してみましょう。下記のように一覧表示画面が表示されれば問題はありません。

最後に、エラーハンドリングについて紹介します。例外が発生した際に特定のエラーページにリダイレクトさせるようにweb.xml の<error-page> タグを記載する必要があります。<exception-type>で、ハンドリングした例外毎にエラーページを表示させる事が可能です。本番環境においては、少なくとも JSF で発生する例外の親である javax.servlet.ServletException を記載してください。

web.xml の編集

以上で、今回の Java EE 6 のアプリケーション作成は終了です。NetBeans を利用するとウィザードを使って、コードのひな形を作成してくれたり、また設定も極力 XML ファイルを手動で編集しなくても済むようになります。是非お試しください。今回紹介したサンプルは Java EE 6 を利用する上で最も基本的な構成と思います、上記の例を元に色々と修正を加え、DI/CDI や Bean Validation 等を加えて Java EE 6 の機能を是非色々と試してみてください。

最後に、私の環境で作成したNetBeans 6.8 のプロジェクトを下記から入手できるようにしました。
(※ Sun の mediacast.sun.com サイトにファイルをアップロードしていますので、
仮にこのサイトが閉鎖してしまった場合は申し訳ありませんがご了承ください。)

●　NetBeans 6.8 のプロジェクト(ソース、設定ファイル等を含む)
●　GlassFish v3 配備用 WARファイル

GlassFishにはインストール時デフォルトで Java DBが付属しており，あらかじめJava DBに対するJDBCリソースと接続プールの設定がされています．そして GlassFish の監視系の機能の一つである，「呼び出しフロー」のデータ保存先として使用されています．
ここでは，新たにMySQL 5.1との接続設定方法について紹介します．MySQLと接続するためには，MySQLのJDBCドライバを事前に入手しておいてください．
また以降の手順ではMySQLが既にインストールされていることを前提に説明します．

JDBCドライバに対するクラスパスを設定

クラスパスの設定は，管理コンソールから左ペインの「設定」→「対象のコンフィグ(cluster1-config)」→「JVM 設定」を選択し右ペインの「サーバクラスパス」内に記載し設定できます．

次に JDBC の接続プールを作成します．

分散トランザクションが必要な場合，リソースタイプ，データソースにそれぞれ下記を使用してください．
javax.sql.XADataSource
com.mysql.jdbc.jdbc2.optional.MysqlXADataSource

管理コンソールからは下記の手順に従い設定してください．
まず、左ペインの「リソース」→「JDBC」→ 「接続プール」を選択し右ペインの「新規 …」ボタンを押下します．

次に，「接続プール名」，「リソースタイプ」，「データベースベンダー」を選択し「次へ」ボタンを押下します．

最後に，JDBC の各種詳細な設定項目を選択/入力し「完了」ボタンを押下します．

JDBCドライバ等の設定項目一覧が数多くリストされますが，ここでは最低限下記の項目のみ編集して設定を完了します．

「完了」ボタンを押下すると下記の画面が表示されます．

ここで、作成した JDBC 接続プールが有効か否か疎通確認を行います．

成功時：

失敗時：

また，管理コンソールから左ペインの「リソース」→「 JDBC」→「 接続プール」より対象の接続プールを選択し「Ping」ボタンを押下し確認できます．
成功時：

失敗時：

次に、作成した JDBC 接続プールに対して，リソース設定を行います．
アプリケーションはここで設定する JNDI 名を利用して DB にアクセスできるようになります．

管理コンソールからは下記の手順に従い設定してください．
まず、左ペインの「リソース」→「JDBC」→ 「 JDBCリソース」を選択し右ペインより「新規 …」ボタンを押下します．


続いて，「JNDI 名」，「プール名」，有効状態のチェックをつけ「利用可能なターゲット」に対象のクラスタ(cluster1)を追加して「了解」ボタンを押下します．


「了解」ボタンを押下すると下記の画面が表示され JDBC リソースの設定は完了します．以降アプリケーションはここで設定した “jdbc/mysql” を利用して DB
に対して接続ができるようになります．

DBの設定情報の取得
ここで，DB の設定可能な項目の一覧をリストしてみます．asadmin の get コマンドを実行して確認ができます．各設定項目は asadmin set コマンドで設定変更を更新できますので必要に応じて設定変更を行ってください．

コネックションプールのモニタリング
最後に、JDBC の接続プールに対してモニタリングの設定を行う方法を紹介します．モニタリングを有効にするために下記の手順に従い設定を行い，確認してください．

クライアント証明書の秘密鍵を作成

クライアント証明書用のCSRを作成

下記の例では便宜上，認証局(CA)上で CSR を生成していますが，CSRの生成はどの環境で構築しても問題ありません．

認証局(CA)でクライアント証明書を署名

クライアント証明書のCSRを認証局(CA)で署名します。

署名されたクライアント証明書をGlassFishのキーストアにインポートするため，X.509形式に変更

GlassFishのキーストアに対してクライアント証明書をインポート

クライアント証明書をブラウザにインポートするためPKCS12形式に変換

最後にブラウザにPKCS12形式のクライアント証明書をインポートします．

上記で設定は完了です，ブラウザからアクセスしてみてください．

ドメイン管理サーバが稼働するサーバが何らかの障害により起動できなくなった場合，ドメインの管理ができなくなります．ドメイン管理サーバが稼働していない状態でもサーバインスタンスを稼働させることはできますが，ドメイン管理サーバが壊れている状態ではアプリケーションの更新やリソースの設定変更等ができなくなります．このような場合、ドメイン管理サーバの設定をバックアップしておくことで，他のサーバをドメイン管理サーバの代替えとして利用することができます．バックアップはドメイン管理サーバ上で何らかの設定変更を行った際，その都度取得しておくことを推奨します．

バックアップを取得する前に，ドメイン管理サーバを停止してください．ドメイン管理サーバを停止しても提供しているサービスに影響は及びませんのでこの作業は本番稼働中に行っても問題ありません．

次にドメイン管理サーバのバックアップを行います．–domaindirには対象のドメインが含まれるディレクトリを指定します．

バックアップコマンドを実行すると，sjsas_backup_vXXXXX.zipと名付けられたバックアップファイルが作成されます．このファイルをドメイン管理サーバのバックアップ用のサーバにFTP等を利用してコピーしておきます．ここではドメイン管理サーバのバックアップ用のサーバとしてnodeagent1を使用します．本番環境ではノードエージェントとは別のマシン上に構築することを推奨します．

展開したファイル中よりドメイン管理サーバ名が記載されている箇所を手動で編集します．domains/clusterDomain/config /domain.xml中より修正する必要のある該当箇所を表示し，dashostからnodeagent1に変更します．

新しい環境上で再度環境変数を設定した後，ドメインを起動します．

上記で，ドメインのリストアは完了です．仮にドメイン管理サーバにアクセスするためにSSLを有効にしている場合にドメイン管理サーバのホスト名が変わる場合，サーバ証明書の更新も必要です．デフォルトでインストールされている自己署名サーバ証明書は変更前のドメイン管理サーバ名が記載されていますので更新の必要があります．
最後に，念のためノードエージェントが保持するドメイン管理サーバへの参照情報が更新されているか確認してください．全てのノードエージェントはagentディレクトリ中にconfigディレクトリが存在しています．このディレクトリ配下にdas.propertiesファイルが存在しており，ドメイン管理サーバへ接続するための接続情報などが記載されています．そこでファイルの内容を確認しdashostからnodeagent1に変更されていることを確認してください．仮に変更されていない場合は手動で変更してください．

クラスタの作成

クラスタ構成を作成するためにはcreate-clusterコマンドを使用します．コマンド引数にクラスタ名を指定してクラスタを作成します．

また，管理コンソールから左ペインの「クラスタ」を選択し右ペインの「新規…」ボタンを押すことによって作成することができます．

クラスタの作成

クラスタサーバインスタンスの作成

クラスタに所属するサーバインスタンスを作成するためには，create-instanceコマンドを実行します．コマンド引数にインスタンスを配置するノードエージェント名とクラスタ名を指定してインスタンスを作成します．

また，クラスタに所属するサーバインスタンスは「クラスタ」作成のウィザードから「作成するサーバインスタンス(2)」のテーブルから，「新規…」ボタンを押すことによって作成することができます．この時ノードエージェントの選択コンボボックスからサーバインスタンスが稼働するノードエージェントを選択します．

クラスタインスタンスの作成

クラスタの一覧表示

ドメイン内に存在するクラスタの一覧を表示するためにはlist-clustersコマンドを使用します．またコマンドを実行すると一覧表示の他クラスタの稼働状態も表示します．

また，管理コンソールから左ペインの「クラスタ」を選択して確認できます．

クラスタの一覧表示

クラスタの起動

クラスタの起動はstart-clusterコマンドを使用します．コマンド引数にクラスタ名を指定して起動します．

また，管理コンソールから左ペインの「クラスタ」を選択し右ペイン中より対象のクラスタにチェックを付け「クラスタの起動」ボタンを押すことによって作成することができます．

クラスタの起動

クラスタの停止

クラスタの停止はstop-clusterコマンドを実行します．コマンド引数にクラスタ名を指定して停止します．

また，管理コンソールから左ペインの「クラスタ」を選択し右ペイン中より対象のクラスタにチェックを付け「クラスタの停止」ボタンを押すことによってクラスタを停止することができます．

クラスタの停止

クラスタの削除

クラスタを削除するためには，クラスタに所属している全てのインスタンスを停止/削除した後に削除を行います．
まず，クラスタの一覧とクラスタに所属するインスタンスを表示します．

次に，cluster1に属するinstance1,instance2を削除します．

最後にcluster1を削除します．

また，管理コンソールから左ペインの「クラスタ」を選択し右ペイン中より対象のクラスタにチェックを付け「削除」ボタンを押すことによってクラスタを削除することができます．管理コンソールから削除を実行すると，クラスタ内に属する全てのインスタンスも同時に削除する事ができます．

クラスタの削除

スタンドアローンサーバインスタンスを追加するためにはcreate-instanceコマンドを実行します．サーバインスタンスが稼働するノードエージェント名を指定して作成します．複数のインスタンスを作成する際は，必ずノードエージェントの指定が必要です．そこで，開発者プロファイルを利用している場合，もしくはノードエージェントを作成していない場合は，新たにサーバインスタンスを作成することができませんので，ご注意ください．

上記のようにサーバインスタンスで使用する各種ポート番号を明示的に指定せずにサーバインスタンスを作成する場合は，極力既存の全てのサーバインスタンスを起動している状態で作成作業を行ってください．ポート番号を指定せずに実行した場合，コマンド内部で自動的に未使用のポート番号を探し出して新規インスタンス用に割り当てます．他のサーバインスタンスが停止している状態でコマンドを実行した場合，他で使用しているポート番号と競合する可能性があり，正常にサーバインスタンスが起動できない場合があります．作成するインスタンスで使用する各種ポート番号を指定したい場合は，下記のように–systempropertiesを付加して各種ポート番号を指定する事もできます．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「新規…」ボタンを押すことによって新規インスタンスを追加することができます．

新規スタンドアローンインスタンスの追加

サーバインスタンスの一覧表示

サーバインスタンスの一覧を確認するためにはlist-instancesコマンドを使用します．コマンドを実行すると一覧表示の他インスタンスの稼働状態も表示します．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択して確認できます．

インスタンスの一覧表示

サーバインスタンスの起動

サーバインスタンスの起動はstart-instanceコマンドを使用します．実行時にインスタンス名を指定して起動します．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「起動」ボタンを押すことによってインスタンスを起動することができます．

サーバインスタンスの起動

もしくは，管理コンソールから左ペインから対象の「スタンドアロンインスタンス」を選択し右ペインの「インスタンスの起動」ボタンを押すことによってインスタンスを起動することができます．

サーバインスタンスの起動

サーバインスタンスの停止

サーバインスタンスの停止はstop-instanceコマンドを実行します．コマンド引数にインスタンス名を指定して停止します．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「停止」ボタンを押すことによってインスタンスを停止することができます．

サーバインスタンスの停止

もしくは，直接左ペインから対象の「スタンドアロンインスタンス」を選択して右ペインの「インスタンスの停止」ボタンを押すことによってインスタンスを停止することができます．

サーバインスタンスの停止

サーバインスタンスの削除

インスタンスの削除はdelete-instanceコマンドを実行します．コマンド引数にインスタンス名を指定して削除します．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「削除」ボタンを押すことによってインスタンスを削除することができます．

サーバインスタンスの削除

ノードエージェントを作成するためには，ドメイン管理サーバ上で create-node-agent-config コマンドを実行しノードエージェント(参照情報のみ)を作成します．下記の例では2つのノードエージェントを作成しています．

次にノードエージェントを稼働させるマシン上でそれぞれ create-node-agent コマンドを実行します．この時ドメイン管理サーバ上で指定したノードエージェント名と同一のエージェント名を指定する必要があります．

便宜上ノードエージェントを稼働させるマシン上で create-node-agent コマンドを実行すると，「参照情報」と，「ノードエージェントの実体」の両方が同時に生成されます．しかし内部的には参照情報の設定とノードエージェントの実体は別々に作成されていることに注意してください．
このように，参照情報とノードエージェントの作成が別々に行われる理由は，ノードエージェントをオフラインで管理ができるようにするためです．例えば，実体であるノードエージェントが停止状態でも，ドメイン管理サーバ上で管理しているノードエージェントの参照情報に対してインスタンスを追加することができます．そしてノードエージェントの実体を起動した時にドメイン管理サーバで保持するノードエージェントの参照（設定）情報と同期をとりインスタンスの実体が生成されます．
管理コンソールからは，ドメイン管理サーバで管理する参照情報のみ作成することができます．参照情報を作成した後，別途ノードエージェントが稼働するマシン上でノードエージェントの実体を作成してください．
管理コンソールの左ペインから「ノードエージェント」を選択し、右ペインより「新規…」ボタンを押すことによってノードエージェントの参照情報を作成することができます．

ノードエージェントの参照情報の作成

ノードエージェントの一覧表示

ノードエージェントの一覧を確認するためにはlist-node-agentsコマンドを使用します．コマンドを実行すると一覧表示の他ノードエージェントの稼働状態も表示します．

また，管理コンソールからは，左ペインの「ノードエージェント」を選択して確認できます．

ノードエージェントの一覧表示

ノードエージェントの起動

ノードエージェントを起動するためには，ノードエージェントが稼働するマシン上で start-node-agent コマンドを実行します．

ノードエージェントの停止

ノードエージェントを停止するためには，ノードエージェントが稼働するマシン上で stop-node-agent コマンドを実行します．

ノードエージェントのログ設定

ノードエージェントのログに関する設定を行う前に，現在設定されているログの設定情報を get コマンドを実行して確認します．

ここで例えば、set コマンドを実行しログローテーションのファイルサイズを 500Kb から 1Mb に変更してみます。
下記を実行してください．

上記の設定内容を確認するため get コマンドを実行します．

また，ノードエージェントに関する各種設定は，管理コンソールからも行えます．

ノードエージェントの各種設定

ノードエージェントの削除

ノードエージェントを削除する前に，ノードエージェント上で稼働している全てのインスタンス，全てのアプリケーションを停止していることを確認してください．ノードエージェント上にリソースが残っている場合，ノードエージェントの削除に失敗します．
全てのリソースを削除した後に，ノードエージェントが稼働するマシン上で delete-node-agent コマンドを実行し実体を削除します．下記のコマンドを実行するとファイルやディレクトリを全て削除します．

次に、delete-node-agent-configコマンドを実行し，ドメイン管理サーバ上で保持するノードエージェントの参照情報を削除します．

ノードエージェントの参照情報は管理コンソールからも削除できます．管理コンソールの左ペインから「ノードエージェント」を選択し，右ペインより削除対象のノードエージェントにチェックを付け，削除ボタンを押す事により削除できます．

ノードエージェントの参照情報の削除

サーバインスタンスはエンドユーザ向けにサービスを提供するJava EE 5の 仕様に完全準拠したJava EEのプロセスです．１つのドメ イン内には複数のサーバインスタンスを作成する事ができます．また物理的にハードウェアが異なる環境上でインスタンスを作成する事もできます．ドメイン内 で複数のサーバインスタンスを作成する場合，それぞれのサーバインスタンスを識別するために，異なる名前を設定する必要があります．

サーバインスタンスは下記の２種類のいずれかの方法で作成できます．

1. クラスタに所属しないインスタンス
2. クラスタに所属しないインスタンス

クラスタについては別途，詳細に説明しますが，複数のサーバインスタンスを作成する環境では，クラスタへの所属の有無に応じて，アプリケーションの配備やリソース設定等の管理方法が大幅に異なってきます．具体的に はクラスタに属する全てのインスタンスは，クラスタに対する設定情報が各インスタンスに完全に引き継がれるため，たった１度のクラスタに対する操作で全て のインスタンスに対して反影されます．このようにクラスタに所属するインスタンスは，同じアプリケーションを負荷分散や高化用性を実現するために複数台の マシンで実行したいような場合に有効です．一方，クラスタに所属しないインスタンスは，各インスタンス間で設定情報を独立に設定するため，リソース設定を 個別に管理したい場合，単一のアプリケーションを別のJava VMプ ロセスで稼働させたい場合，もしくは異なるアプリケーションをそれぞれ別のJava VMの プロセスで稼働させたいような場合に有効です．

サーバインスタンスのアーキテクチャを「図5：サーバインスタンスのアーキテク チャ」に示します．のようにプロセス内にEJBコンテナやWebコンテナ等を含み，各種クライアントからの要求を受け 付けます．

図 5:サーバインスタンスのアー キテクチャ

サーバインスタンス単位，もしくはクラスタ構成単位に「図6： インスタンス毎の設定項目」に示す項目の設定が可能です．

図 6:インスタンス毎の設定項目

ドメインを作 成するためには create-domain コマンドを 実行して作成します．下記にプロファイルごとのドメイン作成方法を示します．

開発者 用プロファイルを使用したドメインの作成方法

デフォルトで 作成されるドメイン（domain1）以外に開発者用プロファイ ルを利用した新規ドメイン（devDomain）を作成する方法を下記 に示します．

クラスタプロファイルを使用したドメインの作成方法

クラスタプロファイルを使用したドメインの作成方法を下記に示します．下記の例では，ベースとなるポート番号（portbase）を指定して実行します．このオプションは 指定したポート番号を基に自動的に各種ポート番号を割り当てドメインを作成します．ポート番号の把握が容易になるため，複数ドメインを構築する場合などに 適しています．

上記はいずれも —savemasterpassword,–savelogin を有効にして設定を行いました．これらのオプションを指定してドメインを作成すると， 管理者のパスワード，管理者のパスワードがローカルファイルシステム(.asadminpass/master-password)に保存され，次回コマン ド実行時に管理者パスワードの入力を省略できます。一方 –savemasterpassword,–savelogin を指定せずに作成したドメインは asadmin コマンドの実行時に毎回管理者パスワードを問い合わせされます．

不正使用を防ぎたい場合は，毎回パスワードの入力を求めるように–savemasterpassword,–saveloginの 設定を無効にし，環境変数も設定しないようにしてください．

ドメインの一覧表示

作成されているドメインの一覧を表示するためにはlist-domainsコ マンドを実行します．コマンドを実行すると一覧表示以外にドメインの稼働状態も確認できます．

ドメインとドメイン管理サーバインスタンスの起動

ドメイン管理サーバを起動するためには，start-domainコマンドを実行します．

ドメインとドメイン管理サーバインスタンスの停止

ドメイン管理サーバを停止するためには，stop-domainコマンドを実行します．

開発者プロファイルを使用して作成したドメインの場合，管理コンソールの左ペインから「アプリケーションサーバ」を選択し右ペインの「一般」タブか ら「インスタンスの停止」ボタンを押すことによってドメイン管理サーバのインスタンスを停止する事ができます．

図 7:開発者プロファイルを利用 したドメイン管理サーバの停止方法
クラスタプロファイルを使用して作成したドメインの場合，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「一般」 タブから「インスタンスの停止」ボタンを押すことによってドメイン管理サーバのインスタンスを停止する事ができます．

図 8:クラスタプロファイルを利 用したドメイン管理サーバの停止方法

クラスタプロファイルへの変更方法

開発者プロファイルで作成したドメインをクラスタプロファイルに変更することができます．クラスタプロファイルへの変更は、asadminコマンドは利用できず，GUIの管理コンソールを使用した場合のみ可能です．

クラスタプロファイルへ変更するためには，管理コンソールの左ペインから「アプリケーションサーバ」を選択し右ペインの「一般」タブから「クラスタ サポートを追加…」ボタンを押すことによってクラスタ 構成を組むことのできるクラスタプロファイルへ変更できます．

図 9:クラスタプロファイルへの 変更方法

ドメインの削除

ドメインを削除する前に，ドメインが管理する全てのノードエージェント，全てのインスタンス，全てのアプリケーションが停止/削除されていることを確認して下さい．ドメイン上の各種リ ソースが残っている場合，削除に失敗します．

ドメインを削除するためには，delete-domainコマンドを実行します．