User: mnf999
Date: 01/06/14 10:27:34
Added: . faq.jsp
Log:
faq file
Revision Changes Path
1.1 newsite/faq.jsp
Index: faq.jsp
===================================================================
<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>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> 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>
<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"><a class="link" href="#Definitions" name="FAQ-SECTION-BEANDEV">BEAN
DEVELOPERS QUESTIONS</a>
<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 "java:comp/env" ?</a>
<li><a class="link" href="#FAQ-BEANDEV-ACCESSBEANS">How do I access beans in a
different jar ?</a>
</ul>
<p class="head"><a class="link" href="#Definitions" name="FAQ-SECTION-ADMIN">SERVER
ADMINISTRATION QUESTIONS</a>
<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>
</ul>
<p class="head">'<a class="link" href="#Definitions"
name="FAQ-SECTION-SRVDEV">CONTAINER DEVELOPER QUESTIONS</a>
<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 Ö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 application server. </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>
<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> </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. </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">"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)."<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. </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
"hot" deploy
<li>proxy
based EJBs
<li>configurable container
<li>small
footprint
<li>JMX based
architecture
<li>"full" 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.html">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> </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 "Apache group" 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.htm">binary distributions</a> for JDK 1.2.2 and JDK 1.3 JVMs.
<li>Source: From the <a href="cvs.html">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 also detailed information available for installing JBoss on
<a class="link" href="../documentation/jboss_linux_trail_index.html">
Linux</a> and <a class="link" href="../documentation/jboss_win32_trail_index.html">
Windows</a>.</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 "what is
the value add"? 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> </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 (please contact the
the <a href="team.html">JBoss Board</a>), 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.html">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(
"encryption.NoCrypt" );</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"> </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> </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="/documentation/HTML/index.html">JBoss 2.0</a> documentation.</p>
<p class="text">Back to <a class="link" href="#FAQ_CONTENTS">FAQ
Contents</a> </p>
<h3><a name="FAQ-BEANDEV-RESOURCEPREFIX"></a>When do I need to prefix a lookup with
"java:comp/env" ?</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> </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 </p>
<pre><code> java -jar run.jar</code></pre>
<p class="text">Back to <a class="link"
href="#FAQ_CONTENTS">FAQ
Contents</a> </p>
<h3><a
name="FAQ-ADMIN-SHUTDOWN"></a>How do I cleanly shutdown JBoss ?</h3>
<p class="text">^C and
kill <pid> both cause a clean shutdown.</p>
<p class="text">Back to <a class="link"
href="#FAQ_CONTENTS">FAQ
Contents</a> </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> </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, see the following message from
the mail archives: <a class="link"
href="http://www.mail-archive.com/jboss-user@list.working-dogs.com/msg10908.html";>Starting
JBoss as a service on Linux </a>
<p class="text">Back to <a class="link"
href="#FAQ_CONTENTS">FAQ
Contents</a> </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> </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.
<li>Create an
ejb-jar.xml file by hand or using EJX.
<li>If using
Entity Beans with CMP, then use EJX to create a jaws.xml file.
<li>If using
resources, custom containers, or any other JBoss specific configurations, then use EJX
to create a jboss.xml file.
<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.
<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> </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> </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> </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="/documentation/HTML/index.html">Manual</a>,
which has <a class="link"
href="/documentation/HTML/ch03.html">examples</a>
for many common databases and <a class="link"
href="/documentation/HTML/ch03s05.html">procedures</a>
for the rest.</p>
<p class="text">Back to <a class="link"
href="#FAQ_CONTENTS">FAQ
Contents</a> </p>
<h3><a
name="FAQ-ADMIN-JAWSDTD"></a>Is a DTD available for jaws.xml ?</h3>
<p class="text"><a class="link"
href="/documentation/jaws.dtd">Yes</a>.</p>
<p class="text">Back to <a class="link"
href="#FAQ_CONTENTS">FAQ
Contents</a> </p>
<h3><a
name="FAQ-ADMIN-JBOSSDTD"></a>Is a DTD available for jboss.xml ?</h3>
<p class="text"><a class="link"
href="/documentation/jboss.dtd">Yes</a>.</p>
<p class="text">Back
to <a class="link" href="#FAQ_CONTENTS">FAQ Contents</a></p>
<p class="text">
<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="/documentation/HTML/index.html">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> </p>
<h3><a
name="FAQ-CONTAINER-CONTRIBUTE"></a>How can I contribute to JBoss ?</h3>
<p class="text">Unless
you have your own ideas, send mail to <a class="link"
href="mailto:[EMAIL PROTECTED]?subject=%22I%20want%20to%20help%20JBoss!%22";>the
board</a> indicating your interests. 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> </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> Date</b></td>
<td width="27%" style="background-color:
#808080"><b> Author(s)</b></td>
<td width="58%" style="background-color:
#808080"><b>Comments</b></td>
</tr>
<tr>
<td width="15%" style="background-color:
#C0C0C0"> 26-Mar-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">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" />
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
http://lists.sourceforge.net/lists/listinfo/jboss-development
