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

Edge for Private Cloud v. 4.17.01

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

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

विकल्प

जानकारी

e

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

b

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

p

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

c

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

eb

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

ebp

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

आसा

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

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

कॉन्फ़िगरेशन फ़ाइल में, API BaaS को इंस्टॉल करने के लिए ज़रूरी सारी जानकारी होती है. BaaS इंस्टॉलेशन में सभी कॉम्पोनेंट को इंस्टॉल करने के लिए, अक्सर एक ही कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल किया जा सकता है.

नीचे बताई गई हर इंस्टॉलेशन टोपोलॉजी, उस टोपोलॉजी के लिए कॉन्फ़िगरेशन फ़ाइल का उदाहरण दिखाती है. कॉन्फ़िगरेशन फ़ाइल के बारे में पूरी जानकारी पाने के लिए, BaaS कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस देखें.

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

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

IP1=192.168.56.101   # IP address of single node

# 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=stackAdminPWord

# Because you are installing Cassandra,
# specify Cassandra data center and rack suffix.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1"

# Specify the Cassandra region.
REGION=dc-1

# 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 Cassandra data center name.
BAAS_CASS_LOCALDC=dc-1

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST=dc-1

# Replication is in the form "dataCenterName:#CassandraNodes". 
# For dc-1 with one Cassandra node, it is dc-1:1.
BAAS_CASS_REPLICATION=dc-1:1

# Defines the initial contact points for members of the BaaS cluster. 
# For a single node install, specify the IP address of the node. 
BAAS_CLUSTER_SEEDS="dc-1:$IP1"

# Single ElasticSearch IP.
ES_HOSTS="$IP1"

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

# IP/DNS and port 8080 of a single Stack node.
BAAS_USERGRID_URL="http://$IP1:8080"

# URL and port of the BaaS Portal node.  
BAAS_PORTAL_URL="http://$IP1: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

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

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

    “-p asa” विकल्प से, सभी API BaaS कॉम्पोनेंट को एक ही नोड (Cassandra, Elasticsearch, API BaaS स्टैक, API BaaS पोर्टल, Tomcat) पर इंस्टॉल करने के बारे में बताया जाता है.
    "apigee" उपयोगकर्ता के पास कॉन्फ़िगरेशन फ़ाइल को ऐक्सेस करने या पढ़ने की अनुमति होनी चाहिए.
  3. आपने ElasticSearch को स्टैंडअलोन नोड पर इंस्टॉल किया है. इसलिए, 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 ड्रॉपडाउन
  4. नए संगठन को शामिल करना में बताए गए तरीके से, संगठन को शामिल करें.

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

7 या 10 नोड पर API BaaS इंस्टॉल करें

API BaaS के 7 या 10 नोड वाले वर्शन को इंस्टॉल करने का तरीका काफ़ी हद तक एक जैसा है. सिर्फ़ इतना अंतर है कि:

  • 10 नोड वाले इंस्टॉलेशन में, तीन ElasticSearch कॉम्पोनेंट और तीन API BaaS स्टैक कॉम्पोनेंट को अलग-अलग नोड पर इंस्टॉल किया जाता है. इस तरह, कुल छह नोड होते हैं. बेहतरीन परफ़ॉर्मेंस के लिए, यह सबसे सही कॉन्फ़िगरेशन है. ऐसा इसलिए, क्योंकि ElasticSearch को ज़्यादा डिस्क I/O और मेमोरी की ज़रूरत होती है.
  • सात नोड वाले इंस्टॉलेशन में, तीन ElasticSearch कॉम्पोनेंट और तीन एपीआई BaaS स्टैक कॉम्पोनेंट को एक ही नोड पर इंस्टॉल किया जाता है.

API BaaS के 7 और 10 दोनों नोड वर्शन के लिए, आपको किसी Cassandra क्लस्टर से कनेक्ट करना होगा. अगर आपने पहले से ही Edge इंस्टॉल किया हुआ है, तो आपके पास उसके Cassandra क्लस्टर से कनेक्ट करने का विकल्प है. इसका मतलब है कि आपको API BaaS इंस्टॉल करने के लिए, Cassandra इंस्टॉल करने की ज़रूरत नहीं है.

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

  • आईपी1 और आईपी4, एक ही आईपी पते पर सेट हैं
  • IP2 और IP5 एक ही आईपी पते पर सेट हैं
  • आईपी3 और आईपी6, एक ही आईपी पते पर सेट हैं

अपने कॉन्फ़िगरेशन के लिए, इस फ़ाइल में ज़रूरत के मुताबिक बदलाव करें. कॉन्फ़िगरेशन फ़ाइल के बारे में पूरी जानकारी पाने के लिए, BaaS कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस देखें. 

# 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=stackAdminPWord

# Only if you are installing Cassandra.
# Specify Cassandra data center and rack suffix.
# 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"

# Specify the Cassandra region.
REGION=dc-1

# 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.

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST=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

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# 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

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

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

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" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.

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

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

Cassandra क्रॉन जॉब सेट अप करना

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

अगर आपके पास कई 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

    ElasticSearch इंस्टॉल करने के लिए, “-p e” विकल्प का इस्तेमाल किया जाता है.
    "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

एपीआई BaaS स्टैक को अपने नोड पर इंस्टॉल करने के लिए:

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

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

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

एपीआई BaaS पोर्टल इंस्टॉल करना: मशीन 7

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

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

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

    इंस्टॉलर, Nginx वेब सर्वर को शुरू करता है और फिर API BaaS पोर्टल के कॉन्फ़िगरेशन को पूरा करता है.
  3. आपका अगला चरण, इंस्टॉलेशन के तरीके पर निर्भर करता है.
    1. अगर आपके पास Portal या Stack नोड के सामने लोड बैलेंसर है, तो अगले सेक्शन में लोड बैलेंसर के लिए API BaaS को कॉन्फ़िगर करने का तरीका बताया गया है.
    2. अगर आपके पास Portal या Stack नोड के सामने कोई लोड बैलेंसर नहीं है, तो नए संगठन को शामिल करना में बताए गए तरीके से, किसी संगठन को शामिल करें.

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

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

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

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

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

usergrid-deployment_usergrid.api.url.base=http://localhost:8080

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

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

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

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

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

usergrid-deployment_portal.url=http://localhost:9000

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

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

  1. स्टैक नोड को कॉन्फ़िगर करें:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid कॉन्फ़िगरेशन
  2. BaaS स्टैक को रीस्टार्ट करें:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart

    ध्यान दें: BaaS स्टैक नोड को रीस्टार्ट करते समय, उन्हें उसी क्रम में रीस्टार्ट करें जिसमें वे BAAS_CLUSTER_SEEDS में दी गई हैं. BAAS_CLUSTER_SEEDS में, स्टैक नोड में से ज़्यादा से ज़्यादा दो नोड की सूची होती है. उन दो नोड को क्रम से रीस्टार्ट करने के बाद, बाकी नोड को किसी भी क्रम में रीस्टार्ट किया जा सकता है.

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

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

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

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

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

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

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

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

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

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