Εγκατάσταση

Πώς να κάνετε την αρχική ρύθμισηERDDAP™στον εξυπηρετητή σας

ERDDAP™μπορεί να τρέξει σε οποιοδήποτε διακομιστή που υποστηρίζειJavaκαι Tomcat (και άλλους διακομιστές εφαρμογών όπως ο Jetty, αλλά δεν τους υποστηρίζουμε) .ERDDAP™έχει δοκιμαστεί σε Linux (Η LuxOpCo και η LuxOpCo υποστηρίζουν ότι η LuxOpCo δεν είναι σε θέση να αποδείξει ότι η LuxOpCo δεν είναι σε θέση να εκπληρώσει τις υποχρεώσεις της.) , Mac, και υπολογιστές Windows.

• Αμαζόνιος -- Εάν εγκαθιστάτεERDDAP™σε ένα παράδειγμα Amazon Web Services EC2, δείτε αυτόAmazon Web Services ΕπισκόπησηΠρώτα.
• Ντόκερ -- Το αξίωμα προσφέρει τώραERDDAP™σε δοχείο Dockerκαι ο IOOS προσφέρει τώραΟδηγός γρήγορης εκκίνησης γιαERDDAP™σε ένα κοντέινερ Docker. Είναι το πρότυπο.ERDDAP™εγκατάσταση, αλλά Axiom έχει βάλει σε ένα δοχείο docker. Εάν χρησιμοποιείτε ήδη Docker, πιθανότατα θα προτιμάτε την έκδοση Docker. Αν δεν χρησιμοποιείτε ήδη τον Ντόκερ, γενικά δεν το συνιστούμε αυτό. Αν επιλέξατε να εγκαταστήσετεERDDAP™μέσω Docker, δεν προσφέρουμε καμία υποστήριξη για τη διαδικασία εγκατάστασης. Δεν έχουμε δουλέψει με τον Ντόκερ ακόμα. Αν συνεργαστείτε με αυτό, παρακαλούμε να μας στείλετε τα σχόλιά σας.
• Linux και Macs --ERDDAP™λειτουργεί τέλεια στους υπολογιστές Linux και Mac. Δείτε τις παρακάτω οδηγίες.
• Παράθυρα -- Τα Windows είναι μια χαρά για δοκιμήERDDAP™και για προσωπική χρήση (Δείτε τις παρακάτω οδηγίες) , αλλά δεν προτείνουμε να το χρησιμοποιήσετε για το κοινόERDDAPΣ. ΕκτέλεσηERDDAP™στα Windows μπορεί να έχουν προβλήματα: κυρίως,ERDDAP™μπορεί να μην είναι σε θέση να διαγράψει ή/και να μετονομάσει αρχεία γρήγορα. Αυτό οφείλεται πιθανώς στο λογισμικό antivirus (π.χ. από τη McAfee και τη Norton) Που ελέγχει τα αρχεία για ιούς. Αν συναντήσεις αυτό το πρόβλημα (το οποίο μπορεί να φανεί από τα μηνύματα σφάλματος στοlog.txtαρχείο όπως "Μη δυνατή η διαγραφή ...") , η αλλαγή των ρυθμίσεων του λογισμικού antivirus μπορεί εν μέρει να ανακουφίσει το πρόβλημα. Ή σκεφτείτε να χρησιμοποιήσετε έναν εξυπηρετητή Linux ή Mac.

Το πρότυποERDDAP™οδηγίες εγκατάστασης για τους υπολογιστές Linux, Mac και Windows είναι:

0. Βεβαιωθείτε ότι έχουν εγκατασταθεί οποιεσδήποτε εξαρτήσεις. Σε μηχανές χωρίς παράθυρα (Linux και Mac) , χρειάζεσαι csh.

Java

1. ΓιαERDDAP™v2.19+, σετJava21. Για λόγους ασφαλείας, είναι σχεδόν πάντα καλύτερο να χρησιμοποιήσετε την τελευταία έκδοση τουJava21. Παρακαλώ κατεβάστε και εγκαταστήστε την τελευταία έκδοση του Το OpenJDK της Υιοθέτησης (Τεμουρίνη) 21 (LTS) . Για να επαληθεύσετε την εγκατάσταση, type "/javaJreBinΚατάλογος/java -έκδοση", για παράδειγμα /usr/local/jdk-21.0.3+9/jre/bin/java -έκδοση

   ERDDAP™έργα μεJavaαπό άλλες πηγές, αλλά προτείνουμε την υιοθεσία γιατί είναι η κύρια, υποστηριζόμενη από την κοινότητα, ελεύθερη (όπως στην μπύρα και τον λόγο) έκδοση τουJava21 που προσφέρει μακροπρόθεσμη υποστήριξη (δωρεάν αναβαθμίσεις για πολλά χρόνια μετά την αρχική κυκλοφορία) . Για λόγους ασφαλείας, παρακαλούμε ενημερώστε τοERDDAPΈκδοση τηςJavaπεριοδικά ως νέες εκδόσειςJava21 διατίθενται από την Υιοθεσία.

   ERDDAP™έχει δοκιμαστεί και χρησιμοποιηθεί εκτενώς με 21, όχι άλλες εκδόσεις. Για διάφορους λόγους, δεν δοκιμάζουμε ούτε υποστηρίζουμε άλλες εκδόσεις τουJava.  

Τομκάτ

2. Set Τομκάτ. Tomcat είναι η πιο ευρέως χρησιμοποιούμενηJavaΕξυπηρετητής εφαρμογών, η οποία είναιJavaλογισμικό που βρίσκεται μεταξύ των υπηρεσιών δικτύου του λειτουργικού συστήματος καιJavaλογισμικό διακομιστή όπωςERDDAP™. Είναι Ελεύθερο και Ανοικτό Λογισμικό (ΑΦΟΣ) .

Μπορείτε να χρησιμοποιήσετε ένα άλλοJavaΕξυπηρετητής εφαρμογών (π.χ., Jetty) Αλλά μόνο με τεστ και υποστήριξη Tomcat.  

• Κατεβάστε το Tomcat και ξεπακετάρετε στον server ή τον υπολογιστή σας. Για λόγους ασφαλείας, είναι σχεδόν πάντα καλύτερο να χρησιμοποιήσετε την τελευταία έκδοση του Tomcat 10 (η έκδοση 9 και κάτω δεν είναι αποδεκτές) η οποία έχει σχεδιαστεί για να λειτουργεί μεJava21 ή νεότερη. Παρακάτω, ο κατάλογος Tomcat θα αναφέρεται ως tomcat.

Προειδοποίηση! Αν έχετε ήδη Tomcat τρέχει κάποια άλλη εφαρμογή web (Ειδικά οι ΤΡΕΙΣ) , σας προτείνουμε να εγκαταστήσετεERDDAP™μέσαΈνα δευτερόλεπτο Tomcat, επειδήERDDAP™χρειάζεται διαφορετικές ρυθμίσεις Tomcat και δεν θα πρέπει να αγωνιστούν με άλλες εφαρμογές για τη μνήμη.

• Στο Linux,κατεβάστε το "Core" "tar.gz" Διανομή Tomcatκαι να το ξεπακετάρω. Σας συνιστούμε να το ξεπακετάρετε στο /usr/local.
• Σε ένα Mac, το Tomcat είναι πιθανώς ήδη εγκατεστημένο στο /Library/Tomcat, αλλά θα πρέπει να το ενημερώσει στην τελευταία έκδοση του Tomcat 10. Αν το κατεβάσεις,κατεβάστε το "Core" "tar.gz" Διανομή Tomcatκαι να το ξεπακετάρετε σε /Βιβλιοθήκη / Tomcat.
• Στα Windows, μπορείτεκατεβάστε τη διανομή "Core" "zip" Tomcat (το οποίο δεν πειράζει το μητρώο των Windows και το οποίο ελέγχεις από μια γραμμή εντολών DOS) και να το ξεπακετάρω σε έναν κατάλληλο κατάλογο. (Για την ανάπτυξη, χρησιμοποιούμε την κατανομή "Core" "zip". Φτιάχνουμε έναν κατάλογο προγραμμάτων και τον ξεπακετάρουμε εκεί.) Ή μπορείτε να κατεβάσετε το "Core" "64-bit Windows zip" διανομή, το οποίο περιλαμβάνει περισσότερα χαρακτηριστικά. Αν η διανομή είναι ένας εγκαταστάτης των Windows, πιθανότατα θα βάλει Tomcat, για παράδειγμα, /Αρχεία προγράμματος/pache-tomcat-10.0.23 .  

εξυπηρετητής.xml

• εξυπηρετητής.xml- Στο αρχείο tomcat/conf/server.xml, υπάρχουν δύο αλλαγές που πρέπει να κάνετε σε καθένα από τα δύο<Connector> ετικέτες- ένα για

        <Connector port="8080" 

και ένα για

        <Conector port="8443"

1. (Συνιστώμενη) Αύξηση της τιμής παραμέτρου σύνδεσηςTimeout, ίσως σε 300000 (χιλιοστοδευτερόλεπτο) (που είναι 5 λεπτά.) .
2. (Συνιστώμενη) Προσθέστε μια νέα παράμετρο: χαλαρήQueryChars="\[\]|" Αυτό είναι προαιρετικό και ελαφρώς λιγότερο ασφαλές, αλλά αφαιρεί την ανάγκη για τους χρήστες να κωδικοποιήσουν τοις εκατό αυτούς τους χαρακτήρες όταν εμφανίζονται στις παραμέτρους του URL αιτήματος ενός χρήστη.  

περιεχόμενο.xml

• πλαίσιο.xml -- Πόροι λανθάνουν - Σε tomcat/conf/context.xml, ακριβώς πριν από το</Context> tag, αλλαγή ετικέτας πόρων (ή να το προσθέσετε αν δεν είναι ήδη εκεί) για τον καθορισμό της λανθάνουσας μνήμης Μέγιστη παράμετρος μεγέθους σε 80000: <Πόροι cachingAllowed=" true" cacheMaxSize="80000" /> Αυτό αποφεύγει πολυάριθμες προειδοποιήσεις στην καταλίνα. Όλα αυτά ξεκινούν με "ΑΠΟΦΑΣΗ\[κύριος\]org.apache.catalina.webresources.Cache.getResource Αδυναμία προσθήκης του πόρου στο\[/WEB-INF/κλάσεις/...]  

Χρονικό όριο Απάτσι

• Στους υπολογιστές Linux, αλλάξτε τις ρυθμίσεις χρονικού ορίου Apache έτσι ώστε τα αιτήματα χρήστη που καταναλώνουν χρόνο να μην timeout (με αυτό που συχνά εμφανίζεται ως ένα "Proxy" ή "Bad Gateway" σφάλμα) . Ως ο ριζικός χρήστης:
  1. Τροποποίηση των Απάτσιhttpαρχείο d.conf (συνήθως στο /etc/httpδ/conf/) : Αλλαγή του υπάρχοντος<Χρονικό όριο & gt· ρύθμιση (ή να προσθέσετε ένα στο τέλος του αρχείου) έως 3600 (δευτερόλεπτα) , αντί των προκαθορισμένων 60 ή 120 δευτερολέπτων. Αλλαγή του υπάρχοντος<ProxyTimeout&gt· ρύθμιση (ή να προσθέσετε ένα στο τέλος του αρχείου) έως 3600 (δευτερόλεπτα) , αντί των προκαθορισμένων 60 ή 120 δευτερολέπτων.
  2. Επανεκκίνηση Apache: /usr/sbin/apachectl -Χάρηκα. (Αλλά μερικές φορές είναι σε διαφορετικό κατάλογο) .  
  • Σύσταση ασφάλειας: Βλέπεις;Αυτές οι οδηγίεςνα αυξήσει την ασφάλεια της εγκατάστασης Tomcat σας, ειδικά για τους δημόσιους servers.  
  • Για το κοινόERDDAP™εγκαταστάσεις σε Linux και Macs, είναι καλύτερο να συσταθεί Tomcat (το πρόγραμμα) ως ανήκει στο χρήστη "tomcat" (ξεχωριστό χρήστη με περιορισμένες άδειες και ο οποίοςδεν έχει κωδικό πρόσβασης) . Έτσι, μόνο ο σούπερ χρήστης μπορεί να αλλάξει σε λειτουργώντας ως χρήστης tomcat. Αυτό καθιστά αδύνατη την είσοδο των χάκερ στον server σας ως χρήστη tomcat. Και σε κάθε περίπτωση, θα πρέπει να το κάνετε έτσι ώστε ο χρήστης tomcat να έχει πολύ περιορισμένες άδειες στο σύστημα αρχείων του διακομιστή (read+write+execute δικαιώματα για το δέντρο καταλόγου apache-tomcat και<bigParentDirectory> και δικαιώματα μόνο ανάγνωσης για καταλόγους με δεδομένα πουERDDAP™χρειάζεται πρόσβαση σε).

    • Μπορείτε να δημιουργήσετε το λογαριασμό χρήστη tomcat (που δεν έχει κωδικό πρόσβασης) χρησιμοποιώντας την εντολή sudo useradd tomcat -s /bin/bash -p '\* "

    • Μπορείτε να μεταβείτε στην εργασία ως χρήστης tomcat χρησιμοποιώντας την εντολή sudo su - τομκάτ (Θα σας ζητήσει τον κωδικό πρόσβασης υπερχρήστη για την άδεια για να το κάνετε αυτό.)

    • Μπορείτε να σταματήσετε να εργάζεστε ως χρήστης tomcat χρησιμοποιώντας την εντολή έξοδος

    • Κάντε τα περισσότερα από τα υπόλοιπα Tomcat καιERDDAP™οδηγίες εγκατάστασης ως χρήστης-tomcat". Αργότερα, εκτελέστε την εκκίνηση.sh και το κλείσιμο.sh σενάρια ως user "tomcat" έτσι ώστε Tomcat έχει την άδεια να γράψει στα αρχεία καταγραφής του.

    • Μετά την αποσυσκευασία Tomcat, από τον γονέα του καταλόγου apache-tomcat:

      • Αλλάξτε την ιδιοκτησία του δέντρου καταλόγου apache-tomcat στον χρήστη tomcat. chown -R tomcat apache-tomcat-10.0.23 (αλλά να αντικαταστήσει το πραγματικό όνομα του καταλόγου tomcat σας) .

      • Αλλαγή της ομάδας" να είναι Tomcat, το όνομα χρήστη σας, ή το όνομα μιας μικρής ομάδας που περιλαμβάνει Tomcat και όλους τους διαχειριστές του Tomcat /ERDDAP, π.χ., Chgrp -R your ΧρήστηςName apache-tomcat-10.0.23

      • Αλλάξτε άδειες έτσι ώστε ο Tomcat και η ομάδα να έχουν διαβάσει, γράψει, εκτελέσει προνόμια, π.χ.. chmod -R ug+rwx apache-tomcat-10.0.23

      • Αφαίρεση " άλλων" αδειών χρήσης για ανάγνωση, εγγραφή ή εκτέλεση: chmod -R o-rwx apache-tomcat-10.0.23 Αυτό είναι σημαντικό, διότι εμποδίζει άλλους χρήστες από την ανάγνωση ενδεχομένως ευαίσθητων πληροφοριώνERDDAP™αρχεία εγκατάστασης.

Μνήμη

• Ορισμός μεταβλητών περιβάλλοντος Tomcat

Σε Linux και Macs: Δημιουργία ενός αρχείου tomcat/bin/setenv.sh (ή στο Red Hat Enterprise Linux\[ΡΕΛ\], επεξεργασία ~tomcat/conf/tomcat10.conf) να ρυθμίσουν τις μεταβλητές περιβάλλοντος του Tomcat. Αυτό το αρχείο θα χρησιμοποιηθεί από tomcat/bin/startup.sh και κλείσιμο.sh. Το αρχείο πρέπει να περιέχει κάτι σαν:

    export JAVA\\_HOME=/usr/local/jdk-21.0.3+9  
    export JAVA\\_OPTS='-server -Djava.awt.headless=true -Xmx1500M -Xms1500M'  
    export TOMCAT\\_HOME=/usr/local/apache-tomcat-_10.0.23_  
    export CATALINA\\_HOME=/usr/local/apache-tomcat-_10.0.23_

(αλλά να αντικαταστήσει τα ονόματα καταλόγου από τον υπολογιστή σας) . (Αν έχετε ρυθμίσει προηγουμένως JRE\_HOME, μπορείτε να αφαιρέσετε αυτό.)
Σε Macs, πιθανότατα δεν χρειάζεται να ρυθμίσετε JAVA\_HOME.

Στα Windows: Δημιουργήστε ένα αρχείο tomcat\bin\setenv.bat για να ρυθμίσετε τις μεταβλητές περιβάλλοντος του Tomcat. Αυτό το αρχείο θα χρησιμοποιηθεί από tomcat\bin\startup.bat καιshutdown.bat. Το αρχείο πρέπει να περιέχει κάτι σαν:

    SET "JAVA\\_HOME=\\_someDirectory_\\jdk-21.0.3+9"  
    SET "JAVA\\_OPTS=-server -Xmx1500M -Xms1500M"  
    SET "TOMCAT\\_HOME=\\Program Files\\apache-tomcat-_10.0.23_"  
    SET "CATALINA\\_HOME=\\Program Files\\apache-tomcat-_10.0.23_"

(αλλά να αντικαταστήσει τα ονόματα καταλόγου από τον υπολογιστή σας) . Εάν αυτό είναι μόνο για τοπικές δοκιμές, αφαιρέστε "-server. (Αν έχετε ρυθμίσει προηγουμένως JRE\_HOME, μπορείτε να αφαιρέσετε αυτό.)

Οι ρυθμίσεις μνήμης -Xmx και -Xms είναι σημαντικές επειδήERDDAP™λειτουργεί καλύτερα με περισσότερη μνήμη. Πάντα καθορισμένο -Xms στην ίδια τιμή με -Xmx.

• Για 32 bit Λειτουργικά Συστήματα και 32 bitJava: 64 bitJavaείναι πολύ καλύτερο από 32 bitJavaΑλλά 32 bitJavaΘα λειτουργήσει εφόσον ο διακομιστής δεν είναι πραγματικά απασχολημένος. Όσο πιο φυσική μνήμη στον εξυπηρετητή τόσο το καλύτερο: 4+ GB είναι πραγματικά καλό, 2 GB είναι εντάξει, λιγότερο δεν συνιστάται. Με 32 bitJava, ακόμη και με άφθονη φυσική μνήμη, Tomcat καιJavaΔεν θα τρέξει αν προσπαθήσετε να ρυθμίσετε -Xmx πολύ πάνω από 1500M (1200M σε μερικούς υπολογιστές) . Εάν ο διακομιστής σας έχει λιγότερο από 2GB μνήμης, μειώστε την τιμή -Xmx (στο 'M'egaBytes') στο 1/2 της φυσικής μνήμης του υπολογιστή.

• Για 64 bit Λειτουργικά Συστήματα και 64 bitJava: 64 bitJavaθα λειτουργήσει μόνο σε ένα λειτουργικό σύστημα 64 bit.

  • ΜεJava8, θα πρέπει να προσθέσετε \-d64 στην παράμετρο Tomcat CATALINA\_OPTS στο setenv.bat
  • ΜεJava21, διαλέγεις 64 bitJavaόταν κατεβάζετε μια έκδοση τουJavaσημειώνονται "64 bit".".

Με 64 bitJava, Tomcat καιJavaμπορεί να χρησιμοποιήσει πολύ υψηλές -Xmx και -Xms ρυθμίσεις. Όσο πιο φυσική μνήμη στον διακομιστή τόσο το καλύτερο. Ως μια απλοϊκή πρόταση: σας συνιστούμε να ρυθμίσετε -Xmx και -Xms σε (στο 'M'egaBytes') έως 1/2 (ή λιγότερο) της φυσικής μνήμης του υπολογιστή. Μπορείτε να δείτε αν Tomcat,Java, καιERDDAP™τρέχουν πράγματι σε λειτουργία 64 bit με την αναζήτηση για " bit," inERDDAP's Daily Report email ή στο bigParentΚατάλογος/logs/log.txtαρχείο (bigParentΚατάλογος καθορίζεται στοsetup.xml) .

Συλλογή σκουπιδιών

• ΜέσαERDDAP™Σlog.txtαρχείο, θα δείτε πολλά "GC (Αποτυχία κατανομής) " μηνύματα. Αυτό συνήθως δεν είναι πρόβλημα. Είναι ένα συχνό μήνυμα από μια κανονική λειτουργίαJavaλέγοντας ότι μόλις τελείωσε μια μικρή συλλογή σκουπιδιών επειδή έμεινε από χώρο στην Εδέμ (το τμήμα τουJavaσωρός για πολύ νεαρά αντικείμενα) . Συνήθως το μήνυμα σας δείχνει μνήμηUsePefore\->μνήμηUseAfter. Αν αυτοί οι δύο αριθμοί είναι κοντά, σημαίνει ότι η συλλογή σκουπιδιών δεν ήταν παραγωγική. Το μήνυμα είναι μόνο ένα σημάδι προβλήματος αν είναι πολύ συχνό. (κάθε λίγα δευτερόλεπτα) , δεν είναι παραγωγικοί, και οι αριθμοί είναι μεγάλοι και δεν αυξάνονται, που μαζί δείχνουν ότιJavaχρειάζεται περισσότερη μνήμη, παλεύει να απελευθερώσει τη μνήμη, και αδυνατεί να απελευθερώσει τη μνήμη. Αυτό μπορεί να συμβεί κατά τη διάρκεια μιας αγχωτικής περιόδου, και στη συνέχεια να φύγει. Αλλά αν επιμένει, αυτό είναι ένα σημάδι προβλήματος.
• Αν δείτε java.lang.OutMemoryError's inERDDAP™Σlog.txtαρχείο, δείτεΕκτός μνήμηςγια συμβουλές σχετικά με τον τρόπο διάγνωσης και επίλυσης των προβλημάτων.  

Άδειες

• Σε Linux και Macs, αλλάξτε τις άδειεςόλων\*.shαρχεία σε tomcat/bin/ να εκτελεστεί από τον ιδιοκτήτη, π.χ., με

    chmod +x \\*.sh  

Γραμματοσειρές

• Γραμματοσειρές για εικόνες:Προτιμούμε έντονα το ελεύθεροΓραμματοσειρές DejaVuπρος την άλληJavaγραμματοσειρές. Η χρήση αυτών των γραμματοσειρών συνιστάται έντονα αλλά δεν απαιτείται.

Αν επιλέξετε να μην χρησιμοποιήσετε τις γραμματοσειρές DejaVu, θα πρέπει να αλλάξετε τη γραμματοσειράΟικογένεια ρύθμιση στο setup.xml σε<fontFamily>SansSerif</fontFamily>, το οποίο είναι διαθέσιμο με όλαJavaδιανομές. Αν ορίσετε γραμματοσειράFamily στο όνομα μιας γραμματοσειράς που δεν είναι διαθέσιμη,ERDDAP™δεν φορτώνει και θα εκτυπώσει μια λίστα με τις διαθέσιμες γραμματοσειρές στο αρχείο log.txt. Πρέπει να χρησιμοποιήσεις μια από αυτές τις γραμματοσειρές.

Αν επιλέξετε να χρησιμοποιήσετε τις γραμματοσειρές DejaVu, βεβαιωθείτε ότι η ρύθμιση της γραμματοσειράςFamily στη ρύθμιση.xml είναι<γραμματοσειρά Οικογένεια & gt; DejaVu Sans</fontFamily>.

Για να εγκαταστήσετε τις γραμματοσειρές DejaVu, κατεβάστεDejaVuFonts (στα Αγγλικά).zip (5,522.795 bytes, MD5=33E1E61FAB06A547851ED308B4FFEF42) και unzip τα αρχεία γραμματοσειράς σε έναν προσωρινό κατάλογο.

• Στο Linux:
  • Για το Linux AdmitiumJavaδιανομές, βλέπεΑυτές οι οδηγίες.
  • Με άλλαJavaδιανομές: Ως χρήστης Tomcat, αντιγράψτε τα αρχεία γραμματοσειράς σε _JAVA\HOME/lib/fonts έτσιJavaμπορεί να βρει τις γραμματοσειρές. Θυμηθείτε: αν / όταν αργότερα αναβάθμιση σε μια νεότερη έκδοση τουJava, θα πρέπει να επανεγκαταστήσετε αυτές τις γραμματοσειρές.
• Σε Macs: για κάθε αρχείο γραμματοσειράς, κάντε διπλό κλικ σε αυτό και στη συνέχεια κάντε κλικ στο Install Font.
• Στα Windows 7 και 10: στο Windows Explorer, επιλέξτε όλα τα αρχεία γραμματοσειράς. Δεξί κλικ. Κάντε κλικ στο Εγκατάσταση.  

Δοκιμή Tomcat

• Δοκίμασε την εγκατάσταση Tomcat.

  • Linux:

    • Ως χρήστης "tomcat", τρέχει tomcat/bin/startup.sh
    • Δείτε το URL σας + ":8080" in στον browser σας (π.χ., http://coastwatch.pfeg.noaa.gov:8080/ ) .
    • Θα πρέπει να δείτε το Tomcat " Συγχαρητήρια" σελίδα. Αν υπάρχει πρόβλημα, δείτε το αρχείο καταγραφής Tomcat tomcat/logs/catalina.out.

  • Μακ (εκτελέστε tomcat ως ο χρήστης συστήματος) :

    • Εκτέλεση tomcat/bin/startup.sh
    • Δείτε το URL σας + ":8080" in στον browser σας (π.χ., http://coastwatch.pfeg.noaa.gov:8080/ ) . Σημειώστε ότι εξ ορισμού, Tomcat σας είναι προσβάσιμο μόνο από εσάς. Δεν είναι δημόσια προσβάσιμη.
    • Θα πρέπει να δείτε το Tomcat " Συγχαρητήρια" σελίδα. Αν υπάρχει πρόβλημα, δείτε το αρχείο καταγραφής Tomcat tomcat/logs/catalina.out.

  • Εντοπισμός παραθύρων:

    • Κάντε δεξί κλικ στο εικονίδιο Tomcat στο δίσκο του συστήματος, και επιλέξτε "Ξεκινήστε την υπηρεσία.
    • Προβολή http://127.0.0.1:8080/ ή ίσως http://localhost:8080/ , στο πρόγραμμα περιήγησης σας. Σημειώστε ότι εξ ορισμού, Tomcat σας είναι προσβάσιμο μόνο από εσάς. Δεν είναι δημόσια προσβάσιμη.
    • Θα πρέπει να δείτε το Tomcat " Συγχαρητήρια" σελίδα. Αν υπάρχει πρόβλημα, δείτε το αρχείο καταγραφής Tomcat tomcat/logs/catalina.out.

Προβλήματα με την εγκατάσταση Tomcat;

• Σε Linux και Mac, αν δεν μπορείτε να φτάσετε Tomcat ήERDDAP™ (Ή απλά δεν μπορείς να τους βρεις από έναν υπολογιστή έξω από το τείχος προστασίας σου.) , μπορείτε να δοκιμάσετε αν Tomcat ακούει τη θύρα 8080, πληκτρολογώντας (ως ρίζα) σε γραμμή εντολών του εξυπηρετητή:

    netstat -tuplen | grep 8080  

Αυτό θα πρέπει να επιστρέψει μια γραμμή με κάτι σαν:

    tcp 0 0 :::8080 :::\\* LISTEN ## ##### ####/java

(όπου το '#' είναι κάποιο ψηφίο) , υποδεικνύοντας ότι η διαδικασία a "java" (Μάλλον Τόμκατ.) ακούει στο λιμάνι "8080" για " tcp" κυκλοφορία. Εάν δεν επιστραφούν γραμμές, εάν η γραμμή που επιστρέφεται είναι σημαντικά διαφορετική, ή αν επιστράφηκαν δύο ή περισσότερες γραμμές, τότε μπορεί να υπάρξει πρόβλημα με τις ρυθμίσεις της θύρας.

• Δείτε το αρχείο καταγραφής Tomcat tomcat/logs/catalina.out. Προβλήματα Tomcat και μερικάERDDAP™Τα προβλήματα εκκίνησης σχεδόν πάντα εμφανίζονται εκεί. Αυτό είναι συνηθισμένο όταν πρώτη φορά στήνετεERDDAP™.
• Δείτε τοΤομκάτιστοσελίδα ή αναζήτηση του ιστού για βοήθεια, αλλά παρακαλούμε να μας ενημερώσετε τα προβλήματα που είχατε και τις λύσεις που βρήκατε.
• Δείτε μαςτμήμα για τη λήψη πρόσθετης υποστήριξης.  

ERDDAP™Περιεχόμενο

3. Ρυθμίστε το_tomcat_/content/erddapαρχεία ρυθμίσεων.
   Σε Linux, Mac και Windows, κατεβάστεerddapΠεριεχόμενο.zip (έκδοση 1.0.0, 20333 bytes, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, με ημερομηνία 2024-10-14) και αποσυμπίεση σε tomcat, δημιουργία_tomcat_/content/erddap.

   \[Μερικές προηγούμενες εκδόσεις είναι επίσης διαθέσιμες: 2.17 (19.792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, με ημερομηνία 2022-02-16)
   2.18 (19.792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, με ημερομηνία 2022-02-16)
   2.21 (19,810 bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, με ημερομηνία 2022-10-09)
   2.22 (19.810 bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, με ημερομηνία 2022-12-08) 2.23 (19.810 bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, με ημερομηνία 2023-02-27) και αποσυμπίεση σε tomcat, δημιουργία_tomcat_/content/erddap.\]

Άλλος κατάλογος

Για το Red Hat Enterprise Linux (ΡΕΛ) ή για άλλες περιπτώσεις όπου δεν επιτρέπεται να τροποποιήσετε τον κατάλογο Tomcat ή όπου θέλετε / πρέπει να βάλετε τοERDDAP™κατάλογος περιεχομένου σε κάποια άλλη τοποθεσία για κάποιο άλλο λόγο (για παράδειγμα, αν χρησιμοποιείτε Jetty αντί Tomcat) , unzip erddapΠεριεχόμενο.zipστον επιθυμητό κατάλογο (στην οποία έχει πρόσβαση μόνο ο χρήστης=tomcat) και να ορίσετε τοerddapContentDirectoryιδιότητα συστήματος (π.χ.,erddapContentDirectory=~tomcat/content/erddap) Οπότε...ERDDAP™μπορεί να βρει αυτόν τον νέο κατάλογο περιεχομένου.

setup.xml

• Διαβάστε τα σχόλια_tomcat_/content/erddap/ setup.xml και να κάνει τις ζητούμενες αλλαγές. setup.xml είναι το αρχείο με όλες τις ρυθμίσεις που καθορίζουν πώς σαςERDDAP™Συμπεριφέρεται καλά. Για την αρχική ρύθμιση, ΠΡΕΠΕΙ τουλάχιστον να αλλάξετε αυτές τις ρυθμίσεις:

    <bigParentDirectory>, <emailEverythingTo>, <baseUrl>, <email.\\*>, <admin.\\*> (and <baseHttpsUrl> when you set up https).

Όταν δημιουργείτε το bigParentΚατάλογος, από τον γονικό κατάλογο του bigParentΚατάλογος:

• Κάντε user=tomcat τον ιδιοκτήτη του BigParentΚατάλογος, π.χ.,

        chown -R tomcat _bigParentDirectory_

• Αλλαγή της ομάδας" να είναι Tomcat, το όνομα χρήστη σας, ή το όνομα μιας μικρής ομάδας που περιλαμβάνει Tomcat και όλους τους διαχειριστές του Tomcat /ERDDAP, π.χ.,

        chgrp -R _yourUserName_ _bigParentDirectory_

• Αλλάξτε άδειες έτσι ώστε ο Tomcat και η ομάδα να έχουν διαβάσει, γράψει, εκτελέσει προνόμια, π.χ..

        chmod -R ug+rwx _bigParentDirectory_

• Αφαίρεση " άλλων" αδειών χρήσης για ανάγνωση, εγγραφή ή εκτέλεση. Αυτό είναι σημαντικό για την πρόληψη της ανάγνωσης ενδεχομένως ευαίσθητων πληροφοριώνERDDAP™αρχεία καταγραφής και αρχεία με πληροφορίες για ιδιωτικά σύνολα δεδομένων.:

        chmod -R o-rwx _bigParentDirectory_

Μεταβλητές περιβάλλοντος

Ξεκινώντας μεERDDAP™v2.13,ERDDAP™Οι διαχειριστές μπορούν να παρακάμπτουν οποιαδήποτε τιμή στο setup.xml προσδιορίζοντας μια μεταβλητή περιβάλλοντος με όνομαERDDAP\ΑξίαName πριν την εκτέλεσηERDDAP™. Για παράδειγμα, χρήσηERDDAP\_ baseUrl παρακάμπτει το<ΒάσηUrl> τιμή. Αυτό μπορεί να είναι χρήσιμο κατά την ανάπτυξηERDDAP™με ένα δοχείο όπως Docker, όπως μπορείτε να βάλετε τις τυπικές ρυθμίσεις στο setup.xml και στη συνέχεια να παρέχει ειδικές ρυθμίσεις μέσω μεταβλητών περιβάλλοντος. Εάν παρέχετε μυστικές πληροφορίεςERDDAP™μέσω αυτής της μεθόδου, βεβαιωθείτε ότι οι πληροφορίες θα παραμείνουν μυστικές.ERDDAP™μόνο διαβάζει τις μεταβλητές περιβάλλοντος μία φορά ανά εκκίνηση, στο πρώτο δευτερόλεπτο της εκκίνησης, έτσι ένας τρόπος για να χρησιμοποιήσετε αυτό είναι: ρυθμίστε τις μεταβλητές περιβάλλοντος, ξεκινήστεERDDAP, περιμένετε μέχριERDDAP™αρχίζει, στη συνέχεια, αποκαθιστά τις μεταβλητές περιβάλλοντος.

datasets.xml

• Διαβάστε τα σχόλια Συνεργασία με τοdatasets.xmlΑρχείο . Αργότερα, αφού πάρειςERDDAP™τρέχει για πρώτη φορά (συνήθως με μόνο τα προεπιλεγμένα σύνολα δεδομένων) , θα τροποποιήσετε το XML σε_tomcat_/content/erddap/ datasets.xml για να ορίσετε όλα τα σύνολα δεδομένων που θέλετεERDDAP™να υπηρετήσω. Εδώ θα περνάς το μεγαλύτερο μέρος του χρόνου σου ενώ στήνειςERDDAP™και αργότερα κατά τη διατήρηση σαςERDDAP™.

Μπορείτε να δείτε ένα παράδειγμαdatasets.xmlστο GitHub.  

• (Απίθανο.) Τώρα ή (Λίγο πιο πιθανό.) Στο μέλλον, αν θέλετε να τροποποιήσετε το αρχείο CSS του erddap, κάντε ένα αντίγραφο του_tomcat_/content/erddap/images/erddapStart2.css ονομάζεται erddap2.css και στη συνέχεια να κάνει αλλαγές σε αυτό. Οι αλλαγές στο erddap2.css αρχίζουν να ισχύουν μόνο ότανERDDAP™επανεκκινείται και συχνά απαιτεί επίσης από το χρήστη να καθαρίσει τα κρυμμένα αρχεία του προγράμματος περιήγησης.   ERDDAP™δεν θα λειτουργήσει σωστά εάν η ρύθμιση.xml ήdatasets.xmlΤο αρχείο δεν είναι καλοσχηματισμένο αρχείο XML. Έτσι, αφού επεξεργαστείτε αυτά τα αρχεία, είναι μια καλή ιδέα να επαληθεύσετε ότι το αποτέλεσμα είναι καλά διαμορφωμένο XML επικολλώντας το κείμενο XML σε έναν έλεγχο XML όπωςΕπικύρωση xml.  

Εγκαταστήστε το αρχείο erddap.war

4. Σε Linux, Mac και Windows, κατεβάστεErddap.war (στα Αγγλικά).tomcat/webapps . (έκδοση 2.25_1, 592,292,039 bytes, MD5=652AFC9D1421F00B5F789DA2C4732D4C, με ημερομηνία 2024-11-07)

Το αρχείο .war είναι μεγάλο επειδή περιέχει ακτογραμμή υψηλής ανάλυσης, όρια και δεδομένα ανύψωσης που απαιτούνται για τη δημιουργία χαρτών.

\[Μερικές προηγούμενες εκδόσεις είναι επίσης διαθέσιμες. 2.17 (551.068.245 bytes, MD5=5FEA912B5D42E50EAB9591F773EA848D, με ημερομηνία 2022-02-16)
2.18 (551,069.844 bytes, MD5=461325E97E7577EC671DD50246CCFB8B, με ημερομηνία 2022-02-23)
2.21 (568.644.411 bytes, MD5=F2CFF805893146E932E498FDDBD519B6, με ημερομηνία 2022-10-09)
2.22 (567.742.665 bytes, MD5=2B33354F633294213AE2AFDDCF4DA6D0, με ημερομηνία 2022-12-08) 2.23 (572,124,953 bytes, MD5=D843A043C506725EBD6F8EFDCA8FD5F, με ημερομηνία 2023-03-03) 2.24 (568.748.187 bytes, MD5=970fbee172e28b0b8a07756eecbc898e, με ημερομηνία 2024-06-07) \]

ProxyPass (στα Αγγλικά)

5. Χρήση διαμεσολαβητή Περάστε ώστε οι χρήστες να μην χρειάζεται να τοποθετήσουν τον αριθμό θύρας, π.χ., :8080, στο URL. Στους υπολογιστές Linux, αν ο Tomcat τρέχει στους Απάτσι, παρακαλώ τροποποιήστε τους Apachehttpαρχείο d.conf (συνήθως στο /etc/httpδ/conf/) να επιτρέπει την κυκλοφορία HTTP προς/απόERDDAP™χωρίς να απαιτείται ο αριθμός θύρας, π.χ., :8080, στο URL. Ως ο ριζικός χρήστης:
   1. Τροποποίηση του υπάρχοντος<VirtualHost> tag (αν υπάρχει) , ή να προσθέσετε ένα στο τέλος του αρχείου:

        <VirtualHost \\*:80>
           ServerName _YourDomain.org_
           ProxyRequests Off
           ProxyPreserveHost On
           ProxyPass /erddap http://localhost:8080/erddap
           ProxyPassReverse /erddap http://localhost:8080/erddap
        </VirtualHost>

2. Στη συνέχεια επανεκκίνηση Apache: /usr/sbin/apachectl -Χάρηκα. (Αλλά μερικές φορές είναι σε διαφορετικό κατάλογο) .  

NGINX

(UNCOΜΜΟΝ) Εάν χρησιμοποιείτεNGINX (Διακομιστής ιστού και ισοσταθμιστής φορτίου) : προκειμένου να ληφθεί NGINX καιERDDAP™να λειτουργεί σωστά μεhttps, θα πρέπει να βάλετε το ακόλουθο snippet μέσα στο διακομιστή Tomcat.xml<Υποδοχή & gt; block:

    <Valve className="org.apache.catalina.valves.RemoteIpValve"  
      remoteIpHeader="X-Forwarded-For"  
      protocolHeader="X-Forwarded-Proto"  
      protocolHeaderHttpsValue="https" /> 

Και στο αρχείο ρυθμίσεων Nginx, θα πρέπει να ρυθμίσετε αυτές τις κεφαλίδες:

      proxy\\_set\\_header Host              $host;
      proxy\\_set\\_header X-Real-IP         $remote\\_addr;
      proxy\\_set\\_header REMOTE\\_ADDR       $remote\\_addr;
      proxy\\_set\\_header HTTP\\_CLIENT\\_IP    $remote\\_addr;
      proxy\\_set\\_header X-Forwarded-For   $proxy\\_add\\_x\\_forwarded\\_for;
      proxy\\_set\\_header X-Forwarded-Proto $scheme;

(Χάρη στον Κάιλ Γουίλκοξ.)
 

Εκκίνηση Tomcat

• (Δεν συνιστώ να χρησιμοποιήσετε το Tomcat Web Application Manager. Αν δεν κλείσεις πλήρως και ξεκινήσεις το Tomcat, αργά ή γρήγορα θα έχεις προβλήματα μνήμης PermGen.)
   
• (Σε Linux ή Mac OS, αν έχετε δημιουργήσει έναν ειδικό χρήστη για να εκτελέσετε Tomcat, π.χ., Tomcat, θυμηθείτε να κάνετε τα ακόλουθα βήματα ως αυτός ο χρήστης.)
   
• Αν ο Tomcat ήδη τρέχει, κλείσε τον Tomcat με (σε Linux ή Mac OS) tomcat/bin/shutdown.sh ή (στα Windows) Tomcat\bin\shutdown.bat

Σε Linux, χρήση ps -ef|grep tomcat πριν και μετά το κλείσιμο.sh για να βεβαιωθείτε ότι η διαδικασία tomcat έχει σταματήσει. Η διαδικασία θα πρέπει να καταχωρηθεί πριν από τη διακοπή λειτουργίας και τελικά να μην καταχωρηθεί μετά τη διακοπή λειτουργίας. Μπορεί να πάρει ένα ή δύο λεπτά γιαERDDAP™να κλείσει πλήρως. Κάνε υπομονή. Ή αν φαίνεται ότι δεν θα σταματήσει από μόνο του, χρήση: kill -9 processID

• Εκκίνηση Tomcat με (σε Linux ή Mac OS) tomcat/bin/startup.sh ή (στα Windows) tomcat\binbin\startup.bat

ΕίναιERDDAP™Να τρέξω;

Χρήση ενός περιηγητή για την προβολή http://www.YourServer.org/erddap/status.html
ERDDAP™ξεκινά χωρίς να φορτώνονται σύνολα δεδομένων. Τα σύνολα δεδομένων φορτώνονται σε ένα νήμα φόντου και έτσι γίνονται διαθέσιμα ένα προς ένα.

Αντιμετώπιση προβλημάτων

• Όταν ένα αίτημα από ένα χρήστη έρχεται, πηγαίνει σε Apache (σε υπολογιστές Linux και Mac OS) , τότε Tomcat, τότεERDDAP™.
• Μπορείς να δεις τι έρχεται στους Απάτσι. (και σχετικά σφάλματα) Στα αρχεία καταγραφής των Απάτσι.
• Εσύ.μπορεί να δει τι έρχεται στον Tomcat (και σχετικά σφάλματα) στα αρχεία καταγραφής Tomcat (tomcat/logs/catalina.out και άλλα αρχεία του καταλόγου) .
• Εσύ.μπορεί να δει τι έρχεται ναERDDAP, διαγνωστικά μηνύματα απόERDDAP, και μηνύματα σφάλματος απόERDDAP, στοERDDAP™ <bigParentΚατάλογος>logs/log.txt αρχείο.
• Το Tomcat δεν ξεκινάει.ERDDAP™έως ότου Tomcat λάβει μια αίτηση γιαERDDAP™. Έτσι μπορείτε να δείτε στα αρχεία καταγραφής Tomcat αν ξεκίνησεERDDAP™ή εάν υπάρχει μήνυμα σφάλματος σχετικό με αυτή την προσπάθεια.
• ΠότεERDDAP™αρχίζει, μετονομάζει το παλιόERDDAP™αρχείο log.txt (logArchivedAt_CurrentTime_.txt) και δημιουργεί ένα νέο αρχείο καταγραφής.txt. Αν το ημερολόγιο. Txt αρχείο είναι παλιά, είναι ένα σημάδι ότιERDDAP™Δεν έχει επανεκκινήσει πρόσφατα.ERDDAP™γράφει πληροφορίες καταγραφής σε μια ενδιάμεση μνήμη και γράφει μόνο την ενδιάμεση μνήμη στο αρχείο καταγραφής περιοδικά, αλλά μπορείτε να πιέσετεERDDAP™για να γράψετε την ενδιάμεση μνήμη στο αρχείο καταγραφής με την επίσκεψη .../erddap/status.html.

Πρόβλημα: Παλιά έκδοση τουJava

Εάν χρησιμοποιείτε μια έκδοση τουJavaΑυτό είναι πολύ παλιό γιαERDDAP,ERDDAP™δεν τρέχει και θα δείτε ένα μήνυμα σφάλματος στο αρχείο καταγραφής Tomcat όπως Εξαίρεση στο νήμα "κύριο" java.lang.Un supportedClassVersionError: μερική/κατηγορία/όνομα: Μη υποστηριζόμενη έκδοση major.minor omeNumber Η λύση είναι να ενημερώσετε την πιο πρόσφατη έκδοση τουJavaκαι σιγουρέψου ότι το χρησιμοποιεί ο Τόμκατ.

Πρόβλημα: Αργή εκκίνηση πρώτη φορά

Tomcat πρέπει να κάνει πολλή δουλειά την πρώτη φορά μια εφαρμογή όπωςERDDAP™έχει ξεκινήσει· κυρίως, πρέπει να ξεπακετάρει το erddap. αρχείο πολέμου (που είναι σαν ένα.zipαρχείο) . Σε κάποιους servers, η πρώτη προσπάθεια προβολήςERDDAP™πάγκοι (30 δευτερόλεπτα;) μέχρι να τελειώσει αυτή η δουλειά. Σε άλλους διακομιστές, η πρώτη προσπάθεια θα αποτύχει αμέσως. Αλλά αν περιμένετε 30 δευτερόλεπτα και δοκιμάσετε ξανά, θα πετύχει ανERDDAP™έχει εγκατασταθεί σωστά. Δεν υπάρχει λύση γι' αυτό. Έτσι λειτουργεί ο Τόμκατ. Αλλά συμβαίνει μόνο την πρώτη φορά αφού εγκαταστήσετε μια νέα έκδοση τουERDDAP™.

Κλείσιμο και επανεκκίνηση

Στο μέλλον, για να κλείσει (και επανεκκίνηση) ERDDAP, δείτεΠώς να κλείσετε και να επανεκκινήσετε Tomcat καιERDDAP.

Πρόβλημα;

Προβλήματα εγκατάστασης Tomcat ήERDDAP♪ ♪ Δείτε μαςτμήμα για τη λήψη πρόσθετης υποστήριξης.

Email Κοινοποίηση των νέων εκδόσεων τουERDDAP

Εάν θέλετε να λάβετε ένα email κάθε φορά που μια νέα έκδοση τουERDDAP™είναι διαθέσιμο ή άλλο σημαντικόERDDAP™ανακοινώσεις, μπορείτε να συμμετάσχετε στοERDDAP™Κατάλογος ανακοινώσεωνΕδώ.. Αυτή η λίστα έχει μέσο όρο περίπου ένα email κάθε τρεις μήνες.

Προσαρμογή

ΠροσαρμογήERDDAP™να τονίσει την οργάνωσή σας (όχιNOAA ERD) .

• Αλλάξτε το banner που εμφανίζεται στην κορυφή όλωνERDDAP™.html σελίδες με την επεξεργασία του<startBodyHtml5> tag in yourdatasets.xmlΑρχείο. (Εάν δεν υπάρχει, αντιγράψτε την προεπιλεγμένη απόERDDAPΣ \[τομκάτ\]/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml αρχείο σεdatasets.xmlκαι να το επεξεργαστείτε.) Για παράδειγμα, θα μπορούσατε:
  • Χρήση διαφορετικής εικόνας (Δηλαδή, το λογότυπο του οργανισμού σας) .
  • Αλλαγή χρώματος φόντου.
  • Αλλαγή "ERDDAP" στην οργάνωση σαςERDDAP"
  • Αλλαγή " Ευκολότερη πρόσβαση σε επιστημονικά δεδομένα" σε ευκολότερη πρόσβαση στα δεδομένα του YourOrganization
  • Αλλάξτε το "Brought σε σας από" συνδέσεις για να είναι συνδέσεις με την οργάνωσή σας και πηγές χρηματοδότησης.
• Αλλαγή των πληροφοριών στην αριστερή πλευρά της αρχικής σελίδας με την επεξεργασία του<theShortDescriptionHtml> tag in yourdatasets.xmlΑρχείο. (Εάν δεν υπάρχει, αντιγράψτε την προεπιλεγμένη απόERDDAPΣ \[τομκάτ\]/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml αρχείο σεdatasets.xmlκαι να το επεξεργαστείτε.) Για παράδειγμα, θα μπορούσατε:
  • Περιγράψτε τι κάνει η οργάνωση ή/και η ομάδα σας.
  • Περιγράψτε τι είδους δεδομένα είναι αυτάERDDAP™Έχει.
• Για να αλλάξετε το εικονίδιο που εμφανίζεται στις καρτέλες του προγράμματος περιήγησης, τοποθετήστε το favicon του οργανισμού σας. ικό_tomcat_/content/erddap/εικόνες/ . Βλέπεις; https://en.wikipedia.org/wiki/Favicon .