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

การติดตั้ง Edge โดยทั่วไปประกอบด้วยคอมโพเนนต์ Edge ที่กระจายอยู่ในหลายโหนด หลังจากติดตั้ง Edge ในโหนดแล้ว คุณจะต้องติดตั้งและกำหนดค่าคอมโพเนนต์ Edge อย่างน้อย 1 รายการในโหนด

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

การติดตั้ง Edge บนโหนดเป็นกระบวนการที่มีหลายขั้นตอน ดังนี้

1. ปิดใช้ SELinux บนโหนดหรือตั้งค่าเป็นโหมดอนุญาต โปรดดูข้อมูลเพิ่มเติมในหัวข้อติดตั้งยูทิลิตีการตั้งค่า Apigee-setup ของ Edge
2. เลือกว่าคุณต้องการเปิดใช้การตรวจสอบสิทธิ์ Cassandra หรือไม่
3. ตัดสินใจว่าคุณต้องการตั้งค่าการจำลองการสแตนด์บายต้นแบบสำหรับ Postgres หรือไม่
4. เลือกการกำหนดค่า Edge จากรายการโทโพโลยีที่แนะนำ ตัวอย่างเช่น คุณติดตั้ง Edge ในโหนดเดียวสำหรับการทดสอบ หรือติดตั้งบน 13 โหนดสำหรับเวอร์ชันที่ใช้งานจริงได้ ดูข้อมูลเพิ่มเติมในTopologies การติดตั้ง
5. ติดตั้งยูทิลิตี Edge apigee-setup ต่อไปนี้ในแต่ละโหนดในโทโพโลยีที่คุณเลือก
   • ดาวน์โหลดไฟล์ Edge bootstrap_4.52.02.sh ไปยัง /tmp/bootstrap_4.52.02.sh
   • ติดตั้งยูทิลิตีและการอ้างอิง Edge apigee-service
   • ติดตั้งยูทิลิตีและการอ้างอิง Edge apigee-setup

     โปรดดูข้อมูลเพิ่มเติมที่หัวข้อติดตั้งยูทิลิตีการตั้งค่า Edge Apigee

6. ใช้ยูทิลิตี apigee-setup เพื่อติดตั้งคอมโพเนนต์ Edge อย่างน้อย 1 รายการในแต่ละโหนดตามโทโพโลยีที่คุณเลือก

   ดูหัวข้อติดตั้งคอมโพเนนต์ Edge ในโหนด

7. ในโหนดเซิร์ฟเวอร์การจัดการ ให้ใช้ยูทิลิตี apigee-setup เพื่อติดตั้ง apigee-provision ซึ่งเป็นยูทิลิตีที่คุณใช้สร้างและจัดการองค์กร Edge

   ดูข้อมูลเพิ่มเติมในเริ่มต้นใช้งานองค์กร

8. รีสตาร์ทคอมโพเนนต์ UI แบบคลาสสิกในแต่ละโหนดหลังจากที่ติดตั้งเสร็จสมบูรณ์แล้ว ตามตัวอย่างต่อไปนี้

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. (แนะนำ) หลังจากติดตั้งเบื้องต้นเสร็จแล้ว Apigee จะแนะนำให้คุณติดตั้ง Edge UI ใหม่ (ชื่อคอมโพเนนต์คือ edge-management-ui) ซึ่งเป็นอินเทอร์เฟซผู้ใช้ขั้นสูงสำหรับนักพัฒนาและผู้ดูแลระบบ Apigee Edge สำหรับ Private Cloud

   โปรดดูข้อมูลเพิ่มเติมที่หัวข้อติดตั้ง Edge UI ใหม่

หลังจากติดตั้งเสร็จแล้ว โปรดดูรายการการดำเนินการทั่วไปหลังการติดตั้ง

ผู้ที่ดำเนินการติดตั้งได้

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

ผู้ใช้ที่ต้องการเรียกใช้คำสั่งหรือสคริปต์ต่อไปนี้ต้องเป็นผู้ใช้ที่รูทหรือเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็ม

• ยูทิลิตี apigee-service:
  • คำสั่ง apigee-service: install, uninstall, update
  • คำสั่ง apigee-all: install, uninstall, update
• สคริปต์ setup.sh เพื่อติดตั้งคอมโพเนนต์ Edge (ยกเว้นคุณได้ใช้ "apigee-service install" เพื่อติดตั้ง RPM ที่จำเป็นไว้แล้ว จากนั้นให้เข้าถึงรูทหรือ sudo แบบเต็มหากไม่จำเป็น)
• สคริปต์ update.sh เพื่ออัปเดตคอมโพเนนต์ Edge

นอกจากนี้ โปรแกรมติดตั้ง Edge จะสร้างผู้ใช้ใหม่ในระบบโดยใช้ชื่อว่า "apigee" ด้วย คำสั่ง Edge หลายรายการเรียกใช้ sudo เพื่อเรียกใช้ในฐานะผู้ใช้ "apigee"

ผู้ใช้ที่ต้องการเรียกใช้คำสั่งอื่นๆ ทั้งหมดนอกเหนือจากที่แสดงด้านบนต้องเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee" คำสั่งเหล่านี้รวมถึง

• คำสั่งยูทิลิตี apigee-service มีดังนี้
  • คำสั่ง apigee-service เช่น start, stop, restart, configure
  • คำสั่ง apigee-all เช่น start, stop, restart, configure

การสร้างผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee"

หากต้องการกำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee" ให้ใช้คำสั่ง "visudo" เพื่อแก้ไขไฟล์ sudoers ที่จะเพิ่ม:

installUser        ALL=(apigee)      NOPASSWD: ALL

โดยที่ installUser คือชื่อผู้ใช้ของบุคคลที่ทำงานกับ Edge

การตั้งค่าสิทธิ์ในไฟล์การกำหนดค่า

ผู้ใช้ "Apigee" จะต้องเข้าถึงไฟล์หรือทรัพยากรใดๆ ที่ใช้คำสั่ง Edge ได้ ซึ่งรวมถึงไฟล์ใบอนุญาต Edge และไฟล์การกำหนดค่าทั้งหมด

เมื่อสร้างไฟล์การกำหนดค่า คุณจะเปลี่ยนเจ้าของไฟล์เป็น "apigee:apigee" เพื่อให้มั่นใจว่าคำสั่ง Edge จะเข้าถึงไฟล์ดังกล่าวได้ โดยทำดังนี้

1. สร้างไฟล์ในตัวแก้ไขในฐานะผู้ใช้ใดก็ได้
2. chown เจ้าของไฟล์เป็น "apigee:apigee" หรือถ้าคุณเปลี่ยนผู้ใช้ที่เรียกใช้บริการ Edge จากผู้ใช้ "apigee" แล้ว ให้เจาะจงไฟล์ให้กับผู้ใช้ที่ใช้บริการ Edge

การแยกงานการติดตั้ง Edge ระหว่างผู้ใช้ระดับรูทและผู้ใช้ที่ไม่ใช่รูท

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

1. งานที่ดำเนินการโดยรูท:
   1. ดาวน์โหลดและเรียกใช้ไฟล์ bootstrap_4.52.02.sh:

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      ขั้นตอนนี้จะติดตั้งยูทิลิตี apigee-service และสร้างผู้ใช้ "Apigee"

   2. กำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee" ตามที่อธิบายไว้ใน การสร้างผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee"
   3. ติดตั้งยูทิลิตี apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. ใช้ยูทิลิตี apigee-setup เพื่อติดตั้ง Edge RPM บนโหนด

      /opt/apigee/apigee-service/bin/apigee-service compName install

      RPM ของ Edge ที่คุณติดตั้งในโหนดขึ้นอยู่กับโทโพโลยีของคุณ รายการคอมโพเนนต์ที่ใช้ได้ ได้แก่ apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server

2. หลังจากผู้ใช้รูทติดตั้ง Edge RPM ในโหนดแล้ว ผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee" จะดำเนินขั้นตอนการกำหนดค่าให้เสร็จสมบูรณ์ได้ดังนี้
   1. ใช้ยูทิลิตี setup.sh เพื่อกำหนดค่าคอมโพเนนต์ Edge ในโหนดให้เสร็จสมบูรณ์ รูปแบบของคำสั่งจะขึ้นอยู่กับคอมโพเนนต์ที่คุณติดตั้งในโหนด ดูรายการทั้งหมดได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

      ตัวอย่างเช่น หากต้องการติดตั้ง ZooKeeper และ Cassandra ให้เสร็จสมบูรณ์ ให้ใช้คำสั่งต่อไปนี้

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      โดยที่ configFile คือไฟล์การกำหนดค่า Edge

      หรือใช้คำสั่งต่อไปนี้เพื่อติดตั้งแบบรวมเครื่องมือเดียว

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

ตำแหน่งของไฟล์การกำหนดค่าการติดตั้ง

คุณต้องส่งไฟล์การกำหนดค่าไปยังยูทิลิตี apigee-setup ที่มีข้อมูลเกี่ยวกับการติดตั้ง Edge ข้อกำหนดเพียงอย่างเดียวเกี่ยวกับการติดตั้งแบบเงียบคือ ผู้ใช้ "Apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้ เช่น วางไฟล์ในไดเรกทอรี /usr/local/var หรือ /usr/local/share บนโหนด และ chown ไปยัง "apigee:apigee"

ต้องระบุข้อมูลทั้งหมดในไฟล์การกำหนดค่า ยกเว้นรหัสผ่านของผู้ดูแลระบบระบบ Edge หากไม่ใส่รหัสผ่าน ยูทิลิตี apigee-setup จะแจ้งให้คุณป้อนในบรรทัดคำสั่ง

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อติดตั้งคอมโพเนนต์ Edge ในโหนด

การจัดการความล้มเหลวในการติดตั้ง

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

หลังจากติดตั้งหรืออัปเกรดแล้ว อย่าลืมรีสตาร์ทคอมโพเนนต์ Edge UI ในแต่ละโหนดที่คอมโพเนนต์ทำงานอยู่

การติดตั้งผ่านอินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต

หากต้องการติดตั้ง Edge ในโหนด โหนดต้องเข้าถึงที่เก็บ Apigee ได้ โดยทำดังนี้

• โหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

  โหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee เพื่อติดตั้ง RPM และทรัพยากร Dependency ของ Edge

• โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

  โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee เวอร์ชันมิเรอร์ซึ่งคุณตั้งค่าภายในได้ ที่เก็บนี้มี RPM ของ Edge ทั้งหมด แต่คุณจะต้องตรวจสอบว่าคุณมีทรัพยากร Dependency อื่นๆ ทั้งหมดจากที่เก็บในเครือข่ายภายใน

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

การใช้ที่เก็บ Edge ในเครื่องเพื่อดูแลรักษาเวอร์ชันของ Edge

เหตุผลข้อหนึ่งในการใช้ที่เก็บในเครื่องหรือที่เก็บสำหรับมิเรอร์คือการติดตั้ง Edge บนโหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกตามที่อธิบายไว้ในส่วนก่อนหน้า

การแก้ไขทรัพยากร Dependency ของการติดตั้ง RPM

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

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

คำสั่ง Yum ทั่วไป

เครื่องมือการติดตั้ง Edge สำหรับ Linux ต้องใช้ Yum ในการติดตั้งและอัปเดตคอมโพเนนต์ คุณอาจต้องใช้คำสั่ง Yum หลายรายการเพื่อจัดการการติดตั้งในโหนด

• ล้างแคช Yum ทั้งหมด:

  sudo yum clean all

• หากต้องการอัปเดตคอมโพเนนต์ Edge ให้ทำดังนี้

  sudo yum update componentName

  เช่น

  sudo yum update apigee-setup
  sudo yum update edge-management-server

โครงสร้างระบบไฟล์

Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee

ในคู่มือนี้และในคู่มือการดำเนินการ Edge ไดเรกทอรีการติดตั้งรูทจะระบุไว้ดังนี้

/opt/apigee

การติดตั้งใช้โครงสร้างระบบไฟล์ต่อไปนี้ในการทำให้ Apigee Edge สำหรับ Private Cloud ใช้งานได้

ไฟล์บันทึก

ไฟล์บันทึกสำหรับ apigee-setup และสคริปต์ setup.sh เขียนไปยัง /tmp/setup-root.log

ไฟล์บันทึกของแต่ละคอมโพเนนต์จะอยู่ในไดเรกทอรี /opt/apigee/var/log คอมโพเนนต์แต่ละอย่างมีไดเรกทอรีย่อยของตัวเอง เช่น บันทึกสำหรับเซิร์ฟเวอร์การจัดการจะอยู่ในไดเรกทอรีต่อไปนี้

/opt/apigee/var/log/edge-management-server

ตารางต่อไปนี้แสดงตำแหน่งของไฟล์บันทึก

ส่วนประกอบ	ตำแหน่ง
เซิร์ฟเวอร์การจัดการ	/opt/apigee/var/log/edge-management-server
เราเตอร์	/opt/apigee/var/log/edge-router Edge Router จะใช้ Nginx ดูบันทึกเพิ่มเติมได้จากหัวข้อต่อไปนี้ /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs
Message Processor	/opt/apigee/var/log/edge-message-processor
เซิร์ฟเวอร์ Apigee Qpid	/opt/apigee/var/log/edge-qpid-server
เซิร์ฟเวอร์ Apigee Postgres	/opt/apigee/var/log/edge-postgres-server
UI แบบคลาสสิก (ไม่ใช่ Edge UI ใหม่ ซึ่งมีชื่อคอมโพเนนต์คือ edge-management-ui)	/opt/apigee/var/log/edge-ui
ZooKeeper	/opt/apigee/var/log/apigee-zookeeper
OpenLDAP	/opt/apigee/var/log/apigee-openldap
Cassandra	/opt/apigee/var/log/apigee-cassandra/system.log
คพิด	/opt/apigee/var/log/apigee-qpidd
ฐานข้อมูล PostgreSQL	/opt/apigee/var/log/apigee-postgresql
apigee-monit	/opt/apigee/var/log/apigee-monit

ข้อมูล

ส่วนประกอบ	ตำแหน่ง
เซิร์ฟเวอร์การจัดการ	/opt/apigee/data/edge-management-server
เราเตอร์	/opt/apigee/data/edge-router
Message Processor	/opt/apigee/data/edge-message-processor
Agent ของ Apigee Qpid	/opt/apigee/data/edge-qpid-server
Agent ของ Apigee Postgres	/opt/apigee/data/edge-postgres-server
ZooKeeper	/opt/apigee/data/apigee-zookeeper
OpenLDAP	/opt/apigee/data/apigee-openldap
Cassandra	/opt/apigee/data/apigee-cassandra/data
คพิด	/opt/apigee/data/apigee-qpid/data
ฐานข้อมูล PostgreSQL	/opt/apigee/data/apigee-postgres/pgdata
apigee-monit	/opt/apigee/data/apigee-monit

เปิดใช้การตรวจสอบระบบเมื่อติดตั้ง

ไฟล์การกำหนดค่าการติดตั้ง Edge รองรับพร็อพเพอร์ตี้ต่อไปนี้

ENABLE_SYSTEM_CHECK=y

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