Skip to content

Mention config options so WAR-file doesn't need to be modified #248

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ZakarFin wants to merge 3 commits into
base: 4.0.x
Choose a base branch
from
Open

Mention config options so WAR-file doesn't need to be modified #248

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4bd5fbc
Prefix index-names with defaults from pom.xml
ZakarFin Jun 17, 2025
2132e29
Note about env variables for es
ZakarFin Jun 17, 2025
10f9084
Mention using env/Java system props as config option
ZakarFin Jun 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion source/install-guide/configuring-database.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ is created:
Configuring a database via config files
---------------------------------------

The database dialect is configured in :file:`/WEB-INF/config-node/srv.xml`. Uncomment the dialect to use.
The database dialect is configured in :file:`/WEB-INF/config-node/srv.xml`. Uncomment the dialect to use or use Java System property to configure it with `-Dgeonetwork.db.type=postgres` as described in https://github.com/geonetwork/core-geonetwork/blob/4.2.7/web/src/main/webResources/WEB-INF/config-node/srv.xml#L36.

A jdbc driver is included for PostgreSQL, Oracle and H2. Other dialects require a jdbc driver to be installed.
Download the jdbc library for the dialect and place it in ``/WEB-INF/lib`` or in the tomcat or GeoNetwork lib folder.
Expand Down Expand Up @@ -98,6 +98,18 @@ Setting configuration properties via environment variables is common in containe
Within PostgreSQL it is possible to configure `postgres` or `postgis`. In the latter case GeoNetwork will use spatial capabilities of PostGIS to filter metadata.
In the first case (and for other database dialects) a Shapefile is created for storage of metadata coverage.

Alternative environment variables are also supported for non-container (WAR-file) environments:

.. code-block:: text

GEONETWORK_DB_USERNAME=example
GEONETWORK_DB_PASSWORD=xxx
GEONETWORK_DB_NAME=example
GEONETWORK_DB_HOST=localhost
GEONETWORK_DB_PORT=5432

Based on compile-time settings: https://github.com/geonetwork/core-geonetwork/blob/4.2.7/pom.xml#L1457-L1462

Logging
-------

Expand Down
23 changes: 17 additions & 6 deletions source/install-guide/installing-index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,13 +49,13 @@ User may want to customize the index settings for example to change language con
.. code-block:: shell

cd $GN_DATA_DIRECTORY/config/index
curl -X DELETE http://localhost:9200/features
curl -X DELETE http://localhost:9200/records
curl -X DELETE http://localhost:9200/searchlogs
curl -X DELETE http://localhost:9200/gn-features
curl -X DELETE http://localhost:9200/gn-records
curl -X DELETE http://localhost:9200/gn-searchlogs

curl -X PUT http://localhost:9200/features -H 'Content-Type: application/json' -d @features.json
curl -X PUT http://localhost:9200/records -H 'Content-Type: application/json' -d @records.json
curl -X PUT http://localhost:9200/searchlogs -H 'Content-Type: application/json' -d @searchlogs.json
curl -X PUT http://localhost:9200/gn-features -H 'Content-Type: application/json' -d @features.json
curl -X PUT http://localhost:9200/gn-records -H 'Content-Type: application/json' -d @records.json
curl -X PUT http://localhost:9200/gn-searchlogs -H 'Content-Type: application/json' -d @searchlogs.json


Install using Maven
Expand Down Expand Up @@ -94,4 +94,15 @@ Update Elasticsearch connection details in ```WEB-INF/config.properties``` and r
es.username=
es.password=


Alternatively these can also be configured as system environment variables:

.. code-block:: shell

GEONETWORK_ES_HOST=localhost
GEONETWORK_ES_PROTOCOL=http
GEONETWORK_ES_PORT=9200
GEONETWORK_ES_USERNAME=
GEONETWORK_ES_PASSWORD=

It is not needed nor recommended to open port 9200 to the outside. GeoNetwork is protecting the Elasticsearch instance exposing only the search API and taking care of user privileges.