This chapter describes the steps for a manual installation (eg. not using the vagrant script and puppet scripts). This chapter is for developers who would like to have more control over the installation procedure.
With the increased control come increased risks of things not working with the versions or configuration of the software involved with the OSGP environment. If you run into issues, you may find clues in the puppet scripts about versions and modifications to the configuration of installed software.
The Open Smart Grid Platform runs on a Linux environment. It is recommended to set up a machine running Ubuntu.
The Open Smart Grid platform needs the following software and tools installed/downloaded:
It is recommended to create a 'dev' user, because some scripts contain hard coded references to this 'dev' user. It is possible to skip this step, but then some of the scripts will have to be adjusted manually.
Clone the following repo's, it is recommended to create a
Sources/OSGP directory in
/home/dev/ since some scripts contain hard coded references to those folders.
git clone https://github.com/OSGP/Config.git /home/dev/Sources/OSGP/Config git clone https://github.com/OSGP/open-smart-grid-platform.git /home/dev/Sources/OSGP/open-smart-grid-platform git clone https://github.com/OSGP/Documentation.git /home/dev/Sources/OSGP/Documentation
Make sure you are on the development branch (default).
Create the following directories:
Make the dev user (or equivalent) the owner of the log directory with rwx permission. Give the other users read and execute permission.
Execute the script
Note This script uses hard coded references to
/home/dev/Sources/OSGP/*, if you used a different user, please edit the script before executing it.
The script will make symlinks to certificates, to Apache HTTP server configuration and copy configuration settings as samples to locations where these properties may be overridden.
To create the database run the following command (Change /home/dev/ in case of no dev user)
sudo -u postgres /usr/bin/psql -p 5432 -f /home/dev/Sources/OSGP/Config/sql/create-users-and-databases.sql
And create a backup of the pg_hba.conf file (modify if your version of PostgreSQL is different)
cp -p /etc/postgresql/9.4/main/pg_hba.conf /etc/postgresql/9.4/main/pg_hba.backup
Finally, reload the postgresql service:
service postgresql reload
Continue with setting up the Open Smart Grid Platform by following the Set up the Open Smart Grid Platform Guide