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

Edge for Private Cloud v. 4.17.01

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

กระบวนการติดตั้ง

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

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

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

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

ผู้ใช้ที่ต้องการเรียกใช้คำสั่งหรือสคริปต์ต่อไปนี้ต้องเป็นรูทหรือเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็ม

• ยูทิลิตี apigee-service
  • คำสั่ง apigee-service: install, uninstall, update
  • คำสั่ง apigee-all: install, install, 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" ให้แก้ไขไฟล์ sudoers เพื่อเพิ่มข้อมูลต่อไปนี้

installUser        ALL=(apigee)      NOPASSWD: ALL

โดยที่ installUser คือชื่อผู้ใช้ของบุคคลที่ทำงานกับ Edge

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

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

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

ตำแหน่งของไฟล์การกำหนดค่าการติดตั้ง

คุณต้องส่งไฟล์การกําหนดค่าไปยังยูทิลิตี apigee-setup ที่มีข้อมูลเกี่ยวกับการติดตั้ง Edge ข้อกำหนดเดียวในการติดตั้งแบบเงียบคือผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้ เช่น วางไฟล์ในไดเรกทอรี /usr/local/var หรือ /usr/local/share ในโหนด แล้วใช้คำสั่ง chown เปลี่ยนความเป็นเจ้าของเป็น "apigee:apigee"

ต้องระบุข้อมูลทั้งหมดในไฟล์การกำหนดค่า ยกเว้นรหัสผ่านของผู้ดูแลระบบระบบ Edge หากไม่ใส่รหัสผ่าน ยูทิลิตี apigee-setup จะให้คุณป้อนรหัสผ่านในบรรทัดคำสั่ง

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

การจัดการความล้มเหลวในการติดตั้ง

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

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

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

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

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

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

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

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

รีพอยต์ที่มิเรอร์มีความยืดหยุ่นมาก เช่น คุณสามารถสร้างที่เก็บข้อมูลที่มิเรอร์จาก RPM ของ Edge เวอร์ชันล่าสุดหรือจาก Edge เวอร์ชันที่เฉพาะเจาะจง หลังจากสร้างที่เก็บแล้ว คุณจะอัปเดตที่เก็บเพื่อเพิ่ม RPM จาก Edge เวอร์ชันต่างๆ ได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge

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

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

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

คำสั่งทั่วไปของ Yum

เครื่องมือการติดตั้ง Edge สำหรับ Linux จะใช้ Yum เพื่อติดตั้งและอัปเดตคอมโพเนนต์ คุณอาจต้องใช้คำสั่ง Yum หลายรายการเพื่อจัดการการติดตั้งบนโหนด

• ล้างแคช Yum ทั้งหมดโดยทำดังนี้
  sudo yum clear all
• วิธีอัปเดตคอมโพเนนต์ Edge
  sudo yum update componentName
  เช่น
  sudo yum update apigee-setup
  sudo yum update edge-management-server

โครงสร้างระบบไฟล์

Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee

ในคู่มือนี้และในคู่มือการดำเนินการ Edge ไดเรกทอรีการติดตั้งรูทจะระบุไว้ดังนี้

<inst_root>/apigee

การติดตั้งใช้โครงสร้างระบบไฟล์ต่อไปนี้เพื่อทำให้ Apigee Edge สำหรับ Private Cloud ใช้งานได้

ไฟล์บันทึก

ระบบจะเขียนไฟล์บันทึกของ apigee-setup และสคริปต์ setup.sh ลงใน /tmp/setup-root.log

ไฟล์บันทึกของคอมโพเนนต์แต่ละรายการอยู่ในไดเรกทอรี /opt/apigee/var/log คอมโพเนนต์แต่ละรายการจะมีไดเรกทอรีย่อยของตัวเอง เช่น บันทึกสำหรับเซิร์ฟเวอร์การจัดการจะอยู่ในไดเรกทอรีต่อไปนี้

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

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

คอมโพเนนต์	ตำแหน่ง
เซิร์ฟเวอร์การจัดการ	<inst_root>/apigee/var/log/edge-management-server
เราเตอร์	<inst_root>/apigee/var/log/edge-router
Message Processor	<inst_root>/apigee/var/log/edge-message-processor
เซิร์ฟเวอร์ Apigee Qpid	<inst_root>/apigee/var/log/edge-qpid-server
เซิร์ฟเวอร์ Postgres ของ Apigee	<inst_root>/apigee/var/log/edge-postgres-server
UI ของ Edge	<inst_root>/apigee/var/log/edge-ui
ZooKeeper	<inst_root>/apigee/var/log/apigee-zookeeper
OpenLDAP	<inst_root>/apigee/var/log/apigee-openldap
Cassandra	<inst_root>/apigee/var/log/apigee-cassandra
Qpidd	<inst_root>/apigee/var/log/apigee-qpidd
ฐานข้อมูล PostgreSQL	<inst_root>/apigee/var/log/apigee-postgresql

ข้อมูล

คอมโพเนนต์	ตำแหน่ง
เซิร์ฟเวอร์การจัดการ	<data_root>/apigee/data/edge-management-server
เราเตอร์	&lt;data_root&gt;/apigee/data/edge-router
Message Processor	<data_root>/apigee/data/edge-message-processor
Agent Qpid ของ Apigee	<data_root>/apigee/data/edge-qpid-server
Agent ของ Apigee Postgres	&lt;data_root&gt;/apigee/data/edge-postgres-server
ZooKeeper	<data_root>/apigee/data/apigee-zookeeper
OpenLDAP	<data_root>/apigee/data/apigee-openldap
Cassandra	<data_root>/apigee/data/apigee-cassandra/data
Qpidd	<data_root>/apigee/data/apigee-qpid/data
ฐานข้อมูล PostgreSQL	<data_root>/apigee/data/apigee-postgres/pgdata

งานหลังการติดตั้ง

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

การกำหนดค่าคอมโพเนนต์ของ Edge หลังการติดตั้ง

หากต้องการกำหนดค่า Edge หลังจากการติดตั้ง คุณจะใช้ไฟล์ .properties ร่วมกับยูทิลิตีของ Edge เช่น หากต้องการกำหนดค่า TLS/SSL ใน UI ของ Edge คุณต้องแก้ไขไฟล์ .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 action

เช่น หากต้องการรีสตาร์ท 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
• baas - คอมโพเนนต์ BaaS ของ API เช่น baas-usergrid

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

• เริ่ม หยุด รีสตาร์ท
• สถานะ, เวอร์ชัน
• backup, restore
• ติดตั้ง, ถอนการติดตั้ง