स्थापित करना
कैसे करने के लिए प्रारंभिक सेटअप ERDDAP™ अपने सर्वर पर
ERDDAP™ किसी भी सर्वर पर चलाया जा सकता है जो समर्थन करता है Java टॉमकैट (अन्य अनुप्रयोग सर्वर जैसे जेटी, लेकिन हम उन्हें समर्थन नहीं देते) । ERDDAP™ लिनक्स पर परीक्षण किया गया है (अमेज़ॅन के एडब्ल्यूएस पर भी शामिल है) मैक, मैक और विंडोज कंप्यूटर।
- डोकर -- हम प्रदान करते हैं ERDDAP™ एक डोकर कंटेनर मे ं IIOOS अब प्रदान करता है क्विक स्टार्ट गाइड ERDDAP™ एक डोकर कंटेनर में । यह मानक है ERDDAP™ स्थापना, एक डोकर कंटेनर में। डॉकर के माध्यम से Compose हम एसएसएल और निगरानी स्थापित करने के लिए आसान तरीके प्रदान करते हैं, बाहर में अधिक पढ़ें डॉकर प्रलेखन । यदि आप पहले से ही डोकर का उपयोग करते हैं, तो आप शायद डोकर संस्करण पसंद करेंगे। यदि आप क्लाउड सेवाओं पर चल रहे हैं तो आप शायद डॉकर संस्करण को पसंद करेंगे।
- अमेज़न -- यदि आप स्थापित कर रहे हैं ERDDAP™ एक अमेज़न वेब सर्विसेज EC2 उदाहरण पर, इसे देखें अमेज़न वेब सर्विसेज अवलोकन पहला।
- लिनक्स और मैक -- ERDDAP™ लिनक्स और मैक कंप्यूटर पर बहुत अच्छा काम करता है। नीचे दिए गए निर्देशों को देखें।
- विंडोज -- विंडोज परीक्षण के लिए ठीक है ERDDAP™ व्यक्तिगत उपयोग के लिए (नीचे दिए गए निर्देशों को देखें) , लेकिन हम सार्वजनिक रूप से इसका उपयोग करने की सलाह नहीं देते ERDDAP™ तैनाती। दौड़ना ERDDAP™ विंडोज पर समस्या हो सकती है: विशेष रूप से, ERDDAP™ जल्दी से फ़ाइलों को हटाने और / या नाम देने में असमर्थ हो सकता है। यह शायद एंटीवायरस सॉफ्टवेयर के कारण होता है (उदाहरण के लिए, McAfee और Norton से) जो वायरस के लिए फ़ाइलों की जांच कर रहा है। यदि आप इस समस्या में भाग लेते हैं (जिसे त्रुटि संदेश द्वारा देखा जा सकता है) लॉग-इन फाइल लाइक "हटने में असमर्थ ...", एंटीवायरस सॉफ़्टवेयर की सेटिंग को बदलने से समस्या को आंशिक रूप से कम किया जा सकता है। या इसके बजाय लिनक्स या मैक सर्वर का उपयोग करने पर विचार करें।
मानक ERDDAP™ लिनक्स, मैक और विंडोज कंप्यूटर के लिए स्थापना निर्देश हैं:
- सुनिश्चित करें कि कोई भी निर्भरता स्थापित की गई ह ै। गैर-विंडोज मशीनों पर (लिनक्स और मैक) , आपको csh की आवश्यकता है।
Java
-
के लिए ERDDAP™ v2.19+, सेट अप Java 21. सुरक्षा कारणों के लिए, नवीनतम संस्करण का उपयोग करना लगभग हमेशा सबसे अच्छा होता है Java 21. कृपया नवीनतम संस्करण को डाउनलोड और इंस्टॉल करें एडॉप्टियम का OpenJDK (टेमुरिन) 21 (एलटीएस) । स्थापना को सत्यापित करने के लिए, रन
/javaJreBinDirectory /java -version
उदाहरण के लिए/usr/local/jdk-21.0.3+9/jre/bin/java -version
।ERDDAP™ साथ काम करना Java अन्य स्रोतों से, लेकिन हम एडॉप्टियम की सलाह देते हैं क्योंकि यह मुख्य, सामुदायिक समर्थित है, मुक्त (जैसा कि बियर और भाषण में) का संस्करण Java 21 जो दीर्घकालिक समर्थन प्रदान करता है (प्रारंभिक रिलीज के कई वर्षों के लिए मुफ्त उन्नयन) । सुरक्षा कारणों के लिए कृपया अपना अद्यतन करें ERDDAP का संस्करण Java समय-समय पर नए संस्करणों के रूप में Java 21 अडॉप्टियम से उपलब्ध हो गए।
ERDDAP™ 21, अन्य संस्करणों के साथ बड़े पैमाने पर परीक्षण और उपयोग किया गया है। विभिन्न कारणों से, हम परीक्षण नहीं करते हैं और न ही अन्य संस्करणों का समर्थन करते हैं Java ।
टॉमकैट
- सेट अप टॉमकैट । टॉमकैट सबसे व्यापक रूप से इस्तेमाल किया जाता है Java अनुप्रयोग सर्वर जो है Java सॉफ्टवेयर जो ऑपरेटिंग सिस्टम की नेटवर्क सेवाओं और के बीच खड़ा है Java जैसे सर्वर सॉफ्टवेयर ERDDAP™ । यह मुफ्त और ओपन सोर्स सॉफ्टवेयर है (FOSS) ।
आप एक दूसरे का उपयोग कर सकते हैं Java अनुप्रयोग सर्वर (उदाहरण के लिए, जेटी) लेकिन हम केवल टॉमकैट के साथ परीक्षण और समर्थन करते हैं।
- टॉमकैट डाउनलोड करें औ र इसे अपने सर्वर या पीसी पर अनपैक करें।
सुरक्षा कारणों के लिए, टॉमकैट 10 के नवीनतम संस्करण का उपयोग करना लगभग हमेशा सबसे अच्छा होता है (संस्करण 9 और नीचे स्वीकार्य नहीं हैं)
जिसके साथ काम करने के लिए डिज़ाइन किया गया है Java 21 या नया। नीचे, टॉमकैट निर्देशिका के रूप में जाना जाएगा
tomcat
।
Warning! यदि आपके पास पहले से ही एक टॉमकैट है तो कुछ अन्य वेब एप्लिकेशन चल रहा है (विशेष रूप से THREDDS) , हम अनुशंसा करते हैं कि आप इंस्टॉल करें ERDDAP™ में एक दूसरा टॉमकैट क्योंकि ERDDAP™ विभिन्न टॉमकैट सेटिंग्स की जरूरत है और स्मृति के लिए अन्य अनुप्रयोगों के साथ संघर्ष नहीं करना चाहिए।
- लिनक्स पर "कोर" "tar" डाउनलोड करें .gz टॉमकैट वितरण और इसे खोलना।
हम अनुशंसा करते हैं कि यह उस पर पैक न करें
/usr/local
। - मैक पर, टॉमकैट शायद पहले से ही स्थापित है
Library/Tomcat
लेकिन इसे टॉमकैट 10 के नवीनतम संस्करण में अद्यतन करना चाहिए। अगर आप इसे डाउनलोड करते हैं, "कोर" "tar" डाउनलोड करें .gz टॉमकैट वितरण इसे खोलनाLibrary/Tomcat
। - विंडोज पर, आप कर सकते हैं "कोर" "zip" टॉमकैट वितरण डाउनलोड करें
(जो विंडोज रजिस्ट्री के साथ गड़बड़ नहीं करता है और जिसे आप डीओएस कमांड लाइन से नियंत्रित करते हैं) और इसे उचित निर्देशिका में अनपैक करें।
(विकास के लिए, हम "कोर" "zip" वितरण का उपयोग करते हैं। हम बनाना
कार्यक्रम
निर्देशिका और वहाँ इसे खोलना।) या आप "कोर" "64-bit Windows zip" वितरण डाउनलोड कर सकते हैं, जिसमें अधिक विशेषताएं शामिल हैं। यदि वितरण एक Windows इंस्टॉलर है, तो शायद इसे टॉमकैट डाल दिया जाएगा, उदाहरण के लिए,/प्रोग्राम फ़ाइलें/apache-tomcat-10.0.23
।
सर्वर xml
- सर्वर xml - में
Tomcat/conf/server.xml
फ़ाइल, वहाँ दो परिवर्तन है कि आप दो में से प्रत्येक के लिए करना चाहिए रहे हैं<Connector>
टैग (एक<कनेक्टर पोर्ट="8080"
और एक<Conector port="8443"
) ।- (अनुशंसित) वृद्धि
कनेक्शन टाइमआउट
पैरामीटर मान, शायद 300000 (मिलीसेकंड, जो 5 मिनट है) । - (अनुशंसित) एक नया पैरामीटर जोड़ें:
RelaxedQueryChars[] | "
। यह वैकल्पिक और थोड़ा कम सुरक्षित है, लेकिन उपयोगकर्ता के अनुरोध URL के मापदंडों में होने पर इन पात्रों को प्रतिशत-कोड करने की आवश्यकता को हटा देता है।
- (अनुशंसित) वृद्धि
सामग्री.xml
- संदर्भ.xml -- संसाधन कैश
tomcat/conf/context.xml
ठीक पहले</Context>
टैग, संसाधन टैग बदलें ( अगर यह पहले से ही नहीं है तो इसे जोड़ें) कैश सेट करना MaxSize पैरामीटर 80000:<Resources cachingAllowed="true" cacheMaxSize="80000" />
यह catalina में कई चेतावनी से बचा है। सभी के साथ शुरू
WARNING [main] org.apache.catalina.webresources.Cache.getResource Unable to add the resource at [/WEB-INF/classes/...]
अपाचे टाइमआउट
- लिनक्स कंप्यूटर पर, अपाचे टाइमआउट सेटिंग्स को बदल दें ताकि समय लेने वाले उपयोगकर्ता अनुरोध टाइमआउट नहीं करते
(अक्सर "Proxy" या "Bad Gateway" त्रुटि के रूप में दिखाई देता है) । मूल उपयोगकर्ता के रूप में:
- अपाचे को संशोधित करें
http d.conf
फ़ाइल (आमतौर परप्रमाणन http d/conf/
) :- मौजूदा परिवर्तन
<Timeout>
सेटिंग (या फ़ाइल के अंत में एक जोड़ें) 3600 (सेकंड) , डिफ़ॉल्ट 60 या 120 सेकंड के बजाय। - मौजूदा परिवर्तन
<ProxyTimeout>
सेटिंग (या फ़ाइल के अंत में एक जोड़ें) 3600 (सेकंड) , डिफ़ॉल्ट 60 या 120 सेकंड के बजाय।
- मौजूदा परिवर्तन
- अपाचे शुरू:
/usr/sbin/apachectl सुंदर
(लेकिन कभी-कभी यह एक अलग निर्देशिका में होता है) ।
- अपाचे को संशोधित करें
सुरक्षा
- सुरक्षा सिफारिश: देखें ये निर्देश सुरक्षा बढ़ाने के लिए विशेष रूप से सार्वजनिक सर्वरों के लिए आपका टॉमकैट इंस्टॉलेशन।
- जनता के लिए ERDDAP™ लि नक्स और मैक पर इंस्टॉलेशन, टॉमकैट स्थापित करना सबसे अच्छा है (कार्यक्रम) उपयोगकर्ता से संबंधित
tomcat
(सीमित अनुमतियों के साथ एक अलग उपयोगकर्ता और जो पासवर्ड नहीं है ) । इस प्रकार, केवल सुपर उपयोगकर्ता उपयोगकर्ता उपयोगकर्ता के रूप में कार्य करने के लिए स्विच कर सकते हैंtomcat
। यह हैकर्स के लिए उपयोगकर्ता के रूप में अपने सर्वर में लॉग इन करना असंभव बनाता हैtomcat
। और किसी भी मामले में, आपको ऐसा करना चाहिए ताकि आपको ऐसा करना पड़ेtomcat
उपयोगकर्ता सर्वर की फ़ाइल प्रणाली (read+write+execute विशेषाधिकार) पर बहुत सीमित अनुमति है के लिएअपाचे-tomcat
निर्देशिका पेड़ और<bigParentDirectory>
और केवल डेटा के साथ निर्देशिकाओं के लिए विशेषाधिकारों कि ERDDAP™ पहुँच की जरूरत है).- आप बना सकते हैं
tomcat
उपयोगकर्ता खाता (जो पासवर्ड नहीं है) आदेश का उपयोग करके:sudo useradd tomcat -s /bin/bash -p '*'
- आप उपयोगकर्ता के रूप में काम करने के लिए स्विच कर सकते हैं
tomcat
आदेश का उपयोग करके(यह आपको ऐसा करने की अनुमति के लिए सुपरयूज़र पासवर्ड के लिए पूछेगा।)sudo su - tomcat
- आप कमांड का उपयोग करके उपयोगकर्ता tomcat के रूप में काम करना बंद कर सकते हैं
exit
- टॉमकैट के बाकी हिस्सों में से अधिकांश और ERDDAP™ उपयोगकर्ता के रूप में सेटअप निर्देश
tomcat
। बाद में, रनस्टार्टअप.sh
औरबंद करना। sh
उपयोगकर्ता के रूप में स्क्रिप्टtomcat
ताकि टॉमकैट अपनी लॉग फ़ाइलों को लिखने की अनुमति दे। - टॉमकैट को अनपैक करने के बाद, माता-पिता से
अपाचे-tomcat
निर्देशिका:- apache-tomcat निर्देशिका पेड़ के स्वामित्व को tomcat उपयोगकर्ता में बदलें।
(लेकिन अपने tomcat निर्देशिका के वास्तविक नाम की जगह) ।
chown -R tomcat apache-tomcat-10.0.23
- 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
- apache-tomcat निर्देशिका पेड़ के स्वामित्व को tomcat उपयोगकर्ता में बदलें।
- आप बना सकते हैं
यह महत्वपूर्ण है क्योंकि यह अन्य उपयोगकर्ताओं को स ंभवतः संवेदनशील जानकारी पढ़ने से रोकता है ERDDAP™ सेटअप फ़ाइलों।
स्मृति
सेट टॉमकैट पर्यावरण चर
-
लिनक्स और मैक पर: एक फ़ाइल बनाएँ
Tomcat/bin/setenv.sh
(या Red Hat Enterprise Linux में \[ आरएचईएल \] संपादित करें~tomcat/conf/tomcat10.conf
) टॉमकैट के पर्यावरण चर सेट करने के लिए। इस फ़ाइल का उपयोग करके किया जाएगा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
, आप इसे हटा सकते हैं।) मैक पर, आपको शायद सेट करने की आवश्यकता नहीं हैJAVA_HOME
। -
विंडोज पर: एक फ़ाइल बनाएँ
tomcat \bin \\setenv.bat
टॉमकैट के पर्यावरण चर सेट करने के लिए। इस फ़ाइल का उपयोग करके किया जाएगा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
, आप इसे हटा सकते हैं।)
The The most of the -Xmx
और -Xms
स्मृति सेटिंग्स महत्वपूर्ण हैं क्योंकि ERDDAP™ अधिक स्मृति के साथ बेहतर काम करता है।
हमेशा सेट -Xms
समान मूल्य -Xmx
।
-
32 बिट ऑपरेटिंग सिस्टम और 32 बिट के लिए Java : 64 बिट Java 32 बिट से बेहतर है Java लेकिन 32 बिट Java जब तक सर्वर वास्तव में व्यस्त नहीं है तब तक काम करेगा। सर्वर में बेहतर भौतिक मेमोरी: 4 + जीबी वास्तव में अच्छा है, 2 जीबी ठीक है, कम अनुशंसित नहीं है। 32 बिट Java यहां तक कि प्रचुर मात्रा में भौतिक स्मृति, टॉमकैट और Java अगर आप सेट करने की कोशिश करते हैं तो नहीं चलेंगे
-Xmx
1500M से अधिक (कुछ कंप्यूटरों पर 1200M) । यदि आपके सर्वर में 2GB मेमोरी से कम है, तो कम करें-Xmx
मूल्य ('M'egaBytes) कंप्यूटर की भौतिक मेमोरी का 1/2। -
64 बिट ऑपरेटिंग सिस्टम और 64 बिट के लिए Java : 64 बिट Java केवल 64 बिट ऑपरेटिंग सिस्टम पर काम करेगा।
- साथ Java 8, आपको जोड़ने की आवश्यकता है
-d64
टॉमकैट मेंकैटालिना_OPTS
में पैरामीटरSetenv.bat
। - साथ Java 21, आप 64 बिट चुन सकते हैं Java जब आप एक संस्करण को डाउनलोड करते हैं Java चिह्नित "64 बिट"।
- साथ Java 8, आपको जोड़ने की आवश्यकता है
64 बिट के साथ Java टॉमकैट Java बहुत अधिक उपयोग कर सकते हैं -Xmx
और -Xms
सेटिंग्स। सर्वर में बेहतर भौतिक मेमोरी।
एक सरल सुझाव के रूप में: हम अनुशंसा करते हैं कि आप सेट करें -Xmx
और -Xms
to ('M'egaBytes) 1/2 (या कम) कंप्यूटर की भौतिक मेमोरी की।
आप देख सकते हैं कि क्या टॉमकैट, Java , और ERDDAP™ वास्तव में 64 बिट मोड में "बिट" की खोज करके चल रहे हैं। ERDDAP दैनिक रिपोर्ट ईमेल
या bigParentDirectory/logs/ [लॉग-इन](/docs/server-admin/additional-information#log)
फ़ाइल ( बड़ाParentDirectory
में निर्दिष्ट है साइटमैप ) ।
कचरा संग्रह
- में ERDDAP™ ' लॉग-इन फ़ाइल, आप कई देखेंगे "GC (आवंटन विफलता) " संदेश"
यह आमतौर पर एक समस्या नहीं है। यह एक सामान्य ऑपरेटिंग से लगातार संदेश है Java यह कहना कि यह सिर्फ एक मामूली कचरा समाप्त हो गया
संग्रह क्योंकि यह ईडन में कमरे से बाहर चला गया (अनुभाग Java बहुत युवा वस्तुओं के लिए ढेर) । आमतौर पर संदेश आपको दिखाता है
स्मृति UseBefore-> स्मृति उपयोग के बाद
। यदि उन दो संख्याओं को एक साथ बंद कर दिया जाता है तो इसका मतलब है कि कचरा संग्रह उत्पादक नहीं था। यदि यह बहुत बार होता है तो संदेश केवल परेशानी का संकेत है (कुछ सेकंड) , उत्पादक नहीं, और संख्या बड़ी है और नहीं बढ़ रही है, जो एक साथ इंगित करता है कि Java अधिक स्मृति की जरूरत है, स्मृति को मुक्त करने के लिए संघर्षरत है, और स्मृति को मुक्त करने में असमर्थ है। यह एक तनावपूर्ण समय के दौरान हो सकता है, फिर दूर हो सकता है। लेकिन अगर यह बनी रहती है, तो यह परेशानी का संकेत है। - यदि आप देखते हैं
java.lang.OutOfMemoryError
s in ERDDAP™ ' लॉग-इन फ़ाइल देखें OutOfMemoryError कैसे निदान और समस्याओं को हल करने के लिए सुझावों के लिए।
अनुमतियां
- लिनक्स और मैक पर, अनुमतियों को बदल दें सभी
* sh
फ़ाइलों मेंtomcat/bin/
मालिक द्वारा निष्पादन योग्य होना:
chmod +x *.sh