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

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

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

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

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

     โปรดดูข้อมูลเพิ่มเติมที่ติดตั้งยูทิลิตี Edge Apigee-setup

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

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

7. ในโหนด Management Server ให้ใช้ยูทิลิตี 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 หากต้องการติดตั้ง ถอนการติดตั้ง และอัปเดต RPM ของ Edge ผู้ใช้รากหรือผู้ใช้ที่มีสิทธิ์เข้าถึง 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.01.sh:

      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
      sudo bash /tmp/bootstrap_4.52.01.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

      Edge RPM ที่คุณติดตั้งบนโหนดจะขึ้นอยู่กับโทโพโลยีของคุณ รายการคอมโพเนนต์ที่ใช้ได้ ได้แก่ 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 เพื่อติดตั้ง Edge RPM และการอ้างอิง

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

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

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

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

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

การแก้ไขการอ้างอิงการติดตั้ง RPM

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

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

/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" เพื่อปิดใช้การตรวจสอบ