diff --git a/docs/first-steps/3dcitydb.md b/docs/first-steps/3dcitydb.md index 22c5e7d..23b5613 100644 --- a/docs/first-steps/3dcitydb.md +++ b/docs/first-steps/3dcitydb.md @@ -1,6 +1,6 @@ --- -title: 3DCityDB -subtitle: Getting started with the 3DCityDB +title: Migration from previous releases +subtitle: description: # icon: material/emoticon-happy status: wip @@ -9,4 +9,4 @@ status: wip # - tag2 --- -The 3D City Database serves as a central data management component for 3D city models. It enables the consistent storage of 3D geodata content, enabling long-term viability of the data. It includes a relational database schema for implementing a CityGML-compliant database on top of a database management system (DBMS), a Java-based database client for data import and export. Currently, the most advanced open-source PostgreSQL/PostGIS geodatabase systems is supported. +Ich würde hier die Migrationsdetails in Bezug auf die Datenbank hinschieben anstatt die gleich beim Welcome zu haben! \ No newline at end of file diff --git a/docs/first-steps/citydb-tool.md b/docs/first-steps/citydb-tool.md index effafc4..26f51ad 100644 --- a/docs/first-steps/citydb-tool.md +++ b/docs/first-steps/citydb-tool.md @@ -9,8 +9,4 @@ status: wip # - tag2 --- -Intro content - -## hl2 - -### hl3 +Ein einfaches Beispiel für Import und Export von Daten mithilfe des Tools. diff --git a/docs/first-steps/index.md b/docs/first-steps/index.md index 28c3560..9184696 100644 --- a/docs/first-steps/index.md +++ b/docs/first-steps/index.md @@ -1,5 +1,5 @@ --- -title: Intro +title: First Steps subtitle: Getting started with the 3DCityDB description: # icon: material/emoticon-happy @@ -9,4 +9,12 @@ status: wip # - tag2 --- -- Clarification of compatibility of 3DCityDB <--> Tools +This quickstart guide gives step-by-step instructions for setting up a 3D City Database instance and CityDB tools. Installers for the 3D City Database components can be downloaded from the [official release website](https://github.com/3dcitydb/3dcitydb-suite/releases) or from the [project website](https://www.3dcitydb.org/3dcitydb/downloads/). The source code of the 3D City Database is hosted and maintained on [GitHub](https://github.com/3dcitydb). + +- [System requirements](requirements.md) +- [Setting up the 3DCityDB schema](setup.md) +- [Migration from previous releases](3dcitydb.md) +- [CityDB tools](citydb-tool.md) +- [Docker Images](docker.md) + +The individual components of the 3D City Database are also available as images for the Docker virtualization technology. This makes it possible to install and configure a 3D City Database with a single command line statement in almost any runtime environment. See Section [Docker](docker.md) for more details. diff --git a/docs/first-steps/requirements.md b/docs/first-steps/requirements.md index 93f67f3..1e101d8 100644 --- a/docs/first-steps/requirements.md +++ b/docs/first-steps/requirements.md @@ -8,10 +8,15 @@ status: wip # - tag1 # - tag2 --- -# Requirements +# System Requirements -Setting up an instance of the 3D City Database requires an existing installation of a PostgreSQL. +Setting up an instance of the 3D City Database requires an existing installation of a [PostgreSQL](https://www.postgresql.org/). # PostgreSQL with PostGIS extension -Supported versions are PostgreSQL 11 and higher with PostGIS 2.5 and higher. Make sure to check the PostgreSQL versioning policy to find out which PostgreSQL are actively maintained or have reached end-of-life. The PostGIS support matrix shows which versions of PostgreSQL are supported by which versions of PostGIS and whether a specific PostGIS version has reached end-of-life. +Supported versions are PostgreSQL 13 and higher with PostGIS 3.0 and higher. Make sure to check the [PostgreSQL versioning policy](https://www.postgresql.org/support/versioning/) to find out which PostgreSQL versions are actively maintained or have reached end-of-life. The [PostGIS support matrix](https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS) shows which versions of PostgreSQL are supported by which versions of PostGIS and whether a specific PostGIS version has reached end-of-life. + +!!! info "NOTE" + It is recommended that you always install the latest patches, minor releases, and security updates for your database system. Database versions that have reached end-of-life are no longer supported by the 3D City Database. + +The SQL scripts for creating the 3D City Database schema are written to be executed by the default command-line client of either database system – namely psql for PostgreSQL. The scripts include meta commands specific to these clients and would not work properly when using a different client software. So please make sure psql is installed on the machine from where you want to set up the 3D City Database.