BuildForge Help

Configuring Management Console to Use an Alternate Port

You can run Management Console on a port other than the default (80).

To configure Management Console to run on an alternate port:
  1. During installation, set the port to the value you want. If the system is already installed, you can change two settings in <bf-install>/Apache/conf/httpd.conf. For example, if myHost is your local machine and you want to run on port 81:
    • Listen 81
    • ServerName myHost:81
    See also the comments in the httpd.conf file.
    Important: Do not use port 8080; it is the default port for Apache Tomcat.
  2. Start the console and log in as root (or a user name with administrative privileges)
  3. Go to Administration > System . Change the following settings. The example is continued from step 1.
    • Console URL: set to the URL and port that Management Console runs on. In this example it is http://myHost:81. Do not use a trailing slash.
    • QuickReport URL: set to http://myHost:8080/quickReport. Do not use a trailing slash. The Management Console uses this URL to navigate to the Quick Report pages.
  4. Stop and then start the engine.
To make the Build Forge console pages your document root, update the httpd.conf file in Apache, as follows:
  • Set DocumentRoot in Apache httpd.conf to /usr/local/buildforge/ui
  • Modify the Apache httpd.conf and update the directive to point to /usr/local/buildforge/ui