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

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

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

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

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

     ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge

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 commands: install, uninstall, update
  • apigee-all commands: 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.53.01.sh ดังนี้

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

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

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

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

ข้อมูล

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

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

ENABLE_SYSTEM_CHECK=y

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