Update instructions for GeoNetwork 4
This commit is contained in:
Juan Luis Rodríguez
parent
b000c3181c
commit
c36fe01925
|
|
@ -12,50 +12,156 @@ The project is part of the Open Source Geospatial Foundation ( [OSGeo](http://ww
|
|||
|
||||
%%LOGO%%
|
||||
|
||||
# How to use this image
|
||||
## How to use this image
|
||||
|
||||
## Start geonetwork
|
||||
GeoNetwork 4 uses an Elasticsearch server to store the index of the documents it manages so **it can't be run without configuring the URL of the Elasticsearch server**.
|
||||
|
||||
This command will start a debian-based container, running a Tomcat web server, with a geonetwork war deployed on the server:
|
||||
This is a quick example of how to get GeoNetwork 4.4 Latest up and running for demo purposes. This configuration doesn't keep the data if containers are removed.
|
||||
|
||||
```console
|
||||
$ docker run --name some-%%REPO%% -d %%IMAGE%%
|
||||
docker pull elasticsearch:7.17.15
|
||||
docker pull %%IMAGE%%:4
|
||||
|
||||
docker network create gn-network
|
||||
|
||||
docker run -d --name my-es-host --network gn-network -e "discovery.type=single-node" elasticsearch:7.17.15
|
||||
docker run --name %%REPO%%-host --network gn-network -e GN_CONFIG_PROPERTIES="-Des.host=my-es-host -Des.protocol=http -Des.port=9200 -Des.url=http://my-es-host:9200" -p 8080:8080 %%IMAGE%%:4
|
||||
```
|
||||
|
||||
## Publish port
|
||||
|
||||
Geonetwork listens on port `8080`. If you want to access the container at the host, **you must publish this port**. For instance, this, will redirect all the container traffic on port 8080, to the same port on the host:
|
||||
For GeoNetwork 4.2 Stable:
|
||||
|
||||
```console
|
||||
$ docker run --name some-%%REPO%% -d -p 8080:8080 %%IMAGE%%
|
||||
docker pull elasticsearch:7.17.15
|
||||
docker pull %%IMAGE%%:4.2
|
||||
|
||||
docker network create gn-network
|
||||
|
||||
docker run -d --name my-es-host --network gn-network -e "discovery.type=single-node" elasticsearch:7.17.15
|
||||
docker run --name %%REPO%%-host --network gn-network -e ES_HOST=my-es-host -e ES_PROTOCOL=http -e ES_PORT=9200 -p 8080:8080 %%IMAGE%%:4.2
|
||||
```
|
||||
|
||||
To be sure about what Elasticsearch version to use you can check the [GeoNetwork documentation](https://docs.geonetwork-opensource.org/4.4/install-guide/installing-index/) for your GN version or the `es.version` property in the [`pom.xml`](https://github.com/geonetwork/core-geonetwork/blob/main/pom.xml#L1528C17-L1528C24) file of the GeoNetwork release used.
|
||||
|
||||
### Elasticsearch configuration
|
||||
|
||||
#### Java properties (version 4.4.0 and newer)
|
||||
|
||||
Since GeoNetwork 4.4.0 the configuration is done using Java properties passed in the `GN_CONFIG_PROPERTIES` environment variable. Property names used for setting the Elasticsearh connection are:
|
||||
|
||||
- `es.host`: *optional* (default `localhost`): The host name of the Elasticsearch server.
|
||||
- `es.port` *optional* (default `9200`): The port where Elasticsearch server is listening to.
|
||||
- `es.protocol` *optional* (default `http`): The protocol used to talk to Elasticsearch. Can be `http` or `https`.
|
||||
- `es.url`: **mandatory if host, port or protocol aren't the default values** (default `http://localhost:9200`): Full URL of the Elasticsearch server.
|
||||
- `es.index.records` *optional* (default `gn_records`): In case you have more than GeoNetwork instance using the same Elasticsearch cluster each one needs to use a different index name. Use this variable to define the name of the index used by each GeoNetwork.
|
||||
- `es.username` *optional (default empty): username used to connect to Elasticsearch.
|
||||
- `es.password` *optional (default empty): password used to connect to Elasticsearch.
|
||||
- `kb.url` *Optional* (default `http://localhost:5601`): The URL where Kibana is listening.
|
||||
|
||||
For example, define this environment variable to pass these values to GeoNetwork:
|
||||
|
||||
```yaml
|
||||
services:
|
||||
%%REPO%%:
|
||||
image: %%IMAGE%%:4.4
|
||||
environment:
|
||||
GN_CONFIG_PROPERTIES: >-
|
||||
-Des.host=elasticsearch
|
||||
-Des.protocol=http
|
||||
-Des.port=9200
|
||||
-Des.url=http://elasticsearch:9200
|
||||
-Des.username=my_es_username
|
||||
-Des.password=my_es_password
|
||||
-Dkb.url=http://kibana:5601
|
||||
```
|
||||
|
||||
#### Environment variables (version 4.2 and older)
|
||||
|
||||
If you are using a GeoNetwork older than 4.4.0 it must be configured using these environment variables:
|
||||
|
||||
- `ES_HOST` **mandatory**: The host name of the Elasticsearch server.
|
||||
- `ES_PORT` *optional* (default `9200`): The port where Elasticsearch server is listening to.
|
||||
- `ES_PROTOCOL` *optional* (default `http`): The protocol used to talk to Elasticsearch. Can be `http` or `https`.
|
||||
- `ES_INDEX_RECORDS` *optional* (default `gn_records`): In case you have more than GeoNetwork instance using the same Elasticsearch cluster each one needs to use a different index name. Use this variable to define the name of the index used by each GeoNetwork.
|
||||
- `ES_USERNAME` *optional (default empty): username used to connect to Elasticsearch.
|
||||
- `ES_PASSWORD` *optional (default empty): password used to connect to Elasticsearch.
|
||||
- `KB_URL` *Optional* (default `http://localhost:5601`): The URL where Kibana is listening.
|
||||
|
||||
### Database configuration
|
||||
|
||||
By default GeoNetwork uses a local **H2 database** for demo use (this one is **not recommended for production**). The image contains JDBC drivers for PostgreSQL and MySQL. To configure the database connection use these environment variables:
|
||||
|
||||
- `GEONETWORK_DB_TYPE`: The type of database to use. Valid values are `postgres`, `postgres-postgis`, `mysql`. The image can be extended including other drivers and these other types could be used too: `db2`, `h2`, `oracle`, `sqlserver`. The JAR drivers for these other databases would need to be added to `/opt/geonetwork/WEB-INF/lib` mounting them as binds or extending the official image.
|
||||
- `GEONETWORK_DB_HOST`: The database host name.
|
||||
- `GEONETWORK_DB_PORT`: The database port.
|
||||
- `GEONETWORK_DB_NAME`: The database name.
|
||||
- `GEONETWORK_DB_USERNAME`: The username used to connect to the database.
|
||||
- `GEONETWORK_DB_PASSWORD`: The password used to connect to the database.
|
||||
- `GEONETWORK_DB_CONNECTION_PROPERTIES`: Additional properties to be added to the connection string, for example `search_path=test,public&ssl=true` will produce a JDBC connection string like `jdbc:postgresql://localhost:5432/postgres?search_path=test,public&ssl=true`
|
||||
|
||||
### Start GeoNetwork
|
||||
|
||||
This command will start a debian-based container, running a Tomcat (GN 3) or Jetty (GN 4) web server, with a GeoNetwork WAR deployed on the server:
|
||||
|
||||
```console
|
||||
docker run --name some-%%REPO%% -d %%IMAGE%%
|
||||
```
|
||||
|
||||
### Publish port
|
||||
|
||||
GeoNetwork listens on port `8080`. If you want to access the container at the host, **you must publish this port**. For instance, this, will redirect all the container traffic on port 8080, to the same port on the host:
|
||||
|
||||
```console
|
||||
docker run --name some-%%REPO%% -d -p 8080:8080 %%IMAGE%%
|
||||
```
|
||||
|
||||
Then, if you are running docker on Linux, you may access geonetwork at http://localhost:8080/geonetwork. Otherwise, replace `localhost` by the address of your docker machine.
|
||||
|
||||
## Set the data directory and H2 db file
|
||||
### Set the data directory and H2 db file
|
||||
|
||||
The data directory is the location on the file system where the catalog stores much of its custom configuration and uploaded files. It is also where it stores a number of support files, used for various purposes (e.g.: Lucene index, spatial index, thumbnails). The default variant also uses a local H2 database to store the metadata catalog itself.
|
||||
The data directory is the location on the file system where the catalog stores much of its custom configuration and uploaded files. It is also where it stores a number of support files, used for various purposes (e.g.: spatial index, thumbnails). The default variant also uses a local H2 database to store the metadata catalog itself.
|
||||
|
||||
By default, geonetwork sets the data directory on `/usr/local/tomcat/webapps/geonetwork/WEB-INF/data` and H2 database file to the tomcat bin dir `/usr/local/tomcat/gn.h2.db`, but you may override these values by injecting environment variables into the container: - `-e DATA_DIR=...` (defaults to `/usr/local/tomcat/webapps/geonetwork/WEB-INF/data`) and `-e GEONETWORK_DB_NAME=...` (defaults to `gn` which sets up database `gn.h2.db` in tomcat bin dir `/usr/local/tomcat`). Note that setting the database location via `GEONETWORK_DB_NAME` only works from version 3.10.3 onwards.
|
||||
By default, GeoNetwork sets the data directory on `/opt/geonetwork/WEB-INF/data` and H2 database file to the Jetty dir `/var/lib/jetty/gn.h2.db` (since GN 4.0.0) or Tomcat `/usr/local/tomcat/gn.h2.db` (for GN 3), but you may override these values by injecting environment variables into the container: - `-e DATA_DIR=...` (defaults to `/opt/geonetwork/WEB-INF/data`) and `-e GEONETWORK_DB_NAME=...` (defaults to `gn` which sets up database `gn.h2.db` in tomcat bin dir `/usr/local/tomcat`). Note that setting the database location via `GEONETWORK_DB_NAME` only works from version 3.10.3 onwards.
|
||||
|
||||
## Persisting data
|
||||
|
||||
To set the data directory to `/var/lib/geonetwork/data` and H2 database file to `/var/lib/geonetwork/db/gn.h2.db` so they both persist through restarts:
|
||||
Since version 4.4.0 the data directory needs to be configued using Java properties passed in the `GN_CONFIG_PROPERTIES` environment variable. For example:
|
||||
|
||||
```console
|
||||
$ docker run --name some-%%REPO%% -d -p 8080:8080 -e DATA_DIR=/var/lib/geonetwork/data -e GEONETWORK_DB_NAME=/var/lib/geonetwork/db/gn %%IMAGE%%
|
||||
docker run --name some-%%REPO%% -d -p 8080:8080 -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn %%IMAGE%%
|
||||
```
|
||||
|
||||
If you want the data directory to live beyond restarts, or even destruction of the container, you can mount a directory from the docker engine's host into the container. - `-v /host/path:/path/to/data/directory`. For instance this, will mount the host directory `/host/geonetwork-docker` into `/var/lib/geonetwork` on the container:
|
||||
### Persisting data
|
||||
|
||||
To set the data directory to `/catalogue-data/data` and H2 database file to `/catalogue-data/db/gn.h2.db` so they both persist through restarts:
|
||||
|
||||
- GeoNetwork 4.2 and older
|
||||
|
||||
```console
|
||||
$ docker run --name some-%%REPO%% -d -p 8080:8080 -e DATA_DIR=/var/lib/geonetwork/data -e GEONETWORK_DB_NAME=/var/lib/geonetwork/db/gn -v /host/geonetwork-docker:/var/lib/geonetwork %%IMAGE%%
|
||||
docker run --name some-%%REPO%% -d -p 8080:8080 -e DATA_DIR=/catalogue-data/data -e GEONETWORK_DB_NAME=/catalogue-data/db/gn %%IMAGE%%:3
|
||||
```
|
||||
|
||||
## %%STACK%%
|
||||
- Since GeoNetwork 4.4.0
|
||||
|
||||
```console
|
||||
docker run --name some-%%REPO%% -d -p 8080:8080 -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn %%IMAGE%%
|
||||
```
|
||||
|
||||
If you want the data directory to live beyond restarts, or even destruction of the container, you can mount a directory from the docker engine's host into the container. - `-v /host/path:/path/to/data/directory`. For instance this, will mount the host directory `/host/%%REPO%%-docker` into `/catalogue-data` on the container:
|
||||
|
||||
- GeoNetwork 4.2 and older
|
||||
|
||||
```console
|
||||
docker run --name some-%%REPO%% -d -p 8080:8080 -e DATA_DIR=/catalogue-data/data -e GEONETWORK_DB_NAME=/catalogue-data/db/gn -v /host/%%REPO%%-docker:/catalogue-data %%IMAGE%%:3
|
||||
```
|
||||
|
||||
- GeoNetwork 4.4.0 and newer
|
||||
|
||||
```console
|
||||
docker run --name some-%%REPO%% -d -p 8080:8080 -e GN_CONFIG_PROPERTIES="-Dgeonetwork.dir=/catalogue-data" -e GEONETWORK_DB_NAME=/catalogue-data/db/gn -v /host/%%REPO%%-docker:/catalogue-data %%IMAGE%%
|
||||
```
|
||||
|
||||
### %%STACK%%
|
||||
|
||||
Run `docker stack deploy -c stack.yml %%REPO%%` (or `docker-compose -f stack.yml up`), wait for it to initialize completely, and visit `http://swarm-ip:8080/geonetwork`, `http://localhost:8080/geonetwork`, or `http://host-ip:8080/geonetwork` (as appropriate).
|
||||
|
||||
## Default credentials
|
||||
### Default credentials
|
||||
|
||||
After installation a default user with name `admin` and password `admin` is created. Use this credentials to start with. It is recommended to update the default password after installation.
|
||||
|
|
|
|||
|
|
@ -5,18 +5,117 @@
|
|||
# Default user: admin
|
||||
# Default password: admin
|
||||
|
||||
version: '3.1'
|
||||
services:
|
||||
|
||||
geonetwork:
|
||||
image: geonetwork
|
||||
restart: always
|
||||
ports:
|
||||
- 8080:8080
|
||||
environment:
|
||||
DATA_DIR: /var/lib/geonetwork_data
|
||||
volumes:
|
||||
- geonetwork:/var/lib/geonetwork_data
|
||||
version: '3.8'
|
||||
|
||||
volumes:
|
||||
geonetwork:
|
||||
esdata:
|
||||
pgdata:
|
||||
pglog:
|
||||
|
||||
services:
|
||||
geonetwork:
|
||||
image: geonetwork:4.4
|
||||
healthcheck:
|
||||
test: curl http://localhost:8080/
|
||||
interval: 5s
|
||||
timeout: 5s
|
||||
retries: 30
|
||||
restart: always
|
||||
volumes:
|
||||
- geonetwork:/catalogue-data
|
||||
depends_on:
|
||||
database:
|
||||
condition: service_healthy
|
||||
ports:
|
||||
- 8080:8080
|
||||
environment:
|
||||
WEBAPP_CONTEXT_PATH: /geonetwork
|
||||
DATA_DIR: /catalogue-data
|
||||
TZ: Europe/Amsterdam
|
||||
|
||||
JAVA_OPTS: >-
|
||||
--add-opens=jdk.management/com.sun.management.internal=ALL-UNNAMED
|
||||
-Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true
|
||||
-Xms512M -Xss512M -Xmx2G -XX:+UseConcMarkSweepGC
|
||||
-Djetty.httpConfig.requestHeaderSize=32768
|
||||
-Dorg.eclipse.jetty.server.Request.maxFormContentSize=500000
|
||||
-Dorg.eclipse.jetty.server.Request.maxFormKeys=4000
|
||||
# For remote debug
|
||||
# -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005
|
||||
|
||||
GN_CONFIG_PROPERTIES: >-
|
||||
-Dgeonetwork.dir=/catalogue-data
|
||||
-Dgeonetwork.formatter.dir=/catalogue-data/data/formatter
|
||||
-Dgeonetwork.schema.dir=/opt/geonetwork/WEB-INF/data/config/schema_plugins
|
||||
-Dgeonetwork.indexConfig.dir=/opt/geonetwork/WEB-INF/data/config/index
|
||||
-Dgeonetwork.schemapublication.dir=/opt/geonetwork/WEB-INF/data/resources/schemapublication
|
||||
-Dgeonetwork.htmlcache.dir=/opt/geonetwork/WEB-INF/data/resources/htmlcache
|
||||
-Des.host=elasticsearch
|
||||
-Des.protocol=http
|
||||
-Des.port=9200
|
||||
-Des.url=http://elasticsearch:9200
|
||||
-Des.username=
|
||||
-Des.password=
|
||||
-Dgeonetwork.ESFeaturesProxy.targetUri=http://elasticsearch:9200/gn-features/{_}
|
||||
-Dgeonetwork.HttpDashboardProxy.targetUri=http://kibana:5601
|
||||
|
||||
GEONETWORK_DB_TYPE: postgres-postgis
|
||||
GEONETWORK_DB_HOST: database
|
||||
GEONETWORK_DB_PORT: 5432
|
||||
GEONETWORK_DB_NAME: geonetwork
|
||||
GEONETWORK_DB_USERNAME: geonetwork
|
||||
GEONETWORK_DB_PASSWORD: geonetwork
|
||||
|
||||
database:
|
||||
image: postgis/postgis:16-3.4
|
||||
environment:
|
||||
POSTGRES_USER: geonetwork
|
||||
POSTGRES_PASSWORD: geonetwork
|
||||
POSTGRES_DB: geonetwork
|
||||
command: [postgres, -c, log_statement=all, -c, logging_collector=true, -c, log_file_mode=0644,
|
||||
-c, log_directory=/var/log/postgresql, -c, log_filename=postgresql.log]
|
||||
healthcheck:
|
||||
test: [CMD-SHELL, pg_isready -U postgres]
|
||||
interval: 5s
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
volumes:
|
||||
- pgdata:/var/lib/postgresql/data
|
||||
- pglog:/var/log/postgresql
|
||||
|
||||
elasticsearch:
|
||||
image: elasticsearch:7.17.15
|
||||
ports:
|
||||
- 9200:9200
|
||||
ulimits:
|
||||
memlock:
|
||||
soft: -1
|
||||
hard: -1
|
||||
nofile:
|
||||
soft: 65536
|
||||
hard: 65536
|
||||
healthcheck:
|
||||
test: curl -s http://localhost:9200 >/dev/null || exit 1
|
||||
interval: 10s
|
||||
timeout: 2s
|
||||
retries: 10
|
||||
start_period: 2m
|
||||
environment:
|
||||
ES_JAVA_OPTS: -Xms1G -Xmx1G
|
||||
discovery.type: single-node
|
||||
volumes:
|
||||
- esdata:/usr/share/elasticsearch/data
|
||||
|
||||
kibana:
|
||||
image: kibana:7.17.15
|
||||
environment:
|
||||
SERVER_NAME: kibana
|
||||
ELASTICSEARCH_URL: http://elasticsearch:9200/
|
||||
SERVER_BASEPATH: /geonetwork/dashboards
|
||||
SERVER_REWRITEBASEPATH: 'false'
|
||||
KIBANA_INDEX: .dashboards
|
||||
XPACK_MONITORING_UI_CONTAINER_ELASTICSEARCH_ENABLED: 'true'
|
||||
depends_on:
|
||||
elasticsearch:
|
||||
condition: service_healthy
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
## `%%REPO%%:postgres`
|
||||
## `%%REPO%%:postgres` (Only for GeoNetwork 3 series)
|
||||
|
||||
This image gives support for using [PostgreSQL](https://www.postgresql.org/) as database engine for geonetwork. When you start the container, a database is created, and it is populated by geonetwork, once it starts.
|
||||
|
||||
|
|
@ -15,25 +15,25 @@ If you want to connect to a postgres server, you need to pass an extra environme
|
|||
If you want to connect to an **external database server**, you can use either the IP address or the DNS as `POSTGRES_DB_HOST`. For instance, if the server is running on `mydns.net`, on port `5434`, the username is `postgres` and the password is `mysecretpassword`:
|
||||
|
||||
```console
|
||||
$ docker run --name geonetwork -d -p 8080:8080 -e POSTGRES_DB_HOST=mydns.net -e POSTGRES_DB_PORT=5434 -e POSTGRES_DB_USERNAME=postgres -e POSTGRES_DB_PASSWORD=mysecretpassword -e POSTGRES_DB_NAME=mydbname geonetwork:postgres
|
||||
docker run --name geonetwork -d -p 8080:8080 -e POSTGRES_DB_HOST=mydns.net -e POSTGRES_DB_PORT=5434 -e POSTGRES_DB_USERNAME=postgres -e POSTGRES_DB_PASSWORD=mysecretpassword -e POSTGRES_DB_NAME=mydbname geonetwork:postgres
|
||||
```
|
||||
|
||||
If are want to **run postgres on a container**, you can use the container name as `POSTGRES_DB_HOST`: just make sure that containers can discover each other, by **running them in the same user-defined network**. For instance, you can create a bridge network:
|
||||
|
||||
```console
|
||||
$ docker network create --driver bridge mynet
|
||||
docker network create --driver bridge mynet
|
||||
```
|
||||
|
||||
Then if you want to run the official image of postgres, using `some-postgres` as container name, you could launch it like this:
|
||||
|
||||
```console
|
||||
$ docker run --name some-postgres --network=mynet -d postgres
|
||||
docker run --name some-postgres --network=mynet -d postgres
|
||||
```
|
||||
|
||||
And then you could launch geonetwork, making sure you join the same network, and setting the required environment variables, including the `POSTGRES_DB_HOST`:
|
||||
|
||||
```console
|
||||
$ docker run --name geonetwork -d -p 8080:8080 --network=mynet -e POSTGRES_DB_HOST=some-postgres -e POSTGRES_DB_PORT=5432 -e POSTGRES_DB_USERNAME=postgres -e POSTGRES_DB_PASSWORD=mysecretpassword -e POSTGRES_DB_NAME=mydbname geonetwork:postgres
|
||||
docker run --name geonetwork -d -p 8080:8080 --network=mynet -e POSTGRES_DB_HOST=some-postgres -e POSTGRES_DB_PORT=5432 -e POSTGRES_DB_USERNAME=postgres -e POSTGRES_DB_PASSWORD=mysecretpassword -e POSTGRES_DB_NAME=mydbname geonetwork:postgres
|
||||
```
|
||||
|
||||
#### Configuration environment variables
|
||||
|
|
|
|||
Loading…
Reference in New Issue