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

Edge for Private Cloud v4.18.05

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

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

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

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

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

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

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

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

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

8. รีสตาร์ทคอมโพเนนต์ 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

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

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

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

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

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

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

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

      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
      sudo bash /tmp/bootstrap_4.18.05.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 ในโหนดแล้ว ผู้ใช้ที่มีสิทธิ์เข้าถึงโดยสมบูรณ์ "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 และทรัพยากร Dependency

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

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

รีสตาร์ท Edge UI ส่วนประกอบ

หลังจากติดตั้งเสร็จแล้ว คุณต้องรีสตาร์ทคอมโพเนนต์ Edge UI ในแต่ละโหนด ดังนี้

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

กำลังกำหนดค่า 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_name action

ตำแหน่งที่ component_name ระบุคอมโพเนนต์ คอมโพเนนต์ต้องอยู่ในโหนดบน ซึ่งคุณจะเรียกใช้ apigee-service ค่าของ ทั้งนี้ขึ้นอยู่กับการกำหนดค่าของคุณ component_name สามารถมีข้อมูลต่อไปนี้

• apigee-cassandra (คาสซานดรา)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (ฐานข้อมูล PostgreSQL)
• apigee-qpidd (Qpidd)
• apigee-sso (SSO ของ Edge)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (เซิร์ฟเวอร์การจัดการ)
• edge-management-ui (UI ใหม่ของ Edge)
• edge-message-processor (ตัวประมวลผลข้อความ)
• edge-postgres-server (เซิร์ฟเวอร์ Postgres)
• edge-qpid-server (เซิร์ฟเวอร์ Qpid)
• edge-router (เราเตอร์ Edge)
• edge-ui (UI แบบคลาสสิก)

นอกจากคอมโพเนนต์เหล่านี้ คุณยังเรียกใช้ apigee-service ใน apigee-provision และ apigee-validate ที่ขึ้นอยู่กับ การกำหนดค่า

ตัวอย่างเช่น หากต้องการรีสตาร์ท 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

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

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

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

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

ENABLE_SYSTEM_CHECK=y

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