Μετάβαση στο κύριο περιεχόμενο

Εγκατάσταση

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

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

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

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

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

Java​

  1. Για ERDDAP™ v2.29.0+, εγκατάσταση Java 25. Για λόγους ασφαλείας, είναι σχεδόν πάντα καλύτερο να χρησιμοποιήσετε την τελευταία έκδοση του Java 25. Παρακαλώ κατεβάστε και εγκαταστήστε την τελευταία έκδοση του Το OpenJDK της υιοθεσίας (Τεμουρίνη) 25 (LTS) . Για να επαληθεύσετε την εγκατάσταση, εκτελέστε /JavaJreBinΚατάλογος/Java -έκδοση , για παράδειγμα /usr/local/jdk-25.0.1+8/jre/bin/java -έκδοση .

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

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

Τομκάτ​

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

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

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

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

  • Στο Linux, κατεβάστε το "Core" "tar .gz " Διανομή Tomcat και να το ξεπακετάρω. Συνιστούμε να το ξεπακετάρουμε. /usr/τοπική .
  • Σε ένα Mac, Tomcat είναι πιθανώς ήδη εγκατεστημένο σε /Βιβλιοθήκη/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 Name αρχείο, υπάρχουν δύο αλλαγές που πρέπει να κάνετε σε καθένα από τα δύο <Connector> ετικέτες (ένα για Λιμένας &lt; Connector ="8080" και ένα για Λιμένας &lt; Conector="8443" ) .
    1. (Συνιστώμενη) Αύξηση της σύνδεση Χρονικό όριο τιμή παραμέτρου, ίσως έως 300000 (χιλιοστά του δευτερολέπτου, που είναι 5 λεπτά) .
    2. (Συνιστώμενη) Προσθήκη μιας νέας παράμετρου: χαλαρήQueryChars="[] | " . Αυτό είναι προαιρετικό και ελαφρώς λιγότερο ασφαλές, αλλά αφαιρεί την ανάγκη για τους χρήστες να το ποσοστό-κωδικοποιεί αυτούς τους χαρακτήρες όταν εμφανίζονται στις παραμέτρους του URL αίτημα ενός χρήστη.  

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

  • πλαίσιο.xml -- Πόροι λανθάνουσας μνήμης τομκάτ/conf/context.xml , ακριβώς πριν από την </Context> ετικέτα, αλλαγή της ετικέτας Πόρων (ή να το προσθέσετε αν δεν είναι ήδη εκεί) για τον ορισμό της λανθάνουσας μνήμης Μέγιστη παράμετρος μεγέθους σε 80000: 
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Αυτό αποφεύγει πολυάριθμες προειδοποιήσεις στην καταλίνα. Αυτό είναι όλο.

WARNING [main] org.apache.catalina.webresources.Cache.getResource Unable to add the resource at [/WEB-INF/classes/...]

 

Χρονικό όριο Apache​

  • Στους υπολογιστές Linux, αλλάξτε τις ρυθμίσεις χρονικού ορίου Apache έτσι ώστε τα αιτήματα χρήστη που καταναλώνουν χρόνο να μην timeout (με αυτό που συχνά εμφανίζεται ως ένα "Proxy" ή "Bad Gateway" σφάλμα) . Ως ο ριζικός χρήστης:
    • Τροποποίηση των Απάτσι http δ.conf αρχείο (συνήθως σε /εκατ. http δ/conf/ ) :
      • Αλλαγή του υπάρχοντος <Timeout> setting (ή να προσθέσετε ένα στο τέλος του αρχείου) έως 3600 (δευτερόλεπτα) , αντί των προκαθορισμένων 60 ή 120 δευτερολέπτων.
      • Αλλαγή του υπάρχοντος <ProxyTimeout> setting (ή να προσθέσετε ένα στο τέλος του αρχείου) έως 3600 (δευτερόλεπτα) , αντί των προκαθορισμένων 60 ή 120 δευτερολέπτων.
    • Επανεκκίνηση Απάτσι: /usr/sbin/apachectl -κ χαριτωμένα (Αλλά μερικές φορές είναι σε διαφορετικό κατάλογο) .

Ασφάλεια​

 

  • Σύσταση ασφάλειας: Βλέπεις; Αυτές οι οδηγίες να αυξήσει την ασφάλεια της εγκατάσταση Tomcat σας, ειδικά για δημόσιους servers.  
  • Για το κοινό ERDDAP™ εγκαταστάσεις σε Linux και Macs, είναι καλύτερο να συσταθεί Tomcat (το πρόγραμμα) ως ανήκει στον χρήστη τομκάτ (ξεχωριστό χρήστη με περιορισμένες άδειες και ο οποίος δεν έχει κωδικό πρόσβασης ) . Έτσι, μόνο ο σούπερ χρήστης μπορεί να αλλάξει σε λειτουργία ως χρήστης τομκάτ . Αυτό καθιστά αδύνατη την είσοδο των χάκερ στο διακομιστή σας ως χρήστη τομκάτ . Και σε κάθε περίπτωση, θα πρέπει να το κάνετε έτσι ώστε η τομκάτ Ο χρήστης έχει πολύ περιορισμένες άδειες στο σύστημα αρχείων του διακομιστή (διαβάστε+write+execute proνόμια για την Απάτσι-τομκάτος δέντρο καταλόγου και <bigParentDirectory> και δικαιώματα μόνο ανάγνωσης για καταλόγους με δεδομένα που ERDDAP™ χρειάζεται πρόσβαση σε).
    • Μπορείτε να δημιουργήσετε το τομκάτ λογαριασμός χρήστη (που δεν έχει κωδικό πρόσβασης) χρησιμοποιώντας την εντολή: 
      sudo useradd tomcat -s /bin/bash -p '*'
    • Μπορείτε να μεταβείτε σε λειτουργία ως χρήστης τομκάτ χρησιμοποιώντας την εντολή 
      sudo su - tomcat
      (Θα σας ζητήσει τον κωδικό πρόσβασης υπερχρήστη για την άδεια για να το κάνετε αυτό.)
      • Μπορείτε να σταματήσετε να εργάζεστε ως χρήστης tomcat χρησιμοποιώντας την εντολή
      exit
      • Κάνε το υπόλοιπο Tomcat και ERDDAP™ οδηγίες ρύθμισης ως χρήστης τομκάτ . Αργότερα, τρέξτε το Εκκίνηση. και Κλείσιμο. Σσσ. σενάρια ως χρήστης τομκάτ Έτσι ώστε ο Tomcat να έχει άδεια να γράψει στα αρχεία καταγραφής του.
      • Μετά την αποσυσκευασία Tomcat, από το γονέα του Απάτσι-τομκάτος κατάλογος:
        • Αλλαγή ιδιοκτησίας του δέντρου καταλόγου apache-tomcat στον χρήστη tomcat. 
          chown -R tomcat apache-tomcat-10.0.23
          (αλλά να αντικαταστήσει το πραγματικό όνομα του καταλόγου tomcat σας) .
        • Αλλαγή της ομάδας" να είναι Tomcat, το όνομα χρήστη σας, ή το όνομα μιας μικρής ομάδας που περιλαμβάνει Tomcat και όλους τους διαχειριστές του Tomcat / ERDDAP : 
          chgrp -R yourUserName 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 και Mac: Δημιουργία αρχείου tomcat/bin/setenv.sh (ή στο Red Hat Enterprise Linux \[ ΡΕΛ \] , επεξεργασία ~tomcat/conf/tomcat10.conf ) να ρυθμίσουν τις μεταβλητές περιβάλλοντος του Tomcat. Αυτό το αρχείο θα χρησιμοποιηθεί από tomcat/bin/startup.sh και Κλείσιμο. Σσσ. . Το αρχείο πρέπει να περιέχει κάτι σαν:

    export JAVA_HOME=/usr/local/jdk-25.0.1+8
    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

    (αλλά να αντικαταστήσει τα ονόματα καταλόγου από τον υπολογιστή σας) . (Εάν έχετε ορίσει προηγουμένως _ΧΡΩΜΑ Μπορείς να το αφαιρέσεις αυτό.) Στο Macs, μάλλον δεν χρειάζεται να ορίσετε JAVA_HOME .

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

    SET "JAVA_HOME=\\someDirectory\\jdk-25.0.1+8"
    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. (Εάν έχετε ορίσει προηγουμένως _ΧΡΩΜΑ Μπορείς να το αφαιρέσεις αυτό.)

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

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

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

    • Με Java 8, θα πρέπει να προσθέσετε - δ64 στην Tomcat CATALINA_OPTS (Κάτω Χώρες) παράμετρος σε setenv.bat (στα Αγγλικά). .
    • Με Java 21, διαλέγεις 64 bit. Java όταν κατεβάζετε μια έκδοση του Java σημειώνονται "64 bit".

Με 64 bit Java , Tomcat και Java μπορεί να χρησιμοποιήσει πολύ υψηλή - Xmx. και -Xms. settings. Όσο πιο φυσική μνήμη στον server τόσο το καλύτερο. Ως μια απλοϊκή πρόταση: σας συνιστούμε να ορίσετε - Xmx. και -Xms. σε (στο 'M'egaBytes') έως 1/2 (ή λιγότερο) της φυσικής μνήμης του υπολογιστή. Μπορείς να δεις αν ο Tomcat, Java και ERDDAP™ τρέχουν πράγματι σε λειτουργία 64 bit με την αναζήτηση για " bit," in ERDDAP Ηλεκτρονικό ταχυδρομείο Daily Report ή bigParentΚατάλογος/logs/ [log.txt](/docs/server-admin/additional-information#log) αρχείο ( bigParentΚατάλογος προσδιορίζεται στο setup.xml ) .

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

  • Μέσα ERDDAP™ " log.txt αρχείο, θα δείτε πολλά "GC (Αποτυχία κατανομής) " μηνύματα. Αυτό συνήθως δεν είναι πρόβλημα. Είναι ένα συχνό μήνυμα από μια κανονική λειτουργία Java λέγοντας ότι μόλις τελείωσε ένα μικρό σκουπίδι Η συλλογή γιατί δεν είχε χώρο στην Εδέμ (το τμήμα της Java σωρός για πολύ νεαρά αντικείμενα) . Συνήθως το μήνυμα σας δείχνει χρήση μνήμης πριν από-&gt; μνήμη χρήσης μετά . Αν αυτοί οι δύο αριθμοί είναι κοντά, σημαίνει ότι η συλλογή σκουπιδιών δεν ήταν παραγωγική. Το μήνυμα είναι μόνο ένα σημάδι προβλήματος αν είναι πολύ συχνό. (κάθε λίγα δευτερόλεπτα) , όχι παραγωγικό, και οι αριθμοί είναι μεγάλοι και δεν αυξάνονται, που μαζί δείχνουν ότι Java χρειάζεται περισσότερη μνήμη, αγωνίζεται να απελευθερώσει τη μνήμη, και αδυνατεί να απελευθερώσει τη μνήμη. Αυτό μπορεί να συμβεί κατά τη διάρκεια μιας αγχωτικής περιόδου, και στη συνέχεια να φύγει. Αλλά αν επιμένει, αυτό είναι σημάδι προβλήματος.
  • Αν δεις Java.lang.OutMemoryError (στα Αγγλικά) σε ERDDAP™ " log.txt αρχείο, Βλέπε Εκτός μνήμης για συμβουλές σχετικά με τον τρόπο διάγνωσης και επίλυσης των προβλημάτων.  

Άδειες​

chmod +x *.sh

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

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

Αν επιλέξετε να χρησιμοποιήσετε τις γραμματοσειρές DejaVu, βεβαιωθείτε ότι το <fontFamily> ρύθμιση σε setup.xml είναι <fontFamily> Ντεγιάβου Σανς </fontFamily> .

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

  • Στο Linux:
    • Για το Linux Admitium Java διανομές, βλέπε Αυτές οι οδηγίες .
    • Με άλλα Java διανομές: Ως τομκάτ χρήστη, αντιγραφή των αρχείων γραμματοσειράς σε $JAVA_HOME/lib/φορητές Οπότε... Java μπορεί να βρει τις γραμματοσειρές. Θυμηθείτε: αν / όταν αργότερα αναβάθμιση σε μια νεότερη έκδοση του Java , θα πρέπει να επανεγκαταστήσετε αυτές τις γραμματοσειρές.
  • Σε Macs: για κάθε αρχείο γραμματοσειράς, κάντε διπλό κλικ σε αυτό και, στη συνέχεια, κάντε κλικ στο Install Font.
  • Στα Windows 7 και 10: στο Windows Explorer, επιλέξτε όλα τα αρχεία γραμματοσειράς. Δεξί κλικ. Κάντε κλικ στο Εγκατάσταση.  

Δοκιμή Tomcat​

  • Δοκιμάστε την εγκατάσταση Tomcat σας.
    • Linux:
    • Μακ (εκτελέστε tomcat ως ο χρήστης του συστήματος) :
      • Εκτέλεση tomcat/bin/startup.sh .
      • Δείτε το URL σας + ":8080" στον browser σας (π.χ., http://coastwatch.pfeg.noaa.gov:8080/ ) . Σημειώστε ότι από προεπιλογή, Tomcat σας είναι προσβάσιμο μόνο από εσάς. Δεν είναι δημόσια προσβάσιμη.
    • Εντοπισμός παραθύρων:
      • Κάντε δεξί κλικ στο εικονίδιο Tomcat στο δίσκο συστήματος, και επιλέξτε "Εκκίνηση υπηρεσίας.
      • Προβολή http://127.0.0.1:8080/ , ή ίσως http://localhost:8080/ , στο πρόγραμμα περιήγησης σας. Σημειώστε ότι από προεπιλογή, Tomcat σας είναι προσβάσιμο μόνο από εσάς. Δεν είναι δημόσια προσβάσιμη.

Θα πρέπει να δείτε το Tomcat " Συγχαρητήρια" σελίδα.

Αν υπάρχει πρόβλημα, δείτε το αρχείο καταγραφής Tomcat στο tomcat/logs/καταλίνα.out .

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

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

    netstat -tuplen | grep 8080

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

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

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

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

  • Δείτε το Τομκάτ ιστοσελίδα ή αναζήτηση του ιστού για βοήθεια, αλλά παρακαλούμε ενημερώστε μας τα προβλήματα που είχατε και τις λύσεις που βρήκατε.

  • Δείτε μας Τμήμα για τη λήψη πρόσθετης υποστήριξης .  

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

  1. Ρυθμίστε το tomcat/content/erddap αρχεία διαμόρφωσης. Σε Linux, Mac, και Windows, κατεβάστε erddapΠεριεχόμενο .zip και ξεκουμπώστε το στο τομκάτ κατάλογος, δημιουργία tomcat/content/erddap .

Έκδοση 1.0.1, 20683 bytes, MD5=98a8099e7e674da59fe35e9c96efa7b5, με ημερομηνία 2025-06-02_

Μερικές προηγούμενες εκδόσεις είναι επίσης διαθέσιμες:

  • 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)

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

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

setup.xml​

Για την αρχική ρύθμιση, ΠΡΕΠΕΙ τουλάχιστον να αλλάξετε αυτές τις ρυθμίσεις:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> settings
  • <admin...> settings
  • <baseHttpsUrl> (όταν στήνεις https )

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

  • Κάντε το τομκάτ χρήστη του ιδιοκτήτη του 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 _ΒάσηUrl παρακάμπτει το <baseUrl> αξία. Αυτό μπορεί να είναι χρήσιμο κατά την ανάπτυξη ERDDAP™ με ένα δοχείο όπως Docker, όπως μπορείτε να βάλετε τις τυπικές ρυθμίσεις στη ρύθμιση.xml και στη συνέχεια παρέχουν ειδικές ρυθμίσεις μέσω μεταβλητών περιβάλλοντος. Εάν παρέχετε μυστικές πληροφορίες ERDDAP™ μέσω αυτής της μεθόδου, Βεβαιωθείτε ότι οι πληροφορίες θα παραμείνουν μυστικές. ERDDAP™ μόνο διαβάζει τις μεταβλητές περιβάλλοντος μία φορά ανά εκκίνηση, στο πρώτο δευτερόλεπτο της εκκίνησης, έτσι ένας τρόπος για να το χρησιμοποιήσετε αυτό είναι: ρυθμίστε τις μεταβλητές περιβάλλοντος, ξεκινήστε ERDDAP , Περίμενε μέχρι ERDDAP™ αρχίζει, στη συνέχεια, unset τις μεταβλητές περιβάλλοντος.

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 σε tomcat/content/erddap/images/erddap2.css και στη συνέχεια να κάνει αλλαγές σε αυτό. Αλλαγές erddap2.css (στα Αγγλικά). παράγει αποτελέσματα μόνο όταν ERDDAP™ επανεκκινείται και συχνά απαιτούν επίσης από το χρήστη να καθαρίσει τα κρυμμένα αρχεία του προγράμματος περιήγησης.   ERDDAP™ δεν θα λειτουργήσει σωστά αν η ρύθμιση.xml ή datasets.xml Το αρχείο δεν είναι καλοσχηματισμένο αρχείο XML. Έτσι, αφού επεξεργαστείτε αυτά τα αρχεία, είναι μια καλή ιδέα να επαληθεύσετε ότι το αποτέλεσμα είναι καλά διαμορφωμένο XML με την επικόλληση του κειμένου XML σε έναν έλεγχο XML όπως Επικύρωση xml .  

Εγκαταστήστε το erddap. αρχείο πολέμου​

  1. Σε Linux, Mac, και Windows, __download erddap.war (στα Αγγλικά). __ tomcat/webapps :

Παροχή 2.30.0, 706.939.130 bytes, MD5=CDC4B3D82A20B33A6623B85312F6DC21, με ημερομηνία 2026-04-06

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

Μερικές προηγούμενες εκδόσεις είναι επίσης διαθέσιμες.

  • 2.17 (551,068,245 bytes, MD5=5FEA912B5D42E50EAB9591F773EA848D, με ημερομηνία 2022-02-16)
  • 2.18 (551,069.844 bytes, MD5=461325E97E7577EC671D50246CCFB8B, με ημερομηνία 2022-02-23)
  • 2.21 (568.644.411 bytes, MD5=F2CFF805893146E932E498FDDBD519B6, με ημερομηνία 2022-10-09)
  • 2.22 (567,742,765 bytes, MD5=2B33354F633294213AE2AFDCF4DA6D0, με ημερομηνία 2022-12-08)
  • 2.23 (572,124,953 bytes, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, με ημερομηνία 2023-03-03)
  • 2.24 (568.748.187 bytes, MD5=970fbee172e28b0b8a07756eecbc898e, με ημερομηνία 2024-06-07)
  • 2.25 (592,292,039 bytes, MD5=652AFC9D1421F00B5F789DA2C4732D4C, με ημερομηνία 2024-11-07)
  • 2.26 (607,404,032 bytes, MD5=99a725108b37708e5420986c1616a119, με ημερομηνία 2025-03-31)
  • 2.27.0 (620,554,403 bytes, MD5=3b2086c659ee4145ca2dff447bf4ef7, με ημερομηνία 2025-06-11)
  • 2.28.1 (622.676,238 bytes, MD5=48b4226045f950c8a8d69ef9521b9bc9, με ημερομηνία 2025-09-05)
  • 2.29.0 (706.788.135 bytes, MD5=A5ED0DCC8D46CA27640FFEB8CE4A8560, με ημερομηνία 2025-12-15)

Configure διαμεσολαβητή (ειδική εγκατάσταση)​

ERDDAP™ είναι συνήθως αναπτυχθεί πίσω από ένα webserver αντίστροφη μεσολάβηση για να επιτρέψει να εξυπηρετείται σε τυποποιημένες θύρες HTTP (80 και 443) . Ο τερματισμός SSL/TLS συχνά διαχωρίζεται και στο επίπεδο μεσολάβησης webserver. Οι λεπτομέρειες εξαρτώνται από τις απαιτήσεις κάθε ανάπτυξης.

Απάτσι.​

  1. Διασφάλιση ότι mod_proxy και mod_proxy_ http φορτώνονται:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Τροποποίηση του υπάρχοντος <VirtualHost> ετικέτα (εάν υπάρχει) , ή να προσθέσετε ένα στο τέλος του αρχείου:
<VirtualHost *:80>
   ServerName YourDomain.org
   ProxyRequests Off
   ProxyPreserveHost On
   ProxyPass /erddap http://localhost:8080/erddap
   ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Εάν ERDDAP™ σερβίρεται σε άλλο μονοπάτι εκτός από /erddap , να ορίσουν επίσης το Προκαθορισμένο X κεφαλίδα στην Τμήμα διαδρομής πριν /erddap . Αυτή η ρύθμιση θα ήταν κατάλληλη για ERDDAP™ σερβίρεται στο /υποδιαδρομή/erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Στη συνέχεια, επανεκκινήστε Apache: /usr/sbin/apachectl -κ χαριτωμένα (Αλλά μερικές φορές είναι σε διαφορετικό κατάλογο) .  

ΝΓΚΙΝΧ​

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

proxy_set_header Host              $http_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;

Εάν ERDDAP™ σερβίρεται σε άλλο μονοπάτι εκτός από /erddap , να ορίσουν επίσης το Προκαθορισμένο X κεφαλίδα στην Τμήμα διαδρομής πριν /erddap . Αυτή η ρύθμιση θα ήταν κατάλληλη για ERDDAP™ σερβίρεται στο /υποδιαδρομή/erddap :

proxy_set_header X-Forwarded-Prefix /subpath

Για να πάρετε NGINX και ERDDAP™ εργασία σωστά με https , θα πρέπει να βάλετε το ακόλουθο snippet μέσα στο διακομιστή Tomcat.xml <Host> μπλοκ:

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

 

Έναρξη Tomcat​

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

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

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

Είναι ERDDAP™ Τρέχει;​

Χρήση περιηγητή για την προβολή http://www.YourServer.org/erddap/status.html.

ERDDAP™ ξεκινά χωρίς να φορτώνονται σύνολα δεδομένων. Τα σύνολα δεδομένων φορτώνονται σε ένα νήμα φόντου και έτσι γίνονται διαθέσιμα ένα προς ένα.

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

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

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

Εάν χρησιμοποιείτε μια έκδοση του Java Αυτό είναι πολύ παλιό για ERDDAP , ERDDAP™ δεν τρέχει και θα δείτε ένα μήνυμα σφάλματος στο αρχείο καταγραφής Tomcat όπως

Exception in thread "main" java.lang.UnsupportedClassVersionError:
_some/class/name_: Unsupported major.minor version _someNumber_

Η λύση είναι να ενημερώσετε την πιο πρόσφατη έκδοση του Java Και σιγουρέψου ότι το χρησιμοποιεί ο Τόμκατ.

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

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

Δεν υπάρχει λύση γι' αυτό. Έτσι λειτουργεί ο Τόμκατ. Αλλά συμβαίνει μόνο την πρώτη φορά αφού εγκαταστήσετε μια νέα έκδοση του ERDDAP™ .

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

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

Πρόβλημα;​

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

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

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

Προσαρμογή​

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