Troubleshooting the Startup of the Linux/Unix BRU Server Agent

Making sure the BRU Server Agent is running troubleshooting steps

Perhaps the easiest way for you to check if the BRU Server Agent is running on your Linux/Unix/Mac OS X system is to run a simple command in a terminal window (you may also use the Process Manager on Mac OS X ).  The command you can use to check if the BRU Server Agent is running is:

$ sudo ps ax | grep agent
 

If the Agent process is running, then you will see:

Mac OS X:

$ ps ax | grep agent
376 ?? Ss 0:28.70 /Applications/BRU Server Agent Config Tool.app/Contents/MacOS/agent
19732 s001 R+ 0:00.00 grep agent
$

Linux/Unix:

$ ps ax | grep agent
376 ?? Ss 0:28.70 /usr/local/bru-server/agent
19732 s001 R+ 0:00.00 grep agent
$

At this point, no further troubleshooting is needed as the BRU Server Agent is running correctly and listening for connections on port 14442 as it should. However, if the Agent is not running, then there is some troubleshooting that needs to be done.  If you simply get back the following:

All OS Versions:

$ ps ax | grep agent
19732 s001 R+ 0:00.00 grep agent
$

This means that the BRU Server Agent is not running.  You will need to start the daemon by using the BRU Server Config Tool (Mac OS X) or by command line (Linux/Unix/Mac OS X).

To start the BRU Server Agent, run the following command:

Mac OS X:

$ sudo /usr/local/bru-server/agent
 

Linux/Unix:

$ sudo "/Applications/BRU Server Agent Config Tool.app/Contents/MacOS/agent"
 

That will start the daemon. Now, rerun the "ps ax" command above to make sure that the BRU Server Agent is running.  You should see output in the example provided above.   If it still is not running then start the Agent in foreground mode to see just what's happening.  This will give you insight to errors that are occurring that may be preventing the BRU Server Agent from successfully starting on your system.   You can run the Agent in foreground mode by running:

Mac OS X:

$ sudo "/Applications/BRU Server Agent Config Tool.app/Contents/MacOS/agent --foreground"
 

Linux/Unix:

$ sudo /usr/local/bru-server/agent --foreground
 

When the Agent is starting up, you should see the following output:

All OS Versions:

$ sudo /usr/local/bru-server/agent --foreground
20080709 14:58:03 BRU Server Agent starting (version 1.2.0)
20080709 14:58:03 Built 16:17:53 12/05/2005 on pc-00103
20080709 14:58:03 Bound socket

Note: The built date and time, as well as the machine (pc-00103) may differ on various platforms, but the version and "bound socket" message should appear on all systems.  Remember that a 1.2.0 version of the BRU Server Agent can only run with v1.2.0 BRU Server Server .  If you have an Agent that is running a different version, you will need to correct this by installing the version that matches your BRU Server system.

If you do not see the above message, something is wrong with the BRU Server Agent.  Make sure that you have the correct Agent installed for your platform (i.e. x86 versus x86_64).  For further assistance, please contact TOLIS Group Support (http://support.tolisgroup.com).