Difference between revisions of "Debian 10 Buster with Zoneminder 1.36.x from ZM Repo"

From ZoneMinder Wiki
Jump to navigationJump to search
 
(40 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Debian 10 Buster with Zoneminder 1.32.3 from the Debian Multimedia Repository ==
__TOC__




Install Debian Buster. I used the net install CD and installed only SSH server and standard system utilities from tasksel.
'''Notice: These procedure are for a new install of Zoneminder 1.36.x on Debian 10 (Buster). If you are doing an upgrade I strongly recommend you check the Zoneminder-1.36 Forum area for recommendations from others.'''


You will need to install LAMP. One good guide to do this can be found here:
Debian, unlike Ubuntu, does not install sudo with the initial setup. While you can log in as root, a user with sudo authority is recommended.


  https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mariadb-php-lamp-stack-on-debian-10
To enable sudo:
In a terminal,become root with su. Enter your root password.
Install sudo with:
  apt install sudo
Add the user account to the group sudo with:  
/sbin/adduser username sudo
where username is your user account.
Exit root then log out and then log in with the same user.


Install Zoneminder
Timezone: it is recommended you set your specific timesone with:
sudo timedatectl set-timezone America/New_York
Of course use your timezone in place of America/New_York.
 
Mariadb additional settings
The default values for the database are adequate for initial setup. However, I recommend you make these changes before installing Zoneminder:
Edit the Mariadb config file:
sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf
Add the following in the [mysql] area:
innodb_file_per_table = ON
innodb_buffer_pool_ size = 256M
innodb_log_file_size - 32M
CTRL+o then [Enter] to save
 
CTRL+x to exit
 
Reatart Mariadb:
sudo service mysql restart
 
I recommend you install mysqltuner and run it from time to time and adjust the database settings as the number of saved events grows.
 
 
===Debian 10 Buster with Zoneminder 1.36.x from the ZM Release-1.36 Repo===
 
This install procedure was developed to use the Debian package developed by iconnor. This is from the 1.36 release version of Zoneminder.
 
'''Note: This is an install procedure for new installations! Upgraders are encouraged to search the Zoneminder Forum for upgrade information!'''
 
This procedure will work on a Raspberry Pi 3b+ and possibly other devices.
 
To begin, install Debian 10 (Buster) along with Apache2, PHP and your favorite database (Mariadb recommended). A quick way to do this is:
 
sudo apt install apache2 mariadb-server php libapache2-mod-php php-mysql
 
Then secure Mariadb
 
sudo mysql_secure_installation


Add the Deb Multimedia repository. (instructions at: https://deb-multimedia.org/)
(If you want more detailed instrunctions for a LAMP server see: https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mariadb-php-lamp-stack-on-debian-10)


Edit sources.list
Add the repo


  sudo nano /etc/apt/sources.list
  sudo nano /etc/apt/sources.list


Add to the end of the file:
Add the following line to the end of the file
 
deb https://zmrepo.zoneminder.com/debian/release-1.36 buster/


deb http://www.deb-multimedia.org buster main non-free
CTRL+o then [Enter] to save


Ctrl+o Enter to save
CTRL+x to exit


Ctrl+x to exit
Install the following and retrieve the key from the repro


After you have added the necessary line in /etc/apt/sources.list the first package to install is deb-multimedia-keyring.
sudo apt install apt-transport-https gnupg


  wget http://www.deb-multimedia.org/pool/main/d/deb-multimedia-keyring/deb-multimedia-keyring_2016.8.1_all.deb
  wget -O - https://zmrepo.zoneminder.com/debian/archive-keyring.gpg | sudo apt-key add -


sudo dpkg -i deb-multimedia-keyring_2016.8.1_all.deb
'''Important - Make sure the above "wget" process completes without error! If it does not complete you will not get the most recent Zoneminder version this procedure is written for.'''


  sudo apt update
  sudo apt update
Line 34: Line 79:
Install Zoneminder
Install Zoneminder


  sudo apt install zoneminder vlc-plugin-base
  sudo apt install zoneminder
 
Create a new user if you plan to use local (USB or capture card) cameras.
 
sudo adduser www-data video
 
Enable and start Zoneminder
 
sudo systemctl enable zoneminder.service
sudo systemctl start zoneminder
 
Enable Apache Modules
 
sudo a2enconf zoneminder
sudo a2enmod rewrite
Restart Apache
 
sudo service apache2 reload
 
Remember to set your timezone in Zoneminder - Options
 
===Zoneminder 1.36.x on Buster LEMP (NGNIX, Mariadb, PHP)===
 
This procedure will work on a Raspberry Pi 3b+ and possibly other devices.
 
Thanks to "terdinglage" for the input to get this to work!
 
Start with a basic Buster install. You can use a server or desktop install. Do not install LAMP!
 
Install Ngnix, Mariadb and PHP components


sudo apt install nginx mariadb-server php-fpm php-mysql fcgiwrap


Create Zoneminder database in MySQL (Note: this also creates the default Zoneminder user and permissions in MySQL)
Secure the Mariadb server


  sudo mysql -uroot -p < /usr/share/zoneminder/db/zm_create.sql
  sudo mysql_secure_installation


sudo mysql -uroot -p -e "grant all on zm.* to 'zmuser'@localhost identified by 'zmpass';"
Restart Mariadb


  sudo mysqladmin -uroot -p reload
  sudo systemctl restart mysql


Set permissions
Edit the php.ini file


  sudo chmod 740 /etc/zm/zm.conf
  sudo nano /etc/php/7.3/fpm/php.ini


sudo chown root:www-data /etc/zm/zm.conf
Locate (Ctrl+w) cgi.fix_pathinfo=1 and change to


  sudo chown -R www-data:www-data /usr/share/zoneminder/
  cgi.fix_pathinfo=0


sudo chown -R www-data:www-data /var/cache/zoneminder/
Remember to remove the leading ;


Enable Zoneminder service to start at boot
Ctrl+o Enter to save


  sudo systemctl enable zoneminder.service
CTRL+x to exit
 
Restart php-fpm
 
  sudo systemctl restart php7.3-fpm
 
 
Add the repro
 
sudo nano /etc/apt/sources.list
 
Add the following line to the end of the file
 
deb https://zmrepo.zoneminder.com/debian/release-1.34 buster/
 
CTRL+o then [Enter] to save
 
CTRL+x to exit
 
Install the following and retrieve the key from the repro
 
sudo apt install apt-transport-https gnupg
 
wget -O - https://zmrepo.zoneminder.com/debian/archive-keyring.gpg | sudo apt-key add -
 
'''Important - Make sure the above "wget" process completes without error! If it does not complete you will not get the most recent Zoneminder version this procedure is written for.'''
 
sudo apt update
 
Install Zoneminder
 
sudo apt install zoneminder


Add www-data to the sudo group (to enable use of local video devices)
Create a new user if you plan to use local (USB or capture card) cameras.


  sudo adduser www-data video
  sudo adduser www-data video


Start Zoneminder


  sudo systemctl start zoneminder.service
Change the ZM_PATH_ZMS in the 01-system-paths.conf file to /cgi-bin/nph-zms by dropping the /zm/
 
  sudo nano /etc/zm/conf.d/01-system-paths.conf
 
Ctrl+o Enter to save
 
CTRL+x to exit


Check to see that Zoneminder is running
Enable and start Zoneminder


  sudo systemctl status zoneminder.service
  sudo systemctl enable zoneminder


Enable CGI and Zoneminder configuration in Apache.
sudo service zoneminder start


sudo a2enmod cgi


sudo a2enmod rewrite
Edit the Ngnix default configuration.


  sudo a2enconf zoneminder
  sudo nano /etc/nginx/sites-available/default


Add timezone to PHP
Locate the line "index index.html index.htm index.nginx-debian.html;" and add index.php


  sudo nano /etc/php/7.3/apache2/php.ini
  index index.php index.html index.htm index.nginx-debian.html;


Search for [Date] (Ctrl + w then type Date and press Enter) and make changes as follows for your time zone
In the "server" section after listen [::] :80 default_Server; add


  [Date]
  include /etc/nginx/zoneminder.conf;
; 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+o Enter to save
Line 94: Line 202:
CTRL+x to exit  
CTRL+x to exit  


'''Note: 20JUL19 - A fix for the below was submitted to deb-multimedia  but the fix has errors in it.'''
Create a Zoneminder conf file


You need to Edit zoneminder.conf.
sudo nano /etc/nginx/zoneminder.conf


First make a copy of zoneminder.conf
Enter the following into the zoneminder.conf file (This file was improved by databoy2k)


  sudo cp /etc/apache2/conf-enabled/zoneminder.conf /etc/apache2/conf-enabled/zoneminder.sav
  location /cgi-bin {
auth_basic off;
        alias /usr/lib/zoneminder/cgi-bin;   
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        fastcgi_param HTTP_PROXY "";
        fastcgi_pass unix:/var/run/fcgiwrap.socket;
}
location /zm/cache {
auth_basic off;
        alias /var/cache/zoneminder/cache;
}
location ~ /zm/api/(css|img|ico) {
auth_basic off;
        rewrite ^/zm/api(.+)$ /api/app/webroot/$1 break;
        try_files $uri $uri/ =404;
}
location /zm {
auth_basic off;
        alias /usr/share/zoneminder/www;
        try_files $uri $uri/ /index.php?$args =404;   
        location /zm/api {
auth_basic off;
                rewrite ^/zm/api(.+)$ /zm/api/app/webroot/index.php?p=$1 last;
          }
                location ~ \.php$ {
                auth_basic off;
                        include fastcgi_params;
                        fastcgi_param SCRIPT_FILENAME $request_filename;
                        fastcgi_param HTTP_PROXY "";
                fastcgi_index index.php;
                        fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
        }
    }


Next, edit the file
Ctrl+o Enter to save


sudo nano /etc/apache2/conf-enabled/zoneminder.conf
CTRL+x to exit


Replace the contents with:
Restart Ngnix


  ########################
  sudo service nginx restart
#
# Remember to enable cgi mod and serve-cgi-bin.conf configuration
#
# a2enmod cgi
# a2enconf serve-cgi-bin.conf
#
########################
# Order matters. This alias must come first.
Alias /zm/cache /var/cache/zoneminder
<Directory /var/cache/zoneminder>
    Options -Indexes +FollowSymLinks
    AllowOverride None
    Require all granted
</Directory>


Alias /zm /usr/share/zoneminder/www
Note: If Nginx gives you an error on restart go back one step and re-enter include /etc/ngnix/zoneminder.conf;
<Directory /usr/share/zoneminder/www>
#  php_flag register_globals off
  Options -Indexes +FollowSymLinks
  <IfModule mod_authz_core.c>
            Require all granted
  </IfModule>
</Directory>


ScriptAlias /cgi-bin "/usr/lib/zoneminder/cgi-bin"
If it does not exist create
<Directory "/usr/lib/zoneminder/cgi-bin">
    Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
    AllowOverride All
    Require all granted
</Directory>


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


<Directory "/usr/share/zoneminder/www/api/app">
and insert (with the number of children -c equal to the number of cameras) Note that you may need to have this value larger than the number if cameras. In my case I run "camera walls" from a custom web page that accesses the Zoneminder monitors. I have needed to increase the -c to include the number of cameras in the camera wall web pages.
    RewriteEngine on
    RewriteRule ^$ webroot/ [L]
    RewriteRule (.*) webroot/$1 [L]
    RewriteBase /zm/api
</Directory>


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


Ctrl+o Enter to save
Ctrl+o Enter to save
Line 166: Line 265:
CTRL+x to exit  
CTRL+x to exit  


Restart Apache
then restart the fcgiwrap service.


  sudo service apache2 restart
  sudo systemctl restart fcgiwrap


All done! Navigate to http://serverip/zm
Open Zoneminder and under Options set your timezone.

Latest revision as of 12:51, 28 September 2021


Notice: These procedure are for a new install of Zoneminder 1.36.x on Debian 10 (Buster). If you are doing an upgrade I strongly recommend you check the Zoneminder-1.36 Forum area for recommendations from others.

Debian, unlike Ubuntu, does not install sudo with the initial setup. While you can log in as root, a user with sudo authority is recommended.

To enable sudo: In a terminal,become root with su. Enter your root password. Install sudo with:

apt install sudo

Add the user account to the group sudo with:

/sbin/adduser username sudo 

where username is your user account. Exit root then log out and then log in with the same user.

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

sudo timedatectl set-timezone America/New_York

Of course use your timezone in place of America/New_York.

Mariadb additional settings The default values for the database are adequate for initial setup. However, I recommend you make these changes before installing Zoneminder: Edit the Mariadb config file:

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

Add the following in the [mysql] area:

innodb_file_per_table = ON
innodb_buffer_pool_ size = 256M
innodb_log_file_size - 32M

CTRL+o then [Enter] to save

CTRL+x to exit

Reatart Mariadb:

sudo service mysql restart

I recommend you install mysqltuner and run it from time to time and adjust the database settings as the number of saved events grows.


Debian 10 Buster with Zoneminder 1.36.x from the ZM Release-1.36 Repo

This install procedure was developed to use the Debian package developed by iconnor. This is from the 1.36 release version of Zoneminder.

Note: This is an install procedure for new installations! Upgraders are encouraged to search the Zoneminder Forum for upgrade information!

This procedure will work on a Raspberry Pi 3b+ and possibly other devices.

To begin, install Debian 10 (Buster) along with Apache2, PHP and your favorite database (Mariadb recommended). A quick way to do this is:

sudo apt install apache2 mariadb-server php libapache2-mod-php php-mysql

Then secure Mariadb

sudo mysql_secure_installation

(If you want more detailed instrunctions for a LAMP server see: https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mariadb-php-lamp-stack-on-debian-10)

Add the repo

sudo nano /etc/apt/sources.list

Add the following line to the end of the file

deb https://zmrepo.zoneminder.com/debian/release-1.36 buster/

CTRL+o then [Enter] to save

CTRL+x to exit

Install the following and retrieve the key from the repro

sudo apt install apt-transport-https gnupg
wget -O - https://zmrepo.zoneminder.com/debian/archive-keyring.gpg | sudo apt-key add -

Important - Make sure the above "wget" process completes without error! If it does not complete you will not get the most recent Zoneminder version this procedure is written for.

sudo apt update

Install Zoneminder

sudo apt install zoneminder

Create a new user if you plan to use local (USB or capture card) cameras.

sudo adduser www-data video

Enable and start Zoneminder

sudo systemctl enable zoneminder.service
sudo systemctl start zoneminder 

Enable Apache Modules

sudo a2enconf zoneminder
sudo a2enmod rewrite

Restart Apache

sudo service apache2 reload

Remember to set your timezone in Zoneminder - Options

Zoneminder 1.36.x on Buster LEMP (NGNIX, Mariadb, PHP)

This procedure will work on a Raspberry Pi 3b+ and possibly other devices.

Thanks to "terdinglage" for the input to get this to work!

Start with a basic Buster install. You can use a server or desktop install. Do not install LAMP!

Install Ngnix, Mariadb and PHP components

sudo apt install nginx mariadb-server php-fpm php-mysql fcgiwrap

Secure the Mariadb server

sudo mysql_secure_installation

Restart Mariadb

sudo systemctl restart mysql

Edit the php.ini file

sudo nano /etc/php/7.3/fpm/php.ini

Locate (Ctrl+w) cgi.fix_pathinfo=1 and change to

cgi.fix_pathinfo=0

Remember to remove the leading ;

Ctrl+o Enter to save

CTRL+x to exit

Restart php-fpm

sudo systemctl restart php7.3-fpm


Add the repro

sudo nano /etc/apt/sources.list

Add the following line to the end of the file

deb https://zmrepo.zoneminder.com/debian/release-1.34 buster/

CTRL+o then [Enter] to save

CTRL+x to exit

Install the following and retrieve the key from the repro

sudo apt install apt-transport-https gnupg
wget -O - https://zmrepo.zoneminder.com/debian/archive-keyring.gpg | sudo apt-key add -

Important - Make sure the above "wget" process completes without error! If it does not complete you will not get the most recent Zoneminder version this procedure is written for.

sudo apt update

Install Zoneminder

sudo apt install zoneminder

Create a new user if you plan to use local (USB or capture card) cameras.

sudo adduser www-data video


Change the ZM_PATH_ZMS in the 01-system-paths.conf file to /cgi-bin/nph-zms by dropping the /zm/

sudo nano /etc/zm/conf.d/01-system-paths.conf

Ctrl+o Enter to save

CTRL+x to exit

Enable and start Zoneminder

sudo systemctl enable zoneminder
sudo service zoneminder start


Edit the Ngnix default configuration.

sudo nano /etc/nginx/sites-available/default

Locate the line "index index.html index.htm index.nginx-debian.html;" and add index.php

index index.php index.html index.htm index.nginx-debian.html;

In the "server" section after listen [::] :80 default_Server; add

include /etc/nginx/zoneminder.conf;

Ctrl+o Enter to save

CTRL+x to exit

Create a Zoneminder conf file

sudo nano /etc/nginx/zoneminder.conf

Enter the following into the zoneminder.conf file (This file was improved by databoy2k)

location /cgi-bin {
auth_basic off;
        alias /usr/lib/zoneminder/cgi-bin;     
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        fastcgi_param HTTP_PROXY "";
        fastcgi_pass unix:/var/run/fcgiwrap.socket;
}
location /zm/cache {
auth_basic off;
        alias /var/cache/zoneminder/cache;
}
location ~ /zm/api/(css|img|ico) {
auth_basic off;
        rewrite ^/zm/api(.+)$ /api/app/webroot/$1 break;
        try_files $uri $uri/ =404;
}
location /zm {
auth_basic off;
        alias /usr/share/zoneminder/www;
        try_files $uri $uri/ /index.php?$args =404;    
        location /zm/api {
auth_basic off;
                rewrite ^/zm/api(.+)$ /zm/api/app/webroot/index.php?p=$1 last;
         }
                location ~ \.php$ {
                auth_basic off;
                        include fastcgi_params;
                        fastcgi_param SCRIPT_FILENAME $request_filename;
                        fastcgi_param HTTP_PROXY "";
                fastcgi_index index.php;
                        fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
        }
    }

Ctrl+o Enter to save

CTRL+x to exit

Restart Ngnix

sudo service nginx restart

Note: If Nginx gives you an error on restart go back one step and re-enter include /etc/ngnix/zoneminder.conf;

If it does not exist create

sudo nano /etc/default/fcgiwrap

and insert (with the number of children -c equal to the number of cameras) Note that you may need to have this value larger than the number if cameras. In my case I run "camera walls" from a custom web page that accesses the Zoneminder monitors. I have needed to increase the -c to include the number of cameras in the camera wall web pages.

DAEMON_OPTS=-c 10

Ctrl+o Enter to save

CTRL+x to exit

then restart the fcgiwrap service.

sudo systemctl restart fcgiwrap

Open Zoneminder and under Options set your timezone.