JOH User Manual (split by node): Section: Back: 3.3 Signals Forward: 5. How to Report a Bug Chapter: FastBack: 3. Johd – Jabber Over HTTP Daemon Up: JOH FastForward: 5. How to Report a Bug Doc: Contents: Table of Contents Index: Concept Index   ?

4. Joh.cgi – Auxiliary CGI Utility

If you need to run johd on a box which already runs an HTTP server, it is impossible to have johd handle HTTP connections directly, because port 80 is already in use. The solution then is to use joh.cgi within your HTTP server and to start johd in CGI mode. This approach is discussed in detail in CGI Mode.

The usual way to run joh.cgi is to copy it to your ‘cgi-bin’ directory and to provide an alias for it. For example, in Apache ‘httpd.conf’:

 
Alias /http-poll  /var/www/cgi-bin/joh.cgi

The built-in default configuration is sufficient for most cases. If, however, you need to configure joh.cgi, you can do so via the following environment variables:

JOH_SERVER_URL

Sets the URL of the johd server. Default is ‘127.0.0.1:1100’.

JOH_JABBER_SERVER_URL

Sets the URL of the default Jabber server. This value is used when the incoming HTTP request does not specify server and port explicitly.

The default value is ‘inet://gnu.org.ua’.

JOH_JABBER_SERVER

Specifies the IP address of the default Jabber server.

JOH_JABBER_PORT

Sets the port name of the default Jabber server.

JOH_ERROR_PAGE

If any request other than ‘POST’ arrives, return the contents of the file specified in the value of this variable. See joh.cgi bad request handling.

JOH_ERROR_REDIRECT

If any request other than ‘POST’ arrives, redirect it to the URL supplied in this variable. See joh.cgi bad request handling.

This document was generated by Sergey Poznyakoff on March, 31 2011 using texi2html 1.78.

Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.