User manual REDHAT APPLICATION SERVER JONAS TUTORIAL

[. . . ] Red Hat Application Server JOnAS Tutorial Red Hat Application Server: JOnAS Tutorial Copyright © 1999-2004 by ObjectWeb Consortium ObjectWeb Consortium INRIA - ZIRST, 655 avenue de l'Europe Montbonnot 38334 SAINT-ISMIER Cedex FRANCE Additional information copyright © Red Hat, Inc. , 2003-2004. 1801 Varsity Drive Raleigh NC 27606-2072 USA Phone: +1 919 754 3700 Phone: 888 733 4281 Fax: +1 919 754 3701 PO Box 13588 Research Triangle Park NC 27709 USA Manual identifier: · PDF: rhaps-jonas-EN-3-PDF-RHI (2003-09-24T01:08) · HTML: rhaps-jonas-EN-3-HTML-RHI (2003-09-24T01:08) JOnAS is copyright © ObjectWeb Consortium. The JOnAS logo is copyright © Bruno Bellamy. Tomcat is copyright © The Apache Software Foundation (ASF). [. . . ] jonas. service. resource. autoloaddir autoload # Set the list of Resource Adapter to be used. # This enables the JOnAS server to configure the resource adapter # and register it into JNDI. # This property is set with a comma-separated list of RAR file names # (with/without the '. rar' suffix). # Ex: XXXX, YYYY (while the rar file names are XXXX. rar and YYYY. rar) jonas. service. resource. resources 4. 1. 2. 2. carol. properties Access to JNDI is bound to the carol. properties file, which must be accessible from the classpath. This file is supplied with the JOnAS distribution in the $JONAS_ROOT/conf directory. Getting Started With JOnAS # Groupname for Javagroups. carol. cmi. multicast. groupname=G1 # Factor used for this server in wheighted round robin algorithms carol. cmi. rr. factor=100 # If enabled, cluster stubs will print messages on some error cases carol. cmi. stub. debug=false # If true, local call with jrmp are optimized. # If you get "ClassCastException with 2 beans in different jars, # you should set it at "false". carol. jvm. rmi. local. call=false carol. jndi. java. naming. factory. url. pkgs=org. objectweb. jonas. naming 4. 1. 3. Database Access Any database with a JDBC driver can be used with JOnAS. Sample properties files are provided for Oracle, InstantDB, Interbase, and PostgreSQL. If you want to setup a new database, you can modify one of those configuration files to suit your database driver requirements. # datasource. name jdbc_1 datasource. url jdbc:postgresql://localhost:5433/db_jonas datasource. classname org. postgresql. Driver datasource. username jonas datasource. password jonas datasource. mapper rdb. postgres ##### # ConnectionManager configuration # # JDBC connection checking level. # 0 = no special checking # 1 = check physical connection is still open before reusing it # 2 = try every connection before reusing it jdbc. connchecklevel 1 # Max age for jdbc connections # nb of minutes a connection can be kept in the pool jdbc. connmaxage 30 # Test statement jdbc. connteststmt select 1 Note that postgresql_ds is the name that you will have to use in your beans deployment descriptors to reference this datasource. Also, if you called this file postgresql. properties, you must define Chapter 4. Getting Started With JOnAS 21 a line such as jonas. service. dbm. datasources postgresql in your jonas. properties file. 4. 1. 4. Loading Beans Using jonas. properties jonas. properties file. Here are some examples: · You can statically define the beans you want to load at JOnAS startup by updating the If you want to load the beans defined in a single ejb-jar. xml file, and not packaged in an ejb-jar file, place this line in your jonas. properties file: jonas. service. ejb. descriptors META-INF/ejb-jar. xml Note that in the above case, the shell CLASSPATH used to start the JOnAS server must also allow access to your bean classes. · · To deploy beans defined in several deployment descriptors, the syntax is as follows: jonas. service. ejb. descriptors Bean1. xml, Bean2. xml If you want to load all the beans of your application, you can give the name of the application jar file, but you must store your xml deployment descriptor in the META-INF directory: jonas. service. ejb. descriptors myApp. jar 4. 1. 5. JOnAS Administration JOnAS can be administered from a Web interface with: http://hostname:9000/jonasAdmin Login with User Name jonas and Password jonas. JOnAS can also be managed using the command-line tool called jonas, using username jonas and password jonas. The administrative option is started by passing admin as a command-line argument. [. . . ] JMX (Java Management Extension) JOnAS contains the Java Management Extension technology. Management and monitoring is available through a Web interface. See http://java. sun. com/products/JavaManagement. 52 JNDI (Java Naming and Directory Interface) Glossary JNDI provides Java applications with a unified interface to naming and directory services. JOnAS JOnAS (Java Open Application Server) is a distributed platform compliant with the EJB TM specifications (see http://www. objectweb. org/jonas/index. html). [. . . ]