Differential D635 Diff 13000 source/administrator-guide/troubleshooting.rst

Changeset View

Standalone View

source/administrator-guide/troubleshooting.rst

	Show First 20 Lines • Show All 76 Lines • ▼ Show 20 Lines
	.. parsed-literal::			.. parsed-literal::
	$config['activesync_debug'] = true;			$config['activesync_debug'] = true;

	Useful messages should then appear in the :file:`/var/log/kolab-syncroton/console` file.			Useful messages should then appear in the :file:`/var/log/kolab-syncroton/console` file.
	If there is no such file, please make sure that your webserver actually has the rights to create this file.			If there is no such file, please make sure that your webserver actually has the rights to create this file.

	It is also possible to debug ActiveSync sessions of individual users only			It is also possible to debug ActiveSync sessions of individual users only
	by creating a :file:`/var/log/syncroton/<username>/` folder			by creating a :file:`/var/log/syncroton/<username>/` folder
	and setting the following configuration parameter.			and enabling `per_user_logging` mentioned above.

	.. parsed-literal::
	$config['activesync_user_debug'] = true;

	Please make sure that this location is writeable by your webserver.			Please make sure that this location is writeable by your webserver.

	iRony			iRony
	-----			-----

	After :ref:`enabling general error logging <troubleshooting_error-logging>`,			After :ref:`enabling general error logging <troubleshooting_error-logging>`,
	you should already find some messages in your webserver's error log.			you should already find some messages in your webserver's error log.

	Additionally, you can enable the debug console			Additionally, you can enable the debug console
	that shows the internal function calls triggered by HTTP requests.			that shows the internal function calls triggered by HTTP requests.

	.. parsed-literal::			.. parsed-literal::
	$config['kolabdav_console'] = true;			$config['kolabdav_console'] = true;

	This will write debug log messages to :file:`/var/log/iRony/console`.			This will write debug log messages to :file:`/var/log/iRony/console`.

	It is also possible to debug DAV sessions of individual users only			It is also possible to debug DAV sessions of individual users only
	by creating a :file:`/var/log/iRony/<username>/` folder			by creating a :file:`/var/log/iRony/<username>/` folder
	and setting the following configuration parameter.			and enabling `per_user_logging` mentioned above.

	.. parsed-literal::
	$config['kolabdav_user_debug'] = true;

	Please make sure that this location is writeable by your webserver.			Please make sure that this location is writeable by your webserver.

	Sometimes it can be useful to track the full HTTP payload of DAV requests.			Sometimes it can be useful to track the full HTTP payload of DAV requests.
	In order to do this, add the following setting.			In order to do this, add the following setting.

	.. parsed-literal::			.. parsed-literal::
	// (bitmask of these values: 2 = HTTP Requests, 4 = HTTP Responses)			// (bitmask of these values: 2 = HTTP Requests, 4 = HTTP Responses)
	$config['kolabdav_http_log'] = 6;			$config['kolabdav_http_log'] = 6;

	In order to enable full HTTP payload logging for single users only,
	you can change the configuration as such:

	.. parsed-literal::
	$config['kolabdav_user_debug'] = true;
	$config['kolabdav_http_log'] = 0;

	Then create the file :file:`/var/log/iRony/<username>/httpraw` and make it writeable by the webserver user.
	The existence of this file will enable HTTP request/response logging for this user while it is disabled for all others.