संगठन को शामिल करना

Edge for Private Cloud v4.19.01

किसी संगठन को शामिल करने के लिए, आपको शामिल करने से जुड़ी कॉन्फ़िगरेशन फ़ाइल बनानी होगी. इसके बाद, उसे setup-org कमांड को पास करना होगा. इनमें से हर चरण के बारे में, आगे दिए गए सेक्शन में बताया गया है.

किसी संगठन को शामिल करने के लिए मैनेजमेंट एपीआई का इस्तेमाल करने के बारे में जानने के लिए, संगठन, एनवायरमेंट, और वर्चुअल होस्ट बनाना देखें.

ऑनबोर्डिंग कॉन्फ़िगरेशन फ़ाइल बनाना

इस सेक्शन में, setup-org की मदद से किसी संगठन को शामिल करने के लिए कॉन्फ़िगरेशन फ़ाइल का सैंपल शामिल है.

नीचे दिए गए उदाहरण को कॉपी करें और अपने संगठन के हिसाब से उसमें बदलाव करें:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator.
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name.
ENV_NAME=prod  # lowercase only

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host,
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001"

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.

# Specify the analytics group.
# AXGROUP=axgroup-001 # Default name is axgroup-001.

ध्यान दें:

  • VHOST_ALIAS के लिए, अगर आपके पास पहले से ही ऐसा डीएनएस रिकॉर्ड है जिसका इस्तेमाल वर्चुअल होस्ट को ऐक्सेस करने के लिए किया जाएगा, तो होस्ट का दूसरा नाम और पोर्ट डालें. हालांकि, पोर्ट डालना ज़रूरी नहीं है. उदाहरण के लिए, "myapi.example.com". अगर आपके पास अब तक कोई डीएनएस रिकॉर्ड नहीं है, तो राउटर के आईपी पते का इस्तेमाल किया जा सकता है.

    वर्चुअल होस्ट को कॉन्फ़िगर करने के तरीके के बारे में ज़्यादा जानने के लिए, वर्चुअल होस्ट सेट अप करना लेख पढ़ें.

  • टीएलएस/एसएसएल कॉन्फ़िगरेशन के लिए, कीस्टोर और ट्रस्टस्टोर देखें. साथ ही, JAR फ़ाइल बनाने और टीएलएस/एसएसएल कॉन्फ़िगर करने के अन्य पहलुओं के बारे में ज़्यादा जानने के लिए, निजी क्लाउड के लिए एपीआई के टीएलएस ऐक्सेस को कॉन्फ़िगर करना लेख पढ़ें.
  • वर्चुअल होस्ट कॉन्फ़िगर करने के बारे में ज़्यादा जानने के लिए, प्राइवेट क्लाउड के लिए एपीआई के TLS ऐक्सेस को कॉन्फ़िगर करना लेख पढ़ें.
  • एक ही नाम के दो संगठन नहीं बनाए जा सकते. ऐसे में, दूसरी बार क्रिएट करने की प्रोसेस पूरी नहीं हो पाएगी.

setup-org को चलाना

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

किसी संगठन को शामिल करते समय, setup-org स्क्रिप्ट ये काम करती है:

  • नया संगठन बनाता है.
  • एनवायरमेंट बनाता है.
  • एनवायरमेंट के लिए वर्चुअल होस्ट बनाता है.
  • चुने गए उपयोगकर्ता को संगठन के एडमिन के तौर पर सेट करता है. ध्यान रखें:
    • आप किसी मौजूदा उपयोगकर्ता का इस्तेमाल कर सकते हैं या संगठन के एडमिन के लिए एक नया उपयोगकर्ता खाता बना सकते हैं.
    • यह ज़रूरी नहीं है कि संगठन का एडमिन और सिस्टम एडमिन, दोनों एक ही व्यक्ति हों.
  • संगठन को "गेटकवे" पॉड से जोड़ता है. (यह डिफ़ॉल्ट सेटिंग है और इसे बदला नहीं जा सकता.)
  • सभी मैसेज प्रोसेसर के साथ एनवायरमेंट को जोड़ता है.
  • आंकड़े देखने की सुविधा चालू करता है.

setup-org को लागू करने के लिए:

  1. मैनेजमेंट सर्वर नोड पर apigee-provision इंस्टॉल करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. मैनेजमेंट सर्वर नोड पर setup-org स्क्रिप्ट चलाएं और उसे उस कॉन्फ़िगरेशन फ़ाइल पर ले जाएं जो आपने ऑनबोर्डिंग कॉन्फ़िगरेशन फ़ाइल बनाएं में बनाई थी: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता पढ़ सकता हो.

  3. पुष्टि करें कि आपने किसी संगठन को शामिल कर लिया है. ऐसा करने का एक तरीका यह है कि ब्राउज़र में इस यूआरएल का अनुरोध करके, यूज़र इंटरफ़ेस (यूआई) में लॉग इन करें: 
    http://IP_address:9000/login

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

    पुष्टि करने के अन्य चरणों के बारे में जानने के लिए, शामिल होने की पुष्टि करना लेख पढ़ें.

  4. अपना पहला प्रॉक्सी बनाएं!

शामिल होने की पुष्टि करना

शामिल होने की प्रोसेस पूरी होने के बाद, मैनेजमेंट सर्वर नोड पर ये curl कमांड जारी करके, सिस्टम के स्टेटस की पुष्टि करें:

  1. मैनेजमेंट सर्वर पर उपयोगकर्ता और संगठन की स्थिति देखने के लिए, ये कमांड चलाएं: 
    curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments
  2. नीचे दिया गया निर्देश चलाकर, आंकड़े देखें: 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. नोड 2 पर इन निर्देशों को लागू करके, PostgreSQL डेटाबेस की स्थिति की जांच करें (जैसा कि इंस्टॉलेशन टोपोलॉजी में दिखाया गया है): 
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    कमांड प्रॉम्प्ट पर, अपने संगठन के आंकड़ों की टेबल देखने के लिए यह कमांड डालें:

    \d analytics."org_name.env_name.fact"

    psql से बाहर निकलने के लिए, इस कमांड का इस्तेमाल करें:

    \q
  4. वेब ब्राउज़र का इस्तेमाल करके, Apigee Edge के यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करें. याद रखें कि आपने इंस्टॉलेशन के आखिर में, Admin console का यूआरएल पहले ही नोट कर लिया था.
    1. अपना पसंदीदा ब्राउज़र लॉन्च करें और Edge यूज़र इंटरफ़ेस (यूआई) का यूआरएल डालें. यह इस तरह दिखता है, जहां आईपी पता नोड 1 के लिए है (जैसा कि इंस्टॉलेशन टॉपोलॉजी में दिखाया गया है) या जिस नोड पर आपने वैकल्पिक कॉन्फ़िगरेशन के लिए यूज़र इंटरफ़ेस इंस्टॉल किया है: 
      http://192.168.56.111:9000/login

      यूज़र इंटरफ़ेस (यूआई) में 9000 पोर्ट नंबर का इस्तेमाल किया जाता है.

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

      http://localhost:9000/login

    2. कंसोल के लॉगिन पेज पर, Apigee सिस्टम के एडमिन का उपयोगकर्ता नाम/पासवर्ड डालें.
  5. Apigee के नए उपयोगकर्ता खाते के लिए साइन अप करें और लॉगिन करने के लिए, नए उपयोगकर्ता क्रेडेंशियल का इस्तेमाल करें. Console के साइन इन पेज पर, साइन इन करें बटन पर क्लिक करें.

    इसके बाद, ब्राउज़र http://192.168.56.111:9000/platform/#/org_name/ पर रीडायरेक्ट हो जाता है और एक डैशबोर्ड खुल जाता है. इसकी मदद से, आपने जो संगठन बनाया है उसे कॉन्फ़िगर किया जा सकता है. ऐसा तब ही किया जा सकता है, जब आपने Apigee के एडमिन क्रेडेंशियल का इस्तेमाल करके लॉग इन किया हो.

अपना पहला प्रॉक्सी बनाएं

किसी नए संगठन को शामिल करने और पुष्टि करने के बाद कि शामिल करने की प्रोसेस पूरी हो गई है, अब आपके पास अपनी पहली प्रॉक्सी बनाने का विकल्प है. ज़्यादा जानकारी के लिए, अपना पहला एपीआई प्रॉक्सी बनाना लेख पढ़ें.

यहां कुछ अन्य संसाधन दिए गए हैं जिनसे आपको मदद मिल सकती है: