Updating the buildforge.conf file

The buildforge.conf file is located in two locations. If you need to update it after installation, you must update it in both locations.

You might need to edit the buildforge.conf file to update the database host if your Build Forge® database is moved to a different host computer. Another common reason to edit this file is to update your database password, which must be changed regularly to comply with network security policies.

Use the following procedure to update the buildforge.conf file and then recreate the jas.war file with the updated copy of buildforge.conf.

  1. Stop the Build Forge® engine.
  2. Locate the buildforge.conf file in your Build Forge® installation directory.
    Windows <bfinstall>
    UNIX and Linux <bfinstall>/Platform
  3. Use a text editor to open the file and modify configuration settings, and then save the file.
    Note: You need root or Administrator privileges to edit this file.
  4. Navigate to the directory that contains the jas.war file, for example:
    Apache Tomcat server <bfinstall>/Apache/tomcat/webapps

    $CATALINA_HOME/webapps
  5. Using your preferred archive manager tool, open the jas.war file and find com.ibm.jas-xxx.jar under /WEB-INF/eclipse/plugins/
  6. Update the buildforge.conf file in the com.ibm.jas-xxx.jar and save it.
    Note: Make sure that the jas.war file is set to update automatically.
  7. Under $CATALINA_HOME/webapps and $CATALINA_HOME/work/Catalina/localhost, delete the jas directory using the following examples:
    Windows rmdir jas /s /q
    UNIX/Linux rm -rf jas
  8. Restart the Build Forge® engine.

    The jas file is redeployed and automatically creates the jas directory again with the updated buildforge.conf. file.