Le fichier de configuration TDS (content/thredds/threddsConfig.xml) permet à l'administrateur TDS de définir un certain nombre de paramètres qui contrôlent le comportement du TDS. La plupart de ces paramètres sont définis avec des valeurs par défaut. Certains d'entre eux permettent néanmoins de décrire le serveur, de fournir des informations de contact et de modifier le "thème" des pages HTML générées par le serveur.

Personnalisation du serveur TDS

Informations Serveur THREDDS

Les informations décrivant votre installation TDS et fournissant des informations de contact sont configurées dans l'élément serverInformation du fichier de configuration TDS. Ceci comprend:

• les informations de base sur le serveur (par exemple, nom, résumé, mots-clés, institution hôte),
• les informations de contact afin que les utilisateurs pour les utilisateurs du site.

Voici à quoi ressemble la version par défaut de l'élément serverInformation :

<serverInformation>
    <name>Initial TDS Installation</name>
    <logoUrl>/thredds/threddsIcon.gif</logoUrl>
    <logoAltText>Initial TDS Installation</logoAltText>

    <abstract>Scientific Data</abstract>
    <keywords>meteorology, atmosphere, climate, ocean, earth science</keywords>

    <contact>
      <name>Support</name>
      <organization>My Group</organization>
      <email>support@my.group</email>
      <!--phone></phone-->
    </contact>
    <hostInstitution>
      <name>My Group</name>
      <webSite>http://www.my.site/</webSite>
      <logoUrl>myGroup.gif</logoUrl>
      <logoAltText>My Group</logoAltText>
    </hostInstitution>
  </serverInformation>

sudo cp /anfsist/img/sist_logo.png  /opt/tomcat/content/thredds/public
sudo chown tomcat: /opt/tomcat/content/thredds/public/sist_logo.png

sudo cp /anfsist/img/logo_cnrs.png  /opt/tomcat/content/thredds/public
sudo chown tomcat: /opt/tomcat/content/thredds/public/logo_cnrs.png

  <serverInformation>
    <name>Serveur TDS ANF Sist</name>
    <logoUrl>/thredds/sist_logo.png</logoUrl>
    <logoAltText>Logo Reseau Sist</logoAltText>

    <abstract>Scientific Data</abstract>
    <keywords>meteorology, atmosphere, climate, ocean, earth science</keywords>

    <contact>
      <name>Support</name>
      <organization>Reseau Sist</organization>
      <email>support@sist.fr</email>
      <!--phone></phone-->
    </contact>
    <hostInstitution>
      <name>CNRS/Sist</name>
      <webSite>https://sist.cnrs.fr/</webSite>
      <logoUrl>/thredds/logo_cnrs.png</logoUrl>
      <logoAltText>Logo Sist</logoAltText>
    </hostInstitution>
  </serverInformation>

Toutes les informations sur le serveur TDS sont accessibles depuis l'adresse http://localhost:8080/thredds/serverInfo.html

Apparence des pages HTML générées

Les noms de serveur et d'institution, les logos et les liens donnés dans la section ci-dessus sont utilisés dans toutes les pages HTML générées par TDS.

Vous pouvez également spécifier les fichiers CSS et plusieurs icônes utilisés dans les pages HTML. Ils sont configurés dans l'élément htmlSetup du fichier de configuration TDS threddsConfig.xml. Les fichiers CSS par défaut sont fournis avec la distribution thredds.war et ne doivent pas être modifiés. Au lieu de cela, vous pouvez les remplacer en plaçant les fichiers CSS appropriés dans le répertoire $ {tomcat_home}/content/thredds/public/.

Voici la configuration par défaut de l'élément htmlSetup:

<htmlSetup>
  <!--
   * CSS documents used in generated HTML pages.
   * The CSS document given in the "catalogCssUrl" element is used for all pages
   * that are HTML catalog views. The CSS document given in the "standardCssUrl"
   * element is used in all other generated HTML pages.
   * -->
  <standardCssUrl>tds.css</standard CssUrl>
  <CatalogCssUrl>tdsCat.css</CatalogCssUrl>
  <openDapCssUrl>tdsDap.css</openDapCssUrl>
</htmlSetup>

Contrôle des services d'accès aux données

Tous les services d'accès aux données ne sont pas activés par défaut dans le serveur TDS. L'activation se fait dans le fichier threddsConfig.xml.

  <WCS>
    <allow>true</allow>
    <allowRemote>true</allowRemote>
    <scour>15 min</scour>
    <maxAge>30 min</maxAge>
  </WCS>

  <WMS>
    <allow>true</allow>
    <allowRemote>true</allowRemote>
    <maxImageWidth>2048</maxImageWidth>
    <maxImageHeight>2048</maxImageHeight>
  </WMS>

  <NCISO>
    <ncmlAllow>true</ncmlAllow>
    <uddcAllow>true</uddcAllow>
    <isoAllow>true</isoAllow>
  </NCISO>

  <service name="all" base="" serviceType="compound">
    <service name="odap" serviceType="OpenDAP" base="/thredds/dodsC/" />
    <service name="http" serviceType="HTTPServer" base="/thredds/fileServer/" />
    <service name="ncss" serviceType="NetcdfSubset" base="/thredds/ncss/" />
    <service name="wcs" serviceType="WCS" base="/thredds/wcs/" />
    <service name="wms" serviceType="WMS" base="/thredds/wms/" />
    <service name="ncml" serviceType="NCML" base="/thredds/ncml/"/>
    <service name="uddc" serviceType="UDDC" base="/thredds/uddc/"/>
    <service name="iso" serviceType="ISO" base="/thredds/iso/"/>
  </service>

La capture d'écran suivante montre l'ensemble des services activés pour le jeu de données Sirta Wind Profile Multifiles

Le service OpenDAP

Le protocole OpenDAP permet d'accéder au jeu de données servi par le serveur TDS depuis des applications clientes, comme un programme C ou Fortran compilé avec la librairie NetCDF, des applications Python, Matlab, IDL et de nombreuses autres applications clientes. Il permet d'extraire des données en précisant les indices des tableaux à extraire. Les données peuvent être extraites en ASCII ou en binaire.

$ ncdump -h http://127.0.0.1:8080/thredds/dodsC/sirtadir/profilvent_1a_Lmat10mLz1PventR5sN5n_v01_20170310_000005_1440.nc

Le service NetCDF SubSet

Le service de NetCDF SubSet (NCSS) est un service Web permettant d'extraire des sous-ensembles de données en précisant non-pas les indices, mais directement des coordonnées spatiales et temporelles. Les données peuvent être extraites dans différents formats (csv, geocsv, XML, WaterML, NetCDF).

Installation du service ncSOS

NcSOS ajoute un service OGC SOS à votre serveur THREDDS existant. Toutes les informations utiles pour l'installation du service ncSOS sont disponibles ici.

• Télécharger le Jar de ncSOS ici
• Copier le Jar dans $TOMCAT_HOME/webapps/thredds/WEB-INF/lib

$ sudo cp /anfsist/ressources/ncsos-1.4.3.jar /opt/tomcat/webapps/thredds/WEB-INF/lib
$ sudo chown tomcat:  /opt/tomcat/webapps/thredds/WEB-INF/lib/ncsos-1.4.3.jar 

• Activer le service SOS dans threddsConfig.xml

<NCSOS>
  <allow>true</allow>
</NCSOS>

• Activer le service SOS pour les données du SIRTA dans le fichier sirta-catalog.xml

<service name="sos" serviceType="SOS" base="/thredds/sos/" />

Autres paramètres de configuration du TDS

Les catalogues supplémentaires

Des catalogues de configuration racine supplémentaires peuvent être définis dans le fichier <tds.content.root.path>/thredds/threddsConfig.xml. Par exemple, éditer le fichier de configuration TDS

$ vi /opt/tomcat/content/thredds/threddsConfig.xml

et ajouter le catalogue sirta-catalog.xml, en ajoutant la ligne suivante au fichier :

<catalogRoot> sirta-catalog.xml </catalogRoot>

Il est alors nécessaire de déscativer le catalogue SIRTA dans le fichier catalog.xml

$ vi /opt/tomcat/content/thredds/catalog.xml

  <!-- catalogRef xlink:href="sirta-catalog.xml" xlink:title="Sirta Dataset" ID="SirtaSet" name=""/-->

Le catalogue SIRTA est maintenant accessible à l'adresse : http://127.0.0.1:8080/thredds/sirta-catalog.html

Chaque catalogue racine supplémentaire peut être la racine d'un autre arbre de catalogues de configuration.

Service de catalogue distant

Les services de catalogue, référencés par les balises <catalogRef> sont disponibles par défaut pour les catalogues servis par le TDS local. Mais pour les catalogues distants, ces services doivent être explicitement activés dans threddsConfig.xml:

<CatalogServices>
  <allowRemote>true</allowRemote>
</CatalogServices>

Le serveur TDS local doit avoir un accès internet pour interroger le serveur distant.