Configuring JBoss Application Server 6

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

Note

JBOSS_HOME is the folder where JBoss is installed. The SHARE_COMPONENTS folder is a child folder of the core BMC IT Business Management installation folder.

To configure JBoss Application Server 6 after installation

  1. Back up the following files:
    • JBOSS_HOME/standalone/configuration/standalone-full.xml
    • JBOSS_HOME/standalone/configuration/standalone-full-ha.xml
    • JBOSS_HOME/bin/standalone.conf.bat
    • JBOSS_HOME/bin/standalone.conf
  2. Back up the conf and bat directories:
    • JBOSS_HOME/conf
    • JBOSS_HOME/bin
  3. Copy the standalone-full.xml file from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/standalone/configuration folder to the JBOSS_HOME/standalone/configuration folder.
  4. Copy the standalone-full-ha.xml file from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/standalone/configuration folder to the JBOSS_HOME/standalone/configuration folder.
  5. Copy the standalone.conf.bat file from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/bin folder to the JBOSS_HOME/bin folder.
  6. Copy the standalone.conf file from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/bin folder to the JBOSS_HOME/bin folder.
  7. Copy the ehcache.xml file from the SHARE_COMPONENTS/appserver/conf/ folder to the JBOSS_HOME/modules/com/bmc/main/conf folder.
  8. Copy the bmc folder from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/modules/com folder to the JBOSS_HOME/modules/com folder.
  9. Copy the arapi and arutil  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/modules/com/bmc/main folder.
  10. (Oracle) Copy the drivers for Oracle from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/modules/com/oracle folder to the JBOSS_HOME/modules/com/oracle folder.
  11. (Microsoft SQL Server) Copy the drivers for SQL Server from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/modules/com/microsoft folder to the JBOSS_HOME/modules/com/microsoft folder.
  12. (Microsoft SQL Server) Copy the sqljdbc4.jar file from the SHARE_COMPONENTS/sql/driver/mssql/mssql_2008_JDBC_Driver folder to the JBOSS_HOME/modules/com/microsoft/main. 
    After copying, rename it to sqljdbc.jar.
  13. Back up and delete the JBoss patches in the following folders:
    • JBOSS_HOME/modules/org/jboss/as/cmp
    • JBOSS_HOME/modules/org/jboss/as/web
  14. Copy the following JBoss patches:
    • Copy the files from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/modules/org/jboss/as/cmp folder to the JBOSS_HOME/modules/org/jboss/as/cmp folder.
    • Copy the files from the SHARE_COMPONENTS/appserver/jboss-eap-6.0/modules/org/jboss/as/web folder to the JBOSS_HOME/modules/org/jboss/as/web folder.
  15. Copy the itmsoft-jboss6-form.ear file from the SHARE_COMPONENTS/ear folder to the JBOSS_HOME/standalone/deployments folder.
  16. Replace the values in the following files:
    1. In the JBOSS_HOME\bin\standalone.conf.bat file, replace the value of the ITBM_JBOSS_DEFAULT_PROFILE parameter with standalone-full.xml.
    2. In the JBOSS_HOME\bin\standalone.conf.bat file, replace the value of the ITBM_JBOSS_SERVER_PEER_ID parameter with 1.
    3. In the JBOSS_HOME\bin\standalone.conf file, replace the value of the ITBM_JBOSS_DEFAULT_PROFILE parameter with standalone-full.xml.
    4. In the JBOSS_HOME\bin\standalone.conf file, replace the value of the ITBM_JBOSS_SERVER_PEER_ID parameter with 1.
    5. In the JBOSS_HOME\modules\com\bmc\main\module.xml file, replace the value of the AR_API_JAR parameter with the arapi file name copied in preceding steps (for example, arapi80_build001.jar).
    6. In the JBOSS_HOME\modules\com\bmc\main\module.xml file, replace the value of the AR_UTIL_JAR parameter with the arapi file name copied in preceding steps (for example, arapi80_build001.jar).
    7. In the JBOSS_HOME\standalone\configuration\standalone-full.xml file, replace the value of the BMC_ITBM_HTTP_PORT parameter with the port number that will be used to listen for the HTTP requests received from a network.
    8. In the JBOSS_HOME\standalone\configuration\standalone-full.xml file, replace the value of the AR_HOST parameter with BMC Remedy AR System host name.
    9. In the JBOSS_HOME\standalone\configuration\standalone-full.xml file, replace the value of the AR_PORT parameter with BMC Remedy AR System port number.
    10. In the JBOSS_HOME\standalone\configuration\standalone-full.xml file, replace the value of the AR_APPSERVICE_PASSWORD parameter with the encrypted AR Application service password.
    11. In the JBOSS_HOME\bin\standalone.conf.bat file, replace the value of the JAVA_HOME parameter with the actual path to the Java Development Kit.
    12. In the JBOSS_HOME\bin\standalone.conf file, replace the value of the JAVA_HOME parameter with the actual path to the Java Development Kit.
  17. In the JBOSS_HOME\standalone\configuration\standalone-full.xml file, replace the following values:
    1. Replace the values of the ITBM_DB_USER_NAME_1 and ITBM_DB_USER_NAME_2 parameters with the BMC IT Business Management database instance name.
    2. Replace the values of the ITBM_DB_USER_PASSWORD_1 and ITBM_DB_USER_PASSWORD_2 parameters with the BMC IT Business Management database instance password.
  18. Edit the JBOSS_HOME\standalone\configuration\standalone-full.xml file based on the type of your database: 
    • (Oracle)
      1. Delete or comment the lines starting from <!--MSSQL_START--> and ending with <!--MSSQL_END-->.
      2. Replace the ORACLE_URL_1 and ORACLE_URL_2 parameters with the Oracle URL to the BMC IT Business Management database instance in the following format: jdbc:oracle:thin:@host:port:SID

        For example: jdbc:oracle:thin:@localhost:1521:XE
    • (SQL Server)
      1. Delete or comment the lines starting from <!--ORACLE_START--> and ending with <!--ORACLE_END-->.
      2. Replace the MSSQL_URL_1 and MSSQL_URL_2 parameters with the SQL Server URL to the BMC IT Business Management database instance in the following format:
        jdbc:sqlserver://host:port;SelectMethod=cursor;DatabaseName=db_schema 

        For example:
        jdbc:sqlserver://localhost:3133;SelectMethod=cursor;DatabaseName=ITBM

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

  1. Copy the itmsoft-jboss6-form.ear file from the SHARE_COMPONENTS/ear/ folder to the JBOSS_HOME/standalone/deployments folder. 
  2. Replace 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/modules/com/bmc/main folder (deleting the old libraries).
  3. Edit the following values in the JBOSS_HOME\modules\com\bmc\main\module.xml file:
    1. Replace the old AR API file name with the AR API file name copied in the preceding step (for example, arapi80_build001.jar).
    2. Replace the old AR UTIL file name with the AR UTIL file name copied in the preceding step (for example, arutil80_build001.jar).

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*