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

Edge for Private Cloud เวอร์ชัน 4.17.09

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

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

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

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

ผู้ที่ติดตั้งได้

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

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

• apigee-service:
  • apigee-service commands: 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. เปลี่ยนเจ้าของไฟล์เป็น "apigee:apigee" หรือหากคุณเปลี่ยนผู้ใช้ที่เรียกใช้บริการ Edge จากผู้ใช้ "apigee" ให้เปลี่ยนเจ้าของไฟล์เป็นผู้ใช้ที่เรียกใช้บริการ Edge

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

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

1. งานที่ดำเนินการโดยรูท
   1. ดาวน์โหลดและเรียกใช้ไฟล์ bootstrap_4.17.09.sh:
      > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
      
      ขั้นตอนนี้จะติดตั้งยูทิลิตี apigee-service และสร้างผู้ใช้ "apigee"
   2. กำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง 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-ui, 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 ในโหนด แล้วเปลี่ยนเจ้าของเป็น "apigee:apigee"

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

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

การจัดการการติดตั้งที่ไม่สำเร็จ

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

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

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

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

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

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

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

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

ที่เก็บที่มิเรอร์มีความยืดหยุ่นสูง เช่น คุณสามารถสร้างที่เก็บที่มิเรอร์จาก RPM ของ Edge ล่าสุดหรือจาก Edge เวอร์ชันที่เฉพาะเจาะจงได้ หลังจากสร้างที่เก็บแล้ว คุณยังสามารถอัปเดตเพื่อเพิ่ม RPM จาก Edge เวอร์ชันต่างๆ ได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ 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 ได้

การกำหนดค่าคอมโพเนนต์ Edge หลังการติดตั้ง

หากต้องการกำหนดค่า Edge หลังการติดตั้ง ให้ใช้ไฟล์ .properties และยูทิลิตี Edge ร่วมกัน เช่น หากต้องการกำหนดค่า TLS/SSL ใน Edge UI คุณต้องแก้ไขไฟล์ .properties เพื่อตั้งค่าพร็อพเพอร์ตี้ที่จำเป็น การเปลี่ยนแปลงไฟล์ .properties กำหนดให้คุณต้องรีสตาร์ทคอมโพเนนต์ Edge ที่ได้รับผลกระทบ

ไฟล์ .properties จะอยู่ในไดเรกทอรี /opt/apigee/customer/application แต่ละคอมโพเนนต์จะมีไฟล์ .properties ของตัวเองในไดเรกทอรีนั้น เช่น router.properties และ management-server.properties

หากต้องการตั้งค่าพร็อพเพอร์ตี้สำหรับคอมโพเนนต์ ให้แก้ไขไฟล์ .properties ที่เกี่ยวข้อง แล้วรีสตาร์ทคอมโพเนนต์ โดยทำดังนี้

> /opt/apigee/apigee-service/bin/apigee-service component restart

เช่น

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

เมื่อคุณอัปเดต Edge ระบบจะอ่านไฟล์ .properties ในไดเรกทอรี /opt/apigee/customer/application ซึ่งหมายความว่าการอัปเดตจะเก็บพร็อพเพอร์ตี้ที่คุณตั้งค่าไว้ในคอมโพเนนต์

ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่า Edge ได้ที่วิธีกำหนดค่า Edge

การเรียกใช้คำสั่งในคอมโพเนนต์ Edge

Edge จะติดตั้งยูทิลิตีการจัดการใน /opt/apigee/apigee-service/bin ซึ่งคุณสามารถใช้เพื่อจัดการการติดตั้ง Edge ได้ เช่น คุณสามารถใช้ยูทิลิตี apigee-all เพื่อเริ่ม หยุด รีสตาร์ท หรือระบุสถานะของคอมโพเนนต์ Edge ทั้งหมดในโหนดได้

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

ใช้ยูทิลิตี apigee-service เพื่อควบคุมและกำหนดค่าคอมโพเนนต์แต่ละรายการ ยูทิลิตี apigee-service มีรูปแบบดังนี้

/opt/apigee/apigee-service/bin/apigee-service component action

ตัวอย่างเช่น หากต้องการรีสตาร์ท Edge Router ให้ทำดังนี้

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

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

• apigee - คอมโพเนนต์ของบุคคลที่สามที่ Edge ใช้ ตัวอย่างเช่น apigee-cassandra
• edge - คอมโพเนนต์ Edge จาก Apigee เช่น edge-management-server
• edge-mint - คอมโพเนนต์การสร้างรายได้ เช่น edge-mint-management-server
• baas - คอมโพเนนต์ API BaaS เช่น baas-usergrid

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

• start, stop, restart
• status, version
• backup, restore
• install, uninstall