ภาพรวมการติดตั้ง 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.52.00.sh ไปยัง /tmp/bootstrap_4.52.00.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.52.00.sh ดังนี้

      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
      sudo bash /tmp/bootstrap_4.52.00.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 เพื่อติดตั้ง RPM และทรัพยากร Dependency ของ Edge

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

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

  โฮสต์ทรัพยากร Dependency ของบุคคลที่สามทั้งหมดในที่เก็บสาธารณะของเรา

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

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

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

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

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