किसी सामान्य एज इंस्टॉलेशन में, कई नोड में डिस्ट्रिब्यूट किए गए एज कॉम्पोनेंट होते हैं. किसी नोड पर Edge इंस्टॉल करने के बाद, नोड पर एक या उससे ज़्यादा Edge कॉम्पोनेंट को इंस्टॉल और कॉन्फ़िगर किया जा सकता है.
इंस्टॉल करने की प्रोसेस
किसी नोड पर Edge इंस्टॉल करने की प्रक्रिया कई चरणों में होती है:
- नोड पर SELinux को बंद करें या इसे अनुमति वाले मोड पर सेट करें. ज़्यादा जानकारी के लिए, Edge apigee-setup उपयोगिता इंस्टॉल करें देखें.
- तय करें कि आपको Cassandra की पुष्टि करने की सुविधा चालू करनी है या नहीं.
- तय करें कि क्या आपको Postgres के लिए, मास्टर-स्टैंडबाय प्रतिरूप को सेट अप करने का विकल्प है.
- सुझाए गए टोपोलॉजी की सूची से अपना Edge कॉन्फ़िगरेशन चुनें. उदाहरण के लिए, Edge को टेस्टिंग के लिए एक नोड पर या प्रोडक्शन के लिए 13 नोड पर इंस्टॉल किया जा सकता है. ज़्यादा जानकारी के लिए, इंस्टॉल करने की खास जानकारी देखें.
- आपकी चुनी गई टोपोलॉजी के हर नोड पर, Edge
apigee-setup
सुविधा इंस्टॉल करें:- Edge
bootstrap_4.52.01.sh
फ़ाइल को/tmp/bootstrap_4.52.01.sh
में डाउनलोड करें. - Edge
apigee-service
यूटिलिटी और डिपेंडेंसी इंस्टॉल करें. - Edge
apigee-setup
यूटिलिटी और डिपेंडेंसी इंस्टॉल करें.ज़्यादा जानकारी के लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करें देखें.
- Edge
- अपनी चुनी गई टोपोलॉजी के हिसाब से हर नोड पर एक या उससे ज़्यादा Edge कॉम्पोनेंट इंस्टॉल करने के लिए,
apigee-setup
सुविधा का इस्तेमाल करें. - मैनेजमेंट सर्वर नोड पर,
apigee-setup
यूटिलिटी का इस्तेमालapigee-provision
को इंस्टॉल करने के लिए करें. यह उन यूटिलिटी को इंस्टॉल करता है जिनका इस्तेमाल, Edge के संगठन बनाने और उन्हें मैनेज करने के लिए किया जाता है.ज़्यादा जानकारी के लिए, संगठन में शामिल होना लेख पढ़ें.
- इंस्टॉलेशन पूरा होने के बाद हर नोड पर क्लासिक यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें,
जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(सुझाया गया) शुरुआती इंस्टॉलेशन पूरा करने के बाद, Apigee का सुझाव है कि आप नया Edge यूज़र इंटरफ़ेस (यूआई) (जिसका कॉम्पोनेंट नाम
edge-management-ui
है) इंस्टॉल करें. यह निजी क्लाउड के लिए, Apigee Edge के डेवलपर और एडमिन के लिए एक बेहतर यूज़र इंटरफ़ेस है.ज़्यादा जानकारी के लिए, नया Edge यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करें देखें.
इंस्टॉल पूरा होने के बाद, इंस्टॉल करने के बाद होने वाली सामान्य कार्रवाइयों की यह सूची देखें.
कौन इंस्टॉल कर सकता है
Apigee Edge की डिस्ट्रिब्यूशन फ़ाइलों को, आरपीएम और डिपेंडेंसी के सेट के तौर पर इंस्टॉल किया जाता है. Edge आरपीएम इंस्टॉल, अनइंस्टॉल, और अपडेट करने के लिए, यह ज़रूरी है कि निर्देश, रूट उपयोगकर्ता या ऐसे उपयोगकर्ता के पास हों जिनके पास सूडो का पूरा ऐक्सेस हो. पूरे sudo ऐक्सेस के लिए, इसका मतलब है कि उपयोगकर्ता के पास रूट की तरह ही कार्रवाइयां करने के लिए sudo ऐक्सेस है.
जो उपयोगकर्ता नीचे दिए गए निर्देशों या स्क्रिप्ट को चलाना चाहता है, वह या तो रूट होना चाहिए या ऐसा उपयोगकर्ता होना चाहिए जिसके पास सूडो का पूरा ऐक्सेस हो:
- apigee-service यूटिलिटी:
- apigee-service निर्देश:
install, uninstall, update
. - apigee-all निर्देश:
install, uninstall, update
.
- apigee-service निर्देश:
- setup.sh स्क्रिप्ट को किनारे के कॉम्पोनेंट इंस्टॉल करने के लिए माना जाता है (जब तक कि आपने ज़रूरी आरपीएम इंस्टॉल करने के लिए
"
apigee-service install
" का इस्तेमाल न किया हो. इसके बाद, अगर ज़रूरी न हो, तो रूट या पूरा sudo ऐक्सेस करें.) - किनारे के कॉम्पोनेंट अपडेट करने के लिए, update.sh स्क्रिप्ट
साथ ही, Edge इंस्टॉलर आपके सिस्टम पर एक नया उपयोगकर्ता बनाता है, जिसका नाम "apigee" है. कई Edge कमांड, "apigee" उपयोगकर्ता के तौर पर चलने के लिए sudo को शुरू करते हैं.
जो उपयोगकर्ता ऊपर दिखाए गए निर्देशों के अलावा, अन्य सभी निर्देशों को चलाना चाहता है वह "apigee" उपयोगकर्ता का पूरा सुडो ऐक्सेस रखने वाला उपयोगकर्ता होना चाहिए. इनमें ये निर्देश शामिल हैं:
-
apigee-service यूटिलिटी कमांड शामिल हैं. इनमें ये शामिल हैं:
- apigee-service निर्देश दिए जाते हैं, जैसे कि
start, stop, restart, configure
. - apigee-all कमांड दिए जाते हैं, जैसे कि
start, stop, restart, configure
.
- apigee-service निर्देश दिए जाते हैं, जैसे कि
"apigee" उपयोगकर्ता के लिए पूर्ण sudo ऐक्सेस वाला उपयोगकर्ता बनाना
किसी उपयोगकर्ता को "apigee" उपयोगकर्ता का पूरा sudo ऐक्सेस मिले, इसके लिए कॉन्फ़िगर करने के लिए, "visudo" कमांड का इस्तेमाल करके sudoers फ़ाइल में बदलाव करें:
installUser ALL=(apigee) NOPASSWD: ALL
जहां installUser, Edge के साथ काम करने वाले व्यक्ति का उपयोगकर्ता नाम है.
कॉन्फ़िगरेशन फ़ाइलों पर अनुमतियां सेट करना
यह ज़रूरी है कि Edge के निर्देशों में इस्तेमाल की जाने वाली सभी फ़ाइलों या रिसॉर्स को "apigee" उपयोगकर्ता ऐक्सेस कर सके. इसमें Edge की लाइसेंस फ़ाइल और सभी कॉन्फ़िगरेशन फ़ाइलें शामिल हैं.
कॉन्फ़िगरेशन फ़ाइल बनाते समय, इसके मालिक को "apigee:apigee" में बदला जा सकता है, ताकि यह पक्का हो सके कि इसे Edge के निर्देशों से ऐक्सेस किया जा सकता है:
- किसी भी उपयोगकर्ता के तौर पर एडिटर में फ़ाइल बनाएं.
chown
फ़ाइल का मालिक "apigee:apigee" हो गया है या अगर आपने "apigee" उपयोगकर्ता से Edge सेवा चलाने की सेटिंग बदली है, तो फ़ाइल को उस उपयोगकर्ता के नाम से बदलें जो Edge सेवा इस्तेमाल कर रहा है.
रूट और नॉन-रूट उपयोगकर्ता के बीच Edge इंस्टॉल करने के टास्क को अलग करना
हालांकि, Edge इंस्टॉल करने की पूरी प्रोसेस को रूट के तौर पर या ऐसे उपयोगकर्ता से पूरा करना सबसे आसान है जिसके पास पूरा सूडो ऐक्सेस है, लेकिन हमेशा ऐसा करना मुमकिन नहीं होता. इसके बजाय, प्रोसेस को रूट और किए गए टास्क में अलग-अलग किया जा सकता है. ये टास्क ऐसे उपयोगकर्ता होते हैं जिन्हें "apigee" उपयोगकर्ता का पूरा सूडो ऐक्सेस मिला हो.
- रूट के हिसाब से किए गए टास्क:
bootstrap_4.52.01.sh
फ़ाइल को डाउनलोड करके चलाएं:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
यह चरण,
apigee-service
यूटिलिटी इंस्टॉल करता है और "apigee" उपयोगकर्ता बनाता है.- "apigee" उपयोगकर्ता के लिए पूरे सुडो ऐक्सेस वाला उपयोगकर्ता बनाना में बताए गए तरीके के मुताबिक, "apigee" उपयोगकर्ता को पूरा sudo ऐक्सेस पाने के लिए उपयोगकर्ता को कॉन्फ़िगर करें.
apigee-setup
यूटिलिटी इंस्टॉल करें:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- नोड पर Edge आरपीएम इंस्टॉल करने के लिए
apigee-setup
सुविधा का इस्तेमाल करें:/opt/apigee/apigee-service/bin/apigee-service compName install
नोड पर इंस्टॉल किए गए Edge आरपीएम आपकी टोपोलॉजी पर निर्भर करते हैं. उपलब्ध कॉम्पोनेंट की सूची में ये कॉम्पोनेंट शामिल हैं:
apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server
.
- जब रूट उपयोगकर्ता नोड पर Edge आरपीएम इंस्टॉल कर लेता है, तो "apigee" उपयोगकर्ता के लिए पूरी सूडो ऐक्सेस वाला उपयोगकर्ता कॉन्फ़िगरेशन प्रोसेस को पूरा करता है:
- नोड पर Edge के कॉम्पोनेंट का कॉन्फ़िगरेशन पूरा करने के लिए,
setup.sh
सुविधा का इस्तेमाल करें. निर्देश का टाइप, उन कॉम्पोनेंट पर निर्भर करता है जिन्हें आपने नोड पर इंस्टॉल किया है. पूरी सूची के लिए, नोड पर एज कॉम्पोनेंट इंस्टॉल करें देखें.उदाहरण के लिए, ZooKeeper और Cassandra को इंस्टॉल करने के लिए, इस कमांड का इस्तेमाल करें:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
जहां configFile, Edge की कॉन्फ़िगरेशन फ़ाइल है.
इसके अलावा, एक ही जगह पर ऐप्लिकेशन इंस्टॉल करने के लिए, इस कमांड का इस्तेमाल करें:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- नोड पर Edge के कॉम्पोनेंट का कॉन्फ़िगरेशन पूरा करने के लिए,
इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइलों की जगह
आपको apigee-setup
यूटिलिटी को कॉन्फ़िगरेशन फ़ाइल पास करनी होगी. इसमें Edge इंस्टॉल करने के बारे में जानकारी शामिल है. साइलेंट इंस्टॉलेशन के लिए, सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल, "apigee" उपयोगकर्ता ऐक्सेस कर सके या उसे पढ़ सके. उदाहरण के लिए, फ़ाइल को
/usr/local/var
या /usr/local/share
डायरेक्ट्री में, नोड पर रखें और
chown
उसे "apigee:apigee" पर रखें.
Edge सिस्टम एडमिन के पासवर्ड के अलावा, कॉन्फ़िगरेशन फ़ाइल
की पूरी जानकारी देना ज़रूरी है. अगर पासवर्ड को छोड़ा जाता है, तो apigee-setup
यूटिलिटी आपको कमांड लाइन पर उसे डालने का निर्देश देती है.
ज़्यादा जानकारी के लिए किसी नोड पर एज कॉम्पोनेंट इंस्टॉल करना देखें.
इंस्टॉलेशन की गड़बड़ी ठीक करना
अगर Edge कॉम्पोनेंट को इंस्टॉल करने के दौरान कोई गड़बड़ी होती है, तो समस्या को ठीक करने की कोशिश की जा सकती है. इसके बाद, इंस्टॉलर को फिर से चलाया जा सकता है. इंस्टॉलर को ऐसे मामलों में बार-बार चलाने के लिए डिज़ाइन किया गया है, जहां उसे किसी गड़बड़ी का पता चलता है या अगर आप बाद में किसी कॉम्पोनेंट को इंस्टॉल करने के बाद उसे बदलना या अपडेट करना चाहें.
इंस्टॉल या अपग्रेड करने के बाद, हर उस नोड पर Edge यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करना न भूलें जिस पर यह चल रहा है.
इंटरनेट या बिना इंटरनेट के इंस्टॉल करने की सेवा
किसी नोड पर Edge इंस्टॉल करने के लिए यह ज़रूरी है कि नोड, Apigee डेटा स्टोर करने की जगह को ऐक्सेस कर पाए:
- बाहरी इंटरनेट कनेक्शन वाले नोड
बाहरी इंटरनेट कनेक्शन वाले नोड, Edge आरपीएम और डिपेंडेंसी इंस्टॉल करने के लिए, Apigee रिपॉज़िटरी को ऐक्सेस करते हैं.
- बाहरी इंटरनेट कनेक्शन के बिना नोड
बिना बाहरी इंटरनेट कनेक्शन वाले नोड, Apigee डेटा स्टोर करने की उस जगह के डुप्लीकेट वर्शन को ऐक्सेस कर सकते हैं जिसे आपने अंदरूनी तौर पर सेट अप किया था. इस रिपॉज़िटरी में सभी Edge आरपीएम शामिल होते हैं. हालांकि, आपको यह पक्का करना होगा कि आपके पास इंटरनल नेटवर्क पर, डेटा स्टोर करने की अन्य सभी डिपेंडेंसी मौजूद हों.
इंटरनल Apigee रिपॉज़िटरी बनाने के लिए, आपको एज आरपीएम और डिपेंडेंसी डाउनलोड करने के लिए, बाहरी इंटरनेट ऐक्सेस वाले नोड की ज़रूरत होगी. इंटरनल रेपो बनाने के बाद, उसे किसी दूसरे नोड में ले जाया जा सकता है या उसे इंस्टॉल करने के लिए Edge नोड से ऐक्सेस किया जा सकता है.
Edge का वर्शन मैनेज करने के लिए, लोकल Edge का डेटा स्टोर करने की जगह का इस्तेमाल करना
लोकल या डुप्लीकेट डेटा स्टोर करने की जगह का इस्तेमाल करने की एक वजह, बिना बाहरी इंटरनेट कनेक्शन वाले नोड पर Edge इंस्टॉल करना है. इसके बारे में पिछले सेक्शन में बताया गया है.
आरपीएम इंस्टॉलेशन की डिपेंडेंसी से जुड़ी समस्या हल करना
Apigee Edge की डिस्ट्रिब्यूशन फ़ाइलों को आरपीएम फ़ाइलों के सेट के तौर पर इंस्टॉल किया जाता है. इनमें से हर फ़ाइल की, इंस्टॉलेशन डिपेंडेंसी की अपनी चेन हो सकती है. इनमें से कई डिपेंडेंसी, तीसरे पक्ष के कॉम्पोनेंट की मदद से तय की जाती हैं, जो Apigee के कंट्रोल से बाहर होते हैं. साथ ही, ये किसी भी समय बदल सकते हैं. इसलिए, दस्तावेज़ में हर डिपेंडेंसी का खास वर्शन नंबर नहीं दिया गया है.
अगर इंटरनेट ऐक्सेस वाली किसी मशीन पर इंस्टॉलेशन किया जा रहा है, तो नोड ज़रूरी आरपीएम और डिपेंडेंसी डाउनलोड कर सकता है. हालांकि, अगर बिना इंटरनेट ऐक्सेस वाले नोड से इंस्टॉल किया जा रहा है, तो आम तौर पर इंटरनल रेपो सेट अप किया जाता है, जिसमें सभी ज़रूरी डिपेंडेंसी होती हैं. आपके लोकल रेपो में सभी डिपेंडेंसी शामिल हैं, इस बात की गारंटी का सिर्फ़ एक तरीका है. इंस्टॉल करने की कोशिश करें, उन डिपेंडेंसी की पहचान करें जो छूटी हुई हैं, और जब तक इंस्टॉलेशन पूरा नहीं हो जाता, तब तक उन्हें लोकल रेपो में कॉपी करें.
Yum के लिए सामान्य निर्देश
Linux के Edge इंस्टॉलेशन टूल, कॉम्पोनेंट को इंस्टॉल और अपडेट करने के लिए, Yum का इस्तेमाल करते हैं. किसी नोड पर इंस्टॉलेशन को मैनेज करने के लिए, आपको कई Yum निर्देशों का इस्तेमाल करना पड़ सकता है.
- Yum की सभी कैश मेमोरी मिटाएं:
sudo yum clean all
- Edge कॉम्पोनेंट को अपडेट करने के लिए:
sudo yum update componentName
उदाहरण के लिए:
sudo yum update apigee-setup
sudo yum update edge-management-server
फ़ाइल सिस्टम स्ट्रक्चर
Edge, /opt/apigee
डायरेक्ट्री की सभी फ़ाइलें इंस्टॉल करता है.
इस गाइड और Edge कार्रवाइयों की गाइड में, रूट इंस्टॉलेशन डायरेक्ट्री को इस तरह से नोट किया जाता है:
/opt/apigee
इंस्टॉल करने में, Private Cloud के लिए Apigee Edge को डिप्लॉय करने के लिए, नीचे दिए गए फ़ाइल सिस्टम स्ट्रक्चर का इस्तेमाल किया जाता है.
लॉग फ़ाइलें
apigee-setup
और setup.sh
स्क्रिप्ट की लॉग फ़ाइल,
/tmp/setup-root.log
में लिखी गई है.
हर कॉम्पोनेंट की लॉग फ़ाइलें, /opt/apigee/var/log
डायरेक्ट्री में शामिल होती हैं. हर कॉम्पोनेंट की अपनी सबडायरेक्ट्री होती है. उदाहरण के लिए, मैनेजमेंट सर्वर के लॉग, डायरेक्ट्री में मौजूद होते हैं:
/opt/apigee/var/log/edge-management-server
नीचे दी गई टेबल में, लॉग फ़ाइलों की जगह की जानकारी दी गई है:
कॉम्पोनेंट | जगह |
---|---|
मैनेजमेंट सर्वर |
/opt/apigee/var/log/edge-management-server
|
राऊटर |
/opt/apigee/var/log/edge-router
Edge राऊटर को Nजिनx का इस्तेमाल करके लागू किया जाता है. अतिरिक्त लॉग के लिए, देखें:
|
मैसेज प्रोसेसर |
/opt/apigee/var/log/edge-message-processor
|
Apigee Qpid सर्वर |
/opt/apigee/var/log/edge-qpid-server
|
Apigee Postgres सर्वर | /opt/apigee/var/log/edge-postgres-server |
क्लासिक यूज़र इंटरफ़ेस (यूआई) (नया Edge यूज़र इंटरफ़ेस (यूआई), जिसका कॉम्पोनेंट नाम
edge-management-ui है) नहीं |
/opt/apigee/var/log/edge-ui |
ZooKeeper | /opt/apigee/var/log/apigee-zookeeper |
OpenLDAP | /opt/apigee/var/log/apigee-openldap |
कासांद्रा | /opt/apigee/var/log/apigee-cassandra/system.log |
क्विड | /opt/apigee/var/log/apigee-qpidd |
PostgreSQL डेटाबेस | /opt/apigee/var/log/apigee-postgresql |
apigee-monit |
/opt/apigee/var/log/apigee-monit |
डेटा
कॉम्पोनेंट | जगह |
---|---|
मैनेजमेंट सर्वर | /opt/apigee/data/edge-management-server |
राऊटर | /opt/apigee/data/edge-router |
मैसेज प्रोसेसर | /opt/apigee/data/edge-message-processor |
Apigee Qpid एजेंट | /opt/apigee/data/edge-qpid-server |
Apigee Postgres एजेंट | /opt/apigee/data/edge-postgres-server |
ZooKeeper | /opt/apigee/data/apigee-zookeeper |
OpenLDAP | /opt/apigee/data/apigee-openldap |
कासांद्रा | /opt/apigee/data/apigee-cassandra/data |
क्विड | /opt/apigee/data/apigee-qpid/data |
PostgreSQL डेटाबेस | /opt/apigee/data/apigee-postgres/pgdata |
apigee-monit |
/opt/apigee/data/apigee-monit |
इंस्टॉल करने पर सिस्टम की जांच करने की सुविधा चालू करें
Edge इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल, नीचे दी गई प्रॉपर्टी के साथ काम करती है:
ENABLE_SYSTEM_CHECK=y
अगर इस प्रॉपर्टी को "y" पर सेट किया जाता है, तो इंस्टॉलर यह जांच करता है कि सिस्टम, इंस्टॉल किए जा रहे कॉम्पोनेंट के लिए, सीपीयू और मेमोरी से जुड़ी ज़रूरी शर्तों को पूरा करता है या नहीं. जांच को बंद करने के लिए, डिफ़ॉल्ट वैल्यू "n" होती है.