Error: Could not locate CentovaCast system files.

Question:

When I try to use Centova Cast, I see the following error:

Error: Could not locate CentovaCast system files. Please check 
your settings in /path/config.php.

But my settings appear to be correct. How do I fix this?

Answer:

There are several potential causes for this problem. Please check the following in order:

  1. Ensure that the configuration file mentioned in the error message contains a valid SYSTEM_PATH setting. If the SYSTEM_PATH is set to an incorrect path, correct this and try again.

  2. Ensure that you included a trailing slash in the SYSTEM_PATH setting in the configuration file mentioned in the error message.

  3. Check the diagnostic page. There is a script called diagnostics.php in your Centova Cast web root (i.e., http://www.example.com/cast/diagnostics.php or similar). Launch this page and see if any lines marked Failed are displayed.

  4. If any line other than "Checking CLI interface" reports Failed, then you will need to correct the problem described in the failure report. You should correct the problems one-by-one, starting at the top, and re-load the page each time you correct a problem to see the updated diagnostic report.

  5. If only "Checking CLI interface" reports Failed, then it's likely that there is a problem with your PHP CLI binary. In this case, login via SSH and run the following command:

    php -q /home/centovacast/system/ccmanage.php version check all
    

(Note that the command may appear wordwrapped above, but it should be entered all on one line.) If this command does not display any output, then there is a problem with your PHP CLI binary and you need to have your systems administrator fix this.

If it does display any output (ending with a line that says OK Centova Cast vx.x.x), then try the following command as well:

/home/centovacast/system/runascc/runascc exec ccmanage version check all

(Note that the command may appear wordwrapped above, but it should be entered all on one line.) If this last command does not display any output, then you probably have more than one PHP CLI binary installed on your server, and one of them is broken (and Centova Cast is inadvertently chosing the broken one). You simply need to identify the broken one and remove it. Ask your systems administrator to check the /usr/bin, /usr/local/bin, and /bin directories, identify the bad copy of the PHP CLI binary, and remove it.