zoneminder/distros/fedora
Andy Bauer ead696e5a7 Create zoneminder.f19.spec 2013-09-29 11:26:32 -05:00
..
README.Fedora Update README.Fedora 2013-09-28 15:18:45 -05:00
redalart.wav Add fedora files to zoneminder source tree 2013-09-21 16:36:00 -05:00
zoneminder-1.24.3-runlevel.patch Add fedora files to zoneminder source tree 2013-09-21 16:36:00 -05:00
zoneminder-1.24.4-installfix.patch Add fedora files to zoneminder source tree 2013-09-21 16:36:00 -05:00
zoneminder-1.26.3-dbinstall.patch Add fedora files to zoneminder source tree 2013-09-21 16:36:00 -05:00
zoneminder-1.26.3-noffmpeg.patch Add fedora files to zoneminder source tree 2013-09-21 16:36:00 -05:00
zoneminder.conf Add fedora files to zoneminder source tree 2013-09-21 16:36:00 -05:00
zoneminder.f19.spec Create zoneminder.f19.spec 2013-09-29 11:26:32 -05:00
zoneminder.logrotate Add fedora files to zoneminder source tree 2013-09-21 16:36:00 -05:00
zoneminder.service Add fedora files to zoneminder source tree 2013-09-21 16:36:00 -05:00

README.Fedora

New installs
============

1. Unless you are already using the MySQL server or you are running it
   remotely you will need to ensure that the server is installed and secured:

	yum install mysql-community-server
	--OR--
	yum install mariadb-server

	sudo systemctl enable mysqld

	sudo system start mysqld
     
	mysql_secure_installation

2. Using the password for the root account set during the previous step, you
   will need to create the ZoneMinder database, assuming your database server is local:

     mysql -u root -p < /usr/share/zoneminder/db/zm_create.sql
     mysqladmin reload

3. The database needs a user.  One is not created by default because this would
   introduce an obvious security issue.  The following should set this up:

     mysql -u root -p
     grant select,insert,update,delete on zm.* to 'zmuser'@localhost identified by 'zmpass';

   Obviously, change at least zmpass to an actual, secure password or
   passphrase.  You can change zmuser as well if you like.

4. Edit /etc/zm.conf and, at the bottom, change ZM_DB_PASS and perhaps
   ZM_DB_USER to match.

5. Edit /etc/php.ini, uncomment the date.timezone line, and add your local
   timezone.  For whatever reason, PHP will complain loudly if this is not set,
   or if it is set incorrectly, and these complaints will show up in the
   zoneminder logging system as errors.

   If you are not sure of the proper timezone specification to use, look at
   http://php.net/date.timezone

6. This package probably does not work with SELinux enabled at the moment. It
   may be necessary to disable SELinux for httpd, or even completely for
   ZoneMinder to function. This will be addressed in a later release.  Run

     setenforce 0

   for testing, and edit /etc/sysconfig/selinux to disable it at boot time.

7. IMPORTANT: Edit /etc/httpd/conf.d/zoneminder.conf and/or /etc/httpd/conf.

   The httpd.conf file included with this version of Fedora processes the conf.d
   folder after the default ScriptAlias directive in the httpd.conf file.
   Previously, the conf.d folder was processed before the default ScriptAlias
   directive. This causes a ScriptAlias overlap and breaks Zoneminder's streaming
   abilities.

   Reference: http://httpd.apache.org/docs/2.4/mod/mod_alias.html#order
   Bug Report: https://bugzilla.redhat.com/show_bug.cgi?id=973067

   WORKAROUND #1
   If you are running zoneminder on a dedicated server then the simplest solution
   may be to simply comment out the line in httpd.conf that reads:

	ScriptAlias /cgi-bin/ "/var/www/cgi-bin/"

   WORKAROUND #2
   If you need both the default cgi-bin folder & the zoneminder cgi-bin folder then
   a solution might be to move the following line before the default ScriptAlias
   directive in the httpd.conf file:

	IncludeOptional conf.d/*.conf

8. Now start the web server:

	sudo systemctl enable httpd.service
	sudo systemctl start httpd.service

9. You should immediately visit http://localhost/zm and secure the system if
   it is network facing.  To do this:

   a) click Options, then System.
   b) check OPT_USE_AUTH.
   c) set AUTH_HASH_SECRET to a random string.
   d) click Save and refresh the main browser window.
   e) You should be prompted to log in; the default username/password is admin/admin.
   f) Open Options again, choose the newly visible Users tab.
   g) click the admin user and set a password.
   h) enable OPT_CONTROL on the Ssytem tab to enable ptz camera control.

10. The zoneminder.service file fails at present but the zmpkg.pl script
    can be run as root to start zoneminder.

	sudo zmpkg.pl start

    To start zoneminder automatically, create /etc/rc.d/rc.local and place the 
    following inside it:
	#!/bin/sh
	/usr/bin/zmpkg.pl start 

    The rc.local file must be made executable.

Upgrades
========

1. Update /etc/zm.conf.  Check for any new settings and update the version
   information.  Comparing /etc/zm.conf and /etc/zm.conf.rpmnew should help to
   do this.

2. You will need to upgrade the ZoneMinder database as described in the
   manual. This command should be sufficient when run as root:

     zmupdate.pl --user=root --pass=<mysql_root_pwd> --version=<from version>