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:
- Upewnij się, że wszystkie zależności są zainstalowane. Na maszynach innych niż Windows (Linux i Mac) Potrzebujesz CSH.
Java
-
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
- 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
.
- Na Linuksie, Pobierz "Core" "tar .gz "Dystrybucja Tomcat i rozpakować.
Zalecamy rozpakowanie go w
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< Port połączeń = "8080"
i jeden dla< Port Conector = "8443"
) .- (Zalecane) Zwiększenie
połączenie Czas
wartość parametru, być może do 300000 (milisekundy, czyli 5 minut) . - (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.
- (Zalecane) Zwiększenie
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.
- Zmiana istniejącego
- Przywróć Apache:
/ usr / sbin / apachectl -k graceful
(ale czasami jest w innym katalogu) .
- Modyfikuj Apache
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żytkowniktomcat
. To uniemożliwia hakerom zalogowanie się na serwer jako użytkowniktomcat
. I w każdym razie, należy zrobić tak, żetomcat
użytkownik ma bardzo ograniczone uprawnienia w systemie plików serwera (odczyt + write + execute przywileje dlaapache- 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(Poprosi o hasło do superausera, aby uzyskać na to pozwolenie.)sudo su - tomcat
- 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, uruchomstartp.sh
orazwyłączenie. sh
skrypty jako użytkowniktomcat
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.
(ale zastąpić rzeczywistą nazwę katalogu tomcat) .
chown -R tomcat apache-tomcat-10.0.23
- 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
- Zmień właściciela drzewa katalogowego apache- tomcat na użytkownika tomcat.
- Możesz stworzyć
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 przezTomcat / bin / startup.sh
orazwyłą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 przeztomcat\\ bin\\ startup.bat
orazshutdown.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
TomcatCATALINA _ OPTS
parametr wsetenv.bat
. - Z Java 21, wybierasz 64 bity Java po pobraniu wersji Java oznaczone "64 bit".
- Z Java 8, musisz dodać
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- > 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
- Na Linuksie i Makach, zmień uprawnienia wszystkich
* .sh
pliki wTomcat / bin /
do wykonania przez właściciela:
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:
- Jako użytkownik "tomcat" uruchomić
Tomcat / bin / startup.sh
. - Zobacz swój adres URL + ": 8080 /" w przeglądarce (np., http://coastwatch.pfeg.noaa.gov:8080/ ) .
- Jako użytkownik "tomcat" uruchomić
- 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.
- Biegnij
- 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.
- Linux:
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ś.
ERDDAP™ Zawartość
- Ustaw
tomcat / content / erddap
pliki konfiguracyjne. Na Linuksie, Mac i Windows, pobierz erddapContent .zip i rozpiąć go dotomcat
katalog, tworzenietomcat / 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
- Przeczytaj komentarze w
tomcat / content / erddap / setup.xml
i wprowadzić wymagane zmiany. setup.xml jest plikiem ze wszystkimi ustawieniami, które określają jak Twój ERDDAP™ Zachowuje się.
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ścicielabigParentDirectory
: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
dotomcat / content / erddap / images / erddap2.css
a potem wprowadzić zmiany. Zmianyerddap2.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
- 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
- Zapewnienie
mod _ proxy
orazmod _ proxy _ http
są załadowane:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
- 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
- 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ślilog.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 yourdatasets.xml
plik. (Jeśli nie ma żadnego, skopiuj domyślny ERDDAP™ jesttomcat / webapps / erddap / WEB- INF / classes / gov / noaa / pfel / erddap / util / messages.xml
plik dodatasets.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 yourdatasets.xml
plik. (Jeśli nie ma żadnego, skopiuj domyślny ERDDAP™ jesttomcat / webapps / erddap / WEB- INF / classes / gov / noaa / pfel / erddap / util / messages.xml
plik dodatasets.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.