Update GettingStarted.adoc

[cwardgar]

From BFS-580070:

Hi,

I'm working through trying to get a THREDDS server running on our weather data server here at UW. Long overdue.. Anyways..

On the page

http://www.unidata.ucar.edu/software/thredds/v4.6/tds/tutorial/GettingStarted.html

in the section about creating the setenv.sh file, the content to be added shows

export CATALINA_HOME="/usr/local/tomcat"

export CATALINA_BASE="/usr/local/tomcat"

export JAVA_HOME="/usr"

I'm wondering if those are correct, since everywhere else things are under /usr/local/tds/apache-tomcat-8.0.30 or /usr/local/tds/jdk1.8.0_71 (for example)

I'm thinking those should be

export CATALINA_HOME="/usr/local/tds/apache-tomcat-8.0.30" export CATALINA_BASE="/usr/local/tds/apache-tomcat-8.0.30" export JAVA_HOME="/usr/local/tds/jdk1.8.0_71"

Is that right?

Also, the CONTENT_ROOT directory - is that supposed to point to where data lives? Or is that used by the TDS for its own internal stuff?

The tutorial shows

CONTENT_ROOT=-Dtds.content.root.path=/usr/local/tomcat/content

But in my setup, I'm thinking that should be /usr/local/tds/content ? or a path to where our data lives?

Thanks! Pete

[cwardgar]

Hi Pete,

Looking at that tutorial now, it is in dire need of an update. Not only are some of the paths wrong, as you mentioned, but according to the Tomcat documentation in $TOMCAT_HOME/RUNNING.TXT (which I highly suggest you read):

The CATALINA_HOME and CATALINA_BASE variables cannot be configured in the setenv script, because they are used to locate that file.

So we're just giving completely wrong-headed instructions there. Oops. Here [1] is another reference that's more up-to-date. Just ignore the part about setting CATALINA_BASE.

As for the content root, it is principally the location of the root catalog (named "catalog.xml"). It's also a general working directory for THREDDS; it writes stuff like logs and and cached information there. It's our convention at Unidata to have that directory beneath $TOMCAT_HOME (e.g. mine is at "/Users/cwardgar/dev/tools/apache-tomcat-8.0.29/content") but it doesn't have to be there.

Similarly, your datasets can be located anywhere you want as well. You just need to point to them in your catalog.

Cheers, Christian

[1] https://www.unidata.ucar.edu/software/thredds/current/tds/reference/ChecklistReference.html

[cwardgar]

ChecklistReference.adoc also contains Tomcat config and needs cleanup as well. Plus, it seems to be the one remaining Asciidoctor doc that needs to be updated to use cross-references:

[cwardgar@lenny ~/dev/projects/thredds2] (get-altitude %=)
$ egrep -r --include '*.adoc' 'link:.*\.adoc' docs/
docs//website/tds/reference/ChecklistReference.adoc:. link:../reference/Performance.adoc#enableCompression[Enable
docs//website/tds/reference/ChecklistReference.adoc:. link:../tutorial/TDSMonitoringAndDebugging.adoc#access[Enable access
docs//website/tds/reference/ChecklistReference.adoc:. link:../tutorial/GettingStarted.adoc#grantingAccess[Add yourself as a
docs//website/tds/reference/ChecklistReference.adoc:6. (optional) link:../../netcdf-java/reference/netcdf4Clibrary.adoc[Build
docs//website/tds/reference/ChecklistReference.adoc:If needed, link:../tutorial/Security.adoc#access[limit access to the

[lesserwhirls]

From e-support:

• need of netcdf4 C as prerequisite (if netcdf-4 output desired)
• {tomcat_home} directory path should be consistent (dupe from above)