ZoneMinder Wiki - User contributions [en]

Zms-inetd

2007-09-27T14:57:14Z

Kz: Script-Version: 2007-09-27

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as <code>/usr/local/bin/zms-inetd</code>. Don't forget to make it executable (<code>chmod 755 /usr/local/bin/zms-inetd</code>).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
<nowiki>http://<server>:85/<anypath></nowiki>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but mask it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass <nowiki>http://127.0.0.1:85;</nowiki>
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS) appropriate (eg: <code>/zm/zms-inetd</code>).

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be too hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Version: 2007-09-27
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.0 500 Internal Server Error"
echo "Content-Type: text/html"
echo
echo "<title>ERROR</title><h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
exit 1
}

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\""
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\""

# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
# (STDERR output is discarded as this confuses MPEG streaming clients)
export QUERY_STRING="$QUERY"
echo "HTTP/1.0 200 OK"
"$ZMS" 2>/dev/null
echo
exit 0</nowiki></pre>

Zms-inetd

2007-09-27T14:55:21Z

Kz: /* Other use cases for zms-inetd */

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as <code>/usr/local/bin/zms-inetd</code>. Don't forget to make it executable (<code>chmod 755 /usr/local/bin/zms-inetd</code>).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
<nowiki>http://<server>:85/<anypath></nowiki>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but mask it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass <nowiki>http://127.0.0.1:85;</nowiki>
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS) appropriate (eg: <code>/zm/zms-inetd</code>).

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be too hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0</nowiki></pre>

Zms-inetd

2007-06-14T19:20:49Z

Kz: /* Make it transparent */

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as <code>/usr/local/bin/zms-inetd</code>. Don't forget to make it executable (<code>chmod 755 /usr/local/bin/zms-inetd</code>).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
<nowiki>http://<server>:85/<anypath></nowiki>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but mask it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass <nowiki>http://127.0.0.1:85;</nowiki>
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS) appropriate (eg: <code>/zm/zms-inetd</code>).

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be to hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0</nowiki></pre>

Utilities

2007-06-14T19:20:19Z

Kz:

[[zms-inetd]] -- Inetd-wrapper for ZMS (Zoneminder Streaming Server), makes ZMS work "standalone"

[[ZM4MS]]<br> - Complete Windows GUI frontend for ZM (requires ZM!) (Please feel free to add to this anyone![James])

[[zm4ms playback|ZM4MS playback with Mandriva 2006 livecd]]

[[xlib_shm]] - allows you to view live streams from zm on local machine with low cpu usage

[[zmxap]] - an xAP connector (to/from home automation applications)

[[Voronwe ZM Frontend]] - Alternate web front end, with enhanced cron/calender integration.

[[ICamviewRelay]] - a small app that allows the ICamview to be used with ZM

[http://xoomer.alice.it/uxguerri/zoneminder.html intellinet550-relay] - a small daemon that allows old Intellinet IP cameras (550550) to be used with ZM. It can also be used to improve frame rate for new (550710) Intellinet IP camera model.

[[ViewMAX]] - a quasi-branch of ZoneMinder, new interface and some added/modified functions

[http://www.mythtv.org/wiki/index.php/MythZoneMinder MythZoneMinder] - a ZoneMinder plugin for MythTV to enable viewing ZM status, monitors, and events.

Zms-inetd

2007-05-31T15:40:23Z

Kz: /* Make it transparent */

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as <code>/usr/local/bin/zms-inetd</code>. Don't forget to make it executable (<code>chmod 755 /usr/local/bin/zms-inetd</code>).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
<nowiki>http://<server>:85/<anypath></nowiki>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but masq it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass <nowiki>http://127.0.0.1:85;</nowiki>
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS) appropriate (eg: <code>/zm/zms-inetd</code>).

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be to hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0</nowiki></pre>

Zms-inetd

2007-05-31T15:39:30Z

Kz: /* Make it transparent */

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as <code>/usr/local/bin/zms-inetd</code>. Don't forget to make it executable (<code>chmod 755 /usr/local/bin/zms-inetd</code>).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
<nowiki>http://<server>:85/<anypath></nowiki>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but masq it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass <nowiki>http://127.0.0.1:85;</nowiki>
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS), for example, to /zm/zms-inetd.

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be to hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0</nowiki></pre>

Zms-inetd

2007-05-31T15:38:52Z

Kz: /* Zoneminder-Configuration */

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as <code>/usr/local/bin/zms-inetd</code>. Don't forget to make it executable (<code>chmod 755 /usr/local/bin/zms-inetd</code>).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
<nowiki>http://<server>:85/<anypath></nowiki>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but masq it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass http://127.0.0.1:85;
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS), for example, to /zm/zms-inetd.

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be to hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0</nowiki></pre>

Zms-inetd

2007-05-31T15:37:25Z

Kz: /* Installation */

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as <code>/usr/local/bin/zms-inetd</code>. Don't forget to make it executable (<code>chmod 755 /usr/local/bin/zms-inetd</code>).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
http://<server>:85/<anypath>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but masq it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass http://127.0.0.1:85;
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS), for example, to /zm/zms-inetd.

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be to hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0</nowiki></pre>

Zms-inetd

2007-05-31T15:35:49Z

Kz:

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as ''/usr/local/bin/zms-inetd''. Don't forget to make it executable (chmod 755 /usr/local/bin/zms-inetd).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
http://<server>:85/<anypath>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but masq it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass http://127.0.0.1:85;
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS), for example, to /zm/zms-inetd.

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be to hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0</nowiki></pre>

Zms-inetd

2007-05-31T15:35:26Z

Kz:

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as ''/usr/local/bin/zms-inetd''. Don't forget to make it executable (chmod 755 /usr/local/bin/zms-inetd).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
http://<server>:85/<anypath>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but masq it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass http://127.0.0.1:85;
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS), for example, to /zm/zms-inetd.

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be to hard to adapt it to ash (default shell in busybox).

== Script ==
<pre><nowiki>#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0</nowiki></pre>

Zms-inetd

2007-05-31T15:23:59Z

Kz:

'''zms-inetd''' is an [http://en.wikipedia.org/wiki/Inetd inetd]-wrapper for the ZMS (Zoneminder Streaming Server), so ZMS can work "standalone".

* '''Author''': Kurt Zankl <kz@xon.uni.cc>
* '''Inspiration''': http://www.debian-administration.org/articles/371
* '''Requirements''': bash, inetd
* '''License''': GNU General Public License, Version 2

== Motivation ==

I'm using Zoneminder with [http://nginx.net/ Nginx Httpd], which doesnt support simple CGI (just FastCGI). So I needed a leightweight solution to make ZMS work without any extra software. This script depends only on inetd and bash.

== Installation and Configuration ==

=== Installation ===

Just copy and paste the zms-inetd-script from below (Section "Script") into a text file and save it, for example, as ''/usr/local/bin/zms-inetd''. Don't forget to make it executable (chmod 755 /usr/local/bin/zms-inetd).

=== /etc/services ===

As for every inetd-service you have to define a port number in /etc/services:
zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper

=== /etc/inetd.conf ===

Of course also an entry in the inetd configuration is needed. Please adapt this to your needs (user [= www], path):
zms-inetd stream tcp nowait www /usr/local/bin/zms-inetd zms-inetd

=== Path to zm.conf ===

Set the ZMCONF variable in the shell-script appropriate.

=== Zoneminder-Configuration ===

The last step is to adjust the web path (URL) to ZMS. This is done through the ZM-Webinterface > Options > Paths > Web path to zms streaming server (ZM_PATH_ZMS). According to the configuration above this would be:
http://<server>:85/<anypath>
It doesn't matter which path you specifiy as zms-inetd will always proxy to the ZMS cgi-binary for security reasons.

== Further thoughts ==

=== Make it transparent ===

In combination with Nginx its propably useful not to point ZM directly to the zms-inetd port, but masq it with a reverse proxy configuration in Nginx. That should avoid some problems if you want to reverse proxy the whole ZM installation (eg: from intranet to the internet).

Example:
location /zm/zms-inetd {
proxy_pass http://127.0.0.1:85;
}

Of course you have to adjust the cgi-bin path (ZM_PATH_ZMS), for example, to /zm/zms-inetd.

=== Other use cases for zms-inetd ===

Another scenario where zms-inetd perhaps could also be used is a leightweight or embedded system, just running ZMS. For example the [http://busybox.net/ busybox] multibinary offers an inetd and a shell. Due the fact that zms-inetd is not heavily integrated with bash it should not be to hard to adapt it to ash (default shell in busybox).

== Script ==
<source lang="shell">
#!/bin/bash
#
# Inetd-wrapper for ZMS (Zoneminder Streaming Server)
#
# Author: Kurt Zankl <kz@xon.uni.cc>
# Inspiration: http://www.debian-administration.org/articles/371
# Requirements: bash, inetd
# License: GNU General Public License, Version 2
#
# /etc/services:
# zms-inetd 85/tcp # Zoneminder ZMS inetd-wrapper
#
# /etc/inetd.conf:
# zms-inetd stream tcp nowait www-data /usr/local/bin/zms-inetd zms-inetd
#
# ZM Options / Paths / Web path to zms streaming server:
# ZM_PATH_ZMS = http://<server>:85/<anypath>
#

# configuration
ZMCONF="/usr/local/etc/zm.conf"
CGIBIN="zms"

# error handler
function errormsg {
echo "HTTP/1.1 200 OK"
echo "Content-Type: text/html"
echo
echo "<h1>ERROR</h1>"
echo -e "<pre>$1</pre>"
echo
exit 1
}

# read ZM configuration
[ -r $ZMCONF ] || errormsg "Error reading Zoneminder configuration \"$ZMCONF\"";
. $ZMCONF
ZMS="$ZM_PATH_CGI/$CGIBIN"
[ -x $ZMS ] || errormsg "Error finding ZMS executable \"$ZMS\"";

# get request
read REQUEST
# skip headers
HEADER="nothing"; while [ "$HEADER" != $'\r' -a -n "$HEADER" ]; do read HEADER; done
# check request
[ -z "$REQUEST" ] && errormsg "Request is empty"

# split request
URL="${REQUEST#GET }"
URL="${URL% HTTP/*}"
QUERY="${URL#*\?}"
URL="${URL%%\?*}"

# check query
[ "$QUERY" == "$URL" ] && errormsg "Invalid query"

# execute ZMS
export QUERY_STRING="$QUERY"
echo "HTTP/1.1 200 OK"
"$ZMS"
echo
exit 0
</source>

Utilities

2007-05-31T14:47:59Z

Kz:

[[zms-inetd]] -- Inetd-wrapper for ZMS (Zoneminder Streaming Server), makes ZMS working "standalone"

[[ZM4MS]]<br> - Complete Windows GUI frontend for ZM (requires ZM!) (Please feel free to add to this anyone![James])

[[zm4ms playback|ZM4MS playback with Mandriva 2006 livecd]]

[[xlib_shm]] - allows you to view live streams from zm on local machine with low cpu usage

[[zmxap]] - an xAP connector (to/from home automation applications)

[[Voronwe ZM Frontend]] - Alternate web front end, with enhanced cron/calender integration.

[[ICamviewRelay]] - a small app that allows the ICamview to be used with ZM

[http://xoomer.alice.it/uxguerri/zoneminder.html intellinet550-relay] - a small daemon that allows old Intellinet IP cameras (550550) to be used with ZM. It can also be used to improve frame rate for new (550710) Intellinet IP camera model.

[[ViewMAX]] - a quasi-branch of ZoneMinder, new interface and some added/modified functions

[http://www.mythtv.org/wiki/index.php/MythZoneMinder MythZoneMinder] - a ZoneMinder plugin for MythTV to enable viewing ZM status, monitors, and events.