Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

...

  1. Download and install JBoss v4.2.1 as explained in the product documentation guides. From now on the installation directory will be referred as <jboss_home>
  2. Create a copy of the default JBoss v4.2.1 application server. Copy recursively <jboss_home>\server\default to <jboss_home>\server\<your_server_name>
  3. Start the new server by running the run.sh -c <your_server_name> command from the <jboss_home>\bin directory.
  4. Once the server is started, you can verify that it is running by opening a Web browser and pointing it to this URL: http://localhost:8080Image Removed. You should see the JBoss Welcome window and be able to access the JBoss console.
  5. Once the application server is up and running, the next step is to install and configure all the remaining prerequisite software required by the sample application. This step is described in the following section.

...

After extracting the zip file, a loan directory is created. In that directory open the build.properties file and edit the properties to match your environment as shown in the following example:

xml
Code Block
xml
borderStylesolid
titlebuild.properties
xml
## Set the Geronimo 2.0 home here
geronimo.home=<geronimo_home>

## Set XDoclet 1.2.3 Home 
xdoclet.home=<xdoclet_home>

...

The following example shows the JBoss deployment descriptor.

Code Block
xmlxml
borderStylesolid
titlejboss.xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE jboss PUBLIC "-//JBoss//DTD JBOSS 4.0//EN" "http://www.jboss.org/j2ee/dtd/jboss_4_0.dtd">

<jboss>

   <enterprise-beans>

      <entity>
         <ejb-name>Loan</ejb-name>
         <local-jndi-name>Loan</local-jndi-name>
        <method-attributes>
        </method-attributes>
      </entity>

      <session>
         <ejb-name>LoanManager</ejb-name>
         <jndi-name>org.apache.geronimo.samples.loan.ejb.LoanManager</jndi-name>
         <local-jndi-name>LoanManager</local-jndi-name>
        <method-attributes>
        </method-attributes>
      </session>

   </enterprise-beans>

   <resource-managers>
   </resource-managers>
  
</jboss>

Compare it with the contents of the Geronimo deployment plan shown in the following example.

Code Block
xmlxml
borderStylesolid
titleopenejb-jar.xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<openejb-jar xmlns="http://www.openejb.org/xml/ns/openejb-jar-2.1">
	<dep:environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2">
		<dep:moduleId>
			<dep:groupId>org.apache.geronimo.samples</dep:groupId>
			<dep:artifactId>LoanManagerEJB</dep:artifactId>
			<dep:version>1.0</dep:version>
			<dep:type>car</dep:type>
		</dep:moduleId>
		<dep:dependencies/>
		<dep:hidden-classes/>
		<dep:non-overridable-classes/>
	</dep:environment>
	<enterprise-beans>
		<session>
			<ejb-name>LoanManager</ejb-name>
			<ejb-ref>
				<ref-name>ejb/LoanLocal</ref-name>
				<ejb-link>Loan</ejb-link>
			</ejb-ref>
		</session>
		<entity>
			<ejb-name>Loan</ejb-name>			
			<resource-ref>
				<ref-name>jdbc/LoanDataSource</ref-name>
				<resource-link>SystemDatasource</resource-link>
			</resource-ref>
		</entity>
	</enterprise-beans>
</openejb-jar>

...

The Web archive related configuration files give you few more differences.

Code Block
xmlxml
borderStylesolid
titlejboss-web.xml
xml
<?xml version="1.0" encoding="UTF-8"?>


<jboss-web>

	<ejb-local-ref>
		<ejb-ref-name>ejb/LoanManagerLocal</ejb-ref-name>
		<local-jndi-name>LoanManager</local-jndi-name>
	</ejb-local-ref>  
</jboss-web>
Code Block
xmlxml
borderStylesolid
titlegeronimo-web.xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1" xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.1">
  <dep:environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.1">
    <dep:moduleId>
      <dep:groupId>org.apache.geronimo.samples</dep:groupId>
      <dep:artifactId>LoanManagerWeb</dep:artifactId>
      <dep:version>1.0</dep:version>
      <dep:type>car</dep:type>
    </dep:moduleId>
    <dep:dependencies/>	
    <dep:hidden-classes/>
    <dep:non-overridable-classes/>
  </dep:environment>
 
  <naming:ejb-local-ref>
	  <naming:ref-name>ejb/LoanManagerLocal</naming:ref-name>
	  <naming:ejb-link>LoanManager</naming:ejb-link>
  </naming:ejb-local-ref>
	
</web-app>

...