OpenSuse Notes
===============
1. OpenSuse, along with other distros, now use systemd for task control.
One of the capabilties of systemd is to use private space for /tmp to reduce
the possibility of cross talk between applications. The default settings
for zoneminder use /tmp for a number of files. When you start/stop
zoneminder from a web page /tmp will be in private space but when the
start/stop script zmpkg.pl is run from a shell it will be looking in the
real /tmp. This can result in two instances of zoneminder running at
the same time.
In order to remove this problem the OpenSuse rpm defaults the temporary
directory to /var/run/zoneminder. For a new install this will not be a
problem but if you use the rpm to upgrade you may have to make database
changes.
Note: the location is held both within the database an explicitly within some
scripts. It is therefore essential that the database conforms to the values
used in the scripts. Please see information in the Upgrades section of this
document.
2. OpenSuse prefers mariadb to mysql. mariadb is a direct replacement for mysql
and all mysql functions work in the same way. These notes assumes that you
are running mariadb.
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:
To install the database issue the following commands (as root):
zypper in mariadb
systemctl enable mysql
systemctl start mysql.service
mysql_secure_installation
IMPORTANT: mariadb defaults to strict mode of operation which will cause
some zoneminder database writes to fail. In order to turn this off -
which will be for the whole database - you will need to edit
/etc/my.cnf and comment out the record
sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES.
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 -uroot -p < /opt/zoneminder/share/zoneminder/db/zm_create.sql
mysqladmin -uroot -p 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:
mysqladmin -uroot -p reload
grant select,insert,update,delete,alter 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/php5/apache2/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. Now start the web server (as root):
systemctl enable apache2.service
systemctl start apache2.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. You should be able to start zoneminder by issuing the commands (as root):
systemctl enable zoneminder
systemctl start zoneminder
If zoneminder fails to start using the service you may also start it
with this command:
/opt/zoneminder/bin/zmpkg.pl start
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. Add the mysql ALTER permission to the zmuser account:
mysql -u root -p
use zm
grant alter, lock tables on zm.* to 'zmuser'@localhost;
Since this is an upgrade, the assumption is that the zmuser account already
has select, insert, update, and delete permission.
3. You will need to upgrade the ZoneMinder database as described in the
manual. Only if the previous step was succesful, may you run zmupdate like
so (as root):
/opt/zoneminder/bin/zmupdate.pl
4. As mentioned in the OpenSuse notes you may need to change database values.
These steps may be run at any time (as root):
stop the current instance of zoneminder - systemctl stop zoneminder
ensure that all zoneminder processes have terminated:
ps -ef|grep zm
if you find any process still running issue a kill -9 for each
mysql -u root
use zm
update Config set DefaultValue = '/var/run/zoneminder'
where name = 'ZM_PATH_LOGS';
update Config set Value = '/var/run/zoneminder'
where name = 'ZM_PATH_LOGS';
update Config set DefaultValue = '/var/run/zoneminder'
where name = 'ZM_PATH_SOCKS';
update Config set Value = '/var/run/zoneminder'
where name = 'ZM_PATH_SOCKS';
update Config set DefaultValue = '/var/run/zoneminder'
where name = 'ZM_PATH_LOGS';
update Config set Value = '/var/run/zoneminder'
where name = 'ZM_PATH_SWAP';
commit;
exit
You can then restart zoneminder - systemctl start zoneminder
5cd165e9d5