API BaaS ইনস্টলেশন

প্রাইভেট ক্লাউডের জন্য Edge 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 Stack ইনস্টল করতে নিম্নলিখিত কমান্ড ব্যবহার করুন:

> 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 ইনস্টল করুন, এটি Tomcat-ও ইনস্টল করে।

p

শুধুমাত্র API BaaS পোর্টাল ইনস্টল করুন, যা ওয়েব সার্ভার হিসেবে ব্যবহার করার জন্য Nginx রাউটারও ইনস্টল করে।

c

শুধুমাত্র Cassandra ইনস্টল করুন।

eb

নোডে ElasticSearch, API BaaS Stack ও Tomcat ইনস্টল করুন।

ebp

ElasticSearch, API BaaS পোর্টাল, API BaaS স্ট্যাক ও Tomcat ইনস্টল করুন, তবে Cassandra ইনস্টল করবেন না। পোর্টালটি এতটাই হালকা যে এর জন্য কোনও অতিরিক্ত রিসোর্স প্রয়োজন হয় না।

asa

একটি নোডে সব API BaaS কম্পোনেন্ট ইনস্টল করুন (Cassandra, Elasticsearch, API BaaS Stack, API BaaS Portal, 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 Stack, API BaaS Portal, Tomcat)।
    কনফিগারেশন ফাইল "apigee" ব্যবহারকারীর অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।
  3. আপনি যেহেতু স্ট্যান্ডঅ্যালোন নোডে ElasticSearch ইনস্টল করেছেন, তাই ElasticSearch-এর জন্য বরাদ্দ করা মেমরি ৪ জিবি থেকে ৬ জিবি বাড়াতে ডিফল্ট মেমরি বিকল্প অ্যাডজাস্ট করুন:
    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. নতুন কোনও প্রতিষ্ঠানকে অনবোর্ড করা নিবন্ধে যেভাবে বর্ণনা করা হয়েছে সেইভাবে কোনও প্রতিষ্ঠানকে অনবোর্ড করুন।

কনফিগারেশন নোডে সেট-আপ সম্পূর্ণ করে।

৭ বা ১০টি নোডে API BaaS ইনস্টল করুন

API BaaS-এর ৭ বা ১০ নোড ভার্সন ইনস্টল করার পদ্ধতি প্রায় একই। একমাত্র পার্থক্য হল যে:

  • ১০টি নোড ইনস্টল করার ক্ষেত্রে, আপনি তিনটি ElasticSearch কম্পোনেন্ট ও তিনটি API BaaS Stack কম্পোনেন্ট আলাদা নোডে ইনস্টল করেন, মোট ছ'টি নোড। এটি সর্বোচ্চ পারফর্ম্যান্সের জন্য সাজেস্ট করা কনফিগারেশন কারণ ElasticSearch-এর জন্য প্রচুর পরিমাণে ডিস্ক I/O ও মেমরি প্রয়োজন।
  • ৭টি নোড ইনস্টল করার ক্ষেত্রে, আপনি তিনটি ElasticSearch কম্পোনেন্ট ও তিনটি API BaaS স্ট্যাক কম্পোনেন্ট একই নোডে ইনস্টল করেন, যার ফলে মোট তিনটি নোড হয়।

API BaaS-এর ৭ ও ১০ নোড ভার্সন, দুটির ক্ষেত্রেই আপনাকে Cassandra ক্লাস্টারে কানেক্ট করতে হবে। আপনি আগে থেকেই Edge ইনস্টল করে থাকলে, আপনি এর Cassandra ক্লাস্টারে কানেক্ট করতে পারবেন, অর্থাৎ API BaaS ইনস্টল করার অংশ হিসেবে আপনাকে Cassandra ইনস্টল করতে হবে না।

নিচে ১০-নোড API BaaS ইনস্টলেশনের জন্য একটি সাইলেন্ট কনফিগারেশন ফাইলের উদাহরণ দেখানো হল। আপনি যদি একই তিনটি নোডে ElasticSearch এবং API BaaS Stack কম্পোনেন্ট ইনস্টল করেন, তাহলে ফাইলটি এডিট করে এগুলি নিশ্চিত করুন:

  • IP1 ও IP4 একই IP অ্যাড্রেসে সেট করা আছে
  • IP2 ও IP5 একই IP অ্যাড্রেসে সেট করা আছে
  • IP3 ও IP6 একই IP অ্যাড্রেসে সেট করা আছে

আপনার কনফিগারেশনের জন্য প্রয়োজন অনুযায়ী এই ফাইল এডিট করুন। কনফিগারেশন ফাইলের সম্পূর্ণ রেফারেন্সের জন্য, 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: মেশিন ৮, ৯ ও ১০

Edge-এর ব্যবহৃত Cassandra ক্লাস্টারের সাথে আপনি API BaaS কানেক্ট করতে পারবেন। আপনি Edge ইনস্টল না করে থাকলে, API 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 রিমোট অ্যাক্সেসের জন্য পাসওয়ার্ডের প্রয়োজন হয় না। JMX-এর জন্য যাচাইকরণ ব্যবহার করতে আপনি Cassandra কনফিগার করতে পারবেন। আরও জানতে, দেখুন কীভাবে মনিটর করতে হয়।

Cassandra ক্রন জব সেট-আপ করা

আপনাকে Cassandra ইনস্টল করতে হলে, এমন একটি ক্রন জব সেট-আপ করুন যা প্রতিটি Cassandra নোডে প্রতি ঘণ্টায় লক ফ্ল্যাশ করার জন্য nodetool ব্যবহার করে ।

আপনার একাধিক Cassandra নোড থাকলে, প্রতিটি সার্ভারে ক্রন জবকে পাঁচ মিনিট করে অফসেট করুন, যাতে সব নোড একই সময়ে ফ্ল্যাশ না হয়।

ক্রন জবকে অবশ্যই নিম্নলিখিত কমান্ডটি এক্সিকিউট করতে হবে:

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

যেখানে IP_address হল Cassandra নোডের IP অ্যাড্রেস।

ElasticSearch ইনস্টল করুন: মেশিন ১, ২ ও ৩

এর নিজস্ব নোডে 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 Stack-এর সাথে ইনস্টল করা না থাকে, তাহলে ElasticSearch-এর জন্য বরাদ্দ করা মেমরি ৪ জিবি থেকে ৬ জিবিতে বাড়াতে ডিফল্ট মেমরি বিকল্প অ্যাডজাস্ট করুন:
    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 Stack ইনস্টল করুন: মেশিন ৪, ৫ ও ৬

নিজস্ব নোডে API BaaS Stack ইনস্টল করতে:

  1. ইন্টারনেট বা ইন্টারনেট ছাড়া প্রক্রিয়া ব্যবহার করে নোডে Edge apigee-setup ইউটিলিটি ইনস্টল করুন। আরও জানতে Edge apigee-setup ইউটিলিটি ইনস্টল করুন দেখুন।
  2. কমান্ড প্রম্পটে, সেট-আপ স্ক্রিপ্ট রান করুন:
    > /opt/apigee/apigee-setup/bin/setup.sh -p b -f configFile

    “-p b” বিকল্পটি API BaaS Stack ইনস্টল করার জন্য নির্দিষ্ট করে।
    কনফিগারেশন ফাইল "apigee" ব্যবহারকারীর অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।

ইনস্টলার সঠিক অ্যাডমিন ক্রেডেনশিয়াল সংগ্রহ করার পরে, এটি Tomcat ইনস্টল করে, API BaaS কীস্পেস তৈরি করে এবং সার্ভারে API BaaS Stack সেট-আপ করে। এছাড়াও, পাসওয়ার্ড কনফার্মেশন ইমেল পাঠানোর জন্য UI-কে অনুমতি দিতে SMTP কনফিগার করা হয়।

API BaaS পোর্টাল ইনস্টল করুন: 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 ওয়েব সার্ভার চালু করে এবং তারপরে API BaaS পোর্টালের কনফিগারেশন সম্পূর্ণ করে।
  3. আপনার পরবর্তী ধাপ ইনস্টলেশনের উপর নির্ভর করে।
    1. Portalor Stack নোডের আগে কোনও লোড ব্যালেন্সার থাকলে, পরের বিভাগে লোড ব্যালেন্সারের জন্য কীভাবে API BaaS কনফিগার করতে হয় তা বর্ণনা করা হয়েছে।
    2. Portalor Stack নোডের সামনে কোনও লোড ব্যালেন্সার না থাকলে, নতুন সংস্থা অনবোর্ড করা অংশে নিচে যেভাবে বর্ণনা করা হয়েছে সেইভাবে কোনও সংস্থাকে অনবোর্ড করুন।

API BaaS পোর্টাল URL লিখে রাখুন। API BaaS পোর্টালের ইউজার ইন্টারফেস অ্যাক্সেস করতে এই URL ব্রাউজারে লিখতে হয়।

কোনও Stack বা পোর্টাল লোড ব্যালেন্সারের জন্য API BaaS নোড কনফিগার করা

আপনি যদি Stack বা Portal নোডের সামনে একটি লোড ব্যালেন্সার অন্তর্ভুক্ত করেন, তাহলে আপনাকে লোড ব্যালেন্সারের সঠিক URL সহ নোডগুলি কনফিগার করতে হবে। যেমন, Stack নোডগুলির এই তথ্য প্রয়োজন হয় যখন:

  • BaaS API অনুরোধের উত্তরে URL যোগ করা।
  • পাসওয়ার্ড রিসেট করার সময় ইমেল টেমপ্লেটে লিঙ্ক যোগ করা অথবা অন্যান্য বিজ্ঞপ্তি পাঠানো।
  • ব্যবহারকারীদের নির্দিষ্ট পোর্টাল পৃষ্ঠায় রিডাইরেক্ট করা।

আপনি যদি Stack নোডের সামনে লোড ব্যালেন্সার ব্যবহার করেন, তাহলে /opt/apigee/customer/application/usergrid.properties-এ নিম্নলিখিত প্রপার্টি সেট করুন: 

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

http://localhost:8080-এর জায়গায় লোড ব্যালেন্সারের URL লিখুন। TLS ব্যবহার করার জন্য লোড ব্যালেন্সার কনফিগার করা থাকলে, HTTPS প্রোটোকল ব্যবহার করুন। আপনি যদি কোনও নন-স্ট্যান্ডার্ড পোর্ট ব্যবহার করেন, শুধুমাত্র তখনই আপনাকে পোর্ট যোগ করতে হবে, অর্থাৎ HTTP-এর জন্য পোর্ট ৮০ এবং HTTPS-এর জন্য পোর্ট ৪৪৩ ছাড়া অন্য কিছু।

এছাড়াও, Stack নোডের সামনে লোড ব্যালেন্সার ব্যবহার করলে, আপনাকে /opt/apigee/customer/application/portal.properties ফাইলে নিম্নলিখিত প্রপার্টি সেট করতে হবে:

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

http://localhost:8080-এর জায়গায় Stack-এর জন্য লোড ব্যালেন্সারের URL লিখুন।

আপনি যদি পোর্টাল নোডের সামনে লোড ব্যালেন্সার ব্যবহার করেন, তাহলে নিম্নলিখিত প্রপার্টি সেট করুন usergrid.properties-এ: 

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

http://localhost:9000-এর জায়গায় লোড ব্যালেন্সারের URL বসিয়ে দিন। TLS ব্যবহার করার জন্য লোড ব্যালেন্সার কনফিগার করা থাকলে, HTTPS প্রোটোকল ব্যবহার করুন। আপনি স্ট্যান্ডার্ড নয় এমন পোর্ট ব্যবহার করলে তবেই পোর্ট অন্তর্ভুক্ত করতে হবে, অর্থাৎ HTTP-এর জন্য পোর্ট ৮০ এবং HTTPS-এর জন্য পোর্ট ৪৪৩-এর পরিবর্তে অন্য কিছু।

usergrid.properties ও portal.properties এডিট করার পরে:

  1. Stack নোড কনফিগার করুন:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure
  2. BaaS স্ট্যাক রিস্টার্ট করুন:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart

    মনে রাখবেন: BaaS Stack নোড রিস্টার্ট করার সময়, 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 পোর্টাল UI-তে লগ-ইন করতে এবং 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 URL ইনস্টলেশনের শেষে আপনি যে URLটি লিখে রেখেছিলেন সেটি ব্যবহার করে ওয়েব ব্রাউজারে API BaaS পোর্টাল লগ-ইন করুন। পোর্টাল অ্যাক্সেস করতে, API BaaS পোর্টাল URL-টি এই ফর্মটিতে লিখুন:
    http://{portalExternalIP}:9000/

    মনে রাখবেন: IP হল পোর্টাল মেশিনের এক্সটার্নাল IP অ্যাড্রেস/হোস্ট নেম। পোর্ট খোলা আছে কিনা তা নিশ্চিত করুন।
  4. পোর্টাল লগ-ইন স্ক্রিন দেখা গেলে, আপনি এগুলি করতে পারবেন:
    • সংস্থার প্রশাসকের ইউজারনেম ও পাসওয়ার্ড ব্যবহার করে লগ-ইন করুন।
    • সিস্টেম অ্যাডমিনিস্ট্রেটরের ইউজারনেম ও পাসওয়ার্ড ব্যবহার করে লগ-ইন করুন।

API BaaS REST API অ্যাক্সেস করা

API BaaS REST API অ্যাক্সেস করতে, এই ফর্ম্যাটে URL ব্যবহার করুন:

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

ডেভেলপমেন্ট এনভায়রনমেন্টে, আপনি একটি নোডে সব API BaaS কম্পোনেন্ট ইনস্টল করতে পারবেন, অর্থাৎ আপনার একটি API BaaS স্ট্যাক থাকবে। অথবা, আপনার এমন একটি ছোট এনভায়রনমেন্ট থাকতে পারে যেখানে একটি API BaaS Stack নোড আছে এবং কোনও লোড ব্যালেন্সার নেই। এই ধরনের এনভায়রনমেন্টে, আপনি API BaaS Stack নোডে সরাসরি API কল করতে পারবেন:

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

API BaaS পোর্টাল ব্যবহার করা শুরু করার ব্যাপারে আরও তথ্য পেতে, এখানে Apigee ডকুমেন্টেশন দেখুন: http://apigee.com/docs/content/build-apps-home.