Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "BaSyx / Download / Components Setup"

m (Adds a remark that the components project depends on basyx.sdk)
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
  
= How to run the BaSyx Components=
+
=How to install BaSyx Components=
The Components package requires an SQL backend to be able to run the DirectorySQLProvider. This backend can for example be provided by [https://www.postgresql.org/ postgreSQL].
+
The Components package depends on [[BaSyx_/_Download_/_Java_Setup#Starting_development | basyx.sdk]] and additionally requires an SQL backend to be able to run the DirectorySQLProvider. This backend can for example be provided by [https://www.postgresql.org/ postgreSQL].
  
 
During installation of the SQL backend, choose the following credentials:
 
During installation of the SQL backend, choose the following credentials:
Line 8: Line 8:
  
 
'''password''': admin
 
'''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:
 
To setup the database for the test cases, open up a console and use the following commands:
Line 17: Line 20:
 
Create configuration directory:
 
Create configuration directory:
  
initdb -D "<installation-path>" -U <username>
+
initdb -D "<db-path>" -U <username>
  
Where <installation-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
+
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 "<installation-path>" start
+
pg_ctl -D "<db-path>" start
 
+
and connect your command line interface to the running instance with
+
 
+
psql -U <username>
+
  
 
|-
 
|-
 
|}
 
|}
  
With the following SQL commands you can now create and fill the database as follows:
+
Save the following commands to an arbitrary text file. Next, import the database through psql -U postgres -f "<your-file>".
  
 
{| class="wikitable" style="text-align: left;"
 
{| class="wikitable" style="text-align: left;"
Line 36: Line 35:
 
|
 
|
 
CREATE DATABASE "basyx-map";
 
CREATE DATABASE "basyx-map";
 
\c basyx-map
 
 
CREATE SCHEMA elements;
 
  
 
CREATE DATABASE "basyx-directory";
 
CREATE DATABASE "basyx-directory";
 
\c basyx-directory
 
 
CREATE SCHEMA directory;
 
 
CREATE TABLE directory.directory ( "ElementRef" varchar(999999), "ElementID" varchar(999999) primary key );
 
 
INSERT INTO directory.directory ( "ElementID", "ElementRef" ) VALUES (
 
'urn:de.FHG:es.iese:aas:0.98:5:lab/microscope#A-19', 'content.aas1' );
 
 
INSERT INTO directory.directory ( "ElementID", "ElementRef" ) VALUES (
 
'urn:de.FHG:es.iese:aas:0.98:5:lab/microscope#A-18', 'content.aas2' );
 
 
INSERT INTO directory.directory ( "ElementID", "ElementRef" ) VALUES ( 'urn:de.FHG:es.iese:aas:0.98:5:lab/microscope#A-17', 'content.aas3' );
 
 
INSERT INTO directory.directory ( "ElementID", "ElementRef" ) VALUES ( 'urn:de.FHG:es.iese:aas:0.98:5:lab/microscope#A-16', 'content.aas4' );
 
 
INSERT INTO directory.directory ( "ElementID", "ElementRef" ) VALUES ( 'urn:de.FHG:es.iese:aas:0.98:5:lab/microscope#A-15', 'content.aas5' );
 
  
 
|-
 
|-
 
|}
 
|}
 +
 +
Finally, you can install the basyx.components project using maven. See the instructions for the [[BaSyx_/_Download_/_Java_Setup#Starting_development | Java SDK]] on how to do that.

Revision as of 11:10, 10 March 2020

How to install BaSyx Components

The Components package depends on basyx.sdk and additionally requires an SQL backend to be able to run the DirectorySQLProvider. 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.

Back to the top