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

From ZoneMinder Wiki
Jump to navigationJump to search
 
(48 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 web server, 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.'''


Login and become root. I have added sudo and permissions for my user and have omitted the use of sudo before each command.
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.  


  sudo su
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 additional LAMP components
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.


  apt install php mariadb-server php-mysql libapache2-mod-php7.3
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


Secure Mariadb, create root password et. al.
CTRL+x to exit


  mysql_secure_installation
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
Install Zoneminder


Add the Deb Multimedia repository. (instructions at: https://deb-multimedia.org/)
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


Edit sources.list
Enable Apache Modules


  nano /etc/apt/sources.list
  sudo a2enconf zoneminder
sudo a2enmod rewrite
Restart Apache


Add to the end of the file:
sudo service apache2 reload


  deb http://www.deb-multimedia.org buster main non-free
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+o Enter to save


Ctrl+x to exit
CTRL+x to exit  
 
Restart php-fpm
 
sudo systemctl restart php7.3-fpm
 
 
Add the repro


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


wget http://www.deb-multimedia.org/pool/main/d/deb-multimedia-keyring/deb-multimedia-keyring_2016.8.1_all.deb
Add the following line to the end of the file


  dpkg -i deb-multimedia-keyring_2016.8.1_all.deb
  deb https://zmrepo.zoneminder.com/debian/release-1.34 buster/


apt update
CTRL+o then [Enter] to save


Install Zoneminder
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 -


apt install zoneminder vlc-plugin-base
'''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


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


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


mysql -uroot -p -e "grant all on zm.* to 'zmuser'@localhost identified by 'zmpass';"
Create a new user if you plan to use local (USB or capture card) cameras.


  mysqladmin -uroot -p reload
  sudo adduser www-data video


Set permissions


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


  chown root:www-data /etc/zm/zm.conf
  sudo nano /etc/zm/conf.d/01-system-paths.conf


chown -R www-data:www-data /usr/share/zoneminder/
Ctrl+o Enter to save


chown -R www-data:www-data /var/cache/zoneminder/
CTRL+x to exit


Enable Zoneminder service to start at boot
Enable and start Zoneminder


  systemctl enable zoneminder.service
  sudo systemctl enable zoneminder


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


adduser www-data video


Start Zoneminder
Edit the Ngnix default configuration.


  systemctl start zoneminder.service
  sudo nano /etc/nginx/sites-available/default


Check to see that Zoneminder is running
Locate the line "index index.html index.htm index.nginx-debian.html;" and add index.php


  systemctl status zoneminder.service
  index index.php index.html index.htm index.nginx-debian.html;


Enable CGI and Zoneminder configuration in Apache.
In the "server" section after listen [::] :80 default_Server; add


  a2enmod cgi
  include /etc/nginx/zoneminder.conf;


a2enmod rewrite
Ctrl+o Enter to save


a2enconf zoneminder
CTRL+x to exit


Add timezone to PHP
Create a Zoneminder conf file


  nano /etc/php/7.3/apache2/php.ini
  sudo nano /etc/nginx/zoneminder.conf


Search for [Date] (Ctrl + w then type Date and press Enter) and make changes as follows for your time zone
Enter the following into the zoneminder.conf file (This file was improved by databoy2k)


[Date]
location /cgi-bin {
; Defines the default timezone used by the date functions
auth_basic off;
; http://php.net/date.timezone
        alias /usr/lib/zoneminder/cgi-bin;   
date.timezone = America/New_York
        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+o Enter to save
Line 103: Line 247:
CTRL+x to exit  
CTRL+x to exit  


To get the API working you need to create .htaccess in 3 places and add the code below. (Thanks Chimaera!)
Restart Ngnix


  nano /usr/share/zoneminder/www/api/.htaccess
  sudo service nginx restart


nano /usr/share/zoneminder/www/api/app/.htaccess
Note: If Nginx gives you an error on restart go back one step and re-enter include /etc/ngnix/zoneminder.conf;


nano /usr/share/zoneminder/www/api/app/webroot/.htaccess
If it does not exist create


Codefor .htaccess files:
sudo nano /etc/default/fcgiwrap


<IfModule mod_rewrite.c>
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
 
    RewriteCond %{REQUEST_FILENAME} !-d
  DAEMON_OPTS=-c 10
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
    RewriteBase /zm/api
  </IfModule>


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


Restart Apache
then restart the fcgiwrap service.


  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.