Difference between revisions of "Installation"
From PhotoVoltaic Logger new generation
m (→Installation / PVLng core repository) |
m (→Configuration) |
||
Line 79: | Line 79: | ||
Choose <tt>SQL-Query > File upload > Execute</tt> | Choose <tt>SQL-Query > File upload > Execute</tt> | ||
− | == Configuration == | + | === Configuration === |
Prepare the configuration file: | Prepare the configuration file: |
Revision as of 10:34, 7 April 2014
Contents
Hardware requirements
- A server, which fits the software requirements :-)
- Some sensors, like 1-Wire sensors, watt meters
- Solar inverter which supports either
- live query of data (SMA Webbox, Fronius, Kaco
- write data in short intervals (quasi-live) somewhere
Software requirements
- Operating system with support of periodic job scheduling (for example *nix with cron)
- MySQL ≥ 5.1.* (supports table partitions, views, trigger, functions, procedures and events)
- PHP ≥ 5.3.*
- Web server with PHP support, tested with Apache, Litespeed and Nginx (recommended)
Installation
The system is devided into 2 repositories, the PVLng core repo with web frontend and API and the PVLng-Scripts repo with the data aquisition scripts.
PVLng core repository
At 1st find the document root of your web server, usually /var/www/htdocs, /var/htdocs, /srv/www/htdocs ...
If you want to run only PVLng on your server, just install PVLng direct into the document root.
If you have more running on your server, setup a own document root for PVLng.
Install with Git
Stable
If your system have Git installed, it will be simplest way to clone the Github repositories from GitHub.
Go into the directory, you will PVLng install to and execute
# wget -qO - https://raw.github.com/KKoPV/PVLng/master/install | bash
The installer will ask for your MySQL credentials, install the basic SQL script and create a basic configuration file with this credentials.
Development
If you are interested in the latest development version, you can also direct install the development branch with
# wget -qO - https://raw.github.com/KKoPV/PVLng/develop/install | bash
Open afterwards your installation in your browser to finalize the setup.
Manual installation
Just download the archive and extract it direct on your server.
# wget https://github.com/KKoPV/PVLng/zipball/master -O master.zip # unzip master.zip # mv PVLng-master/* . # rm -r master.zip PVLng-master
Database setup
Create a database for PVLng if you want. (This is recommend, but not required)
All PVLng specific tables have a pvlng_ as prefix.
Import the SQL file sql/pvlng.sql into your database.
From command line
# mysql -u[username] -p[password] [database] <sql/pvlng.sql
This will install all the required tables, a predefined set of channel types, a view and some functions.
Via Web frontend
PVLng have Adminer installed by default.
Adminer (formerly phpMinAdmin) is a full-featured database management tool written in PHP. Conversely to phpMyAdmin, it consist of a single file ready to deploy to the target server. http://www.adminer.org
http://your.domain.here/adminer/
Choose SQL-Query > File upload > Execute
Configuration
Prepare the configuration file:
# cp config/config.php.dist config/config.php
Fill in config.php at least your database credentials.
Finalize
Open afterwards your installation in your browser to finalize the setup.
Installation / PVLng-Scripts repository
Install with Git by cloning
# git clone https://github.com/KKoPV/PVLng-scripts.git
or download an archive
# wget https://github.com/KKoPV/PVLng-scripts/archive/master.zip
Afterwards prepare the configuration file with
# cp PVLng.conf.dist PVLng.conf
Fill in at least your API key, you can find it on the information page.