Installation

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 -O master.zip https://github.com/KKoPV/PVLng/zipball/master
# 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.

PVLng-Scripts repository

Install with Git by cloning

# git clone https://github.com/KKoPV/PVLng-scripts.git

or download an archive

# wget -O master.zip https://github.com/KKoPV/PVLng-scripts/zipball/master
# unzip master.zip
# mv PVLng-scripts-master/* .
# rm -r master.zip PVLng-scripts-master

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.