Skip to content

Commit

Permalink
Fix section ref links.
Browse files Browse the repository at this point in the history
  • Loading branch information
SpacemanPaul committed Dec 11, 2024
1 parent 0f7479c commit 11adde4
Showing 1 changed file with 8 additions and 6 deletions.
14 changes: 8 additions & 6 deletions docs/installation/MIGRATION-1.8-to-1.9.rst
Original file line number Diff line number Diff line change
Expand Up @@ -58,12 +58,14 @@ Major Changes between 1.8.x and 1.9.x
continue to work as previously with minimal changes.

The behaviour of the new configuration engine (and the reasoning behind the changes) is fully documented in
:doc:`database/passing-configuration`. The reasoning behind the changes is described in
:doc:`database/passing-configuration`.

The reasoning behind the changes is described in
`ODC Enhancement Proposal 10 <https://github.com/opendatacube/datacube-core/wiki/ODC-EP-010---Replace-Configuration-Layer>`_

a. Previously multiple config files could be read and merged to generate the final effective configuration file.
From 1.9.0 only a single config file is ever read at a time
(see :doc:`database/passing-configuration#Merging-multiple-config-files`).
(see :ref:`database/passing-configuration:merging-multiple-config-files`).

Managed instances which have previously allowed
user customisation by the user creating a minimal config file which was loaded merged on top of a default system
Expand All @@ -74,15 +76,15 @@ Major Changes between 1.8.x and 1.9.x
files are not merged.

c. Previously only the INI file format was supported for configuration files. The JSON and YAML formats are now also
supported (see :doc:`database/configuration#format`).
supported (see :ref:`database/configuration:format`).

d. Previously configuration by Environment Variables was implemented in an inconsistent ad hoc way that resulted
in complex interactions that were impossible to predict without intimate knowledge of the source code that
implemented it.

There is now a consistent and systematic approach taken to the interaction between the
active configuration file and environment variables
(see :doc:`database/passing-configuration#generic-environment-variable-overrides`). Partial backwards compatibility is attempted, but
(see :ref:`database/passing-configuration:generic-environment-variable-overrides`). Partial backwards compatibility is attempted, but
full backwards compatibility is not possible due to the ad hoc nature of the previous implementation.

The new (preferred) environment variable names are of the form ``$ODC_<env_name>_<item_name>``.
Expand Down Expand Up @@ -116,7 +118,7 @@ Major Changes between 1.8.x and 1.9.x
The postgis driver uses Alembic for managing schema migrations, so future changes to the postgis database
schema will be much easier to roll out than in the past.

See below for more `information about migrating to the Postgis index driver`<#the-new-postgis-index-driver>`_.
See below for more `information about migrating to the Postgis index driver<#the-new-postgis-index-driver>`_.

Note that many other libraries in the ODC ecosystem may not work well with the Postgis driver at first.

Expand Down Expand Up @@ -191,7 +193,7 @@ for EPSG:3577::

datacube -E new spindex create 3577

For more information, see :doc:`database/setup#create-spatial-indexes-postgis-driver-only`.
For more information, see :ref:`database/setup:create-spatial-indexes-postgis-driver-only`.

Migrating (Cloning) Data From a Postgres Index
++++++++++++++++++++++++++++++++++++++++++++++
Expand Down

0 comments on commit 11adde4

Please sign in to comment.