Configuring JBoss Application Server 4

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

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

To configure JBoss Application Server 4 after installation

1. Delete the following folders:
   • JBOSS_HOME/server/production/conf
   • JBOSS_HOME/server/production/deploy 
2. Copy the following folders to the JBOSS_HOME/server/production folder. 
   The value of <databaseType> is Oracle or Microsoft SQL Server, based on the database that is used by BMC IT Business Management.
   • SHARE_COMPONENTS/appserver/<databaseType>/conf 
   • SHARE_COMPONENTS/appserver/<databaseType>/deploy
3. 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.
4. Copy 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.
5. Copy the SHARE_COMPONENTS/appserver/conf/ehcache.xml  file to the JBOSS_HOME/server/production/conf folder.
6. Copy the JDBC libraries for the used database (the ojdbc5.jar file for Oracle and the sqljdbc.jar file for SQL Server) to the JBOSS_HOME/server/production/lib folder.
7. Copy the itmsoft-jboss4-form.ear file from SHARE_COMPONENTS/ear/ folder to the JBOSS_HOME/server/production/deploy folder. 
8. In the JBOSS_HOME\server\production\conf\login-config.xml file, edit the following parameters:
   1. Replace the AR_HOST parameter with BMC Remedy AR System server host name.
   2. Replace the AR_PORT parameter with AR System server port number.
   3. Replace the BMC_ITBM_DB_USER parameter with the BMC IT Business Management database user name.
9. For the Oracle database, edit the following values:
   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 contents 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 BMC IT Business Management database connection parameters.
   2. In the JBOSS_HOME\server\production\deploy\oracle-xa-ds.xml  file:
      1. Replace the DBSERVER parameter with the BMC IT Business Management database host name.
      2. Replace the DBINSTANCE parameter with the BMC IT Business Management database Oracle connection identifier.
      3. Replace the DBUSER parameter with the BMC IT Business Management database user name.
10. For the SQL Server database, edit the following values:
    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 contents with the 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 contents with the 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.
11. Edit the following parameters:
    1. In the JBOSS_HOME\bin\run.conf.bat file, replace the JAVA_HOME parameter value with the actual path to the Java Development Kit.
    2. In the JBOSS_HOME\bin\run.conf file, replace the JAVA_HOME parameter value with the actual path to the Java Development Kit.

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

1. 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.
2. Copy the BMC Atrium Single Sign-On libraries as follows:
   1. Open the SHARE_COMPONENTS/atriumssolib/ folder.
   2. Copy all the .jar files to the JBOSS_HOME/server/production/lib folder.
3. Copy the itmsoft-jboss4-form.ear file from the SHARE_COMPONENTS/ear/ file to the JBOSS_HOME/server/production/deploy folder.