Aligned ubuntu install with iconnors post about changes in the forum

pull/1017/head
Pliable Pixels 2015-08-23 13:20:04 -04:00
parent 042e9533cf
commit 3ef7250d3e
1 changed files with 57 additions and 34 deletions

View File

@ -1,17 +1,15 @@
Ubuntu Ubuntu
====== ======
Option A: Install a ready made package
---------------------------------------
PPA Install Installation procedure (common for all versions of Ubuntu)
----------- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Follow these instructions to install current release version on Ubuntu.:
Pre-requisite
^^^^^^^^^^^^^^^
It is important that you first apply any system software upgrades first to Ubuntu, especially if you have just created a new image of Ubuntu. It is important that you first apply any system software upgrades first to Ubuntu, especially if you have just created a new image of Ubuntu.
Not doing this may cause the PPA process to fail and complain about various unmet dependencies. Not doing this may cause the PPA process to fail and complain about various unmet dependencies.
If you also plan to install the database in the same server (which is typically the case), first do: If you also plan to install the database in the same server (which is typically the case), first do:
:: ::
@ -21,9 +19,46 @@ If you also plan to install the database in the same server (which is typically
This will ask you for a user and password to configure for Zoneminder. This will ask you for a user and password to configure for Zoneminder.
Note that when you install the PPA, it will also create a username of zmuser and a password of zmpass irrespective of what you select at this stage Note that when you install the PPA, it will also create a username of zmuser and a password of zmpass irrespective of what you select at this stage
Now add the ppa repository path:
::
sudo apt-add-repository ppa:iconnor/zoneminder
Once you have updated the repository then update and install the package.:
::
sudo apt-get update
sudo apt-get install zoneminder
Post Install steps for Ubuntu 15.x or newer (systemd)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
sudo /usr/bin/zmupdate.pl
sudo systemctl enable zoneminder
sudo a2enconf zoneminder
sudo service apache2 reload
systemctl restart zoneminder
You should now be able to view the zoneminder interface at ``http://localhost/zm`` (replace localhost with your server IP if you are accessing it remotely)
.. image:: images/zm_first_screen_post_install.png
Post install steps for Ubuntu 14.x or older (SystemV)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Suggested changes to MySQL (Optional but recommended) Suggested changes to MySQL (Optional but recommended)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ """""""""""""""""""""""""""""""""""""""""""""""""""""""""
For most of you Zoneminder will run just fine with the default MySQL settings. There are a couple of settings that may, in time, provide beneficial especially if you have a number of cameras and many events with a lot of files. One setting we recommend is the "innodb_file_per_table" This will be a default setting in MySQL 5.6 but should be added in MySQL 5.5 which comes with Ubuntu 14.04. A description can be found here: http://dev.mysql.com/doc/refman/5.5/en/innodb-multiple-tablespaces.html For most of you Zoneminder will run just fine with the default MySQL settings. There are a couple of settings that may, in time, provide beneficial especially if you have a number of cameras and many events with a lot of files. One setting we recommend is the "innodb_file_per_table" This will be a default setting in MySQL 5.6 but should be added in MySQL 5.5 which comes with Ubuntu 14.04. A description can be found here: http://dev.mysql.com/doc/refman/5.5/en/innodb-multiple-tablespaces.html
To add "innodb_file_per_table" edit the my.cnf file: To add "innodb_file_per_table" edit the my.cnf file:
@ -37,30 +72,10 @@ Save and exit.
Restart MySQL Restart MySQL
``service mysql restart`` ``service mysql restart``
Installing the actual Zoneminder package
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
sudo apt-add-repository ppa:iconnor/zoneminder
Once you have updated the repository then update and install the package.:
::
sudo apt-get update
sudo apt-get install zoneminder
Post Install Configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^
We are not done yet. There are some post install steps you need to perform:
Adding a sleep for mysql dependency (Ubuntu 14.x and below only) Adding a sleep for mysql dependency (Ubuntu 14.x and below only)
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.. NOTE:: This sleep part is not needed for Ubuntu 15 and above that have moved to systemd
We recommend you add a "sleep" command just after ``start() { `` in ``/etc/init.d/zoneminder``` to make sure mysql starts before ZoneMinder does. To do this, We recommend you add a "sleep" command just after ``start() {`` in ``/etc/init.d/zoneminder`` to make sure mysql starts before ZoneMinder does. To do this,
simply modify ``/etc/init.d/zoneminder`` at around line 25 (where you will find the start function) to look like this: simply modify ``/etc/init.d/zoneminder`` at around line 25 (where you will find the start function) to look like this:
:: ::
@ -71,7 +86,7 @@ simply modify ``/etc/init.d/zoneminder`` at around line 25 (where you will find
echo -n "Starting $prog: " echo -n "Starting $prog: "
Making Apache aware of ZoneMinder Making Apache aware of ZoneMinder
"""""""""""""""""""""""""""""""""""" """"""""""""""""""""""""""""""""""""""""""""
Next, we need to make sure apache knows about zoneminder's configuration for apache. Next, we need to make sure apache knows about zoneminder's configuration for apache.
@ -79,7 +94,13 @@ Next, we need to make sure apache knows about zoneminder's configuration for apa
ln -s /etc/zm/apache.conf /etc/apache2/conf-available/zoneminder.conf ln -s /etc/zm/apache.conf /etc/apache2/conf-available/zoneminder.conf
Then If you are upgrading from an old version:
::
sudo /usr/bin/zmupdate.pl
Then look for ``/etc/apache2/conf-enable/zm.conf`` - if you have it, please remove it
:: ::
@ -87,7 +108,7 @@ Then
adduser www-data video adduser www-data video
Finally, lets make sure we restart apache: lets make sure we restart apache:
:: ::
@ -99,9 +120,11 @@ You should now be able to view the zoneminder interface at ``http://localhost/zm
.. image:: images/zm_first_screen_post_install.png .. image:: images/zm_first_screen_post_install.png
Finally, in the zoneminder web interface, go to Options->Paths, change PATH_ZMS to ``/zm/cgi-bin/nph-zms``
Build Package From Source
------------------------- Option B: Build Package From Source
-------------------------------------------
A fresh build based on master branch running Ubuntu 1204 LTS. Will likely work for other versions as well.:: A fresh build based on master branch running Ubuntu 1204 LTS. Will likely work for other versions as well.::