7-होस्ट और 10-होस्ट वाला एपीआई BaaS इंस्टॉल करना

Edge for Private Cloud v. 4.16.05

लोड बैलेंसर का इस्तेमाल करना

API BaaS का प्रोडक्शन इंस्टॉलेशन, एपीआई BaaS पोर्टल नोड और API BaaS स्टैक नोड के बीच लोड बैलेंसर का इस्तेमाल करता है. पोर्टल को कॉन्फ़िगर करते समय, लोड बैलेंसर का आईपी पता या डीएनएस नाम तय किया जाता है, न कि स्टैक नोड का.

लोड बैलेंसर के विकल्प के तौर पर, राउंड-रॉबिन डीएनएस का इस्तेमाल करें. इस स्थिति में, आपको BaaS स्टैक आईपी पतों से जुड़े एक से ज़्यादा A रिकॉर्ड वाली डीएनएस एंट्री बनानी होगी. डीएनएस लुकअप के दौरान, डीएनएस सर्वर अपने-आप राउंड रॉबिन तरीके में 'A रिकॉर्ड वैल्यू' दिखाता है.

कैसेंड्रा से कनेक्ट हो रहा है

BaaS इंस्टॉल करते समय, BaaS और Edge को एक ही कैसंड्रा क्लस्टर से कनेक्ट किया जा सकता है या BaaS के लिए अलग-अलग कैसांद्रा क्लस्टर बनाया जा सकता है. छोटे BaaS इंस्टॉलेशन का मतलब है कि जिन पर ट्रैफ़िक कम है, उनमें अक्सर Edge के साथ कैसेंड्रा क्लस्टर होता है.

क्षमता और उपलब्धता की ज़्यादा क्षमता के लिए या कैसेंद्रा क्लस्टर को अलग-अलग नेटवर्क ज़ोन में अलग करने के लिए, Apigee का सुझाव है कि आप अलग-अलग कैसेंड्रा क्लस्टर इस्तेमाल करें. अगर BaaS पर ज़्यादा ट्रैफ़िक लोड हो रहा है, तो अलग-अलग क्लस्टर की परफ़ॉर्मेंस को बेहतर बनाया जा सकता है.

तारीख सिंक्रनाइज़ेशन

सभी सर्वर पर सिंक किए गए तारीख/समय का होना ज़रूरी है. अगर पहले से कॉन्फ़िगर नहीं किया गया है, तो 'ntpdate' यूटिलिटी इस काम को पूरा कर सकती है. इससे यह पुष्टि की जाती है कि सर्वर सही समय पर सिंक हुए हैं या नहीं. यूटिलिटी इंस्टॉल करने के लिए, “yum install ntp” का इस्तेमाल किया जा सकता है.

टॉमकैट की सुरक्षा

API BaaS इंस्टॉलर, सभी API BaaS Stack नोड पर Apache Tomcat सर्वर भी इंस्टॉल करता है. इसमें Tomcat एडमिन यूज़र इंटरफ़ेस भी शामिल है. इंस्टॉलर, एडमिन के डिफ़ॉल्ट क्रेडेंशियल में कोई बदलाव नहीं करता है.

अगर ज़रूरी हो, तो Tomcat को सुरक्षित करने के लिए, इन क्रेडेंशियल में बदलाव किया जा सकता है. ज़्यादा जानकारी के लिए, देखें:

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

किसी नोड पर apigee-setup यूटिलिटी इंस्टॉल करने के बाद, उस यूटिलिटी का इस्तेमाल नोड पर एक या उससे ज़्यादा BaaS कॉम्पोनेंट इंस्टॉल करने के लिए करें. apigee-setup यूटिलिटी इस तरह का है:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

apigee-setup यूटिलिटी में कॉन्फ़िगरेशन फ़ाइल पास करें. इसमें इंस्टॉलेशन के बारे में जानकारी दी गई है. अगर कॉन्फ़िगरेशन फ़ाइल में कोई ज़रूरी जानकारी मौजूद नहीं है, तो apigee-setup आपको कमांड लाइन में इसे डालने का अनुरोध करेगा.

सिर्फ़ यह ज़रूरी है कि "apigee" उपयोगकर्ता कॉन्फ़िगरेशन फ़ाइल को ऐक्सेस कर सके या उसे पढ़ सके. उदाहरण के लिए, फ़ाइल को नोड पर /tmp डायरेक्ट्री में रखें.

उदाहरण के लिए, API BaaS Stack को इंस्टॉल करने के लिए, नीचे दिए गए कमांड का इस्तेमाल करें:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p b -f myConfig

Apigee setup.sh यूटिलिटी, API BaaS कॉम्पोनेंट को इंस्टॉल करने के कई विकल्पों के साथ काम करती है. नीचे दिए गए निर्देशों में स्टैंडअलोन विकल्पों (c, e, b, और p) का इस्तेमाल किया गया है. हालांकि, नोड कॉन्फ़िगरेशन के आधार पर अलग-अलग विकल्पों का इस्तेमाल किया जा सकता है:

विकल्प

Description

e

सिर्फ़ ElasticSearch इंस्टॉल करें.

b

सिर्फ़ API BaaS Stack इंस्टॉल करें, जिससे Tomcat भी इंस्टॉल होता है.

p

सिर्फ़ API BaaS पोर्टल इंस्टॉल करें, जो वेब सर्वर के तौर पर इस्तेमाल किए जाने के लिए Ngnx राऊटर भी इंस्टॉल करता है.

c

सिर्फ़ Cassandra को इंस्टॉल करें.

eb

नोड पर ElasticSearch, API BaaS Stack, और Tomcat इंस्टॉल करें.

ईबीपी

ElasticSearch, API BaaS Portal, API BaaS Stack, और Tomcat इंस्टॉल करें. यह पोर्टल इतना हल्का है कि इसके लिए किसी भी अतिरिक्त संसाधन की ज़रूरत नहीं होती.

एसा

एपीआई के सभी कॉम्पोनेंट को एक ही नोड (Cassandra, Elasticsearch, API BaaS Stack, और API BaaS पोर्टल) पर इंस्टॉल करें. इस विकल्प का इस्तेमाल सिर्फ़ डेवलपमेंट और टेस्टिंग के लिए करें. प्रोडक्शन के लिए नहीं.

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

नीचे 10-नोड API BaaS इंस्टॉलेशन के लिए, साइलेंट कॉन्फ़िगरेशन फ़ाइल का एक उदाहरण दिया गया है. अपने कॉन्फ़िगरेशन के लिए, इस फ़ाइल में ज़रूरत के हिसाब से बदलाव करें. इस फ़ाइल को शामिल करने के लिए, setup.sh के लिए -f विकल्प का इस्तेमाल करें.

# Specify IP address or DNS name of node.
IP1=192.168.1.1   # ElasticSearch
IP2=192.168.1.2   # ElasticSearch
IP3=192.168.1.3   # ElasticSearch
IP4=192.168.1.4   # API BaaS Stack
IP5=192.168.1.5   # API BaaS Stack
IP6=192.168.1.6   # API BaaS Stack
IP7=192.168.1.7   # API BaaS Portal
IP8=192.168.1.8   # Cassandra (shared with Edge or standalone)
IP9=192.168.1.9   # Cassandra (shared with Edge or standalone)
IP10=192.168.1.10  # Cassandra (shared with Edge or standalone)

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Define the API BaaS administrator account.  
AS_ADMIN="superuser"    # User name - default is "superuser".
AS_ADMIN_EMAIL=stackAdmin@email.com
AS_PASSWD=stackAdminPWrod

# Only if you are installing Cassandra.
# Specify Cassandra configuration information.
# Must use IP addresses for CASS_HOSTS, not DNS names.
# CASS_HOSTS="$IP8:1,1 $IP9:1,1 $IP10:1,1"

# If connecting to existing Cassandra nodes, 
# specify Cassandra IPs.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP8 $IP9 $IP10"

# Cassandra uname/pword.
# Even if Cassandra authentication is disabled,
# you must still pass values for these properties.
CASS_USERNAME=cassandra    # Default value
CASS_PASSWORD=cassandra    # Default value

# Specify BaaS Cassandra connection information.
# Specify the data center name.
BAAS_CASS_LOCALDC=dc-1    # Default is dc-1.

# Replication is in the form "dataCenterName:#CassandraNodes". 
# For example, for dc-1 with three Cassandra nodes, it is dc-1:3.
BAAS_CASS_REPLICATION=dc-1:3

# ElasticSearch IPs or DNS names, separated by spaces.
ES_HOSTS="$IP1 $IP2 $IP3"

# API BaaS Stack information.
# Default cluster name is "apigee_baas"
BAAS_USERGRID_CLUSTERNAME="apigee_baas" 

# URL and port of the load balancer for the API BaaS Stack nodes, 
# or IP/DNS and port 8080 of a single Stack node with no load balancer.
BAAS_USERGRID_URL=http://myloadbalancer:8443

# API BaaS Portal information.
# URL and port number of load balancer, if there is one in front of the Portal,
# or the URL and port of the Portal node.  
BAAS_PORTAL_URL="http://$IP7:9000"

# Portal port. Default value is 9000.
BAAS_PORTAL_LISTEN_PORT=9000 

# SMTP information. BaaS requires an SMTP server.
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y

इस टेबल में इन प्रॉपर्टी के बारे में ज़्यादा जानकारी दी गई है:

प्रॉपर्टी

ध्यान दें

CASS_HOSTS

अगर आपको Cassandra इंस्टॉल करना है, तो Cassandra नोड के आईपी पते (डीएनएस नाम नहीं) की जानकारी दें. साथ ही, “:dc,ra" मॉडिफ़ायर शामिल करें, जो कैसंड्रा नोड के डेटा सेंटर और रैक की जानकारी देता है.

उदाहरण के लिए, '192.168.124.201:1, 1 = डेटासेंटर 1 और रैक/उपलब्धता ज़ोन 1 और '192.168.124.204:2,1 = डेटासेंटर 2 और रैक/उपलब्धता ज़ोन 1.

CASS_USERNAME
CASS_पासवर्ड

कैसेंड्रा उपयोगकर्ता नाम और पासवर्ड.

अगर Cassandra की पुष्टि करने की सुविधा बंद है, तो भी आपको ये वैल्यू पास करनी होंगी. हालांकि, इन वैल्यू को अनदेखा कर दिया जाता है.

BAAS_CASS_LOCALDC

क्षेत्र के नाम dc-# के रूप में होने चाहिए, जहाँ # एक पूर्णांक मान से संबंधित होता है.

उदाहरण के लिए, dc-1, dc-2 वगैरह. अगर आपको Edge की मदद से इंस्टॉल किए गए Cassandra क्लस्टर से कनेक्ट किया जा रहा है, तो Edge के सिस्टम एडमिन से यह वैल्यू मांगी जा सकती है. Edge के सिंगल डेटा सेंटर को इंस्टॉल करने में, डिफ़ॉल्ट वैल्यू dc-1 होती है.

अगर आपने API BaaS को इंस्टॉल करने के हिस्से के तौर पर Cassandra को इंस्टॉल किया था, तो Cassandra को इंस्टॉल करने के दौरान आपने Cassandra के आईपी पतों में “:dc,ra” मॉडिफ़ायर जोड़ा था. पहली वैल्यू "dc" डेटा सेंटर का नंबर है. डेटा सेंटर का नाम स्ट्रिंग "dc-" है, जिसमें डेटा सेंटर नंबर सफ़िक्स के तौर पर शामिल है.

BAAS_CASS_REPLICATION

इसका फ़ॉर्मैट "dataCenterName:#CassandraNodes" है. उदाहरण के लिए, तीन कैसेंड्रा नोड वाले dc-1 के लिए, यह dc-1:3 है.

BAAS_USERGRID_URL

प्रोडक्शन एनवायरमेंट में, यह लोड बैलेंसर का यूआरएल और पोर्ट होता है. यह एपीआई BaaS स्टैक नोड के सामने इस फ़ॉर्मैट में होता है:

http://myStackLoadBalancer:8443

टेस्टिंग या डेवलपमेंट एनवायरमेंट में, आपके पास सिर्फ़ एक API BaaS स्टैक नोड होता है. यह इस तरह से एपीआई BaaS स्टैक नोड का यूआरएल और पोर्ट नंबर हो सकता है:

http://stackIPorDNS:8080

API BaaS Stack सर्वर का पोर्ट नंबर 8080 है.

BAAS_PORTAL_URL

लोड बैलेंसर का यूआरएल और पोर्ट नंबर, अगर पोर्टल के सामने कोई है, तो इस फ़ॉर्म में:

http://myPortalLoadBalancer:8443

अगर कोई लोड बैलेंसर नहीं है, तो इस फ़ॉर्म में पोर्टल नोड का यूआरएल और पोर्ट नंबर इस तरह से दिखेगा:

http://myPortalLoadBalancer:8443

, डिफ़ॉल्ट तौर पर, पोर्टल IPorडीएनएस:9000 एपीआई के लिए होता है.

BAAS_PORTAL_LISTEN_PORT

API BaaS पोर्टल सर्वर का पोर्ट नंबर 9000 है. अगर यह पोर्ट उपलब्ध नहीं है, तो किसी दूसरे पोर्ट के बारे में बताएं.

अगर BAAS_PORTAL_URL को पोर्टल नोड के यूआरएल में सेट किया जा रहा है, तो दोनों प्रॉपर्टी के लिए पोर्ट नंबर एक जैसे होने चाहिए.

ज़रूरी नहीं - कैसेंड्रा इंस्टॉल करें: मशीन 8, 9, और 10

API BaaS को उसी Cassandra क्लस्टर से कनेक्ट किया जा सकता है जिसका इस्तेमाल Edge में किया जाता है. हालांकि, Apigee का सुझाव है कि आप अलग-अलग क्लस्टर का इस्तेमाल करें.

Cassandra क्लस्टर में ऑथेंटिकेशन की सुविधा का इस्तेमाल किया जा सकता है या Cassandra की पुष्टि करने की सुविधा बंद की जा सकती है. ज़्यादा जानकारी के लिए, कैसांड्रा ऑथेंटिकेशन चालू करें देखें.

  1. इंटरनेट या बिना इंटरनेट प्रोसेस का इस्तेमाल करके, नोड पर Edge apigee-setup यूटिलिटी इंस्टॉल करें. ज़्यादा जानकारी के लिए, Edge apigee-setup उपयोगिता इंस्टॉल करें देखें.
  2. कमांड प्रॉम्प्ट मिलने पर, सेटअप स्क्रिप्ट चलाएं:
    > /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile

    “-p c” विकल्प से कैसंड्रा को इंस्टॉल किया जा सकता है.
    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके. उदाहरण के लिए, फ़ाइल को नोड पर मौजूद /tmp डायरेक्ट्री में रखें.

कॉन्फ़िगरेशन, नोड पर मौजूद डेटास्टोर सेटअप को पूरा करता है.

ध्यान दें कि कैसंड्रा के लिए JMX डिफ़ॉल्ट रूप से चालू है. Cassandra के JMX रिमोट ऐक्सेस के लिए पासवर्ड की ज़रूरत नहीं है. आप कैसंड्रा को JMX की पुष्टि करने के लिए कॉन्फ़िगर कर सकते हैं. ज़्यादा जानकारी के लिए, मॉनिटर करने का तरीका देखें.

कैसेंड्रा क्रॉन जॉब सेट अप करें

एक क्रॉन जॉब सेट अप करें, जो हर कैसंड्रा नोड पर हर घंटे लॉक चलाने के लिए फ़्लश करने के लिए नोडटूल का इस्तेमाल करता है.

अगर आपके पास कई कैसंड्रा नोड हैं, तो हर सर्वर पर क्रॉन जॉब को पांच मिनट तक ऑफ़सेट करें, ताकि सभी नोड एक साथ फ़्लश न हों.

क्रॉन जॉब को यह निर्देश देना होगा:

/opt/apigee/apigee-cassandra/bin/nodetool -h IP_address flush Apigee_Baas_Locks

जहां IP_address, Cassandra नोड का आईपी पता है.

ElasticSearch इंस्टॉल करें: मशीन 1, 2, और 3

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

  1. इंटरनेट या बिना इंटरनेट प्रोसेस का इस्तेमाल करके, नोड पर Edge apigee-सेटअप यूटिलिटी इंस्टॉल करें. ज़्यादा जानकारी के लिए, Edge apigee-setup उपयोगिता इंस्टॉल करें देखें.
  2. निर्देश मिलने पर, सेटअप स्क्रिप्ट चलाएं:
    > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile

    “-p e” विकल्प से ElasticSearch को इंस्टॉल किया जा सकता है.
    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके. उदाहरण के लिए, फ़ाइल को नोड पर मौजूद /tmp डायरेक्ट्री में रखें.
  3. (ज़रूरी नहीं) अगर आपने ElasticSearch को स्टैंडअलोन नोड पर इंस्टॉल किया है, इसका मतलब है कि इसे API BaaS Stack के साथ इंस्टॉल नहीं किया गया है, तो ElasticSearch के लिए तय की गई मेमोरी को 4 जीबी से बढ़ाकर 6 जीबी करने के लिए, डिफ़ॉल्ट मेमोरी विकल्प में बदलाव करें:
    1. किसी एडिटर में /opt/apigee/customer/application/elasticsearch.properties खोलें. अगर यह फ़ाइल मौजूद नहीं है, तो इसे बनाएं.
    2. setenv_elasticsearch_max_mem_size प्रॉपर्टी को 6g पर सेट करें (डिफ़ॉल्ट तौर पर, यह 4g वैल्यू होती है):
      setenv_elasticsearch_max_mem_size=6g
    3. फ़ाइल सेव करें.
    4. इस निर्देश को चलाएं:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch पुरानी

कॉन्फ़िगरेशन नोड पर सेटअप को सफलतापूर्वक पूरा करता है.

API BaaS Stack इंस्टॉल करें: मशीन 4, 5, और 6

API BaaS Stack को इंस्टॉल करने के लिए:

  1. इंटरनेट या बिना इंटरनेट प्रोसेस का इस्तेमाल करके, नोड पर Edge apigee-सेटअप यूटिलिटी इंस्टॉल करें. ज़्यादा जानकारी के लिए, Edge apigee-setup उपयोगिता इंस्टॉल करें देखें.
  2. निर्देश मिलने पर, सेटअप स्क्रिप्ट चलाएं:
    > /opt/apigee/apigee-setup/bin/setup.sh -p b -f configFile

    “-p b” विकल्प में API BaaS Stack को इंस्टॉल करने के बारे में बताया जाता है.
    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके. उदाहरण के लिए, फ़ाइल को नोड पर मौजूद /tmp डायरेक्ट्री में रखें.

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

API BaaS पोर्टल इंस्टॉल करें: मशीन 7

API BaaS पोर्टल इंस्टॉल करने के लिए:

  1. इंटरनेट या बिना इंटरनेट प्रोसेस का इस्तेमाल करके, नोड पर Edge apigee-सेटअप यूटिलिटी इंस्टॉल करें. ज़्यादा जानकारी के लिए, Edge apigee-setup उपयोगिता इंस्टॉल करें देखें.
  2. कमांड प्रॉम्प्ट मिलने पर, सेटअप स्क्रिप्ट चलाएं:
    > /opt/apigee/setup/bin/setup.sh -p p -f configFile

    “-p p” विकल्प से एपीआई BaaS पोर्टल को इंस्टॉल करने के बारे में जानकारी मिलती है.
    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके. उदाहरण के लिए, फ़ाइल को नोड पर मौजूद /tmp डायरेक्ट्री में रखें.

इंस्टॉलर, Ngnx वेबसर्वर शुरू करता है और उसके बाद API BaaS पोर्टल कॉन्फ़िगरेशन को पूरा करता है.

API BaaS पोर्टल यूआरएल को नोट करें. यह वह यूआरएल होता है जिसे एपीआई BaaS पोर्टल का यूज़र इंटरफ़ेस ऐक्सेस करने के लिए, ब्राउज़र में डाला जाता है.

स्टैक या पोर्टल लोड बैलेंसर के लिए, API BaaS नोड कॉन्फ़िगर करें

अगर आपने स्टैक या पोर्टल नोड के सामने लोड बैलेंसर शामिल किया है, तो आपको लोड बैलेंसर के सही यूआरएल से नोड कॉन्फ़िगर करने होंगे. उदाहरण के लिए, स्टैक नोड को इस जानकारी की ज़रूरत तब होती है, जब:

  • BaaS एपीआई अनुरोधों के जवाबों में एक यूआरएल शामिल करना.
  • पासवर्ड रीसेट करते समय या दूसरी सूचनाएं भेजते समय, ईमेल के टेंप्लेट में लिंक जोड़ना.
  • उपयोगकर्ताओं को खास पोर्टल के पेजों पर रीडायरेक्ट करना.

अगर स्टैक नोड के सामने लोड बैलेंसर का इस्तेमाल किया जाता है, तो इन प्रॉपर्टी को /opt/apigee/customer/application/usergrid.properties में सेट करें:

usergrid-deployment_swagger.basepath=http://localhost:8080
usergrid-deployment_usergrid.organization.activation.url=http://localhost:8080/management/organizations/%s/activate
usergrid-deployment_usergrid.admin.activation.url=http://localhost:8080/management/users/%s/activate
usergrid-deployment_usergrid.admin.resetpw.url=http://localhost:8080/management/users/%s/resetpw
usergrid-deployment_usergrid.admin.confirmation.url=http://localhost:8080/management/users/%s/confirm
usergrid-deployment_usergrid.user.activation.url=http://localhost:8080/%s/%s/users/%s/activate
usergrid-deployment_usergrid.user.confirmation.url=http://localhost:8080/%s/%s/users/%s/confirm
usergrid-deployment_usergrid.user.resetpw.url=http://localhost:8080/%s/%s/users/%s/resetpw

http://localhost:8080 को लोड बैलेंसर के यूआरएल से बदलें. अगर लोड बैलेंसर को TLS का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, तो एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करें. आपको पोर्ट को सिर्फ़ तब शामिल करना होगा, जब किसी नॉन-स्टैंडर्ड पोर्ट का इस्तेमाल किया जा रहा हो. इसका मतलब है एचटीटीपी के लिए पोर्ट 80 और एचटीटीपीएस के लिए पोर्ट 443.

अगर आपने स्टैक नोड के सामने लोड बैलेंसर का इस्तेमाल किया है, तो आपको नीचे दी गई प्रॉपर्टी को /opt/apigee/customer/application/DL.properties में भी सेट करना होगा:

baas.portal.config.overrideUrl=http://localhost:8080

http://localhost:8080 की जगह, स्टैक के लोड बैलेंसर का यूआरएल डाल दें.

अगर पोर्टल नोड के सामने लोड बैलेंसर का इस्तेमाल किया जाता है, तो usergrid.properties में इन प्रॉपर्टी को सेट करें:

usergrid-deployment_usergrid.view.management.organizations.organization.activate=http://localhost:9000
usergrid-deployment_usergrid.view.management.organizations.organization.confirm=http://localhost:9000
usergrid-deployment_usergrid.view.management.users.user.activate=http://localhost:9000
usergrid-deployment_usergrid.view.management.users.user.confirm=http://localhost:9000

http://localhost:9000 को लोड बैलेंसर के यूआरएल से बदल दें. अगर लोड बैलेंसर को TLS का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, तो एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करें. आपको पोर्ट को सिर्फ़ तब शामिल करना होगा, जब किसी नॉन-स्टैंडर्ड पोर्ट का इस्तेमाल किया जा रहा हो. इसका मतलब है एचटीटीपी के लिए पोर्ट 80 और एचटीटीपीएस के लिए पोर्ट 443.

usergrid.properties और portal.properties में बदलाव करने के बाद:

  1. स्टैक नोड को कॉन्फ़िगर करें:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid कॉन्फ़िगर
  2. Tomcat में किए गए बदलावों को डिप्लॉय करें:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergriddeploy
  3. BaaS स्टैक को रीस्टार्ट करें:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid कमरों को रीस्टार्ट करें
  4. अगर आपने portal.properties में बदलाव किया है, तो पोर्टल नोड को कॉन्फ़िगर करें:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas- पोर्टल कॉन्फ़िगर
  5. इन बदलावों को लागू करें:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas- पोर्टलdeploy
  6. BaaS पोर्टल को फिर से शुरू करें:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas- पोर्टल रेफ़रल

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

ऑनबोर्डिंग, संगठन और संगठन का एडमिन बनाने की प्रोसेस है. संगठन और संगठन का एडमिन बनाने के बाद, एपीआई BaaS पोर्टल के यूज़र इंटरफ़ेस (यूआई) में लॉग इन किया जा सकता है और एपीआई BaaS REST API को अनुरोध किया जा सकता है.

जब कोई संगठन बनाया जाता है, तो संगठन के एडमिन का ईमेल पता:

  • यह पता, सिस्टम एडमिन के ईमेल पते से अलग होना चाहिए.
  • अन्य सभी संगठनों के बीच का नाम अलग होना चाहिए. इसका मतलब है कि संगठन के एडमिन के लिए, एक ही ईमेल पते से दो संगठन नहीं बनाए जा सकते. हालांकि, संगठन बनाने के बाद, ऐसे अतिरिक्त एडमिन जोड़े जा सकते हैं जिनकी डुप्लीकेट कॉपी कई संगठनों में बनाई जा सकती है.

ऑनबोर्डिंग करने के लिए, create_org_and_user.py Python स्क्रिप्ट का इस्तेमाल करें. इस स्क्रिप्ट को बिना किसी कमांड-लाइन आर्ग्युमेंट के शुरू करने पर, आपको इससे जुड़ी सभी जानकारी मांगी जाएगी:

> python create_org_and_user.py

इसके अलावा, आपके पास किसी भी या सभी विकल्पों को कमांड लाइन आर्ग्युमेंट के तौर पर पास करने का विकल्प है. आपको कमांड लाइन से हटा दी जाने वाली किसी भी जानकारी के लिए कहा जाएगा:

> python create_org_and_user.py -o '<org name>'
> python create_org_and_user.py -o '<org name>' -a '<new admin email>' -p '<new admin password>'

संगठन बनाने के लिए:

  1. डायरेक्ट्री को /opt/apigee/baas-usergrid/bin में बदलें.
  2. create_org_and_user.py Python स्क्रिप्ट को शुरू करें.
    आपको BaaS सिस्टम एडमिन उपयोगकर्ता नाम और पासवर्ड डालने के लिए कहा जाता है, ताकि सिर्फ़ कोई sys एडमिन ही इसे चला सके.
  3. एपीआई BaaS पोर्टल के इंस्टॉलेशन के आखिर में बताए गए यूआरएल का इस्तेमाल करके, किसी वेब ब्राउज़र पर API BaaS पोर्टल में लॉग इन करें. पोर्टल को ऐक्सेस करने के लिए, API BaaS पोर्टल के यूआरएल को इस फ़ॉर्म में डालें:
    http://{portalExternalIP}:9000/

    ध्यान दें: आईपी, पोर्टल मशीन का बाहरी आईपी पता/होस्ट नाम है. पक्का करें कि पोर्ट खुला हो.
  4. पोर्टल में लॉगिन करने की स्क्रीन दिखने पर, इनमें से कोई एक तरीका अपनाएं:
    • संगठन के एडमिन का उपयोगकर्ता नाम और पासवर्ड इस्तेमाल करके लॉग इन करें.
    • सिस्टम एडमिन एडमिन का उपयोगकर्ता नाम और पासवर्ड इस्तेमाल करके लॉग इन करें.

API BaaS REST API को ऐक्सेस करना

एपीआई बास REST API को ऐक्सेस करने के लिए, यूआरएल को इस फ़ॉर्म में इस्तेमाल करें:

https://{loadBalancerIP}:8080/{your-org}/{your-app}

डेवलपमेंट एनवायरमेंट में, सभी एपीआई BaaS कॉम्पोनेंट को एक नोड पर इंस्टॉल किया जा सकता है. इसका मतलब है कि आपके पास सिर्फ़ एक API BaaS स्टैक है. इसके अलावा, हो सकता है कि आपके पास छोटा एनवायरमेंट हो और उसमें एक एपीआई बाएस स्टैक नोड हो और कोई लोड बैलेंसर न हो. इस तरह के एनवायरमेंट में, सीधे 'एपीआई BaaS स्टैक' नोड में एपीआई कॉल किए जा सकते हैं:

curl -v "http://portalExternalIP:8080/status"

एपीआई BaaS पोर्टल के बारे में ज़्यादा जानकारी के लिए Apigee दस्तावेज़ देखें: http://apigee.com/docs/content/build-apps-home.