If you have followed the directions on this page and are experiencing problems, this document is a guide for troubleshooting general issues.

As a first step in troubleshooting problems, please review the list of known issues.

If you are having issues communicating with the generator controller, see this page for serial troubleshooting steps.

Other than serial communications issues, the most common problem experienced is related to the installation of the required modules. The install script, genmonmaint.sh, is used to install the required libraries need for the generator monitor software. If you install the libraries manually and are experiencing problems, try using the install script. You can run the install script over an existing installation. To install the required libraries, from the genmon directory, type:

bash ./genmonmaint.sh -i

The script will prompt you to install the required libraries, copy configuration files and make the required modifications to start the program on boot.

If you upgrade the software to the latest version and experience problems, first try running the install script listed above as some libraries may have been added since your last software update. If this does not solve the problem, you can use the genmonmaint.sh script to update the installed libraries to the latest version by running this command in the genmon directory:

bash ./genmonmaint.sh -r

If you have tried the above items and are still having issues, you can search existing issues. Be sure to search both closed and open issues. Issues are tagged by topic to make searching for relevant issues easier. If you don't find your solution there, feel free to open a new issue.