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

Εγκατάσταση

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

ERDDAP™ μπορεί να τρέξει σε οποιοδήποτε διακομιστή που υποστηρίζει Java και Tomcat (και άλλους διακομιστές εφαρμογών όπως ο Jetty, αλλά δεν τους υποστηρίζουμε) . ERDDAP™ έχει δοκιμαστεί σε Linux (Η LuxOpCo και η LuxOpCo υποστηρίζουν ότι η LuxOpCo δεν είναι σε θέση να αποδείξει ότι η LuxOpCo δεν είναι σε θέση να εκπληρώσει τις υποχρεώσεις της.) , 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 είναι μια χαρά για δοκιμή 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.19+, σετ Java 21. Για λόγους ασφαλείας, είναι σχεδόν πάντα καλύτερο να χρησιμοποιήσετε την τελευταία έκδοση του Java 21. Παρακαλώ κατεβάστε και εγκαταστήστε την τελευταία έκδοση του Το OpenJDK της Υιοθέτησης (Τεμουρίνη) 21 (LTS) . Για να επαληθεύσετε την εγκατάσταση, εκτελέστε /javaJreBinΚατάλογος/java -έκδοση , για παράδειγμα /usr/local/jdk-21.0.3+9/jre/bin/java -έκδοση .

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

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

Τομκάτ

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

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

  • Κατεβάστε το Tomcat και ξεπακετάρετε στον server ή τον υπολογιστή σας. Για λόγους ασφαλείας, είναι σχεδόν πάντα καλύτερο να χρησιμοποιήσετε την τελευταία έκδοση του Tomcat 10 (η έκδοση 9 και κάτω δεν είναι αποδεκτές) η οποία έχει σχεδιαστεί για να λειτουργεί με Java 21 ή νεότερη. Παρακάτω, ο κατάλογος 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;Connector="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/...]

 

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

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

Ασφάλεια

 

  • Σύσταση ασφάλειας: Βλέπεις; Αυτές οι οδηγίες να αυξήσει την ασφάλεια της εγκατάσταση Tomcat σας, ειδικά για δημόσιους servers.  
  • Για το κοινό ERDDAP™ εγκαταστάσεις σε Linux και Macs, είναι καλύτερο να συσταθεί Tomcat (το πρόγραμμα) ως ανήκει στον χρήστη τομκάτ (ξεχωριστό χρήστη με περιορισμένες άδειες και ο οποίος δεν έχει κωδικό πρόσβασης ) . Έτσι, μόνο ο υπερχρήστης μπορεί να ενεργοποιηθεί ως χρήστης τομκάτ . Αυτό καθιστά αδύνατη την είσοδο των χάκερ στον server σας ως χρήστη τομκάτ . Και σε κάθε περίπτωση, θα πρέπει να το κάνετε έτσι ώστε η τομκάτ Ο χρήστης έχει πολύ περιορισμένες άδειες στο σύστημα αρχείων του διακομιστή (διαβάστε+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 και Macs: Δημιουργία αρχείου tomcat/bin/setenv.sh (ή στο Red Hat Enterprise Linux \[ ΡΕΛ \] , επεξεργασία ~tomcat/conf/tomcat10.conf ) να ρυθμίσουν τις μεταβλητές περιβάλλοντος του Tomcat. Αυτό το αρχείο θα χρησιμοποιηθεί από tomcat/bin/startup.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

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

  • Στα Windows: Δημιουργία αρχείου tomcat\bin\\setenv.bat (στα Αγγλικά). να ρυθμίσουν τις μεταβλητές περιβάλλοντος του Tomcat. Αυτό το αρχείο θα χρησιμοποιηθεί από tomcat\bin\\έναρξη.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. (Εάν έχετε ορίσει προηγουμένως _ΑΠΟΤΕΛΕΣΜΑ Μπορείς να το αφαιρέσεις αυτό.)

Η -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 ΚΑΤΑΛΙΝΑ παράμετρος Σετένβ.μπατ. .
    • Με Java 21, διαλέγεις 64 bit Java όταν κατεβάζετε μια έκδοση του Java σημειώνονται "64 bit".".

Με 64 bit Java , Tomcat και Java μπορεί να χρησιμοποιήσει πολύ υψηλό -Xmx και -Xms. settings. Όσο πιο φυσική μνήμη στον διακομιστή τόσο το καλύτερο. Ως μια απλοϊκή πρόταση: σας συνιστούμε να ορίσετε -Xmx και -Xms. προς (στο 'M'egaBytes') έως 1/2 (ή λιγότερο) της φυσικής μνήμης του υπολογιστή. Μπορείτε να δείτε αν Tomcat, Java , και ERDDAP™ τρέχουν πράγματι σε λειτουργία 64 bit με την αναζήτηση για " bit," in ERDDAP Ημερήσιο μήνυμα αναφοράς ή 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, θα πρέπει να αλλάξετε τη γραμματοσειράΟικογένεια ρύθμιση στο setup.xml σε <fontFamily> Σαν Σερίφ </fontFamily> , το οποίο είναι διαθέσιμο σε όλους Java διανομές. Αν είστε έτοιμοι <fontFamily> στο όνομα μιας γραμματοσειράς που δεν είναι διαθέσιμη, ERDDAP™ δεν φορτώνει και θα εκτυπώσει μια λίστα των διαθέσιμων γραμματοσειρών στο log.txt Αρχείο. Πρέπει να χρησιμοποιήσεις μια από αυτές τις γραμματοσειρές.

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

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

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

Δοκιμή Tomcat

  • Δοκίμασε την εγκατάσταση Tomcat.
    • Linux:
      • Ως χρήστης "τόμκατ", τρέχει tomcat/bin/startup.sh .
      • Δείτε το URL σας + ":8080" in στον browser σας (π.χ., http://coastwatch.pfeg.noaa.gov:8080/ ) .
    • Μακ (εκτελέστε tomcat ως ο χρήστης συστήματος) :
      • Εκτέλεση tomcat/bin/startup.sh .
      • Δείτε το URL σας + ":8080" in στον 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/περιεχόμενο/erddap αρχεία ρυθμίσεων. Σε Linux, Mac και Windows, κατεβάστε erddapΠεριεχόμενο .zip και να το αποσυμπιέσει στο τομκάτ κατάλογος, δημιουργία tomcat/περιεχόμενο/erddap .

Έκδοση 1.0.0, 20333 bytes, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, με ημερομηνία 2024-10-14_

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

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

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

  • Κάνε το τομκάτ χρήστη του ιδιοκτήτη του bigParentΚατάλογος :
    chown -R tomcat bigParentDirectory
  • Αλλαγή της ομάδας" να είναι Tomcat, το όνομα χρήστη σας, ή το όνομα μιας μικρής ομάδας που περιλαμβάνει Tomcat και όλους τους διαχειριστές του Tomcat / ERDDAP :
    chgrp -R yourUserName bigParentDirectory
  • Αλλαγή αδειών ώστε ο Tomcat και η ομάδα να έχουν διαβάσει, γράψει, εκτελέσει δικαιώματα:
    chmod -R ug+rwx bigParentDirectory
  • Αφαίρεση " άλλων" αδειών χρήσης για ανάγνωση, εγγραφή ή εκτέλεση. Αυτό είναι σημαντικό για την πρόληψη της ανάγνωσης πιθανών ευαίσθητων πληροφοριών μέσα ERDDAP™ log αρχεία και αρχεία με πληροφορίες για ιδιωτικά σύνολα δεδομένων.
    chmod -R o-rwx bigParentDirectory

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

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

datasets.xml

  • Διαβάστε τα σχόλια Συνεργασία με το datasets.xml Αρχείο . Αργότερα, αφού πάρεις ERDDAP™ εκτέλεση για πρώτη φορά (συνήθως με μόνο τα προεπιλεγμένα σύνολα δεδομένων) , θα τροποποιήσετε το XML σε tomcat/περιεχόμενο/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.28.1, 622.676,238 bytes, MD5=48b4226045f950c8a8d69ef9521b9bc9, με ημερομηνία 2025-09-05

Το αρχείο .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)
  • 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)

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

Στο αρχείο ρυθμίσεων 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) τομκατ-μπιν\\ shutdown.bat

Σε Linux, χρήση Πs | γκρεπ τόμκατ πριν και μετά Κλείσιμο. Σσσ. για να βεβαιωθείτε ότι η διαδικασία 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 Αρχείο.
  • Το Tomcat δεν ξεκινάει. ERDDAP™ έως ότου Tomcat λάβει μια αίτηση για ERDDAP™ . Έτσι μπορείτε να δείτε στα αρχεία καταγραφής Tomcat αν αυτό ξεκίνησε ERDDAP™ ή εάν υπάρχει μήνυμα σφάλματος σχετικό με αυτή την προσπάθεια.
  • Πότε ERDDAP™ αρχίζει, μετονομάζει το παλιό ERDDAP™ αρχείο log.txt ( logArchivedAt <CurrentTime> .τχτ ) και δημιουργεί ένα νέο αρχείο καταγραφής.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 αρχείο) . Σε κάποιους 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> ετικέτα σας datasets.xml Αρχείο. (Εάν δεν υπάρχει, αντιγράψτε την προεπιλεγμένη από ERDDAP™ Σ tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml αρχείο σε datasets.xml και να το επεξεργαστείτε.) Για παράδειγμα, θα μπορούσατε:
    • Χρήση διαφορετικής εικόνας (Δηλαδή, το λογότυπο του οργανισμού σας) .
    • Αλλαγή χρώματος φόντου.
    • Αλλαγή " ERDDAP™ " στην οργάνωση σας ERDDAP™ "
    • Αλλαγή " Ευκολότερη πρόσβαση σε επιστημονικά δεδομένα" σε ευκολότερη πρόσβαση στα δεδομένα του YourOrganization
    • Αλλάξτε το "Brought σε σας από" συνδέσεις για να είναι συνδέσεις με την οργάνωσή σας και πηγές χρηματοδότησης.
  • Αλλαγή των πληροφοριών στην αριστερή πλευρά της αρχικής σελίδας με την επεξεργασία του <theShortDescriptionHtml> ετικέτα σας datasets.xml Αρχείο. (Εάν δεν υπάρχει, αντιγράψτε την προεπιλεγμένη από ERDDAP™ Σ tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml αρχείο σε datasets.xml και να το επεξεργαστείτε.) Για παράδειγμα, θα μπορούσατε:
    • Περιγράψτε τι κάνει η οργάνωση ή/και η ομάδα σας.
    • Περιγράψτε τι είδους δεδομένα είναι αυτά ERDDAP™ Έχει.
    • Για να αλλάξετε το εικονίδιο που εμφανίζεται στις καρτέλες του προγράμματος περιήγησης, τοποθετήστε το favicon του οργανισμού σας. ικό tomcat/περιεχόμενο/erddap/εικόνες/ . Βλέπεις;https://en.wikipedia.org/wiki/Favicon.