Deployment

Easy ways of deployment are important for possible users and contributers to quickly try explore stromx. Building packages or installers for several platforms frequently helps to discover bugs and build issues early.

Compile from sources

The current source code of stromx and stromx-studio can be obtained as explained in GitWorkflow. Provided that you have all the necessary Prerequisites you can build both projects using the Build guide.

Source archives of tagged versions

It is planned to provide compressed archives containing the source code of tagged versions at github (stromx and stromx-studio) as soon as the first versions are tagged.

Install packages for major Linux distribution

Packages for OpenSUSE/Fedora and Ubuntu exist. The packages are automatically rebuilt when the sources in the git repository change.

Raspbian

Packages for Raspbian can be build from the source on the target system, i.e. on a Raspberry Pi.

• Download or clone the source tree from this Github repository OR

• Download the Debian source package from Launchpad and run

  dpgk-source -x stromx*.dsc

  to unpack the source package.

• Adapt the Debian changelog to Raspian, e.g. stromx (0.3.0raspbian1) wheezy, urgency = low.

• Install all build dependencies as stated in the debian/control file. Alternatively, this guide recommends running apt-get build-dep stromx*.dsc to get all dependencies.

• Enter the source directory and build the Debian package:

  dpkg-buildpackage -rfakeroot -uc -b

Windows installer

In the long run Windows installer packages for both for tagged versions of stromx and stromx-studio should be available at github. It should also be possible to build these installers from the sources with as little prerequisites as possible such that frequent building and testing of Windows versions becomes feasible. Currently, only an installer package for stromx-studio is available. To build it follow the steps below:

• Install the WiX Toolset.
• Create an installation directory which contains all necessary 3rd party DLLs. These are listed in the file wix/stromx-studio.wxs.
• Build both projects on Windows. This requires building all prerequisites for which no precompiled binaries can be found.
• Install both projects into to the common installation directory using the INSTALL targets of the respective Visual Studio solutions.
• Copy the file wix/stromx-studio.wxs to the installation directory.

To build an *.msi installer package, open a Windows shell. Enter the installation directory and execute the following commands:

> candle stromx-studio.wxs
> light stromx-studio.wixobj