LookOut - Webcam Overview Tool - Advanced-Installation

Aus Laub-Home Wiki

What about


Requirements

  • Webserver (apache2)
  • PHP 5
  • MySQL Database 5.0
  • HTBasic Auth

Installation

  1. check the preinstallation tasks
  2. configure apache httpd server
  3. download lookout
  4. unzip it to webservers documentroot
  5. create lookout database user and table
  6. start the installation wizard
  7. login to admin panel
  8. copy and paste webcam links
  9. look at the overview page

Preinstallation Tasks

First of all you need a webserver with php and mysql support. I'm sure under Windows you could use the WAMP project. But here I will explain how to setup a small linux server, which will host lookout.
I use a 2GHz, 512 MB Ram and 8 GB HDD installed with Ubuntu Server 64bit 10.04 LTS. My setup is based on this article:

if you want to use Debian Linux, feel free to do this! More Informations here:

after that minimal installation you need to install the apache httpd webserver, php and the mysql database server:

aptitude install apache2 php5 mysql-server php5-mysql unzip

You will be asked for the mysql root password, please use a secure one!
Optional, you can change the MySQL Data Dir to /srv/mysql. For more Informations read this:

Configure Apache Webserver and PHP

Own virtual host for lookout

first we create the lookout home directory:

mkdir -p /srv/httpd/vhosts/lookout.domain.tdl/htdocs/

now we need the virtual host configuration file:
/etc/apache2/sites-available/lookout.domain.tdl

<VirtualHost *:80>
        ServerName lookout.domain.tdl
        DocumentRoot /srv/httpd/vhosts/lookout.domain.tdl/htdocs/
        ErrorDocument 403 http://lookout.domain.tdl
        ErrorDocument 404 http://lookout.domain.tdl
        <Directory /srv/httpd/vhosts/lookout.domain.tdl/>
                Options -Indexes FollowSymLinks -Includes -MultiViews
                AllowOverride None
                Order allow,deny
                allow from all
        </Directory>
        ErrorLog /var/log/apache2/lookout.domain.tdl-error.log
        CustomLog /var/log/apache2/lookout.domain.tdl-access.log combined
        LogLevel warn
</VirtualHost>

Change lookout.domain.tdl to the name of your Full Qualified Domain Name, for example lookout.laub-home.de
to enable the new created vhost type:

a2ensite lookout.domain.tdl
/etc/init.d/apache2 restart

now you have to enable the htbasic module:

a2enmod auth_basic
/etc/init.d/apache2 restart

lookout in an existing virtual host

if you want to use lookout under an existing virtual host, so you can reach it by typing lookout.domain.tdl/lookout/, you have to edit your vhost configuration. Paste something like this in it:

<Directory /srv/httpd/vhosts/lookout.domain.tdl/lookout/>
      Options -Indexes FollowSymLinks -Includes -MultiViews
      AllowOverride None
      Order allow,deny
      allow from all
</Directory>

To make the installation more secure, take a look here:

Lookout Installation

Here you can find the install instructions for the lookout version 0.1

For newer versions download the tar.gz package to your vhost folder and unzip it.
for example:

/srv/httpd/vhosts/lookout.domain.tdl/htdocs
wget http://wiki.laub-home.de/images/7/73/Lookout_0.7-6.zip
unzip Lookout-0.7-6.zip

now there should be something like that in the directory:

ls -la
total 60K
drwxr-xr-x 5 root root 4.0K 2012-10-27 10:55 .
drwxr-xr-x 4 root root 4.0K 2012-10-27 10:55 ..
-rw-r--r-- 1 root root 6.5K 2012-10-25 16:27 admin.php
-rw-r--r-- 1 root root 3.7K 2012-02-21 00:41 api.php
-rw-r--r-- 1 root root 1.2K 2012-10-06 08:45 index.php
drwxr-xr-x 3 root root 4.0K 2012-10-25 17:11 lib
-rw-r--r-- 1 root root  383 2011-12-28 17:48 slide-show.php
drwxr-xr-x 3 root root 4.0K 2012-10-25 17:11 templates
drwxr-xr-x 2 root root 4.0K 2012-10-19 11:14 templates_c
-rw-r--r-- 1 root root 2.6K 2012-02-21 00:45 webcamfetcher.php
-rw-r--r-- 1 root root  14K 2012-10-06 09:01 wizard.php

now you could remove the lookout zip archive file:

rm lookout-*.zip

next you have to check that the folder templates_c is writeable for the apache user.

chown www-data.www-data templates_c

or, the not so secure way

chmod 777 templates_c

also you have to check the writable flag of the file lib/inc.db.php

ls -l lib/inc.db.php
-rw-rw-r-- 1 www-data www-data 302 2011-02-27 10:49 lib/inc.db.php

if not do

chown www-data.www-data lib/inc.db.php

or, the not so secure way

chmod 666 lib/inc.db.php
create lookout DB and User for the installation wizard

you have to create a new user which has all rights to the lookout database:
Attention!!! Change the 'PASSWORD' field to your prefered secure password!

mysql -h localhost -u root -p


CREATE USER 'lookout'@'localhost' IDENTIFIED BY 'PASSWORD';
GRANT USAGE ON * . * TO 'lookout'@'localhost' IDENTIFIED BY 'PASSWORD' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;
CREATE DATABASE IF NOT EXISTS `lookout` ;
GRANT ALL PRIVILEGES ON `lookout` . * TO 'lookout'@'localhost';
quit

Now you can start the installation wizard by opening it in your browser:

  • http://lookout.domain.tdl/wizard.php

Installation Wizard

Instead of manually doing all the configuration stuff above, there's also a web-based step by step setup wizard available. Actually this feature is highly experimental and not yet released - with a final release, the setup wizard will fully replace the manual configuration! What's behind the Wizard?

pre-installation check

  • check webserver environment
  • check PHP version
  • check PHP MySQL support ( MySQL client version)
  • check write permissions to config file inc.db.php and template cache path
  • check if client-side javaScript is supported/ allowed


Example of failed pre-installation check:


Example of succesful pre-installation check:

If the pre-installation check failed, look at the help page below or click on the help link near the failed line.

database connection

here you have to fill in your Database credentials:
DB-Name: your databasename DB-Administrator: the admin user for the database (the one you have created before) DB-Host: the name or IP address of your database server Table prefix: the table prefix for all tables

Successfully Installation

if everything worked fine you should see this last picture:

environment setup

! not yet implemented !

admin user

! not yet implemented !

Ready to start

now you should get the empty lookout startpage by opening the lookout URL in your browser:

  • http://lookout.domain.tdl

now go to the admin interface by clicking on the yellow/red shield symbol in the right upper corner. Log in with your lookout user and start adding new webcams to your lookout frontend.
First create some Categories:

and then you can create your webcams:

For example:
Title: Fellhorn
URL: http://www.das-hoechste.de/vidnet/fellh.jpg
Type: choose image
WOEID: GMXX0259
Check Category
make sure everything is valid and click save webcam. DONE!










So, if you have questions or any ideas to make lookout better, feel free to mail us: mailto:lookout@laub-home.de