JSF2.0 の開発環境を GlassFish v3 Preview 版のまま放置してきましたが、気づけば v3.0.1 がリリースされていました。
今さらですが、v3 正式版を飛び越えて v3.0.1 にバージョンアップしたいと思います。
GlassFish Project - 3.0.1 Final 画面 (英語) に遷移しますので、「GlassFish 3.0.1 Open Source Edition Full Platform」からダウンロードするプラットフォームを選択します。
「Linux / Unix / Mac」と「Zip archive」の二種類のうち、お好みの方を選択してください。
(*) 前者はインストーラに X Window 環境が必要となります。
Preview 版 では「Zip archive」でインストールしたので、今回は「Linux / Unix / Mac」を試してみようと「glassfish-3.0.1-unix-ml.sh (multilingual)」をダウンロードしました。
(*) アンインストールといっても、ディレクトリごと削除するだけですが。。。
Eclipse からの使用を想定しているため、前回同様一般ユーザでインストールを行っています。
ようこそ画面
「次へ」ボタンを選択してください。
ライセンス画面
ライセンス内容を確認してください。
問題なければ「ライセンス契約の条項に同意します」を指定して「次へ」ボタンを選択してください。
GlassFish をインストールするディレクトリを指定します。
デフォルトでは「~/glassfishv3」が指定されていますので必要に応じて変更してください。
(以下、デフォルト値を指定した前提で進めます)
GlassFish サーバの「管理ポート」「HTTP ポート」「ユーザー名」「パスワード」を指定します。
デフォルトではそれぞれ「4848」「8080」「admin」「指定なし」となっています。
赤び～環境では Tomcat が 8080ポートを使用しているため、前回 同様「HTTPポート」を「8181」に変更しました。
「パスワード」も指定しようとしましたが、なぜか入力できなかったためここではデフォルトのままとしています。
この画面で「次へ」ボタン選択時に「ホスト名が見つかりません」エラーが表示される場合は
「6. 補足： ホスト名が見つかりませんエラーへの対応」
を参照してください。
更新ツールの使用有無を指定します。
デフォルトでは「更新ツールのインストール」「更新ツールを有効にする」共に OFF となっています。
赤び～環境では両方とも ON にしています。
「プロキシホスト」「プロキシポート」は必要に応じて指定してください。
GlassFish が使用する JDK を指定します。
デフォルトで有効な (普段使用している) JDK が選択されているかと思いますが、指定されていない or 別の JDK を使用する場合は別途設定を行ってください。
これまでの設定内容で問題なければ「インストール」ボタンを選択してください。
GlassFish のインストールが開始されます。
製品の登録画面
インストール完了後に表示されるユーザ登録画面です。
赤び～は Sun アカウントを持っているため登録しましたが、「登録をスキップ」できる以上必須ではないようです。(未確認ですが。。。)
概要画面
ユーザ登録も含め、インストール完了後に表示されます。
インストールステータス確認後、「終了」ボタンを選択してください。
4.1. GlassFish の起動
GlassFish の起動は startserv コマンドで行います。
コンソールにエラーが出力されなければ問題なく起動しています。
4.2. 管理画面の表示
プラウザを起動し、「http://localhost:4848」に接続してください。
管理ユーザ「デフォルト admin」のパスワードを指定していなければ、GlassFish の管理画面が表示されます。
Preview 版と異なり最初から日本語化されていました。
「更新ツール」-「インストール済みコンポーネント」を確認すると、「l10n」コンポーネントが全てインストール済みでした。(右画面)
4.3. 管理ユーザパスワードの設定
インストール時に管理ユーザのパスワードを設定できなかったため、パスワード設定を行います。
「Enterprise Server」-「管理者パスワード」から管理ユーザのパスワードを設定してください。
パスワード設定後は「http://localhost:4848」接続時にユーザとパスワードの認証が面画表示されます。
4.4. GlassFish の停止
GlassFish の停止は stopserv コマンドで行います。
7/25 追記
以下は Eclipse のサーバ設定における管理者パスワードの設定ミスが原因でした。
Preview 版との差異は、Eclipse からの GlassFish 起動時にも管理ユーザ認証が必要となったことです。
ブラウザからの接続時とは異なり、管理ユーザのパスワードなし時でも入力が必要となります。
6. 補足： ホスト名が見つかりませんエラーへの対応
GlassFish インストール時における管理の設定画面で、以下のような「ホスト名が見つかりません」エラーダイアログが表示されて、これ以上インストールを進めることができない場合があります。
このダイアログは「管理ポート」と「HTTP ポート」で２回出力されます。
原因は GlassFish をインストールするサーバ自身に対する名前解決ができていないことが多いようです。
6.1. /etc/hosts の設定確認
/etc/hosts に下記設定が存在するか確認してください。
その後、インストールが継続可能となれば、名前解決できなかったことがインストールエラーの原因です。
今さらですが、v3 正式版を飛び越えて v3.0.1 にバージョンアップしたいと思います。
1. GlassFish のダウンロード
GlassFish Community のサイトの右上にある「主要なダウンロード」から「GlassFish v3」を選択します。GlassFish Project - 3.0.1 Final 画面 (英語) に遷移しますので、「GlassFish 3.0.1 Open Source Edition Full Platform」からダウンロードするプラットフォームを選択します。
「Linux / Unix / Mac」と「Zip archive」の二種類のうち、お好みの方を選択してください。
(*) 前者はインストーラに X Window 環境が必要となります。
Preview 版 では「Zip archive」でインストールしたので、今回は「Linux / Unix / Mac」を試してみようと「glassfish-3.0.1-unix-ml.sh (multilingual)」をダウンロードしました。
2. 旧バージョンの削除
前にインストールした GlassFish v3 Preview 版をアンインストールします。(*) アンインストールといっても、ディレクトリごと削除するだけですが。。。
$ rm -rf ~/glassfishv3
3. GlassFish のインストール
3.1. インストーラの起動とライセンス確認
ダウンロードしたファイルに実行権を付与し、実行するとインストーラが起動します。Eclipse からの使用を想定しているため、前回同様一般ユーザでインストールを行っています。
$ chmod a+x glassfish-3.0.1-unix-ml.sh
$ ./glassfish-3.0.1-unix-ml.sh
$ ./glassfish-3.0.1-unix-ml.sh
ようこそ画面
「次へ」ボタンを選択してください。
ライセンス画面
ライセンス内容を確認してください。
問題なければ「ライセンス契約の条項に同意します」を指定して「次へ」ボタンを選択してください。
3.3. インストールディレクトリの指定
インストールディレクトリ画面
GlassFish をインストールするディレクトリを指定します。
デフォルトでは「~/glassfishv3」が指定されていますので必要に応じて変更してください。
(以下、デフォルト値を指定した前提で進めます)
3.4. サーバ管理パラメタの指定
管理の設定画面
GlassFish サーバの「管理ポート」「HTTP ポート」「ユーザー名」「パスワード」を指定します。
デフォルトではそれぞれ「4848」「8080」「admin」「指定なし」となっています。
赤び～環境では Tomcat が 8080ポートを使用しているため、前回 同様「HTTPポート」を「8181」に変更しました。
「パスワード」も指定しようとしましたが、なぜか入力できなかったためここではデフォルトのままとしています。
この画面で「次へ」ボタン選択時に「ホスト名が見つかりません」エラーが表示される場合は
「6. 補足： ホスト名が見つかりませんエラーへの対応」
を参照してください。
3.4. 更新ツールの設定
更新の設定画面
更新ツールの使用有無を指定します。
デフォルトでは「更新ツールのインストール」「更新ツールを有効にする」共に OFF となっています。
赤び～環境では両方とも ON にしています。
「プロキシホスト」「プロキシポート」は必要に応じて指定してください。
3.5. 更新ツールの設定
JDKの選択画面
GlassFish が使用する JDK を指定します。
デフォルトで有効な (普段使用している) JDK が選択されているかと思いますが、指定されていない or 別の JDK を使用する場合は別途設定を行ってください。
3.6. インストールと登録
インストール可能画面
これまでの設定内容で問題なければ「インストール」ボタンを選択してください。
GlassFish のインストールが開始されます。
製品の登録画面
インストール完了後に表示されるユーザ登録画面です。
赤び～は Sun アカウントを持っているため登録しましたが、「登録をスキップ」できる以上必須ではないようです。(未確認ですが。。。)
概要画面
ユーザ登録も含め、インストール完了後に表示されます。
インストールステータス確認後、「終了」ボタンを選択してください。
4. GlassFish の動作確認
4.1. GlassFish の起動
GlassFish の起動は startserv コマンドで行います。$ ~/glassfishv3/glassfish/bin/startserv
コンソールにエラーが出力されなければ問題なく起動しています。
4.2. 管理画面の表示
プラウザを起動し、「http://localhost:4848」に接続してください。管理ユーザ「デフォルト admin」のパスワードを指定していなければ、GlassFish の管理画面が表示されます。
Preview 版と異なり最初から日本語化されていました。
「更新ツール」-「インストール済みコンポーネント」を確認すると、「l10n」コンポーネントが全てインストール済みでした。(右画面)
4.3. 管理ユーザパスワードの設定
インストール時に管理ユーザのパスワードを設定できなかったため、パスワード設定を行います。「Enterprise Server」-「管理者パスワード」から管理ユーザのパスワードを設定してください。
パスワード設定後は「http://localhost:4848」接続時にユーザとパスワードの認証が面画表示されます。
4.4. GlassFish の停止
GlassFish の停止は stopserv コマンドで行います。$ ~/glassfishv3/glassfish/bin/stopserv
5. Eclipse の設定変更
GlassFish 再インストールにともない Eclipse の再設定も必要かと思い確認してみたところ、Preview 版で行ったサーバ設定のままで問題なく動作しました。
7/25 追記
以下は Eclipse のサーバ設定における管理者パスワードの設定ミスが原因でした。
Preview 版との差異は、Eclipse からの GlassFish 起動時にも管理ユーザ認証が必要となったことです。
ブラウザからの接続時とは異なり、管理ユーザのパスワードなし時でも入力が必要となります。
6. 補足： ホスト名が見つかりませんエラーへの対応
GlassFish インストール時における管理の設定画面で、以下のような「ホスト名が見つかりません」エラーダイアログが表示されて、これ以上インストールを進めることができない場合があります。
このダイアログは「管理ポート」と「HTTP ポート」で２回出力されます。
原因は GlassFish をインストールするサーバ自身に対する名前解決ができていないことが多いようです。
6.1. /etc/hosts の設定確認
/etc/hosts に下記設定が存在するか確認してください。127.0.0.1 localhost.[ドメイン名] localhost
127.0.0.1 [ホスト名].[ドメイン名] [ホスト名]
127.0.0.1 [ホスト名].[ドメイン名] [ホスト名]
6.2. /etc/sysconfig/network の設定確認
/etc/sysconfig/network に下記設定が存在するか確認してください。HOSTNAME=[ホスト名].[ドメイン名]
6.3. ネットワークの再起動
/etc/hosts と /etc/syscnfig/network のいずれかの設定を変更した場合、ネットワークを再起動して変更内容を有効にしてください。# service network restart
その後、インストールが継続可能となれば、名前解決できなかったことがインストールエラーの原因です。