We compiled a short [getting started guide](/getting-started) that quickly allows a stand-alone test-deployment of the infrastructure on your server without the need of infrastructure configuration.
We compiled a short [getting started guide](/getting-started) that quickly allows a stand-alone test-deployment of the infrastructure on your server without the need of infrastructure configuration.
## External Systems
We thought the easiest way to make documentation of the endpoints available was through the interactive in-code
* Swagger API .yaml: [/v3/api-docs.yaml](http://dbrepo.ossdip.at:9097/v3/api-docs.yaml)
### Metadata Database
### Metadata Database
It is the core component of the project. It is a relational database that contains metadata about all researcher databases
It is the core component of the project. It is a relational database that contains metadata about all researcher databases
created in the database repository like column names, check expressions, value enumerations or key/value constraints and
created in the database repository like column names, check expressions, value enumerations or key/value constraints and
relevant data for citing data sets. Additionally, the concept, e.g. URI of units of measurements of numerical columns is
relevant data for citing data sets. Additionally, the concept, e.g. URI of units of measurements of numerical columns is
stored in the Metadata Database in order to provide semantic knowledge context. We
stored in the Metadata Database in order to provide semantic knowledge context. We use MariaDB for its rich capabilities
use [PostgreSQL](https://www.postgresql.org/) for its rich capabilities in the reference implementation.
in the reference implementation.
The default credentials are `postgres:postgres` for the database `fda`. Connect to the database via, e.g. *psql*.
```console
The default credentials are `root:dbrepo` for the database `fda`. Connect to the database via the JDBC connector.
psql -d fda -h localhost -p 5432 -U postgres -W
```
!!! debug "Debug Information"
!!! debug "Debug Information"
* Port(s): 5432
* Port(s): 3306
* Swagger: not configured
### Unit Service
### Semantics Service
It is designed to map terms in the domain of units of measurement to controlled vocabulary, modelled in
It is designed to map terms in the domain of units of measurement to controlled vocabulary, modelled in
the [ontology of units of measure](https://github.com/HajoRijgersberg/OM). This service validates researcher provided in
the [ontology of units of measure](https://github.com/HajoRijgersberg/OM). This service validates researcher provided in
units and provides a *uniform resource identifier* (URI) to the related concept, which will be stored in the system.
units and provides a *uniform resource identifier* (URI) to the related concept, which will be stored in the system.
Furthermore, there is a method for auto-completing text and listing a description as well as commonly used unit symbols.
Furthermore, there is a method for auto-completing text and listing a description as well as commonly used unit symbols.
The Unit Service reads units of measurement from [`om-2.ttl`](https://gitlab.phaidra.org/fair-data-austria-db-repository/fda-services/-/blob/master/fda-units-service/onto/om-2.ttl)
and registers a unit. It is used to assign a unit of measurement to a table column.
For the **HTTP API**, the Unit Service assigns a unit of measurement via, e.g. cURL. First the list of concepts can be
queried.
```console
curl -X POST -d '{"offset":0,"ustring":"met"}' https://dbrepo.ossdip.at/api/units/suggest
```
Then the concept needs to be saved into the metadata database.
```console
curl -X POST -d '{"name":"metre","uri":...}' https://dbrepo.ossdip.at/api/units/saveconcept
```
Then the column can be assigned to a table column.
```console
curl -X POST -d '{"cdbid":1,"tid":1,"cid":1,"uri":...}' https://dbrepo.ossdip.at/api/units/savecolumnsconcept
