Merge pull request #1211 from SteveGilvarry/multiserver-docs

Adding multiserver documentation

distros/fedora/zoneminder.f23.spec

@@ -38,7 +38,7 @@ BuildRequires: gcc gcc-c++ vlc-devel libcurl-devel libv4l-devel
 BuildRequires:  httpd polkit-devel
 %{!?_without_ffmpeg:BuildRequires: ffmpeg}
 
-Requires: httpd php php-gd php-mysql cambozola polkit net-tools psmisc
+Requires: httpd php php-gd php-mysql cambozola polkit net-tools psmisc mod_ssl
 Requires: libjpeg-turbo vlc-core libcurl
 Requires: perl(:MODULE_COMPAT_%(eval "`%{__perl} -V:version`"; echo $version))
 Requires: perl(DBD::mysql) perl(Archive::Tar) perl(Archive::Zip)

docs/installationguide/images/zm-multiserver.xml

@@ -0,0 +1 @@
+<mxfile type="dropbox" userAgent="Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:43.0) Gecko/20100101 Firefox/43.0" version="5.2.7.3" editor="www.draw.io"><diagram>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</diagram></mxfile>

docs/installationguide/index.rst

@@ -10,3 +10,4 @@ Contents:
    debian
    fedora
    centos
+   multiserver

docs/installationguide/multiserver.rst

@@ -0,0 +1,46 @@
+Multi-Server Install
+====================
+
+It is possible to run multiple ZoneMinder servers and manage them from a single interface. To achieve this each zoneminder server is connected to a single shared database server and shares file storage for event data.
+
+.. image:: images/zm-multiserver.png
+
+New installs
+------------
+
+1. Follow the normal instructions for your distro for installing ZoneMinder onto all the ZoneMinder servers in the normal fashion. Only a single database will be needed either as standalone, or on one of the ZoneMinder Servers.
+
+2. On each ZoneMinder server, edit zm.conf. Find the ZM_DB_HOST variable and set it to the name or ip address of your Database Server.
+
+3. Copy the file /usr/share/zoneminder/db/zm_create.sql from one of the ZoneMinder Servers to the machine targeted as the Database Server.
+
+4. Install mysql/mariadb server onto the Database Server.
+
+5. It is advised to run "mysql_secure_installation" to help secure the server.
+
+6. Using the password for the root account set during the previous step, create the ZoneMinder database and configure a database account for ZoneMinder to use:
+
+::
+
+  mysql -u root -p < zm_create.sql
+  mysql -u root -p
+    mysql> grant all on zm.* to 'zmuser'@'%' identified by 'zmpass';
+    mysql> exit;
+  mysqladmin -u root -p reload
+
+The database account credentials, zmuser/zmpass, are arbitrary. Set them to anything that suits your environment.
+Note that these commands are just an example and might not be secure enough for your environment.
+
+7. If you have chosen to change the ZoneMinder database account credentials to something other than zmuser/zmpass, you must now update zm.conf on each ZoneMinder Server. Change ZM_DB_USER and ZM_DB_PASS to the values you created in the previous step.
+
+Additionally, you must also edit /usr/share/zoneminder/www/api/app/Config/database.php in a similar manner on each ZoneMinder Server. Scroll down and change login and password to the values you created in the previous step.
+
+8. All ZoneMinders Servers must share a common events folder. This can be done in any manner supported by the underlying operating system. From the Storage Server, share/export a folder to be used for ZoneMinder events.
+
+9. From each ZoneMinder Server, mount the shared events folder on the Storage Server to the events folder on the local ZoneMinder Server.
+
+NOTE: The location of this folder varies by distro. This folder is often found under "/var/lib/zoneminder/events" for RedHat based distros and "/var/cache/zoneminder/events" for Debain based distros. This folder is NOT a Symbolic Link!
+
+10. Open your browser and point it to the web console on any of the ZoneMinder Servers (they will all be the same). Open Options, click the Servers tab,and populate this screen with all of your ZoneMinder Servers.
+
+11. When creating a new Monitor, remember to select the server the camera will be assigned to from the Server drop down box.