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

อัปเดต Apigee Edge 4.17.01 เป็น 4.17.05

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

Edge เวอร์ชันใดที่คุณอัปเดตเป็น 4.17.05 ได้

คุณอัปเดต Apigee Edge เวอร์ชัน 4.17.01.0x เป็น 4.17.05 ได้โดยใช้ขั้นตอนนี้

หากมี Edge เวอร์ชันก่อนหน้าเป็นเวอร์ชัน 4.16.01 คุณจะต้องย้ายข้อมูลไปยัง เวอร์ชัน 4.16.01.x จากนั้นอัปเดตเป็นเวอร์ชัน 4.17.01

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

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

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

คุณต้องอัปเดตคอมโพเนนต์ใดบ้าง

คุณต้องอัปเดตคอมโพเนนต์ Edge ทั้งหมด Edge ไม่รองรับการตั้งค่าที่มีคอมโพเนนต์ จากหลายเวอร์ชัน

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

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

การเพิ่ม SMTMAILFROM ที่จำเป็น พารามิเตอร์การกำหนดค่า

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

SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

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

> /opt/apigee/apigee-service/bin/apigee-all สถานะ

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

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

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

หมายเหตุ: โทโพโลยีแบบ All-in-One และ 2 โหนดของ Edge ออกแบบมาเพื่อ การเริ่มต้นใช้งานและการสร้างต้นแบบ ไม่ใช่การใช้งานจริง ดังนั้นจึงไม่มีการย้อนกลับ สำหรับโทโพโลยีแบบ All-in-1 และ 2 โหนด ในสถานการณ์ที่มีการอัปเดต โทโพโลยีล้มเหลว และการลองอัปเดตอีกครั้งไม่สามารถแก้ปัญหาได้ ตัวเลือกที่ง่ายที่สุดคือดำเนินการ มีการติดตั้งใหม่เป็น 4.17.05

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากไม่ป้อน pWord ระบบจะแจ้งให้คุณป้อน

โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณติดตั้ง Java 1.8 แล้ว ถ้าคุณไม่ติดตั้ง ติดตั้งให้คุณได้เลย ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการ การติดตั้ง Java JAVA_FIX ใช้ค่าต่อไปนี้

I = ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
C = ดำเนินการต่อโดยไม่ติดตั้ง Java
ถาม = ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
(CentOS-6.x และ RedHat-6.x เท่านั้น) ในโหนด Qpid ทั้งหมด ให้เรียกใช้คำสั่งต่อไปนี้ เพื่อให้แน่ใจว่าคุณได้ดาวน์โหลด Qpid เวอร์ชันที่ถูกต้อง:
> อร่อยจัง ติดตั้งเลย apigee-qpidd --disablerepo=epel
ใช้ apigee-service เพื่อ อัปเดต apigee-setup ยูทิลิตี:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup อัปเดต
อัปเดต apigee-validate ยูทิลิตีในเซิร์ฟเวอร์การจัดการ:
/opt/apigee/apigee-service/bin/apigee-service apigee-checkate อัปเดต
อัปเดต apigee-provision ยูทิลิตี:
อัปเดต /opt/apigee/apigee-service/bin/apigee-service apigee-provision
เรียกใช้ยูทิลิตีการอัปเดตบนโหนดของคุณตามลำดับที่อธิบายด้านล่างใน "ลำดับของเครื่อง อัปเดต" ด้านล่าง
> /opt/apigee/apigee-setup/bin/update.sh -c คอมโพเนนต์ -f configFile

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

ใช้ตัวเลือก "-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 ในเซิร์ฟเวอร์การจัดการตาม ตามที่อธิบายไว้ในหัวข้อทดสอบการติดตั้ง

หากต้องการย้อนกลับการอัปเดตในภายหลัง ให้ใช้ขั้นตอนที่อธิบายไว้ใน 4.17.05 กระบวนการย้อนกลับ

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

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

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

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

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

สร้างที่เก็บ 4.17.05 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
หมายเหตุ: หากมีที่เก็บเวอร์ชัน 4.17.01 อยู่แล้ว คุณจะเพิ่ม 4.17.05 ได้ เก็บบันทึกไว้ใน "อัปเดตที่เก็บ Apigee ในเครื่อง" ที่ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
วิธีติดตั้ง apigee-service จากไฟล์ .tar
1. ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่อง ลงในไฟล์ .tar ไฟล์เดียวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz ดังนี้
  /opt/apigee/apigee-service/bin/apigee-service แพ็กเกจ apigee-Mirror
2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge ตัวอย่างเช่น คัดลอกไปที่ ไดเรกทอรี /tmp ใน โหนดใหม่
3. ในโหนดใหม่ ให้ยกเลิกการอัปโหลดไฟล์ไปยังไดเรกทอรี /tmp:
  > tar -Xzf apigee-4.17.05.tar.gz
  
  คำสั่งนี้จะสร้างไดเรกทอรีใหม่ที่ชื่อว่า repos ในไดเรกทอรีที่มี .tar เช่น /tmp/repos
4. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency จาก /tmp/repos:
  > Sudo Bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  คุณจะเห็นว่าใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้ Nginx webserver" ที่ Install the Edge ยูทิลิตีการตั้งค่า Apigee
2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.17.05.sh ลงใน /tmp/bootstrap_4.17.05.sh:
  /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  
  โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งค่าไว้ด้านบนสำหรับ ที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของ โหนดที่เก็บ
3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตีและบริการ Apigee ของ Edge และทรัพยากร Dependency:
  > Sudo Bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่เก็บ
ใช้ apigee-service เพื่อ อัปเดตยูทิลิตีการตั้งค่า Apigee ดังนี้
/opt/apigee/apigee-service/bin/apigee-service apigee-setup อัปเดต
อัปเดต apigee-validate ในเซิร์ฟเวอร์การจัดการ
> /opt/apigee/apigee-service/bin/apigee-service apigee-checkate อัปเดต
อัปเดต apigee-provision ยูทิลิตี:
อัปเดต /opt/apigee/apigee-service/bin/apigee-service apigee-provision
เรียกใช้ยูทิลิตีการอัปเดตบนโหนดของคุณตามลำดับที่อธิบายด้านล่างใน "ลำดับของเครื่อง อัปเดต" ด้านล่าง:
> /opt/apigee/apigee-setup/bin/update.sh -c คอมโพเนนต์ -f configFile

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

ใช้ตัวเลือก "-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 ทั้งหมดก่อนที่จะอัปเดต โหนดอื่นๆ
สําหรับเครื่องใดก็ตามที่มีคอมโพเนนต์ Edge หลายรายการ (เซิร์ฟเวอร์การจัดการ, Message Processor เราเตอร์, เซิร์ฟเวอร์ QPID แต่ไม่ใช่เซิร์ฟเวอร์ Postgres) ให้ใช้ "-c edge" ตัวเลือกการอัปเดตทั้งหมด ในเวลาเดียวกัน
หากขั้นตอนระบุว่าควรดำเนินการในหลายเครื่อง ให้ดำเนินการใน ลำดับเครื่องที่ระบุ
เราไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ โดยจะอัปเดตเมื่อระบุ "-c" ขอบ" ตัวเลือก
(CentOS-6.x และ RedHat-6.x เท่านั้น) ในโหนด Qpid ทั้งหมดที่มี การเชื่อมต่ออินเทอร์เน็ตภายนอก โปรดตรวจสอบว่าคุณเรียกใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลด รุ่น Qpid ที่ถูกต้องตามที่แสดงด้านบน:
> อร่อย ติดตั้ง apigee-qpidd --disablerepo=epel