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

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

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

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

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

     ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี 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 ขอแนะนำให้คุณติดตั้ง UI ของ Edge เวอร์ชันใหม่ (ชื่อคอมโพเนนต์คือ edge-management-ui) ซึ่งเป็นอินเทอร์เฟซผู้ใช้ที่ปรับปรุงแล้วสำหรับนักพัฒนาซอฟต์แวร์และผู้ดูแลระบบของ Apigee Edge สำหรับ Private Cloud

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

หลังจากติดตั้งเสร็จแล้ว ให้ดูรายการการดำเนินการหลังการติดตั้งทั่วไปนี้

ใครสามารถติดตั้งได้

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

ผู้ใช้ที่ต้องการเรียกใช้คำสั่งหรือสคริปต์ต่อไปนี้ต้องเป็นรูทหรือเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง 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" ให้ใช้คำสั่ง chown กับไฟล์เพื่อกำหนดให้ผู้ใช้ที่เรียกใช้บริการ Edge เป็นเจ้าของ

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

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

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

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.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 เพื่อติดตั้ง RPM ของ Edge ในโหนด

      /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. หลังจากผู้ใช้รูทติดตั้ง RPM ของ Edge ในโหนดแล้ว ผู้ใช้ที่มีสิทธิ์เข้าถึง 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 และข้อกำหนดของ Edge

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

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

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

การใช้ที่เก็บข้อมูล Edge ในเครื่องเพื่อดูแลรักษาเวอร์ชัน Edge

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

การแก้ไขข้อกำหนดเบื้องต้นในการติดตั้ง RPM

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

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

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