LookOut - Webcam Overview Tool - Advanced-Installation
What about
Requirements
- Webserver (apache2)
- PHP 5
- MySQL Database 5.0
- HTBasic Auth
Installation
- check the preinstallation tasks
- configure apache httpd server
- download lookout
- unzip it to webservers documentroot
- create lookout database user and table
- start the installation wizard
- login to admin panel
- copy and paste webcam links
- 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