Welcome to NeXuS Configuration Server Database's documentation!

Authors: Jan Kotanski, Eugen Wintersberger, Halil Pasic

The package contains SQL files to create the MySQL database for Configuration Server.

NeXuS Configuration Server is a Tango Server with its implementation based on a MySQL database. It allows to store XML configuration datasources and components. It also gives possibility to select mandatory components and perform the process of component merging.

Source code: https://github.com/nexdatas/nxsconfigserver-db
Web page: https://nexdatas.github.io/nxsconfigserver-db

Installation

Install the dependencies:

   MySQLdb, PyTango, sphinx

From sources

Download the latest version of NeXuS Configuration Server from

    https://github.com/nexdatas/nxsconfigserver
    https://github.com/nexdatas/nxsconfigserver-db

Extract the sources and run for both packages

$ python setup.py install

To set database execute

$ mysql < conf/mysql_create.sql

with proper privileges.

Debian packages

Debian Bookworm, Bullseye, Buster as well as Lunar, Jammy, Focal packages can be found in the HDRI repository.

To install the debian packages, add the PGP repository key

$ sudo su
$ wget -q -O - http://repos.pni-hdri.de/debian_repo.pub.gpg | apt-key add -

and then download the corresponding source list

$ cd /etc/apt/sources.list.d
$ wget http://repos.pni-hdri.de/bookworm-pni-hdri.list

Finally,

$ apt-get update
$ apt-get install python-nxsconfigserver nxsconfigserver-db

To instal other NexDaTaS packages

$ apt-get install python-nxswriter nxsconfigtool nxstools

and

$ apt-get install python-nxsrecselector nxselector python-sardana-nxsrecorder

for Component Selector and Sardana related packages.

From pip

To install it from pip you can

$ python3 -m venv myvenv
$ . myvenv/bin/activate

$ pip install nxsconfigserver-db

Moreover it is also good to install mysql to be able to execute

$ mysql < conf/mysql_create.sql

where mysql_create.sql is installed in myvenv/share/nxsconfigserver

Setting NeXus Configuration Server

To set up NeXus Configuration Server with the default configuration run

$ nxsetup -x NXSConfigServer

The nxsetup command comes from the python-nxstools package. It starts the NeXus Configuration Server and tries to find a proper value of the JSONSettings attribute.