ภาพรวมการติดตั้ง 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.50.00.sh ของ Edge ไปยัง /tmp/bootstrap_4.50.00.sh
    • ติดตั้งยูทิลิตีและการอ้างอิง Edge apigee-service
    • ติดตั้งยูทิลิตี apigee-setup ของ Edge และข้อกำหนดเบื้องต้น

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

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

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

  1. งานที่ทำโดยรูทมีดังนี้
    1. ดาวน์โหลดและเรียกใช้ไฟล์ bootstrap_4.50.00.sh โดยทำดังนี้ 
      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
sudo bash /tmp/bootstrap_4.50.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 ไม่สำเร็จ คุณสามารถลองแก้ไขปัญหา แล้วเรียกใช้โปรแกรมติดตั้งอีกครั้ง โปรแกรมติดตั้งออกแบบมาเพื่อให้ทำงานซ้ำได้ในกรณีที่ตรวจพบความล้มเหลว หรือในกรณีที่คุณต้องการเปลี่ยนหรืออัปเดตคอมโพเนนต์ในภายหลังหลังจากการติดตั้ง

หลังจากติดตั้งหรืออัปเกรดแล้ว อย่าลืมรีสตาร์ทคอมโพเนนต์ UI ของ Edge ในโหนดแต่ละโหนดที่ใช้งานอยู่

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

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

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

    โหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee เพื่อติดตั้ง RPM และข้อกำหนดของ Edge

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

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

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

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

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

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

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

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

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

ส่วนประกอบ ตำแหน่ง

เซิร์ฟเวอร์การจัดการ

 /opt/apigee/var/log/edge-management-server

เราเตอร์

 /opt/apigee/var/log/edge-router

ติดตั้งใช้งาน Edge Router โดยใช้ Nginx ดูบันทึกเพิ่มเติมได้จากหัวข้อต่อไปนี้

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

Message Processor

 /opt/apigee/var/log/edge-message-processor

เซิร์ฟเวอร์ Qpid ของ Apigee

 /opt/apigee/var/log/edge-qpid-server
เซิร์ฟเวอร์ Apigee Postgres /opt/apigee/var/log/edge-postgres-server
UI แบบคลาสสิก (ไม่ใช่ UI ใหม่ของ Edge ซึ่งมีชื่อคอมโพเนนต์ว่า edge-management-ui) /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra/system.log
Qpidd /opt/apigee/var/log/apigee-qpidd
ฐานข้อมูล PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

ข้อมูล

ส่วนประกอบ ตำแหน่ง
เซิร์ฟเวอร์การจัดการ /opt/apigee/data/edge-management-server
เราเตอร์ /opt/apigee/data/edge-router
Message Processor /opt/apigee/data/edge-message-processor
Agent Qpid ของ Apigee /opt/apigee/data/edge-qpid-server
Agent ของ Apigee Postgres /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
ฐานข้อมูล PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

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

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

ENABLE_SYSTEM_CHECK=y

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