Difference between revisions of "Core repository installation instructions"
From PhotoVoltaic Logger new generation
m |
m (→Via Web frontend) |
||
| (14 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{TOCright}} | {{TOCright}} | ||
| − | At | + | At 1<sup>st</sup> find the document root of your web server, usually <tt>/var/www/htdocs</tt>, <tt>/var/htdocs</tt>, <tt>/srv/www/htdocs</tt> ... |
If you want to run only PVLng on your server, just install PVLng direct into the document root. | If you want to run only PVLng on your server, just install PVLng direct into the document root. | ||
| Line 14: | Line 14: | ||
Go into the directory, you will PVLng install to and execute | Go into the directory, you will PVLng install to and execute | ||
| + | # cd /your/document/root/here | ||
# wget -qO - <nowiki>https://raw.github.com/KKoPV/PVLng/master/install</nowiki> | bash | # wget -qO - <nowiki>https://raw.github.com/KKoPV/PVLng/master/install</nowiki> | bash | ||
The installer will ask for your MySQL credentials, install the basic SQL script and create a basic configuration file with this credentials. | The installer will ask for your MySQL credentials, install the basic SQL script and create a basic configuration file with this credentials. | ||
| + | |||
| + | '''Please note''': The database to install PVLng into must still exist! | ||
=== Development === | === Development === | ||
| Line 22: | Line 25: | ||
If you are interested in the latest development version, you can also direct install the development branch with | If you are interested in the latest development version, you can also direct install the development branch with | ||
| + | # cd /your/document/root/here | ||
# wget -qO - <nowiki>https://raw.github.com/KKoPV/PVLng/develop/install</nowiki> | bash | # wget -qO - <nowiki>https://raw.github.com/KKoPV/PVLng/develop/install</nowiki> | bash | ||
| Line 30: | Line 34: | ||
Just download the archive and extract it direct on your server. | Just download the archive and extract it direct on your server. | ||
| − | # wget | + | # wget <nowiki>https://github.com/KKoPV/PVLng/archive/master.zip</nowiki> |
# unzip master.zip | # unzip master.zip | ||
# mv PVLng-master/* . | # mv PVLng-master/* . | ||
| Line 47: | Line 51: | ||
# mysql -u[username] -p[password] [database] <sql/pvlng.sql | # mysql -u[username] -p[password] [database] <sql/pvlng.sql | ||
| − | This will install all the required tables, a predefined set of channel types, | + | This will install all the required tables, a predefined set of channel types, an example chart and dashboard and some functions. |
=== Via Web frontend === | === Via Web frontend === | ||
| − | + | I recommend Adminer. | |
<blockquote>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. | <blockquote>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. | ||
<cite>http://www.adminer.org</cite></blockquote> | <cite>http://www.adminer.org</cite></blockquote> | ||
| − | |||
| − | |||
Choose <tt>SQL-Query > File upload > Execute</tt> | Choose <tt>SQL-Query > File upload > Execute</tt> | ||
| Line 64: | Line 66: | ||
Prepare the configuration file: | Prepare the configuration file: | ||
| − | # cp config/config.php. | + | # cp config/config.default.php config/config.php |
| + | # $EDITOR config/config.php | ||
| − | Fill in <tt>config.php</tt> at least your database credentials. | + | Fill in <tt>config.php</tt> at least your database credentials '''and''' location. |
== Finalize == | == Finalize == | ||
Latest revision as of 13:44, 3 April 2016
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
# cd /your/document/root/here # 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.
Please note: The database to install PVLng into must still exist!
Development
If you are interested in the latest development version, you can also direct install the development branch with
# cd /your/document/root/here # 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/archive/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, an example chart and dashboard and some functions.
Via Web frontend
I recommend Adminer.
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
Choose SQL-Query > File upload > Execute
Configuration
Prepare the configuration file:
# cp config/config.default.php config/config.php # $EDITOR config/config.php
Fill in config.php at least your database credentials and location.
Finalize
Open afterwards your installation in your browser to finalize the setup.
