6.3 Deploying Connect Web in RedHat JBoss 4.2.3

Install Software License Key

The brickstlicense.jar file must be stored in the war file:

unzip connectweb.war WEB-INF/lib/brickstlicense.jar
cp import/brickstlicense.jar WEB-INF/lib
zip connectweb.war WEB-INF/lib/brickstlicense.jar

Create Data Source Definition for Connect UI

The Connect UI requires a J2EE data source to be defined by the JBoss application server. Connect includes template data source files in the import/jboss import\jboss subdirectory of the Connect install directory. There are two template data source files:

connect-mssql-ds.xml
connect-oracle-ds.xml

Copy one of these files (depending on whether you want to configure an Oracle or a SQL Server data source) to the JBoss deployment directory (typically /opt/jboss-4.2.3.GA/server/default/deploy C:\jboss-4.2.3.GA\server\default\deploy). Then edit the XML substituting the following values:

%DATABASE_SERVER% - with the name or address of the database server
%DATABASE_NAME% - with the name of the database
%USER% - user name for logging in to database
%PASSWORD% - password logging in to database

Do not modify any other part of the data source definition file.

For a SQL Server data source, copy the JDBC Driver jar to the JBoss server directory:

cd import/SQL2005_jdk/common
cp sqljdbc4.jar /opt/jboss-4.2.3.GA/server/default/lib

cd import\SQL2005_jdk\common
copy sqljdbc4.jar C:\jboss-4.2.3.GA\server\default\lib

For an Oracle data source, copy the JDBC Driver jar to the JBoss server directory:

cd import/Oracle11107_jdk6/common
cp ojdbc6.jar /opt/jboss-4.2.3.GA/server/default/lib    
cp orai18n.jar /opt/jboss-4.2.3.GA/server/default/lib

cd import\Oracle11107_jdk6\common
copy ojdbc6.jar C:\jboss-4.2.3.GA\server\default\lib    
copy orai18n.jar C:\jboss-4.2.3.GA\server\default\lib

Deploy connectweb.war to the JBoss Server

Deploy the connectweb.war file to the JBoss application server by copying it to the JBoss deployment directory:

cp connectweb.war /opt/jboss-4.2.3.GA/server/default/deploy/

copy connectweb.war C:\jboss-4.2.3.GA\server\default\deploy\

If the JBoss server is listening on port 8080 (the default), start Connect by opening http://localhost:8080/connectweb/surveySuccess.jsp in a browser.