Once you have successfully compiled your dSS, this is what you need to run it:

  • webinterface (html-pages)
  • ssl certificate

Run dSS

source ../env.sh
./build-x86/build/dss --webroot=$PREFIX/share/dss-web/webroot \
     --prop:/config/subsystems/WebServer/listen=127.0.0.1:8080,127.0.0.1:8088h \
     --prop:/config/subsystems/WebServer/trustedPort=8088 \
     --prop:/config/subsystems/DSBusInterface/connectionURI=tcp://dss-sdc.local:8442 \
     --prop:/config/loglevel=1

Now you can access your dss through the links:

https://127.0.0.1:8080
http://127.0.0.1:8088

The dss will store apartment information to persistent storage, PREFIX/share/dss/data. hence install the the dss at least once to make sure these directories exist

Note: the installation paths are compiled into the dSS binary, this means that if you ran make install at least once, all expected paths were created, you can run the dSS binary from any place on your system. If needed, the configured paths can still be overridden on the dSS command line

If you the dSS stops with errors from the metering subsystem about the metering path data/metering not existing, run the dss binary from the directory $d such that $d/data/metering exists (it's treated as relative path).th

Install webpages

Note: This will not install the webinterface known from the dss11 hardware, the latter will also reboot your machine, configure your rtc, unlikely that you want that. See Qemu86_image for a virtual image

This reduced interface will allow you to control and configure digitalSTROM components

Install webinterface

https://git.digitalstrom.org/dss-websrc/dss-websrc-mainline

source ../env.sh
autoreconf -i
./configure --prefix=$PREFIX
make
make install

You can change the webroot path permanently via $PREFIX/share/dss/data/config.xml or start the dSS with the -w $prefix/share/dss-web/webroot parameter.

It is possible to build a release and a debug version of the web interface, it will not minimize the JS code and will use debug ExtJS/Sencha libraries. To build the debug version specify the --enable-debug parameter when running the configure script, then run make:

./configure --prefix=$PREFIX --enable-debug
make

Self signed certificate

You need to generate a private key and a certificate. A helper script in the dss-mainline project will do this for you, it will generate a private key, a self signed certificate and it will put them in a file called dsscert.pem. Make sure that openssl is installed on your system

source ../env.sh
tools/create_cert.sh
cp dsscert.pem $PREFIX/share/dss/data