Update Authentication Provider
Connect uses a pluggable authentication provider that is deployed in JBoss as a separate module.
The authentication provider is found in kc/import/jboss/connect_auth_jboss.jar.
Since Connect user passwords are encrypted, the authentication provider needs to embed a copy
of the crypto.properties file.
Add the
crypto.properties file to the authentication provider using the following commands:
cd import/jboss
unzip connect_auth_jboss.jar crypto.properties
copy ..\..\crypto.properties .
zip connect_auth_jboss.jar crypto.properties
del crypto.properties
In other words, add
crypto.properties to
connect_auth_jboss.jar.
Note: Do NOT embed the authentication provider module in brickst.war. The
authentication provider will be deployed below as a separate JBoss module.
Create Data Source Definition
Note: The Connect Web Services access the database through a J2EE data source
definition.
The Connect Web Services require a J2EE data source to be defined by the JBoss
application server. Connect includes template data source files in the
import\jboss subdirectory of the Connect install directory.
There are three template data source files:
- connect-mssql-ds.xml
- connect-mysql-ds.xml
- connect-oracle-ds.xml
Copy one of these files (depending on whether you want to configure an Oracle,
SQL Server, or MySQL data source) to the JBoss deployment directory (typically
C:\jboss-4.2.3.GA\server\default\deploy). Then edit the
XML file (connect-mssql-ds.xml or connect-oracle-ds.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 an SQL Server data source, copy the JDBC Driver jar to the JBoss server
directory:
cd import
copy sqljdbc4.jar C:\jboss-4.2.3.GA\server\default\lib
For a MySQL data source, copy the JDBC Driver jar to the JBoss server
directory:
cd import\SQL2005_jdk\common
copy mysql-connector-java-5.1.13-bin.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
copy ojdbc6.jar C:\jboss-4.2.3.GA\server\default\lib
copy orai18n.jar C:\jboss-4.2.3.GA\server\default\lib
Install Connect Authentication Module
The Connect Web Services use container-managed authentication. Thus, an
authentication module needs to be defined in JBoss in order for authentication to
work with the web services.
Install the Connect authentication module by copying the login-config.xml file to the
JBoss deployment directory:
cd import\jboss
copy login-config.xml C:\jboss-4.2.3.GA\server\default\conf
In addition, the
connect_auth_jboss.jar that was updated earlier should be
copied to the JBoss lib directory:
cd import/jboss
copy connect_auth_jboss.jar C:\jboss-4.2.3.GA\server\default\lib
Modify JBoss Properties Service
Modify the properties-service.xml file in the
C:\jboss-4.2.3.GA\server\default\deploy directory:
- Search for the element that starts with <attribute
name="properties">
- Uncomment this element if it is commented out
- Add the following line to the text of the element:
"jndi.ds.prefix=java:"
The edited element should look like this:
<attribute name="Properties">
jndi.ds.prefix=java:
</attribute>
Deploy brickstapi.war to the JBoss Server
Deploy the brickstapi.war file to the JBoss application server by copying it to the
JBoss deployment directory:
copy brickst-jboss.war C:\jboss-4.2.3.GA\server\default\deploy\brickstapi.war
Note
that we rename the file to brickst.war in the deployment directory.
If the JBoss server is listening on port 8080 (the default), start Connect by opening
http://localhost:8080/brickstapi/metadata/version in a browser. The browser should
prompt for login information and should then show the Connect version.