एपीआई 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 यूटिलिटी, एपीआई 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 इंस्टॉल करें, लेकिन Cassandra इंस्टॉल न करें. यह पोर्टल बहुत हल्का है. इसके लिए, किसी अतिरिक्त संसाधन की ज़रूरत नहीं है.

asa

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

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

कॉन्फ़िगरेशन फ़ाइल में, एपीआई 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

एपीआई 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 Portal, Tomcat).
    कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस कर सकता हो या पढ़ सकता हो.
  3. आपने ElasticSearch को स्टैंडअलोन नोड पर इंस्टॉल किया है. इसलिए, 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
  4. नए संगठन को शामिल करना सेक्शन में बताए गए तरीके से, किसी संगठन को शामिल करें.

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

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

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

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

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

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

  • IP1 और IP4 को एक ही आईपी पते पर सेट किया गया है
  • IP2 और IP5 को एक ही आईपी पते पर सेट किया गया है
  • IP3 और IP6 को एक ही आईपी पते पर सेट किया गया है

अपने कॉन्फ़िगरेशन के हिसाब से, इस फ़ाइल में बदलाव करें. कॉन्फ़िगरेशन फ़ाइल के बारे में पूरी जानकारी पाने के लिए, 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

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

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

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

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

अगर आपको Cassandra इंस्टॉल करना है, तो एक ऐसा cron जॉब सेट अप करें जो हर 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

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

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

API BaaS पोर्टल इंस्टॉल करें: मशीन 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 वेबसर्वर को चालू करता है. इसके बाद, API BaaS पोर्टल का कॉन्फ़िगरेशन पूरा करता है.
  3. अगला चरण, आपके इंस्टॉलेशन पर निर्भर करता है.
    1. अगर आपके पास Portalor Stack नोड के सामने लोड बैलेंसर है, तो अगले सेक्शन में लोड बैलेंसर के लिए, API BaaS को कॉन्फ़िगर करने का तरीका बताया गया है.
    2. अगर आपके पास Portalor Stack नोड के सामने लोड बैलेंसर नहीं है, तो किसी संगठन को शामिल करें. इसके लिए, नए संगठन को शामिल करना में बताया गया तरीका अपनाएं.

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

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

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

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

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

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

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_portal.url=http://localhost:9000

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

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

  1. स्टैक नोड को कॉन्फ़िगर करें:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure
  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 पोर्टल को रीस्टार्ट करें:
    > /opt/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.