क्लासिक यूज़र इंटरफ़ेस (यूआई) प्रॉपर्टी को नए Edge यूज़र इंटरफ़ेस (यूआई) पर माइग्रेट करना

Apigee Edge for Private Cloud 4.54.00 में, क्लासिक यूज़र इंटरफ़ेस (edge-ui कॉम्पोनेंट) को हटा दिया गया है. अब यह उपलब्ध नहीं है. Edge for Private Cloud के लिए, सिर्फ़ New Edge यूज़र इंटरफ़ेस (यूआई) (edge-management-ui कॉम्पोनेंट) उपलब्ध है.

Edge for Private Cloud 4.54.00 में edge-ui का इस्तेमाल नहीं किया जा सकता. अगर आपने /opt/apigee/customer/application/ui.properties में प्रॉपर्टी सेट करके क्लासिक यूज़र इंटरफ़ेस (यूआई) को पसंद के मुताबिक बनाया है, तो नया Edge यूज़र इंटरफ़ेस (यूआई) उस फ़ाइल को नहीं पढ़ता. 4.54.00 पर अपडेट करने के बाद, आपको /opt/apigee/customer/application/management-ui.properties में मिलती-जुलती प्रॉपर्टी सेट करनी होंगी.

इस पेज पर, ui.properties के लिए क्लासिक यूज़र इंटरफ़ेस (यूआई) की प्रॉपर्टी की सूची दी गई है. साथ ही, नए Edge यूज़र इंटरफ़ेस (यूआई) की मिलती-जुलती प्रॉपर्टी और क्लासिक यूज़र इंटरफ़ेस (यूआई) की उन प्रॉपर्टी की सूची दी गई है जो नए Edge यूज़र इंटरफ़ेस (यूआई) में काम नहीं करती हैं.

Edge का नया यूज़र इंटरफ़ेस (यूआई), Edge के अन्य कॉम्पोनेंट की तरह ही कॉन्फ़िगरेशन (CwC) वाले कोड का इस्तेमाल करता है. ज़्यादा जानकारी के लिए, Edge को कॉन्फ़िगर करने का तरीका देखें.

Classic UI और New Edge UI के कॉन्फ़िगरेशन की तुलना करना

New Edge यूज़र इंटरफ़ेस (यूआई), Classic यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट, प्रॉपर्टी फ़ाइल, सेवा का नाम, डिफ़ॉल्ट पोर्ट, और टीएलएस सर्टिफ़िकेट फ़ॉर्मैट की जगह लेता है. अपनी प्रॉपर्टी माइग्रेट करने से पहले, ऑटोमेशन स्क्रिप्ट, फ़ायरवॉल के नियमों, और टीएलएस फ़ाइलों को अपडेट करने के लिए, यहां दी गई टेबल देखें:

New Edge यूज़र इंटरफ़ेस (यूआई) के लिए प्रॉपर्टी सेट करना

/opt/apigee/customer/application/management-ui.properties में, New Edge यूज़र इंटरफ़ेस (यूआई) की कॉन्फ़िगरेशन प्रॉपर्टी सेट करें और edge-management-ui सेवा को रीस्टार्ट करें, ताकि आपके बदलाव लागू हो सकें.

New Edge यूज़र इंटरफ़ेस (यूआई) के लिए कोई प्रॉपर्टी सेट करने के लिए:

1. management-ui.properties फ़ाइल को किसी एडिटर में खोलें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं:

   vi /opt/apigee/customer/application/management-ui.properties
   

2. प्रॉपर्टी सेट करें. उदाहरण के लिए:

   conf_uebe_disableGeoMap=true

3. बदलावों को सेव करें.
4. पक्का करें कि फ़ाइल का मालिकाना हक apigee उपयोगकर्ता के पास हो:

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
   

5. New Edge यूज़र इंटरफ़ेस को रीस्टार्ट करें:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
   

New Edge यूज़र इंटरफ़ेस (यूआई) के लिए प्रॉपर्टी सेट करते समय, फ़ॉर्मैटिंग के इन नियमों का पालन करें:

• प्रॉपर्टी के नाम केस-सेंसिटिव होते हैं. उदाहरण के लिए, conf_uebe_disableGeoMap मान्य है, लेकिन conf_uebe_disablegeomap मान्य नहीं है.
• स्ट्रिंग वैल्यू को डबल कोटेशन मार्क में रखें, जैसे कि conf_uebe_branding_companyNameShort="My Company".
• बूलियन वैल्यू (true या false) या अंकों वाली वैल्यू को कोटेशन मार्क में न रखें. अगर किसी बूलियन या न्यूमेरिक वैल्यू को कोटेशन मार्क में रखा जाता है, तो New Edge यूज़र इंटरफ़ेस (यूआई) शुरू नहीं होता.

किसी प्रॉपर्टी की मौजूदा वैल्यू देखने के लिए, -search विकल्प का इस्तेमाल करें. उदाहरण के लिए:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui \
  configure -search conf_uebe_disableGeoMap

क्लासिक यूज़र इंटरफ़ेस (यूआई) की प्रॉपर्टी को नए Edge यूज़र इंटरफ़ेस (यूआई) पर मैप करना

नीचे दी गई टेबल में, ui.properties में मौजूद क्लासिक यूज़र इंटरफ़ेस (यूआई) की हर प्रॉपर्टी को management-ui.properties में मौजूद, नए Edge यूज़र इंटरफ़ेस (यूआई) की मिलती-जुलती प्रॉपर्टी के साथ मैप किया गया है. डिफ़ॉल्ट कॉलम में, New Edge यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट वैल्यू दिखती है.

सुविधा की प्रॉपर्टी कॉन्फ़िगर करना

क्लासिक यूज़र इंटरफ़ेस (यूआई) के फ़ीचर फ़्लैग को management-ui.properties में मौजूद, conf_uebe_* की संबंधित प्रॉपर्टी से मैप करें:

सेशन और टीएलएस प्रॉपर्टी कॉन्फ़िगर करना

Classic UI के सेशन टाइमआउट और टीएलएस प्रॉपर्टी को management-ui.properties में, New Edge UI की मिलती-जुलती प्रॉपर्टी के साथ मैप करें:

ईमेल की प्रॉपर्टी और टेंप्लेट कॉन्फ़िगर करना

Classic UI में ईमेल भेजने वाले, विषय, ब्रैंडिंग, होस्ट यूआरएल, और लिंक की समयसीमा खत्म होने की प्रॉपर्टी को New Edge UI में मैप करें:

Edge के नए यूज़र इंटरफ़ेस (यूआई) में, पहले से मौजूद ईमेल टेंप्लेट इस्तेमाल किए जाते हैं. क्लासिक यूज़र इंटरफ़ेस (यूआई) के लिए कस्टमाइज़ किए गए टेंप्लेट इस्तेमाल करने के लिए:

1. /opt/apigee/edge-management-ui/email-templates डायरेक्ट्री बनाएं.
2. अपनी पसंद के मुताबिक बनाई गई password-reset.html, user-added-existing.html, और user-added-new.html फ़ाइलों को उस बैकअप डायरेक्ट्री से कॉपी करें जिसे आपने अपडेट करने से पहले बनाया था (उदाहरण के लिए, /opt/apigee/customer/backup/) से /opt/apigee/edge-management-ui/email-templates तक. टेंप्लेट फ़ाइल के नाम और प्लेसहोल्डर, क्लासिक यूज़र इंटरफ़ेस (यूआई) की तरह ही होते हैं.
3. पक्का करें कि डायरेक्ट्री और फ़ाइलों का मालिकाना हक, apigee उपयोगकर्ता के पास हो.
4. New Edge यूज़र इंटरफ़ेस को रीस्टार्ट करें.

ज़्यादा जानकारी के लिए, Edge ईमेल टेंप्लेट को पसंद के मुताबिक बनाना लेख पढ़ें.

अपने-आप जनरेट होने वाले पासवर्ड की प्रॉपर्टी कॉन्फ़िगर करना

क्लासिक यूज़र इंटरफ़ेस (यूआई) में अपने-आप जनरेट होने वाली पासवर्ड प्रॉपर्टी को New Edge यूज़र इंटरफ़ेस (यूआई) में मैप करें:

मैनेजमेंट सर्वर के कनेक्शन और शेयर किए गए सीक्रेट की प्रॉपर्टी कॉन्फ़िगर करना

क्लासिक यूज़र इंटरफ़ेस (यूआई) मैनेजमेंट सर्वर कनेक्शन, क्रेडेंशियल, और ऐप्लिकेशन की सीक्रेट प्रॉपर्टी को नए Edge यूज़र इंटरफ़ेस (यूआई) पर मैप करें:

क्लासिक यूज़र इंटरफ़ेस (यूआई) की उन प्रॉपर्टी को हटाएं जिनके लिए किसी कार्रवाई की ज़रूरत नहीं है

क्लासिक यूज़र इंटरफ़ेस (यूआई) की इन प्रॉपर्टी के बराबर, New Edge यूज़र इंटरफ़ेस (यूआई) में कोई प्रॉपर्टी नहीं है. इसकी वजह यह है कि यह सुविधा हमेशा चालू रहती है. इन प्रॉपर्टी को management-ui.properties में शामिल न करें. साथ ही, इन्हें अपने-आप कॉन्फ़िगर होने वाली किसी भी स्क्रिप्ट से हटाएं:

Classic UI की ऐसी प्रॉपर्टी हटाएं जिनका इस्तेमाल नहीं किया जा सकता

क्लासिक यूज़र इंटरफ़ेस (यूआई) की ये प्रॉपर्टी काम नहीं करती हैं. साथ ही, नए Edge यूज़र इंटरफ़ेस (यूआई) में इनके जैसी कोई प्रॉपर्टी नहीं है. इन प्रॉपर्टी को management-ui.properties में शामिल न करें. साथ ही, इन्हें अपने-आप कॉन्फ़िगरेशन करने वाली किसी भी स्क्रिप्ट से हटाएं:

माइग्रेशन का उदाहरण देखें

यहां दिए गए उदाहरण में, क्लासिक यूज़र इंटरफ़ेस (यूआई) की ui.properties फ़ाइल की तुलना, New Edge यूज़र इंटरफ़ेस (यूआई) की management-ui.properties फ़ाइल से की गई है.

क्लासिक यूज़र इंटरफ़ेस (यूआई), /opt/apigee/customer/application/ui.properties:

conf_apigee_apigee.feature.disablegeomap=false
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
conf_application_session.maxage="1d"
conf_apigee-base_apigee.emails.passwordreset.subject="Reset your My Company password"
conf_apigee_apigee.branding.companynameshort="My Company"
conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"

Edge का नया यूज़र इंटरफ़ेस (यूआई), /opt/apigee/customer/application/management-ui.properties:

conf_uebe_disableGeoMap=false
conf_uebe_trace_for_internal_addresses=true
conf_uebe_authsessiontimeout=24
conf_apigee_apigee.emails.passwordReset.subject="Reset your My Company password"
conf_uebe_branding_companyNameShort="My Company"
conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"

ध्यान दें कि बूलियन वैल्यू true को कोटेशन मार्क में नहीं रखा गया है. साथ ही, सेशन खत्म होने का समय 1d को 24 से बदल दिया गया है.

फ़ाइल सेव करने के बाद, New Edge UI को फिर से चालू करें:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

खास जानकारी वाली चेकलिस्ट

Apigee Edge for Private Cloud 4.54.00 में, नए Edge यूज़र इंटरफ़ेस (यूआई) पर माइग्रेशन की प्रोसेस पूरी करने के लिए, यहां दी गई चेकलिस्ट का इस्तेमाल करें:

1. अपग्रेड करने से पहले, /opt/apigee/edge-ui/email-templates से /opt/apigee/customer/application/ui.properties और पसंद के मुताबिक बनाए गए किसी भी ईमेल टेंप्लेट का बैक अप लें.
2. /opt/apigee/customer/application/management-ui.properties में मैप की गई प्रॉपर्टी जोड़ें. इसके लिए, बूलियन या संख्यात्मक वैल्यू न डालें. साथ ही, Classic UI में काम न करने वाली प्रॉपर्टी शामिल न करें.
3. अपनी बैकअप डायरेक्ट्री से /opt/apigee/edge-management-ui/email-templates में, पसंद के मुताबिक बनाए गए ईमेल टेंप्लेट कॉपी करें.
4. सिस्टम एडमिन के क्रेडेंशियल को फिर से एन्क्रिप्ट (सुरक्षित) करें अगर आपने conf_uebe_mgmtCredential सेट किया है, तो ./bin/management-ui --encrypt का इस्तेमाल करें.
5. फ़ाइल का मालिकाना हक apigee:apigee पर सेट करें और edge-management-ui को रीस्टार्ट करें.