User: user57
Date: 02/03/07 01:44:23
Modified: src/docs/demo/netboot advanced.jsp index.jsp
Log:
o Filled in some blanks...
Revision Changes Path
1.2 +7 -3 newsite/src/docs/demo/netboot/advanced.jsp
Index: advanced.jsp
===================================================================
RCS file: /cvsroot/jboss/newsite/src/docs/demo/netboot/advanced.jsp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- advanced.jsp 7 Mar 2002 07:41:20 -0000 1.1
+++ advanced.jsp 7 Mar 2002 09:44:23 -0000 1.2
@@ -1,5 +1,5 @@
<jsp:include page="/head.jsp" flush="true" />
-<!-- $Id: advanced.jsp,v 1.1 2002/03/07 07:41:20 user57 Exp $ -->
+<!-- $Id: advanced.jsp,v 1.2 2002/03/07 09:44:23 user57 Exp $ -->
<jsp:include page="/slogan.jsp" flush="true" >
<jsp:param name="SLOGAN" value="Demo > Advanced NetBoot"/>
</jsp:include>
@@ -9,7 +9,9 @@
<jsp:include page="/common/picateam.jsp" flush="true"/>
<p>This page covers some more advanced examples of using <em>NetBoot</em>.
-
+ We expect that you have read the basic example found
+ <a href="index.jsp">here</a> first.
+
<p>The previous example uses the <em>default</em> configuration, which we have
trimmed to contain only the basic components required for server to function.
There is nothing stopping you from deploying more advanced configurations,
@@ -36,7 +38,7 @@
<p>
<ul>
<li><a href="#Full_J2EE">A Full J2EE Container</a>
- <li><a href="#Pet_Store">Pet Store</a>
+ <li><a href="#Pet_Store">Java Pet Store</a>
<li><a href="#What_Next">What Next?</a>
</ul>
@@ -50,6 +52,8 @@
<pre class="command">
./bin/run.sh --netboot http://jboss.sf.net/demo/netboot --config j2ee
</pre>
+
+<p>TODO: Show how to deploy a bean!
<p>[<a href="#Contents">Contents</a>]
1.4 +182 -20 newsite/src/docs/demo/netboot/index.jsp
Index: index.jsp
===================================================================
RCS file: /cvsroot/jboss/newsite/src/docs/demo/netboot/index.jsp,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.jsp 7 Mar 2002 07:41:20 -0000 1.3
+++ index.jsp 7 Mar 2002 09:44:23 -0000 1.4
@@ -1,5 +1,5 @@
<jsp:include page="/head.jsp" flush="true" />
-<!-- $Id: index.jsp,v 1.3 2002/03/07 07:41:20 user57 Exp $ -->
+<!-- $Id: index.jsp,v 1.4 2002/03/07 09:44:23 user57 Exp $ -->
<jsp:include page="/slogan.jsp" flush="true" >
<jsp:param name="SLOGAN" value="Demo > NetBoot"/>
</jsp:include>
@@ -29,6 +29,8 @@
<p>This page only covers the most basic <em>NetBoot</em> usage. For
more examples, have a look at <a href="advanced.jsp">Advanced NetBoot</a>.
+<br clear="all"/>
+
<!-- ==================================================================== -->
<h2><a name="Contents"></a>Contents</h2>
@@ -39,6 +41,7 @@
<li><a href="#Requirements">Requirements</a>
<li><a href="#Getting_the_Binary">Getting the Binary</a>
<li><a href="#Starting_the_Server">Starting the Server</a>
+ <li><a href="#Common_Problems">Common Problems and Solutions</a>
<li><a href="#What_Next">What Next?</a>
</ul>
@@ -62,12 +65,14 @@
<h2><a name="Requirements"></a>Requirements</h2>
+<jsp:include page="/common/picateam.jsp" flush="true"/>
+
<p>To effectivly run the examples below you will need to make sure that
you have:
<ul>
<li>A Java 2 Runtime Environemnt or Developer's Kit version 1.3<sup>*</sup>.
- <li>10-20 megabytes of disk space<sup>**</sup>.
+ <li>2-20 megabytes of disk space<sup>**</sup>.
<li>A web browser (to look at the HTTP admin console).
<li>A chair to sit in so you do not faint and hurt yourself after
seeing how easy this is!
@@ -76,7 +81,11 @@
<p><b>*</b> Newer versions will be supported shortly.
<p><b>**</b> Disk space requirements are for local temporary and state
- data files plus the minimal boot-strap binaries.
+ data files plus the minimal boot-strap binaries. The actual amount
+ is dependent on the configuration used as well as the usage the
+ server is under after booting.
+
+<br clear="all"/>
<p>[<a href="#Contents">Contents</a>]
@@ -91,20 +100,42 @@
<li><a
href="http://jboss.sf.net/demo/netboot/jboss-netboot.tgz";>jboss-netboot.tgz</a>
</ul>
-<p>The extracted archive should look something like this:
+<p>Extract the archive. You can use your favorite unzipping/taring tool.
+ Here are some command line examples for how to extract them:
+
+<pre class="command">
+unzip jboss-netboot.zip
+</pre>
+
+<pre class="command">
+gunzip -c jboss-netboot.tgz | tar xvf -
+</pre>
+
+<p>The extracted archive is about 100k and should look something like this:
<pre class="output">
-README.txt
-LICENSE.txt
-bin/
-bin/run.bat
-bin/run.sh
-bin/run.jar
-bin/shutdown.bat
-bin/shutdown.sh
-bin/shutdown.jar
+jboss-netboot/
+jboss-netboot/bin/
+jboss-netboot/bin/run.bat
+jboss-netboot/bin/run.jar
+jboss-netboot/bin/run.sh
+jboss-netboot/bin/shutdown.bat
+jboss-netboot/bin/shutdown.jar
+jboss-netboot/bin/shutdown.sh
+jboss-netboot/LICENSE.txt
+jboss-netboot/README.txt
</pre>
+<p>The remaining examples assume you are running commands inside of the
+ <tt>jboss-netboot/</tt> directory, so make sure that is the case:
+
+<pre class="command">
+cd jboss-netboot
+</pre>
+
+<p>Also make sure that you set the environment variable JAVA_HOME to the
+ location where your JDK or JRE lives.
+
<p>[<a href="#Contents">Contents</a>]
<!-- ==================================================================== -->
@@ -124,10 +155,65 @@
<a href="Common_Problems">Common Problems</a> for more information.
<pre class="output">
-FIXME
-FIXME
-FIXME
-FIXME
+================================================================================
+
+ JBoss Bootstrap Environment
+
+ JBOSS_HOME: c:\coolstuff\jboss-netboot
+
+ JAVA: /cygdrive/c/java/jdk/bin/java
+
+ JAVA_OPTS: -server -Dprogram.name=run.sh
+
+ CLASSPATH:
c:\coolstuff\jboss-netboot\bin\run.jar;c:\java\jdk1.3.1_02\lib\tools.jar
+
+================================================================================
+
+01:12:05,679 INFO [Server] JBoss Release: JBoss-3.0.0beta2 CVSTag=HEAD
+01:12:05,690 INFO [Server] Home Dir: C:\coolstuff\jboss-netboot
+01:12:05,690 INFO [Server] Home URL: http://jboss.sf.net/demo/netboot/
+01:12:05,690 INFO [Server] Library URL: http://jboss.sf.net/demo/netboot/lib/
+01:12:05,690 INFO [Server] Patch URL: null
+01:12:05,690 INFO [Server] Server Name: default
+01:12:05,690 INFO [Server] Server Home Dir:
C:\coolstuff\jboss-netboot\server\default
+01:12:05,690 INFO [Server] Server Home URL:
http://jboss.sf.net/demo/netboot/server/default/
+01:12:05,690 INFO [Server] Server Data Dir:
C:\coolstuff\jboss-netboot\server\default\db
+01:12:05,690 INFO [Server] Server Temp Dir:
C:\coolstuff\jboss-netboot\server\default\tmp
+01:12:05,690 INFO [Server] Server Config URL:
http://jboss.sf.net/demo/netboot/server/...
+01:12:05,690 INFO [Server] Server Library URL:
http://jboss.sf.net/demo/netboot/server/...
+01:12:05,730 INFO [Server] Starting General Purpose Architecture (GPA)...
+01:12:05,860 INFO [ServiceLibraries] ClassLoaders and ServiceLibraries initialized
+01:12:07,001 INFO [Log4jService] Started
+01:12:07,001 INFO [ServerInfo] Java version: 1.3.1_02,Sun Microsystems Inc.
+01:12:07,001 INFO [ServerInfo] Java VM: Java HotSpot(TM) Server VM
1.3.1_02-b02,Sun...
+01:12:07,011 INFO [ServerInfo] OS-System: Windows 2000 5.1,x86
+01:12:07,061 INFO [ServiceController] Controller MBean online
+01:12:07,132 INFO [MainDeployer] Creating
+01:12:07,202 INFO [MainDeployer] Created
+01:12:07,212 INFO [JARDeployer] Creating
+01:12:07,212 INFO [JARDeployer] Created
+01:12:07,222 INFO [JARDeployer] Starting
+01:12:07,222 INFO [JARDeployer] JarDeployer started
+01:12:07,222 INFO [JARDeployer] Started
+01:12:07,272 INFO [Server] Core system initialized
+01:12:07,422 INFO [MainDeployer] Starting deployment of package:
http://jboss.sf.net/demo/...
+01:12:08,053 INFO [MainDeployer] Starting deployment of package:
http://jboss.sf.net/demo/...
+01:12:08,604 INFO [MainDeployer] Successfully completed deployment of package:
http://...
+01:12:09,305 INFO [MainDeployer] Starting deployment of package:
http://jboss.sf.net/demo/...
+01:12:10,006 INFO [MainDeployer] Successfully completed deployment of package:
http://...
+01:12:11,057 INFO [MainDeployer] Starting deployment of package:
http://jboss.sf.net/demo/...
+01:12:12,179 INFO [MainDeployer] Successfully completed deployment of package:
http://...
+01:12:12,289 INFO [URLDeploymentScanner] Creating
+01:12:12,299 INFO [URLDeploymentScanner] Created
+01:12:12,299 INFO [MainDeployer] Successfully completed deployment of package:
http://...
+01:12:12,299 INFO [MainDeployer] Starting
+01:12:12,299 INFO [MainDeployer] Started
+01:12:12,299 INFO [URLDeploymentScanner] Starting
+01:12:12,319 INFO [AbstractDeploymentScanner$ScannerThread] Running
+01:12:12,389 INFO [MainDeployer] Starting deployment of package:
http://jboss.sf.net/...
+01:12:12,559 INFO [MainDeployer] Successfully completed deployment of package:
http://...
+01:12:12,619 INFO [URLDeploymentScanner] Started
+01:12:12,619 INFO [Server] JBoss (MX MicroKernel) [3.0.0beta2 Date:200203042102]
Started...
</pre>
<p>The above command starts JBoss using the configuration named <tt>default</tt>
@@ -159,9 +245,85 @@
<br clear="all">
-<h3><a name="Common_Problems"></a>Common Problems</h3>
+<p>[<a href="#Contents">Contents</a>]
+
+<!-- ==================================================================== -->
+
+<h2><a name="Common_Problems"></a>Common Problems and Solutions</h2>
+
+<h3>Missing file: /lib/tools.jar</h3>
+
+<p>This usually happens when the environment variable JAVA_HOME has not
+ been set correctly. Make sure this value is valid.
+
+<h3>Invalid URL or Server Down</h3>
+
+<p>When the URL given is not valid or the system serving that URL is down
+ the bootstrap system can not load the required classes or resources.
+ This usually results in the following exception:
+
+<pre class="output">
+java.lang.ClassNotFoundException: org.jboss.system.server.ServerImpl
+ at java.net.URLClassLoader$1.run(URLClassLoader.java:200)
+ at java.security.AccessController.doPrivileged(Native Method)
+ at java.net.URLClassLoader.findClass(URLClassLoader.java:188)
+ at java.lang.ClassLoader.loadClass(ClassLoader.java:299)
+ at java.lang.ClassLoader.loadClass(ClassLoader.java:255)
+ at org.jboss.system.server.ServerLoader.createServer(ServerLoader.java:234)
+ at org.jboss.system.server.ServerLoader.load(ServerLoader.java:217)
+ at org.jboss.Main.boot(Main.java:123)
+ at org.jboss.Main$1.run(Main.java:364)
+ at java.lang.Thread.run(Thread.java:484)
+</pre>
+
+<p>Double check that you have given the proper URL argument to the
+ <tt>--netboot</tt> switch.
+
+<p>Try to browse to the URL with your browser. If your browser can not show
+ you a directory for the files listed there, then the you may be suffering
+ from network failure. Try again in a few minutes, or contact your local
+ network administrator or ISP.
+
+<p>NOTE: We should make this error more descriptive...
+
+<h3>Invalid Configuration Name</h3>
+
+<p>When the configuration name specified via the <tt>--config</tt> switch
+ is invalid configuration files will not be found, causing exceptions
+ like the following:
+
+<pre class="output">
+java.io.FileNotFoundException: Failed to find logj4 configuration: log4j.xml
+ at org.jboss.logging.Log4jService.start(Log4jService.java:165)
+ at org.jboss.logging.Log4jService.preRegister(Log4jService.java:254)
+ at
com.sun.management.jmx.MBeanServerImpl.preRegisterInvoker(MBeanServerImpl.java:2245)
+ at
com.sun.management.jmx.MBeanServerImpl.createMBean(MBeanServerImpl.java:513)
+ at org.jboss.system.server.ServerImpl.doStart(ServerImpl.java:264)
+ at org.jboss.system.server.ServerImpl.start(ServerImpl.java:208)
+ at org.jboss.Main.boot(Main.java:131)
+ at org.jboss.Main$1.run(Main.java:364)
+ at java.lang.Thread.run(Thread.java:484)
+</pre>
+
+<p>Make sure that you have typed the configuration name correctly.
+
+<p>Try to browse to the URL you specified for <tt>--netboot</tt> and see
+ if there is a directory under there named <tt>server/<em>config</em></tt>,
+ where <em>config</em> is replaced by the name you passed on the command
+ line.
+
+<p>NOTE: We should make this error more descriptive...
+
+<h3>Nothing Happens after <tt>JBoss Bootstrap Environment</tt></h3>
+
+<jsp:include page="/common/picateam.jsp" flush="true"/>
-<p>TODO Some common problems... JAVA_HOME, URL typeo, configname typeo
+<p>You may find that it takes a while after seeing
+ <tt>JBoss Bootstrap Environment</tt> for more output to occur. This
+ is most because of the limitations of your network connection.
+ Since most of the server components are loaded from the network when
+ using JBoss <em>NetBoot</em>, when your network connection to the
+ machine serving up the target URL is slow, the system will boot slower.
<p>[<a href="#Contents">Contents</a>]
@@ -170,7 +332,7 @@
<h2><a name="What_Next"></a>What Next?</h2>
<p>To see how powerful JBoss <em>NetBoot</em> is, check out some of the
- more advanced examples <a herf="advanced.jsp">here</a>.
+ more advanced examples <a href="advanced.jsp">here</a>.
<p>[<a href="#Contents">Contents</a>]
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development
