Monitoring Distribeast

The Distribeast Monitor

The Distribeast Monitor application displays the status of the current node by changing the appearance of its icon in the system tray.

icon	description
	Indicates that the Distribeast node is currently idle, waiting for a request from the controller.
	Indicates that the Distribeast node is currently processing a job sent by the controller.
	Indicates that the Distribeast node cannot connect to the controller or to the local node. Hover the mouse over the icon for more details.
	Indicates that the Distribeast node has been configured not to accept jobs from the network.
	Indicates that a Distribeast update is available on the controller.
	Indicates that the Distribeast node is attempting to connect to the controller or to the local node.

The dconfig tool

You can use the command-line dconfig tool to view the status of all Distribeast nodes in the current network. You can find this tool in the Distribeast installation directory you set when you installed your Distribeast node.

Network status

You can use the dconfig tool to print a list of all connected nodes. Run the following command:

dconfig -status

Current jobs

You can use the dconfig tool to print a list of all jobs currently running on the Distribeast network, and which computers those jobs are assigned to. Run the following command:

dconfig -consumers

Controller management

You can use the dconfig tool to set which node in the network should be the controller. Run the following command:

dconfig -set controller/address=hostname_or_ip_address

If you want to set the worker node on the local machine to be the controller, you can use the following command instead:

dconfig -set controller/actAsController=[true|false]

Log files

Distribeast writes a detailed record of its operation to log files on disk. You can find these log files at the following locations:

For Windows Vista or later: C:\Windows\ServiceProfiles\NetworkService\AppData\Local\IlluminateLabs\Distribeast.
For Windows XP and Windows Server 2003: C:\Documents and Settings\NetworkService\Local Settings\Application Data\IlluminateLabs\Distribeast.

In networks with large amounts of Distribeast activity, these log files can grow quickly. Distribeast uses a circular log: when the files reach their maximum size, the oldest records are overwritten by newer records. The default maximum size for any single log file is 50 MB. The default maximum size for all log files together is 250 MB.