Starting Up JBoss | JBoss: A Developers Notebook

You might expect it to be complicated and time consuming to configure the server and get it running for the first time. JBoss is indeed a complex server, but it's simple to run, configure, and maintain. Later in the book we will see the different kinds of configuration and maintenance options, but for now let's just get JBoss up and running.

How do I do that?

To start JBoss, you'll need to use the run script in the bin directory of the server. There is a run.sh script for use on Unix machines and a run.bat file for Windows. When you run the script, you'll see something like the following output:

Note: If your run.sh file isn't executable, you should chmod the script or invoke it using the sh run.sh command.

     [bin]$ ./run.sh     =========================================================        JBoss Bootstrap Environment       JBOSS_HOME: /Users/samjr/jboss-4.0.2RC1       JAVA: java       JAVA_OPTS: -server -Xms128m -Xmx128m -Dprogram.name=run.sh       CLASSPATH: /Users/samjr/jboss-4.0.2RC1/bin/run.jar:/lib/tools.jar     =========================================================       05:02:58,197 INFO  [Server] Starting JBoss (MX MicroKernel)...     05:02:58,230 INFO  [Server] Release ID: JBoss [Zion] 4.0.2RC1 (build:     CVSTag=JBoss_4_0_2_RC1 date=200503140913)     05:02:58,232 INFO  [Server] Home Dir: /Users/samjr/jboss-4.0.2RC1     05:02:58,233 INFO  [Server] Home URL: file:/Users/samjr/jboss-4.0.2RC1/     05:02:58,235 INFO  [Server] Library URL: file:/Users/samjr/jboss-4.0.2RC1/lib/     05:02:58,238 INFO  [Server] Patch URL: null     05:02:58,256 INFO  [Server] Server Name: default     05:02:58,258 INFO  [Server] Server Home Dir: /Users/samjr/jboss-4.0.2RC1/     server/default     05:02:58,259 INFO  [Server] Server Home URL: file:/Users/samjr/jboss-4.0.     2RC1/server/default/     05:02:58,261 INFO  [Server] Server Data Dir: /Users/samjr/jboss-4.0.2RC1/     server/default/data     05:02:58,262 INFO  [Server] Server Temp Dir: /Users/samjr/jboss-4.0.2RC1/     server/default/tmp     05:02:58,264 INFO  [Server] Server Config URL: file:/Users/samjr/jboss-4.0.     2RC1/server/default/conf/     05:02:58,265 INFO  [Server] Server Library URL: file:/Users/samjr/jboss-4.0.     2RC1/server/default/lib/     05:02:58,267 INFO  [Server] Root Deployment Filename: jboss-service.xml     05:02:58,324 INFO  [Server] Starting General Purpose Architecture (GPA)...             [Lots of startup output removed for brevity]         05:04:05,834 INFO  [TomcatDeployer] deploy, ctxPath=/quote, warUrl=file:/     Users/samjr/jboss-4.0.2RC1/server/default/tmp/deploy/tmp14739quote.war/     05:04:06,348 INFO  [Http11Protocol] Starting Coyote HTTP/1.1 on http-0.0.0.0-8080     05:04:06,868 INFO  [ChannelSocket] JK2: ajp13 listening on /0.0.0.0:8009     05:04:06,956 INFO  [JkMain] Jk running ID=0 time=0/199  config=null     05:04:07,092 INFO  [Server] JBoss (MX MicroKernel) [4.0.2RC1 (build:     CVSTag=JBoss_4_0_2_RC1 date=200503140913)] Started in 1m:7s:977ms

Note: Most of the services in JBoss log output as they start up. Additional log output is available in the server.log file.

That's it! JBoss is up and running. Right there on that last line we have full confirmation that it's up. But just to make sure, go to http://localhost:8080/ in your browser. You should see the JBoss welcome page that looks similar to Figure 1-1.

Developer's Notebook 1-1. JBoss welcome page

Congratulations! Your JBoss server is now running.