एपीआई BaaS इंस्टॉल करना

Edge for Private Cloud v. 4.16.09

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

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

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

Cassandra से कनेक्ट किया जा रहा है

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

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

तारीख सिंक करने की सुविधा

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

Tomcat security

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

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

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

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

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

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

इसके लिए, सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.

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

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

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

विकल्प

ब्यौरा

e

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

b

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

p

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

c

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

ईबी

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

ईबीपी

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

asa

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

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

यहां 10-नोड वाले एपीआई 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” मॉडिफ़ायर शामिल करें, जो Cassandra नोड के डेटा सेंटर और रैक के बारे में बताता है.

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

CASS_USERNAME
CASS_PASSWORD

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

अगर 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" है. उदाहरण के लिए, तीन Cassandra नोड वाले dc-1 के लिए, यह dc-1:3 है.

BAAS_USERGRID_URL

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

http://myStackLoadBalancer:8443

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

http://stackIPorDNS:8080

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

BAAS_PORTAL_URL

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

http://myPortalLoadBalancer:8443

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

http://portalIPorDNS:9000

डिफ़ॉल्ट रूप से, API BaaS पोर्टल का पोर्ट नंबर 9000 होता है.

BAAS_PORTAL_LISTEN_PORT

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

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

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

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

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

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

    “-p c” विकल्प से Cassandra को इंस्टॉल करने के बारे में पता चलता है.
    कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस कर सकता हो या पढ़ सकता हो.

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

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

Cassandra cron job सेट अप करना

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

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

क्रॉन जॉब को यह कमांड चलाना होगा:

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

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

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

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

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

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

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

एपीआई BaaS स्टैक इंस्टॉल करना: मशीन 4, 5, और 6

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

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

    “-p b” विकल्प, एपीआई BaaS स्टैक को इंस्टॉल करने के लिए है.
    कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस कर सकता हो या पढ़ सकता हो.

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

Install API BaaS Portal: Machine 7

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

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

    “-p p” विकल्प, API BaaS पोर्टल को इंस्टॉल करने के लिए है.
    कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस कर सकता हो या पढ़ सकता हो.

इंस्टॉलर, Nginx वेबसर्वर को शुरू करता है. इसके बाद, एपीआई BaaS पोर्टल का कॉन्फ़िगरेशन पूरा करता है.

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

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

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

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

अगर स्टैक नोड के सामने लोड बैलेंसर का इस्तेमाल किया जाता है, तो /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 को लोड बैलेंसर के यूआरएल से बदलें. अगर लोड बैलेंसर को टीएलएस का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, तो एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करें. आपको पोर्ट को सिर्फ़ तब शामिल करना होगा, जब किसी गैर-मानक पोर्ट का इस्तेमाल किया जा रहा हो. इसका मतलब है कि एचटीटीपी के लिए पोर्ट 80 और एचटीटीपीएस के लिए पोर्ट 443 के अलावा, किसी अन्य पोर्ट का इस्तेमाल किया जा रहा हो.

अगर स्टैक नोड के सामने लोड बैलेंसर का इस्तेमाल किया जाता है, तो आपको /opt/apigee/customer/application/portal.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 को लोड बैलेंसर के यूआरएल से बदलें. अगर लोड बैलेंसर को टीएलएस का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, तो एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करें. आपको पोर्ट को सिर्फ़ तब शामिल करना होगा, जब किसी गैर-मानक पोर्ट का इस्तेमाल किया जा रहा हो. इसका मतलब है कि एचटीटीपी के लिए पोर्ट 80 और एचटीटीपीएस के लिए पोर्ट 443 के अलावा कोई और पोर्ट.

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

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

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

शामिल होने की प्रोसेस में, संगठन और संगठन का एडमिन बनाया जाता है. संगठन और संगठन का एडमिन बनाने के बाद, API BaaS पोर्टल के यूज़र इंटरफ़ेस (यूआई) में लॉग इन किया जा सकता है. साथ ही, API 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 सिस्टम एडमिन का उपयोगकर्ता नाम और पासवर्ड मांगा जाता है, ताकि सिर्फ़ सिस्टम एडमिन ही इसे चला सके.
  3. API BaaS पोर्टल के यूआरएल इंस्टॉलेशन के आखिर में नोट किए गए यूआरएल का इस्तेमाल करके, वेब ब्राउज़र में API BaaS पोर्टल में लॉग इन करें. पोर्टल को ऐक्सेस करने के लिए, एपीआई BaaS पोर्टल का यूआरएल इस फ़ॉर्मैट में डालें:
    http://{portalExternalIP}:9000/

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

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

API BaaS REST API को ऐक्सेस करने के लिए, इस फ़ॉर्मैट में यूआरएल का इस्तेमाल करें:

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

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

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

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