ข้อกําหนดในการติดตั้ง

ข้อกำหนดเกี่ยวกับฮาร์ดแวร์

คุณต้องมีคุณสมบัติตรงตามข้อกำหนดขั้นต่ำสำหรับฮาร์ดแวร์ต่อไปนี้สำหรับโครงสร้างพื้นฐานที่มีความพร้อมใช้งานสูง ในสภาพแวดล้อมระดับการผลิต

วิดีโอต่อไปนี้จะให้คำแนะนำเกี่ยวกับขนาดโดยคร่าวสำหรับการติดตั้ง

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

ในตารางเหล่านี้ ข้อกำหนดของฮาร์ดดิสก์จะเพิ่มเติมจากพื้นที่ฮาร์ดดิสก์ที่ระบบปฏิบัติการต้องการ การติดตั้งอาจต้องใช้ทรัพยากรมากกว่าหรือน้อยกว่าที่ระบุไว้ด้านล่าง ทั้งนี้ขึ้นอยู่กับแอปพลิเคชันและการจราจรของข้อมูลในเครือข่าย

ส่วนประกอบการติดตั้ง RAM CPU ฮาร์ดดิสก์ขั้นต่ำ
Cassandra (สแตนด์อโลน) 16 GB 8 คอร์ พื้นที่เก็บข้อมูลในเครื่องขนาด 250 GB พร้อม SSD ที่รองรับ IOPS 2000
Cassandra/Zookeeper ในเครื่องเดียวกัน 16 GB 8 คอร์ พื้นที่เก็บข้อมูลในเครื่องขนาด 250 GB พร้อม SSD ที่รองรับ IOPS 2000
Message Processor/Router ในเครื่องเดียวกัน 16 GB 8 คอร์ 100 GB
Message Processor (สแตนด์อโลน) 16 GB 8 คอร์ 100 GB
เราเตอร์ (สแตนด์อโลน) 8GB 8 คอร์ 100 GB
Analytics - Postgres/Qpid ในเซิร์ฟเวอร์เดียวกัน 16GB* 8 คอร์* พื้นที่เก็บข้อมูลในเครือข่าย**ขนาด 500 GB - 1 TB*** โดยควรมีแบ็กเอนด์ SSD รองรับ IOPS 1000 ขึ้นไป*
ข้อมูลวิเคราะห์ - Postgres แบบมาสเตอร์หรือสแตนด์บายแบบสแตนด์อโลน 16GB* 8 คอร์* พื้นที่เก็บข้อมูลในเครือข่าย**ขนาด 500 GB - 1 TB*** โดยควรมีแบ็กเอนด์ SSD รองรับ IOPS 1000 ขึ้นไป*
Analytics - Qpid (แบบสแตนด์อโลน) 8GB 4 แกน พื้นที่เก็บข้อมูลในเครื่อง 30-50 GB พร้อม SSD

ขนาดคิว Qpid เริ่มต้นคือ 1 GB ซึ่งเพิ่มได้เป็น 2 GB หากต้องการ ความจุเพิ่มเติม ให้เพิ่มโหนด Qpid

OpenLDAP/UI/เซิร์ฟเวอร์การจัดการ 8GB 4 แกน 60GB
เซิร์ฟเวอร์ UI/การจัดการ 4 GB 2 แกน 60GB
OpenLDAP (แบบสแตนด์อโลน) 4 GB 2 แกน 60GB

* ปรับข้อกำหนดของระบบ Postgres ตามปริมาณงาน

  • น้อยกว่า 250 TPS: 8 GB, 4 คอร์อาจพิจารณาได้โดยใช้พื้นที่เก็บข้อมูลเครือข่ายที่มีการจัดการ***ที่รองรับ 1,000 IOPS ขึ้นไป
  • มากกว่า 250 TPS: 16 GB, 8 คอร์, พื้นที่เก็บข้อมูลเครือข่ายที่มีการจัดการ*** รองรับ 1,000 IOPS ขึ้นไป
  • มากกว่า 1,000 TPS: 16 GB, 8 คอร์, พื้นที่เก็บข้อมูลเครือข่ายที่มีการจัดการ*** รองรับ IOPS ตั้งแต่ 2,000 ขึ้นไป
  • มากกว่า 2,000 TPS: 32 GB, 16 คอร์, พื้นที่เก็บข้อมูลเครือข่ายที่มีการจัดการ*** รองรับ 2,000 IOPS ขึ้นไป
  • มากกว่า 4,000 TPS: 64 GB, 32 คอร์, พื้นที่เก็บข้อมูลเครือข่ายที่มีการจัดการ*** รองรับ 4,000 IOPS ขึ้นไป

** ค่าฮาร์ดดิสก์ของ Postgres อิงตามข้อมูลวิเคราะห์ที่พร้อมใช้งานซึ่ง Edge บันทึกไว้ หากคุณเพิ่มค่าที่กําหนดเองลงในข้อมูลวิเคราะห์ ค่าเหล่านี้ควรเพิ่มขึ้นตามนั้น ใช้สูตรต่อไปนี้เพื่อประมาณพื้นที่เก็บข้อมูลที่จำเป็น

bytes of storage needed =

  (# bytes of analytics data/request) *

  (requests/second) *

  (seconds/hour) *

  (hours of peak usage/day) *

  (days/month) *

  (months of data retention)

เช่น

(2K bytes) * (100 req/sec) * (3600 secs/hr) * (18 peak hours/day) * (30 days/month) * (3 months retention)

= 1,194,393,600,000 bytes or 1194.4 GB of storage needed

*** ขอแนะนำให้ใช้ที่เก็บข้อมูลเครือข่ายสำหรับฐานข้อมูล Postgresql เนื่องจาก

  • ซึ่งจะช่วยให้คุณเพิ่มขนาดพื้นที่เก็บข้อมูลแบบไดนามิกได้เมื่อจำเป็น
  • คุณปรับ IOPS ของเครือข่ายได้ทันทีในสภาพแวดล้อม/ระบบย่อยของที่เก็บข้อมูล/เครือข่ายส่วนใหญ่ในปัจจุบัน
  • คุณเปิดใช้สแนปชอตระดับพื้นที่เก็บข้อมูลได้โดยเป็นส่วนหนึ่งของโซลูชันการสำรองข้อมูลและการกู้คืน

นอกจากนี้ รายการต่อไปนี้แสดงข้อกำหนดของฮาร์ดแวร์หากคุณต้องการติดตั้ง บริการสร้างรายได้ (ไม่รองรับการติดตั้งแบบ All-in-One)

คอมโพเนนต์ที่มีการสร้างรายได้ RAM CPU ฮาร์ดดิสก์
เซิร์ฟเวอร์การจัดการ (พร้อมบริการการสร้างรายได้) 8GB 4 คอร์ 60GB
Analytics - Postgres/Qpid ในเซิร์ฟเวอร์เดียวกัน 16 GB 8 คอร์ พื้นที่เก็บข้อมูลเครือข่าย 500 GB - 1 TB โดยควรมีแบ็กเอนด์ SSD ที่รองรับ IOPS 1,000 รายการขึ้นไป หรือใช้กฎจากตารางด้านบน
ข้อมูลวิเคราะห์ - Postgres แบบมาสเตอร์หรือสแตนด์บายแบบสแตนด์อโลน 16 GB 8 คอร์ พื้นที่เก็บข้อมูลเครือข่าย 500 GB - 1 TB โดยควรมีแบ็กเอนด์ SSD ที่รองรับ IOPS 1,000 รายการขึ้นไป หรือใช้กฎจากตารางด้านบน
Analytics - Qpid (แบบสแตนด์อโลน) 8GB 4 แกน พื้นที่เก็บข้อมูลในเครื่อง 40 GB - 500 GB พร้อม SSD หรือ HDD ที่รวดเร็ว

สําหรับการติดตั้งที่มากกว่า 250 TPS เราขอแนะนําให้ใช้ HDD ที่มีพื้นที่เก็บข้อมูลในเครื่องซึ่งรองรับ 1, 000 IOPS

ข้อกำหนดแบนด์วิดท์เครือข่าย Cassandra

Cassandra ใช้โปรโตคอล Gossip เพื่อแลกเปลี่ยนข้อมูลกับโหนดอื่นๆ เกี่ยวกับโทโพโลยีเครือข่าย การใช้ Gossip ร่วมกับลักษณะการกระจายของ Cassandra ซึ่งเกี่ยวข้องกับการสื่อสารกับโหนดหลายโหนดสำหรับการดำเนินการอ่านและเขียน ส่งผลให้มีการโอนข้อมูลจำนวนมากในเครือข่าย

Cassandra ต้องการแบนด์วิดท์เครือข่ายขั้นต่ำ 1 Gbps ต่อโหนด สำหรับการติดตั้งใช้งานจริง เราขอแนะนำให้ใช้แบนด์วิดท์ที่สูงขึ้น

เวลาในการตอบสนองสูงสุดหรือเปอร์เซ็นไทล์ที่ 99 สำหรับ Cassandra ควรต่ำกว่า 100 มิลลิวินาที

ข้อกำหนดด้านระบบปฏิบัติการและซอฟต์แวร์ของบุคคลที่สาม

เราได้ทดสอบวิธีการติดตั้งและไฟล์การติดตั้งที่ให้มาในระบบปฏิบัติการและซอฟต์แวร์ของบุคคลที่สามที่ระบุไว้ในซอฟต์แวร์และเวอร์ชันที่รองรับ

ข้อกำหนดเบื้องต้น: เปิดใช้ที่เก็บ EPEL

ก่อนดำเนินการติดตั้ง โปรดตรวจสอบว่าได้เปิดใช้ที่เก็บ EPEL (Extra Packages for Enterprise Linux) แล้ว ใช้คำสั่งต่อไปนี้ตามเวอร์ชันระบบปฏิบัติการ

  • สำหรับ Red Hat/CentOS/Oracle 8.X:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
    sudo rpm -ivh epel-release-latest-8.noarch.rpm
  • สำหรับ Red Hat/CentOS/Oracle 9.X:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    sudo rpm -ivh epel-release-latest-9.noarch.rpm

Java

คุณต้องติดตั้ง Java 1.8 เวอร์ชันที่รองรับในแต่ละเครื่องก่อนการติดตั้ง JDK ที่รองรับแสดงอยู่ใน ซอฟต์แวร์ที่รองรับและเวอร์ชันที่รองรับ

ตรวจสอบว่าตัวแปรสภาพแวดล้อม JAVA_HOME ชี้ไปยังรูทของ JDK สำหรับ ผู้ใช้ที่ทำการติดตั้ง

SELinux

Edge อาจพบปัญหาในการติดตั้งและเริ่มต้นคอมโพเนนต์ของ Edge ทั้งนี้ขึ้นอยู่กับการตั้งค่า SELinux หากจำเป็น คุณสามารถปิดใช้ SELinux หรือตั้งค่าเป็นโหมดที่อนุญาตในระหว่าง การติดตั้ง แล้วเปิดใช้อีกครั้งหลังการติดตั้ง ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge

การสร้างผู้ใช้ "apigee"

ขั้นตอนการติดตั้งจะสร้างผู้ใช้ระบบ Unix ชื่อ "apigee" ไดเรกทอรีและไฟล์ Edge เป็นของ "apigee" เช่นเดียวกับกระบวนการ Edge ซึ่งหมายความว่าคอมโพเนนต์ Edge จะทํางานในฐานะผู้ใช้ "apigee" หากจำเป็น คุณสามารถเรียกใช้คอมโพเนนต์ในฐานะผู้ใช้รายอื่นได้

ไดเรกทอรีการติดตั้ง

โดยค่าเริ่มต้น โปรแกรมติดตั้งจะเขียนไฟล์ทั้งหมดลงในไดเรกทอรี /opt/apigee คุณ เปลี่ยนตำแหน่งไดเรกทอรีนี้ไม่ได้ แม้ว่าจะเปลี่ยนไดเรกทอรีนี้ไม่ได้ แต่คุณสามารถสร้าง Symlink เพื่อแมป /opt/apigee ไปยังตำแหน่งอื่นได้ตามที่อธิบายไว้ใน การสร้าง Symlink จาก /opt/apigee

ในวิธีการในคู่มือนี้ ไดเรกทอรีการติดตั้งจะระบุเป็น /opt/apigee

ก่อนสร้าง Symlink คุณต้องสร้างผู้ใช้และกลุ่มชื่อ "apigee" ก่อน ซึ่งเป็นกลุ่มและผู้ใช้เดียวกันกับที่โปรแกรมติดตั้ง Edge สร้างขึ้น

หากต้องการสร้างลิงก์สัญลักษณ์ ให้ทำตามขั้นตอนเหล่านี้ก่อนดาวน์โหลดไฟล์ bootstrap_4.53.00.sh คุณต้องทำตามขั้นตอนเหล่านี้ทั้งหมดในฐานะรูท

  1. สร้างผู้ใช้และกลุ่ม "apigee"
    groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. สร้าง Symlink จาก /opt/apigee ไปยังรูทการติดตั้งที่ต้องการ
    ln -Ts /srv/myInstallDir /opt/apigee

    โดยที่ /srv/myInstallDir คือตำแหน่งที่ต้องการของไฟล์ Edge

  3. เปลี่ยนความเป็นเจ้าของรูทการติดตั้งและ Symlink เป็นผู้ใช้ "apigee" ดังนี้
    chown -h apigee:apigee /srv/myInstallDir /opt/apigee

การตั้งค่าเครือข่าย

Apigee ขอแนะนำให้คุณตรวจสอบการตั้งค่าเครือข่ายก่อนการติดตั้ง โปรแกรมติดตั้ง คาดว่าเครื่องทั้งหมดจะมีที่อยู่ IP แบบคงที่ ใช้คำสั่งต่อไปนี้เพื่อตรวจสอบการตั้งค่า

  • hostname แสดงชื่อเครื่อง
  • hostname -i จะแสดงที่อยู่ IP สำหรับชื่อโฮสต์ที่เข้าถึงได้จาก เครื่องอื่นๆ

คุณอาจต้องแก้ไข /etc/hosts และ /etc/sysconfig/network หากตั้งค่าชื่อโฮสต์ไม่ถูกต้อง ทั้งนี้ขึ้นอยู่กับประเภทและเวอร์ชันของระบบปฏิบัติการ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบสำหรับระบบปฏิบัติการของคุณ

หากเซิร์ฟเวอร์มีอินเทอร์เฟซการ์ดหลายใบ คำสั่ง "hostname -i" จะแสดงรายการที่อยู่ IP ที่คั่นด้วยช่องว่าง โดยค่าเริ่มต้น โปรแกรมติดตั้ง Edge จะใช้ที่อยู่ IP แรกที่แสดง ซึ่งอาจไม่ถูกต้องในบางสถานการณ์ หรือคุณจะตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในไฟล์กำหนดค่าการติดตั้งแทนก็ได้

ENABLE_DYNAMIC_HOSTIP=y

เมื่อตั้งค่าพร็อพเพอร์ตี้นี้เป็น "y" โปรแกรมติดตั้งจะแจ้งให้คุณเลือกที่อยู่ IP ที่จะใช้เป็น ส่วนหนึ่งของการติดตั้ง ค่าเริ่มต้นคือ "n" ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลอ้างอิงไฟล์การกำหนดค่า Edge

TCP Wrappers

TCP Wrapper สามารถบล็อกการสื่อสารของพอร์ตบางพอร์ตและอาจส่งผลต่อการติดตั้ง OpenLDAP, Postgres และ Cassandra ในโหนดเหล่านั้น ให้ตรวจสอบ /etc/hosts.allow และ /etc/hosts.deny เพื่อให้แน่ใจว่าไม่มีข้อจำกัดของพอร์ตในพอร์ต OpenLDAP, Postgres และ Cassandra ที่จำเป็น

iptables

ตรวจสอบว่าไม่มีนโยบาย iptables ที่ป้องกันการเชื่อมต่อระหว่างโหนดในพอร์ต Edge ที่จำเป็น หากจำเป็น คุณสามารถหยุด iptables ระหว่างการติดตั้งได้โดยใช้คำสั่ง

sudo/etc/init.d/iptables stop

การเข้าถึงไดเรกทอรี

ตารางต่อไปนี้แสดงรายการไดเรกทอรีในโหนด Edge ที่มีข้อกำหนดพิเศษจาก กระบวนการ Edge

บริการ ไดเรกทอรี คำอธิบาย
เราเตอร์ /etc/rc.d/init.d/functions

Edge Router ใช้เราเตอร์ Nginx และต้องมีสิทธิ์เข้าถึงแบบอ่านไปยัง /etc/rc.d/init.d/functions

หากกระบวนการรักษาความปลอดภัยกำหนดให้คุณตั้งค่าสิทธิ์ใน /etc/rc.d/init.d/functions อย่าตั้งค่าเป็น 700 ไม่เช่นนั้นเราเตอร์จะ เริ่มทำงานไม่สำเร็จ

คุณตั้งค่าสิทธิ์เป็น 744 เพื่ออนุญาตสิทธิ์การอ่านสำหรับ /etc/rc.d/init.d/functions ได้

ผู้ดูแลสวนสัตว์ /dev/random ไลบรารีไคลเอ็นต์ Zookeeper ต้องมีสิทธิ์เข้าถึงแบบอ่านไปยังตัวสร้างหมายเลขแบบสุ่ม /dev/random หาก /dev/random ถูกบล็อกในการอ่าน บริการ Zookeeper อาจเริ่มต้นไม่สำเร็จ

Cassandra

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

Cassandra จะปรับขนาดฮีปของ Java โดยอัตโนมัติตามหน่วยความจำที่มีอยู่ ดูข้อมูลเพิ่มเติมได้ที่ การปรับแต่ง ทรัพยากร Java ในกรณีที่ประสิทธิภาพลดลงหรือมีการใช้หน่วยความจำสูง

หลังจากติดตั้ง Edge for Private Cloud แล้ว คุณสามารถตรวจสอบว่าได้กำหนดค่า Cassandra อย่างถูกต้องหรือไม่ โดยตรวจสอบไฟล์ /opt/apigee/apigee-cassandra/conf/cassandra.yaml เช่น ตรวจสอบว่าสคริปต์การติดตั้ง Edge for Private Cloud ได้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ แล้ว

  • cluster_name
  • initial_token
  • partitioner
  • seeds
  • listen_address
  • rpc_address
  • snitch

ฐานข้อมูล PostgreSQL

หลังจากติดตั้ง Edge แล้ว คุณสามารถปรับการตั้งค่าฐานข้อมูล PostgreSQL ต่อไปนี้ตาม ปริมาณ RAM ที่มีในระบบ

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

วิธีตั้งค่าเหล่านี้

  1. แก้ไขไฟล์ postgresql.properties ดังนี้
    vi /opt/apigee/customer/application/postgresql.properties

    หากไม่มีไฟล์ ให้สร้างไฟล์

  2. ตั้งค่าพร็อพเพอร์ตี้ที่ระบุไว้ข้างต้น
  3. บันทึกการแก้ไข
  4. รีสตาร์ทฐานข้อมูล PostgreSQL
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

การกำหนดค่าภาษาสำหรับ Rocky 9.X

หากใช้ Rocky 9.X ให้ตรวจสอบว่าระบบได้รับการกำหนดค่าด้วย LANG=en_US.utf8 ในการตั้งค่าภาษาทั่วทั้งระบบ หากต้องการกำหนดค่า ให้เรียกใช้คำสั่งต่อไปนี้

dnf -y -q install langpacks-en
localectl set-locale LANG=en_US.utf8
reboot

ข้อจำกัดของระบบ

ตรวจสอบว่าคุณได้ตั้งค่าขีดจำกัดของระบบต่อไปนี้ในโหนด Cassandra และ Message Processor แล้ว

  • ในโหนด Cassandra ให้ตั้งค่าขีดจำกัดแบบ Soft และ Hard สำหรับ memlock, nofile และพื้นที่ที่อยู่ (as) สำหรับ ผู้ใช้ที่ติดตั้ง (ค่าเริ่มต้นคือ "apigee") ใน /etc/security/limits.d/90-apigee-edge-limits.conf ดังที่แสดงด้านล่าง
    apigee soft memlock unlimited
    apigee hard memlock unlimited
    apigee soft nofile 32768
    apigee hard nofile 65536
    apigee soft as unlimited
    apigee hard as unlimited
    apigee soft nproc 32768
    apigee hard nproc 65536
  • ในโหนด Message Processor ให้ตั้งค่าตัวอธิบายไฟล์ที่เปิดสูงสุดเป็น 64K ใน /etc/security/limits.d/90-apigee-edge-limits.conf ดังที่แสดงด้านล่าง
    apigee soft nofile 32768
    apigee hard nofile 65536

    คุณเพิ่มขีดจำกัดดังกล่าวได้หากจำเป็น เช่น หากคุณมี ไฟล์ชั่วคราวจำนวนมากที่เปิดอยู่พร้อมกัน

  • หากคุณเห็นข้อผิดพลาดต่อไปนี้ในเราเตอร์หรือ Message Processor system.log แสดงว่าอาจตั้งค่าขีดจำกัดของตัวบอกไฟล์ต่ำเกินไป

    "java.io.IOException: Too many open files"

    คุณตรวจสอบขีดจํากัดผู้ใช้ได้โดยเรียกใช้คําสั่งต่อไปนี้

    # su - apigee
    $ ulimit -n
    100000
    

    หากยังคงมีไฟล์ที่เปิดเกินขีดจำกัดหลังจากตั้งค่าขีดจำกัดของตัวอธิบายไฟล์เป็น 100000 ให้เปิดคำขอแจ้งปัญหากับทีมสนับสนุนของ Apigee Edge เพื่อรับการแก้ปัญหาเพิ่มเติม

Network Security Services (NSS)

Network Security Services (NSS) คือชุดไลบรารีที่รองรับการพัฒนาแอปพลิเคชันไคลเอ็นต์และเซิร์ฟเวอร์ที่เปิดใช้ความปลอดภัย คุณควรตรวจสอบว่าได้ติดตั้ง NSS เวอร์ชัน 3.19 ขึ้นไป

วิธีตรวจสอบเวอร์ชันปัจจุบัน

yum info nss

วิธีอัปเดต NSS

yum update nss

ดูข้อมูลเพิ่มเติมได้ในบทความนี้ จาก RedHat

ปิดใช้การค้นหา DNS ใน IPv6 เมื่อใช้ NSCD (Name Service Cache Daemon)

หากคุณติดตั้งและเปิดใช้ NSCD (Name Service Cache Daemon) โปรแกรมประมวลผลข้อความ จะทำการค้นหา DNS 2 ครั้ง ครั้งหนึ่งสำหรับ IPv4 และอีกครั้งสำหรับ IPv6 คุณควรปิดใช้การค้นหา DNS ใน IPv6 เมื่อใช้ NSCD

วิธีปิดใช้การค้นหา DNS ใน IPv6

  1. แก้ไข /etc/nscd.conf ในโหนด Message Processor ทุกโหนด
  2. ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้
    enable-cache hosts no

ปิดใช้ IPv6 ใน RHEL 8 ขึ้นไป

หากคุณกำลังติดตั้ง Edge ใน RHEL 8 หรือเวอร์ชันที่ใหม่กว่าใน Google Cloud Platform คุณ ต้องปิดใช้ IPv6 ในโหนด Qpid ทั้งหมด

หากต้องการดูวิธีการปิดใช้ IPv6 โปรดดูเอกสารประกอบที่ผู้ให้บริการระบบปฏิบัติการของคุณจัดไว้ให้ เช่น คุณสามารถดูข้อมูลที่เกี่ยวข้องได้ในเอกสารประกอบของ Red Hat Enterprise Linux

เครื่องมือ

โปรแกรมติดตั้งใช้เครื่องมือ UNIX ต่อไปนี้ในเวอร์ชันมาตรฐานตามที่ EL5 หรือ EL6 จัดหาให้

awk

expr

libxslt

rpm

แตกไฟล์

basename

grep

lua-socket

rpm2cpio

useradd

bash

hostname

ls

sed

wc

bc

id

net-tools

sudo

wget

curl

libaio

perl (จาก procps)

tar

xerces-c

cyrus-sasl libdb4 pgrep (จาก procps) tr อร่อย

วันที่

libdb-cxx

ps

uuid

chkconfig

dirname libibverbs pwd uname  
echo librdmacm python    

การซิงค์เวลา

Apigee ขอแนะนำให้ซิงค์เวลาของเซิร์ฟเวอร์ หากยังไม่ได้กำหนดค่า ยูทิลิตี ntpdate หรือเครื่องมือที่เทียบเท่าสามารถทำหน้าที่นี้ได้โดยการยืนยันว่าเซิร์ฟเวอร์ซิงค์เวลาหรือไม่ เช่น คุณใช้ yum install ntp หรือคำสั่งที่เทียบเท่าเพื่อติดตั้งยูทิลิตีได้ ซึ่งจะมีประโยชน์อย่างยิ่งสำหรับการจำลองการตั้งค่า OpenLDAP โปรดทราบว่าคุณควรตั้งค่าเขตเวลาของเซิร์ฟเวอร์เป็น UTC

openldap 2.4

การติดตั้งในองค์กรต้องใช้ OpenLDAP 2.4 ซึ่งรวมอยู่ในที่เก็บ apigee-thirdparty-opdk โปรดนำopenldap-compat library ออกเพื่อให้ติดตั้งได้ง่าย

สำหรับการติดตั้ง 13 โฮสต์และการติดตั้ง 12 โฮสต์ที่มีศูนย์ข้อมูล 2 แห่ง คุณต้องใช้การจำลองแบบ OpenLDAP เนื่องจากมีหลายโหนดที่โฮสต์ OpenLDAP

ไฟร์วอลล์และโฮสต์เสมือน

คำว่า virtual มักจะมีการใช้งานมากเกินไปในวงการไอที เช่นเดียวกับการติดตั้งใช้งาน Apigee Edge สำหรับ Private Cloud และโฮสต์เสมือน เพื่อความชัดเจน คำว่า virtual มีการใช้งานหลักๆ 2 อย่าง ดังนี้

  • เครื่องเสมือน (VM): ไม่จำเป็น แต่การติดตั้งใช้งานบางอย่างใช้เทคโนโลยี VM เพื่อสร้างเซิร์ฟเวอร์ที่แยกต่างหากสำหรับคอมโพเนนต์ Apigee โฮสต์ VM เช่นเดียวกับโฮสต์จริงสามารถมี อินเทอร์เฟซเครือข่ายและไฟร์วอลล์ได้
  • โฮสต์เสมือน: อุปกรณ์ปลายทางของเว็บ ซึ่งคล้ายกับโฮสต์เสมือนของ Apache

เราเตอร์ใน VM สามารถแสดงโฮสต์เสมือนหลายรายการ (ตราบใดที่โฮสต์เสมือนเหล่านั้นแตกต่างกันใน นามแฝงของโฮสต์หรือในพอร์ตอินเทอร์เฟซ)

ตัวอย่างการตั้งชื่อเช่น เซิร์ฟเวอร์จริงเครื่องเดียวAอาจเรียกใช้ VM 2 เครื่อง ชื่อ "VM1" และ "VM2" สมมติว่า "VM1" แสดงอินเทอร์เฟซอีเทอร์เน็ตเสมือนซึ่งมีชื่อว่า "eth0" ภายใน VM และได้รับที่อยู่ IP 111.111.111.111 จาก เครื่องมือจำลองเสมือนหรือเซิร์ฟเวอร์ DHCP ของเครือข่าย จากนั้นสมมติว่า VM2 แสดงอินเทอร์เฟซอีเทอร์เน็ตเสมือน ซึ่งมีชื่อว่า "eth0" เช่นกัน และได้รับที่อยู่ IP 111.111.111.222

เราอาจมีเราเตอร์ Apigee ที่ทำงานใน VM ทั้ง 2 รายการ เราเตอร์จะแสดงปลายทางของโฮสต์เสมือน ดังตัวอย่างสมมติต่อไปนี้

เราเตอร์ Apigee ใน VM1 แสดงโฮสต์เสมือน 3 รายการในอินเทอร์เฟซ eth0 (ซึ่งมีที่อยู่ IP ที่เฉพาะเจาะจง) api.mycompany.com:80, api.mycompany.com:443 และ test.mycompany.com:80

เราเตอร์ใน VM2 แสดง api.mycompany.com:80 (ชื่อและพอร์ตเดียวกันกับที่ VM1 แสดง)

ระบบปฏิบัติการของโฮสต์จริงอาจมีไฟร์วอลล์เครือข่าย หากมี คุณต้องกำหนดค่าไฟร์วอลล์นั้น เพื่อให้ส่งต่อการรับส่งข้อมูล TCP ที่มุ่งไปยังพอร์ตที่เปิดเผยในอินเทอร์เฟซเสมือน (111.111.111.111:{80, 443} และ 111.111.111.222:80) นอกจากนี้ ระบบปฏิบัติการของ VM แต่ละรายการอาจมีไฟร์วอลล์ของตัวเองในอินเทอร์เฟซ eth0 และไฟร์วอลล์เหล่านี้ ต้องอนุญาตให้การรับส่งข้อมูลพอร์ต 80 และ 443 เชื่อมต่อด้วย

Basepath เป็นคอมโพเนนต์ที่ 3 ที่เกี่ยวข้องกับการกำหนดเส้นทางการเรียก API ไปยังพร็อกซี API ต่างๆ ที่คุณอาจได้ติดตั้งใช้งาน ชุดพร็อกซี API สามารถแชร์ปลายทางได้หากมี basepath ที่แตกต่างกัน เช่น คุณกำหนดเส้นทางฐานหนึ่งเป็น http://api.mycompany.com:80/ และอีกเส้นทางหนึ่งเป็น http://api.mycompany.com:80/salesdemo ได้

ในกรณีนี้ คุณต้องมีตัวจัดสรรภาระงานหรือตัวจัดการการรับส่งข้อมูลบางประเภทที่แยกการรับส่งข้อมูล http://api.mycompany.com:80/ ระหว่างที่อยู่ IP 2 รายการ (111.111.111.111 ใน VM1 และ 111.111.111.222 ใน VM2) ฟังก์ชันนี้ มีไว้สำหรับการติดตั้งใช้งานของคุณโดยเฉพาะ และได้รับการกำหนดค่าโดยกลุ่มเครือข่ายในพื้นที่ของคุณ

ระบบจะตั้งค่าเส้นทางฐานเมื่อคุณติดตั้งใช้งาน API จากตัวอย่างข้างต้น คุณสามารถติดตั้งใช้งาน API 2 รายการ mycompany และ testmycompany สำหรับองค์กร mycompany-org ด้วยโฮสต์เสมือนที่มีนามแฝงของโฮสต์เป็น api.mycompany.com และตั้งค่าพอร์ตเป็น 80 หากคุณไม่ประกาศ basepath ในการติดตั้งใช้งาน เราเตอร์จะไม่ทราบว่าจะส่งคำขอขาเข้าไปยัง API ใด

แต่หากคุณติดตั้งใช้งาน API testmycompany โดยใช้ URL ฐานของ /salesdemo ผู้ใช้จะเข้าถึง API นั้นโดยใช้ http://api.mycompany.com:80/salesdemo หากคุณติดตั้งใช้งาน API mycompany ด้วย URL ฐานของ / ผู้ใช้จะเข้าถึง API ได้โดยใช้ URL http://api.mycompany.com:80/

การอนุญาตให้ใช้สิทธิ

การติดตั้ง Edge แต่ละครั้งต้องใช้ไฟล์ใบอนุญาตที่ไม่ซ้ำกันซึ่งคุณได้รับจาก Apigee คุณจะต้องระบุเส้นทางไปยังไฟล์ใบอนุญาตเมื่อติดตั้งเซิร์ฟเวอร์การจัดการ เช่น /tmp/license.txt

โปรแกรมติดตั้งจะคัดลอกไฟล์ใบอนุญาตไปที่ /opt/apigee/customer/conf/license.txt

หากไฟล์ใบอนุญาตถูกต้อง เซิร์ฟเวอร์การจัดการจะตรวจสอบวันหมดอายุและจำนวน Message Processor (MP) ที่อนุญาต หากการตั้งค่าใบอนุญาตหมดอายุ คุณจะดูบันทึกได้ใน ตำแหน่งต่อไปนี้ /opt/apigee/var/log/edge-management-server/logs ในกรณีนี้ คุณสามารถติดต่อทีมสนับสนุนของ Apigee Edge เพื่อขอรายละเอียดการย้ายข้อมูลได้

หากยังไม่มีใบอนุญาต โปรดติดต่อฝ่ายขายของ Apigee