Difference between revisions of "Debian 12 Bookworm with Zoneminder 1.36.33"

From ZoneMinder Wiki
Jump to navigationJump to search
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__TOC__
__TOC__


===Debian 9 with Zoneminder 1.30.4===
==Debian 12 with Zoneminder 1.36.x==
17FEB19 This procedure can be used to install Zoneminder on a Raspberry Pi. I used a Pi3 B+.


08OCT17 - This procedure has been verified with the Debian 9.2.0.
Debian 12 Bookworm is released with Zoneminder 1.36.33 and as usual for Debian the zm database needs to be created manually.


Note: 23JUN17 - I was able to get the libvlc source to work! I have added the install for vlc-plugin-base which allows the Zoneminder install to complete without errors. However, I have been getting some console errors from VLC. It may be my old camera and you may have good results with libvlc but I consider ffmpeg better to use.
'''Note: This version has been verified with Bookworm Debian 12 official release. A few issues have been found and corrected. Zoneminder now opens in Firefox (Windows, Linux and Android), Edge, Chrome (on Android). ZmNinja on Android also works. If using ZmNinja you may have to clear the API cache. Please report other errors on the Zoneminder forum.'''


I used Debian 9 net install CD (https://www.debian.org/CD/netinst/).  
In time a version of Zoneminder for Bookworm will be made available in the zmrepo.


Install only: web server, SSH server and standard system utilities from tasksel
You will have to install sudo and add the user to the sudoers file.


Login and become root (su root) or prepend sudo to the following commands
Become root with


If needed check to make sure you are up to date
su


apt update
Install sudo
apt upgrade
apt dist-upgrade


===Install additional LAMP components Mariadb server (recommended)===
apt install sudo


apt install php mariadb-server php-mysql libapache2-mod-php7.0
Then add the user


Secure Mariadb, create root password et. al.
/sbin/adduser username sudo


mysql_secure_installation
I recommend rebooting at this point but a log out and back in also works.


NOTE:The MySQL/MariaDB configuration file is located at: /etc/mysql/mysql.conf.d/mysqld.cnf To better manage the MariaDB server I recommend you move the config file and replace the default my.cnf symbolic link (this also works for MySQL 5.6).
Become root


  rm /etc/mysql/my.cnf 
  sudo su


cp /etc/mysql/mariadb.conf.d/50-server.cnf /etc/mysql/my.cnf
Timezone: it is recommended you set your specific timesone with:


'''The following change to Mariadb settings is optional but is included if you have problems logging into Zoneminder'''
timedatectl set-timezone America/New_York


nano /etc/mysql/my.cnf
Of course use your timezone in place of America/New_York


Make the following changes:
Install Apache2, PHP and your favorite database (Mariadb recommended). A quick way to install LAMP is:  


  character-set-server = latin1
  apt install apache2 mariadb-server php libapache2-mod-php php-mysql lsb-release gnupg2
collation-server = latin1_swedish_ci


Note: The above settings are actually the Mariadb default. Changing back to default is necessary to avoid errors when logging into Zoneminder. This was added on 01APR17 but is not an April Fool! It may be necessary to align these settings with your regional language.
Add timezone to PHP (This may not be necessary but does not hurt and will allow the time of events to be displayed correctly)


Ctrl+o Enter to save
nano /etc/php/8.2/apache2/php.ini


Ctrl+x to exit
Search for [Date] (Ctrl + w then type Date and press Enter) and make changes as follows for your time zone


Restart Mariadb
[Date]
; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = America/New_York


service mariadb restart
Ctrl+o Enter to save


===Install Zoneminder===
CTRL+x to exit


Add the Deb Multimedia repository. (instructions at: https://deb-multimedia.org/)
Restart Apache


Edit sources.list
service apache2 restart


nano /etc/apt/sources.list
Install Zoneminder


Add to the end of the file:
apt install zoneminder


deb http://www.deb-multimedia.org stretch main non-free
Create Zoneminder database in MySQL (Note: this also creates the default Zoneminder user and permissions in MySQL) Use the server root password when prompted.


For Pi uncomment:
mysql -uroot -p < /usr/share/zoneminder/db/zm_create.sql


  deb-src http://raspbian.raspberrypi.org/raspbian/ stretch main contrib non-free$
  mysql -uroot -p -e "grant all on zm.* to 'zmuser'@localhost identified by 'zmpass';"


Ctrl+o Enter to save
mysqladmin -uroot -p reload


Ctrl+x to exit
Set permissions


After you have added the necessary line in /etc/apt/sources.list the first package to install is deb-multimedia-keyring.
chmod 640 /etc/zm/zm.conf
chown root:www-data /etc/zm/zm.conf
chown -R www-data:www-data /var/cache/zoneminder/
chmod 755 /var/cache/zoneminder/


apt update
Replace zoneminder.conf
apt install deb-multimedia-keyring


If apt-get can not find the new key, do that :
cp /etc/apache2/conf-available/zoneminder.conf /etc/apache2/conf-available/zoneminder.conf.sav


  wget http://www.deb-multimedia.org/pool/main/d/deb-multimedia-keyring/deb-multimedia-keyring_2016.8.1_all.deb
  rm /etc/apache2/conf-available/zoneminder.conf
dpkg -i deb-multimedia-keyring_2016.8.1_all.deb


Update packages list:
nano /etc/apache2/conf-available/zoneminder.conf


apt update
Paste the following content into nano:
apt upgrade
apt dist-upgrade
 
 
Install Zoneminder
 
apt install zoneminder vlc-plugin-base php7.0-gd
 
 
Set permissions of /etc/zm/zm.conf to root:www-data 740
 
chmod 740 /etc/zm/zm.conf
 
chown root:www-data /etc/zm/zm.conf


# Remember to enable cgi mod (i.e. "a2enmod cgi").
ScriptAlias /zm/cgi-bin "/usr/lib/zoneminder/cgi-bin"
<Directory "/usr/lib/zoneminder/cgi-bin">
    Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
    AllowOverride All
    Require all granted
</Directory>
# Order matters. This alias must come first.
Alias /zm/cache "/var/cache/zoneminder"
<Directory "/var/cache/zoneminder">
    Options -Indexes +FollowSymLinks
    AllowOverride None
    <IfModule mod_authz_core.c>
        # Apache 2.4
        Require all granted
    </IfModule>
</Directory>
Alias /zm /usr/share/zoneminder/www
<Directory /usr/share/zoneminder/www>
  Options -Indexes +FollowSymLinks
  <IfModule mod_dir.c>
    DirectoryIndex index.php
  </IfModule>
</Directory>
# For better visibility, the following directives have been migrated from the
# default .htaccess files included with the CakePHP project.
# Parameters not set here are inherited from the parent directive above.
<Directory "/usr/share/zoneminder/www/api">
    RewriteEngine on
    RewriteRule ^$ app/webroot/ [L]
    RewriteRule (.*) app/webroot/$1 [L]
    RewriteBase /zm/api
</Directory>
<Directory "/usr/share/zoneminder/www/api/app">
    RewriteEngine on
    RewriteRule ^$ webroot/ [L]
    RewriteRule (.*) webroot/$1 [L]
    RewriteBase /zm/api
</Directory>
<Directory "/usr/share/zoneminder/www/api/app/webroot">
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
    RewriteBase /zm/api
</Directory>
Enable Zoneminder service to start at boot
Enable Zoneminder service to start at boot


Line 108: Line 150:


  adduser www-data video
  adduser www-data video
For Pi, Create Zoneminder database in Mariadb (Note: this also creates the default Zoneminder user and permissions in MySQL)
mysql -uroot -p < /usr/share/zoneminder/db/zm_create.sql
mysql -uroot -p -e "grant all on zm.* to 'zmuser'@localhost identified by 'zmpass';"
mysqladmin -uroot -p reload


Start Zoneminder
Start Zoneminder
Line 122: Line 155:
  systemctl start zoneminder.service
  systemctl start zoneminder.service


Check to see that Zoneminder is running
Enable Zoneminder configuration in Apache.
 
systemctl status zoneminder.service
 
Enable CGI and Zoneminder configuration in Apache.


a2enconf zoneminder
a2enmod rewrite
a2enmod headers
a2enmod expires
  a2enmod cgi
  a2enmod cgi
a2enmod rewrite
a2enconf zoneminder
Add timezone to PHP
sed -i "s/;date.timezone =/date.timezone = $(sed 's/\//\\\//' /etc/timezone)/g" /etc/php/7.0/apache2/php.ini
Change permissions in /usr/share/zoneminder/
chown -R www-data:www-data /usr/share/zoneminder/
Restart Apache
service apache2 restart
Open Zoneminder in a web browser (http://server-ip/zm).
10OCT17 - An issue with the /tmp/zm directory has been reported. Debian uses private tmp folders so even though you can see the files & folders, zoneminder cannot because it is running under a different user account.
Go to Options -> Paths and then inspect each PATH_XXX variable. If it is set to "/tmp/zm", change it to "/dev/shm". Don't forget to restart zoneminder.
===Alternate install MySQL Server===
Note: Install of MySQL was not tested with the Debian 9.0.0 release but should work based on past experience
   
   
service apache2 reload


apt install php default-mysql-server php-mysql apache2-mod-php7.0
Install complete. Open Zoneminder/Options and set the timezone in Options/System. Add cameras.
 
Make a change to MySQL settings: (Note: Your my.cnf may be in another location)
 
nano /etc/mysql/my.cnf
 
In the [mysqld] section add the following
 
sql_mode = NO_ENGINE_SUBSTITUTION
 
Note: if you are installing on an existing database server you can use the following as an alternate to 'sql_mode = NO_ENGINE_SUBSTITUTION' (Thanks to "bodom" for this alternate):


init_connect = 'SET @@sql_mode = CASE CURRENT_USER() WHEN \'zmuser@localhost\' THEN \'NO_ENGINE_SUBSTITUTION\' ELSE @@sql_mode END;'
----------------------------------------------------------------------------------------------------------
 
==Debian 12 with Zoneminder 1.37.x==
Ctrl+o Enter to save
Install Zoneminder Development Branch 1.37.x on Debian 12


Ctrl+x to exit
You will have to install sudo and add the user to the sudoers file.


Restart MySQL
Become root with


  systemctl restart mysql
  su


Continue with Zoneminder install https://wiki.zoneminder.com/Debian_9_64-bit_with_Zoneminder_1.30.4_the_Easy_Way#Install_Zoneminder
Install sudo


===Debian 9 with Zoneminder 1.32.2 from the Experimental Repro===
apt install sudo


This is an interim install procedure for the bold user! Start with a fresh Debian 9 install.
Then add the user


Note: this will do updates from the sid repro as well!
/sbin/adduser username sudo


Edit sources.list
I recommend rebooting at this point but a log out and back in also works.


nano /etc/apt/sources.list
Install Apache2, PHP and your favorite database (Mariadb recommended). A quick way to install LAMP is:


Add to the end of the file:
apt install apache2 mariadb-server php libapache2-mod-php php-mysql lsb-release gnupg2


deb http://deb.debian.org/debian experimental main
deb http://deb.debian.org/debian sid main


Become root with sudo su before running this!


To install an experimental package, do:
Shell script file contents:


#!/bin/sh
clear
read -p "This script installs ZoneMinder 1.37.x on Debian 12 with LAMP (MySQL or Mariadb) installed...
This script must be run as root!
Press Enter to continue or Ctrl + c to quit" nothing
clear
apt install -y lsb-release gnupg2
echo "deb https://zmrepo.zoneminder.com/debian/master "`lsb_release  -c -s`"/" | sudo tee /etc/apt/sources.list.d/zoneminder.list
wget -O - https://zmrepo.zoneminder.com/debian/archive-keyring.gpg | sudo apt-key add -
read -p "Warning! Check above to insure the line says OK. If not the GPG signing key was not installed and you will need to figure out why before continuing.
Press enter to continue" nothing
  apt update
  apt update
  apt upgrade    (note: this will do all the updates in sid  unstable!)
  clear
  apt -t experimental install zoneminder
  apt install -y zoneminder
 
  systemctl enable zoneminder
Set permissions of /etc/zm/zm.conf to root:www-data 740
  service zoneminder start
 
  chmod 740 /etc/zm/zm.conf
 
  chown root:www-data /etc/zm/zm.conf
 
Enable Zoneminder service to start at boot
 
systemctl enable zoneminder.service
 
Add www-data to the sudo group (to enable use of local video devices)
 
  adduser www-data video
  adduser www-data video
a2enconf zoneminder
a2enmod rewrite
a2enmod headers
a2enmod expires
service apache2 reload
clear
read -p "Install complete. Open Zoneminder/Options and set the timezone. Press enter to continue" nothing
clear


Create Zoneminder database in MySQL (Note: this also creates the default Zoneminder user and permissions in MySQL)
mysql -uroot -p < /usr/share/zoneminder/db/zm_create.sql
mysql -uroot -p -e "grant all on zm.* to 'zmuser'@localhost identified by 'zmpass';"
mysqladmin -uroot -p reload
Start Zoneminder


systemctl start zoneminder.service
Copy the contents of the script, open a terminal and run:


Enable CGI and Zoneminder configuration in Apache.
nano zm-install


a2enmod cgi
Paste the contents of the script into Nano


a2enmod rewrite
Then:


  a2enconf zoneminder
  Ctrl + o Ctrl + x


Add timezone to PHP
Next run:


  sed -i "s/;date.timezone =/date.timezone = $(sed 's/\//\\\//' /etc/timezone)/g" /etc/php/7.0/apache2/php.ini
  chmod 755 zm-install


Change permissions in /usr/share/zoneminder/
Start the script by entering:


  chown -R www-data:www-data /usr/share/zoneminder/
  ./zm-install


Restart Apache
Follow the prompts. Things are pretty simple. The timezone is now set in Zoneminder/Options.


service apache2 restart
Good Luck!

Latest revision as of 15:10, 4 November 2023

Debian 12 with Zoneminder 1.36.x

Debian 12 Bookworm is released with Zoneminder 1.36.33 and as usual for Debian the zm database needs to be created manually.

Note: This version has been verified with Bookworm Debian 12 official release. A few issues have been found and corrected. Zoneminder now opens in Firefox (Windows, Linux and Android), Edge, Chrome (on Android). ZmNinja on Android also works. If using ZmNinja you may have to clear the API cache. Please report other errors on the Zoneminder forum.

In time a version of Zoneminder for Bookworm will be made available in the zmrepo.

You will have to install sudo and add the user to the sudoers file.

Become root with

su

Install sudo

apt install sudo

Then add the user

/sbin/adduser username sudo 

I recommend rebooting at this point but a log out and back in also works.

Become root

sudo su

Timezone: it is recommended you set your specific timesone with:

timedatectl set-timezone America/New_York

Of course use your timezone in place of America/New_York

Install Apache2, PHP and your favorite database (Mariadb recommended). A quick way to install LAMP is:

apt install apache2 mariadb-server php libapache2-mod-php php-mysql lsb-release gnupg2

Add timezone to PHP (This may not be necessary but does not hurt and will allow the time of events to be displayed correctly)

nano /etc/php/8.2/apache2/php.ini

Search for [Date] (Ctrl + w then type Date and press Enter) and make changes as follows for your time zone

[Date]
; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = America/New_York

Ctrl+o Enter to save

CTRL+x to exit

Restart Apache

service apache2 restart

Install Zoneminder

apt install zoneminder

Create Zoneminder database in MySQL (Note: this also creates the default Zoneminder user and permissions in MySQL) Use the server root password when prompted.

mysql -uroot -p < /usr/share/zoneminder/db/zm_create.sql
mysql -uroot -p -e "grant all on zm.* to 'zmuser'@localhost identified by 'zmpass';"
mysqladmin -uroot -p reload

Set permissions

chmod 640 /etc/zm/zm.conf

chown root:www-data /etc/zm/zm.conf

chown -R www-data:www-data /var/cache/zoneminder/

chmod 755 /var/cache/zoneminder/

Replace zoneminder.conf

cp /etc/apache2/conf-available/zoneminder.conf /etc/apache2/conf-available/zoneminder.conf.sav
rm /etc/apache2/conf-available/zoneminder.conf
nano /etc/apache2/conf-available/zoneminder.conf

Paste the following content into nano:

# Remember to enable cgi mod (i.e. "a2enmod cgi").
ScriptAlias /zm/cgi-bin "/usr/lib/zoneminder/cgi-bin"
<Directory "/usr/lib/zoneminder/cgi-bin">
    Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
    AllowOverride All
    Require all granted
</Directory>


# Order matters. This alias must come first.
Alias /zm/cache "/var/cache/zoneminder"
<Directory "/var/cache/zoneminder">
    Options -Indexes +FollowSymLinks
    AllowOverride None
    <IfModule mod_authz_core.c>
        # Apache 2.4
        Require all granted
    </IfModule>
</Directory>

Alias /zm /usr/share/zoneminder/www
<Directory /usr/share/zoneminder/www>
  Options -Indexes +FollowSymLinks
  <IfModule mod_dir.c>
    DirectoryIndex index.php
  </IfModule>
</Directory>

# For better visibility, the following directives have been migrated from the
# default .htaccess files included with the CakePHP project.
# Parameters not set here are inherited from the parent directive above.
<Directory "/usr/share/zoneminder/www/api">
   RewriteEngine on
   RewriteRule ^$ app/webroot/ [L]
   RewriteRule (.*) app/webroot/$1 [L]
   RewriteBase /zm/api
</Directory>

<Directory "/usr/share/zoneminder/www/api/app">
   RewriteEngine on
   RewriteRule ^$ webroot/ [L]
   RewriteRule (.*) webroot/$1 [L]
   RewriteBase /zm/api
</Directory>

<Directory "/usr/share/zoneminder/www/api/app/webroot">
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
    RewriteBase /zm/api
</Directory>

Enable Zoneminder service to start at boot

systemctl enable zoneminder.service

Add www-data to the sudo group (to enable use of local video devices)

adduser www-data video

Start Zoneminder

systemctl start zoneminder.service

Enable Zoneminder configuration in Apache.

a2enconf zoneminder

a2enmod rewrite

a2enmod headers

a2enmod expires

a2enmod cgi

service apache2 reload

Install complete. Open Zoneminder/Options and set the timezone in Options/System. Add cameras.


Debian 12 with Zoneminder 1.37.x

Install Zoneminder Development Branch 1.37.x on Debian 12

You will have to install sudo and add the user to the sudoers file.

Become root with

su

Install sudo

apt install sudo

Then add the user

/sbin/adduser username sudo 

I recommend rebooting at this point but a log out and back in also works.

Install Apache2, PHP and your favorite database (Mariadb recommended). A quick way to install LAMP is:

apt install apache2 mariadb-server php libapache2-mod-php php-mysql lsb-release gnupg2


Become root with sudo su before running this!

Shell script file contents:

#!/bin/sh
clear
read -p "This script installs ZoneMinder 1.37.x on Debian 12 with LAMP (MySQL or Mariadb) installed...
This script must be run as root!
Press Enter to continue or Ctrl + c to quit" nothing
clear
apt install -y lsb-release gnupg2
echo "deb https://zmrepo.zoneminder.com/debian/master "`lsb_release  -c -s`"/" | sudo tee /etc/apt/sources.list.d/zoneminder.list
wget -O - https://zmrepo.zoneminder.com/debian/archive-keyring.gpg | sudo apt-key add -
read -p "Warning! Check above to insure the line says OK. If not the GPG signing key was not installed and you will need to figure out why before continuing. 
Press enter to continue" nothing
apt update
clear
apt install -y zoneminder
systemctl enable zoneminder
service zoneminder start
adduser www-data video
a2enconf zoneminder
a2enmod rewrite
a2enmod headers
a2enmod expires
service apache2 reload
clear
read -p "Install complete. Open Zoneminder/Options and set the timezone. Press enter to continue" nothing
clear


Copy the contents of the script, open a terminal and run:

nano zm-install

Paste the contents of the script into Nano

Then:

Ctrl + o Ctrl + x

Next run:

chmod 755 zm-install

Start the script by entering:

./zm-install

Follow the prompts. Things are pretty simple. The timezone is now set in Zoneminder/Options.

Good Luck!