Configuring JBoss Application Server 5

This topic describes how to configure the JBoss Application Server version 5 on Linux and Microsoft Windows operating systems.

• • To configure JBoss Application Server 5 after installation
  • To upgrade JBoss Application Server 5 to use a later version of BMC IT Business Management

To configure JBoss Application Server 5 after installation

1. Back up the following folders and files:
   • JBOSS_HOME/server/production/conf
   • JBOSS_HOME/server/production/deploy
   • JBOSS_HOME/server/production/deployers/jbossweb.deployer/web.xml
2. Copy the following folders and files:
   1. Copy the SHARE_COMPONENTS/appserver/conf/ehcache.xml file to the JBOSS_HOME/server/production/conf folder.
   2. Copy all the files from the SHARE_COMPONENTS/appserver/jboss-eap-5.1.1/conf folder to the JBOSS_HOME/server/production/conf folder.
   3. Copy the following files and folders from the SHARE_COMPONENTS/appserver/jboss-eap-5.1.1/deploy folder to the JBOSS_HOME/server/production/deploy folder:
      • ejb2-timer-service.xml
      • profileservice-jboss-beans.xml
      • transaction-jboss-beans.xml
      • (Microsoft SQL Server) mssql-ds.xml
      • (SQL Server) mssql-xa-ds.xml
      • (Oracle) oracle-ds.xml
      • (Oracle) oracle-xa-ds.xml
   4. Copy the following files and folders from the SHARE_COMPONENTS/appserver/jboss-eap-5.1.1/deploy/messaging folder to the JBOSS_HOME/server/production/deploy/messaging folder:
      • destinations-service.xml
      • jms-ds.xml
      • messaging-jboss-beans.xml
      • messaging-service.xml
      • connection-factories-service.xml
      • remoting-bisocket-service.xml
      • (SQL Server) mssql-persistence-service.xml 
      • (Oracle) oracle-persistence-service.xml 
3. Delete the following files:
   1. From the JBOSS_HOME/server/production/conf folder:
      • jax-ws-catalog.xml
      • jacorb.properties
   2. From the JBOSS_HOME/server/production/deploy folder:
      • ROOT.war
      • admin-console.war
      • deploy.last
      • jbossws.sar
      • jmx-console.war
      • httpha-invoker.sar
      • management folder
      • iiop-service.xml
      • hdscanner-jboss-beans.xml
      • uuid-key-generator.sar
      • juddi-service.sar
      • quartz-ra.rar
      • snmp-adaptor.sar
      • ejb3-connectors-jboss-beans.xml
      • ejb3-interceptors-aop.xml
      • ejb3-container-jboss-beans.xml
      • ejb3-timerservice-jboss-beans.xml
      • hsqldb-ds.xml
      • messaging/hsqldb-persistence-service.xml
   3. From the JBOSS_HOME/server/production/deployers folder:
      • seam.deployer folder
      • jbossws.deployer folder
      • ejb3.deployer/META-INF/ejb3-iiop-deployers-jboss-beans.xml
4. Copy the AR API and AR UTIL libraries as follows:
   1. Open the SHARE_COMPONENTS/arlib/ folder.
   2. Copy all the .jar files whose names start with ar to the JBOSS_HOME/server/production/lib folder.
5. Copy the Atrium SSO libraries as follows:
   1. Open the SHARE_COMPONENTS/atriumssolib/ folder.
   2. Copy all the .jar files to the JBOSS_HOME/server/production/lib folder.
6. Copy the JDBC libraries for the used database (ojdbc5.jar for Oracle and sqljdbc.jar for SQL Server) to the JBOSS_HOME/server/production/lib folder.
7. Copy the itmsoft-jboss4-form.ear file from the SHARE_COMPONENTS/ear/ folder to the JBOSS_HOME/server/production/deploy folder.
8. Copy the run.conf and run.conf.bat files from the SHARE_COMPONENTS/appserver/jboss-eap-5.1.1/bin folder to the JBOSS_HOME/bin folder.
9. Find and replace the tokens in the following files:
   1. In the JBOSS_HOME\server\production\conf\login-config.xmlfile:
      1. Replace the AR_HOST token with the BMC Remedy AR System server host name.
      2. Replace the AR_PORT token with the AR System server port number.
      3. Replace the BMC_ITBM_DB_USER token with the BMC IT Business Management database user name.
   2. For the Oracle database:
      1. In the JBOSS_HOME\server\production\deploy\oracle-ds.xml file, find a node by the xpath /datasources/local-tx-datasource/connection-url and replace its content with the jdbc:oracle:thin:@<BMC_ITBM_DB_HOST>:<BMC_ITBM_DB_PORT>:<BMC_DATABASE_ORACLE_CONNECTION_IDENTIFIER> value.
         The values of <BMC_ITBM_DB_HOST>, <BMC_ITBM_DB_PORT>, and <BMC_DATABASE_ORACLE_CONNECTION_IDENTIFIER> are the database connection parameters.
      2. In the JBOSS_HOME\server\production\deploy\oracle-xa-ds.xml file, replace the DBSERVER token with the BMC IT Business Management database host name.
      3. In the JBOSS_HOME\server\production\deploy\oracle-xa-ds.xml file, replace the DBINSTANCE token with the BMC IT Business Management database oracle connection identifier.
      4. In the JBOSS_HOME\server\production\deploy\oracle-xa-ds.xml file, replace the DBUSER token with the BMC IT Business Management database user name.
   3. For the SQL Server database:
      1. In the JBOSS_HOME\server\production\deploy\mssql-ds.xml file, find a node by the xpath /datasources/local-tx-datasource/connection-url and replace its content with jdbc:sqlserver://<BMC_ITBM_DB_INSTANCE_NAME>:<BMC_ITBM_DB_PORT>;SelectMethod=cursor;DatabaseName=<BMC_ITBM_DB_SCHEMA> value.
         
         The values of <BMC_ITBM_DB_INSTANCE_NAME>, <BMC_ITBM_DB_PORT>, and <BMC_ITBM_DB_SCHEMA> are the BMC IT Business Management database connection parameters.
      2. In the JBOSS_HOME\server\production\deploy\mssql-xa-ds.xml file, find a node by the xpath /datasources/local-tx-datasource/connection-url and replace its content with jdbc:sqlserver://<BMC_ITBM_DB_INSTANCE_NAME>:<BMC_ITBM_DB_PORT>;SelectMethod=cursor;DatabaseName=<BMC_ITBM_DB_SCHEMA> value.
         The values of <BMC_ITBM_DB_INSTANCE_NAME>, <BMC_ITBM_DB_PORT>, and <BMC_ITBM_DB_SCHEMA> are the BMC IT Business Management database connection parameters.
   4. In the <JBOSS_HOME>\bin\run.conf.bat file, replace the JAVA_HOME token with the actual path to the Java Development Kit.
   5. In the <JBOSS_HOME>\bin\run.conf file, replace the JAVA_HOME token with the actual path to the Java Development Kit.

To upgrade JBoss Application Server 5 to use a later version of BMC IT Business Management

1. Replace the AR API and AR UTILlibraries as follows:
   1. Open the SHARE_COMPONENTS/arlib/ folder.
   2. Copy all the .jar files whose names start with ar to the JBOSS_HOME/server/production/lib folder (deleting the old libraries).
2. Copy the itmsoft-jboss4-form.ear file from the SHARE_COMPONENTS/ear/ folder to the JBOSS_HOME/server/production/deploy folder.