[Jboss-cvs] JBossAS SVN: r55427 - trunk/admin-console
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Tue Aug 8 19:45:46 EDT 2006
Author: chilin
Date: 2006-08-08 19:45:44 -0400 (Tue, 08 Aug 2006)
New Revision: 55427
Removed:
trunk/admin-console/.classpath-production
trunk/admin-console/.classpath-webtest
Modified:
trunk/admin-console/.classpath
trunk/admin-console/.project
trunk/admin-console/README.txt
trunk/admin-console/build.xml
Log:
JBADMCON-145 Rearange jars in the .classpath file to allow production code as well as unit test and webtest to compile/run/debug. Separate .classpath files are no longer needed and thus removed.
Modified: trunk/admin-console/.classpath
===================================================================
--- trunk/admin-console/.classpath 2006-08-08 22:59:12 UTC (rev 55426)
+++ trunk/admin-console/.classpath 2006-08-08 23:45:44 UTC (rev 55427)
@@ -4,31 +4,42 @@
<classpathentry output="output/eclipse/test-classes" kind="src" path="src/test"/>
<classpathentry output="output/eclipse/webtest-classes" kind="src" path="src/webtest"/>
<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
- <classpathentry kind="lib" path="/thirdparty/sun-servlet/lib/servlet-api.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-struts/lib/struts-1.2.6.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-beanutils/lib/commons-beanutils.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-collections/lib/commons-collections.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-digester/lib/commons-digester-1.6.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-discovery/lib/commons-discovery.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-fileupload/lib/commons-fileupload.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-httpclient/lib/commons-httpclient.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-lang/lib/commons-lang-2.0.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-logging/lib/commons-logging.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-pool/lib/commons-pool.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-validator/lib/commons-validator-1.1.3.jar"/>
- <classpathentry kind="src" path="/j2se"/>
- <classpathentry kind="lib" path="/thirdparty/junit/lib/junit.jar"/>
- <classpathentry kind="src" path="/system"/>
- <classpathentry kind="src" path="/varia"/>
- <classpathentry kind="lib" path="/thirdparty/easymock/lib/easymock-1.1.jar"/>
- <classpathentry kind="lib" path="/thirdparty/easymock/lib/easymockclassextension.jar"/>
- <classpathentry kind="lib" path="/thirdparty/struts-test-case/lib/strutstest-2.1.3.jar"/>
- <classpathentry kind="lib" path="/thirdparty/dom4j/lib/dom4j.jar"/>
- <classpathentry combineaccessrules="false" kind="src" path="/j2ee"/>
- <classpathentry kind="lib" path="/thirdparty/hibernate/lib/hibernate3.jar"/>
- <classpathentry combineaccessrules="false" kind="src" path="/hibernate-int"/>
- <classpathentry combineaccessrules="false" kind="src" path="/messaging"/>
- <classpathentry combineaccessrules="false" kind="src" path="/common"/>
- <classpathentry kind="lib" path="/thirdparty/apache-xalan/lib/xalan.jar"/>
+ <classpathentry kind="lib" path="tmp_libs/webtest/commons-collections-3.1.jar"/>
+ <classpathentry kind="lib" path="tmp_libs/webtest/commons-httpclient-3.0.jar"/>
+ <classpathentry kind="lib" path="tmp_libs/webtest/commons-io-1.1.jar"/>
+ <classpathentry kind="lib" path="tmp_libs/webtest/htmlunit-1.8.jar"/>
+ <classpathentry kind="lib" path="tmp_libs/webtest/js-1.6R2.jar"/>
+ <classpathentry kind="lib" path="tmp_libs/webtest/nekohtml-0.9.5.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/commons-codec-1.2.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/lib/endorsed/xercesImpl.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/lib/concurrent.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/client/jnp-client.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/commons-beanutils.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/commons-digester-1.6.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/commons-fileupload.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/commons-lang-2.0.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/commons-logging.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/commons-pool.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/commons-validator-1.1.3.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/cglib.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/ejb3.deployer/asm.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/deploy/jbossweb-tomcat6.sar/servlet-api.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/server/default/lib/hibernate3.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/lib/endorsed/xalan.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/lib/jboss-common.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/lib/dom4j.jar"/>
+ <classpathentry kind="var" path="JBOSS_HOME/lib/jaxen.jar"/>
+ <classpathentry kind="var" path="JBOSS_HEAD/thirdparty/apache-struts/lib/struts-1.2.6.jar"/>
+ <classpathentry kind="var" path="JBOSS_HEAD/thirdparty/apache-log4j/lib/log4j.jar"/>
+ <classpathentry kind="var" path="JBOSS_HEAD/thirdparty/junit/lib/junit.jar"/>
+ <classpathentry kind="var" path="JBOSS_HEAD/thirdparty/easymock/lib/easymock-1.1.jar"/>
+ <classpathentry kind="var" path="JBOSS_HEAD/thirdparty/easymock/lib/easymockclassextension.jar"/>
+ <classpathentry kind="var" path="JBOSS_HEAD/thirdparty/struts-test-case/lib/strutstest-2.1.3.jar"/>
+ <classpathentry sourcepath="JBOSS_HEAD/hibernate-int/src/main" kind="var" path="JBOSS_HOME/server/default/lib/jboss-hibernate.jar"/>
+ <classpathentry sourcepath="JBOSS_HEAD/deployment/src/main" kind="var" path="JBOSS_HOME/server/default/deploy/deployment-service.sar/deployment-service.jar"/>
+ <classpathentry sourcepath="JBOSS_HEAD/system/src/main" kind="var" path="JBOSS_HOME/lib/jboss-system.jar"/>
+ <classpathentry sourcepath="JBOSS_HEAD/j2se/src/main" kind="var" path="JBOSS_HOME/client/jboss-j2se.jar"/>
+ <classpathentry sourcepath="JBOSS_HEAD/j2ee/src/main" kind="var" path="JBOSS_HOME/client/jboss-j2ee.jar"/>
+ <classpathentry sourcepath="JBOSS_HEAD/messaging/src/main" kind="var" path="JBOSS_HOME/server/default/lib/jbossmq.jar"/>
<classpathentry kind="output" path="output/eclipse/classes"/>
</classpath>
Deleted: trunk/admin-console/.classpath-production
===================================================================
--- trunk/admin-console/.classpath-production 2006-08-08 22:59:12 UTC (rev 55426)
+++ trunk/admin-console/.classpath-production 2006-08-08 23:45:44 UTC (rev 55427)
@@ -1,34 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<classpath>
- <classpathentry output="output/eclipse/classes" kind="src" path="src/main"/>
- <classpathentry output="output/eclipse/test-classes" kind="src" path="src/test"/>
- <classpathentry output="output/eclipse/webtest-classes" kind="src" path="src/webtest"/>
- <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
- <classpathentry kind="lib" path="/thirdparty/sun-servlet/lib/servlet-api.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-struts/lib/struts-1.2.6.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-beanutils/lib/commons-beanutils.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-collections/lib/commons-collections.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-digester/lib/commons-digester-1.6.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-discovery/lib/commons-discovery.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-fileupload/lib/commons-fileupload.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-httpclient/lib/commons-httpclient.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-lang/lib/commons-lang-2.0.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-logging/lib/commons-logging.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-pool/lib/commons-pool.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-validator/lib/commons-validator-1.1.3.jar"/>
- <classpathentry kind="src" path="/j2se"/>
- <classpathentry kind="lib" path="/thirdparty/junit/lib/junit.jar"/>
- <classpathentry kind="src" path="/system"/>
- <classpathentry kind="src" path="/varia"/>
- <classpathentry kind="lib" path="/thirdparty/easymock/lib/easymock-1.1.jar"/>
- <classpathentry kind="lib" path="/thirdparty/easymock/lib/easymockclassextension.jar"/>
- <classpathentry kind="lib" path="/thirdparty/struts-test-case/lib/strutstest-2.1.3.jar"/>
- <classpathentry kind="lib" path="/thirdparty/dom4j/lib/dom4j.jar"/>
- <classpathentry combineaccessrules="false" kind="src" path="/j2ee"/>
- <classpathentry kind="lib" path="/thirdparty/hibernate/lib/hibernate3.jar"/>
- <classpathentry combineaccessrules="false" kind="src" path="/hibernate-int"/>
- <classpathentry combineaccessrules="false" kind="src" path="/messaging"/>
- <classpathentry combineaccessrules="false" kind="src" path="/common"/>
- <classpathentry kind="lib" path="/thirdparty/apache-xalan/lib/xalan.jar"/>
- <classpathentry kind="output" path="output/eclipse/classes"/>
-</classpath>
Deleted: trunk/admin-console/.classpath-webtest
===================================================================
--- trunk/admin-console/.classpath-webtest 2006-08-08 22:59:12 UTC (rev 55426)
+++ trunk/admin-console/.classpath-webtest 2006-08-08 23:45:44 UTC (rev 55427)
@@ -1,41 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<classpath>
- <classpathentry output="output/eclipse/classes" kind="src" path="src/main"/>
- <classpathentry output="output/eclipse/test-classes" kind="src" path="src/test"/>
- <classpathentry output="output/eclipse/webtest-classes" kind="src" path="src/webtest"/>
- <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
- <classpathentry kind="lib" path="tmp_libs/webtest/htmlunit-1.8.jar"/>
- <classpathentry kind="lib" path="tmp_libs/webtest/commons-collections-3.1.jar"/>
- <classpathentry kind="lib" path="tmp_libs/webtest/commons-httpclient-3.0.jar"/>
- <classpathentry kind="lib" path="tmp_libs/webtest/commons-io-1.1.jar"/>
- <classpathentry kind="lib" path="tmp_libs/webtest/js-1.6R2.jar"/>
- <classpathentry kind="lib" path="tmp_libs/webtest/nekohtml-0.9.5.jar"/>
- <classpathentry kind="lib" path="/thirdparty/jaxen/lib/jaxen.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-xerces/lib/xercesImpl.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-codec/lib/commons-codec-1.2.jar"/>
- <classpathentry kind="lib" path="/thirdparty/sun-servlet/lib/servlet-api.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-struts/lib/struts-1.2.6.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-beanutils/lib/commons-beanutils.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-digester/lib/commons-digester-1.6.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-discovery/lib/commons-discovery.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-fileupload/lib/commons-fileupload.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-lang/lib/commons-lang-2.0.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-logging/lib/commons-logging.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-pool/lib/commons-pool.jar"/>
- <classpathentry kind="lib" path="/thirdparty/apache-validator/lib/commons-validator-1.1.3.jar"/>
- <classpathentry kind="src" path="/j2se"/>
- <classpathentry kind="lib" path="/thirdparty/junit/lib/junit.jar"/>
- <classpathentry kind="src" path="/system"/>
- <classpathentry kind="src" path="/varia"/>
- <classpathentry kind="lib" path="/thirdparty/easymock/lib/easymock-1.1.jar"/>
- <classpathentry kind="lib" path="/thirdparty/easymock/lib/easymockclassextension.jar"/>
- <classpathentry kind="lib" path="/thirdparty/struts-test-case/lib/strutstest-2.1.3.jar"/>
- <classpathentry kind="lib" path="/thirdparty/dom4j/lib/dom4j.jar"/>
- <classpathentry combineaccessrules="false" kind="src" path="/j2ee"/>
- <classpathentry kind="lib" path="/thirdparty/hibernate/lib/hibernate3.jar"/>
- <classpathentry combineaccessrules="false" kind="src" path="/hibernate-int"/>
- <classpathentry combineaccessrules="false" kind="src" path="/messaging"/>
- <classpathentry combineaccessrules="false" kind="src" path="/common"/>
- <classpathentry kind="lib" path="/thirdparty/apache-xalan/lib/xalan.jar"/>
- <classpathentry kind="output" path="output/eclipse/classes"/>
-</classpath>
Modified: trunk/admin-console/.project
===================================================================
--- trunk/admin-console/.project 2006-08-08 22:59:12 UTC (rev 55426)
+++ trunk/admin-console/.project 2006-08-08 23:45:44 UTC (rev 55427)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
- <name>admin-console</name>
+ <name>Admin_Console</name>
<comment></comment>
<projects>
</projects>
@@ -10,31 +10,6 @@
<arguments>
</arguments>
</buildCommand>
- <buildCommand>
- <name>org.eclipse.ui.externaltools.ExternalToolBuilder</name>
- <triggers>auto,full,incremental,</triggers>
- <arguments>
- <dictionary>
- <key>LaunchConfigHandle</key>
- <value><project>/.externalToolBuilders/admin console's builder.launch</value>
- </dictionary>
- </arguments>
- </buildCommand>
- <buildCommand>
- <name>org.eclipse.ui.externaltools.ExternalToolBuilder</name>
- <triggers>auto,full,incremental,</triggers>
- <arguments>
- <dictionary>
- <key>LaunchConfigHandle</key>
- <value><project>/.externalToolBuilders/webtest builder.launch</value>
- </dictionary>
- </arguments>
- </buildCommand>
- <buildCommand>
- <name>com.ibm.sse.model.structuredbuilder</name>
- <arguments>
- </arguments>
- </buildCommand>
</buildSpec>
<natures>
<nature>org.eclipse.jdt.core.javanature</nature>
Modified: trunk/admin-console/README.txt
===================================================================
--- trunk/admin-console/README.txt 2006-08-08 22:59:12 UTC (rev 55426)
+++ trunk/admin-console/README.txt 2006-08-08 23:45:44 UTC (rev 55427)
@@ -1,11 +1,13 @@
----------------------------------------------------------
-Guide for building and developing the JBoss Admin Console
----------------------------------------------------------
+-------------------------------------------------------------------
+Guide for building, developing, and testing the JBoss Admin Console
+-------------------------------------------------------------------
Pre-requisites for building
---------------------------
1) JDK 1.4.x.+
-2) If you haven't already, get a copy of the JBoss HEAD source code. See http://wiki.jboss.org/wiki/PageInfo.jsp?page=CVSRepository for more details.
+
+2) If you haven't already, get a copy of the JBoss HEAD source code. See http://wiki.jboss.org/wiki/Wiki.jsp?page=SVNRepository for more details.
+
3) Build all the jboss modules. Change to the jboss-head/build directory and run:
build
@@ -14,123 +16,126 @@
--------------------------
1) Change to the jboss-head/admin-console directory and run:
build
+
2) The Admin Console WAR file will be at
jboss-head/admin-console/output/ant/lib/admin-console.war
-Deploying to 4.0.x
-------------------
-1) Not available at this time, but will be re-introduced as a priority.
-
-
-Deploying to 5.0.0alpha (i.e. jboss-head)
+Deploying to 5.0.0.Beta (i.e. jboss-head)
-----------------------------------------
This procedure is going to describe the steps needed to deploy the Admin Console to the default configuration of the JBoss instance which is created when the source from jboss-head is built.
1) Ensure the admin-console.war and jboss-head itself, built correctly.
-2) Install the deployment service. Goto jboss-head/build/output/jboss-5.0.0alpha/docs/examples/varia/deployment-service and run:
+2) Install the deployment service. Goto jboss-head/build/output/jboss-5.0.0.Beta/docs/examples/varia/deployment-service and run:
ant install
By default this will install the deployment service into the default configuration
-3) Create the directory for the deployment service to store its files. Goto jboss-head/build/output/jboss-5.0.0alpha/server/default/deploy/ and run:
+3) Create the directory for the deployment service to store its files. Goto jboss-head/build/output/jboss-5.0.0.Beta/server/default/deploy/ and run:
mkdir deployment-service
This directory must be called deployment-service and be underneath /deploy for the Admin Console to work correctly.
-4) Update the deployment service to reference this new directory. Goto jboss-head/build/output/jboss-5.0.0alpha/server/default/deploy/deployment-service.sar\META-INF and edit the jboss-service.xml. Add the following:
+4) Update the deployment service to reference this new directory. Goto jboss-head/build/output/jboss-5.0.0.Beta/server/default/deploy/deployment-service.sar\META-INF and edit the jboss-service.xml. Add the following:
<attribute name="DeployDir">deploy/deployment-service</attribute>
Make sure that the attribute element is not inside comments, . None of the other attribute elements needs to be specified, the default settings are fine.
-4a) Copy the struts library into the shared lib folder. Goto jboss-head/thirdparty/apache-struts/lib and run:
- copy struts-1.2.6.jar "../../../build/output/jboss-5.0.0alpha/server/default/lib/"
-This works around a problem when deploying the Admin Console which appears to be similar to http://jira.jboss.org/jira/browse/JBAS-2072.
-
-5) Start the JBoss instance. Goto jboss-head/build/output/jboss-5.0.0alpha/bin and run:
+5) Start the JBoss instance. Goto jboss-head/build/output/jboss-5.0.0.Beta/bin and run:
run -c default
6) Deploy the Admin Console. Goto jboss-head/admin-console directory and run:
build deploy
-The JBoss AS install root you want to deploy to is specified in jboss-head/admin-console/build.properties, it defaults to ../build/output/jboss-5.0.0alpha. The deploy target will copy the admin-console.war to ./default/deploy relative to this root.
+The JBoss AS install root you want to deploy to is specified in jboss-head/admin-console/build.properties, it defaults to ../build/output/jboss-5.0.0.Beta. The deploy target will copy the admin-console.war to ./default/deploy relative to this root.
7) Open a browser at http://localhost:8080/admin
--------------------------------------------------------------------------------
-Integration with Eclipse 3.0.x [out of date]
+Integration with Eclipse 3.0.x
------------------------------
1) Make sure you have successfully built the Admin Console using the steps above.
-2) Download a copy of JBoss AS 4.0.x from sourceforge and install it.
-3) Add classpath variables to Eclipse. The setting is available at Window>Preferences>Java>Build Path>Classpath variables.
-a) Create a JBOSS_HOME Classpath variable pointing to the root of the JBoss AS install e.g. c:\apps\jboss-4.0.1\.
-This is necessary to avoid including jars built from HEAD which may be incompatible with those in the 4.0.1 installation.
-b) Create a JBOSS_HEAD Classpath variable pointing to the root of the jboss-head checkout that was performed above e.g. c:\sandbox\jboss-head\.
-This is necessary because some required jars are not available standalone in a JBoss AS install, e.g. deployment-service.jar is contained in deployment-service.war.
-4) Update the default JRE to include the endorsed libraries that come with JBoss. The settings are under Window>Preferences>Java>Installed JREs.
-Make sure that the 'Default VM arguments' includes a reference pointing to the endorsed libraries e.g.
- -Djava.endorsed.dirs=C:\usr\apps\jboss\jboss-4.0.1\lib\endorsed
-and that the 4 libraries themselves are added to the 'JRE System Libraries' list, you need to uncheck 'use default system libraries' in order to add them.
-5) Create a new Eclipse project, using File>New>Project...>Java Project and selecting the jboss-head/admin-console folder.
-6) Add CVS integration by right clicking on the project name and choosing Team>Share Project...
+2) Add classpath variables to Eclipse. The setting is available at Window>Preferences>Java>Build Path>Classpath variables.
+ a) Create a JBOSS_HOME Classpath variable pointing to the root of the JBoss appliction server,
+ e.g. c:\jboss-head\build\output\jboss-5.0.0.Beta.
-Unit testing in Eclipse
------------------------
-1) In order to get the StrutsTestCase tests to run correctly you will need to add the following folder to the classpath of the test
- src/resources/admin-console.war
-This is so that StrutsTestCase can find the various struts/tiles configuration files.
-2) Logging is configured via admin-console\src\test\log4j.xml.
+ b) Create a JBOSS_HEAD Classpath variable pointing to the root of the jboss-head checkout
+ that was performed above, e.g. c:\jboss-head.
+ This is necessary because some required jars are not available standalone in a JBoss AS install,
+ e.g. deployment-service.jar is contained in deployment-service.war.
-Integration Tests (webtest) in eclipse
---------------------------------------
+3) Create a new Eclipse project, using File>New>Project...>Java Project and selecting the jboss-head/admin-console folder.
+
+4) Add SVN integration by installing the Subclipse plug-in. Goto the following web site for download, installation, and usage information:
+ http://subclipse.tigris.org/#subclipse
+
+
+Unit test
+---------
+The unit test can be run from the command prompt, or from within Eclipse.
+
+To run the unit test from the command line, Goto jboss-head/admin-console directory and perform one of the following:
+ 1) To run all the unit tests as a suite, enter:
+ build test
+
+ 2) To run a single test, enter:
+ build one-test -Dtest=<class to be tested>
+ e.g. build one-test -Dtest=org.jboss.admin.console.web.struts.datasource.ViewDataSourceActionTest
+
+To run the unit test from within Eclipse, there're also two options:
+ 1) To run all the unit tests as a suite, do the followings from the "Package Explorer":
+ a) Expand the "src/test" package
+ b) Right click on the "org.jboss.admin" package and select Run As>JUnit Test
+ This prevents an AssertionFailedError from being reported against a class in the JUnit framework.
+
+ 2) To run a single test, right click on the test and select Run As>JUnit Test.
+
+
+Logging is configured via admin-console\src\test\log4j.xml.
+
+
+Integration Test (webtest)
+--------------------------
Webtest is an HTML-based JUnit extension that presents webpages
as documents. The integration tests for the console are a suite
of JUnit tests that operate on a console running in the the default
server of the jboss build output.
-Note that the eclipse project as stored in the repository does not
-build the webtest code correctly because of version differences
-between its jarfiles and the main console project.
-Instructions for buiding webtest in eclipse are provided below.
-
-HOWTO: Run the integration tests
- --------------------------------
The webtest can be run from the command prompt, or from within eclipse.
prerequisites for webtest:
$JBOSS_HOME.default_server must be running with the console deployed
for these tests to run. At this time, only the "ports-default" config-
- uration is supported, and only on localhost.
-
-To run the webtest from the command line start the default server,
-then invoke ant with:
-
- "build webtest"
-
-Before building or running webtest from within eclipse, prepare for
-webtest as follows after performing the steps in "Integration with
-eclipse 3.0", above:
-1.) Use eclipse's "Run ... External Tools ... " menu to choose
- "set eclipse classpath for Webtest".
-2.) Use eclipse's "Project Properties" menu to
- enable the "webtest builder".
-3.) Refresh the project.
-
-You can invoke individual tests or run the whole suite of tests by right-
-clicking on the test or package and selecting "Run as ... JUnit test".
-
-Be sure to restore the classpath using "set eclipse classpath for
-production" if you subsequently decide to build the main console code in
-eclipse.
+uration is supported, and only on localhost.
+
+To run the webtest from the command line, start the default server then
+invoke ant with:
+ build webtest
-Web Service Module (no longer required for jboss-head)
-------------------
-Currently, the Web Service module is dependant on 2 cvs patch files for code under jboss-head\webservice.
-To apply the patches please follow these steps:
+To run the webtest from within Eclipse, a VM argument must be set up in
+order to run NoTxDataSourcePageTest.java, XATxDataSourcePageTest.java,
+or the webtest suite as a whole. The following steps show you how to
+set up the launch configuration for the whole webtest. Similar steps
+should be performed if you want to run the above mentioned two tests
+individually.
+ 1) Right click on src/webtest (or the individual test) and select
+ Run As>Run...
-1) Goto http://jira.jboss.com/jira/browse/JBWS-150
-2) Download AxisService.patch and AxisServiceMBean.patch
-3) Apply these cvs patches to their respective files:
+ 2) In the "Create, manage, and run configuration" dialog box, select
+ "JUnit" from the list of Configurations (if not already selected or
+ expanded), then click "New" to create a new JUnit launch configuration.
- jboss-head/webservice/src/main/org/jboss/webservice/AxisService.java
- jboss-head/webservice/src/main/org/jboss/webservice/AxisServiceMBean.java
+ 3) Notice the configuration name is set to "webtest" and the
+ "Run all tests..." option is selected with the source folder set to
+ "src/webtest". (With individual test, the "Run a single test" option
+ should be selected and the test class properly set up.)
+ 4) Click the "Arguments" tab. In the "VM arguments" box, set up an
+ "adminConsole.jboss.home" argument to point at $JBoss_HOME,
+ e.g. enter the following text in the "VM arguments" box:
+
+ -DadminConsole.jboss.home=C:\jboss-head\build\output\jboss-5.0.0.Beta
+
+ 5) Click "Apply" to save the configuration.
+
+ 6) You can then run the test from the "Create, manage, and run configurations"
+ dialog box, or by right clicking on src/webtest (or the individual test) and
+ select Run As>JUnit Test.
\ No newline at end of file
Modified: trunk/admin-console/build.xml
===================================================================
--- trunk/admin-console/build.xml 2006-08-08 22:59:12 UTC (rev 55426)
+++ trunk/admin-console/build.xml 2006-08-08 23:45:44 UTC (rev 55427)
@@ -135,7 +135,7 @@
<include name="struts*.jar" />
</fileset>
<fileset dir="${antlr.antlr.lib}">
- <include name="antlr-2.7.5H3.jar" />
+ <include name="antlr*.jar" />
</fileset>
<fileset dir="${apache.taglibs.lib}">
<include name="jstl*.jar" />
@@ -280,14 +280,7 @@
<!-- Integration Tests (webtest)-->
<!-- ========================== -->
- <!-- Note that the eclipse project as stored in the repository does not -->
- <!-- build the webtest code correctly because of version differences -->
- <!-- between its jarfiles and the main console project. -->
- <!-- Instructions for buiding webtest in eclipse are provided below. -->
-
<!-- =============================================================================== -->
- <!-- = HOWTO: Run the integration tests = -->
- <!-- = = -->
<!-- = Webtest is an HTML-based JUnit extension that presents webpages = -->
<!-- = as documents. The integration tests for the console are a suite = -->
<!-- = of JUnit tests that operate on a console running in the the default = -->
@@ -307,14 +300,7 @@
<!-- = "build webtest" = -->
<!-- = = -->
<!-- = FROM WITHIN ECLIPSE = -->
- <!-- = Prepare for webtest: = -->
- <!-- = 1.) Use eclipse's "Run ... External Tools ... " menu to choose = -->
- <!-- = "set eclipse classpath for Webtest". = -->
- <!-- = 2.) Use eclipse's "Project Properties" menu to = -->
- <!-- = enable the "webtest builder". = -->
- <!-- = = -->
- <!-- = Be sure to restore the classpath using "set eclipse classpath for = -->
- <!-- = production" to build the main console code. = -->
+ <!-- = See readme.txt for details. = -->
<!-- =============================================================================== -->
<!-- ==== classpath for compiling and running webtests ====-->
More information about the jboss-cvs-commits
mailing list