Skip to content

Commit

Permalink
First Steps, Intro, requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
SchultzeMax committed Jan 21, 2025
1 parent 7f4c4c6 commit 6e0bcc1
Show file tree
Hide file tree
Showing 4 changed files with 22 additions and 13 deletions.
6 changes: 3 additions & 3 deletions docs/first-steps/3dcitydb.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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!
6 changes: 1 addition & 5 deletions docs/first-steps/citydb-tool.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,4 @@ status: wip
# - tag2
---

Intro content

## hl2

### hl3
Ein einfaches Beispiel für Import und Export von Daten mithilfe des Tools.
12 changes: 10 additions & 2 deletions docs/first-steps/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Intro
title: First Steps
subtitle: Getting started with the 3DCityDB
description:
# icon: material/emoticon-happy
Expand All @@ -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.
11 changes: 8 additions & 3 deletions docs/first-steps/requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

0 comments on commit 6e0bcc1

Please sign in to comment.