How to install JBoss AS and JBoss WS for CA Gen.

Products

• Gen
• Gen - Workstation Toolset
• Gen - Host Encyclopedia
• Gen - Run Time Distributed

Issue/Introduction

Web Services in JBoss are implemented as a set of stacks. Users are free to use whichever stack meets their requirements. When you install JBoss out of the box it comes preconfigured with the native stack. In Gen and Gen Studio we will be using the metro stack.

This information is a guide how to install JBossAS and JBossWS to work with CA Gen Web Services.

Environment

Ant must be installed and working correctly.NOTE: Apache Ant is a Java library and command-line tool whose mission is to drive processes described in build files as targets and extension points dependent upon each other. The main known usage of Ant is the build of Java applications.Java JRE installed.

Resolution

Web Services in JBoss are implemented as a set of stacks. Users are free to use whichever stack meets their requirements. When you install JBoss out of the box it comes preconfigured with the native stack. In Gen and Gen Studio we will be using the metro stack.

Procedure

Unzip the base JBoss GA distribution zip file into a directory
Unzip the GA metro distribution zip file into a directory (different from above)

Follow the instructions in the docs\install.txt document of the metro installation. Only the first 3 steps are necessary. Ensure that step 3 is done using the ant deploy-jboss510 command.

To start JBoss open a DOS window and execute the bin\run.bat command.

Once the system output starts scrolling notice the use of the correct web services metro stack:

some messages...
12:17:00,446 INFO [JMXKernel] Legacy JMX core initialized
12:17:05,863 INFO [ProfileServiceBootstrap] Loading profile: ProfileKey@121c5df
[domain=default, server=default, name=default]
12:17:10,089 INFO [WebService] Using RMI server codebase: http://127.0.0.1:8083
/
12:17:31,259 INFO [AbstractServerConfig] JBoss Web Services - Metro Server
12:17:31,259 INFO [AbstractServerConfig] 3.2.2.GA
12:17:31,259 INFO [AbstractServerConfig] JBoss Web Services - Metro Server
12:17:31,259 INFO [AbstractServerConfig] 3.2.2.GA
12:17:33,973 INFO [AttributeCallbackItem] Owner callback not implemented.
12:17:38,679 INFO [LogNotificationListener] Adding notification listener for logging
mbean "jboss.system:service=Logging,type=Log4jService" to server org.jboss
.mx.server.MBeanServerImpl@1c4bcda[ defaultDomain='jboss' ]
more messages...

To invoke the console:
http://localhost:8080/jmx-console/

Web Services
http://localhost:8080/jbossws/

Default port: 8080

JBoss and NLS Characters

If a CA Gen model contains characters from a codepage other than 1252 you may have to modify certain JBoss configuration files.

%JBOSS_HOME%\bin\run.conf.bat

Add the -Dfile.encoding=UTF-8 VM runtime option to the JAVA_OPTS variable.

%JBOSS_HOME%\server\default\deploy\jbossweb.sar \server.xml

Add the URIEncoding="UTF-8" attribute to the Connector HTTP/1.1 element

Security

Before version 4.2.0 GA JBoss always bound to 0.0.0.0, i.e. any address, by default. For security purposes starting with version 4.2.0 this is no longer the case. Therefore in order to use anything other than localhost as a hostname in the URL to access services JBoss must be started using the -b option. For development and testing purposes use the following command to start JBoss:

run.bat -b 0.0.0.0

Additional Information

Useful links about JBoss and Web Services.
http://www.jboss.org/jbossws