User: mnf999  
  Date: 01/10/05 11:51:24

  Modified:    src/docs faq.jsp
  Log:
  moved to common
  
  Revision  Changes    Path
  1.2       +5 -302    newsite/src/docs/faq.jsp
  
  Index: faq.jsp
  ===================================================================
  RCS file: /cvsroot/jboss/newsite/src/docs/faq.jsp,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- faq.jsp   2001/08/30 22:29:19     1.1
  +++ faq.jsp   2001/10/05 18:51:24     1.2
  @@ -1,304 +1,7 @@
  -<jsp:include page="head.jsp" flush="true" /><jsp:include page="slogan.jsp" 
flush="true" > <jsp:param name="SLOGAN" value="FREQUENTLY ASKED 
QUESTIONS"/></jsp:include>                <!-- CONTENT -->
  +<jsp:include page="head.jsp" flush="true" />
  +<jsp:include page="slogan.jsp" flush="true" > 
  +<jsp:param name="SLOGAN" value="FREQUENTLY ASKED QUESTIONS"/></jsp:include>         
 <!-- CONTENT -->
   
  -<p class="head"><a name="top_of_faq"></a><a name="FAQ_CONTENTS"></a>FAQ CONTENTS
  -<p class="text">JBoss is an Open Source, standards-compliant, Enterprise JavaBeans 
Application Server implemented in 100% Pure Java.The JBoss organization is working to 
deliver JBoss as <i>the</i> premier Enterprise Java application server for the Java 2 
Enterprise Edition platform. JBoss will be delivered under the LGPL licence. <br>      
                                               
  -<p class="text">This FAQ has been logically divided into the following sections - 
an <a class="link" href="#FAQ-SECTION-CREDITS">initial section</a> about this document 
itself, a catchall section for <a class="link" href="#FAQ-SECTION-GENERAL">general and 
background information</a>, a section about the <a class="link" 
href="#FAQ-SECTION-JBOSS">JBoss projects and people</a>&nbsp; and then three 
role-based sections. Each of this sections is designed to help you based on what you 
do with JBoss - <a class="link" href="#FAQ-SECTION-BEANDEV">Bean Developer</a>, <a 
class="link" href="#FAQ-SECTION-SRVDEV">Server Administrator</a> or <a class="link" 
href="#FAQ-SECTION-SRVDEV">Container Developer</a>.
  -<p class="text">If you are looking for more Technical Information about JBoss then 
you should also read the <a class="link" href="../documentation/ejb.html">JBoss 2.0 
EJB development guide</a>.
  -<p class="text"><a class="link" href="#FAQ-CREDITS" name="FAQ-SECTION-CREDITS">FAQ 
Info and Credits</a>
  -<p class="text"><ul>
  -<li><a class="link" href="#FAQ-CREDITS-AUTHORS">Who is responsible for this FAQ 
?</a>
  -<li><a class="link" href="#FAQ-CREDITS-LATEST">How do I get the latest version of 
this FAQ?</a></ul>
  +<jsp:include page="common/faq.jsp" flush="true" />
   
  -<p class="head"><a class="link" href="#FAQ-GENERAL" 
name="FAQ-SECTION-GENERAL">GENERAL QUESTIONS</a> <ul>
  -<li><a class="link" href="#FAQ-GENERAL-J2EE">What is Java 2 Enterprise Edition 
(J2EE) ?</a>
  -<li><a class="link" href="#FAQ-GENERAL-EJB">What are Enterprise JavaBeans (EJB) 
?</a>        
  -<li><a class="link" href="#FAQ-GENERAL-JAVABEANS">Are JavaBeans different from 
Enterprise JavaBeans ?</a>
  -<li><a class="link" href="#FAQ-GENERAL-JAS">What is a Java Application Server ?</a>
  -<li><a class="link" href="#FAQ-GENERAL-DEPLOYMENT">What does Deployment mean ?</a>
  -<li><a class="link" href="#FAQ-GENERAL-TRANSMGMT">What is Transaction 
Management?</a>
  -<li><a class="link" href="#FAQ-GENERAL-PERSISTENCE">What is Bean / Container 
Managed Persistence ?</a></ul>
  -
  -<p class="head"><a class="link" href="#FAQ-JBOSS" name="FAQ-SECTION-JBOSS">JBOSS 
QUESTIONS</a><ul>
  -<li><a class="link" href="#FAQ-JBOSS-SUMMARY">What is JBoss ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-BENEFITS">What are the benefits of JBoss ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-COMPLIANCE">Is JBoss in compliance with the 
current EJB spec ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-COMMUNITY">What is the JBoss community ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-OBTAIN">How  can I get a copy of JBoss ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-INSTALL">How do I install JBoss ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-SELL">Can I sell JBoss ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-DISTRIBUTE">Can I include JBoss in my 
distribution ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-SURVIVAL">How does JBoss survive ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-IIOP">Does JBoss support RMI/IIOP ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-SOAP">Does JBoss support SOAP ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-RMH">How do I make the RMH samples work ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-JDKS">Are there any functional differences 
between jdk1.2 and jdk1.3 ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-PERFORMANCE">Any benchmark or performance 
metrics available?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-REMOTE">How do I get my client working from a 
remote machine ?</a> 
  -<li><a class="link" href="#FAQ-JBOSS-EJX">EJX won't start, what's wrong ?</a> </ul> 
                                                                                 
  -
  -<p class="head">BEAN DEVELOPERS QUESTIONS<ul>
  -<li><a class="link" href="#FAQ-BEANDEV-RUNJAR">How can I run my EJB jar in JBoss 
?</a>
  -<li><a class="link" href="#FAQ-BEANDEV-GUIDE">Is a programmer guide available for 
JBoss ?</a>
  -<li><a class="link" href="#FAQ-BEANDEV-RESOURCEPREFIX">When do I need to prefix a 
lookup with &quot;java:comp/env&quot; ?</a>
  -<li><a class="link" href="#FAQ-BEANDEV-ACCESSBEANS">How do I access beans in a 
different jar ?</a></ul>
  -
  -<p class="head">SERVER ADMINISTRATION QUESTIONS
  -<ul>
  -  <li><a class="link" href="#FAQ-ADMIN-START">How is JBoss started ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-SHUTDOWN">How do I cleanly shutdown JBoss 
  -    ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-NTSERVICE">How can I set up JBoss as a 
  -    service in Windows NT ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-BOOT">How do I configure JBoss to start 
  -    when the server boots ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-SECURITY">How do I configure security with 
  -    JBoss ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-DEPLOY">What tasks must be completed to 
  -    deploy an EJB using JBoss ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-UNDEPLOY">How do I undeploy an application 
  -    ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-CLUSTER">Can I cluster multiple JBoss 
servers 
  -    ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-DATASOURCE">How do I configure [Database 
  -    Type] with JBoss ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-JAWSDTD">Is a DTD available for jaws.xml 
  -    ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-JBOSSDTD">Is a DTD available for jboss.xml 
  -    ?</a> 
  -  <li><a class="link" href="#FAQ-ADMIN-RUN-PATH-WITH-A-SPACE">JBoss won't run when 
installed 
  -    in a path with spaces?</a> 
  -</ul>
  -
  -<p class="head">CONTAINER DEVELOPER QUESTIONS<ul>
  -<li><a class="link" href="#FAQ-CONTAINER-SPECS">Where can I find technical specs 
for the JBoss server ?</a>
  -<li><a class="link" href="#FAQ-CONTAINER-CONTRIBUTE">How can I contribute to JBoss 
?</a>
  -<li><a class="link" href="#FAQ-CONTAINER-HELP">What help exists to help me learn 
about the JBoss source ?</a></ul>
  -
  -<p class="head"><a name="FAQ-CREDITS"></a>FAQ INFO AND CREDITS
  -<p class="text">
  -<h3><a name="FAQ-CREDITS-AUTHORS"></a>Who is responsible for this FAQ ?</h3>
  -<p class="text">The first version of the JBoss FAQ was created by <a class="link" 
href="mailto:[EMAIL PROTECTED]";>Kunle Odutola</a> in March 2000. The second 
version of the FAQ was a rewrite by <a class="link" 
href="mailto:[EMAIL PROTECTED]";>Jeremiah Johnson</a> in August 2000 with maintenance by 
<a class="link" href="mailto:[EMAIL PROTECTED]";>Kunle Odutola</a>. The current 
version is maintained by <a class="link" href="mailto:[EMAIL PROTECTED]";>Dewayne  
McNair</a>.
  -<p class="text">Most of the wisdom contained in the answers presented here however 
comes from the collective insights and diligence of the many others who inhabit the 
JBoss mailing list(s) and the EJB world-at-large. Particular mention goes to the 
following people from the JBoss mailing list:</p> <ul>
  -<li>Rickard &Ouml;berg
  -<li>Marc Fleury
  -<li>Dan O'Connor
  -<li>Clint Dalton
  -<li>Stephan Schmidt
  -<li>Micheal Jordan
  -<li>Kunle Odutola
  -<li>Jeremiah Johnson</ul>
  -
  -<p class="text">If you see your genius represented anywhere in this FAQ without due 
attribution to you and you would like it fixed, drop me a line and I'll put it in.
  -<p class="text">Back to <a class="link" href="#top_of_faq">FAQ Contents</a></p>
  -<h3><a name="FAQ-CREDITS-LATEST"></a>Where can I get the latest version of this 
FAQ?</h3><ul>
  -<li>From the JBoss project's homepage at <a class="link" 
href="http://www.jboss.org/";>www.JBoss.org</a>. There is a link to a release version 
of this FAQ that in sync with the latest release of JBoss.
  -<li>From the JBoss binary distribution archives. These are downloadable from a link 
on <a class="link" href="http://www.jboss.org/";>www.JBoss.org</a> and, they contain a 
copy of this FAQ that is appropriate to the version of JBoss in the archive.
  -<li>From the JBoss CVS repository. The version in CVS is often under development 
and is more appropriate for developers and seasoned JBoss pros. The other versions are 
derived from the CVS FAQ.</ul>
  -
  -<p class="text">Back to <a class="link" href="#top_of_faq">FAQ Contents</a>
  -<p class="head"><a name="FAQ-GENERAL"></a>GENERAL QUESTIONS
  -<p class="text">
  -<h3><a name="FAQ-GENERAL-J2EE"></a>What is Java 2 Enterprise Edition (J2EE) ?</h3>
  -<p class="text">The Java 2 Platform Enterprise Edition (J2EE) is the platform for 
developing, deploying and managing n-tiered information systems using Java 
technologies. The platform encourages the development of enterprise systems with the 
ability to run <i>anywhere</i> across a wide range of operating systems. J2EE extends 
the Java 2 Platform to cater for the server-side processing needs of the enterprise 
with key technologies including the following:<ul>
  -<li>Enterprise JavaBeans (EJB)                                                      
                 
  -<li>Java Naming and Directory Interface (JNDI)                                      
                                 
  -<li>JDBC data access API                                                            
         
  -<li>Java Servlets                                                                   
 
  -<li>JavaServer Pages (JSP)                                                          
         
  -<li>Java Transaction API (JTA)                                                      
                 
  -<li>Java Transaction Service (JTS)                                                  
                 
  -<li>Java Messaging Service (JMS)                                                    
                 
  -<li>Remote Method Invocation (RMI)                                                  
                 
  -<li>CORBA                                                            </ul>
  -
  -<p class="text">Further information about Java 2 Platform Enterprise Edition (J2EE) 
is available on the <a class="link" href="http://java.sun.com/j2ee/";>J2EE home 
page</a>.                                                         
  -<p class="text">Back to <a class="link" href="#top_of_faq">FAQ Contents</a></p>
  -<h3><a name="FAQ-GENERAL-EJB"></a>What is Enterprise JavaBeans (EJB) ?</h3>
  -<p class="text">Enterprise JavaBeans (EJB) is a <a class="link" 
href="http://java.sun.com/products/ejb/docs.html";>specification and architecture</a> 
for the development and deployment of component-based, distributed business 
applications on the Java platform. It is a significant part of Java 2 Enterprise 
Edition (J2EE) - a unified architecture and platform for delivering the benefits of 
the Java platform to the server-based computing environment.
  -<p class="text">A business component that is developed for the Enterprise JavaBean 
architecture is also confusingly called an Enterprise JavaBean. These components may 
be written once, and then deployed on any server platform that supports the Enterprise 
JavaBeans specification. A key goal of the EJB architecture is to make the job of 
developing EJB components and the client applications that access them very simple 
indeed. Much of this is achieved by defining an architectural entity called a 
<i>container</i> - an EJB container - that acts as a buffer between EJB components and 
their client as well as between EJB components and the very complex reality of 
developing scalable, distributed systems. An EJB container is itself contained within 
an <i>EJB server</i>.
  -<p class="text">Further information about Enterprise JavaBeans is available on the 
<a class="link" href="http://java.sun.com/products/ejb/index.html";>Enterprise 
JavaBeans home page</a>.
  -<p class="text">Back to <a class="link" href="#top_of_faq">FAQ Contents</a></p>
  -<h3><a name="FAQ-GENERAL-JAVABEANS"></a>Are JavaBeans different from Enterprise 
JavaBeans ?</h3>
  -<p class="text">Yes, JavaBeans are different from Enterprise JavaBeans (EJBs). Both 
JavaBeans and EJBs are units of packaged functionality but they are designed to 
function in very specific and different environments. JavaBeans facilitate black box 
reuse of visual and non-visual components within JavaBean-aware IDEs. EJBs on the 
other hand are non-visual components that can only be deployed in an EJB-compliant 
Java&nbsp; application server.&nbsp;</p>
  -<p class="text">JavaBeans are basically just classes executed in the JVM, while 
EJBs are managed objects that are deployed within an EJB application server. JavaBeans 
may be driven by events, but EJBs are currently just driven by remote method calls.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>&nbsp;
  -<h3><a name="FAQ-GENERAL-JAS"></a>What is a Java Application Server ?</h3>
  -<p class="text">In the current context, a Java application server is a 
sophisticated software system that provide a run-time environment for executing 
components written in Java. The widespread adoption of the EJB standard from the J2EE 
specification has ensured that a well written component can be without additional 
development work deployed in almost all Java application servers.</p>                  
                                        
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ 
Contents</a>&nbsp;</p>
  -<h3><a name="FAQ-GENERAL-DEPLOYMENT"></a>What does Deployment mean ?</h3>
  -<p class="text">Deployment is the act of preparing and sending the bean(s) to the 
application server to become available as application components. In preparation for 
deployment, any resources that the bean provider has used in the code must be 
associated with real resources, transactional attributes may be specified, security 
attributes may be set, and any other container-specific settings will all be specified 
in deployment descriptors. The compiled code and the deployment descriptors will all 
be jarred together into an application jar and then the jar will be placed in the 
necessary location for the application server to use. The final act of deployment is 
the application server parsing the deployment descriptors, preparing the container 
environment, and then binding the bean names to the naming service to make them 
available for calls.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-GENERAL-TRANSMGMT"></a>What is Transaction Management ?</h3>
  -<p class="text">A transaction is an atomic and reliable unit of program execution. 
Transactions systems are invaluable in  any system that support concurrent processing. 
For example, if multiple  clients are using the same database table concurrently, it's 
possible  that the database write operations they perform could leave the table in an 
inconsistent state. With transactional support, each user see a transaction as an 
operation that either completes successfully or not at all. The possibility of 
inconsistencies arising as result of their interleaved database operations is 
removed.&nbsp;</p>
  -<p class="text">The Enterprise JavaBeans architecture provides automatic support 
for distributed transactions in component based applications. Such distributed 
transactions can atomically update data in multiple databases. The burden of managing 
transactions is thus shifted from the bean developer to the EJB container and/or 
server.</p>
  -<p class="text">Read chapter 11 of the EJB 1.1 spec if you are interested in 
knowing more about Transaction Management.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-GENERAL-PERSISTENCE"></a>What is Bean / Container Managed 
Persistence ?</h3>
  -<p class="text">With respect to Enterprise JavaBeans (EJBs), persistence is a term 
that describes the process whereby the the state of an active (stateful?) EJB is 
stored (usually to a database) in such a way that the EJB can be reactivated later. It 
is serialization for EJBs if you like.</p>
  -<p class="text">There are two flavours of persistence in EJB - Bean-Manage 
Persistence (BMP) and Container-Managed Persistence (CMP). The main difference between 
the two flavours is who is responsible for <i>actually</i> persisting the EJB. In BMP 
the bean developer is responsible for writing the code that persists the beans state 
(maybe using JDBC?) while in CMP, the container is reponsible. In CMP a bean developer 
might not even <i>know</i> what object-relational database persistence is let alone 
how it works?. Pretty neat.</p>
  -<p class="text">A relevant excerpt from the <a class="link" 
href="http://java.sun.com/products/ejb/docs.html";>EJB 1.1. specification</a> itself, 
on page 100:</p>
  -<p class="text">&quot;The entity bean component protocol allows the entity Bean 
Provider either to implement the entity bean's persistence directly in the entity bean 
class or in one or more helper classes provided with the entity bean class 
(bean-managed persistence), or to delegate the entity bean's persistence to the 
Container Provider tools used at deployment time (container-managed 
persistence).&quot;<br></p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<p class="head"><a name="FAQ-JBOSS"></a><b>JBOSS QUESTIONS</b>
  -<p class="text">
  -<h3><a name="FAQ-JBOSS-SUMMARY"></a>What is JBoss ?</h3>
  -<p class="text">Basically, JBoss is an application server written in Java that can 
host business components developed in Java. The interface and architecture of the 
JBoss application server, the Java business components that can be hosted inside JBoss 
and various protocols by which a client application (or other business components) can 
interact with the business components is defined by the <a class="link" 
href="http://java.sun.com/products/ejb/docs.html";>Enterprise JavaBeans 
specification</a>.</p>
  -<p class="text">JBoss 2 is designed to be an EJB v1.1 container and server. There 
are efforts underway currently to extend the support to EJB v2.0 but the work isn't 
expected to begin before Q4 2000. The JBoss server is developed in the Open Source 
tradition by volunteers and sponsors using 100% Pure Java.&nbsp;</p>
  -<p class="text">We are working very hard to ensure that JBoss rightfully becomes 
<i>the</i> premier EJB server for the Java 2 Enterprise Edition.</p>
  -<p class="text">Back to <a class="link" href="#top_of_faq">FAQ Contents</a></p>
  -<h3><a name="FAQ-JBOSS-BENEFITS"></a>What are the benefits of JBoss ?</h3>
  -<p class="text">Lots, here is an initial list:</p><ul>                              
                                         
  -<li>dynamic &quot;hot&quot; deploy                                                  
                 
  -<li>proxy based EJBs                                                                
 
  -<li>configurable container                                                          
         
  -<li>small footprint                                                                 
 
  -<li>JMX based architecture                                                          
         
  -<li>&quot;full&quot; J2EE implementation / integration                              
                                         
  -<li>large, active developer and user community                                      
                                 
  -<li>free speech _and_ free beer</ul>
  -
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-COMPLIANCE"></a>Is JBoss in compliance with the current EJB 
spec ?</h3>
  -<p class="text">Yes. JBoss is <a class="link" href="jboss-test.jsp">being 
continuously   tested</a> for compliance with the <a class="link" 
href="http://java.sun.com/products/ejb/docs.html";>EJB   2.0 specification</a>.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ  
Contents</a>&nbsp;</p>
  -<h3><a name="FAQ-JBOSS-COMMUNITY"></a>What is the JBoss community ?</h3>
  -<p class="text">The JBoss community is a pool of contributors working on <b>joint 
J2EE projects</b> much like the &quot;Apache group&quot; of Apache Server fame. JBoss 
people come from all over the world... 'Silicon Valley' California, London and the 
rest of the UK, France, Sweden, Siberia, Hong Kong, Singapore, Australia and there's 
even a few from the 'Tropical Antarctic' (otherwise known as New Zealand).</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-OBTAIN"></a>How can I get a copy of JBoss ?</h3><ul>  
  -<li>Binary: From the JBoss project's <a class="link" 
href="http://www.jboss.org/";>homepage</a>,     there is a link to JBoss <a 
class="link" href="binary.jsp">binary distributions</a>     for JDK 1.2.2 and JDK 1.3 
JVMs.   
  -<li>Source: From the <a href="cvs.jsp">JBoss CVS repository</a>. The JBoss source   
  code is in CVS and this route is more appropriate for developers and seasoned     
JBoss pros. Please note that you will need to build this version before it     can be 
used. </ul>
  -
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-INSTALL"></a>How do I install JBoss ?</h3>
  -<p class="text">If you download the binary, you can use these <a class="link" 
href="../documentation/HTML/ch01s05.html">instructions</a>.</p>
  -<p class="text">There is information available for installing JBoss on Linux and 
Windows.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-SELL"></a>Can I sell JBoss ?</h3>
  -<p class="text">Yes, and many do. Many bundle it with J2EE applications for 
example.</p>
  -<p class="text">If you want to sell *only* JBoss, then you need to ask &quot;what 
is the value add&quot;? Just putting it on a CD and selling may not get you many 
customers if they can download it from the net just as easy.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ 
Contents</a>&nbsp;</p>
  -<h3><a name="FAQ-JBOSS-DISTRIBUTE"></a>Can I include JBoss in my distribution ?</h3>
  -<p class="text">Yes JBoss is licensed under the LGPL.  Which means that you are 
entitled to redistribute our binary (our jar) free of charge without modifications.  
You can distribute your code under any license you wish.  If you need modifications of 
the core JBoss code, talk to us.
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-SURVIVAL"></a>How does JBoss survive ?</h3>              
  -<p class="text">JBoss is an open source project. It came into existence             
    due entirely to the generosity of a small but growing group of                 
very talented and prolific software developers and architects                 who 
designed, developed and continue to improve the suite of J2EE                 
application servers available from this website. The project has                 
survived up to this point because this group has remained dedicated                 
and invested significant resources into the project. As a result                 the 
project has thrived and an equally dedicated community of                 users 
continue to grow around it at a phenomenal rate.              
  -<p class="text">Today JBoss, is a large and successful open source project with   
the binary distributions available on the site being downloaded over 500 times   
everyday. A project of this size only survives because <i>everyone</i> in the   
project's community actively contribute to it's future. There are many forms   of 
contributions including financial or equipment donations, technical skills in software 
development   and testing and, insightful wisdom and real-life feedback as technical 
authors   and documenters. <i>What are you going to contribute?</i> 
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                 
Contents</a>               
  -<h3><a name="FAQ-JBOSS-IIOP"></a>Does JBoss support RMI/IIOP ?</h3>
  -<p class="text">No. We do not support RMI/IIOP or OTS.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-SOAP"></a>Does JBoss support SOAP ?</h3>
  -<p class="text">Yes, look at the <a class="link" href="jboss-zoap.jsp">ZOAP 
module</a>.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-RMH"></a>How do I make the RMH samples work ?</h3>
  -<p class="text"><a class="link" href="mailto:[EMAIL PROTECTED]";>Ken Jenks</a> has 
gotten the examples to work, so take a look at <a class="link" 
href="http://abiblion.com/products-jboss.html"; target="_new">his work</a>.
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-JDKS"></a>Are there any functional differences between 
jdk1.2 and jdk1.3 ?</h3>
  -<p class="text">None have been identified.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-PERFORMANCE"></a>Any benchmark or performance metrics 
available ?</h3>
  -<p class="text">Not yet, we are working on ECPerf, the benchmark released by 
SUN.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>
  -<h3><a name="FAQ-JBOSS-REMOTE"></a>How do I get my client working from a remote 
machine ?</h3>
  -<p class="text">This is a very common question and there are a couple options. The 
key is to provide the correct server into the environment so that InitialContext 
performs its lookup on the correct machine. One option is to set a couple system 
properties with the correct information, another is to hard-code the properties, and a 
third option is to use a standard jndi.properties file. Forget the hard-code option, 
here are the others:</p><ul>
  -<li>System Properties Specify java.naming.factory.initial and 
java.naming.provider.url when you start your client.<br>                        <code> 
java -cp 
$CLASSPATH<br>-Djava.naming.factory.initial=<br>org.jnp.interfaces.NamingContextFactory<br>
 -Djava.naming.provider.url=remote.host.name <br>                     
yourCode.Test</code>          
  -<li>jndi.properties Create a file called jndi.properties with the following two 
lines (and put the jndi.properties file into the classpath of the client): <code> 
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory<br>             
java.naming.provider.url=remote.host.name</code>                                       
                </ul>
  -
  -<p class="text">For both of the options above, the instantiation of the 
InitialContext with use the default constructor: </p><code>    Object reference = 
<br>new InitialContext().lookup( &quot;encryption.NoCrypt&quot; );</code>
  -<p class="text">Obviously, you need to narrow that object reference - this is just 
an example of getting a reference from JNDI.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a></p>   
                                                         
  -<p class="text">&nbsp;</p>
  -<h3><a name="FAQ-JBOSS-EJX"></a>EJX won't start, what's wrong ?</h3>                
                                         
  -<p class="text">The most common problem here is not running EJX from the bin 
directory.</p>                                                          
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a></p>
  -<h3><a name="FAQ-BEANDEV-RUNJAR"></a>How can I run my EJB jar in JBoss ?</h3>       
                                                         
  -<p class="text">Once you have deployed your bean(s), they are ready to be called by 
clients or other beans.</p>                                                            
  
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ  
Contents</a>&nbsp;</p>
  -<h3><a name="FAQ-BEANDEV-GUIDE"></a>Is a programmer's guide available for JBoss 
?</h3>
  -<p class="text">Yes, take a look at the <a class="link" 
href="doco_files/jaws.dtd">JBoss   2.0</a> documentation.</p>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>
  -<h3><a name="FAQ-BEANDEV-RESOURCEPREFIX"></a>When do I need to prefix a lookup with 
&quot;java:comp/env&quot; ?</h3>                                                       
  
  -<p class="text">java:comp/env is used to prefix a resource that the bean is looking 
up in the JNDI naming context. Looking up other bean or resources are examples where 
you would prefix the JNDI name that the resource is bound to with java:comp/env</p>    
                                                                             
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-BEANDEV-ACCESSBEANS"></a>How do I access beans in a different jar 
?</h3>                                                            
  -<p class="text">Basically, accessing or referencing beans in a different jar should 
be the same as if the beans were in the same jar. Configure EJB references as 
described in section 14.3 of EJB 1.1 Spec and use JNDI to find the bean as any other 
resource.</p>                                                         
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>       
                                 
  -<p class="head"><a name="FAQ-ADMIN"></a>SERVER ADMINISTRATOR QUESTIONS
  -<p class="text">
  -<h3><a name="FAQ-ADMIN-START"></a>How                             is JBoss started 
?</h3>                                                            
  -<p class="text">Run the appropriate run script in the bin directory. If your 
environment is setup correctly, you can start JBoss with the command&nbsp;</p>         
                                                                         
  -<pre><code>         java -jar run.jar</code></pre>                                  
                                                 
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-SHUTDOWN"></a>How do I cleanly shutdown JBoss ?</h3>         
                                                 
  -<p class="text">^C and kill &lt;pid&gt; both cause a clean shutdown.</p>            
                                                                         
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-NTSERVICE"></a>How can I set up JBoss as a service in 
Windows NT ?</h3>                                                                      
                 
  -<p class="text">There are several alternatives                             to 
starting JBoss as an NT service.</p>                        
  -<p class="text">                                                                    
         <ul>                                            
  -<li> The <i>contrib</i> module in CVS has an <a 
href="http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/contrib/ntservice/?cvsroot=jboss";>ntservice
                   module</a> that may be used                 
  -<li><a class="link" href="http://www.kcmultimedia.com/javaserv/";>Running            
                     a Java 2 Application as an NT Service</a>                         
    
  -<li><a class="link" href="http://www.eworksmart.com/JNT/";>JNT for                   
              Windows NT/2000</a>                        </ul>                         
                  
  -
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-BOOT"></a>How do I configure JBoss to start when the server 
boots ?</h3>                              
  -<p class="text">For Windows NT see the answer to 
  -<a class="link" href="#FAQ-ADMIN-NTSERVICE">How can I set up JBoss as a 
  -service in Windows NT ?</a>. 
  -For Unix based systems look at the <i>jboss_init_redhat.sh</i> script in the 
  -<i>dist/bin</i> directory.  This is fairly configurable, allowing you to start and 
stop jboss and can be used from the system boot scripts. 
  -For more information see the following message from the mail archives: <a 
class="link" 
href="http://www.mail-archive.com/[email protected]/msg10908.html";>Starting
 JBoss as a service on Linux </a>                                                      
                             
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-SECURITY"></a>How do I configure security with JBoss ?</h3>  
                                                                                 
  -<p class="text">Please have a look at                             <a class="link" 
href="/documentation/HTML/ch07s68.html">Security</a>                             topic 
in the JBoss manual.</p>                                                               
                     
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-DEPLOY"></a>What tasks must be completed to deploy an EJB 
using JBoss ?</h3>                                                          <ul>       
                                                             
  -<li>Compile the bean classes and interfaces.&nbsp;                                  
                                 
  -<li>Create an ejb-jar.xml file by hand or using EJX.&nbsp;                          
                                         
  -<li>If using Entity Beans with CMP, then use EJX to create a jaws.xml file.&nbsp;   
                                                                 
  -<li>If using resources, custom containers, or any other JBoss specific 
configurations, then use EJX to create a jboss.xml file.&nbsp;                         
                                               
  -<li>Finally, jar the .xml files (note that they must be in META-INF parent 
directory) and the .class files for the bean into a jar in the deploy directory.&nbsp; 
                                                                   
  -<li>Classes that the bean imports may be included in the deployed jar, or they can 
be put into the lib/ext directory (via a jar).                                         
                   </ul>                                                               
                    
  -
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-UNDEPLOY"></a>How do I undeploy an application ?</h3>        
                                                 
  -<p class="text">Removing the .jar file from the deploy directory will cause the 
file to be undeployed.</p>                                                             
                      
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-CLUSTER"></a>Can I cluster multiple JBoss servers ?</h3>     
                                                         
  -<p class="text">Not yet. Clustering is under development with JBoss at the present. 
                       
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-DATASOURCE"></a>How do I configure [Database Type] with 
JBoss ?</h3>                                                                           
       
  -<p class="text">Refer to the <a class="link" href="doco_files/jaws.dtd">Manual</a>, 
  which has <a class="link" href="doco_files/jaws.dtd">examples</a> for many common   
databases and <a class="link" href="doco_files/jaws.dtd">procedures</a> for   the 
rest.</p>                                                                              
          
  -<p class="text">Back to <a class="link" href="doco_files/jaws.dtd">FAQ 
Contents</a>&nbsp;</p>                                                                
  -<h3><a name="FAQ-ADMIN-JAWSDTD"></a>Is a DTD available for jaws.xml ?</h3>          
                                                                         
  -<p class="text"><a class="link" href="doco_files/jaws.dtd">Yes</a>.</p>             
                                                                         
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-ADMIN-JBOSSDTD"></a>Is a DTD available for jboss.xml ?</h3>        
                                                                         
  -<p class="text"><a class="link" href="#FAQ-CREDITS">Yes</a>.</p>                    
                                         
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a></p>   
                                                         
  -<p class="text">&nbsp;
  -<p class="head"><a name="FAQ-CONTAINER"></a>CONTAINER DEVELOPER QUESTIONS           
                                                                 
  -<p class="text">                                                             
  -<h3><a name="FAQ-ADMIN-RUN-PATH-WITH-A-SPACE"></a>JBoss won't run when installed in 
a path with spaces ?</h3>                                                              
                          
  -<p class="text">Due to SUN feature (the implementation of URL + the RMI 
classloader) 
  -  JBoss may experience errors when it is run from a path that contains a space 
  -  in it. There is a feature in JBoss that you can enable that will cope with this 
  -  problem. To enable it, add the following MBean configuration section to the 
  -  top of jboss.jcml :</p>    
  -<pre>  &lt;mbean code=&quot;org.jboss.util.FileURLPatch&quot; 
name=&quot;DefaultDomain:service=FileURLPatch&quot;&gt;<br>    &lt;attribute 
name=&quot;Enabled&quot;&gt;true&lt;/attribute&gt;<br>  &lt;/mbean&gt;</pre>
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a></p>   
                                                         
  -<p class="text">&nbsp;
  -<p class="head"><a name="FAQ-CONTAINER"></a>CONTAINER DEVELOPER QUESTIONS           
                                                                 
  -<p class="text">                                                             
  -<h3><a name="FAQ-CONTAINER-SPECS"></a>Where can I find technical specs for the 
JBoss server ?</h3>                                                                    
               
  -<p class="text">The best source for technical information is in the JBoss <a 
class="link" href="doco_files/jaws.dtd">manual</a>.   Specifically, the sections on <a 
class="link" href="/documentation/HTML/ch02.html">Basic   Configuration</a> and <a 
class="link" href="/documentation/HTML/ch07.html">Container   Architecture</a>.</p>    
                    
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-CONTAINER-CONTRIBUTE"></a>How can I contribute to JBoss ?</h3>     
                                                         
  -<p class="text">Unless you have your own ideas, start following jboss-dev and 
getting patches submitted into the sourceforge system. Even if you have your own 
ideas, it helps to get involved in the mailing-list to identify areas of need and 
avoid duplicated (i.e. wasted) effort.</p>                                             
                                     
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ                    
         Contents</a>&nbsp;</p>                                                        
  
  -<h3><a name="FAQ-CONTAINER-HELP"></a>What help exists to help me learn about the 
JBoss source ?</h3>                                                         
  -<p class="text">The <a class="link" href="#FAQ-CONTAINER-SPECS">technical 
information</a> listed above is a great place to start. Don't overlook the mailing 
list archives for the various components. As you get into the code, the jboss-dev 
mailing list is the best place to direct your questions. The javadocs come with the 
binary distribution (in the docs directory), or you can create the javadocs from the 
source with 'build javadocs'.</p>                                                      
      
  -<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a>       
                 
  -<p class="head"><a name="FAQ-HISTORY"></a>REVISION HISTORY              
  -<p class="text">               <table border="0" width="90%" align="center">        
        <tr>                   <td width="15%" style="background-color: 
#808080"><b>&nbsp;Date</b></td>                  <td width="27%" 
style="background-color: #808080"><b>&nbsp;Author(s)</b></td>                  <td 
width="58%" style="background-color: #808080"><b>Comments</b></td>                
</tr>                <tr>                   <td width="15%" style="background-color: 
#C0C0C0">&nbsp;26-Mar-2000</td>                  <td width="27%" 
style="background-color: #C0C0C0">&nbsp;<a class="link" 
href="mailto:[EMAIL PROTECTED]";>Kunle                     Odutola</a> </td>    
              <td width="58%" style="background-color: #C0C0C0">Created FAQ</td>       
         </tr>                <tr>                   <td width="15%" 
style="background-color: #C0C0C0">23-Aug-2000</td>                  <td width="27%" 
style="background-color: #C0C0C0"><a class="link" 
href="mailto:[EMAIL PROTECTED]";>Jeremiah                     Johnson</a></td>            
      <td width="58%" style="background-color: #C0C0C0">Added questions                
     and answers; reformatted to make simpler to add via text editor;                  
   removed side boxes.</td>                </tr>                <tr>                   
<td width="15%" style="background-color: #C0C0C0">24-Aug-2000</td>                  
<td width="27%" style="background-color: #C0C0C0"><a class="link" 
href="mailto:[EMAIL PROTECTED]";>Kunle                     Odutola</a> </td>    
              <td width="58%" style="background-color: #C0C0C0">Updated answers        
             in FAQ.</td>                </tr>                <tr>                   
<td width="15%" style="background-color: #C0C0C0">13-Feb-2001</td>                  
<td width="27%" style="background-color: #C0C0C0"><a class="link" 
href="mailto:[EMAIL PROTECTED]";>Dewayne                     McNair</a></td>           
       <td width="58%" style="background-color: #C0C0C0">General cleanup.</td>         
       </tr>                <tr>                  <td width="15%" 
style="background-color: #C0C0C0">24-Mar-2001</td>                  <td width="27%" 
style="background-color: #C0C0C0"><a class="link" 
href="mailto:[EMAIL PROTECTED]";>Kunle                     Odutola</a> </td>    
              <td width="58%" style="background-color: #C0C0C0">Broken links           
          and general tidy-up</td>                </tr>              </table>          
    
  -<p class="text">               
  -<p class="text">Back to <a class="link" href="#top_of_faq">FAQ Contents</a>         
 <jsp:include page="navigation.jsp" flush="true" />
  +<jsp:include page="navigation.jsp" flush="true" />
  
  
  

_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development

Reply via email to