Difference between revisions of "System health check"

From Joomdle
Jump to: navigation, search
(Source IP not allowed)
(Joomla URL seems to be misconfigured in Joomdle auth plugin in Moodle)
Line 86: Line 86:
 
* Check any mod_security rules that may deny XMLRPC traffic
 
* Check any mod_security rules that may deny XMLRPC traffic
 
* Disable any Joomla security extensions you may have installed
 
* Disable any Joomla security extensions you may have installed
 +
* Disable any Joomla SEF extensions you may have
  
  

Revision as of 18:18, 28 October 2014

System Health Check

This document applies to Joomdle Release 2.0.0

Joomdle includes a system health check tool in Joomla Component, that helps you ensure that you have met all the prerequisites to have Joomdle working correctly.

System check.png


.

XMLRPC PHP Extension

You need to install/enable the XMLRPC extension in your PHP configuration

If you are working on a dedicated server, you must install the XML-RPC PHP extension. If on shared hosting, you should ask your provider to enable it for you.


.

Allow URL fopen

You need to set PHP option allow_url_fopen to On, on your PHP configuration

If you are working on a dedicated server, you must set PHP option allow_url_fopen to On, on your PHP configuration. If on shared hosting, you should ask your provider to enable it for you.


.

Joomla Web Services (J1.5 only)

You must enable Web Services in Joomla Global Configuration

You must enable Web Services in Joomla Global Configuration, in System->Global Configuration, System tab.


.

Joomdle XMLRPC Plugin enabled (J1.5 only)

You must enable Joomdle XMLRPC Plugin

You must enable the Joomdle XMLRPC Plugin in Joomla backend, Extensions->Manage plugins.


.

Joomdlehooks User Plugin enabled

You must enable Joomdlehooks User Plugin

You must enable the Joomdlehooks User Plugin in Joomla backend, Extensions->Manage plugins.


.

Joomla to Moodle HTTP connectivity

This indicated wheter Joomla can connect to the Moodle connection test script.

It is useful for debugging when Joomdle web services check is failing.

If Joomdle web services check is OK, you can ignore the result of this check. Sometimes it will fail due to security measures in place.


.

Moodle to Joomla HTTP connectivity

This indicated wheter Moodle can connect to the Joomla connection test script.

It is useful for debugging when Joomdle web services check is failing.

If Joomdle web services check is OK, you can ignore the result of this check. Sometimes it will fail due to security measures in place.


.

Joomdle Web Services

It seems the Joomdle auth plugin is not enabled in Moodle

You must enable the Joomdle auth plugin in Moodle Admin->Users->Authentication->Manage Authentication.

Moodle networking is not enabled

You must enable Moodle Networking in Moodle Admin->Networking->Settings

You need to add your site IP to Moodle XML-RPC trusted hosts list

You must add your site IP to the Moodle trusted XML-RPC hosts list, in Moodle Admin->Networking->XML-RPC Hosts

Something is wrong with Joomdle Web Services setup

Something went wrong setting up Joomdle web services in Moodle. Try visiting Notifications page in Moodle Admin->Notifications.

If you get database errors with duplicate keys, try starting over by removing the offending rows/table. Execute these queries in your Moodle database:

  • delete from mdl_config_plugins where plugin like '%joomdle%';
  • delete from mdl_mnet_host2service where hostid=0 and serviceid=4;
  • drop table mdl_joomdle_dummytable

An then, visit Notifications page again.

Moodle Network authentication is not enabled in Moodle

You must enable the Moodle Network auth plugin in Moodle Admin->Users->Authentication->Manage Authentication.

Joomla URL is not configured in Joomdle auth plugin in Moodle

You need to enter Joomla URL in Joomdle auth plugin configuration, in Moodle Admin->Users->Authentication->Joomdle

Joomla URL seems to be misconfigured in Joomdle auth plugin in Moodle

  • Re-check your Joomla URL in Joomdle auth plugin configuration, in Joomdle auth plugin in Moodle.
  • Make sure you include http://
  • Check Joomla multi-language configuration and enter appropiate parameters in Moodle side if necessary
  • Check any mod_security rules that may deny XMLRPC traffic
  • Disable any Joomla security extensions you may have installed
  • Disable any Joomla SEF extensions you may have


You may also want to visit: http::/yoursite.com/index.php?option=com_joomdle&task=ws.server&format=xmlrpc

If everything is working fine, you should see something like:

XML-RPC Error (1): Access Denied

Alternatively, you could see this message, if you are trying from the server IP:

faultString parse error. not well formed. error occurred at line 1, column 1, byte index 0 faultCode -32700 


If you get a different message or a blank page, there is some problem with your server configuration.

Received empty response from Moodle

Usually this caused by a misconfigured Moodle URL in Joomdle component. Double check that it is correct and that it includes http:// in front. If you are sure everything is correct, consider that it may be a connection issue (firewall, etc).

Source IP not allowed

This means your server is using a non-public IP address for Joomla-Moodle connections. You will need to enter the displayed IP address in the "Internal IP address" config option, which can be found in Joomdle general config in Joomla.

E_DEPRECATED errors are enabled in your PHP configuration

You have E_DEPRECATED errors enabled in your PHP configuration. You need to disable them for Joomla web services to work.

Look into your php.ini file and look for the 'error_reporting' directive. If you are on a hosted server you may need to contact your hosting company to modify your PHP configuration.

For example, my local configuration is: error_reporting = E_ALL & ~E_DEPRECATED