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

อัปเดต Apigee Edge 4.17.0x เป็น 4.18.01

Edge for Private Cloud v4.18.01

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

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

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

ผู้ที่มีสิทธิ์ดำเนินการอัปเดต

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

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

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

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

รักษาความเข้ากันได้

เมื่ออัปเกรด Apigee Edge สำหรับ Private Cloud เป็น 4.18.01 คุณต้องตรวจสอบว่าผลลัพธ์ที่ได้ จะอ้างอิงเฉพาะพร็อพเพอร์ตี้ที่รองรับในไฟล์การกำหนดค่า

พร็อพเพอร์ตี้	ตำแหน่ง	คำอธิบาย
`conf_load_balancing_load.balancing. driver.nginx.server.retry`	`router.properties`	นำพร็อพเพอร์ตี้นี้ออกจากไฟล์ `router.properties` วิธีตั้งค่าตัวเลือกการลองอีกครั้ง ใน 4.18.01 ให้ใช้โหมดเสมือนจริง พร็อพเพอร์ตี้การกำหนดค่าโฮสต์

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

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

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

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

API BaaS เวอร์ชัน 4.17.09 ยังเพิ่มการรองรับสำหรับพร็อพเพอร์ตี้ SMTPMAILFROM ด้วย เมื่ออัปเดต API BaaS จาก 4.17.01 หรือ 4.17.05 คุณต้องตั้งค่า SMTPMAILFROM ใน ใหม่

โดยพารามิเตอร์นี้จะอยู่ในรูปแบบ

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

จำเป็นต้องอัปเกรดเป็น Postgres 9.6

Edge รุ่นนี้มีการอัปเกรดเป็น Postgres 9.6 ในการอัปเกรด ทั้งหมดนี้ ข้อมูล Postgres จะย้ายไปยัง Postgres 9.6

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

วิธีดำเนินการอัปเดต Postgres จะขึ้นอยู่กับวิธีที่คุณกำหนดค่าพื้นที่เก็บข้อมูลสำหรับ โหนด Postgres:

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

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

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

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

การติดตั้ง Postgres ใหม่ โหนดสแตนด์บาย

กระบวนการนี้จะสร้างเซิร์ฟเวอร์สแตนด์บายของ Postgres ในโหนดใหม่ ตรวจสอบว่าคุณติดตั้งแอป เซิร์ฟเวอร์สแตนด์บายของ Postgres สำหรับ Edge เวอร์ชันที่มีอยู่ (4.17.0x) ไม่ใช่สำหรับ เวอร์ชัน 4.18.01

หากต้องการดำเนินการติดตั้ง ให้ใช้ไฟล์การกำหนดค่าเดียวกันกับที่คุณใช้ติดตั้งเวอร์ชันปัจจุบัน ของ Edge

วิธีสร้างโหนดสแตนด์บายของ Postgres ใหม่

ในต้นแบบ Postgres ปัจจุบัน ให้แก้ไข /opt/apigee/customer/application/postgresql.properties ไฟล์ที่จะตั้งค่าต่อไปนี้ โทเค็น:
```
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
trust\ \nhost replication apigee new_slave_ip/32 trust
```
โดยที่ existing_slave_ip คือที่อยู่ IP ของ Postgres ปัจจุบัน เซิร์ฟเวอร์สแตนด์บายและ new_slave_ip คือที่อยู่ IP ของโหนดสแตนด์บายใหม่

หากไม่มีไฟล์ postgresql.properties ให้สร้างและใช้ chown เพื่อให้สิทธิ์ผู้ใช้ apigee ในการเข้าถึง ตามตัวอย่างต่อไปนี้ แสดง:
```
chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
```
รีสตาร์ท apigee-postgresql ในต้นฉบับ Postgres:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
```
ตรวจสอบว่าได้เพิ่มโหนดสแตนด์บายใหม่โดยดู /opt/apigee/apigee-postgresql/conf/pg_hba.conf ในไฟล์หลัก คุณควรเห็นบรรทัดต่อไปนี้ในไฟล์นั้น
```
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
```
ติดตั้งเซิร์ฟเวอร์สแตนด์บายของ Postgres ใหม่:
1. แก้ไขไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง Edge เวอร์ชันปัจจุบันเพื่อระบุ ดังต่อไปนี้
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102 
```
2. ปิดใช้งาน SELinux ตามที่อธิบายไว้ใน ติดตั้ง ยูทิลิตีการตั้งค่า Apigee ของ Edge
3. ดาวน์โหลดไฟล์ Edge Bootstrap_4.17.0x.sh (โดยที่ 4.17.0x เท่ากับ 4.17.01, 4.17.05 หรือ 4.17.09) เป็น /tmp/bootstrap_4.17.0x.sh :
```
curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
```
4. ติดตั้งยูทิลิตี Edge apigee-service และ ทรัพยากร Dependency:
```
sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
  apigeepassword=pWord
```
5. ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
6. ติดตั้ง Postgres
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
7. เรียกใช้คำสั่งต่อไปนี้ในเซิร์ฟเวอร์สแตนด์บายใหม่
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  ตรวจสอบว่ามีข้อความระบุว่าอยู่ในโหมดสแตนด์บาย

การเลิกใช้งาน Postgres โหนด

หลังจากการอัปเดตเสร็จสมบูรณ์ ให้เลิกใช้โหนดสแตนด์บายใหม่:

ตรวจสอบว่า Postgres ทำงานอยู่:
> /opt/apigee/apigee-service/bin/apigee-all สถานะ

หาก Postgres ไม่ได้ทำงานอยู่ ให้เริ่มทำงานโดยทำดังนี้
> /opt/apigee/apigee-service/bin/apigee-all เริ่มต้น
รับ UUID ของโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่ง cURL ต่อไปนี้ในโหนดใหม่ โหนดสแตนด์บาย:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

คุณควรเห็น UUID ของโหนดที่ส่วนท้ายของเอาต์พุตในรูปแบบ:
"ประเภท" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
หยุดโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่งต่อไปนี้ในโหนดสแตนด์บายใหม่
> /opt/apigee/apigee-service/bin/apigee-all Stop
ในโหนดหลักของ Postgres ให้แก้ไข /opt/apigee/customer/application/postgresql.properties ในการนำโหนดสแตนด์บายใหม่ออกจาก conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host Apigee ของการจำลอง existing_slave_ip/32 ความน่าเชื่อถือ
รีสตาร์ท apigee-postgresql ในต้นแบบ Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql รีสตาร์ท
ตรวจสอบว่าโหนดสแตนด์บายใหม่ถูกนำออกโดยดู /opt/apigee/apigee-postgresql/conf/pg_hba.conf ในไฟล์หลัก คุณควรเห็นเฉพาะบรรทัดต่อไปนี้ในไฟล์นั้น
Apigee การจำลองโฮสต์ ความน่าเชื่อถือ existing_slave_ip/32
ลบ UUID ของโหนดสแตนด์บายจาก ZooKeeper โดยสร้างการจัดการ Edge ต่อไปนี้ การเรียก API ในโหนดเซิร์ฟเวอร์การจัดการ:
> curl -u sysAdminEmail:password -X ลบ http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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

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

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

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

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

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

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

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

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

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

โดยค่าเริ่มต้นไฟล์ 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.0x

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

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

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

หากคุณกำลังใช้พื้นที่เก็บข้อมูลของเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ ให้ใช้ ภาพรวมเครือข่ายของพื้นที่เก็บข้อมูลที่ Postgres ใช้ โปรดดูข้อมูลเพิ่มเติมที่จำเป็นต้องอัปเกรดเป็น Postgres 9.6
หากมี ให้ปิดใช้งาน CRON ที่กำหนดค่าไว้เพื่อดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณดำเนินการ Edge ได้ การกำหนดค่าที่ไม่มีสิทธิ์เข้าถึงราก
ติดตั้ง yum-utils และ yum-plugin-priorities:
> sudo yum ติดตั้ง yum-utils
sudo yum ติดตั้ง yum-plugin-priorities
ปิดใช้งาน SELinux ตามที่อธิบายไว้ใน ติดตั้ง ยูทิลิตีการตั้งค่า Apigee ของ Edge
หากกำลังติดตั้งใน Oracle 7.x ให้เรียกใช้คำสั่งต่อไปนี้
> sudo yum-config-manager --เปิดใช้ ol7_optional_latest
หากกำลังติดตั้งใน AWS ให้เรียกใช้คำสั่ง yum-configure-manager ต่อไปนี้
> อัปเดตอร่อยๆ rh-amazon-rhui-client.noarch
> sudo yum-config-manager --เปิดใช้งาน rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
ดาวน์โหลดไฟล์ Edge 4.18.01 bootstrap_4.18.01.sh ลงใน /tmp/bootstrap_4.18.01.sh:
> Curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
ติดตั้งยูทิลิตี apigee-service ของ Edge 4.18.01 และ ทรัพยากร Dependency:
> Sudo Bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

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

I = ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
C = ดำเนินการต่อโดยไม่ติดตั้ง Java
ถาม = ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
ใช้ 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-validate บนการจัดการ เซิร์ฟเวอร์ ตามที่อธิบายไว้ใน ทดสอบการติดตั้ง
ถ้าคุณติดตั้งโหนดสแตนด์บายของ Postgres ใหม่ ให้ยกเลิกการทำงานของโหนดตามที่อธิบายไว้ข้างต้น ในการเลิกใช้งาน โหนด Postgres

หากคุณกำลังใช้พื้นที่เก็บข้อมูลของเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ โปรดดูข้อมูลเพิ่มเติมที่จำเป็นต้องอัปเกรดเป็น Postgres 9.6

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

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

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

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

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

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

หากคุณกำลังใช้การจำลองการสแตนด์บายต้นแบบ Postgres ให้ติดตั้ง Postgres ใหม่ โหนดสแตนด์บายตามที่อธิบายไว้ข้างต้นในการติดตั้ง Postgres ใหม่ โหนดสแตนด์บาย

หากคุณกำลังใช้พื้นที่เก็บข้อมูลของเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ ให้ใช้ ภาพรวมเครือข่ายของพื้นที่เก็บข้อมูลที่ Postgres ใช้ โปรดดูข้อมูลเพิ่มเติมที่จำเป็นต้องอัปเกรดเป็น Postgres 9.6
สร้างที่เก็บ 4.18.01 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
หมายเหตุ: หากมีที่เก็บขนาด 4.17.0x อยู่แล้ว คุณสามารถเพิ่ม ที่เก็บ 4.18.01 ไปยังที่เก็บตามที่อธิบายไว้ใน "อัปเดตที่เก็บ Apigee ในเครื่อง" ที่ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
วิธีติดตั้ง apigee-service จากไฟล์ .tar
1. ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่อง ลงในไฟล์ .tar ไฟล์เดียวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz ดังนี้
  > /opt/apigee/apigee-service/bin/apigee-service แพ็กเกจ apigee-Mirror
2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge ตัวอย่างเช่น คัดลอกไปที่ ไดเรกทอรี /tmp ใน โหนดใหม่
3. ในโหนดใหม่ ให้ยกเลิกการอัปโหลดไฟล์ไปยังไดเรกทอรี /tmp:
  > tar -Xzf apigee-4.18.01.tar.gz
  
  คำสั่งนี้จะสร้างไดเรกทอรีใหม่ที่ชื่อว่า repos ในไดเรกทอรีที่มี .tar เช่น /tmp/repos
4. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency จาก /tmp/repos:
  > Sudo Bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  คุณจะเห็นว่าใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้ Nginx webserver" ที่ Install the Edge ยูทิลิตีการตั้งค่า Apigee
2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.18.01.sh เพื่อ /tmp/bootstrap_4.18.01.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  
  โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งค่าไว้ด้านบนสำหรับ ที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของ โหนดที่เก็บ
3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตีและบริการ Apigee ของ Edge และทรัพยากร Dependency:
  > Sudo Bash /tmp/bootstrap_4.18.01.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-validate บนการจัดการ เซิร์ฟเวอร์ ตามที่อธิบายไว้ใน ทดสอบการติดตั้ง
ถ้าคุณติดตั้งโหนดสแตนด์บายของ Postgres ใหม่ ให้ยกเลิกการทำงานของโหนดตามที่อธิบายไว้ ด้านบนในการเลิกใช้งาน โหนด Postgres

หากคุณกำลังใช้พื้นที่เก็บข้อมูลของเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ โปรดดูข้อมูลเพิ่มเติมที่จำเป็นต้องอัปเกรดเป็น Postgres 9.6

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

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

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

สำหรับสแตนด์อโลน 1 โฮสต์ การติดตั้ง

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

หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหาก คุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้อยู่ในรูปแบบ
SMTPMAILFROM="บริษัทของฉัน <myco@company.com>"
อัปเดต Cassandra และ ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
อัปเดต Qpid:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
อัปเดต LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c LDAP -f configFile
หยุดเซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์ Qpid และ PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server การหยุด
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server หยุดทำงาน
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql หยุดยั้ง
อัปเดต postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
อัปเดตฐานข้อมูล Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
อัปเดตคอมโพเนนต์ Edge ที่เหลือ:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
อัปเดต Edge UI:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับสแตนด์อโลนสำหรับ 2 โฮสต์ การติดตั้ง

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