स्थापित करना

कैसे करने के लिए प्रारंभिक सेटअपERDDAP™अपने सर्वर पर

ERDDAP™किसी भी सर्वर पर चलाया जा सकता है जो समर्थन करता हैJavaटॉमकैट (अन्य अनुप्रयोग सर्वर जैसे जेटी, लेकिन हम उन्हें समर्थन नहीं देते) ।ERDDAP™लिनक्स पर परीक्षण किया गया है (अमेज़ॅन के एडब्ल्यूएस पर भी शामिल है) मैक, मैक और विंडोज कंप्यूटर।

अमेज़न -- यदि आप स्थापित कर रहे हैंERDDAP™एक अमेज़न वेब सर्विसेज EC2 उदाहरण पर, इसे देखेंअमेज़न वेब सर्विसेज अवलोकनपहला।
डोकर -- अब Axiom प्रदान करता हैERDDAP™एक डोकर कंटेनर मेंIIOOS अब प्रदान करता हैक्विक स्टार्ट गाइडERDDAP™एक डोकर कंटेनर में। यह मानक हैERDDAP™स्थापना, लेकिन Axiom इसे एक डॉकर कंटेनर में डाल दिया है। यदि आप पहले से ही डोकर का उपयोग करते हैं, तो आप शायद डोकर संस्करण पसंद करेंगे। यदि आप पहले से ही डॉकर का उपयोग नहीं करते हैं, तो हम आम तौर पर इसकी अनुशंसा नहीं करते हैं। यदि आप स्थापित करना चुनते हैंERDDAP™डॉकर के माध्यम से, हम स्थापना प्रक्रिया के लिए कोई समर्थन नहीं देते हैं। हमने अभी तक डोकर के साथ काम नहीं किया है। यदि आप इसके साथ काम करते हैं, तो कृपया हमें अपनी टिप्पणी भेजें।
लिनक्स और मैक --ERDDAP™लिनक्स और मैक कंप्यूटर पर बहुत अच्छा काम करता है। नीचे दिए गए निर्देशों को देखें।
विंडोज -- विंडोज परीक्षण के लिए ठीक हैERDDAP™व्यक्तिगत उपयोग के लिए (नीचे दिए गए निर्देशों को देखें) लेकिन हम सार्वजनिक रूप से इसका उपयोग करने की सलाह नहीं देतेERDDAPS. दौड़नाERDDAP™विंडोज पर समस्याएं हो सकती हैं: खासकर,ERDDAP™जल्दी से फ़ाइलों को हटाने और / या नाम देने में असमर्थ हो सकता है। यह शायद एंटीवायरस सॉफ्टवेयर के कारण होता है (उदाहरण के लिए, McAfee और Norton से) जो वायरस के लिए फ़ाइलों की जांच कर रहा है। यदि आप इस समस्या में भाग लेते हैं (जिसे त्रुटि संदेशों द्वारा देखा जा सकता हैलॉग-इनफ़ाइल की तरह "हटने में असमर्थ ...") एंटीवायरस सॉफ़्टवेयर की सेटिंग को बदलने से आंशिक रूप से समस्या को कम किया जा सकता है। या इसके बजाय लिनक्स या मैक सर्वर का उपयोग करने पर विचार करें।

मानकERDDAP™लिनक्स, मैक और विंडोज कंप्यूटर के लिए स्थापना निर्देश हैं:

सुनिश्चित करें कि कोई भी निर्भरता स्थापित की गई है। गैर-विंडोज मशीनों पर (लिनक्स और मैक) , आपको csh की आवश्यकता है।

Java

के लिएERDDAP™v2.19+, सेट अपJava21. सुरक्षा कारणों के लिए, नवीनतम संस्करण का उपयोग करना लगभग हमेशा सबसे अच्छा होता हैJava21. कृपया नवीनतम संस्करण को डाउनलोड और इंस्टॉल करें एडॉप्टियम का OpenJDK (टेमुरिन) 21 (एलटीएस) । स्थापना को सत्यापित करने के लिए, उदाहरण के लिए "/javaJreBinDirectory/java -version" टाइप करें। /usr/local/jdk-21.0.3+9/jre/bin/java -version

ERDDAP™साथ काम करनाJavaअन्य स्रोतों से, लेकिन हम एडॉप्टियम की सलाह देते हैं क्योंकि यह मुख्य, सामुदायिक समर्थित, मुफ्त है। (जैसा कि बियर और भाषण में) का संस्करणJava21 जो दीर्घकालिक समर्थन प्रदान करता है (प्रारंभिक रिलीज के कई वर्षों के लिए मुफ्त उन्नयन) । सुरक्षा कारणों के लिए कृपया अपना अद्यतन करेंERDDAPका संस्करणJavaसमय-समय पर नए संस्करणों के रूप मेंJava21 अडॉप्टियम से उपलब्ध हो गए।

ERDDAP™21, अन्य संस्करणों के साथ बड़े पैमाने पर परीक्षण और उपयोग किया गया है। विभिन्न कारणों से, हम परीक्षण नहीं करते हैं और न ही अन्य संस्करणों का समर्थन करते हैंJava।

टॉमकैट

सेट अप टॉमकैट। टॉमकैट सबसे व्यापक रूप से इस्तेमाल किया जाता हैJavaअनुप्रयोग सर्वर, जो हैJavaसॉफ्टवेयर जो ऑपरेटिंग सिस्टम की नेटवर्क सेवाओं और के बीच खड़ा हैJavaजैसे सर्वर सॉफ्टवेयरERDDAP™। यह मुफ्त और ओपन सोर्स सॉफ्टवेयर है (FOSS) ।

आप एक दूसरे का उपयोग कर सकते हैंJavaअनुप्रयोग सर्वर (उदाहरण के लिए, जेटी) लेकिन हम केवल टॉमकैट के साथ परीक्षण और समर्थन करते हैं।

टॉमकैट डाउनलोड करें और इसे अपने सर्वर या पीसी पर अनपैक करें। सुरक्षा कारणों के लिए, टॉमकैट 10 के नवीनतम संस्करण का उपयोग करना लगभग हमेशा सबसे अच्छा होता है (संस्करण 9 और नीचे स्वीकार्य नहीं हैं) जिसके साथ काम करने के लिए डिज़ाइन किया गया हैJava21 या नया। नीचे, टॉमकैट निर्देशिका को टोमकैट_ कहा जाएगा।

चेतावनी! यदि आपके पास पहले से ही एक टॉमकैट है तो कुछ अन्य वेब एप्लिकेशन चल रहा है (विशेष रूप से THREDDS) , हम अनुशंसा करते हैं कि आप इंस्टॉल करेंERDDAP™मेंएक दूसरा टॉमकैटक्योंकिERDDAP™विभिन्न टॉमकैट सेटिंग्स की आवश्यकता होती है और स्मृति के लिए अन्य अनुप्रयोगों के साथ संघर्ष नहीं करना चाहिए।

लिनक्स पर"कोर" "tar" डाउनलोड करें.gzटॉमकैट वितरणऔर इसे खोलना। हम इसे /usr/local में पैक करने की सलाह देते हैं।
मैक पर, टॉमक शायद पहले से ही / पुस्तकालय/Tomcat में स्थापित किया गया है, लेकिन इसे टॉमकैट 10 के नवीनतम संस्करण में अपडेट करना चाहिए। अगर आप इसे डाउनलोड करते हैं,"कोर" "tar" डाउनलोड करें.gzटॉमकैट वितरणऔर इसे / पुस्तकालय/Tomcat में अनपैक करें।
विंडोज पर, आप कर सकते हैं"कोर" "zip" टॉमकैट वितरण डाउनलोड करें (जो विंडोज रजिस्ट्री के साथ गड़बड़ नहीं करता है और जिसे आप डीओएस कमांड लाइन से नियंत्रित करते हैं) और इसे उचित निर्देशिका में अनपैक करें। (विकास के लिए, हम "कोर" "zip" वितरण का उपयोग करते हैं। हम एक / प्रोग्राम डायरेक्टरी बनाते हैं और इसे वहाँ अनपैक करते हैं।) या आप "कोर" "64-bit Windows zip" वितरण डाउनलोड कर सकते हैं, जिसमें अधिक विशेषताएं शामिल हैं। यदि वितरण एक Windows installer है, तो यह संभवतः टॉमकैट को डाल देगा, उदाहरण के लिए, /प्रोग्राम फ़ाइलें / अपाचे-tomcat-10.0.23।

सर्वर xml

सर्वर xml- में tomcat/conf/server.xml फ़ाइल, वहाँ दो परिवर्तन है कि आप दो में से प्रत्येक के लिए करना चाहिए कर रहे हैं<कनेक्टर> टैग-एक के लिए

        <Connector port="8080"

और एक

        <Conector port="8443"

(अनुशंसित) कनेक्शन टाइमआउट पैरामीटर मान में वृद्धि, शायद 300000 (मिलीसेकंड) (5 मिनट) ।
(अनुशंसित) एक नया पैरामीटर जोड़ें: RelaxedQueryChars="\[\]|" यह वैकल्पिक और थोड़ा कम सुरक्षित है, लेकिन उपयोगकर्ता के अनुरोध URL के मापदंडों में होने पर इन पात्रों को प्रतिशत-कोड करने की आवश्यकता को हटा देता है।

सामग्री.xml

xml संसाधन कैश - In tomcat/conf/context.xml, ठीक पहले</Context> टैग, संसाधन टैग बदलें (अगर यह पहले से ही नहीं है तो इसे जोड़ें) कैश सेट करना MaxSize पैरामीटर 80000: <संसाधन cachingAllowed="true" कैशमैक्स आकार="80000" /> यह catalina में कई चेतावनी से बचा है। सभी के साथ शुरू "WARNING"\[मुख्य\]Org.apache.catalina.webresources.Cache.getResource संसाधन जोड़ने में असमर्थ\[E-Mail _ साइटमैप

अपाचे टाइमआउट

लिनक्स कंप्यूटर पर, अपाचे टाइमआउट सेटिंग्स को बदल दें ताकि समय लेने वाले उपयोगकर्ता अनुरोध टाइमआउट नहीं करते (अक्सर "Proxy" या "Bad Gateway" त्रुटि के रूप में दिखाई देता है) । मूल उपयोगकर्ता के रूप में:
1. अपाचे को संशोधित करेंhttpd.conf file (आमतौर पर /etc/ मेंhttpd/conf/) : मौजूदा परिवर्तन<टाइमआउट & gt; सेटिंग (या फ़ाइल के अंत में एक जोड़ें) 3600 (सेकंड) , डिफ़ॉल्ट 60 या 120 सेकंड के बजाय। मौजूदा परिवर्तन<ProxyTimeout> सेटिंग (या फ़ाइल के अंत में एक जोड़ें) 3600 (सेकंड) , डिफ़ॉल्ट 60 या 120 सेकंड के बजाय।
2. Restart Apache: /usr/sbin/apachectl सुंदर (लेकिन कभी-कभी यह एक अलग निर्देशिका में होता है) ।
- सुरक्षा सिफारिश: देखेंये निर्देशविशेष रूप से सार्वजनिक सर्वरों के लिए, अपने टॉमकैट इंस्टॉलेशन की सुरक्षा को बढ़ाने के लिए।
- जनता के लिएERDDAP™लिनक्स और मैक पर इंस्टॉलेशन, टॉमकैट स्थापित करना सबसे अच्छा है (कार्यक्रम) उपयोगकर्ता "tomcat" से संबंधित (सीमित अनुमतियों के साथ एक अलग उपयोगकर्ता और जोपासवर्ड नहीं है) । इस प्रकार, केवल सुपर उपयोगकर्ता उपयोगकर्ता उपयोगकर्ता tomcat के रूप में कार्य करने के लिए स्विच कर सकते हैं। इससे हैकर्स को अपने सर्वर को यूज़र टोमैट के रूप में लॉग इन करना असंभव हो जाता है। और किसी भी मामले में, आपको ऐसा करना चाहिए ताकि टॉमकैट उपयोगकर्ता को सर्वर की फ़ाइल सिस्टम पर बहुत सीमित अनुमतियां हो (read+write+execute विशेषाधिकार) अपाचे-टोमकैट निर्देशिका पेड़ के लिए और<BigParentDirectory> और केवल डेटा के साथ निर्देशिकाओं के लिए विशेषाधिकारों कि पढ़ने के लिएERDDAP™पहुँच की जरूरत है).
  - आप tomcat उपयोगकर्ता खाता बना सकते हैं (जो पासवर्ड नहीं है) आदेश का उपयोग करके sudo useradd tomcat -s /bin/bash -p '\* '
  - आप कमांड का उपयोग करके उपयोगकर्ता tomcat के रूप में काम करने के लिए स्विच कर सकते हैं sudo - tomcat (यह आपको ऐसा करने की अनुमति के लिए सुपरयूज़र पासवर्ड के लिए पूछेगा।)
  - आप कमांड का उपयोग करके उपयोगकर्ता tomcat के रूप में काम करना बंद कर सकते हैं निकास
  - टॉमकैट के बाकी हिस्सों में से अधिकांश औरERDDAP™उपयोगकर्ता "tomcat" के रूप में सेटअप निर्देश। बाद में, उपयोगकर्ता "tomcat" के रूप में स्टार्टअप.sh और शटडाउन.sh स्क्रिप्ट चलाएं ताकि टॉमकैट अपनी लॉग फ़ाइलों को लिखने की अनुमति दे।
  - Apache-tomcat निर्देशिका के माता-पिता से टॉमकैट को अनपैक करने के बाद:
    - apache-tomcat निर्देशिका पेड़ के स्वामित्व को tomcat उपयोगकर्ता में बदलें। chown -R tomcat अपाचे-tomcat-10.0.23 (लेकिन अपने tomcat निर्देशिका के वास्तविक नाम की जगह) ।
    - Tomcat करने के लिए "समूह" बदलें, आपका उपयोगकर्ता नाम, या एक छोटे समूह का नाम जिसमें टॉमकैट और टॉमकैट के सभी प्रशासक शामिल हैं।ERDDAP, उदाहरण के लिए, chgrp उपयोगकर्ता नाम _ अपाचे-tomcat-10.0.23
    - अनुमतियां बदलें ताकि tomcat और समूह ने विशेषाधिकारों को पढ़ा, लिखना, निष्पादित करना, उदाहरण के लिए। chmod -R ug+rwx अपाचे-tomcat-10.0.23
    - "अन्य" उपयोगकर्ता की अनुमति को पढ़ने, लिखने या निष्पादित करने के लिए निकालें: chmod -R o-rwx अपाचे-tomcat-10.0.23 यह महत्वपूर्ण है क्योंकि यह अन्य उपयोगकर्ताओं को संभवतः संवेदनशील जानकारी पढ़ने से रोकता है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 सेट करते हैं, तो आप इसे हटा सकते हैं।)

-Xmx और -Xms मेमोरी सेटिंग्स महत्वपूर्ण हैं क्योंकिERDDAP™अधिक स्मृति के साथ बेहतर काम करता है। हमेशा -Xms को समान मूल्य के रूप में सेट करें -Xmx।

32 बिट ऑपरेटिंग सिस्टम और 32 बिट के लिएJava: 64 बिटJava32 बिट से बेहतर हैJavaलेकिन 32 बिटJavaजब तक सर्वर वास्तव में व्यस्त नहीं है तब तक काम करेगा। सर्वर में बेहतर भौतिक मेमोरी: 4 + जीबी वास्तव में अच्छा है, 2 जीबी ठीक है, कम अनुशंसित नहीं है। 32 बिटJavaयहां तक कि प्रचुर मात्रा में भौतिक स्मृति, टॉमकैट औरJavaयदि आप 1500M से अधिक -Xmx सेट करने की कोशिश करते हैं तो नहीं चलेगा (कुछ कंप्यूटरों पर 1200M) । यदि आपके सर्वर में 2GB से कम मेमोरी है, तो -Xmx मान को कम करें ('M'egaBytes) कंप्यूटर की भौतिक मेमोरी का 1/2।
64 बिट ऑपरेटिंग सिस्टम और 64 बिट के लिएJava: 64 बिटJavaकेवल 64 बिट ऑपरेटिंग सिस्टम पर काम करेगा।
- साथJava8, आपको सेटएनवी.बेट में टॉमकैट CATALINA \_OPTS पैरामीटर में \-d64 जोड़ने की आवश्यकता है।
- साथJava21, आप 64 बिट चुन सकते हैंJavaजब आप एक संस्करण को डाउनलोड करते हैंJavaचिह्नित "64 बिट"।

64 बिट के साथJavaटॉमकैटJavaबहुत उच्च-Xmx और -Xms सेटिंग्स का उपयोग कर सकते हैं। सर्वर में बेहतर भौतिक मेमोरी। एक सरल सुझाव के रूप में: हम अनुशंसा करते हैं कि आप -Xmx और -Xms सेट करें ('M'egaBytes) 1/2 (या कम) कंप्यूटर की भौतिक मेमोरी की। आप देख सकते हैं कि क्या टॉमकैट,Java, औरERDDAP™वास्तव में 64 बिट मोड में "बिट" की खोज करके चल रहे हैं।ERDDAP's Daily Report email or in bigParentDirectory/logs/लॉग-इनफ़ाइल (bigParentDirectory में निर्दिष्ट हैसाइटमैप) ।

कचरा संग्रह

मेंERDDAP™'लॉग-इनफ़ाइल, आप कई देखेंगे "GC (आवंटन विफलता) " संदेश" यह आमतौर पर एक समस्या नहीं है। यह एक सामान्य ऑपरेटिंग से लगातार संदेश हैJavaयह कहना कि यह सिर्फ एक मामूली कचरा संग्रह समाप्त हो गया क्योंकि यह ईडन में कमरे से बाहर चला गया (अनुभागJavaबहुत युवा वस्तुओं के लिए ढेर) । आमतौर पर संदेश आपको दिखाता है memoryUseBefore\->memoryUse After यदि उन दो संख्याओं को एक साथ बंद कर दिया जाता है तो इसका मतलब है कि कचरा संग्रह उत्पादक नहीं था। यदि यह बहुत बार होता है तो संदेश केवल परेशानी का संकेत है (कुछ सेकंड) , उत्पादक नहीं, और संख्या बड़ी है और नहीं बढ़ रही है, जो एक साथ संकेत मिलता है किJavaअधिक स्मृति की जरूरत है, स्मृति को मुक्त करने के लिए संघर्षरत है, और स्मृति को मुक्त करने में असमर्थ है। यह एक तनावपूर्ण समय के दौरान हो सकता है, फिर दूर हो सकता है। लेकिन अगर यह बनी रहती है, तो यह परेशानी का संकेत है।
यदि आप java.lang.OutOfMemoryError में देखते हैंERDDAP™'लॉग-इनफ़ाइल देखेंOutOfMemoryErrorकैसे निदान और समस्याओं को हल करने के लिए सुझावों के लिए।

अनुमतियां

लिनक्स और मैक पर, अनुमतियों को बदल देंसभी\*.shमें फाइलें tomcat/bin/ मालिक द्वारा निष्पादन योग्य, उदाहरण के लिए, साथ में

    chmod +x \\*.sh

फ़ॉन्ट्स

छवियों के लिए फ़ॉन्ट्स:हम दृढ़ता से मुक्त पसंद करते हैंDejavu fontsअन्यJavaफ़ॉन्ट्स। इन फोंटों का उपयोग दृढ़ता से अनुशंसा की जाती है लेकिन आवश्यकता नहीं है।

यदि आप DejaVu फोंट का उपयोग नहीं करते हैं, तो आपको सेटअप.xml में फ़ॉन्टपरिवार सेटिंग को बदलने की आवश्यकता है।<फ़ॉन्टपरिवार>SansSerif</ फ़ॉन्टपरिवार> जो सभी के साथ उपलब्ध हैJavaवितरण। यदि आप फ़ॉन्टपरिवार को एक फ़ॉन्ट के नाम पर सेट करते हैं जो उपलब्ध नहीं है, तोERDDAP™लॉग.txt फ़ाइल में उपलब्ध फ़ॉन्ट्स की एक सूची को लोड नहीं करेगा और प्रिंट करेगा। आपको उन फ़ॉन्ट्स में से एक का उपयोग करना चाहिए।

यदि आप DejaVu फ़ॉन्ट्स का उपयोग करना चुनते हैं, तो कृपया सुनिश्चित करें कि सेटअप में फ़ॉन्टपरिवार सेटिंग.xml है<फ़ॉन्ट परिवार & gt; Dejavu Sans</ फ़ॉन्टपरिवार>

DejaVu fonts स्थापित करने के लिए कृपया डाउनलोड करेंDejaVuFonts.zip (5,522,795 बाइट्स, MD5=33E1E61FAB06A547851ED308B4FFEF42) और एक अस्थायी निर्देशिका के लिए फ़ॉन्ट फ़ाइलों को खोलना।

लिनक्स पर:
- लिनक्स एडॉप्टियमJavaवितरण, देखेंये निर्देश।
- अन्यJavaवितरण: टॉमकैट उपयोगकर्ता के रूप में, फ़ॉन्ट फ़ाइलों को _JAVA \HOME/lib/fonts में कॉपी करें।Javaफ़ॉन्ट्स पा सकते हैं। याद रखें: अगर / जब आप बाद में एक नए संस्करण में अपग्रेड करते हैंJava, आपको इन फोंटों को फिर से स्थापित करने की आवश्यकता है।
मैक पर: प्रत्येक फ़ॉन्ट फ़ाइल के लिए, उस पर डबल क्लिक करें और फिर फ़ॉन्ट इंस्टॉल करें क्लिक करें।
विंडोज 7 और 10 पर: विंडोज एक्सप्लोरर में, सभी फ़ॉन्ट फ़ाइलों का चयन करें। राइट क्लिक इंस्टॉल पर क्लिक करें।

टेस्ट टॉमकैट

अपने टॉमकैट इंस्टॉलेशन का परीक्षण करें।
- लिनक्स:
  - उपयोगकर्ता के रूप में "tomcat", रन tomcat/bin/startup.sh
  - अपने ब्राउज़र में अपना URL + ":8080/" देखें (उदाहरण के लिए http://coastwatch.pfeg.noaa.gov:8080/ ) ।
  - आपको टॉमकैट "Congratulations" पेज देखना चाहिए। यदि कोई समस्या है, तो टॉमकैट लॉग फ़ाइल tomcat/logs/catalina.out देखें।
- मैक (सिस्टम प्रशासक उपयोगकर्ता के रूप में tomcat चलाने) :
  - रन tomcat/bin/startup.sh
  - अपने ब्राउज़र में अपना URL + ":8080/" देखें (उदाहरण के लिए http://coastwatch.pfeg.noaa.gov:8080/ ) । ध्यान दें कि डिफ़ॉल्ट रूप से, आपका टॉमकैट केवल आपके द्वारा सुलभ है। यह सार्वजनिक रूप से सुलभ नहीं है।
  - आपको टॉमकैट "Congratulations" पेज देखना चाहिए। यदि कोई समस्या है, तो टॉमकैट लॉग फ़ाइल tomcat/logs/catalina.out देखें।
- विंडोज स्थानीयहोस्ट:
  - सिस्टम ट्रे में टॉमकैट आइकन पर राइट क्लिक करें, और "स्टार्ट सर्विस" चुनें।
  - देखें http://127.0.0.1:8080/ शायद http://localhost:8080/ , अपने ब्राउज़र में। ध्यान दें कि डिफ़ॉल्ट रूप से, आपका टॉमकैट केवल आपके द्वारा सुलभ है। यह सार्वजनिक रूप से सुलभ नहीं है।
  - आपको टॉमकैट "Congratulations" पेज देखना चाहिए। यदि कोई समस्या है, तो टॉमकैट लॉग फ़ाइल tomcat/logs/catalina.out देखें।

टॉमकैट स्थापना के साथ समस्या?

लिनक्स और मैक पर, यदि आप टॉमकैट तक नहीं पहुंच सकते हैं याERDDAP™ (या शायद आप उन्हें अपने फायरवॉल के बाहर कंप्यूटर से नहीं पहुंच सकते) , आप परीक्षण कर सकते हैं कि क्या टॉमक 8080 पोर्ट सुन रहा है, टाइपिंग द्वारा (जड़ के रूप में) सर्वर की एक कमांड लाइन पर:

    netstat -tuplen | grep 8080

इस तरह कुछ के साथ एक लाइन वापस आना चाहिए:

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

(जहाँ '#' कुछ अंक हैं) यह दर्शाता है कि "जावा" प्रक्रिया (संभवतः टॉमकैट) "tcp" यातायात के लिए बंदरगाह "8080" पर सुन रहा है। यदि कोई रेखा वापस नहीं की गई थी, तो यदि लाइन लौटी तो काफी अलग है, या यदि दो या दो से अधिक लाइनें वापस आ गई हैं, तो पोर्ट सेटिंग के साथ समस्या हो सकती है।

टॉमकैट लॉग फ़ाइल tomcat/logs/catalina.out देखें। टॉमकैट समस्याओं और कुछERDDAP™स्टार्टअप समस्याओं को हमेशा वहाँ संकेत दिया जाता है। यह आम है जब आप पहली बार सेटिंग कर रहे हैंERDDAP™।
देखेंटॉमकैटवेबसाइट या मदद के लिए वेब की खोज करें, लेकिन कृपया हमें उन समस्याओं को जानने दें जो आपके पास थे और आपके द्वारा मिले समाधान।
देखेंअतिरिक्त समर्थन प्राप्त करने पर अनुभाग।

ERDDAP™सामग्री

सेट अप_tomcat_/content/erddapविन्यास फाइलें।
लिनक्स, मैक और विंडोज पर, डाउनलोड करेंerddapContent.zip (संस्करण 1.0.0, 20333 बाइट्स, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, दिनांक 2024-10-14) To unzip it in tomcat.tomcat/content/erddap।

\[कुछ पिछले संस्करण भी उपलब्ध हैं: 2.17 (19,792 बाइट्स, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, दिनांक 2022-02-16)
2.18 (19,792 बाइट्स, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, दिनांक 2022-02-16)
2.21 (19,810 बाइट्स, MD5=1E26F62E7A06191EE6868C40B9A29362, दिनांक 2022-10-09)
2.22 (19,810 बाइट्स, MD5=1E26F62E7A06191EE6868C40B9A29362, दिनांक 2022-12-08) 2.23 (19,810 बाइट्स, MD5=1E26F62E7A06191EE6868C40B9A29362, दिनांक 2023-02-27) To unzip it in tomcat.tomcat/content/erddap।\]

अन्य निर्देशिका

Red Hat Enterprise Linux के लिए (आरएचईएल) या अन्य स्थितियों के लिए जहां आपको टॉमकैट निर्देशिका को संशोधित करने की अनुमति नहीं है या जहां आप चाहते हैं / रखने की जरूरत हैERDDAP™कुछ अन्य कारणों से कुछ अन्य स्थानों में सामग्री निर्देशिका (उदाहरण के लिए, यदि आप टॉमकैट के बजाय जेटी का उपयोग करते हैं) , unzip erddapContent.zipवांछित निर्देशिका में (to which only user=tomcat is access) और सेटerddapContentDirectoryप्रणाली संपत्ति (उदाहरण के लिएerddapContentDirectory=~tomcat/content/erddap) इसलिएERDDAP™इस नई सामग्री निर्देशिका को पा सकते हैं।

साइटमैप

में टिप्पणी पढ़ें_tomcat_/content/erddap/ साइटमैप और अनुरोधित परिवर्तन करें। सेटअप.xml सभी सेटिंग्स के साथ फ़ाइल है जो निर्दिष्ट करता है कि कैसे आपकाERDDAP™व्यवहार करना। प्रारंभिक सेटअप के लिए, आप कम से कम इन सेटिंग्स को बदल सकते हैं:

    <bigParentDirectory>, <emailEverythingTo>, <baseUrl>, <email.\\*>, <admin.\\*> (and <baseHttpsUrl> when you set up https).

जब आप बिगParentDirectory बनाते हैं, तो बिगParentDirectory की मूल निर्देशिका से:

उपयोगकर्ता=tomcat बिगParentDirectory के मालिक, उदाहरण के लिए,

        chown -R tomcat _bigParentDirectory_

Tomcat करने के लिए "समूह" बदलें, आपका उपयोगकर्ता नाम, या एक छोटे समूह का नाम जिसमें टॉमकैट और टॉमकैट के सभी प्रशासक शामिल हैं।ERDDAP, उदाहरण के लिए,

        chgrp -R _yourUserName_ _bigParentDirectory_

अनुमतियां बदलें ताकि tomcat और समूह ने विशेषाधिकारों को पढ़ा, लिखना, निष्पादित करना, उदाहरण के लिए।

        chmod -R ug+rwx _bigParentDirectory_

"अन्य" उपयोगकर्ता की अनुमति को पढ़ने, लिखने या निष्पादित करने के लिए निकालें। इसमें पढ़ने की संभावित संवेदनशील जानकारी को रोकने के लिए यह महत्वपूर्ण हैERDDAP™निजी डेटासेट के बारे में जानकारी के साथ फ़ाइलों और फ़ाइलों को लॉग इन करें।

        chmod -R o-rwx _bigParentDirectory_

पर्यावरण चर

शुरूERDDAP™v2.13,ERDDAP™व्यवस्थापक सेटअप में किसी भी मूल्य को ओवरराइड कर सकते हैं.xml एक पर्यावरण चर नामित निर्दिष्ट करकेERDDAP\valueName चलाने से पहलेERDDAP™। उदाहरण के लिए, उपयोगERDDAP\_baseUrl overrides<BaseUrl> value. तैनाती करते समय यह आसान हो सकता हैERDDAP™डोकर जैसे कंटेनर के साथ, जैसा कि आप सेटअप.xml में मानक सेटिंग्स डाल सकते हैं और फिर पर्यावरण चर के माध्यम से विशेष सेटिंग्स की आपूर्ति कर सकते हैं। यदि आप गुप्त जानकारी की आपूर्ति करते हैंERDDAP™इस विधि के माध्यम से यह जांचना सुनिश्चित करें कि सूचना गुप्त रहेगी।ERDDAP™केवल स्टार्टअप प्रति एक बार पर्यावरण चर पढ़ता है, स्टार्टअप के पहले सेकंड में, इसलिए इसका उपयोग करने का एक तरीका है: पर्यावरण चर सेट करें, शुरू करेंERDDAP, जब तक इंतजारERDDAP™शुरू किया जाता है, फिर पर्यावरण चर को बंद कर दिया जाता है।

datasets.xml

में टिप्पणी पढ़ें साथ काम करनाdatasets.xmlफ़ाइल । बाद में, आने के बादERDDAP™पहली बार (आमतौर पर सिर्फ डिफ़ॉल्ट डेटासेट के साथ) , आप XML को संशोधित करेंगे_tomcat_/content/erddap/ datasets.xml उन सभी डेटासेट को निर्दिष्ट करने के लिए जिन्हें आप चाहते हैंERDDAP™सेवा यह वह जगह है जहाँ आप अपने समय का थोक खर्च करते हैंERDDAP™और बाद में अपने बनाए रखने के दौरानERDDAP™।

आप एक उदाहरण देख सकते हैंdatasets.xmlGitHub।

(विपरीत) अब या (थोड़ा अधिक संभावना) भविष्य में, यदि आप erddap की CSS फ़ाइल को संशोधित करना चाहते हैं, तो इसकी एक प्रति बनाएं_tomcat_/content/erddap/images/erddapStart2.css को erddap2.css कहा जाता है और फिर इसमें बदलाव आता है। erddap2.css में परिवर्तन केवल तभी प्रभावी होता है जबERDDAP™पुनः आरंभ किया जाता है और अक्सर उपयोगकर्ता को ब्राउज़र की कैश्ड फ़ाइलों को साफ़ करने की भी आवश्यकता होती है। ERDDAP™अगर सेटअप.xml याdatasets.xmlफ़ाइल एक अच्छी तरह से निर्मित XML फ़ाइल नहीं है। इसलिए, इन फ़ाइलों को संपादित करने के बाद, यह सत्यापित करने का एक अच्छा विचार है कि परिणाम XML टेक्स्ट को XML चेकर जैसे XML चेकर में पेस्ट करके अच्छी तरह से निर्मित XML है।xmlvalidation।

erddap.war फ़ाइल स्थापित करें

लिनक्स, मैक और विंडोज पर, डाउनलोड करेंerddap.warin tomcat/webapps. (संस्करण 2.26, 607,404,032 बाइट्स, MD5=99a725108b37708e5420986c1616a119, दिनांक 03-31-2025)

.war फ़ाइल बड़ा है क्योंकि इसमें मानचित्र बनाने के लिए उच्च रिज़ॉल्यूशन तटरेखा, सीमा और ऊंचाई डेटा की आवश्यकता होती है।

\[कुछ पिछले संस्करण भी उपलब्ध हैं। 2.17 (551,068,245 बाइट्स, MD5=5FEA912B5D42E50EAB9591F773EA848D, दिनांक 2022-02-16)
2.18 (551,069,844 बाइट्स, MD5=461325E97E7577EC671DD50246CCFB8B, दिनांक 2022-02-23)
2.21 (568,644,411 बाइट्स, MD5=F2CFF805893146E932E498FDDBD519B6, दिनांक 2022-10-09)
2.22 (567,742,765 बाइट्स, MD5=2B33354F633294213AE2AFDDCF4DA6D0, दिनांक 2022-12-08) 2.23 (572,124,953 बाइट्स, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, दिनांक 2023-03-03) 2.24 (568,748,187 बाइट्स, MD5=970fbee172e28b0b8a07756eecbc898e, दिनांक 2024-06-07) 2.25 (592,292,039 बाइट्स, MD5=652AFC9D1421F00B5F789DA2C4732D4C, दिनांक 2024-11-07) \]

प्रॉक्सी

प्रॉक्सी पास इसलिए उपयोगकर्ताओं को URL में पोर्ट नंबर, उदाहरण के लिए,:8080, डालना नहीं है। लिनक्स कंप्यूटर पर, यदि टॉमकैट अपाचे में चल रहा है, तो कृपया अपाचे को संशोधित करें।httpd.conf file (आमतौर पर /etc/ मेंhttpd/conf/) HTTP यातायात को / से अनुमति देने के लिएERDDAP™बिना पोर्ट नंबर की आवश्यकता के, उदाहरण के लिए: 8080, यूआरएल में। मूल उपयोगकर्ता के रूप में:
1. मौजूदा को संशोधित करें<VirtualHost> tag (यदि कोई हो) , या फ़ाइल के अंत में एक जोड़ें:

        <VirtualHost \\*:80>
           ServerName _YourDomain.org_
           ProxyRequests Off
           ProxyPreserveHost On
           ProxyPass /erddap http://localhost:8080/erddap
           ProxyPassReverse /erddap http://localhost:8080/erddap
        </VirtualHost>

फिर अपाचे को पुनरारंभ करें: /usr/sbin/apachectl सुंदर (लेकिन कभी-कभी यह एक अलग निर्देशिका में होता है) ।

NGINX

(यूNCOएमएमएन) यदि आप उपयोग कर रहे हैंNGINX (वेब सर्वर और लोड बैलेंसर) : NGINX प्राप्त करने के लिए औरERDDAP™ठीक से काम करनाhttps, आपको टॉमकैट सर्वर.xml के अंदर निम्नलिखित स्निपेट लगाने की आवश्यकता है<होस्ट> ब्लॉक:

    &lt;Valve className="org.apache.catalina.valves.RemoteIpValve"  
      remoteIpHeader="X-Forwarded-For"  
      protocolHeader="X-Forwarded-Proto"  
      protocolHeaderHttpsValue="https" /&gt; 

और nginx विन्यास फ़ाइल में, आपको इन हेडर सेट करने की आवश्यकता है:

      proxy\\_set\\_header Host              $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;

(Kyle Wilcox के लिए धन्यवाद।)

टॉमकैट

(मैं टॉमकैट वेब एप्लीकेशन मैनेजर का उपयोग करने की सलाह नहीं देता। यदि आप पूरी तरह से बंद नहीं करते हैं और स्टार्टअप टॉमकैट, जल्द ही या बाद में आपके पास PermGen स्मृति मुद्दे होंगे।)
(लिनक्स या मैक ओएस में, यदि आपने टॉमकैट चलाने के लिए एक विशेष उपयोगकर्ता बनाया है, उदाहरण के लिए, टॉमकैट, उस उपयोगकर्ता के रूप में निम्नलिखित चरणों को करना याद रखें।)
यदि टॉमकैट पहले से ही चल रहा है, तो टॉमकैट को बंद कर दें (लिनक्स या मैक ओएस) To make a shutdown.sh या (Windows में) \________________________________________________________________________shutdown.bat

लिनक्स पर ps-ef|यह सुनिश्चित करने के लिए कि टोमकैट प्रक्रिया बंद हो गई है, पहले और बाद में शटडाउन.sh के बाद गंभीर tomcat। प्रक्रिया को बंद होने से पहले सूचीबद्ध किया जाना चाहिए और अंततः बंद होने के बाद सूचीबद्ध नहीं किया जाना चाहिए। यह एक मिनट या दो के लिए ले सकता हैERDDAP™पूरी तरह बंद करने के लिए। रोगी बनें यदि ऐसा लगता है कि यह अपने आप को बंद नहीं करेगा, तो इसका उपयोग करें: -9 की मौत

साथ में टॉमकैट शुरू (लिनक्स या मैक ओएस) To make a set up.sh या (Windows में) To make a lyric.

क्या हैERDDAP™दौड़ना?

देखने की कोशिश करने के लिए ब्राउज़र का उपयोग करें http://www.YourServer.org/erddap/status.html
ERDDAP™किसी भी डेटासेट लोड के बिना शुरू होता है। डेटासेट को पृष्ठभूमि धागे में लोड किया जाता है और इसलिए एक-एक करके उपलब्ध हो जाता है।

समस्या निवारण

जब एक उपयोगकर्ता से अनुरोध आता है, तो यह अपाचे जाता है (लिनक्स और मैक ओएस कंप्यूटर पर) तब टॉमकैटERDDAP™।
आप देख सकते हैं क्या आता है अपाचे (और संबंधित त्रुटियों) अपाचे लॉग फ़ाइलों में।
आपक्या आता है (और संबंधित त्रुटियों) टॉमकैट लॉग फ़ाइलों में (tomcat/logs/catalina.out और उस निर्देशिका में अन्य फाइलें) ।
आपक्या आता हैERDDAPसे नैदानिक संदेशERDDAP, और त्रुटि संदेश सेERDDAP, मेंERDDAP™ <bigParentDirectory>logs/log.txt फ़ाइल.
टॉमकैट शुरू नहीं होताERDDAP™जब तक टॉमकैट को अनुरोध नहीं हो जाता हैERDDAP™। तो अगर यह शुरू हुआ तो आप टॉमकैट लॉग फ़ाइलों में देख सकते हैंERDDAP™या यदि उस प्रयास से संबंधित त्रुटि संदेश है।
कबERDDAP™शुरू होता है, यह पुराने नाम बदलता हैERDDAP™log.txt फ़ाइल (LogArchivedAt_CurrentTime_txt) और एक नई log.txt फ़ाइल बनाता है। तो अगर लॉग. txt फ़ाइल पुराना है, यह एक संकेत है किERDDAP™हाल ही में पुनः आरंभ नहीं हुआ है।ERDDAP™एक बफर को लॉग जानकारी लिखते हैं और केवल बफर को समय-समय पर लॉग फ़ाइल में लिखते हैं, लेकिन आप बल कर सकते हैंERDDAP™लॉग फ़ाइल में बफर लिखने के लिए .../erddap/status.html।

Trouble: पुराने संस्करणJava

यदि आप एक संस्करण का उपयोग कर रहे हैंJavaयह बहुत पुराना हैERDDAP,ERDDAP™नहीं चलेंगे और आपको टॉमकैट की लॉग फाइल जैसे त्रुटि संदेश दिखाई देंगे थ्रेड "मुख्य" java.lang.UnsupportedClassVersionError: some/class/name: Unsupported major.minor version someNumber समाधान के हाल के संस्करण को अद्यतन करना हैJavaऔर सुनिश्चित करें कि टॉमकैट इसका उपयोग कर रहा है।

मुसीबत: धीमी शुरुआत पहली बार

टॉमकैट को पहली बार एक आवेदन की तरह काम करने का एक बहुत कुछ करना हैERDDAP™शुरू हो गया है; विशेष रूप से, इसे erddap को खोलना पड़ता है। युद्ध (जो समान है.zipफ़ाइल) । कुछ सर्वरों पर देखने का पहला प्रयासERDDAP™स्टाल (30 सेकंड?) जब तक यह काम समाप्त हो जाता है। अन्य सर्वरों पर, पहला प्रयास तुरंत विफल हो जाएगा। लेकिन अगर आप 30 सेकंड का इंतजार करते हैं और फिर से कोशिश करते हैं तो यह सफल होगा अगरERDDAP™सही ढंग से स्थापित किया गया था। इसके लिए कोई निश्चित नहीं है। यह बस कैसे काम करता है टॉमकैट। लेकिन यह केवल पहली बार होता है जब आप एक नया संस्करण स्थापित करते हैंERDDAP™।

बंद करें और फिर से शुरू करें

भविष्य में बंद करने के लिए (और पुनः आरंभ) ERDDAP, देखेंकैसे बंद करें और टॉमकैट को फिर से शुरू करेंERDDAP।

मुसीबत?

टॉमकैट स्थापित करने वाले समस्याएँERDDAP? देखेंअतिरिक्त समर्थन प्राप्त करने पर अनुभाग।

नए संस्करण की ईमेल अधिसूचनाERDDAP

यदि आप किसी नए संस्करण में ईमेल प्राप्त करना चाहते हैं तोERDDAP™उपलब्ध है या अन्य महत्वपूर्णERDDAP™घोषणाओं, आप शामिल हो सकते हैंERDDAP™घोषणा सूचीयहाँ। यह सूची हर तीन महीने में लगभग एक ईमेल का औसत है।

अनुकूलित

अनुकूलित करेंERDDAP™अपने संगठन को उजागर करने के लिए (नहींNOAA ERD) ।

सभी के शीर्ष पर दिखाई देने वाले बैनर को बदलेंERDDAP™HTML पृष्ठों को संपादित करके<startBodyHtml5> अपने में टैगdatasets.xmlफ़ाइल (यदि कोई नहीं है, तो डिफ़ॉल्ट को से कॉपी करेंERDDAP' \[tomcat\]/webapps/erddap/WEB-INF/classs/gov/noaa/pfel/erddap/util/mesage.xml फ़ाइल मेंdatasets.xmlइसे संपादित करें उदाहरण के लिए, आप कर सकते हैं:
- एक अलग छवि का उपयोग करें (यानी, आपका संगठन का लोगो) ।
- पृष्ठभूमि रंग बदलें।
- बदलेंERDDAP"YourOrganization's"ERDDAP"
- "Easier access to science data" to "Easier access to YourOrganization's data".
- अपने संगठन और फंडिंग स्रोतों के लिंक होने के लिए "Brought to you" लिंक बदलें।
होम पेज के बाईं ओर की जानकारी को संपादित करके बदलें<ShortDescriptionHtml> अपने में टैगdatasets.xmlफ़ाइल (यदि कोई नहीं है, तो डिफ़ॉल्ट को से कॉपी करेंERDDAP' \[tomcat\]/webapps/erddap/WEB-INF/classs/gov/noaa/pfel/erddap/util/mesage.xml फ़ाइल मेंdatasets.xmlइसे संपादित करें उदाहरण के लिए, आप कर सकते हैं:
- अपने संगठन और/या समूह के बारे में बताएं।
- इस बारे में किस तरह के डेटा का वर्णन करेंERDDAP™है।
ब्राउज़र टैब पर दिखाई देने वाले आइकन को बदलने के लिए, अपने संगठन के फ़ैविकॉन को डाल दें। ico in_tomcat_/content/erddap/images/। देखें https://en.wikipedia.org/wiki/Favicon ।

Java​

टॉमकैट​

सर्वर xml​

सामग्री.xml​

अपाचे टाइमआउट​

स्मृति​

कचरा संग्रह​

अनुमतियां​

फ़ॉन्ट्स​

टेस्ट टॉमकैट​

टॉमकैट स्थापना के साथ समस्या?​

ERDDAP™सामग्री​

अन्य निर्देशिका​

साइटमैप​

पर्यावरण चर​

datasets.xml​

erddap.war फ़ाइल स्थापित करें​

प्रॉक्सी​

NGINX​

टॉमकैट​

क्या हैERDDAP™दौड़ना?​

समस्या निवारण​

Trouble: पुराने संस्करणJava​

मुसीबत: धीमी शुरुआत पहली बार​

बंद करें और फिर से शुरू करें​

मुसीबत?​

नए संस्करण की ईमेल अधिसूचनाERDDAP​

अनुकूलित​

Java

टॉमकैट

सर्वर xml

सामग्री.xml

अपाचे टाइमआउट

स्मृति

कचरा संग्रह

अनुमतियां

फ़ॉन्ट्स

टेस्ट टॉमकैट

टॉमकैट स्थापना के साथ समस्या?

ERDDAP™सामग्री

अन्य निर्देशिका

साइटमैप

पर्यावरण चर

datasets.xml

erddap.war फ़ाइल स्थापित करें

प्रॉक्सी

NGINX

टॉमकैट

क्या हैERDDAP™दौड़ना?

समस्या निवारण

Trouble: पुराने संस्करणJava

मुसीबत: धीमी शुरुआत पहली बार

बंद करें और फिर से शुरू करें

मुसीबत?

नए संस्करण की ईमेल अधिसूचनाERDDAP

अनुकूलित