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

Edge for Private Cloud v. 4.17.01

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

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

apigee-setup यूटिलिटी इस फ़ॉर्म में उपलब्ध है:

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

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

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

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

एसा

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

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

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

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

एपीआई 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” विकल्प में, एपीआई BaaS के सभी कॉम्पोनेंट को एक ही नोड पर इंस्टॉल करने के बारे में बताया जाता है (Cassandra, Elasticsearch, API BaaS Stack, API BaaS Stack, API BaaS Stack.
    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "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 Stack कॉम्पोनेंट को इंस्टॉल करने होते हैं. सबसे अच्छी परफ़ॉर्मेंस के लिए, हम यह कॉन्फ़िगरेशन इस्तेमाल करने का सुझाव देते हैं. ऐसा इसलिए, क्योंकि ElasticSearch के लिए बहुत ज़्यादा डिस्क I/O और मेमोरी की ज़रूरत होती है.
  • 7 नोड को इंस्टॉल करने से, आपको एक ही नोड पर, तीन ElasticSearch कॉम्पोनेंट और तीन API BaaS स्टैक कॉम्पोनेंट को इंस्टॉल करने पर, कुल तीन नोड होते हैं.

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

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

  • IP1 और IP4 एक ही IP पते पर सेट हैं
  • 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

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

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

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

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

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

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

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

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

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

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

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

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

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

ElasticSearch इंस्टॉल करें: Machine 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" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.
  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 स्टैक इंस्टॉल करें: मशीन 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" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.

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

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

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

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

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

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

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

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

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

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

अगर आपको स्टैक नोड के सामने लोड बैलेंसर का इस्तेमाल करना है, तो इस प्रॉपर्टी को /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/DL.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.properties और portal.properties में बदलाव करने के बाद:

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

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

ऑनबोर्डिंग, संगठन और संगठन का एडमिन बनाने की प्रोसेस है. संगठन और संगठन का एडमिन बनाने के बाद, एपीआई 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.