Edge को कॉन्फ़िगर करने का तरीका

Edge for Private Cloud v. 4.17.01

इंस्टॉल करने के बाद Edge को कॉन्फ़िगर करने के लिए, .properties फ़ाइलों और Edge की सुविधाओं का इस्तेमाल किया जाता है. उदाहरण के लिए, Edge यूज़र इंटरफ़ेस (यूआई) पर टीएलएस/एसएसएल को कॉन्फ़िगर करने के लिए, .properties फ़ाइलों में बदलाव करके ज़रूरी प्रॉपर्टी सेट की जाती हैं. .properties फ़ाइलों में बदलाव करने के लिए, आपको Edge के उस कॉम्पोनेंट को रीस्टार्ट करना होगा जिस पर असर पड़ा है.

Apigee, .properties फ़ाइलों में बदलाव करने की तकनीक को कॉन्फ़िगरेशन के साथ कोड के तौर पर दिखाता है. कॉन्फ़िगरेशन के साथ कोड, मुख्य रूप से .properties फ़ाइलों में मौजूद सेटिंग के आधार पर, की/वैल्यू लुकअप टूल है. कॉन्फ़िगरेशन वाले कोड में, कुंजियों को टोकन कहा जाता है. इसलिए, Edge को कॉन्फ़िगर करने के लिए, .properties फ़ाइलों में टोकन सेट किए जाते हैं.

कॉन्फ़िगरेशन वाले कोड की मदद से, Edge कॉम्पोनेंट के लिए डिफ़ॉल्ट वैल्यू सेट की जा सकती हैं. ये वैल्यू, प्रॉडक्ट के साथ शिप की जाती हैं. साथ ही, इंस्टॉलेशन टीम को इंस्टॉलेशन टोपोलॉजी के आधार पर उन सेटिंग को बदलने की अनुमति मिलती है. इसके बाद, ग्राहक अपनी पसंद के मुताबिक किसी भी प्रॉपर्टी को बदल सकते हैं.

अगर इसे हैरारकी के तौर पर देखा जाए, तो सेटिंग को इस तरह से व्यवस्थित किया जाता है. इसमें ग्राहक की सेटिंग को सबसे ज़्यादा प्राथमिकता दी जाती है, ताकि इंस्टॉलर टीम या Apigee की किसी भी सेटिंग को बदला जा सके:

1. ग्राहक
2. इंस्टॉलर
3. Apigee

.properties फ़ाइलों को इस्तेमाल करने का तरीका

ग्राहक के तौर पर, सिर्फ़ /opt/apigee/customer/application डायरेक्ट्री में मौजूद .properties फ़ाइलों में बदलाव किया जा सकता है. हर कॉम्पोनेंट की अपनी .properties फ़ाइल होती है, जो उस डायरेक्ट्री में मौजूद होती है. उदाहरण के लिए, router.properties और management-server.properties.

1. किसी भी उपयोगकर्ता के तौर पर, एडिटर में फ़ाइल बनाएं.
2. फ़ाइल के मालिक को apigee:apigee पर सेट करें. इसके अलावा, अगर आपने Edge सेवा को चलाने वाले उपयोगकर्ता को apigee उपयोगकर्ता से बदल दिया है, तो फ़ाइल को Edge सेवा चलाने वाले उपयोगकर्ता पर सेट करें.

किसी कॉम्पोनेंट के लिए प्रॉपर्टी सेट करने के लिए, उससे जुड़ी .properties फ़ाइल में बदलाव करके टोकन सेट करें. इसके बाद, कॉम्पोनेंट को रीस्टार्ट करें:

> /opt/apigee/apigee-service/bin/apigee-service component restart

उदाहरण के लिए, router.properties में बदलाव करने के बाद, राऊटर को रीस्टार्ट करें:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Edge को अपग्रेड करने पर, /opt/apigee/customer/application डायरेक्ट्री में मौजूद .properties फ़ाइलें पढ़ी जाती हैं. इसका मतलब है कि अपग्रेड करने पर, कॉम्पोनेंट पर सेट की गई कोई भी प्रॉपर्टी बनी रहेगी.

.properties फ़ाइलों की जगह

Edge कॉम्पोनेंट के लिए, .properties फ़ाइलों की तीन टॉप-लेवल डायरेक्ट्री होती हैं: इंस्टॉलेशन, मालिक, और ग्राहक. जगह की डिफ़ॉल्ट जानकारी, इस टेबल में दिखाई गई है:

चेतावनी: Edge के ग्राहक, सिर्फ़ /opt/apigee/customer में मौजूद .properties फ़ाइलों में बदलाव कर सकते हैं. कॉम्पोनेंट और इंस्टॉलेशन डायरेक्ट्री में मौजूद फ़ाइलें देखी जा सकती हैं. हालांकि, किसी भी फ़ाइल में बदलाव न करें.

टोकन की मौजूदा वैल्यू तय करना

कॉम्पोनेंट के लिए .properties फ़ाइल में टोकन सेट करने से पहले, इस कमांड का इस्तेमाल करके उसकी मौजूदा वैल्यू का पता लगाया जा सकता है:

> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token

जहां comp कॉम्पोनेंट का नाम है और token वह टोकन है जिसकी जांच करनी है.

यह कमांड, .properties फ़ाइलों की हैरारकी को खोजता है, ताकि टोकन की मौजूदा वैल्यू का पता लगाया जा सके.

उदाहरण के लिए, राऊटर के लिए conf_http_HTTPRequest.line.limit टोकन की मौजूदा वैल्यू देखने के लिए:

> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

आपको इस फ़ॉर्मैट में आउटपुट दिखेगा:

Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

.properties फ़ाइलों में टोकन सेट करना

किसी टोकन की वैल्यू बदलने के लिए:

1. टोकन की वैल्यू सेट करने के लिए, कॉम्पोनेंट की .properties फ़ाइल में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
2. कॉम्पोनेंट को रीस्टार्ट करें.
3. टोकन की वैल्यू देखें.

उदाहरण के लिए, Edge Router के लिए अनुरोध की लाइन की सीमा सेट करने के लिए:

1. conf_http_HTTPRequest.line.limit टोकन सेट करने के लिए, /opt/apigee/customer/application/router.properties फ़ाइल में बदलाव करें:
   
   conf_http_HTTPRequest.line.limit=8k
2. Edge राऊटर को रीस्टार्ट करें:
   
   > /opt/apigee/apigee-service/bin/apigee-service edge-router restart
3. टोकन की वैल्यू देखें:
   
   > /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

एक से ज़्यादा वैल्यू वाले टोकन को सेट करना

कुछ टोकन में, कॉमा लगाकर अलग की गई वैल्यू की सूची होती है. उदाहरण के लिए, conf_security_rbac.restricted.resources टोकन, प्रतिबंधित यूआरआई की सूची लेता है, ताकि सिर्फ़ सिस्टम एडमिन उन्हें कॉल कर सके. conf_security_rbac.restricted.resources की वैल्यू देखने के लिए:

> cd /opt/apigee/edge-management-server
> grep -ri "conf_security_rbac.restricted.resources" *

आउटपुट में ये शामिल हैं:

token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status

वैल्यू की सूची वाले टोकन को सेट करने के लिए, .properties फ़ाइल में टोकन की मौजूदा वैल्यू में कोई भी नई वैल्यू जोड़ें. इसलिए, conf_security_rbac.restricted.resources में यूआरआई /myuri/* जोड़ने के लिए, /opt/apigee/customer/application/management-server.properties फ़ाइल में बदलाव करें, जैसा कि यहां दिखाया गया है:

conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

टोकन का पता लगाना

ज़्यादातर मामलों में, आपको जो टोकन सेट करने होते हैं उनकी जानकारी इस गाइड में दी गई है. हालांकि, अगर आपको किसी प्रॉपर्टी को बदलने के लिए इस्तेमाल किए गए टोकन का पता लगाना है, तो कॉम्पोनेंट के सोर्स फ़ोल्डर में grep करें.

उदाहरण के लिए, अगर आपको पता है कि Edge के पिछले वर्शन में आपने session.maxAge प्रॉपर्टी सेट की थी और आपको उसे सेट करने के लिए इस्तेमाल की गई टोकन वैल्यू जाननी है, तो /opt/apigee/edge-ui/source डायरेक्ट्री में प्रॉपर्टी के लिए grep करें:

> grep -ri "session.maxAge" /opt/apigee/edge-ui/source

आपको इस फ़ॉर्मैट में नतीजा दिखेगा:

/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

{T}{/T} टैग के बीच मौजूद स्ट्रिंग, वह टोकन है जिसे आपने .properties फ़ाइल में सेट किया है.

ऐसा टोकन सेट करना जिसे फ़िलहाल टिप्पणी के तौर पर मार्क किया गया है

Edge की कॉन्फ़िगरेशन फ़ाइलों में कुछ टोकन, टिप्पणी के तौर पर मार्क किए गए हैं. अगर आपने कोई ऐसा टोकन सेट करने की कोशिश की है जिसे टिप्पणी के तौर पर मार्क किया गया है, तो सेटिंग को अनदेखा कर दिया जाता है.

टिप्पणी के तौर पर मार्क किए गए टोकन को सेट करने के लिए, आपको एक खास सिंटैक्स का इस्तेमाल करना होगा. इसका फ़ॉर्मैट इस तरह का होता है:

conf/file.extension+propertyName=propertyValue

उदाहरण के लिए, आपको मैसेज प्रोसेसर पर HTTPClient.proxy.host नाम की प्रॉपर्टी सेट करनी है. इसके बाद, प्रॉपर्टी के लिए grep करें, ताकि उसके टोकन का पता लगाया जा सके:

> cd /opt/apigee/edge-message-processor
> grep -ri "HTTPClient.proxy.host" *

grep कमांड से मिलने वाले नतीजों में, टोकन की वैल्यू शामिल होती है. ध्यान दें कि प्रॉपर्टी के नाम को टिप्पणी के तौर पर कैसे मार्क किया गया है. इसके लिए, प्रॉपर्टी के नाम के आगे # प्रीफ़िक्स लगाया गया है:

source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=

प्रॉपर्टी सेट करने के लिए, /opt/apigee/customer/application/message-processor.properties में बदलाव करें, ताकि प्रॉपर्टी को इस तरह सेट किया जा सके:

conf/http.properties+HTTPClient.proxy.host=myhost.name.com

ध्यान दें कि प्रॉपर्टी के नाम से पहले conf/http.properties+ जोड़ा गया है. यह प्रॉपर्टी वाली कॉन्फ़िगरेशन फ़ाइल की जगह और नाम है. इसके बाद, "+" जोड़ा गया है.

मैसेज प्रोसेसर को रीस्टार्ट करने के बाद, /opt/apigee/edge-message-processor/conf/http.properties फ़ाइल की जांच करें:

> cat /opt/apigee/edge-message-processor/conf/http.properties

फ़ाइल के आखिर में, आपको प्रॉपर्टी सेट इस फ़ॉर्म में दिखेगा:

conf/http.properties:HTTPClient.proxy.host=yhost.name.com