नया एज अनुभव इंस्टॉल करना

Edge for Private Cloud v4.19.01

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

प्राइवेट क्लाउड इंस्टॉलेशन के लिए, Edge में New Edge इस्तेमाल करने के लिए, आपको ये काम करने होंगे:

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

New Edge के बारे में ज़्यादा जानने के लिए, यहां जाएं The New Edge experience प्राइवेट क्लाउड.

इंस्टॉल करने के बारे में खास जानकारी

प्राइवेट क्लाउड के लिए Edge इंस्टॉल करने के लिए, आपको इंस्टॉल करने की दो अलग-अलग प्रोसेस करता है:

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

इंस्टॉल करने से जुड़ी ज़रूरी शर्तें

• नया Edge इंस्टॉल करने से पहले, आपको Edge पर एसएएमएल को चालू करना होगा. द न्यू एज यह वर्शन, एसएएमएल के पुष्टि करने के तरीके के तौर पर सिर्फ़ इसके साथ काम करता है.

  Edge पर एसएएमएल को चालू करने के बारे में जानकारी के लिए, देखें प्राइवेट क्लाउड के लिए Edge पर एसएएमएल काम करती है.

• New Edge का अनुभव सिर्फ़ TLS v1.2 के साथ काम करता है. TLS पर एसएएमएल आईडीपी से कनेक्ट किए जाने की वजह से, इसलिए, आपके एसएएमएल आईडीपी को TLS v1.2 के साथ काम करना चाहिए.

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

  नोड को नीचे दी गई ज़रूरी शर्तें पूरी करनी होंगी:

  • JAVA 1.8
  • 4 जीबी रैम
  • 2-कोर
  • डिस्क में 60 जीबी की जगह
  • आपको पहले apigee-setup सुविधा का 4.19.01 वर्शन इंस्टॉल करना होगा नोड, जैसा कि Edge इंस्टॉल करें apigee-setup उपयोगिता.
  • पोर्ट 3001 खुला होना चाहिए. यह New Edge इस्तेमाल करने के अनुरोध के लिए इस्तेमाल किया जाने वाला डिफ़ॉल्ट पोर्ट है. नीचे दी गई प्रॉपर्टी का इस्तेमाल करके पोर्ट को बदलने के लिए, पक्का करें कि पोर्ट खुला हो.

नया वर्शन इंस्टॉल करने से पहले ध्यान देने वाली बातें Edge का अनुभव

जैसा कि ऊपर ज़रूरी शर्तों में बताया गया है, New Edge इस्तेमाल करने के लिए एसएएमएल को चालू करना ज़रूरी है एज पर हैं. इसका मतलब है कि उपयोगकर्ता की पुष्टि करने के तरीके को एसएएमएल आईडीपी से कंट्रोल किया जाता है, जहां एसएएमएल को कॉन्फ़िगर किया जाता है आईडीपी (IdP) की मदद से, यूज़र आईडी के तौर पर ईमेल पतों का इस्तेमाल किया जा सकता है. इसलिए, New Edge इस्तेमाल करने वाले सभी लोगों को एसएएमएल आईडीपी (IdP) में रजिस्टर किया गया है.

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

• Edge पर और क्लासिक यूज़र इंटरफ़ेस (यूआई) और New Edge, दोनों पर एसएएमएल सहायता को चालू करें.

  इस स्थिति में, सभी क्लासिक यूज़र इंटरफ़ेस (यूआई) और New Edge के उपयोगकर्ताओं को एसएएमएल आईडीपी (IdP) में रजिस्टर किया जाता है. एसएएमएल आईडीपी में नए उपयोगकर्ता जोड़ने के बारे में जानकारी के लिए, यहां देखें Edge के नए उपयोगकर्ताओं को रजिस्टर करें.

• Edge पर एसएएमएल से जुड़ी सहायता चालू करें, लेकिन बुनियादी पुष्टि करने की सुविधा चालू रखें. The New Edge गेम, एसएएमएल और क्लासिक यूज़र इंटरफ़ेस (यूआई), अब भी पुष्टि करने के बुनियादी तरीके का इस्तेमाल करते हैं.

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

  हालांकि, क्लासिक यूज़र इंटरफ़ेस (यूआई) का उपयोगकर्ता, New Edge में लॉग इन नहीं कर सकता, जब तक कि आप उसे जोड़ न दें उपयोगकर्ता को एसएएमएल आईडीपी (IdP) से लिंक करें, जैसा कि नया Edge रजिस्टर करें' में बताया गया है उपयोगकर्ता.

पिछली रिलीज़ से इंस्टॉलेशन कॉन्फ़िगरेशन में बदलाव

New Edge वर्शन के बीटा रिलीज़ के बाद, इंस्टॉल करने की प्रक्रिया में किए गए इन बदलावों के बारे में जानकारी रखें.

Edge 4.18.05 से इंस्टॉल करने का कॉन्फ़िगरेशन बदल गया है

New Edge के Edge 4.19.01 वर्शन की रिलीज़ में, नीचे दिए गए बदलाव होते हैं कॉन्फ़िगरेशन फ़ाइल देखें:

MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS

Edge 4.18.01 से इंस्टॉल करने का कॉन्फ़िगरेशन बदल गया है

New Edge के Edge 4.19.01 वर्शन की रिलीज़ में, नीचे दिए गए बदलाव होते हैं कॉन्फ़िगरेशन फ़ाइल देखें:

# Shoehorn UI configurations.
SHOEHORN_SCHEME
SHOEHORN_IP
SHOEHORN_PORT

# Classic UI configurations.
CLASSIC_UI_SCHEME
CLASSIC_UI_IP
CLASSIC_UI_PORT

# Information about Edge SSO module.
MANAGEMENT_UI_SKIP_VERIFY

ROUTES_SHOEHORN
ROUTES_CLASSICUI

MANAGEMENT_UI_USE_HTTPS

MANAGEMENT_UI_SCHEME

इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल

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

कॉन्फ़िगरेशन फ़ाइल का एक उदाहरण नीचे दिखाया गया है:

# IP of the Edge Management Server.
# This node also hosts the Edge SSO module and the current, or classic, Edge UI.
IP1=11.111.111.111

# IP of the New Edge experience node.
IP2=22.222.222.222

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge experience configuration.
#

# Enable the New Edge experience.
EDGEUI_ENABLE_UNIFIED_UI=y
# Specify IP and port for the New Edge experience.
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
# Specify a Private Cloud deployment.
MANAGEMENT_UI_APP_ENV=OPDK
# Disable TLS on the New Edge experience.
MANAGEMENT_UI_SCHEME=http

# Location of New Edge experience.
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=CHANGE_TO_YOUR_SECRET
# Duration of CSRF token.
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
# Defaults to 8760 hours, or 365 days.
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=8760

# SSO configuration for the New Edge experience.
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y
MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=secret111

#
# Shoehorn UI configuration
#
# Set to http even if you enable TLS on the New Edge experience.
SHOEHORN_SCHEME=http
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000

#
# Edge Classic UI configuration.
# Some settings are for the classic UI,
# but are still required to configure the New Edge experience.
#

# These settings assume that classic UI is installed on the Management Server.
CLASSIC_UI_IP=$MSIP
CLASSIC_UI_PORT=9000
CLASSIC_UI_SCHEME=http
EDGEUI_PUBLIC_URIS=$CLASSIC_UI_SCHEME://$CLASSIC_UI_IP:$CLASSIC_UI_PORT

# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

# Enable SSO.
EDGEUI_SSO_ENABLED=y

# The name of the OAuth client used to connect to apigee-sso. 
# The default client name is edgeui.
# Apigee recommends that you use the same settings as you used
# when enabling SAML on the classic Edge UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars. 
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Information about Edge SSO module.
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Edge SSO module.
# If Edge SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
SSO_PUBLIC_URL_SCHEME=http
# MANAGEMENT_UI_SKIP_VERIFY=y
# SSO admin credentials as set when you installed Edge SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

#
# Required SMTP information.
#

SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company myco@company.com"

बेस Edge यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करें (शूहॉर्न)

नया इंस्टॉल करने से पहले आपको बेस एज यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करना होगा, जिसे शूहॉर्न कहा जाता है Edge का अनुभव.

बुनियादी यूज़र इंटरफ़ेस (यूआई) को इंस्टॉल करने के लिए:

1. नोड पर apigee-setup सुविधा का 4.19.01 वर्शन इस तरह इंस्टॉल करें इसकी जानकारी Edge apigee-setup इंस्टॉल करने के बारे में दी गई है उपयोगिता.
2. साफ़ स्वादिष्ट:

   sudo yum clean all

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
3. ऊपर बताए गए तरीके से कॉन्फ़िगरेशन फ़ाइल बनाएं और पक्का करें कि इसका मालिकाना हक "apigee" के पास है उपयोगकर्ता:

   chown apigee:apigee configFile

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

   जहां configFile, ऊपर बताई गई कॉन्फ़िगरेशन फ़ाइल है इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल.

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

   /opt/apigee/apigee-service/bin/apigee-service edge-ui install

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
6. Edge यूज़र इंटरफ़ेस (यूआई) को कॉन्फ़िगर करें:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
7. Edge यूज़र इंटरफ़ेस (यूआई) पर एसएएमएल को चालू करें:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

New Edge इंस्टॉल करें

बेस एज यूआई को इंस्टॉल करने के बाद, नए एज को इंस्टॉल और कॉन्फ़िगर किया जा सकता है अनुभव.

New Edge इंस्टॉल करने के लिए:

1. New Edge इंस्टॉल करें:

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

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
2. edge-management-ui डायरेक्ट्री में बदलें:

   cd /opt/apigee/edge-management-ui

3. New Edge के अनुभव को कॉन्फ़िगर करें:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

   जहां configFile, ऊपर बताई गई कॉन्फ़िगरेशन फ़ाइल है इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल.

4. नए Edge पर एसएएमएल को चालू करें:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
5. यहां दिए गए यूआरएल को ब्राउज़र में खोलकर, New Edge पर लॉग इन करें:

   http://newEdgeExperienceIP:3001

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

   जहां newEdgeExperienceIP, नोड होस्टिंग का आईपी पता है The New Edge का अनुभव कर सकते हैं. आपको एसएएमएल के क्रेडेंशियल डालने के लिए कहा जाएगा. दर्ज करने के बाद क्रेडेंशियल कॉन्फ़िगर करते हैं, तो नया एज अनुभव दिखाई देता है.

6. द न्यू प्राइवेट क्लाउड के लिए Edge Experience देखें, ताकि आपको ज़्यादा जानकारी मिल सके. इसमें, New Edge इस्तेमाल करने के बारे में जानकारी.

New Edge के अनुभव को अनइंस्टॉल करें

New Edge वर्शन अनइंस्टॉल करने के लिए:

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

बेस एज यूज़र इंटरफ़ेस (यूआई) को अनइंस्टॉल करने के लिए (शूहॉर्न):

/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

नोड से Edge को पूरी तरह से हटाने के लिए:

1. मशीन पर चल रही सभी Edge सेवाओं को बंद करें:

   /opt/apigee/apigee-service/bin/apigee-all stop

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
2. लज़ीज़ कैश मेमोरी मिटाएं:

   sudo yum clean all

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
3. सभी Apigee आरपीएम हटाएं:

   sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
4. इंस्टॉलेशन रूट डायरेक्ट्री हटाएं:

   sudo rm -rf /opt/apigee

   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है