หน้านี้ได้รับการแปลโดย Cloud Translation API

อัปเดต Apigee Edge 4.16.05.x เป็น 4.16.05 รุ่นล่าสุด

Edge for Private Cloud เวอร์ชัน 4.16.05

เอกสารนี้มีขั้นตอนที่คุณใช้เพื่ออัปเดตการติดตั้ง 4.16.05 ที่มีอยู่ เพื่อใช้ RPM ล่าสุดและไฟล์สนับสนุนจาก Apigee ขั้นตอนนี้ใช้ยูทิลิตี update.sh เพื่อดำเนินการอัปเดต

คุณอัปเดต Edge เวอร์ชันใดได้บ้าง เป็นรุ่นล่าสุด 4.16.05

คุณจะอัปเดตการติดตั้ง Apigee Edge เวอร์ชัน 4.16.05.x ที่มีอยู่เป็นเวอร์ชันล่าสุดได้เท่านั้น รุ่น 4.16.05

หากคุณกำลังใช้ Edge เวอร์ชัน 4.16.01.0x หรือเวอร์ชันก่อนหน้านั้น คุณต้องย้ายข้อมูลไปยัง 4.16.05. ดูอัปเดต Apigee Edge 4.16.01 เป็น 4.16.05 สำหรับข้อมูลเกี่ยวกับวิธีย้ายข้อมูลไปยังเวอร์ชัน 4.16.05

ใครอัปเดตได้บ้าง

ผู้ใช้ที่เรียกใช้การอัปเดตควรเป็นผู้ใช้เดียวกับผู้ใช้ที่ติดตั้ง Edge ไว้ก่อนหน้านี้ หรือ ผู้ใช้ที่เรียกใช้ในฐานะผู้ใช้ระดับราก

หลังจากติดตั้ง Edge RPM แล้ว ผู้ใช้ทุกคนจะกำหนดค่าได้

ความต้องการพื้นที่ในดิสก์สำหรับการอัปเดต

ตรวจสอบว่ามีพื้นที่ว่างในดิสก์อย่างน้อย 1 GB ก่อนดำเนินการ อัปเดต

การเผยแพร่พร็อพเพอร์ตี้โดยอัตโนมัติ การตั้งค่าจาก 4.16.05.x

หากคุณตั้งค่าพร็อพเพอร์ตี้ใดๆ โดยการแก้ไขไฟล์ .properties ใน /opt/apigee/customer/application ให้ใช้ข้อมูลต่อไปนี้ ค่าจะยังคงอยู่ตามการอัปเดต

อัปเดตข้อกำหนดเบื้องต้น

โปรดอ่านข้อกำหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge

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

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

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

การจัดการการอัปเดตที่ล้มเหลว

ในกรณีที่อัปเดตไม่สำเร็จ ให้ลองแก้ไขปัญหาแล้วเรียกใช้ update.sh อีกครั้ง คุณเรียกใช้การอัปเดตได้หลายครั้งและจะอัปเดตต่อจากที่ค้างไว้ ปิดอยู่

หากความล้มเหลวกำหนดให้คุณต้องย้อนกลับการอัปเดตเป็นเวอร์ชันก่อนหน้า โปรดดู 4.16.05 กระบวนการย้อนกลับ

ข้อมูลการอัปเดตการบันทึก

โดยค่าเริ่มต้นไฟล์ update.sh จะเขียนข้อมูลบันทึกไปที่:

/opt/apigee/var/log/apigee-setup/update.log

หากผู้ใช้ที่เรียกใช้ยูทิลิตี update.sh ไม่มีสิทธิ์เข้าถึง ไดเรกทอรีนั้น ไฟล์จะเขียนบันทึกไปยังไดเรกทอรี /tmp เป็นไฟล์ชื่อ update_username.log

หากผู้ใช้ไม่มีสิทธิ์เข้าถึง /tmp ยูทิลิตี update.sh ล้มเหลว

การอัปเดตไม่มีช่วงพัก

การอัปเดตแบบไม่มีช่วงพักหรือการอัปเดตต่อเนื่องช่วยให้คุณอัปเดตการติดตั้ง Edge ได้โดยไม่ต้อง นำ Edge ลงมา

การอัปเดตไม่มีช่วงพักจะทำได้ในกรณีที่กำหนดค่า 5 โหนดขึ้นไปเท่านั้น

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

อัปเดตเครื่องตามลำดับที่ถูกต้องสำหรับการติดตั้งตามที่อธิบายไว้ด้านล่างใน "คำสั่งซื้อ ของการอัปเดตเครื่อง"
เมื่อถึงเวลาอัปเดตเราเตอร์ ให้เลือกเราเตอร์หนึ่งตัวและทำให้ไม่สามารถเข้าถึงได้ เช่น ที่อธิบายไว้ในส่วนถัดไป "การทำให้ไม่สามารถเข้าถึง Router และ Message Processor"
อัปเดตเราเตอร์ที่เลือกและคอมโพเนนต์ Edge อื่นๆ ทั้งหมดบนเครื่องเดียวกันกับเราเตอร์ การกำหนดค่า Edge ทั้งหมดจะแสดงเราเตอร์และผู้ประมวลผลข้อความในโหนดเดียวกัน
ทำให้เราเตอร์เข้าถึงได้อีกครั้ง
ทำซ้ำขั้นตอนที่ 2 ถึง 4 สำหรับเราเตอร์ที่เหลือ
อัปเดตเครื่องที่เหลือในการติดตั้งต่อ

การสร้างเราเตอร์และ เข้าถึงโปรแกรมประมวลผลข้อความไม่ได้

ในการตั้งค่าเวอร์ชันที่ใช้งานจริง คุณจะมีเราเตอร์และ Message Processor หลายรายการ ประสิทธิภาพสูงสุดและคุณต้องเปิด/ปิดใช้ความสามารถในการเข้าถึงของเราเตอร์และข้อความเหล่านี้ โปรเซสเซอร์ก่อน/หลังการอัปเดต

การเรียก API ต่อไปนี้จะกำหนดค่าโหนดเป็นเข้าถึงหรือเข้าถึงไม่ได้

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

โดยที่ UUID คือ UUID ของผู้ประมวลผลข้อความหรือเราเตอร์ และ การเข้าถึงได้มีการตั้งค่าเป็น "จริง" หรือ "เท็จ"

ถ้าคุณต้องการระบุ UUID ของเราเตอร์ ให้ใช้คำสั่ง cURL ต่อไปนี้

> curl http://<routerIP>:8081/v1/servers/self

ถ้าคุณต้องการระบุ UUID ของโปรแกรมประมวลผลข้อความ ให้ใช้ cURL ต่อไปนี้ คำสั่ง:

> curl http://<mpIP>:8082/v1/servers/self

ดูแลสิ่งต่อไปนี้ก่อน/หลังการอัปเดต

ในโหนดเราเตอร์และโหนดตัวประมวลผลข้อความแบบรวม:
- ก่อนการอัปเดต ให้ดำเนินการดังนี้
  1. ทำให้เข้าถึงเราเตอร์ไม่ได้โดยใช้การเรียก API ที่แสดงด้านบน
  2. ทำให้ไม่สามารถเข้าถึงโปรแกรมประมวลผลข้อความได้
- หลังจากการอัปเดต - ให้ดำเนินการต่อไปนี้
  1. ทำให้โปรแกรมประมวลผลข้อความสามารถเข้าถึงได้
  2. ทำให้เราเตอร์เข้าถึงได้
ในโหนดเราเตอร์เดี่ยว:
- ตั้งค่าเราเตอร์ให้เข้าถึงได้ก่อนอัปเดต
- หลังจากอัปเดตแล้ว ให้ทําให้เข้าถึงเราเตอร์ได้
ในโหนดตัวประมวลผลข้อความเดี่ยว:
- ทำให้ไม่สามารถเข้าถึงโปรแกรมประมวลผลข้อความได้ก่อนที่จะอัปเดต
- หลังจากอัปเดต ตั้งค่า Message Processor ให้เข้าถึงได้

การใช้ไฟล์การกำหนดค่าที่ผู้ใช้ไม่ต้องดำเนินการ

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

ขั้นตอนการอัปเดต 4.16.05 บนโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

ใช้ขั้นตอนต่อไปนี้เพื่ออัปเดตคอมโพเนนต์ Edge ในโหนด

หากมี ให้ปิดใช้งาน CRON ที่กำหนดค่าไว้เพื่อดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณดำเนินการ Edge ได้ การกำหนดค่าที่ไม่มีสิทธิ์เข้าถึงราก
ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้ง Edge apigee-setup ยูทิลิตี
ทำความสะอาดแคชของ Yum ทั้งหมด โดยทำดังนี้
> น่าอร่อยจริงๆ
ดาวน์โหลดไฟล์ Edge Bootstrap_4.16.05.sh ล่าสุด /tmp/bootstrap_4.16.05.sh:
> Curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
อัปเดตยูทิลิตีและบริการ Dependency ของ Edge Apigee:
> Sudo Bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากไม่ป้อน pWord ระบบจะแจ้งให้คุณป้อน
ใช้ apigee-service เพื่ออัปเดตยูทิลิตีการตั้งค่า Apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup อัปเดต

การอัปเดต apigee-service จะติดตั้งยูทิลิตี update.sh ใน /<inst_dir>/apigee/apigee-setup/bin
เรียกใช้ยูทิลิตีการอัปเดตบนโหนดของคุณตามลำดับที่อธิบายด้านล่างใน "ลำดับของเครื่อง อัปเดต" ด้านล่าง:
> /opt/apigee/apigee-setup/bin/update.sh -c คอมโพเนนต์ -f configFile

ข้อกำหนดเพียงอย่างเดียวในไฟล์การกำหนดค่าคือ ไฟล์การกำหนดค่าต้องเข้าถึงได้ หรือ อ่านได้โดย "apigee" ผู้ใช้ ตัวอย่างเช่น วางไฟล์ไว้ในไดเรกทอรี /tmp ใน

ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการที่เป็นไปได้ ประกอบด้วย
- LDAP = OpenLDAP
- cs = คาสแซนเดอร์
- zk = Zookeeper
- qpid = qpidd
- ps = Postgresql
- edge =คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI ได้แก่ เซิร์ฟเวอร์การจัดการ, ตัวประมวลผลข้อความ, เราเตอร์ เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
- ui = Edge UI
- all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้สำหรับโปรไฟล์การติดตั้ง Edge Aio เท่านั้น หรือโปรไฟล์การติดตั้ง API BaaS Asa)
- e = ElasticSearch
- b = สแต็ก API BaaS
- p = พอร์ทัล API BaaS
- ebp = ElasticSearch, สแต็ก API BaaS และ API BaaS ในโหนดเดียวกัน
ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ทดสอบการติดตั้ง

ขั้นตอนการอัปเดต 4.16.05 จากในเครื่อง ที่เก็บ

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

หลังจากสร้างที่เก็บ Edge ในเครื่องแล้ว คุณจะมี 2 ตัวเลือกในการอัปเดต Edge จาก ที่เก็บในท้องถิ่น:

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

วิธีอัปเดตจากที่เก็บในเครื่อง 4.16.05

ตรวจสอบว่าคุณมีที่เก็บในเครื่อง 4.16.05 ตามที่อธิบายไว้ในหัวข้อติดตั้งคอมโพเนนต์ Edge ใน โหนด
อัปเดตที่เก็บในเครื่อง:
1. ดาวน์โหลดไฟล์ Edge bootstrap_4.16.05.sh ล่าสุดลงใน /tmp/bootstrap_4.16.05.sh:
  Curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. ดำเนินการซิงค์ โดยทำดังนี้
  > /opt/apigee/apigee-service/bin/apigee-service ซิงค์ apigee-Mirror --only-new-rpms
วิธีติดตั้ง apigee-service จากไฟล์ .tar
1. ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่อง ลงในไฟล์ .tar ไฟล์เดียวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz ดังนี้
  /opt/apigee/apigee-service/bin/apigee-service แพ็กเกจ apigee-Mirror
2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge ตัวอย่างเช่น คัดลอกไปที่ ไดเรกทอรี /tmp ใน โหนดใหม่
3. ในโหนดใหม่ ให้ยกเลิกการอัปโหลดไฟล์ไปยังไดเรกทอรี /tmp:
  tar -Xzf apigee-4.16.05.tar.gz
  
  คำสั่งนี้จะสร้างไดเรกทอรีใหม่ที่ชื่อว่า repos ในไดเรกทอรีที่มี .tar เช่น /tmp/repos
4. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
  หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณดำเนินการ Edge ได้ การกำหนดค่าที่ไม่มีสิทธิ์เข้าถึงราก
5. ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้ง Edge ยูทิลิตีการตั้งค่า Apigee
6. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency จาก /tmp/repos:
  > Sudo Bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  คุณจะเห็นว่าใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้ Nginx webserver" ที่ ติดตั้ง คอมโพเนนต์ Edge บนโหนด
2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge Bootstrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งค่าไว้ด้านบนสำหรับ ที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของ โหนดที่เก็บ
3. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
  หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณดำเนินการ Edge ได้ การกำหนดค่าที่ไม่มีสิทธิ์เข้าถึงราก
4. ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้ง Edge ยูทิลิตีการตั้งค่า Apigee
5. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตีและบริการ Apigee ของ Edge และทรัพยากร Dependency:
  > Sudo Bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่เก็บ
หากมี ให้ปิดใช้งาน CRON ที่กำหนดค่าไว้เพื่อดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
ใช้ apigee-service เพื่ออัปเดตยูทิลิตีการตั้งค่า Apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup อัปเดต

การอัปเดต apigee-service จะติดตั้งยูทิลิตีupdate.sh ใน <inst_dir>/apigee/apigee-setup/bin
เรียกใช้ยูทิลิตีการอัปเดตบนโหนดของคุณตามลำดับที่อธิบายด้านล่างใน "ลำดับของเครื่อง อัปเดต" ด้านล่าง:
> /opt/apigee/apigee-setup/bin/update.sh -c คอมโพเนนต์ -f configFile

ข้อกำหนดเพียงอย่างเดียวในไฟล์การกำหนดค่าคือ ไฟล์การกำหนดค่าต้องเข้าถึงได้ หรือ อ่านได้โดย "apigee" ผู้ใช้ ตัวอย่างเช่น วางไฟล์ไว้ในไดเรกทอรี /tmp ใน

ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการที่เป็นไปได้ ประกอบด้วย
- LDAP = OpenLDAP
- cs = คาสแซนเดอร์
- zk = Zookeeper
- qpid = qpidd
- ps = Postgresql
- edge =คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI ได้แก่ เซิร์ฟเวอร์การจัดการ, ตัวประมวลผลข้อความ, เราเตอร์ เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
- ui = Edge UI
- all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้สำหรับโปรไฟล์การติดตั้ง Edge Aio เท่านั้น หรือโปรไฟล์การติดตั้ง API BaaS Asa)
- e = ElasticSearch
- b = สแต็ก API BaaS
- p = พอร์ทัล API BaaS
- ebp = ElasticSearch, สแต็ก API BaaS และ API BaaS ในโหนดเดียวกัน
ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตีตรวจสอบ Apigee และทดสอบการติดตั้ง

ลำดับของการอัปเดตเครื่อง

คุณจำเป็นต้องอัปเดตเครื่องในการติดตั้ง Edge มากที่สุด สิ่งสำคัญที่ควรพิจารณาเพื่ออัปเดตมีดังนี้

คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนที่จะอัปเดต โหนดอื่นๆ
คุณต้องอัปเดตโหนด qpidd และ postgresql ทั้งหมดก่อนที่จะอัปเดต โหนดเราเตอร์และโหนดตัวประมวลผลข้อความ
สําหรับเครื่องใดก็ตามที่มีคอมโพเนนต์ Edge หลายรายการ (เซิร์ฟเวอร์การจัดการ, Message Processor เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres) ใช้ "-c edge" ตัวเลือกการอัปเดตการตั้งค่า
หากขั้นตอนระบุว่าควรดำเนินการในหลายเครื่อง ให้ดำเนินการใน ลำดับเครื่องที่ระบุ
เราไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ โดยจะอัปเดตเมื่อระบุ "-c" ขอบ" ตัวเลือก
หลังจากอัปเดตโหนดเราเตอร์แล้ว คุณต้องนำไฟล์ทั้งหมดออกจากไดเรกทอรี /opt/nginx/conf.d จากนั้นให้รีสตาร์ทเราเตอร์