Skip to main content
Jump to: navigation, search

BaSyx / Download / Components Setup

How to install BaSyx Components

The components package depends on basyx.sdk and is a hierarchical maven project that consists of multiple infrastructure components. Each of them is separated in its own maven project. Therefore each component can be built independently and can have its own dependencies.

In order to install all components to the local maven repository, mvn install can be used like with installing the basyx.sdk. As maven executes all tests before installing the build artifacts into the local repository, you need to make sure all the component's requirements are met beforehand. See the next subsections for the SQL and MongoDB backends. Alternatively, it is possible to directly build the artifacts without these requirements by skipping the maven test phase with mvn install -DskipTests.

Additionally, all of the off-the-shelf components can be used in a Docker environment. All maven projects can also build their correspondent docker images.

SQL components

All SQL components additionally require an SQL backend. This backend can for example be provided by postgreSQL.

During installation of the SQL backend, choose the following credentials:

user: postgres

password: admin

Note: In order to change these default connection settings for the postgreSQL database, the connection data has to be updated in the properties files for the SQL tests in the components project.

To setup the database for the test cases, open up a console and use the following commands:

Create configuration directory:

initdb -D "<db-path>" -U <username>

Where <db-path> is a path to a directory you have the right to write to, and <username> would be "postgres". Now you start the database with

pg_ctl -D "<db-path>" start

Save the following commands to an arbitrary text file. Next, import the database through psql -U postgres -f "<your-file>".

CREATE DATABASE "basyx-map";

CREATE DATABASE "basyx-directory";

Finally, you can install the basyx.components project using maven. See the instructions for the Java SDK on how to do that.


MongoDB components

Similarly, the components based on MongoDB need the MongoDB when executed locally. This can for example be provided by the Community version of the MongoDB MongoDB.

Back to the top