Przejdź do głównej treści

Instalacja

Jak zrobić wstępne ustawienie ERDDAP™ na serwerze

ERDDAP™ może działać na dowolnym serwerze, który obsługuje Java i Tomcat (i innych serwerów aplikacji takich jak Jetty, ale ich nie wspieramy) . ERDDAP™ został przetestowany na Linuksie (w tym na AWS Amazona) komputerów Mac i Windows.

  • Docker -- Zapewniamy ERDDAP™ w pojemniku Docker i IOOS oferuje teraz Szybki przewodnik startowy dla ERDDAP™ w kontenerze dokującym . Taki jest standard. ERDDAP™ instalacji, w pojemniku Docker. Przez Docker Komponowanie zapewniamy łatwe sposoby konfiguracji ssl i monitorowania, czytaj więcej na zewnątrz Dokumentacja dokująca . Jeśli już używasz Docker, prawdopodobnie wolisz wersję Docker. Jeśli chcesz uruchomić usługi w chmurze, prawdopodobnie wolisz wersję Docker.
  • Amazon -- W przypadku instalacji ERDDAP™ na przykładzie Amazon Web Services EC2, zobacz to Amazon Web Services Przegląd Najpierw.
  • Linux i Mac -- ERDDAP™ działa świetnie na komputerach Linux i Mac. Patrz instrukcja poniżej.
  • Okna -- Okna są dobre do testowania ERDDAP™ oraz do użytku osobistego (Zob. instrukcje poniżej.) , ale nie zalecamy używania go dla publiczności ERDDAP™ rozmieszczenia. Uruchomienie ERDDAP™ w systemie Windows mogą mieć problemy: w szczególności: ERDDAP™ może nie być w stanie szybko usunąć i / lub zmienić nazwy plików. To prawdopodobnie z powodu oprogramowania antywirusowego (np. z McAfee i Norton) czyli sprawdzanie plików pod kątem wirusów. Jeśli wpadniesz na ten problem (które mogą być widoczne przez komunikaty błędów w log.txt plik podobny "Nie można usunąć"...), zmiana ustawień oprogramowania antywirusowego może częściowo złagodzić problem. Albo rozważyć użycie serwera Linux lub Mac zamiast.

Norma ERDDAP™ instrukcje instalacji dla komputerów Linux, Mac i Windows to:

  1. Upewnij się, że wszystkie zależności są zainstalowane. Na maszynach innych niż Windows (Linux i Mac) Potrzebujesz CSH.

Java

  1. Dla ERDDAP™ v2.19 +, skonfigurowane Java 21. Ze względów bezpieczeństwa, prawie zawsze najlepiej jest użyć najnowszej wersji Java 21. Proszę pobrać i zainstalować najnowszą wersję OpenJDK Adoptium (Temuryna) 21 (LTS) . Aby zweryfikować instalację, uruchom / javaJreBinDirectory / java - wersja , na przykład / usr / local / jdk- 21.0.3 + 9 / jre / bin / java - wersja .

    ERDDAP™ z Java z innych źródeł, ale zalecamy Adoptium, ponieważ jest głównym, wspieranym przez społeczność, wolny (jak w piwie i mowie) wersja Java 21, który oferuje długoterminowe wsparcie (darmowe aktualizacje przez wiele lat po wydaniu początkowym) . Ze względów bezpieczeństwa, prosimy o aktualizację ERDDAP Wersja Java okresowo jako nowe wersje Java Lek Adoptium dostępny jest w postaci 21 tabletek.

    ERDDAP™ został przetestowany i szeroko stosowany z 21, a nie inne wersje. Z różnych powodów, nie testujemy z lub wspierać inne wersje Java .  

Tomcat

  1. Ustaw Tomcat . Tomcat jest najczęściej używane Java Serwer aplikacji, co jest Java oprogramowanie, które stoi pomiędzy usługami sieciowymi systemu operacyjnego i Java oprogramowanie serwera jak ERDDAP™ . To jest wolne i otwarte oprogramowanie źródłowe (FOSS) .

Możesz użyć innego. Java Serwer aplikacji (np. Jetty) Ale my tylko sprawdzamy i wspieramy Tomcata.

  • Pobierz Tomcat i rozpakuj go na serwerze lub komputerze. Ze względów bezpieczeństwa, prawie zawsze najlepiej jest użyć najnowszej wersji Tomcat 10 (Wersja 9 i poniżej są niedopuszczalne) który jest przeznaczony do pracy z Java 21 lub nowsze. Poniżej katalog Tomcat będzie określany jako tomcat .
  • Ostrzeżenie! Jeśli masz już Tomcat uruchomiony jakiś inny aplikacji internetowej (zwłaszcza TRREDDS) , zalecamy zainstalować ERDDAP™ w a drugi Tomcat , ponieważ ERDDAP™ potrzebuje różnych ustawień Tomcat i nie powinny mieć do czynienia z innymi aplikacjami pamięci.

    • Na Linuksie, Pobierz "Core" "tar .gz "Dystrybucja Tomcat i rozpakować. Zalecamy rozpakowanie go w / usr / local .
    • Na Mac, Tomcat jest prawdopodobnie już zainstalowany w / Biblioteka / Tomcat , ale powinien zaktualizować go do najnowszej wersji Tomcat 10. Jeśli go ściągniesz, Pobierz "Core" "tar .gz "Dystrybucja Tomcat i rozpakować go w / Biblioteka / Tomcat .
    • W systemie Windows możesz Pobierz dystrybucję "Core" "zip" Tomcat (który nie zadziera z rejestrem systemu Windows i który kontrolujesz z linii poleceń DOS) i rozpakować go w odpowiednim katalogu. (Dla rozwoju używamy dystrybucji "Core" "zip". Robimy / programy Katalog i rozpakować go tam.) Możesz też pobrać dystrybucję "Core" "64- bit Windows zip", która zawiera więcej funkcji. Jeśli dystrybucja jest instalatorem systemu Windows, to prawdopodobnie będzie umieścić Tomcat, na przykład, / Pliki programu / apache- tomcat- 10.0.23 .  

server.xml

  • server.xml - W tomcat / conf / server.xml plik, są dwie zmiany, które należy wprowadzić do każdego z dwóch <Connector> tagi (jeden dla &lt; Port połączeń = "8080" i jeden dla &lt; Port Conector = "8443" ) .
    1. (Zalecane) Zwiększenie połączenie Czas wartość parametru, być może do 300000 (milisekundy, czyli 5 minut) .
    2. (Zalecane) Dodaj nowy parametr: relaxedQueryChars = "[] | " . Jest to opcjonalne i nieco mniej bezpieczne, ale usuwa potrzebę dla użytkowników do zaszyfrowania tych znaków, gdy występują w parametrach URL żądania użytkownika.  

content.xml

  • context.xml -- Zasoby Cache - W tomcat / conf / context.xml , tuż przed </Context> tag, zmień znacznik Surowców (lub dodać go, jeśli nie jest jeszcze tam) do ustawienia pamięci podręcznej Parametr MaxSize do 80000:
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Unika to licznych ostrzeżeń w katalinie. że wszystko zaczyna się od

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

 

Czas Apache

  • Na komputerach Linuksa zmienić ustawienia czasu Apache tak, aby czasochłonne żądania użytkownika nie timeout (co często pojawia się jako błąd "Proxy" lub "Bad Gateway") . Jako użytkownik root:
    • Modyfikuj Apache http D.conf plik (zwykle w / etc / http d / conf / ) :
      • Zmiana istniejącego <Timeout> ustawienie (lub dodać jeden na końcu pliku) Do 3600 (sekund) , zamiast domyślnej 60 lub 120 sekund.
      • Zmiana istniejącego <ProxyTimeout> ustawienie (lub dodać jeden na końcu pliku) Do 3600 (sekund) , zamiast domyślnej 60 lub 120 sekund.
    • Przywróć Apache: / usr / sbin / apachectl -k graceful (ale czasami jest w innym katalogu) .

Bezpieczeństwo

 

  • Zalecenie bezpieczeństwa: Patrz instrukcje zwiększenie bezpieczeństwa Twoja instalacja Tomcat, szczególnie dla serwerów publicznych.  
  • Dla publiczności ERDDAP™ Instalacje na Linuksie i Macsie, najlepiej skonfigurować Tomcat (program) jako należące do użytkownika tomcat (oddzielnego użytkownika z ograniczonymi uprawnieniami i który nie ma hasła ) . Tak więc tylko super użytkownik może przejść do działania jako użytkownik tomcat . To uniemożliwia hakerom zalogowanie się na serwer jako użytkownik tomcat . I w każdym razie, należy zrobić tak, że tomcat użytkownik ma bardzo ograniczone uprawnienia w systemie plików serwera (odczyt + write + execute przywileje dla apache- tomcat drzewo katalogowe oraz <bigParentDirectory> i tylko read- przywileje dla katalogów z danymi, które ERDDAP™ wymaga dostępu do).
    • Możesz stworzyć tomcat konto użytkownika (który nie ma hasła) za pomocą polecenia:
      sudo useradd tomcat -s /bin/bash -p '*'
    • Możesz przejść do pracy jako użytkownik tomcat za pomocą polecenia
      sudo su - tomcat
      (Poprosi o hasło do superausera, aby uzyskać na to pozwolenie.)
      • Możesz przestać pracować jako tomcat użytkownika za pomocą polecenia
      exit
      • Zrób większość reszty Tomcat i ERDDAP™ instrukcje konfiguracji jako użytkownik tomcat . Później, uruchom startp.sh oraz wyłączenie. sh skrypty jako użytkownik tomcat tak, że Tomcat ma pozwolenie na pisanie do swoich plików dziennika.
      • Po rozpakowaniu Tomcat, od rodzica apache- tomcat katalog:
        • Zmień właściciela drzewa katalogowego apache- tomcat na użytkownika tomcat.
          chown -R tomcat apache-tomcat-10.0.23
          (ale zastąpić rzeczywistą nazwę katalogu tomcat) .
        • Zmień nazwę "grupy" na tomcat, nazwę użytkownika lub nazwę małej grupy, która zawiera Tomcat i wszystkich administratorów Tomcat / ERDDAP :
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Zmień uprawnienia tak, aby tomcat i grupa mieli odczyt, zapis, wykonanie uprawnień:
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Usuń "inne" uprawnienia użytkownika do odczytu, zapisu lub wykonania:
          chmod -R o-rwx apache-tomcat-10.0.23

Jest to ważne, ponieważ uniemożliwia innym użytkownikom odczytywanie potencjalnie wrażliwych informacji w ERDDAP™ konfiguracja plików.

Pamięć

Ustaw zmienne środowiska Tomcat

  • Na Linuksie i Makach: Utwórz plik tomcat / bin / setenv.sh (lub w Red Hat Enterprise Linux \[ RHEL \] , edit - tomcat / conf / tomcat10.conf ) aby ustawić zmienne środowiska Tomcat. Ten plik zostanie użyty przez Tomcat / bin / startup.sh oraz wyłączenie. sh . Plik powinien zawierać coś w rodzaju:

    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

    (ale podmień nazwy katalogów z komputera) . (Jeśli wcześniej ustawiono JRE _ HOME Możesz to usunąć.) Na Macs, prawdopodobnie nie trzeba ustawić JAVA _ HOME .

  • W systemie Windows: Utwórz plik tomcat\\ bin\\ setenv.bat aby ustawić zmienne środowiska Tomcat. Ten plik zostanie użyty przez tomcat\\ bin\\ startup.bat oraz shutdown.bat . Plik powinien zawierać coś w rodzaju:

    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"

    (ale podmień nazwy katalogów z komputera) . Jeśli jest tylko do lokalnych testów, usuń "-server". (Jeśli wcześniej ustawiono JRE _ HOME Możesz to usunąć.)

W - Xmx oraz - Xms ustawienia pamięci są ważne, ponieważ ERDDAP™ działa lepiej z większą pamięcią. Zawsze ustawiony - Xms do tej samej wartości co - Xmx .

  • Dla 32-bitowych systemów operacyjnych i 32-bitowych Java : 64 bity Java jest o wiele lepszy niż 32 bit Java , ale 32 bit Java będzie działać tak długo, jak serwer nie jest naprawdę zajęty. Im więcej fizycznej pamięci na serwerze, tym lepiej: 4 + GB jest naprawdę dobry, 2 GB jest w porządku, mniej nie jest zalecane. Z 32 bitami Java , nawet z obfitej pamięci fizycznej, Tomcat i Java nie ucieknie jeśli spróbujesz ustawić - Xmx znacznie powyżej 1500M (1200M na niektórych komputerach) . Jeśli Twój serwer ma mniej niż 2GB pamięci, zmniejszyć - Xmx wartość (in 'M' egaBytes) do 1 / 2 fizycznej pamięci komputera.

  • Dla 64-bitowych systemów operacyjnych i 64-bitowych Java : 64 bity Java działa tylko na 64-bitowym systemie operacyjnym.

    • Z Java 8, musisz dodać - d64 Tomcat CATALINA _ OPTS parametr w setenv.bat .
    • Z Java 21, wybierasz 64 bity Java po pobraniu wersji Java oznaczone "64 bit".

Z 64 bitami Java , Tomcat i Java może używać bardzo wysoki - Xmx oraz - Xms ustawienia. Im więcej fizycznej pamięci na serwerze, tym lepiej. Jako uproszczona sugestia: zalecamy ustawienie - Xmx oraz - Xms do (in 'M' egaBytes) do 1 / 2 (lub mniej) fizycznej pamięci komputera. Możesz zobaczyć, czy Tomcat, Java oraz ERDDAP™ rzeczywiście działają w trybie 64 bit przez wyszukiwanie "bit", w ERDDAP E-mail z dziennika lub bigParentDirectory / logi / [log.txt](/docs/server-admin/additional-information#log) plik ( bigParentDirectory jest określony w setup.xml ) .

Kolekcja śmieci

  • W ERDDAP™ jest log.txt plik, zobaczysz wiele "GC (Niepowodzenie przydziału) "wiadomości. Zazwyczaj nie jest to problem. Jest to częste przesłanie z normalnie działających Java mówiąc, że właśnie skończył drobne śmieci kolekcja, ponieważ zabrakło miejsca w Eden (Sekcja Java sterta dla bardzo młodych obiektów) . Zazwyczaj wiadomość pokazuje memoryUseBefore- &gt; memoryUseAfter . Jeśli te dwie liczby są blisko siebie, oznacza to, że zbiórka śmieci nie była produktywna. Wiadomość jest tylko oznaką kłopotów, jeśli jest bardzo często (co kilka sekund) , nieproduktywne, a liczby są duże i nie rośnie, które łącznie wskazują, że Java potrzebuje więcej pamięci, walczy o uwolnienie pamięci, i nie jest w stanie uwolnić pamięci. To może się zdarzyć w stresującym czasie, a następnie odejść. Ale jeśli trwa, to jest oznaką kłopotów.
  • Jeśli widzisz java.lang.OutOfMemoryError s ERDDAP™ jest log.txt plik, patrz Błąd OutOfMemoryError wskazówki dotyczące diagnozowania i rozwiązywania problemów.  

Uprawnienia

chmod +x *.sh

Czcionki

  • Czcionki obrazów: Zdecydowanie wolimy wolność. Czcionki DejaVu do innych Java czcionki. Korzystanie z tych czcionek jest zdecydowanie zalecane, ale nie jest wymagane.

Jeśli zdecydujesz się nie używać czcionek DejaVu, musisz zmienić ustawienia fontFamily w setup.xml na <fontFamily> SansSerif </fontFamily> , który jest dostępny ze wszystkimi Java dystrybucji. Jeśli ustawisz <fontFamily> do nazwy czcionki, która nie jest dostępna, ERDDAP™ nie załaduje i wydrukuje listę dostępnych czcionek w log.txt plik. Musisz użyć jednej z tych czcionek.

Jeśli zdecydujesz się użyć czcionek DejaVu, upewnij się, że <fontFamily> ustawienie w setup.xml <fontFamily> DejaVu Sans </fontFamily> .

Aby zainstalować czcionki DejaVu, pobierz DejaVuFonts .zip (5,522,795 bajtów, MD5 = 33E1E61FAB06A547851ED308B4FFEF42) i rozpakować pliki czcionek do tymczasowego katalogu.

  • W Linux:
    • Dla Adoptium Linuksa Java dystrybucje, patrz instrukcje .
    • Z innymi Java dystrybucje: Jako tomcat użytkownik, kopiuj pliki czcionek do $JAVA _ HOME / lib / fonts więc Java może znaleźć czcionki. Pamiętaj: jeśli / kiedy później uaktualnisz do nowszej wersji Java , musisz ponownie zainstalować te czcionki.
  • Na komputerach: dla każdego pliku czcionki kliknij dwukrotnie, a następnie zainstaluj czcionkę.
  • Na Windows 7 i 10: w Windows Explorer wybierz wszystkie pliki czcionek. Prawe kliknięcie. Kliknij na Install.  

Test Tomcat

  • Sprawdź instalację Tomcat.
    • Linux:
    • Mac (uruchom tomcat jako użytkownik administratora systemu) :
      • Biegnij Tomcat / bin / startup.sh .
      • Zobacz swój adres URL + ": 8080 /" w przeglądarce (np., http://coastwatch.pfeg.noaa.gov:8080/ ) . Pamiętaj, że domyślnie, Twój Tomcat jest dostępny tylko przez Ciebie. Nie jest on publicznie dostępny.
    • Windows localhost:
      • Kliknij prawym przyciskiem myszy na ikonę Tomcat w tacce systemowej i wybierz "Start service".
      • Widok http://127.0.0.1:8080/ albo może http://localhost:8080/ , w twojej przeglądarce. Pamiętaj, że domyślnie, Twój Tomcat jest dostępny tylko przez Ciebie. Nie jest on publicznie dostępny.

Powinieneś zobaczyć stronę Tomcat "Gratulacje".

Jeśli będą problemy, zobacz plik dziennika Tomcat na stronie tomcat / logi / katalina.out .

Kłopoty z instalacją Tomcata?

  • Na Linuksie i Mac, jeśli nie możesz dotrzeć do Tomcat lub ERDDAP™ (a może po prostu nie możesz do nich dotrzeć z komputera na zewnątrz zapory) , Możesz sprawdzić, czy Tomcat słucha portu 8080, wpisując (jako korzeń) na linii poleceń serwera:

    netstat -tuplen | grep 8080

To powinno zwrócić jedną linię z czymś takim:

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

(gdzie # jest jakąś cyfrą) , wskazując, że java proces (Prawdopodobnie Tomcat) Słucha w porcie "8080" dla ruchu "tcp". Jeśli nie zwrócono żadnych linii, jeśli linia jest znacznie inna, lub jeśli zwrócono dwie lub więcej linii, wtedy może być problem z ustawieniami portu.

  • Zobacz plik dziennika Tomcat tomcat / logi / katalina.out . Problemy z Tomcat i niektóre ERDDAP™ Problemy związane z startupem są tam niemal zawsze wskazywane. Jest to powszechne, gdy po raz pierwszy ustawiasz ERDDAP™ .

  • Patrz Tomcat strona internetowa lub wyszukać w sieci pomocy, ale proszę dać nam znać problemy i rozwiązania, które znalazłeś.

  • Zobacz rozdział dotyczący uzyskania dodatkowego wsparcia .  

ERDDAP™ Zawartość

  1. Ustaw tomcat / content / erddap pliki konfiguracyjne. Na Linuksie, Mac i Windows, pobierz erddapContent .zip i rozpiąć go do tomcat katalog, tworzenie tomcat / content / erddap .

_ _ Wersja 1.0.0, 20333 bajtów, MD5 = 2B8D2A5AE5ED73A42B529C168C60B5, datowany 2024- 10- 14 _ BAR _

Niektóre poprzednie wersje są również dostępne:

  • 2, 17 (19,792 bajtów, MD5 = 8F892616BAEEF2DF0F4BB036DCB4AD7C, datowany 2022- 02- 16)
  • 2, 18 (19,792 bajtów, MD5 = 8F892616BAEEF2DF0F4BB036DCB4AD7C, datowany 2022- 02- 16)
  • 2, 21 (19,810 bajtów, MD5 = 1E26F62E7A06191E0668C40B9A29362 z 2022- 10- 09)
  • 2, 22 (19,810 bajtów, MD5 = 1E26F62E7A06191E0668C40B9A29362 z 2022- 12- 08)
  • 2, 23 (19,810 bajtów, MD5 = 1E26F62E7A06191EE6868C40B9A29362, datowany na 2023- 02- 27)

Inny katalog

Dla Red Hat Enterprise Linux (RHEL) lub w innych sytuacjach, w których nie możesz modyfikować katalogu Tomcat lub gdzie chcesz / potrzebujesz umieścić ERDDAP™ katalog treści w innej lokalizacji z jakiegoś innego powodu (na przykład, jeśli używasz Jetty zamiast Tomcat) , rozpakuj erddapContent .zip do pożądanego katalogu (do którego tomcat użytkownik ma dostęp) i ustawić erddapContentDirectory właściwość systemu (np. erddapContentDirectory =~tomcat/content/erddap ) więc ERDDAP™ może znaleźć nowy katalog treści.

setup.xml

Dla początkowego ustawienia, MUSI przynajmniej zmienić te ustawienia:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> Ustawienia
  • <admin...> Ustawienia
  • <baseHttpsUrl> (Kiedy się ustawisz https )

Po utworzeniu bigParentDirectory, z katalogu nadrzędnego bigParentDirectory:

  • Zrobić tomcat użytkownik właściciela bigParentDirectory :
    chown -R tomcat bigParentDirectory
  • Zmień nazwę "grupy" na tomcat, nazwę użytkownika lub nazwę małej grupy, która zawiera Tomcat i wszystkich administratorów Tomcat / ERDDAP :
    chgrp -R yourUserName bigParentDirectory
  • Zmień uprawnienia tak, aby tomcat i grupa mieli odczyt, zapis, wykonanie uprawnień:
    chmod -R ug+rwx bigParentDirectory
  • Usuń "inne" uprawnienia użytkownika do odczytu, zapisu lub wykonania. Jest to ważne, aby zapobiec odczytywaniu potencjalnie wrażliwych informacji w ERDDAP™ logowanie plików i plików z informacjami o prywatnych zbiorach danych.
    chmod -R o-rwx bigParentDirectory

Zmienne środowiska

Począwszy od ERDDAP™ v2.13, ERDDAP™ administratorzy mogą nadpisać dowolną wartość w setup.xml poprzez podanie zmiennej środowiskowej Nazwa ERDDAP _ valueName przed uruchomieniem ERDDAP™ . Na przykład, używać ERDDAP _ baseUrl nad <baseUrl> wartość. To może być przydatne podczas rozmieszczania ERDDAP™ z pojemnikiem takim jak Docker, jak można umieścić standardowe ustawienia w setup.xml a następnie dostarczają specjalne ustawienia za pomocą zmiennych środowiskowych. Jeśli dostarczysz tajne informacje ERDDAP™ za pomocą tej metody, Upewnij się, że informacje pozostaną w tajemnicy. ERDDAP™ odczytuje zmienne środowiskowe tylko raz na startup, w pierwszej sekundzie startup, więc jednym ze sposobów użycia jest: ustawić zmienne środowiskowe, uruchomić ERDDAP , Poczekaj aż ERDDAP™ jest uruchomiony, a następnie wyłączyć zmienne środowiskowe.

datasets.xml

  • Przeczytaj komentarze w Praca z datasets.xml Plik . Później, jak już będziesz ERDDAP™ uruchomiony po raz pierwszy (zazwyczaj tylko z domyślnymi zbiorami danych) , będziesz modyfikować XML w tomcat / content / erddap / datasets.xml aby określić wszystkie zestawy danych, które chcesz ERDDAP™ służyć. Tutaj spędzisz większość swojego czasu. podczas ustawiania ERDDAP™ a później przy zachowaniu ERDDAP™ .

Możesz zobaczyć przykład datasets.xml w sprawie GitHub .  

  • (Nieprawdopodobne) Teraz lub (nieco bardziej prawdopodobne) w przyszłości, jeśli chcesz zmodyfikować plik CSS erddap, kopiuj tomcat / content / erddap / images / erddapStart2.css do tomcat / content / erddap / images / erddap2.css a potem wprowadzić zmiany. Zmiany erddap2.css stają się skuteczne tylko wtedy, gdy ERDDAP™ jest ponownie uruchomiony i często wymaga od użytkownika, aby wyczyścił pliki buforowane przeglądarki.   ERDDAP™ nie działa prawidłowo, jeśli setup.xml lub datasets.xml plik nie jest dobrze uformowanym plikiem XML. Po edycji tych plików, dobrym pomysłem jest sprawdzenie, czy wynik jest dobrze ukształtowany XML poprzez wklejanie tekstu XML do sprawdzania XML jak xmlalidation .  

Zainstaluj erddap. plik wojenny

  1. Na Linuksie, Mac i Windows, _ _ download erddap.war - Tak. tomcat / webapps :

_ _ Wersja 2.28.1, 622,676,238 bajtów, MD5 = 48b4226045f950c8a8d69ef9521b9bc9, dated 2025- 09- 05 _ _

Plik .war jest duży, ponieważ zawiera wysoką rozdzielczość linii brzegowej, granicy i danych elewacji potrzebnych do tworzenia map.

Niektóre poprzednie wersje są również dostępne.

  • 2, 17 (551,068,245 bajtów, MD5 = 5FEA912B5D42E50EAB9591F773EA848D, datowany 2022- 02- 16)
  • 2, 18 (551,069,844 bajtów, MD5 = 461325E97E7577EC671DD50246CCFB8B, datowany na 2022- 02- 23)
  • 2, 21 (568,644,411 bajtów, MD5 = F2CFF805893146E932E498FDDBD519B6, datowany na 2022- 10- 09)
  • 2, 22 (567,742,765 bajtów, MD5 = 2B33354F633294213AE2AFDDCF4DA6D0, datowany na 2022- 12- 08)
  • 2, 23 (572,124,953 bajtów, MD5 = D843A043C506725EBD6F8EFDCCA8FD5F z 2023- 03- 03)
  • 2, 24 (568,748,187 bajtów, MD5 = 970fbee172e28b0b8a07756eecbc898e, dated 2024- 06- 07)
  • 2, 25 (592,292,039 bajtów, MD5 = 652AFC9D1421F00B5F789DA2C4732D4C z 2024- 11- 07)
  • 2, 26 (607,404,032 bajtów, MD5 = 99a725108b37708e5420986c1616a119, datowany 2025- 03- 31)
  • 2, 27, 0 (620,554,403 bajtów, MD5 = 3b2086c659eee4145ca2dff447bf4ef7, datowany 2025- 06- 11)

Konfiguracja proxy (szczególne zastosowanie)

ERDDAP™ jest zazwyczaj stosowany za serwerem webserver reverse proxy, aby umożliwić jego obsługę w standardowych portach HTTP (80 i 443) . Rozwiązanie SSL / TLS jest często przekazywane także w warstwie proxy serwera webserver. Specyfikacje zależą od wymogów każdego rozmieszczania.

Apache

  1. Zapewnienie mod _ proxy oraz mod _ proxy _ http są załadowane:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Zmień istniejący <VirtualHost> tag (jeśli istnieje) lub dodać jeden na końcu pliku:
<VirtualHost *:80>
ServerName YourDomain.org
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /erddap http://localhost:8080/erddap
ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Jeśli ERDDAP™ jest obsługiwany na ścieżce innej niż / erddap , również ustawić X- Forwarded- Prefix nagłówek do Segment ścieżki _ przed _ / erddap . Ustawienie to byłoby właściwe dla ERDDAP™ podanie / subpath / erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Następnie ponownie uruchomić Apache: / usr / sbin / apachectl -k graceful (ale czasami jest w innym katalogu) .  

NGINX

W pliku konfiguracyjnym nginx ustaw nagłówki:

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;

Jeśli ERDDAP™ jest obsługiwany na ścieżce innej niż / erddap , również ustawić X- Forwarded- Prefix nagłówek do Segment ścieżki _ przed _ / erddap . Ustawienie to byłoby właściwe dla ERDDAP™ podanie / subpath / erddap :

proxy_set_header X-Forwarded-Prefix /subpath

W celu uzyskania NGINX i ERDDAP™ działa prawidłowo z https , należy umieścić następujący fragment wewnątrz Tomcat server.xml <Host> blok:

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

 

Uruchom Tomcat

  • (Nie polecam korzystania z Tomcat Web Application Manager. Jeśli nie wyłączysz i nie uruchomisz Tomcat, prędzej czy później będziesz miał problemy z pamięcią PermGen.)
  • (W systemie Linux lub Mac OS, jeśli stworzyłeś specjalnego użytkownika do uruchomienia Tomcat, np. tomcat, pamiętaj, aby wykonać następujące kroki jako ten użytkownik.)
  • Jeśli Tomcat już biegnie, zamknij Tomcat z (w systemie Linux lub Mac OS) tomcat / bin / shutdown.sh lub (w systemie Windows) tomcat\\ bin\\ shutdown.bat

Na Linuksie użyj p-ef | Grp tomcat przed i po wyłączenie. sh aby upewnić się, że proces tomcat przestał. Proces powinien być wymieniony przed zamknięciem i ostatecznie nie powinien być wymieniony po wyłączeniu. To może zająć minutę lub dwie ERDDAP™ do całkowitego zamknięcia. Cierpliwości. Albo jeśli wygląda na to, że sam się nie zatrzyma, użyj: zabić -9 <processID>

  • Uruchom Tomcat z (w systemie Linux lub Mac OS) Tomcat / bin / startup.sh lub (w systemie Windows) tomcat\\ bin\\ startup.bat

Czy ERDDAP™ Bieganie?

Użyj przeglądarki, aby spróbować wyświetlićhttp://www.YourServer.org/erddap/status.html. ERDDAP™ startuje bez wczytywanych zbiorów danych. Zestawy danych są wczytywane w tle i dlatego stają się dostępne jeden-by-jeden.

Rozwiązywanie problemów

  • Kiedy pojawia się prośba użytkownika, idzie do Apache (na komputerach Linux i Mac OS) A potem Tomcat. ERDDAP™ .
  • Możesz zobaczyć co przychodzi do Apaczów (i powiązane błędy) w plikach dziennika Apache.
  • Ty może zobaczyć, co przychodzi do Tomcat (i powiązane błędy) w plikach dziennika Tomcat ( tomcat / logi / katalina.out i inne pliki w tym katalogu) .
  • Ty może zobaczyć, co przychodzi do ERDDAP , wiadomości diagnostyczne z ERDDAP , i komunikaty błędów z ERDDAP , w ERDDAP™ <bigParentDirectory> / logs / log.txt plik.
  • Tomcat nie zaczyna ERDDAP™ dopóki Tomcat nie otrzyma wniosku o ERDDAP™ . Więc można zobaczyć w plikach Tomcat log, jeśli rozpoczęte ERDDAP™ lub jeżeli istnieje komunikat błędu związany z tą próbą.
  • Kiedy ERDDAP™ zaczyna się, zmienia nazwę starego ERDDAP™ plik log.txt ( logArchivedat <CurrentTime> .txt ) i tworzy nowy plik log.txt. Więc jeśli log.txt plik jest stary, to znak, że ERDDAP™ ostatnio nie zaczął od nowa. ERDDAP™ zapisuje informacje dziennika do bufora i tylko zapisuje bufor do pliku dziennika okresowo, ale można wymusić ERDDAP™ aby zapisać bufor do pliku dziennika przez odwiedzenie /erddap/status.html .

Problem: Stara wersja Java

Jeśli używasz wersji Java To za stare na ERDDAP , ERDDAP™ nie uruchomi i zobaczysz komunikat błędu w pliku dziennika Tomcat jak

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

Rozwiązaniem jest aktualizacja do najnowszej wersji Java i upewnić się, że Tomcat go używa.

Problem: Slow Startup Pierwszy raz

Tomcat musi zrobić dużo pracy za pierwszym razem aplikacji jak ERDDAP™ jest uruchomiony; w szczególności, musi rozpakować erddap.war plik (co jest jak .zip plik) . Na niektórych serwerach, pierwsza próba oglądania ERDDAP™ stragany (30 sekund?) Dopóki ta praca się nie skończy. Na innych serwerach pierwsza próba zakończy się natychmiast. Ale jeśli poczekasz 30 sekund i spróbujesz jeszcze raz, odniesie sukces, jeśli ERDDAP™ został prawidłowo zainstalowany.

Nie da się tego naprawić. Tak po prostu działa Tomcat. Ale pojawia się tylko po raz pierwszy po zainstalowaniu nowej wersji ERDDAP™ .

Wyłącz i uruchom ponownie

W przyszłości, zamknąć (i ponownie uruchomić) ERDDAP™ , see Jak zamknąć i ponownie Tomcat i ERDDAP .

Kłopoty?

Kłopoty z instalacją Tomcat lub ERDDAP™ ? Zobacz rozdział dotyczący uzyskania dodatkowego wsparcia .

Powiadomienie e-mail nowych wersji ERDDAP

Jeśli chcesz otrzymywać e-mail kiedy nowa wersja ERDDAP™ jest dostępny lub inne ważne ERDDAP™ ogłoszenia, możesz dołączyć do ERDDAP™ Lista ogłoszeń Tutaj . Ta lista zawiera średnio jeden e-mail co trzy miesiące.

Dostosuj

  • Dostosuj ERDDAP™ aby podkreślić swoją organizację (nie NOAA ERD ) .
  • Zmień baner, który pojawia się na górze wszystkich ERDDAP™ .html strony poprzez edycję <startBodyHtml5> tag in your datasets.xml plik. (Jeśli nie ma żadnego, skopiuj domyślny ERDDAP™ jest tomcat / webapps / erddap / WEB- INF / classes / gov / noaa / pfel / erddap / util / messages.xml plik do datasets.xml i edytować go.) Na przykład:
    • Użyj innego obrazu (np. logo Twojej organizacji) .
    • Zmień kolor tła.
    • Zmiana " ERDDAP™ "to" _ YourOrganization _ 's ERDDAP™ "
    • Zmień "łatwiejszy dostęp do danych naukowych" na "łatwiejszy dostęp do danych _ YourOrganization _ '".
    • Zmień odnośniki "Sprowadzony do Ciebie przez", aby być linki do organizacji i źródeł finansowania.
  • Zmiana informacji po lewej stronie strony głównej poprzez edycję <theShortDescriptionHtml> tag in your datasets.xml plik. (Jeśli nie ma żadnego, skopiuj domyślny ERDDAP™ jest tomcat / webapps / erddap / WEB- INF / classes / gov / noaa / pfel / erddap / util / messages.xml plik do datasets.xml i edytować go.) Na przykład:
    • Opisz, co robi twoja organizacja lub grupa.
    • Opisz jaki rodzaj danych to ERDDAP™ Tak.
    • Aby zmienić ikonę, która pojawia się na zakładkach przeglądarki, umieść favicon Twojej organizacji. ico in tomcat / content / erddap / images / . Patrzhttps://en.wikipedia.org/wiki/Favicon.