Troubleshooting errors starting the application server

After installing BMC IT Business Management Suite, if your application server (JBOSS) is generating errors and is not able to start up, then you can follow the procedure in this section to troubleshoot this issue.

You must ensure that the application service password was logged in the configuration file, login-config.xml. If not, then you can add the password manually.

To verify if the application service password was added to the configuration file

1. Open the configuration file login-config.xml.
    The configuration file is located in the JBOSS directory. For example, if you use 4.3 version of JBOSS, you can find the configuration file in the C:\jboss-eap-4.3.0.GA_CP09\jboss-eap-4.3\jboss-as\server\production\conf directory.
2. Search for the following entry:
   <application-policy name="itmRealm">
3. Verify if the application service paswword was added as shown in the following example:
   <module-option name="ar.application.service.password">X0Q4flfWBat7zH2ogKXBNH+k88AuMrJJ==</module-option>

To add the application service password manually to the configuration file

1. Open the installation log file bmcitbm_install_log.txt.
    The log file is located in the temp directory in the installation machine.
2. Search for log event related to module-option name.
    For example, a log event is displayed as follows:
   LOG EVENT {Description=[Syntax will be :],Detail=[<module-option name="ar.application.service.password">X0Q4flfWBat7zH2ogKXBNH+k88AuMrJJ==</module-option>]}
    In this log event, the application service password is logged as X0Q4flfWBat7zH2ogKXBNH+k88AuMrJJ==.
3. Copy the encrypted application service password from the log file.
4. Open the configuration file login-config.xml.
5. Search for the following entry:
   <application-policy name="itmRealm">
6. Add the <module-option name="ar.application.service.password"> entry.
    For example, for the password that you copied in example in step 2, the entry in the configuration file will be:
   <module-option name="ar.application.service.password">X0Q4flfWBat7zH2ogKXBNH+k88AuMrJJ==</module-option>]
   Therefore the updated configuration file has the following content:
   <application-policy name="itmRealm">
   <authentication>
   <login-module code="com.itmsoft.security.auth.module.ITBMLoginModule" flag="required">
   <module-option name="ar.host">vw-snj-rem-qa04</module-option>
   <module-option name="ar.tcpport">0</module-option>
   <module-option name="unauthenticatedIdentity">itmjms</module-option>
   <module-option name="ar.application.service.password">X0Q4flfWBat7zH2ogKXBNH+k88AuMrJJ==</module-option>
   </login-module>
   </authentication>
   </application-policy>