upgrading.rst 2.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243
  1. .. _upgrading:
  2. Upgrading from previous version
  3. -------------------------------
  4. Removal of ``htmlDescription``
  5. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  6. Starting with version 2.20 the OpenSearch module dropped the HTML template columns in the
  7. database, and switched to freemarker templates instead. This relieves the database from a
  8. significant burden, especially on the products table.
  9. The default templates are automatically used, and the old ``htmlDescription`` columns ignored
  10. (they should therefore be removed).
  11. In order for the default `collection.ftl <https://github.com/geoserver/geoserver/blob/main/src/community/oseo/oseo-service/src/main/resources/org/geoserver/opensearch/eo/response/collection.json>`_
  12. to work, two new fields, ``title`` and ``description``, should be added to the database
  13. structure, if not already present.
  14. As a result of these changes, the REST resources previously used to manage the description templates
  15. have been removed, and residual HTML description templates included in product or collection
  16. zips will be ignored.
  17. The replacement Freemarker templates are :ref:`located in the data directory<oseo_html_templates>`
  18. and can be thus managed via the :api:`/resource <resource.yaml>` REST API.
  19. Removal of ``collection_metadata`` and ``product_metadata``
  20. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  21. Starting with version 2.20 the OpenSearch module dropped the metadata storage tables from the
  22. database, and switched to freemarker templates instead. This relieves the database from a
  23. significant burden, especially on the products metadata table.
  24. The default templates are automatically used, and the old metadata tables are ignored
  25. (they should therefore be removed).
  26. As a result of these changes, the REST resources previously used to manage the metadata
  27. have been removed, and residual metadata xml files included in product or collection
  28. zips will be ignored.
  29. The replacement Freemarker templates are :ref:`located in the data directory<oseo_metadata_templates>`
  30. and can be thus managed via the :api:`/resource <resource.yaml>` REST API.