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

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 फ़ाइल बनाने और टीएलएस/एसएसएल को कॉन्फ़िगर करने के अन्य पहलुओं के बारे में ज़्यादा जानकारी मिलेगी.
• वर्चुअल होस्ट को कॉन्फ़िगर करने के बारे में ज़्यादा जानकारी के लिए, प्राइवेट क्लाउड के लिए एपीआई में टीएलएस ऐक्सेस को कॉन्फ़िगर करना लेख पढ़ें.
• एक ही नाम से दो संगठन नहीं बनाए जा सकते. ऐसे में, दूसरी बार किया गया अनुरोध पूरा नहीं होगा.

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 यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करें. याद रखें कि आपने इंस्टॉलेशन के आखिर में, मैनेजमेंट कंसोल का यूआरएल पहले ही नोट कर लिया था.
   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 एडमिन क्रेडेंशियल का इस्तेमाल करके लॉग इन करना होगा.

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

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

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

• सैंपल की सूची
• मॉक टारगेट RESTful API, जिनका इस्तेमाल एपीआई बनाने के अपने प्रयोगों में किया जा सकता है