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

Edge for Private Cloud v4.19.01

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

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

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

इस सेक्शन में, 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". अगर आपके पास अब तक डीएनएस रिकॉर्ड नहीं है, तो राऊटर के आईपी पते का इस्तेमाल किया जा सकता है.

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

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

सेटअप-संगठन चलाएं

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

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

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

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 के यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करना. याद रखें कि आपने इंस्टॉलेशन के आखिर में मैनेजमेंट कंसोल का यूआरएल नोट कर लिया है.
    1. अपना पसंदीदा ब्राउज़र लॉन्च करें और Edge यूज़र इंटरफ़ेस (यूआई) का यूआरएल डालें. यह नीचे दिए गए तरीके जैसा दिखता है, जहां आईपी पता नोड 1 (जैसा कि इंस्टॉलेशन टोपोलॉजी में दिखाया गया है) के लिए है या उस नोड पर भी है जिस पर आपने वैकल्पिक कॉन्फ़िगरेशन के लिए यूज़र इंटरफ़ेस (यूआई) इंस्टॉल किया है:
      http://192.168.56.111:9000/login

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

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

      http://localhost:9000/login

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

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

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

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

आपके लिए मददगार अन्य संसाधन शामिल हो सकते हैं: