การติดตั้ง BaaS ของ API

Edge สำหรับ Private Cloud เวอร์ชัน 4.17.09

ภาพรวมการติดตั้ง

หลังจากติดตั้งยูทิลิตี apigee-setup Edge บนโหนดแล้ว ให้ใช้ยูทิลิตีนั้นติดตั้งคอมโพเนนต์ BaaS อย่างน้อย 1 รายการในโหนด

ยูทิลิตี 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

การระบุคอมโพเนนต์ที่จะติดตั้ง

ยูทิลิตี setup.sh ของ Apigee รองรับหลายตัวเลือกสำหรับการติดตั้งคอมโพเนนต์ 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 บนโหนด

Epp

ติดตั้ง ElasticSearch, พอร์ทัล API BaaS, API BaaS Stack และ Tomcat แต่ไม่ติดตั้ง Cassandra พอร์ทัลนี้ใช้งานง่ายมาก จึงไม่ต้องใช้ทรัพยากรเพิ่มเติมสำหรับเรื่องนี้

อาซา

ติดตั้งคอมโพเนนต์ 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
SMTPMAILFROM="My Company <myco@company.com>"

วิธีติดตั้ง 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 จาก 4 GB เป็น 6 GB ดังนี้
    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 บนโหนด 7 หรือ 10 รายการ

ขั้นตอนการติดตั้ง API BaaS เวอร์ชัน 7 หรือ 10 โหนดคล้ายกันมาก ความแตกต่างเพียงอย่างเดียวคือ

  • การติดตั้ง 10 โหนด คุณติดตั้งคอมโพเนนต์ ElasticSearch 3 รายการและคอมโพเนนต์ API BaaS Stack ของ API 3 รายการบนโหนดแยกต่างหาก รวมทั้งหมด 6 โหนด นี่เป็นการกำหนดค่าที่แนะนำเพื่อให้มีประสิทธิภาพสูงสุดเนื่องจาก ElasticSearch ต้องใช้ I/O และหน่วยความจำของดิสก์จำนวนมาก
  • การติดตั้ง 7 โหนด คุณติดตั้งคอมโพเนนต์ ElasticSearch 3 รายการและคอมโพเนนต์ API BaaS Stack 3 รายการบนโหนดเดียวกัน รวมทั้งหมด 3 โหนด

สำหรับ API BaaS ทั้งเวอร์ชัน 7 และ 10 โหนด คุณต้องเชื่อมต่อกับคลัสเตอร์ Cassandra หากติดตั้ง Edge แล้ว คุณจะเชื่อมต่อกับคลัสเตอร์ Cassandra ได้ ซึ่งหมายความว่าคุณจะไม่ต้องติดตั้ง Cassandra เป็นส่วนหนึ่งของการติดตั้ง API BaaS

ด้านล่างนี้เป็นตัวอย่างไฟล์การกำหนดค่าแบบไม่มีเสียงสำหรับการติดตั้ง API BaaS แบบ 10 โหนด หากคุณกำลังติดตั้งคอมโพเนนต์ ElasticSearch และ API BaaS Stack ในโหนด 3 โหนดเดียวกัน ให้แก้ไขไฟล์เพื่อให้มีคุณสมบัติดังนี้

  • ตั้งค่า 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
SMTPMAILFROM="My Company <myco@company.com>"

ไม่บังคับ - ติดตั้ง Cassandra: เครื่อง 8, 9 และ 10

คุณเชื่อมต่อ API BaaS กับคลัสเตอร์ Cassandra เดียวกับที่ Edge ใช้ได้ หากยังไม่ได้ติดตั้ง Edge คุณเลือกติดตั้ง Cassandra เพื่อใช้กับ 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" จะระบุให้ติดตั้ง Cassandra

    ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านได้

การกำหนดค่าทำให้การตั้งค่าพื้นที่เก็บข้อมูลบนโหนดเสร็จสมบูรณ์

โปรดทราบว่า Cassandra จะเปิดใช้ JMX ไว้โดยค่าเริ่มต้น การเข้าถึง Cassandra จากระยะไกลของ JMX ไม่ต้องใช้รหัสผ่าน คุณกำหนดค่า Cassandra ให้ใช้การตรวจสอบสิทธิ์สำหรับ JMX ได้ ดูข้อมูลเพิ่มเติมได้ที่วิธีตรวจสอบ

ตั้งค่างาน Cassandra Cron

หากคุณต้องติดตั้ง Cassandra ให้ตั้งค่างาน Cron ที่ใช้ nodetool เพื่อล้างเพื่อให้ล็อกทำงานทุกชั่วโมงในโหนด Cassandra ทุกโหนด

หากคุณมีโหนด Cassandra หลายโหนด ให้ออฟเซ็ตงาน Cron บนเซิร์ฟเวอร์แต่ละรายการด้วย 5 นาที เพื่อให้โหนดทั้งหมดไม่ล้างพร้อมกัน

งาน Cron ต้องเรียกใช้คำสั่งต่อไปนี้

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

โดยที่ IP_address คือที่อยู่ IP ของโหนด 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
      
    The "-p e" option specifies to install ElasticSearch. The configuration file must be
      accessible or readable by the "apigee" user.
  3. (Optional) If you install ElasticSearch on a standalone node, meaning it is not installed with API BaaS Stack, then adjust the default memory option to increase the memory allocated for ElasticSearch from 4GB to 6GB:
    1. Open /opt/apigee/customer/application/elasticsearch.properties in an editor. If this file does not exist, create it.
    2. Set the setenv_elasticsearch_max_mem_size property to 6g (the default is 4g): 
      setenv_elasticsearch_max_mem_size=6g
    3. บันทึกไฟล์
    4. เรียกใช้คำสั่งต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch restart

    การกำหนดค่าทำการตั้งค่าบนโหนดสำเร็จ

    ติดตั้ง API BaaS Stack: เครื่อง 4, 5 และ 6

    วิธีติดตั้ง 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, สร้างคีย์ BaaS ของ API และตั้งค่า API BaaS Stack บนเซิร์ฟเวอร์ ระบบยังกำหนดค่า SMTP เพื่อให้ UI ส่งอีเมลยืนยันรหัสผ่านได้ด้วย

    ติดตั้งพอร์ทัล 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. หากคุณมีตัวจัดสรรภาระงานอยู่ด้านหน้าโหนดของพอร์ทัลหรือสแต็ก ส่วนถัดไปจะอธิบายวิธีกำหนดค่า API BaaS สำหรับตัวจัดสรรภาระงาน
      2. หากไม่มีตัวจัดสรรภาระงานด้านหน้าโหนดของพอร์ทัลหรือสแต็ก ให้เริ่มต้นใช้งานองค์กรตามที่อธิบายไว้ด้านล่างในการเริ่มต้นใช้งานองค์กรใหม่

    จดบันทึก URL ของ API BaaS พอร์ทัล นี่คือ URL ที่คุณป้อนลงในเบราว์เซอร์เพื่อเข้าถึงอินเทอร์เฟซผู้ใช้ของพอร์ทัล API BaaS

    กำหนดค่าโหนด API BaaS สำหรับตัวจัดสรรภาระงานของสแต็กหรือพอร์ทัล

    หากรวมตัวจัดสรรภาระงานไว้หน้าโหนดสแต็กหรือพอร์ทัล คุณจะต้องกำหนดค่าโหนดด้วย URL ของตัวจัดสรรภาระงานที่ถูกต้อง ตัวอย่างเช่น โหนดสแต็กต้องใช้ข้อมูลนี้ในกรณีต่อไปนี้

    • การใส่ URL ในการตอบกลับในคำขอ BaaS API
    • เพิ่มลิงก์ในเทมเพลตอีเมลเมื่อรีเซ็ตรหัสผ่านหรือส่งการแจ้งเตือนอื่นๆ
    • กำลังเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าพอร์ทัลที่เจาะจง

    หากคุณใช้ตัวจัดสรรภาระงานด้านหน้าโหนดสแต็ก ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน /opt/apigee/customer/application/usergrid.properties

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

    แทนที่ http://localhost:8080 ด้วย URL ของตัวจัดสรรภาระงาน หากตัวจัดสรรภาระงานมีการกำหนดค่าให้ใช้ TLS ให้ใช้โปรโตคอล HTTPS คุณต้องรวมพอร์ตเฉพาะในกรณีที่ใช้พอร์ตที่ไม่ใช่แบบมาตรฐาน ซึ่งหมายถึงพอร์ตอื่นที่ไม่ใช่พอร์ต 80 สำหรับ HTTP และพอร์ต 443 สำหรับ HTTPS

    นอกจากนี้ คุณต้องตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน /opt/apigee/customer/application/portal.properties หากคุณใช้ตัวจัดสรรภาระงานด้านหน้าโหนดสแต็ก

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

    แทนที่ http://localhost:8080 ด้วย URL ของตัวจัดสรรภาระงานสำหรับสแต็ก

    หากคุณใช้ตัวจัดสรรภาระงานด้านหน้าโหนดพอร์ทัล ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน usergrid.properties

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

    แทนที่ http://localhost:9000 ด้วย URL ของตัวจัดสรรภาระงาน หากตัวจัดสรรภาระงานมีการกำหนดค่าให้ใช้ TLS ให้ใช้โปรโตคอล HTTPS คุณต้องระบุพอร์ตเฉพาะในกรณีที่ใช้พอร์ตที่ไม่ใช่แบบมาตรฐาน ซึ่งหมายถึงพอร์ต 80 สำหรับ HTTP และพอร์ต 443 สำหรับ HTTPS

    หลังจากแก้ไข usergrid.properties และ portal.properties:

    1. กำหนดค่าโหนดสแต็ก: 
      /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure
    2. รีสตาร์ท BaaS Stack โดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart
    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

    การเริ่มต้นใช้งานองค์กรใหม่

    การเริ่มต้นใช้งานคือกระบวนการสร้างองค์กรและผู้ดูแลระบบองค์กร หลังจากสร้างผู้ดูแลระบบองค์กรและองค์กรแล้ว คุณจะเข้าสู่ระบบ UI พอร์ทัล API BaaS และส่งคำขอไปยัง API BaaS REST API ได้

    เมื่อสร้างองค์กร ที่อยู่อีเมลของผู้ดูแลระบบองค์กรจะดำเนินการดังนี้

    • ต้องแตกต่างจากอีเมลของผู้ดูแลระบบ
    • ต้องไม่ซ้ำกันกับองค์กรอื่นๆ ทั้งหมด กล่าวคือ คุณจะสร้าง 2 องค์กรด้วยอีเมลเดียวกันสำหรับผู้ดูแลระบบองค์กรไม่ได้ แต่หลังจากที่สร้างองค์กรแล้ว คุณจะเพิ่มผู้ดูแลระบบรายอื่นที่ซ้ำกันในหลายองค์กรได้

    หากต้องการเริ่มต้นใช้งาน ให้ใช้สคริปต์ Python create_org_and_user.py การเรียกใช้สคริปต์นี้โดยไม่มีอาร์กิวเมนต์บรรทัดคำสั่งจะทำให้สคริปต์แจ้งคุณสำหรับข้อมูลทั้งหมด

    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. เรียกใช้สคริปต์ Python create_org_and_user.py

      คุณจะได้รับข้อความแจ้งให้ป้อนชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบ BaaS เพื่อให้เฉพาะผู้ดูแลระบบ เท่านั้นเรียกใช้ได้

    3. ลงชื่อเข้าสู่ระบบพอร์ทัล API BaaS ในเว็บเบราว์เซอร์โดยใช้ URL ที่คุณระบุไว้ในตอนท้ายของการติดตั้ง URL พอร์ทัล API BaaS หากต้องการเข้าถึงพอร์ทัล ให้ป้อน URL พอร์ทัล API BaaS ในรูปแบบต่อไปนี้ 
      http://portalExternalIP:9000/
    4. เมื่อหน้าจอการเข้าสู่ระบบพอร์ทัลปรากฏขึ้น คุณจะทําสิ่งต่อไปนี้ได้
      • เข้าสู่ระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบองค์กร
      • เข้าสู่ระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบ

    การเข้าถึง API BaaS REST API

    หากต้องการเข้าถึง API BaaS REST API ให้ใช้ URL ในแบบฟอร์มดังนี้

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

    ในสภาพแวดล้อมการพัฒนา คุณจะติดตั้งคอมโพเนนต์ API BaaS ทั้งหมดบนโหนดเดียวได้ ซึ่งหมายความว่าคุณจะมี API BaaS Stack เดี่ยว หรือคุณอาจมีสภาพแวดล้อมขนาดเล็กที่มีโหนด API BaaS Stack เดี่ยวและไม่มีตัวจัดสรรภาระงาน ในสภาพแวดล้อมประเภทต่อไปนี้ คุณจะเรียก API ไปยังโหนด API BaaS Stack ได้โดยตรง

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

    สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเริ่มต้นใช้งานพอร์ทัล API BaaS โปรดดูเอกสารของ Apigee ที่ http://apigee.com/docs/content/build-apps-home