From 9afb316907d16218716a6ab7efc37a799ee51ab1 Mon Sep 17 00:00:00 2001 From: Tara Drwenski Date: Thu, 12 Oct 2023 15:19:59 -0600 Subject: [PATCH] Update docs about threddsIso not being packaged with TDS --- docs/userguide/src/site/index.md | 2 +- .../tds_tutorial/metadata/IsoMetadataRef.md | 23 ++++++------- .../tds_configuration/AddingOgcIsoServices.md | 33 ++++++++++++------- .../src/site/pages/thredds/TdsServices.md | 27 +++++++-------- .../site/pages/thredds/ThreddsConfigRef.md | 11 ++++--- 5 files changed, 53 insertions(+), 43 deletions(-) diff --git a/docs/userguide/src/site/index.md b/docs/userguide/src/site/index.md index 04f1faf72d..bdffe2f4ea 100644 --- a/docs/userguide/src/site/index.md +++ b/docs/userguide/src/site/index.md @@ -28,7 +28,7 @@ Some of the technology in the TDS: * An integrated server provides data access through the [OpenGIS Consortium (OGC) Web Coverage Service (WCS)](https://www.ogc.org/standards/wcs){:target="_blank"} protocol, for any gridded dataset whose coordinate system information is complete. * An integrated server provides data access through the [OpenGIS Consortium (OGC) Web Map Service (WMS)](http://www.opengeospatial.org/standards/wms){:target="_blank"} protocol, for any gridded dataset whose coordinate system information is complete. This software was developed by Jon Blower (University of Reading (UK) E-Science Center) as part of the [ESSC Web Map Service for environmental data](https://github.com/Reading-eScience-Centre/edal-java){:target="_blank"} (aka Godiva3). -* The integrated [ncISO server](iso_metadata.html) provides automated metadata analysis and ISO metadata generation. +* The optional [ncISO server](iso_metadata.html) provides automated metadata analysis and ISO metadata generation. * The integrated [NetCDF Subset Service](netcdf_subset_service_ref.html) allows subsetting certain CDM datasets in coordinate space, using a REST API. Gridded data subsets can be returned in [CF-compliant](http://cfconventions.org/cf-conventions/v1.6.0/cf-conventions.html){:target="_blank"} netCDF-3 or netCDF-4. Point data subsets can be returned in CSV, XML, WaterML (with [assistance](https://github.com/Unidata/thredds/tree/5.0.0/waterml#waterml){:target="_blank"} diff --git a/docs/userguide/src/site/pages/tds_tutorial/metadata/IsoMetadataRef.md b/docs/userguide/src/site/pages/tds_tutorial/metadata/IsoMetadataRef.md index 63610ffb93..ea0b624f31 100644 --- a/docs/userguide/src/site/pages/tds_tutorial/metadata/IsoMetadataRef.md +++ b/docs/userguide/src/site/pages/tds_tutorial/metadata/IsoMetadataRef.md @@ -6,30 +6,31 @@ toc: false permalink: iso_metadata.html --- -The TDS distribution includes the [ncISO](https://github.com/Unidata/threddsIso/){:target="_blank"} package from NOAA/Environmental Data Management (many thanks to Dave Neufeld and Ted Habermann). +The TDS can include ISO metadata services by using the [ncISO plugin](https://github.com/Unidata/threddsIso/){:target="_blank"} package from NOAA/Environmental Data Management (many thanks to Dave Neufeld and Ted Habermann). +See [enabling ncISO services](adding_ogc_iso_services.html) for more information on how to add these services to your TDS. -## `ncISO` Services -`ncISO` supports three new services for datasets: +## ncISO Services +The ncISO plugin provides three new services for datasets: * `NCML`: an NcML representation of the dataset's structure and metadata; * `ISO`: an ISO 19115 metadata representation of the dataset; and * `UDDC`: an evaluation of how well the metadata contained in the dataset conforms to the NetCDF Attribute Convention for Data Discovery (NACDD) (see the [NOAA/EDM page on NACDD](http://wiki.esipfed.org/index.php/Category:Attribute_Conventions_Dataset_Discovery){:target="_blank"}). -## Enabling `ncISO` Services +## Enabling ncISO Services -The `ncISO` services are enabled by default. -These services can be disabled for locally served datasets by including the following in the `threddsConfig.xml` file: +The ncISO services are disabled by default. +Provided that you have added the [ncISO plugin](adding_ogc_iso_services.html#nciso-configuration), these services can be enabled for locally served datasets by including the following in the `threddsConfig.xml` file: ~~~xml - false - false - false + true + true + true ~~~ -## Providing `ncISO` Services For Datasets +## Providing ncISO Services For Datasets -Once `ncISO` is enabled, datasets can be configured to have the three `ncISO` services in the TDS catalog configuration files similar to the way other services are configured. +Once ncISO is enabled, datasets can be configured to have the three ncISO services in the TDS catalog configuration files similar to the way other services are configured. The `service` element's `serviceType` and `base` attribute values must be as follows: ~~~xml diff --git a/docs/userguide/src/site/pages/tds_tutorial/tds_configuration/AddingOgcIsoServices.md b/docs/userguide/src/site/pages/tds_tutorial/tds_configuration/AddingOgcIsoServices.md index 806aec8ebd..66b1ed8690 100644 --- a/docs/userguide/src/site/pages/tds_tutorial/tds_configuration/AddingOgcIsoServices.md +++ b/docs/userguide/src/site/pages/tds_tutorial/tds_configuration/AddingOgcIsoServices.md @@ -6,11 +6,12 @@ toc: false permalink: adding_ogc_iso_services.html --- -## Configure TDS To Allow WCS, WMS, and `ncISO` Access +## Configure TDS To Allow WCS, WMS, and ncISO Access -Out of the box, the TDS distribution will have `WCS`, `WMS`, and `ncISO` enabled. +Out of the box, the TDS distribution will have `WCS` and `WMS` enabled. If you do not wish to use these services, they must be explicitly allowed in the `threddsConfig.xml` file. -Please see the [threddsConfig.xml file](tds_config_ref.html#wcs-service) documentation for information on how to disable these services. +The ncISO services are disabled by default but can be enabled by adding the plugin and updating the `threddsConfig.xml` file. +Please see the [threddsConfig.xml file](tds_config_ref.html#wcs-service) documentation for information on how to enable/disable these services. The default `threddsConfig.xml` file (which should now be in your `${tds.content.root.path}/content/thredds` directory) contains commented out sections for each of these services. ### `WCS` Configuration @@ -41,19 +42,29 @@ The following section in the `threddsConfig.xml` file controls the WMS service: Additional `WMS` configuration options can be set in the `threddsConfig.xml` file, More details are available in the `WMS` section of the [threddsConfig.xml file](tds_config_ref.html#wms-service) documentation. -### `ncISO` Configuration +### ncISO Configuration -The following section in the `threddsConfig.xml` file controls the `ncIso` services: +#### Adding the plugin +To use the ncISO services, you must add the `tds-plugin-jar-with-dependencies.jar` artifact to your TDS for TDS versions >= 5.5. +For TDS versions prior to 5.5 this artifact was included in the TDS war file. +To see which versions of the plugin are compatible with your TDS version see the table [here](https://github.com/Unidata/threddsIso). +The plugin can be downloaded on the [TDS downloads page](https://downloads.unidata.ucar.edu/tds/){:target="_blank"}. +The downloaded ncISO plugin jar file should be placed in your `${tomcat_home}/webapps/thredds/WEB-INF/lib/` directory. + +#### Updating `threddsConfig.xml` +The following section in the `threddsConfig.xml` file controls the ncISO services: ~~~xml - true - true - true + false + false + false ~~~ -Each `*Allow` element allows one of the three `ncISO` services. +Each `*Allow` element allows one of the three ncISO services. + +After adding the ncISO plugin and updating your `threddsConfig.xml`, the TDS should be restarted. ### Adding `WCS` And `WMS` Services @@ -70,9 +81,9 @@ Adding them to an existing compound service would look something like this: ~~~ -### Adding `ncISO` Services +### Adding ncISO Services -Similar to above, as long as the `ncISO` services are enabled, all that is required for the TDS to provide `ncISO` services on datasets is for those datasets to reference the `ncISO` service elements. +Similar to above, as long as the ncISO services are enabled and the jar file is added as explained here(TODO), all that is required for the TDS to provide ncISO services on datasets is for those datasets to reference the ncISO service elements. For instance, adding to the same compound service as above: ~~~xml diff --git a/docs/userguide/src/site/pages/thredds/TdsServices.md b/docs/userguide/src/site/pages/thredds/TdsServices.md index 0ce78168ed..c2e2b9cd62 100644 --- a/docs/userguide/src/site/pages/thredds/TdsServices.md +++ b/docs/userguide/src/site/pages/thredds/TdsServices.md @@ -21,10 +21,7 @@ The TDS has a set of **Standard Data Services** that are always available (unles * opendap * wcs * wms -* iso -* ncml -* uddc - + ### Available Services The TDS configures the appropriate set of standard data services for each dataType/featureType. @@ -71,20 +68,20 @@ Consult the [Configuration Catalogs](config_catalog.html) documentation and [TDS | Remote THREDDS Catalog Service | *Disabled* | `/thredds/remoteCatalogService` | -## `ncISO` Metadata Services +## ncISO Metadata Services + +The ncISO plugin adds the *ncISO Metadata Services*, which facilitate the generation of [ISO 19115 metadata representation](https://en.wikipedia.org/wiki/Geospatial_metadata){:target="_blank"} from data in [NetCDF](https://www.unidata.ucar.edu/software/netcdf/). -*`ncISO` Metadata Services* facilitate the generation of [ISO 19115 metadata representation](https://en.wikipedia.org/wiki/Geospatial_metadata){:target="_blank"} from data in [NetCDF](https://www.unidata.ucar.edu/software/netcdf/). + {% include note.html content=" + Learn how to [enable the ncISO services](adding_ogc_iso_services.html#nciso-configuration). + " %} -The three `ncISO` Metadata Services are: +The three ncISO Metadata Services are: * **ISO** The ISO Metadata Service provides [ISO 19115 metadata representation](https://www.ngdc.noaa.gov/wiki/index.php/NcISO){:target="_blank"} of a dataset's structure and metadata. - - {% include note.html content=" - Learn how to [enable NcISO](adding_ogc_iso_services.html) in the TDS Configuration file. - " %} - + * **NCML** The *NCML Metadata Service* provides NCML representation of a dataset. @@ -103,9 +100,9 @@ The three `ncISO` Metadata Services are: |-----------------|-------------------|-------------------------------| | Service Name | Default Availability | Access Point | |:----------------|:------------------|:------------------------------| -| ISO | Enabled | `/thredds/iso/*` | -| NCML | Enabled | `/thredds/ncml/*` | -| UDDC | Enabled | `/thredds/uddc/*` | +| ISO | Disabled | `/thredds/iso/*` | +| NCML | Disabled | `/thredds/ncml/*` | +| UDDC | Disabled | `/thredds/uddc/*` | #### Catalog Service Configuration: (These are the exact [required](services_ref.html#tds-requirements-for-thredds-catalog-service-elements) values to enable these service.) diff --git a/docs/userguide/src/site/pages/thredds/ThreddsConfigRef.md b/docs/userguide/src/site/pages/thredds/ThreddsConfigRef.md index 61752d71ac..9b5c45f34b 100644 --- a/docs/userguide/src/site/pages/thredds/ThreddsConfigRef.md +++ b/docs/userguide/src/site/pages/thredds/ThreddsConfigRef.md @@ -299,15 +299,16 @@ Here is the description of the various options: Optional; default is that there is no size limitation. If the file is > 2 GB, large format netCDF will be written. -### ncISO Service +### ncISO Services -By default, these services are enabled, and can be disabled by including the following in the `threddsConfig.xml` file: +By default, these services are disabled. +Provided that you have added the [ncISO plugin](adding_ogc_iso_services.html#nciso-configuration), these services can be enabled by including the following in the `threddsConfig.xml` file: ~~~xml - false - false - false + true + true + true ~~~