Permalink
Fetching contributors…
Cannot retrieve contributors at this time
151 lines (88 sloc) 4.57 KB

Install

Linux

For the following Linux distributions and package managers 0.8 packages are available:

Available, but not up-to-date:

For OpenSUSE, CentOS, Fedora, RHEL and SLE Kai-Uwe Behrmann kindly provides packages for download.

Debian

To use the debian repository of the latest builds from master put following lines in /etc/apt/sources.list:

For Stretch:

    deb     [trusted=yes] https://debian-stretch-repo.libelektra.org/ stretch main
    deb-src [trusted=yes] https://debian-stretch-repo.libelektra.org/ stretch main

Which can also be done using:

    echo "deb     [trusted=yes] https://debian-stretch-repo.libelektra.org/ stretch main" | sudo tee /etc/apt/sources.list.d/elektra.list

Or alternatively, you can use (if you do not mind many dependences just to add one line to a config file):

    sudo apt-get install software-properties-common apt-transport-https
    sudo add-apt-repository "deb     [trusted=yes] https://debian-stretch-repo.libelektra.org/ stretch main"

For Jessie:

    deb     [trusted=yes] https://debian-stable.libelektra.org/elektra-stable/ jessie main
    deb-src [trusted=yes] https://debian-stable.libelektra.org/elektra-stable/ jessie main

For Wheezy (not updated anymore, contains 0.8.19-8121 packages):

    deb     [trusted=yes] https://build.libelektra.org/debian/ wheezy main
    deb-src [trusted=yes] https://build.libelektra.org/debian/ wheezy main

To get all packaged plugins, bindings and tools install:

apt-get install libelektra4-all

For a small installation with command-line tools available use:

apt-get install elektra-bin

If you want to rebuild Elektra from Debian unstable or our repositories, add a deb-src entry to /etc/apt/sources.list and then run:

apt-get source -b elektra

To build Debian Packages from the source you might want to use:

dpkg-buildpackage -us -uc -sa

(You need to be in the Debian branch, see GIT)

macOS

You can install Elektra using Homebrew via the shell command:

brew install elektra

. We also provide a tap containing a more elaborate formula here.

Generic

First follow the steps in COMPILE.

To install Elektra use:

sudo make install
sudo ldconfig  # See troubleshooting below

To uninstall Elektra use (will not be very clean, e.g. it will not remove directories and *.pyc files):

sudo make uninstall
sudo ldconfig

or in the build directory (will not honor DESTDIR!):

xargs rm < install_manifest.txt

CPack

First follow the steps in COMPILE.

Then use:

cpack

which should create a package for distributions where a Generator is implemented. See this cmake file for available Generators and send a merge request for your system.

Troubleshooting

Error Loading Libraries

If you encounter the problem that the library can not be found (output like this)

kdb: error while loading shared libraries:
     libelektra-core.so.4: cannot open shared object file: No such file or directory

or:

kdb: error while loading shared libraries:
     libelektratools.so.2: cannot open shared object file: No such file or directory

you need to place a configuration file at /etc/ld.so.conf.d/ (e.g. /etc/ld.so.conf.d/elektra.conf).

Add the path where the library has been installed

/usr/lib/local/

and run ldconfig as root.

Installation Manuals

For some of the plugins and tools that ship with Elektra, additional installation manuals have been written. You can find them in the tutorial overview.

See also