{scrollbar} {noformat:borderStyle=solid} Release Notes -- Apache Geronimo -- Version 2.0.2 リリース・ノート -- Apache Geronimo -- 2.0.2 バージョン Geronimo URLs ------------- Home Page: http://geronimo.apache.org/ ホームページ: http://geronimo.apache.org/ Downloads: http://geronimo.apache.org/downloads.html ダウンロード: http://geronimo.apache.org/downloads.html Documentation: http://geronimo.apache.org/documentation.html ドキュメント: http://geronimo.apache.org/documentation.html Mailing Lists: http://geronimo.apache.org/mailing.html メーリングリスト: http://geronimo.apache.org/mailing.html Source Code: http://geronimo.apache.org/svn.html ソースコード: http://geronimo.apache.org/svn.html Bug Tracking: http://issues.apache.org/jira/browse/GERONIMO バグ・トラッキング: http://issues.apache.org/jira/browse/GERONIMO Wiki: http://cwiki.apache.org/geronimo Wiki: http://cwiki.apache.org/geronimo Updated Information 更新情報 ------------------- Please see http://cwiki.apache.org/GMOxDOC20/release-notes-202txt.html for the latest information on this release. このリリースに関する最新情報については、http://cwiki.apache.org/GMOxDOC20/release-notes-202txt.html を参照してください。 System Requirements システム要件 ------------------- You need a platform that supports the Sun JDK 5.0+ (J2SE 1.5.0+). Other Java VMs should work as well. Sun JDK 5.0 以上 (J2SE 1.5.0 以上) をサポートするプラットホームを必要とします。他の Java VM も同様に動作するでしょう。 Most testing has been done on Linux, Mac OS X, and Windows. 大抵のテストが、Linux、Mac OS X、および、Windows 上で実行されました。 Significant Changes in the 2.0.2 Release 2.0.2 リリースの主な変更履歴 ---------------------------------------- - MEJB security issue fixed * Access to the Management EJB (MEJB) is now controlled by the admin (read access) and mejb-admin (read/write access) groups. - MEJB セキュリティー脆弱性の解決 * Management EJB (MEJB) へのアクセスは、admin (読込アクセス)、および、mejb-admin (読込/書込アクセス) グループによって制御されています。 - Changes in the default JNDI names for EJB's * The default JNDI names generated for EJB's has been simplified. Environments reliant on the default JNDI names generated by Geronimo 2.0.1 will not work with Geronimo 2.0.2 For information on the new format, see http://cwiki.apache.org/GMOxDEV/client-jndi-names.html - EJB の初期 JNDI 名の変更 * EJB の初期 JNDI 名は、簡素化されました。 Geronimo 2.0.1 によって生成された、初期 JNDI 名に依存している環境は、Geronimo 2.0.2 では動作しません。 新しい書式に関する情報については http://cwiki.apache.org/GMOxDEV/client-jndi-names.html を参照してください。 - Updated CA (Certification Authority) Helper application * Certificate requests and downloads are now supported using Internet Explorer - CA (認証局) ヘルパー・アプリケーションの更新 * Internet Explorer を使って、証明書の要求やダウンロードがサポートされるようになりました。 - Multiple bug fixes * A number of issues are resolved by Geronimo 2.0.2. A summary of issues is provided below. - 多くのバグ修正 * 多くの課題が Geronimo 2.0.2 で解決されています。解決された課題の一覧は、本ページの下に掲載されています。 Certification Status 認定状況 -------------------- Apache Geronimo v2.0 have passed 100% SUN's Java Enterprise Edition 5.0 Certification Test Suite. See "Distributions" for further details. Apache Geronimo v2.0 は、SUN の Java Enterprise Edition 5.0 Certification Test Suiteを通過しています。 さらなる詳細については、"配布物"欄を参照してください。 Distributions 配布物 ------------- Apache Geronimo v2.0 is available in five distributions so you can pick the one that better fits your environment. Apache Geronimo v2.0 は、5種類の配布物を利用可能で、あなたの環境にもっとも適したものを選択することが可能です。 The available distributions are as follows: 利用可能な配布物は、以下の通りです: Certified distributions: 認定済みの配布物: - Apache Geronimo with Tomcat web container, AXIS2 for Web Services and OpenJPA for persistence. - Apache Geronimo with Tomcat Web コンテナー ( AXIS2 Web サービス、および、OpenJPA 永続化エンジン)。 - Apache Geronimo with Jetty web container, CXF for Web Services and OpenJPA for persistence. - Apache Geronimo with Jetty Web コンテナー、( CXF Web サービス、および、OpenJPA 永続化エンジン)。 Non-Certified distributions: 非認定の配布物: - Little-G with Tomcat web container, minimal configuration. - Little-G with Tomcat Web コンテナー (最小限の構成)。 - Little-G with Jetty web container, minimal configuration. - Little-G with Jetty Web コンテナー (最小限の構成)。 - Micro-G, stripped down Geronimo pluggable framework. - Micro-G (Geronimo プラグインをカスタマイズするためのフレームワークのみの構成)。 Note: Non-Certified distributions do not contain a complete JavaEE5 stack and so cannot be certified. Certified distributions can be reconfigured by the user (such as Tomcat web container with CXF for Web Services). 注意: 非認定の配布物は、Java EE 5 スタックを含んでおらず、認定を受けていません。認定済みの配布物は、(CXF Web サービス を実装した Tomcat Web コンテナーのように) ユーザーの手で再構成可能です。 Supported features サポートしている機能 ------------------ All programming model elements of the Java EE 5.0 Specification are available. Some of the non-specification related elements such as clustering are still being worked on. Java EE 5.0 仕様のすべてのプログラミング・モデル要素が利用可能です。 クラスタリングのような仕様化されていない一部の関連要素も動作しています。 Building Geronimo Geronimo のビルド ----------------- See http://cwiki.apache.org/GMOxDEV/building-apache-geronimo.html for information about building Geronimo 2.0.2 from source ソースから Geronimo 2.0.2 をビルドする情報については、http://cwiki.apache.org/GMOxDEV/building-apache-geronimo.html を参照してください。 Installing & Starting Geronimo Geronimo のインストール & 始動 ------------------------------ To install, simply unpack the .zip (Windows) or tar.gz (Unix) file containing Geronimo. インストールするには、Geronimo を含む .zip (Windows) もしくは tar.gz (Unix) ファイルを普通に解凍してください。 If you wish to modify the default ports that Geronimo will use, edit the file /var/config/config-substitutions.properties Geronimo が使用する初期ポートを変更したい場合、ファイル /var/config/config-substitutions.properties を編集してください。 Geronimo comes with batch and script files to control server start and stop functions. To see usage examples simply type geronimo.bat or geronimo.sh command as appropriate for your platform. It is necessary to set JAVA_HOME to the copy of your Sun 5 JDK/JRE prior to executing the command. Geronimo では、サーバーの始動や停止を制御するためのバッチやスクリプトのファイルを提供しています。 使用例を見ておくために、あなたの環境に適した geronimo.bat もしくは geronimo.sh を普通に入力してください。 当該コマンドを実行する前に、JAVA_HOME 変数へ Sun JDK/JRE 5 の保存場所を設定する必要があります。 Here is an example to set JAVA_HOME: これは、JAVA_HOME へセットする一例です: export JAVA_HOME= To see the available command options type: サポートされているコマンド・オプションの種類を参照するには、下記のコマンドを呼び出します: /bin/geronimo.sh or \bin\geronimo.bat /bin/geronimo.sh もしくは \bin\geronimo.bat The command will display help text instructing you as to how to start and stop the Geronimo server. 当該コマンドは、Geronimo サーバーを始動および停止する方法を手引きするための、ヘルプ・テキストを表示します。 If you prefer to start the server without a script file you can simply type the following command from directory: スクリプト・ファイルなしでサーバーを始動したい場合、 ディレクトリーから次のコマンドを入力してください。 java -Djava.endorsed.dirs=lib/endorsed -javaagent:bin/jpa.jar -jar bin/server.jar Once the server has started, you can access the Geronimo Administration Console at http://localhost:8080/console/ . The default user name is "system" and the default password is "manager". サーバーが始動完了すると、Geronimo 管理コンソール http://localhost:8080/console/ へアクセス可能です。 初期ユーザーは "system"、そして、初期パスワードは "manager" です。 Note for Windows platforms: Windows users keep in mind the directory path length limitation of 255 characters. Defaulting installation to predefined directories such as "My Documents" or "Program Files" may cause the installation or the server start up to fail. Try a at a root level instead. Windows 環境での注意事項: Windows ユーザーは、ディレクトリーのパスに255文字までの制限があることを覚えておいてください。 "My Documents" や "Program Files" のような、決まったディレクトリーへ初期インストールすると、インストール処理、もしくは、サーバーの始動に失敗するかもしれません。 そのようにしないで、ルート・レベルの場所を に設定するように試みてください。 Security Configuration セキュリティーの設定 ---------------------- The default administration user/password for the Geronimo Administration Console and command line deployment tool is system/manager. You can change these defaults directly from the Geronimo Administration Console by accessing Security -> Console Realm and change the user name and password from the Console Realm Users portlet. Geronimo 管理コンソール、および、コマンドライン・デプロイメント・ツールの初期管理ユーザ/パスワードは、system/manager です。 Geronimo 管理コンソール上で、Security -> Console Realm へアクセスし、Console Realm Users ポートレットからユーザーとパスワードを変更することによって、これらの初期値を直接変更することが可能です。 As an alternative, you can make the same changes by editing the /var/security/users.properties and /var/security/groups.properties files. 他の方法として、 /var/security/users.properties および /var/security/groups.properties のファイルを編集することによって、同様の変更が可能です。 Access to the var/security directory should be appropriately secured on systems where you install Geronimo. var/security ディレクトリーへのアクセスは、Geronimo をインストールするシステム上で適切にセキュリティー対策されるすべきです。 Passwords in users.properties are encrypted by the server. Passwords can be changed using the Geronimo Administration Console. They can also be changed using a text editor. While the server is stopped, simply edit the users.properties file. The password(s) will be encrypted the next time the server is started. users.properties にあるパスワードは、サーバーによって暗号化されます。 パスワードは、Geronimo 管理コンソールを使って変更することが可能です。 テキスト・エディターを使って変更することも可能です。 サーバーが停止している間、users.properties ファイルを普通に編集してください。 次回のサーバー始動時に、パスワードは暗号化されます。 To prevent potential security exposures, we strongly recommend you update the default user names and passwords on your system. 潜在的なセキュリティーの漏洩を防ぐためには、システムの初期ユーザーとパスワードを変更しておくことを強く推奨します。 Deploying Applications アプリケーションのデプロイ ---------------------- Geronimo comes with deploy scripts and batch files to deploy J2EE modules or applications. You can use the scripts or simply invoke the executable jar by running the following command (note that you need to start Geronimo first): Geronimo では、J2EE モジュール、または、アプリケーションをデプロイするためのスクリプトやバッチのファイルを用意しています。 スクリプトを使用するか、次のコマンドを実行することで、実行可能な jar を普通に呼び出すことが可能です(注意: 最初に Geronimo を始動させておく必要があります): /bin/java -jar deployer.jar deploy my-web-app.war [deploy plan] /bin/java -jar deployer.jar deploy my-web-app.war [デプロイメント・プラン] You will need to use the username "system" and password "manager" unless you customized those as described above. The deployment plan argument is optional -- you can pack a deployment plan into the application module, provide it on the command line, or in some cases omit it entirely. 前項に記述されていたカスタマイズを行っていない場合、ユーザー名 "system" および パスワード "manager" を使用しなければなりません。 デプロイメント・プランの引数は、オプションです -- アプリケーション・モジュールの中にデプロイメント・プランを同梱したり、コマンドライン上でそれを外部指定することも可能で、場合によっては完全に省略することも可能です。 You can also use the "Login" command to avoid entering a user name and password every time you use the deploy tool また、デプロイ・ツールを使用するたびにユーザーとパスワードの入力を避けるためには、"Login" コマンドも使用可能です。 For more information on the commands and options supported by the deploy tool, run from within the Geronimo directory /bin: デプロイ・ツールでサポートされているコマンドやオプションに関するさらなる情報については、Geronimo directory /bin から以下のコマンドを実行してください: java -jar deployer.jar help [command] java -jar deployer.jar help [コマンド] You can also graphically deploy applications and resources via the Geronimo Administration Console available at http://localhost:8080/console/ http://localhost:8080/console/ にて利用可能な Geronimo 管理コンソール経由で、アプリケーションや資源を視覚的にデプロイ操作することも可能です。 Other Deployment Options その他のデプロイメント・オプション ------------------------ As an alternative to the command-line deployer, you can copy application modules into the /deploy/ directory and the hot deployer service will deploy them automatically. The command-line deployer has some advantages, as it will output any deployment errors to its own console rather than just the server log. コマンドライン・デプロイヤーに対する他の方法として、/deploy/ ディレクトリーにアプリケーション・モジュールを格納することが可能で、ホット・デプロイヤー・サービスが、それらを自動的にデプロイします。 コマンドライン・デプロイヤーには、デプロイメントのエラーをサーバーログではなくコンソールに出力するといった、いくつかのメリットがあります。 Additionally, Geronimo provides a Maven plugin that can deploy applications to Geronimo as part of a Maven build. その上、Geronimo は、Maven ビルドの一部として、アプリケーションを Geronimo へデプロイすることの可能な Maven プラグインを提供しています。 Configuration コンフィグレーション ------------- Most configuration attributes can be updated in the /var/config/config.xml file. The attributes most likely to be changed are already included in the supplied config.xml file, while others may need to be added manually. 大抵のコンフィグレーション属性は、/var/config/config.xml ファイルの中で変更可能です。 もっとも頻繁に変更されそうな属性は提供されている config.xml ファイルにあらかじめ含まれており、その他の属性は手作業で追加する必要があるかもしれません。 To enable MEJB write access, you will need to configure either an mejb-admin group. For example, to enable read/write MEJB access to the 'system' user, add the following to /var/security/groups.properties file: MEJB 書込アクセスを可能にするには、任意の mejb-admin グループに設定する必要があります。 例えば、'system' ユーザーに読込/書込アクセスを可能にするには、/var/security/groups.properties ファイルに、次の文を追加してください: mejb-admin=system Known Issues and Limitations 既知の問題、および、制約事項 ---------------------------- Spring jars packaged within the lib directory of an EAR file will not be accessible to web applications packaged within the same EAR file. To workaround this issue you must either override Spring class filtering which is automatically configured for the web applications or configure the Spring jars via the manifest classpath of the web applications. EAR ファイルの lib ディレクトリーに同梱されている Spring jar ファイルは、同 EAR ファイルに同梱されている Web アプリケーションに対して、利用されません。 この問題を回避するためには、Web アプリケーションに自動設定された Spring クラスのフィルタリングーを上書きするか、Web アプリケーションのマニフェスト・クラスパス経由で Spring の jar ファイルを設定するしかありません。 Resolved Issues 解決済みの課題 --------------- Sub-task サブ・タスク [GERONIMO-3461] - Disable MEJB gbean in the default assemblies until G3456 is fixed Bug バグ [GERONIMO-1746] - Cannot override default configurationFile value in Log4jService GBean [GERONIMO-2188] - When oracle wrapper is used, commits are not immediately committed to oracle database [GERONIMO-2567] - Remote admin of server using deployer.jar fails to connect [GERONIMO-2775] - Enabling web statistics collection for jetty fails from the admin console [GERONIMO-2851] - LDAP view in the console [GERONIMO-2884] - JNDI Name Not Correct [GERONIMO-2925] - Key used for encryption same for all server instances [GERONIMO-3208] - In-place deployment fails when renaming file [GERONIMO-3248] - Extraneous WARN messages during deployment of resource-env-refs in EJB jar [GERONIMO-3265] - Spring stale version in 2.0-M6-rc1 [GERONIMO-3310] - Geronimo is not finding message-destination elements in ejb-jar.xmls [GERONIMO-3317] - "has not been enhanced" error when invoking an EJB 2.1 Entity Bean [GERONIMO-3324] - Could not scan module for TLD files: illegal char (space) [GERONIMO-3326] - ClassLoader memory leak caused by OpenJPA [GERONIMO-3329] - javaVirtualMachine param for StartServerMojo in geronimo-maven-plugin doesn't work [GERONIMO-3348] - java.lang.NoSuchMethodError in org.springframework.context.i18n.LocaleContextHolder [GERONIMO-3363] - ArrayList thread safe problem in OpenJPA [GERONIMO-3376] - can't customize tomcat's session manager behavior per web context [GERONIMO-3380] - Derby embedded database pool created from console doesn't work [GERONIMO-3383] - "Connect" button on LDAP Viewer portlet just listens on port "1389" ,not 10389 [GERONIMO-3386] - Nothing returned when clicking on "Save" button at creating Tomcat NIO HTTPs Connector [GERONIMO-3388] - LoginKerberosTest relies on kerberos not being installed... so it can fail on windows? [GERONIMO-3390] - Server Logs portlet - Web Access Log Viewer is broken [GERONIMO-3405] - Generating WSDL files are runtime leaves files in use on Windows [GERONIMO-3409] - Several geronimo-web.xml files still use a 2.0-SNAPSHOT depend. Upgrade to geronimo.components vers=2.0.1 [GERONIMO-3411] - injection target entries are not added to existing env-entry entries [GERONIMO-3412] - Upgrade geronimo.components to released 2.0.1 levels [GERONIMO-3414] - servlet.destroy() not called on POJOWebServiceServlet [GERONIMO-3420] - Remote deploy of an EAR without an application.xml plan fails [GERONIMO-3421] - ClassFinder classloader problems cause deployer to hang [GERONIMO-3426] - The Holder object contains duplicated injections [GERONIMO-3435] - Axis2: unable to create a service-ref without wsdl using a generic Service class [GERONIMO-3437] - Axis2: serviceimplClass being null caused NPE at invoke in JavaBeanDispatcher [GERONIMO-3439] - geronimo-openejb-2.0.xsd not packaged under schema directory! [GERONIMO-3446] - Improperly configured JRE_HOME or JAVA_HOME environment variables can cause server failure [GERONIMO-3452] - Stateless Session EJBs cannot contain a remove() method [GERONIMO-3456] - Make MEJB security configurable [GERONIMO-3458] - include Dojo information in LICENSE and NOTICE files [GERONIMO-3459] - Build break due to OpenEJB Rev572863 changes [GERONIMO-3464] - A webapp with fails deployment [GERONIMO-3465] - Default log level needs to be tweaked to provide more useful information to users [GERONIMO-3473] - CA Helper app should support submitting Certificate Requests from Internet Explorer [GERONIMO-3474] - Use released openjpa 1.0.0 [GERONIMO-3475] - expose thread pool size in config.xml/config-substitutions.properties [GERONIMO-3477] - Transaction recovery broken for resource adapter [GERONIMO-3481] - Offline deployer throws BIND Exception when port 1099 is in use [GERONIMO-3484] - openejb-deployer should not require openejb to be running [GERONIMO-3489] - Deployment problems caused by file deletion failures [GERONIMO-3494] - HTTP GET is not handled correctly for JAX-WS services [GERONIMO-3499] - Expose ConnectionTimeout configuration in tomcat web connector to the user [GERONIMO-3505] - JettyAJP13Connector in geronimo-jetty6-minimal isn't using config-substitutions.properties [GERONIMO-3508] - Still cannot build branches/2.0 without building OpenEJB first, due to XBean depends [GERONIMO-3514] - NullPointerException in EjbModuleBuilder.addResourceAdapterMDBInfos Improvement 改善 [GERONIMO-2964] - Cannot specify the Tomcat work directory for a web application [GERONIMO-3378] - Enhance debugability of Deployer by logging errors and more data on debug [GERONIMO-3391] - Use the config-substitutions.properties for the Deployer remoteDeployAddress settings [GERONIMO-3401] - Stop of module from "System Modules" in console should warn user of destructive action [GERONIMO-3423] - Ensure that users can change the ejb jndi name format [GERONIMO-3507] - Expose all TomcatConnector attributes in config.xml [GERONIMO-3511] - Upgrade to TranQL 1.1 released MySQL and PostgresSQL [GERONIMO-3513] - Update XBean versions to new 3.2 release Task タスク [GERONIMO-3521] - plugin catalog for 2.0.2 {noformat}