Увійти
Як зробити початковий набірERDDAP™на сер вері
ERDDAP™може працювати на будь-якому сервері, який підтримуєJavaі Томат (та інші сервери додатків, такі як Jetty, але ми не підтримуємо їх) йERDDAP™Тестовано на Linux (включаючи AWS Amazon) , Mac і Windows комп'ютери.
- Українська --- Якщо ви встановитеERDDAP™на сайті Amazon Web Services EC2 див. цеОгляд веб-сайтів Amazonперший.
- Докер --- Axiom тепер пропонуєERDDAP™в контейнері DockerIOOS тепер пропонуєШвидкий посібник для запускуERDDAP™в контейнері Dockerй Це стандартERDDAP™установка, але Axiom поставить його в докерну ємність. Якщо ви вже використовуєте Docker, ви напевно віддаєте перевагу версії Docker. Якщо ви вже не використовуєте Docker, ми зазвичай не рекомендуємо. Якщо Ви вибрали для установкиERDDAP™через Docker, ми не пропонуємо ніякої підтримки процесу установки. Ми ще не працювали з Docker. Будь ласка, зв'яжіться з нами
- Linux і Macs ---ERDDAP™працює на комп'ютерах Linux і Mac. Переглянути інструкції нижче.
- Головна --- Windows відмінно підходить для тестуванняERDDAP™і для особистого користування (Переглянути інструкції нижче) , але ми не рекомендуємо використовувати його для публічногоERDDAPй ЗапускERDDAP™на Windows може виникнути проблеми: необов'язково,ERDDAP™може бути не в змозі видалити і / або перейменувати файли швидко. Це, ймовірно, через антивірусне програмне забезпечення (Наприклад, з Макафе і Нортон) який перевіряє файли для вірусів. Якщо ви запустили цю проблему (які можна побачити повідомлення про помилки вJavaScript licenses API Веб-сайт Go1.13.8файл, як "Не вдалося видалити ...") Зміна параметрів антивірусного програмного забезпечення може частково полегшити проблему. Або розгляньте замість сервера Linux або Mac.
СтандартERDDAP™інструкції з монтажу для Linux, Macs та Windows комп'ютерів:
- Обов'язково встановлюються будь-які залежності. На невірусних машинах (Linux і Mac) , вам потрібно csh.
Java
-
ДляERDDAP™v2.19+, налаштуватиJava21. З причин безпеки, майже завжди краще використовувати останню версіюJava21. Будь ласка, завантажте та встановіть останню версію Адоптиум OpenJDK (Темурин) 21 мар (ЛТС) й Для перевірки установки типу "/javaJreBinDirectory/java -version", наприклад /usr/local/jdk-21.0.3+9/jre/bin/java -версія
ERDDAP™роботи зJavaз інших джерел, але ми рекомендуємо Adoptium, оскільки це основний, громадський супровід, безкоштовно (як у пивному та мовному виступі) версіяJava21 пропонує довгострокову підтримку (безкоштовні оновлення протягом багатьох років минулого випуску) й З причин безпеки, будь ласка, поновіть свійERDDAP's версіяJavaперіодично як нові версіїJava21 стає доступним з Адоптиуму.
ERDDAP™Випробувано і використовується в основному з 21, не іншими версіями. З різних причин ми не тестуємо за допомогою інших версійJavaй
Кошик
- Налаштування Кошикй Tomcat є найбільш поширенимJavaСервер додатків, якийJavaпрограмне забезпечення, яке стоїть між службами операційної системи таJavaсерверне програмне забезпеченняERDDAP™й Це безкоштовний і відкритий джерело програмного забезпечення (ФОСС) й
Ви можете використовувати іншийJavaСервер додатків (Наприклад, джинс) , але ми тільки тестуємо і підтримуємо Tomcat.
- Завантажте Tomcat і відпакуйте його на сервері або ПК. З причин безпеки, майже завжди краще використовувати останню версію Tomcat 10 (версія 9 і нижче не прийнятні) який призначений для роботи зJava21 або новий. Нижче наведено каталог Tomcat як tomcat.
Про нас Якщо у вас вже є Tomcat, яка працює на веб-додатку (особливо THREDDS) , ми рекомендуємо вам встановитиERDDAP™вдругий Tomcat, боERDDAP™потребує різних налаштувань Tomcat і не потрібно заплутуватися з іншими додатками для пам'яті.
- На Linuxзавантажити "Core" "tar".gz"Розширення томатів"і розпакуйте його. Ми рекомендуємо розпакувати його в /usr /local.
- На Mac Tomcat, ймовірно, вже встановлений в / Library / Tomcat, але слід оновити його до останньої версії Tomcat 10. Якщо завантажити його,завантажити "Core" "tar".gz"Розширення томатів"і розпакуйте його в / Лібрарі / Томкат.
- На Windows ви можетезавантажити "Core" "zip" Tomcat дистриб'ютор (що не означає реєстр Windows, і який ви контролюєте з командного рядка DOS) і розпакуйте його в відповідному каталозі. (Для розробки ми використовуємо "Core" "zip". Ми робимо каталог /програм і розпакуємо його там.) Або ви можете завантажити "Core" "64-bit Windows zip" дистрибуція, яка включає більше функцій. Якщо дистрибуція є інсталятором Windows, вона, ймовірно, поставить Tomcat, наприклад, /Програмні файли / папаш-tomcat-10.0.23 .
Сервер.xml
- Сервер.xml- У tomcat/conf/server.xml файл є два зміни, які слід зробити кожному з двох<Роз'єм і гт; теги- один для
<Connector port="8080"
і один
<Conector port="8443"
- (Рекомендовані) Збільшення значення параметра з'єднання, можливо, до 300000 (мілісекунди) (5 хвилин) й
- (Рекомендовані) Додати новий параметр: розслабленийQueryChars="\[\]|« » » » » » » » » » » » » » » Це необов'язково і дещо менш захищено, але виводить необхідність для користувачів до відсотків-коду цих символів, коли вони відбуваються в параметрах запиту користувача URL.
JavaScript licenses API Веб-сайт Go1.13.8
- JavaScript licenses API Веб-сайт Go1.13.8 Ресурси кешу - В tomcat/conf/context.xml, прямо перед тим</Context> тег, зміна тегів ресурсів (або додати його, якщо це вже немає) встановити кеш MaxSize параметр до 80000: <Ресурси кешуванняДозволено="true" cacheMaxSize="80000" /> Це дозволяє уникнути численних попереджень у каталіні. з того, що все починається з «Охорона\[Головна\]org.apache.catalina.webresources.Cache.getResource Неможливо додати ресурс в\[/ WEB-INF / Класи / ...]
Статус на сервери
- На комп'ютерах Linux змініть налаштування часу Apache, щоб часові запити користувачів не витрачали часу (з чим часто з'являється «Проксі» або «Bad Gateway» помилка) й Як користувач кореня:
- Змінення Apachehttpd.conf файл (зазвичай в /etc /httpдо/conf/) : Зміна існуючої<Налаштування та налаштування (або додати один в кінці файлу) до 3600 (час) , замість за замовчуванням 60 або 120 секунд. Зміна існуючої<ProxyTimeout> налаштування (або додати один в кінці файлу) до 3600 (час) , замість за замовчуванням 60 або 120 секунд.
- Статус на сервери -k витончений (але іноді це в іншому каталозі) й
- Рекомендації з безпеки: Про насці інструкціїзбільшити безпеку вашої установки Tomcat, особливо для публічних серверів.
- Для громадськостіERDDAP™Налаштування на Linux і Macs, краще налаштувати Tomcat (Програма) як приналежність до користувача "tomcat" (окремий користувач з обмеженими дозволаминемає пароля) й Таким чином, тільки супер-користувач може переключатися, щоб дійти від користувача. Це робить його неможливим для хакерів, щоб увійти в свій сервер, як користувач tomcat. І в будь-якому випадку, ви повинні зробити це таким чином, щоб користувач тормка мав дуже обмежені дозволи на файлову систему сервера (читати+write+execute привілеї для каталогу apache-tomcat і<bigParentDirectory> і чит-only привілеї для каталогів з даними, якіERDDAP™необхідний доступ.
-
Ви можете створити обліковий запис користувача tomcat (не має пароля) за допомогою команди sudo useradd tomcat -s /bin/bash -p "\* Р
-
Ви можете переключатися на роботу як користувацького томка за допомогою команди sudo su - tomcat (Вам запрошують пароль суперкористувацького пароля.)
-
Ви можете зупинити роботу як користувацький томатор за допомогою команди Увійти
-
До більшості решти Томата іERDDAP™інструкції налаштування як користувача "tomcat". Пізніше запустіть скрипти запуску.sh і вимкнути.sh, як користувач "tomcat", так що Tomcat має дозвіл на написання його файлів журналу.
-
Після розпакування Tomcat від батьківського каталогу apache-tomcat:
-
Зміна володіння каталогом apache-tomcat до користувача tomcat. Български, English, Українська... (але замініть фактичне ім'я вашого каталогу) й
-
Зміна "групи" для того, щоб бути томка, ім'я користувача або ім'я невеликої групи, яка включає в себе томка і всі адміністратори Tomcat/ERDDAP, наприклад, HYIP и SSL UserName_ apache-tomcat_10.0.23_
-
Змінити дозволи так, щоб tomcat і група читати, писати, виконувати привілеї, наприклад,. JavaScript licenses API Веб-сайт Go1.13.8
-
Видаліть "інші" дозволи користувачів читати, писати або виконувати: JavaScript licenses API Веб-сайт Go1.13.8 Це важливо, тому що вона запобігає іншим користувачам від читання, можливо, конфіденційної інформації вERDDAP™Налаштування файлів.
-
-
Навігація
- Настроювання Томата варіабельності
На Linux і Macs: Створити файл tomcat/bin/setenv.sh (або в Red Hat Enterprise Linux\[РХЕЛ\], редагування ~tomcat/conf/tomcat10.conf) для встановлення змінних середовища Tomcat. Цей файл буде використовуватися tomcat/bin/startup.sh і відключення.sh. Файл повинен містити щось схоже:
export JAVA\\_HOME=/usr/local/jdk-21.0.3+9
export JAVA\\_OPTS='-server -Djava.awt.headless=true -Xmx1500M -Xms1500M'
export TOMCAT\\_HOME=/usr/local/apache-tomcat-_10.0.23_
export CATALINA\\_HOME=/usr/local/apache-tomcat-_10.0.23_
(але замініть імена каталогів з вашого комп'ютера) й
(Якщо ви раніше встановили JRE\_HOME, ви можете видалити це.)
На Macs, ймовірно, не потрібно встановити JAVA\_HOME.
На Windows: Створіть файл tomcat\bin\setenv.bat для встановлення змін середовища Tomcat. Цей файл буде використовуватися tomcat\bin\startup.bat іshutdown.batй Файл повинен містити щось схоже:
SET "JAVA\\_HOME=\\_someDirectory_\\jdk-21.0.3+9"
SET "JAVA\\_OPTS=-server -Xmx1500M -Xms1500M"
SET "TOMCAT\\_HOME=\\Program Files\\apache-tomcat-_10.0.23_"
SET "CATALINA\\_HOME=\\Program Files\\apache-tomcat-_10.0.23_"
(але замініть імена каталогів з вашого комп'ютера) й Якщо це просто для місцевих випробувань, видаліть "сервер". (Якщо ви раніше встановили JRE\_HOME, ви можете видалити це.)
Налаштування пам'яті Xmx і -Xms є важливими, оскількиERDDAP™працює краще з пам'яттю. Завжди встановити -Xms до того ж значення, як -Xmx.
-
Для 32 біт опера ційних систем і 32 бітJava: 64 бітJavaнабагато краще 32 бітJava, але 32 бітJavaне дуже зайнятий сервер. Чим більше фізичного пам'яті в сервері краще: 4+ Гб дійсно хороший, 2 ГБ океї, менше не рекомендується. З 32 бітJava, навіть з рясною фізичною пам'яттю, Tomcat іJavaне запустіть, якщо ви намагаєтеся встановити -Xmx набагато вище 1500M (1200M на деяких комп'ютерах) й Якщо сервер має менше 2 Гб пам'яті, знижуйте значення -Xmx (в 'M'egaBytes) до 1/2 фізичної пам'яті комп'ютера.
-
Для 64 біт Операційні системи та 64 бітJava: 64 бітJavaпрацюватиме лише на 64 біт операційній системі.
- ЗJava8, вам потрібно додати \-d64 до параметра Tomcat CATALINA \_OPTS в setenv.bat
- ЗJava21 вибираємо 64 бітJavaколи ви завантажуєте версіюJavaпозначений "64 біт".
З 64 бітJavaТвитнутьJavaможе використовувати дуже високі -Xmx і -Xms настройки. Більша фізична пам'ять в сервері краще. Ми рекомендуємо вам встановити -Xmx і -Xms до (в 'M'egaBytes) до 1/2 (або менше) Фізична пам'ять комп'ютера. Ви можете побачити, якщо Tomcat,JavaйERDDAP™дійсно працює в режимі 64 біт, шукаючи " біт",ERDDAP's Щоденний звіт електронної пошти або в bigParentDirectory/logs/JavaScript licenses API Веб-сайт Go1.13.8Головна (bigParentDirectory вказаний вНалаштування.xml) й
Колекція Garbage
- УERDDAP™РJavaScript licenses API Веб-сайт Go1.13.8файл, ви побачите багато "GC (Розміщений отвір) « повідомлення». Це зазвичай не проблема. Це часте повідомлення від нормальної роботиJavaкажучи, що він просто закінчив незначний збір сміття, оскільки він виріс з кімнати в Едені (секція розділуJavaхап для дуже молодих предметів) й Зазвичай повідомлення ви memoryUseBefore\->memoryUseAfter. Якщо у двох числах закриті разом, значить, збір сміття не було продуктивним. Повідомлення є тільки ознакою неприємностей, якщо це дуже часто (кожні кілька секунд) , не продуктивні, а цифри великі і не зростаючі, які разом вказують на те, щоJavaпотребує більше пам'яті, що суперечить пам'яті, і не може звільнити пам'ять. Це може статися під час стресового часу, потім піти. Але якщо він псує, то це ознака неприємностей.
- Якщо ви бачите java.lang.OutOfMemoryError's вERDDAP™РJavaScript licenses API Веб-сайт Go1.13.8файл, дивОфМемориПоради щодо діагностики та вирішення проблем.
Дозвіли
- На Linux і Macs змініть дозволиВсі\*.shФайли в tomcat/bin/ для виконання власником, наприклад, з
chmod +x \\*.sh
Кошик
- Шрифти для зображень:Ми настійно віддаємо перевагу безкоштовноДеяВу шрифтидо іншоїJavaшрифти. За допомогою цих шрифтів дуже рекомендується, але не потрібно.
Якщо ви не можете використовувати шрифти DejaVu, вам потрібно змінити налаштування шрифту.xml<JavaScript licenses API Веб-сайт Go1.13.8</fontFamily>, який доступний з усімаJavaрозподіли. Якщо ви встановите шрифтСімейно на ім'я шрифту, який не доступний,ERDDAP™не завантажується і буде друкувати список доступних шрифтів у файлі log.txt. Ви повинні використовувати один з цих шрифтів.
Якщо ви вирішили використовувати шрифти DejaVu, будь ласка, переконайтеся, що налаштування fontFamily у налаштуваннях.xml<шрифт Family>ДеяВу Санс</fontFamily>
Щоб встановити шрифти DejaVu, будь ласка, завантажтеДеяВуФонтс.zip (5,522,795 байтів, MD5=33E1E61FAB06A547851ED308B4FFEFEF42) і розпакування файлів шрифтів до тимчасового каталогу.
- На Linux:
- Для Linux AdoptiumJavaрозподіли, див.ці інструкціїй
- З іншого бокуJavaрозподіли: Як користувач Tomcat копіювати файли шрифтів у _JAVA\HOME/lib/fonts такJavaможе знайти шрифти. Пам'ятайте: якщо / коли ви пізніше модернізуєте нову версіюJava, вам потрібно перевстановити ці шрифти.
- На Macs: для кожного файлу шрифту двічі натисніть на нього, а потім натисніть кнопку Встановити шрифт.
- На Windows 7 і 10: в Windows Explorer виберіть всі файли шрифтів. Клацніть правою кнопкою миші Натисніть на Встановити.
Тест Tomcat
- Тестування установки Tomcat.
-
Українська
- Як користувач "tomcat", запустити tomcat/bin/startup.sh
- Перегляд URL + ":8080/" у вашому браузері (Наприклад, http://coastwatch.pfeg.noaa.gov:8080/ ) й
- Ви повинні бачити сторінку Tomcat. Якщо є проблеми, див. файл Tomcat_/logs/catalina.out.
-
Мапа (запустити tomcat як адміністратор системи) :
- Килимок tomcat/bin/startup.sh
- Перегляд URL + ":8080/" у вашому браузері (Наприклад, http://coastwatch.pfeg.noaa.gov:8080/ ) й Зверніть увагу, що за замовчуванням, ваш Tomcat доступний тільки для вас. Недоступно.
- Ви повинні бачити сторінку Tomcat. Якщо є проблеми, див. файл Tomcat_/logs/catalina.out.
-
Windows localhost:
- Клацніть правою кнопкою миші на піктограму Tomcat в системному лотку, і виберіть "Почати послугу".
- Переглянути http://127.0.0.1:8080/ або, можливо, http://localhost:8080/ , у вашому браузері. Зверніть увагу, що за замовчуванням, ваш Tomcat доступний тільки для вас. Недоступно.
- Ви повинні бачити сторінку Tomcat. Якщо є проблеми, див. файл Tomcat_/logs/catalina.out.
-
Зубки з установкою Tomcat?
- На Linux і Mac, якщо ви не можете дістатися до Tomcat абоERDDAP™ (або, можливо, ви не можете дістатися до комп'ютера за межами вашого брандмауера) , ви можете перевірити, якщо Tomcat слухає порт 8080, набравши (як корінь) на командному рядку сервера:
netstat -tuplen | grep 8080
Щоб повернути один рядок з чимось схожим:
tcp 0 0 :::8080 :::\\* LISTEN ## ##### ####/java
(де '#' є деякі цифри) , що свідчить про те, що процес «Ява» (Томат) Прослуховування на порту "8080" для "tcp" трафіку. Якщо не повернулися лінії, якщо повернуто рядок, або якщо повернулися дві або більше рядків, то може бути проблема з налаштуванням порту.
- Переглянути файл Tomcat tomcat/logs/catalina.out. Проблеми Tomcat і деякіERDDAP™проблеми стартапів практично завжди вказані. Це поширено, коли ви спочатку налаштованіERDDAP™й
- ДивитисяКошикЯкщо ви хочете, щоб допомогти вам, будь ласка, зв'яжіться з нами
- Про насрозділ про отримання додаткової підтримкий
ERDDAP™Зміст
-
Налаштування_tomcat_/content/erddapналаштування файлів.
На Linux, Mac і Windows, скачатиерддапКонтент.zip (версія 1.0.0, 20333 байтів, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, від 2024-10-14) і розпакувати його в tomcat, створення_tomcat_/content/erddapй\[Деякі попередні версії також доступні: 2.17 (19792 байтів, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, від 2022-02-16)
2.18 р. (19792 байтів, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, від 2022-02-16)
2.21 (19810 байтів, MD5=1E26F62E7A06191EE686868C40B9A29362, від 2022-10-09)
2.22 км (19810 байтів, MD5=1E26F62E7A06191EE686868C40B9A29362, від 2022-12-08) 2.23 р. (1E26F62E7A06191EE6868C40B9A29362, від 2023-02-27) і розпакувати його в tomcat, створення_tomcat_/content/erddapй\]
Інші каталоги
Для Red Hat Enterprise Linux (РХЕЛ) або для інших ситуацій, де ви не можете змінити каталог Tomcat або де ви хочете / не ставитиERDDAP™каталог контенту в іншому місці для деяких інших причин (наприклад, якщо ви використовуєте Jetty замість Tomcat) , безконтактний erddapContent.zipв бажаний каталог (до якого тільки користувач=tomcat має доступ) і встановитиerddapContentDirectoryсистемне майно (Наприклад,erddapContentDirectory=~tomcat/content/erddap) доERDDAP™може знайти цей новий каталог контенту.
Налаштування.xml
- Читати коментарі_tomcat_/content/erddapУкраїнська Налаштування.xml і змусити запитані зміни. Налаштування.xml є файлом з усіма налаштуваннями, які вказують на те, як вашERDDAP™бджіл. Для початкової настройки ви MUST принаймні змініть ці налаштування:
<bigParentDirectory>, <emailEverythingTo>, <baseUrl>, <email.\\*>, <admin.\\*> (and <baseHttpsUrl> when you set up https).
Коли ви створюєте bigParentDirectory, з батьківського каталогу bigParentDirectory:
- Зробіть користувальницький=томатувати власника bigParentDirectory, наприклад,
chown -R tomcat _bigParentDirectory_
- Зміна "групи" для того, щоб бути томка, ім'я користувача або ім'я невеликої групи, яка включає в себе томка і всі адміністратор и Tomcat/ERDDAP, наприклад,
chgrp -R _yourUserName_ _bigParentDirectory_
- Змінити дозволи так, щоб tomcat і група читати, писати, виконувати привілеї, наприклад,.
chmod -R ug+rwx _bigParentDirectory_
- Видаліть "інші" дозволи користувачів читати, писати або виконувати. Це важливо для запобігання читання, можливо, конфіденційної інформації вERDDAP™Файли та файли з інформацією про приватні дані.:
chmod -R o-rwx _bigParentDirectory_