การติดตั้ง Edge ทั่วไปประกอบด้วยคอมโพเนนต์ Edge ที่กระจายอยู่ในโหนดหลายรายการ หลังจากติดตั้ง Edge บนโหนดแล้ว ให้ติดตั้งและกำหนดค่าคอมโพเนนต์ Edge อย่างน้อย 1 รายการในโหนด
ขั้นตอนการติดตั้ง
การติดตั้ง Edge บนโหนดเป็นกระบวนการที่มีหลายขั้นตอน
- ปิดใช้ SELinux ในโหนดหรือตั้งค่าเป็นโหมดอนุญาต โปรดดูข้อมูลเพิ่มเติมที่ติดตั้งยูทิลิตีการตั้งค่า Edge Apigee
- ตัดสินใจว่าคุณต้องการเปิดใช้การตรวจสอบสิทธิ์ Cassandra หรือไม่
- ตัดสินใจว่าคุณต้องการตั้งค่าการจำลองในโหมดต้นฉบับสำหรับ Postgres หรือไม่
- เลือกการกำหนดค่า Edge จากรายการโทโพโลยีที่แนะนำ เช่น คุณอาจติดตั้ง Edge บนโหนดเดียวสำหรับการทดสอบ หรือติดตั้งใน 13 โหนดสำหรับเวอร์ชันที่ใช้งานจริง ดูข้อมูลเพิ่มเติมได้ที่โทโพโลยีการติดตั้ง
- ติดตั้งยูทิลิตี Edge
apigee-setup
ในแต่ละโหนดของโทโพโลยีที่เลือก- ดาวน์โหลดไฟล์ Edge
bootstrap_4.52.01.sh
ไปยัง/tmp/bootstrap_4.52.01.sh
- ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge
apigee-service
- ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge
apigee-setup
โปรดดูข้อมูลเพิ่มเติมที่ติดตั้งยูทิลิตี 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.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.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
Edge RPM ที่คุณติดตั้งบนโหนดจะขึ้นอยู่กับโทโพโลยีของคุณ รายการคอมโพเนนต์ที่ใช้ได้ ได้แก่
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
- ดาวน์โหลดและเรียกใช้ไฟล์
- หลังจากที่ผู้ใช้รูทติดตั้ง Edge RPM บนโหนดแล้ว ผู้ใช้ที่มีสิทธิ์เข้าถึง 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 และการอ้างอิง
- โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee เวอร์ชันมิเรอร์ที่คุณตั้งค่าภายในได้ ที่เก็บนี้มี RPM ทั้งหมด แต่คุณต้องตรวจสอบว่ามีทรัพยากร Dependency อื่นๆ ทั้งหมดที่พร้อมใช้งานจากที่เก็บในเครือข่ายภายใน
หากต้องการสร้างที่เก็บ Apigee ภายใน คุณต้องมีโหนดที่มีสิทธิ์เข้าถึงอินเทอร์เน็ตภายนอกจึงจะดาวน์โหลด Edge RPM และ Dependencies ได้ เมื่อสร้างที่เก็บภายในแล้ว คุณจะย้ายไปยังโหนดอื่นหรือทำให้โหนด 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 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 Router ใช้งานโดยใช้ 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 แบบคลาสสิก (ไม่ใช่ Edge UI ใหม่ที่มีชื่อคอมโพเนนต์คือ 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 |
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 |
คพิดด์ | /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" เพื่อปิดใช้การตรวจสอบ