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

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

विकल्प

जानकारी

e

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

b

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

p

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

c

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

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
SMTPMAILFROM="My Company <myco@company.com>"

एपीआई 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 Stack, API BaaS Stack, API).
    "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 restart
  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, एक ही आईपी पते पर सेट हैं
  • आईपी2 और आईपी5, एक ही आईपी पते पर सेट हैं
  • आईपी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
SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

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

API 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" उपयोगकर्ता के पास कॉन्फ़िगरेशन फ़ाइल को ऐक्सेस करने या पढ़ने की अनुमति होनी चाहिए.

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

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

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

  1. इंटरनेट या बिना इंटरनेट वाली प्रोसेस का इस्तेमाल करके, नोड पर Edge apigee-सेटअप सुविधा इंस्टॉल करें. ज़्यादा जानकारी के लिए, 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 configure
  2. BaaS स्टैक को रीस्टार्ट करें:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid रीस्टार्ट

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

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

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

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

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

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

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

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