JBossWS - Installation

Version 18

    Installation on JBoss depends on your selected target container. In order to install JBossWS-CXF (JBossWS with Apache CXF integration) or JBossWS-Native, download it and follow these steps:

    1. Copy ant.properties.examples to ant.properties
    2. Modify ant.properties file accordingly. The most important properties are jbossXYZ.home and jbossws.integration.target. (Don't forget to uncomment jbossXYZ.home)
    3. Execute one of the following (replace 'x' by a supported minor version)
    ant -Djboss.server.instance=default deploy-jboss5xx
    ant -Djboss.server.instance=default deploy-jboss6xx
    ant deploy-jboss7xx


    The supported server configurations are default, all and standard. This parameter is not needed for AS 7 series.

    If users omit -Djboss.server.instance JVM property the stack is installed to default configuration.

    Since 3.4 (CXF)

    If you're installing JBossWS-CXF stack and want to install SpringFramework libraries too to the application server, allowing the use of CXF Spring configuration files, please add the -Dspring=true property:

    ant -Dspring=true deploy-jbossXYZ


    After the jbossws-console.war is deployed, you should be able to access JBossWS under http://localhost:8080/jbossws.

    If you have any questions, please post to the User Forum.



    Running the JBossWS samples and building from source

    To build the examples you need JUnit. Download junit-4.X.jar from junit.org and copy into ${JBOSS_HOME}/lib/endorsed.

    Since we currently rely on an external ant installation for the build, you'll need to set the correct ANT_OPTS

      export ANT_OPTS="-Djava.endorsed.dirs=<JBOSS_HOME>/lib/endorsed/" 

    On Windows:

      set ANT_OPTS="-Djava.endorsed.dirs=<JBOSS_HOME>\lib\endorsed"