การติดตั้ง Edge โดยทั่วไปจะประกอบไปด้วยคอมโพเนนต์ Edge ที่กระจายไปยังโหนดหลายโหนด หลังจากติดตั้ง Edge ในโหนดแล้ว คุณจะติดตั้งและกำหนดค่าคอมโพเนนต์ Edge อย่างน้อย 1 รายการในโหนดนั้น
ขั้นตอนการติดตั้ง
การติดตั้ง Edge บนโหนดเป็นกระบวนการที่มีหลายขั้นตอน ดังนี้
- ปิดใช้ SELinux ในโหนดหรือตั้งค่าเป็นโหมดอนุญาต โปรดดูข้อมูลเพิ่มเติมที่ติดตั้งยูทิลิตี Edge Apigee-setup
- เลือกว่าต้องการเปิดใช้การตรวจสอบสิทธิ์ Cassandra ไหม
- ตัดสินใจว่าคุณต้องการตั้งค่าการจำลองสแตนด์บายหลักสำหรับ Postgres หรือไม่
- เลือกการกำหนดค่า Edge จากรายการโทโพโลยีที่แนะนำ เช่น คุณอาจติดตั้ง Edge บนโหนดเดียวสำหรับการทดสอบ หรือใน 13 โหนดสำหรับเวอร์ชันที่ใช้งานจริง ดูข้อมูลเพิ่มเติมได้ที่โทโพโลยีการติดตั้ง
- ติดตั้งยูทิลิตี Edge
apigee-setup
ในแต่ละโหนดของโทโพโลยีที่เลือก- ดาวน์โหลดไฟล์ Edge
bootstrap_4.51.00.sh
ไปยัง/tmp/bootstrap_4.51.00.sh
- ติดตั้งยูทิลิตีและทรัพยากร Dependency
apigee-service
Edge - ติดตั้งยูทิลิตีและทรัพยากร Dependency
apigee-setup
Edgeโปรดดูข้อมูลเพิ่มเติมที่ติดตั้งยูทิลิตี Edge Apigee-setup
- ดาวน์โหลดไฟล์ Edge
- ใช้ยูทิลิตี
apigee-setup
เพื่อติดตั้งคอมโพเนนต์ Edge อย่างน้อย 1 รายการในแต่ละโหนดโดยอิงตามโทโพโลยีที่เลือกโปรดดูหัวข้อติดตั้งคอมโพเนนต์ Edge ในโหนด
- ในโหนด Management Server ให้ใช้ยูทิลิตี
apigee-setup
เพื่อติดตั้งapigee-provision
ซึ่งเป็นยูทิลิตีที่คุณใช้สร้างและจัดการองค์กร Edgeโปรดดูข้อมูลเพิ่มเติมที่เริ่มต้นใช้งานองค์กร
- รีสตาร์ทคอมโพเนนต์ UI แบบคลาสสิกในแต่ละโหนดหลังจากการติดตั้งเสร็จสมบูรณ์ ตามตัวอย่างต่อไปนี้
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(แนะนำ) หลังจากติดตั้งครั้งแรกเสร็จแล้ว Apigee ขอแนะนำให้คุณติดตั้ง Edge UI ใหม่ (ที่มีชื่อคอมโพเนนต์คือ
edge-management-ui
) ซึ่งเป็นอินเทอร์เฟซผู้ใช้ที่มีประสิทธิภาพมากขึ้นสำหรับนักพัฒนาซอฟต์แวร์และผู้ดูแลระบบของ Apigee Edge สำหรับ Private Cloudโปรดดูข้อมูลเพิ่มเติมที่ติดตั้ง Edge UI ใหม่
หลังจากติดตั้งเสร็จแล้ว ให้ดูรายการการดำเนินการทั่วไปหลังการติดตั้ง
ผู้ที่มีสิทธิ์ติดตั้ง
ไฟล์การกระจาย Apigee Edge จะได้รับการติดตั้งเป็นชุด RPM และทรัพยากร Dependency หากต้องการติดตั้ง ถอนการติดตั้ง และอัปเดต RPM ของ Edge ผู้ใช้รูทหรือผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็มต้องเรียกใช้คำสั่ง สำหรับการเข้าถึง sudo เต็มรูปแบบ หมายความว่าผู้ใช้มีสิทธิ์เข้าถึง sudo เพื่อดำเนินการเช่นเดียวกับรูท
ผู้ใช้ที่ต้องการเรียกใช้คำสั่งหรือสคริปต์ต่อไปนี้ต้องเป็นรูทหรือเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง sudo เต็มรูปแบบ
- ยูทิลิตี apigee-service:
- คำสั่ง apigee-service:
install, uninstall, update
- คำสั่ง apigee-all:
install, uninstall, update
- คำสั่ง apigee-service:
- สคริปต์ 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
- apigee-service เช่น
การสร้างผู้ใช้ที่มีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์
หากต้องการกำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์ ให้ใช้คำสั่ง "visudo" เพื่อแก้ไขไฟล์ sudoers เพื่อเพิ่ม:
installUser ALL=(apigee) NOPASSWD: ALL
โดย installUser คือชื่อผู้ใช้ของบุคคลที่ทำงานร่วมกับ Edge
การตั้งค่าสิทธิ์ในไฟล์การกำหนดค่า
ผู้ใช้ "Apigee" ต้องเข้าถึงไฟล์หรือทรัพยากรที่คำสั่ง Edge ได้ ซึ่งรวมถึงไฟล์ใบอนุญาต Edge และไฟล์การกำหนดค่าทั้งหมด
เมื่อสร้างไฟล์การกำหนดค่า คุณจะเปลี่ยนเจ้าของเป็น "apigee:apigee" ได้ เพื่อให้มั่นใจว่าคําสั่ง Edge จะเข้าถึงไฟล์ดังกล่าวได้
- สร้างไฟล์ในเครื่องมือแก้ไขในฐานะผู้ใช้ใดก็ได้
chown
ให้เจ้าของไฟล์เป็น "apigee:apigee" หรือหากคุณเปลี่ยนผู้ใช้ที่เรียกใช้บริการ Edge จากผู้ใช้ "apigee" ให้เปลี่ยนชื่อไฟล์เป็นผู้ใช้ที่ใช้งานบริการ Edge
การแยกงานการติดตั้ง Edge ระหว่างผู้ใช้รูทและผู้ใช้ที่ไม่ใช่รูท
แม้ว่ากระบวนการติดตั้ง Edge ทั้งหมดจะเป็นวิธีรูทหรือโดยผู้ใช้ที่มีสิทธิ์เข้าถึง sudo โดยสมบูรณ์ที่ง่ายที่สุด แต่ก็เป็นไปไม่ได้เสมอไป แต่คุณแยกกระบวนการออกเป็นงานที่ดำเนินการโดยรูทและงานที่ดำเนินการโดยผู้ใช้ซึ่งมีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์แทนได้
- งานที่ดำเนินการโดยรูท:
- ดาวน์โหลดและเรียกใช้ไฟล์
bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
ขั้นตอนนี้จะติดตั้งยูทิลิตี
apigee-service
และสร้างผู้ใช้ "apigee" - กำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์ตามที่อธิบายไว้ใน การสร้างผู้ใช้ที่มีสิทธิ์การเข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee"
- ติดตั้งยูทิลิตี
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- ใช้ยูทิลิตี
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
- ดาวน์โหลดและเรียกใช้ไฟล์
- หลังจากที่ผู้ใช้รูทติดตั้ง RPM ของ Edge ในโหนดแล้ว ผู้ใช้ที่มีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์จะดำเนินการกำหนดค่าจนเสร็จสมบูรณ์ดังนี้
- ใช้ยูทิลิตี
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 และ Dependencies
- โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee ของเวอร์ชันมิเรอร์ที่คุณตั้งค่าภายในได้ ที่เก็บนี้มี RPM ของ Edge ทั้งหมด แต่คุณต้องตรวจสอบว่ามีทรัพยากร Dependency อื่นๆ ที่ใช้ได้จากที่เก็บในเครือข่ายภายใน
หากต้องการสร้างที่เก็บ Apigee ภายใน คุณต้องมีโหนดที่มีสิทธิ์เข้าถึงอินเทอร์เน็ตภายนอกจึงจะดาวน์โหลด Edge RPM และทรัพยากร Dependency ได้ เมื่อสร้างที่เก็บภายในแล้ว คุณจะย้ายไปยังโหนดอื่นหรือกำหนดให้โหนด Edge เข้าถึงโหนดดังกล่าวเพื่อติดตั้งได้
การใช้ที่เก็บ Edge ในเครื่องเพื่อรักษาเวอร์ชัน Edge ของคุณ
หนึ่งในเหตุผลที่ควรใช้ที่เก็บในเครื่องหรือที่มิเรอร์คือการติดตั้ง Edge บนโหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกตามที่อธิบายไว้ในส่วนก่อนหน้า
การแก้ไขการอ้างอิงการติดตั้ง RPM
ไฟล์การกระจาย Apigee Edge จะได้รับการติดตั้งเป็นชุดไฟล์ RPM ซึ่งแต่ละไฟล์จะมีเชนทรัพยากร Dependency การติดตั้งของตัวเองได้ ทรัพยากร Dependency เหล่านี้หลายรายการกำหนดโดยคอมโพเนนต์ของบุคคลที่สามซึ่งอยู่นอกเหนือการควบคุมของ Apigee และมีการเปลี่ยนแปลงได้ตลอดเวลา ดังนั้นเอกสารประกอบจะไม่แสดงหมายเลขเวอร์ชันที่ชัดเจนของทรัพยากร Dependency แต่ละรายการ
หากคุณกำลังติดตั้งบนเครื่องที่มีการเข้าถึงอินเทอร์เน็ต โหนดจะดาวน์โหลด RPM และทรัพยากร Dependency ที่จำเป็นได้ อย่างไรก็ตาม หากติดตั้งจากโหนดที่ไม่มีการเข้าถึงอินเทอร์เน็ต โดยปกติแล้วระบบจะตั้งค่าที่เก็บภายในที่มีทรัพยากร Dependency ที่จำเป็นทั้งหมด วิธีเดียวที่จะรับประกันว่าทรัพยากร Dependency ทั้งหมดจะรวมอยู่ในที่เก็บในเครื่องคือการพยายามติดตั้ง ค้นหาทรัพยากร Dependency ที่ขาดหายไป และคัดลอกทรัพยากรดังกล่าวไปยังที่เก็บในเครื่องจนกว่าการติดตั้งจะสำเร็จ
คำสั่ง Common 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 Operations Guide ไดเรกทอรีการติดตั้งรูทจะมีข้อความระบุไว้ดังนี้
/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 โดยใช้ NGINX โปรดดูบันทึกเพิ่มเติมที่
|
Message Processor |
/opt/apigee/var/log/edge-message-processor
|
เซิร์ฟเวอร์ Apigee Qpid |
/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 |
คพิดด์ | /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 ของ Apigee Qpid | /opt/apigee/data/edge-qpid-server |
ตัวแทน 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 |
คพิดด์ | /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" เพื่อปิดใช้การตรวจสอบ