อัปเดต Apigee Edge 4.16.09 เป็น 4.17.09

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

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

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

หากใช้ Edge เวอร์ชันเก่ากว่า 4.16.01 คุณต้องย้ายข้อมูลเป็นเวอร์ชัน 4.16.01.x ก่อน แล้วจึงอัปเดตเป็นเวอร์ชัน 4.17.09

ผู้ที่จะอัปเดตได้

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

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

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

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

จำเป็นต้องอัปเกรดเป็น Qpid 1.35

รุ่นนี้มีการอัปเดตที่จำเป็นสำหรับ Qpid 1.35 ในการอัปเดตโหนด Qpid คุณต้องทำดังนี้

• ป้องกันไม่ให้เราเตอร์และโปรแกรมประมวลผลข้อความเขียนลงในโหนด Qpid ชั่วคราวโดยบล็อกพอร์ต 5672 ในโหนด Qpid คุณสามารถใช้คำสั่งต่อไปนี้เพื่อบล็อกพอร์ตนี้ในโหนด Qpid
  > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
• รอให้คิว Qpid ไม่มีข้อความเหลืออยู่เพื่อให้แน่ใจว่าโหนด Qpid ได้ประมวลผลข้อความทั้งหมดแล้วก่อนการอัปเดต ใช้คำสั่งต่อไปนี้เพื่อให้แน่ใจว่าคิวข้อความ Qpid ว่างเปล่า
  > qpid-stat -q
• อัปเดตโหนด Qpid
• เลิกบล็อกพอร์ต 5672 ในโหนด Qpid เพื่ออนุญาตให้เข้าถึงจากเราเตอร์และโปรแกรมประมวลผลข้อความ คุณสามารถใช้คำสั่งต่อไปนี้เพื่อเลิกบล็อกพอร์ตนี้
  > sudo iptables -F
  
  โปรดทราบว่าหากใช้ iptables สำหรับกฎอื่นๆ คุณสามารถใช้ตัวเลือก -D เพื่อยกเลิกการเปลี่ยนแปลงที่เฉพาะเจาะจงได้
  > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

กระบวนการนี้อธิบายไว้อย่างละเอียดด้านล่างสำหรับโทโพโลยี Edge แต่ละรายการ

ต้องระบุเพื่อเปิดใช้ที่เก็บ EPEL

คุณต้องเปิดใช้แพ็กเกจเพิ่มเติมสำหรับ Enterprise Linux (หรือ EPEL) เพื่อติดตั้งหรืออัปเดต Edge คำสั่งที่คุณใช้จะขึ้นอยู่กับเวอร์ชัน RedHat/CentOS ดังนี้

• สำหรับ RedHat/CentOS/Oracle 7.x
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
• สำหรับ RedHat/CentOS/Oracle 6.x
  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

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

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

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

พารามิเตอร์นี้มีรูปแบบดังนี้

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

ต้องระบุหากอัปเดตเมื่อใช้การตรวจสอบสิทธิ์ภายนอก

คุณสามารถผสานรวมบริการไดเรกทอรีภายนอกเข้ากับการติดตั้ง Apigee Edge Private Cloud ที่มีอยู่ได้ ฟีเจอร์นี้ออกแบบมาให้ทำงานร่วมกับบริการไดเรกทอรีที่รองรับ LDAP เช่น Active Directory, OpenLDAP และอื่นๆ โซลูชัน LDAP ภายนอกช่วยให้ผู้ดูแลระบบจัดการข้อมูลเข้าสู่ระบบของผู้ใช้ได้จากบริการจัดการไดเรกทอรีแบบรวมศูนย์ ซึ่งอยู่ภายนอกระบบต่างๆ เช่น Apigee Edge ที่ใช้ข้อมูลเข้าสู่ระบบดังกล่าว

ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่าการตรวจสอบสิทธิ์ภายนอก

เมื่อเปิดใช้การตรวจสอบสิทธิ์ภายนอก ลูกค้าส่วนใหญ่จะใช้ช่องชื่อบัญชี SAM ของ Active Directory เป็นชื่อผู้ใช้สำหรับการตรวจสอบสิทธิ์แทนอีเมลที่ใช้โดยเซิร์ฟเวอร์ OpenLDAP ของ Edge

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

IS_EXTERNAL_AUTH="true"

บรรทัดนี้จะกำหนดค่า Edge ให้รองรับชื่อบัญชีแทนอีเมลเป็นชื่อผู้ใช้

การนำไปใช้งานการตั้งค่าที่พักโดยอัตโนมัติ

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

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

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

• สำรองข้อมูลโหนดทั้งหมด
  ก่อนอัปเดต ขอแนะนำให้สำรองข้อมูลโหนดทั้งหมดให้เรียบร้อยด้วยเหตุผลด้านความปลอดภัย โปรดใช้กระบวนการสำหรับ Edge เวอร์ชันปัจจุบันเพื่อสำรองข้อมูล
  
  ซึ่งจะช่วยให้คุณมีแผนสำรองในกรณีที่การอัปเดตเป็นเวอร์ชันใหม่ทำงานไม่ถูกต้อง ดูข้อมูลเพิ่มเติมเกี่ยวกับการสำรองข้อมูลได้ที่การสำรองและกู้คืนข้อมูล
• ตรวจสอบว่า Edge ทำงานอยู่
  ตรวจสอบว่า Edge ทำงานอยู่ในระหว่างกระบวนการอัปเดตโดยใช้คําสั่งต่อไปนี้
  
  > /opt/apigee/apigee-service/bin/apigee-all status

การจัดการการอัปเดตที่ไม่สำเร็จ

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

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

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

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

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

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

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

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

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

การอัปเดตแบบไม่มีเวลาหยุดทำงานจะเกิดขึ้นได้เฉพาะกับการกำหนดค่าที่มีโหนด 5 ตัวขึ้นไป

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

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

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

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

การใช้ไฟล์การกําหนดค่าแบบเงียบ

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

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

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

1. หากมี ให้ปิดใช้งาน CRON ที่กำหนดค่าไว้เพื่อดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง RPM ของ Edge
   หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องใช้สิทธิ์เข้าถึงระดับรูท แต่คุณก็สามารถกำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงระดับรูท
3. ติดตั้ง yum-utils และ yum-plugin-priorities
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
4. ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
5. เปิดใช้ที่เก็บ EPEL ตามที่อธิบายไว้ด้านบน
6. หากติดตั้งใน AWS ให้เรียกใช้คำสั่ง yum-configure-manager ต่อไปนี้
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
7. ดาวน์โหลดไฟล์ bootstrap_4.17.09.sh ของ Edge 4.17.09 ไปยัง /tmp/bootstrap_4.17.09.sh
   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
8. ติดตั้งยูทิลิตี apigee-service และข้อกําหนดของ Edge 4.17.09 ดังนี้
   > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
   
   โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากไม่ได้ระบุ pWord ระบบจะแจ้งให้คุณป้อน
   
   โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณติดตั้ง Java 1.8 แล้ว หากไม่ โปรแกรมจะติดตั้งให้คุณ ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการการติดตั้ง Java JAVA_FIX ใช้ค่าต่อไปนี้
   
   I = ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
   C = ดำเนินการต่อโดยไม่ติดตั้ง Java
   Q = Quit สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
9. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
10. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
11. อัปเดตยูทิลิตี apigee-provision
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
12. เรียกใช้ยูทิลิตีการอัปเดตบนโหนดตามลำดับที่อธิบายไว้ด้านล่างในส่วน "ลำดับการอัปเดตเครื่อง"
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    ข้อกำหนดเพียงอย่างเดียวสำหรับไฟล์การกําหนดค่าคือผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกําหนดค่าได้
    
    ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
    ui = UI ของ Edge
    all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้กับโปรไฟล์การติดตั้ง aio ของ Edge หรือโปรไฟล์การติดตั้ง asa ของ API BaaS เท่านั้น)
    e = ElasticSearch
    b = สแต็ก API BaaS
    p = พอร์ทัล API BaaS
    ebp = ElasticSearch, สแต็ก API BaaS และพอร์ทัล API BaaS ในโหนดเดียวกัน
13. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในทดสอบการติดตั้ง

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

ขั้นตอนการอัปเดตเป็น 4.17.09 จากรีโปในพื้นที่

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

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

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

วิธีอัปเดตจากที่เก็บข้อมูล 4.17.09 ในพื้นที่

1. สร้างที่เก็บข้อมูล 4.17.09 ในพื้นที่ตามที่อธิบายไว้ใน "สร้างที่เก็บข้อมูล Apigee ในพื้นที่" ที่ ติดตั้งยูทิลิตี apigee-setup ของ Edge
   หมายเหตุ: หากมีที่เก็บข้อมูล 4.16.09 อยู่แล้ว คุณสามารถเพิ่มที่เก็บข้อมูล 4.17.09 เข้าไปได้ตามที่อธิบายไว้ใน "อัปเดตที่เก็บข้อมูล Apigee ในพื้นที่" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
2. วิธีติดตั้ง apigee-service จากไฟล์ .tar
   1. ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่องลงในไฟล์ .tar ไฟล์เดียวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirrorpackage
   2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
   3. ในโหนดใหม่ ให้แตกไฟล์ไปยังไดเรกทอรี /tmp
      > tar -xzf apigee-4.17.09.tar.gz
      
      คําสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos
   4. ติดตั้งยูทิลิตี apigee-service ของ Edge และไลบรารีที่เกี่ยวข้องจาก /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      โปรดทราบว่าคุณใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
3. วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
   1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากรีโปโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
   2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ bootstrap_4.17.09.sh ของ Edge ไปยัง /tmp/bootstrap_4.17.09.sh
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      
      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งไว้ข้างต้นสำหรับรีโป และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดรีโป
   3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-service ของ Edge และรายการที่เกี่ยวข้อง ดังนี้
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      
      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านของ repo
4. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
5. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ
   > อัปเดต /opt/apigee/apigee-service/bin/apigee-service apigee-Validate
6. อัปเดตยูทิลิตี apigee-provision
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
7. เรียกใช้ยูทิลิตีการอัปเดตบนโหนดตามลำดับที่อธิบายไว้ด้านล่างในส่วน "ลำดับการอัปเดตเครื่อง"
   > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
   
   ข้อกำหนดเพียงอย่างเดียวสำหรับไฟล์การกําหนดค่าคือผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกําหนดค่าได้
   
   ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้
   ldap = OpenLDAP
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   edge =คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
   ui = UI ของ Edge
   all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้กับโปรไฟล์การติดตั้ง aio ของ Edge หรือโปรไฟล์การติดตั้ง asa ของ API BaaS เท่านั้น)
   e = ElasticSearch
   b = สแต็ก API BaaS
   p = พอร์ทัล API BaaS
   ebp = ElasticSearch, สแต็ก API BaaS และพอร์ทัล API BaaS ในโหนดเดียวกัน
8. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในทดสอบการติดตั้ง

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

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

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

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

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

1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้อยู่ในรูปแบบ
   SMTPMAILFROM="My Company <myco@company.com>"
2. อัปเดต Cassandra และ ZooKeeper
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. ตั้งกฎ iptables ต่อไปนี้
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. ตรวจสอบคิวข้อความ Qpid
   > qpid-stat -q
   
   ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเท่ากับ 0 คุณจะอัปเกรด Qpid ไม่ได้จนกว่าระบบจะประมวลผลข้อความทั้งหมดแล้ว
5. อัปเดต qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. ล้าง iptables:
   > sudo iptables -F
7. อัปเดต postgresql:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. เริ่ม postgresql
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. อัปเดต LDAP
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. อัปเดตคอมโพเนนต์ Edge ที่เหลือ
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. อัปเดต UI ของ Edge
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

ดูรายการโทโปโลยีการติดตั้งและจำนวนโหนดได้ที่โทโปโลยีการติดตั้ง

1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
   SMTPMAILFROM="My Company <myco@company.com>"
2. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. ตั้งกฎ iptables ต่อไปนี้ในเครื่องที่ 2
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `ชื่อโฮสต์` -i eth0 -j DROP
4. ตรวจสอบคิวข้อความ Qpid ในเครื่องที่ 2
   > qpid-stat -q
   
   ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเท่ากับ 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมด
5. อัปเดต qpidd ในเครื่องที่ 2
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. ล้าง iptables ในเครื่อง 2:
   > sudo iptables -F
7. อัปเดต postgresql ในเครื่องที่ 2
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. เริ่ม postgresql ในเครื่องที่ 2
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. อัปเดต LDAP บนเครื่อง 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c LDAP -f configFile
10. อัปเดตคอมโพเนนต์ Edge ในเครื่องที่ 2 และ 1
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. อัปเดต UI ในเครื่องที่ 1
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งคลัสเตอร์ 5 โฮสต์

ดูรายการโทโปโลยีการติดตั้งและจำนวนโหนดได้ที่โทโปโลยีการติดตั้ง

1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
   SMTPMAILFROM="My Company <myco@company.com>"
2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. ตั้งค่ากฎ iptables ต่อไปนี้บนเครื่อง 4
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. ตรวจสอบคิวข้อความ Qpid ในเครื่องที่ 4
   > qpid-stat -q
   
   ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเท่ากับ 0 คุณจะอัปเกรด Qpid ไม่ได้จนกว่าระบบจะประมวลผลข้อความทั้งหมดแล้ว
5. อัปเดต qpidd ในเครื่อง 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. ล้าง iptables ในเครื่องที่ 4
   > sudo iptables -F
7. ทำขั้นตอนที่ 3 ถึง 6 ซ้ำในเครื่อง 5
8. อัปเดต postgresql ในเครื่องที่ 4
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. เริ่ม postgresql ในเครื่องที่ 4
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. ทำขั้นตอนที่ 8 และ 9 ซ้ำในเครื่องที่ 5
11. อัปเดต LDAP ในเครื่องที่ 1
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5, 1, 2, 3
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. อัปเดต UI ในเครื่องที่ 1
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งคลัสเตอร์ 9 โฮสต์

ดูรายการโทโปโลยีการติดตั้งและจำนวนโหนดได้ที่โทโปโลยีการติดตั้ง

1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
   SMTPMAILFROM="My Company <myco@company.com>"
2. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่องที่ 6
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. ตรวจสอบคิวข้อความ Qpid ในเครื่อง 6
   > qpid-stat -q
   
   ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเท่ากับ 0 คุณจะอัปเกรด Qpid ไม่ได้จนกว่าระบบจะประมวลผลข้อความทั้งหมดแล้ว
5. อัปเดต qpidd ในเครื่อง 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. ล้าง iptables ในเครื่อง 6:
   > sudo iptables -F
7. ทำขั้นตอนที่ 3 ถึง 6 ซ้ำในเครื่องที่ 7
8. อัปเดต postgresql บนเครื่อง 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. เริ่ม postgresql ในเครื่อง 6:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. ทำขั้นตอนที่ 8 และ 9 ซ้ำในเครื่องที่ 7
11. อัปเดต LDAP บนเครื่อง 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c LDAP -f configFile
12. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 8, 9, 1, 4 และ 5 ตามลำดับ
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. อัปเดต UI บนเครื่อง 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งคลัสเตอร์ 13 โฮสต์

ดูรายการโทโปโลยีการติดตั้งและจำนวนโหนดได้ที่โทโปโลยีการติดตั้ง

1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
   SMTPMAILFROM="My Company <myco@company.com>"
2. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. ตั้งค่ากฎ iptables ต่อไปนี้บนเครื่อง 12:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. ตรวจสอบคิวข้อความ Qpid ในเครื่อง 12:
   > qpid-stat -q
   
   ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเท่ากับ 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมด
5. อัปเดต qpidd ในเครื่อง 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. ล้าง iptables ในเครื่อง 12:
   > sudo iptables -F
7. ทำขั้นตอนที่ 3 ถึง 6 ซ้ำในเครื่องที่ 13
8. อัปเดต postgresql ในเครื่อง 12
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. เริ่มต้น Postgresql ในเครื่อง 12:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. ทำขั้นตอนที่ 8 และ 9 ซ้ำในเครื่องที่ 13
11. อัปเดต LDAP ในเครื่องที่ 4 และ 5
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 8, 9, 6, 7, 10 และ 11 ตามลำดับ
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. อัปเดต UI ในเครื่องที่ 6 และ 7
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งคลัสเตอร์ 12 โฮสต์

ดูรายการโทโปโลยีการติดตั้งและจำนวนโหนดได้ที่โทโปโลยีการติดตั้ง

1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า หากเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
   SMTPMAILFROM="My Company <myco@company.com>"
2. อัปเดต Cassandra และ ZooKeeper โดยทำดังนี้
   1. ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   2. ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. อัปเดต qpidd
   1. เครื่อง 4, 5 ในศูนย์ข้อมูล 1
      1. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่องที่ 4
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. ตรวจสอบคิวข้อความ Qpid ในเครื่องที่ 4
         > qpid-stat -q
         
         ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเท่ากับ 0 คุณจะอัปเกรด Qpid ไม่ได้จนกว่าระบบจะประมวลผลข้อความทั้งหมดแล้ว
      3. อัปเดต qpidd ในเครื่องที่ 4:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. ล้าง iptables ในเครื่องที่ 4
         > sudo iptables -F
      5. ทำขั้นตอนที่ 1 ถึง 4 ซ้ำในเครื่อง 5
   2. เครื่อง 10, 11 ใน Data Center 2
      1. ตั้งกฎ iptables ต่อไปนี้ในเครื่อง 10
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `ชื่อโฮสต์` -i eth0 -j DROP
      2. ตรวจสอบคิวข้อความ Qpid ในเครื่อง 10:
         > qpid-stat -q
         
         ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเท่ากับ 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมด
      3. อัปเดต qpidd ในเครื่อง 10:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. ล้าง iptables ในเครื่อง 10:
         > sudo iptables -F
      5. ทำตามขั้นตอนที่ 1 ถึง 4 ซ้ำในเครื่อง 11
4. อัปเดต postgresql
   1. เครื่อง 6 ในศูนย์ข้อมูล 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
   2. เครื่อง 12 ในศูนย์ข้อมูล 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. อัปเดต LDAP ดังนี้
   1. เครื่อง 1 ในศูนย์ข้อมูล 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. เครื่อง 7 ในศูนย์ข้อมูล 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. อัปเดตคอมโพเนนต์ Edge โดยทำดังนี้
   1. เครื่อง 4, 5, 6, 1, 2, 3 ใน Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
   2. เครื่อง 10, 11, 12, 7, 8, 9 ใน Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. อัปเดต UI
   1. เครื่อง 1 ในศูนย์ข้อมูล 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. เครื่อง 7 ในศูนย์ข้อมูล 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้ง API BaaS แบบ 7 โฮสต์

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

ดูตัวอย่างไฟล์การกําหนดค่าที่สมบูรณ์ได้ที่การติดตั้ง API BaaS

นอกจากนี้ คุณต้องตรวจสอบว่าพอร์ต 2551 เปิดอยู่ในโหนด Stack ทั้งหมดเพื่อให้เข้าถึงจากโหนด Stack อื่นๆ ทั้งหมดได้

ดูรายการโทโปโลยีการติดตั้งและจำนวนโหนดได้ที่โทโปโลยีการติดตั้ง

1. อัปเดต Cassandra บนเครื่อง 5, 6 และ 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

2. อัปเดต ElasticSearch และ API BaaS Stack ในเครื่องที่ 1, 2 และ 3
   > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

3. อัปเดตพอร์ทัล API BaaS บนเครื่อง 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

สำหรับการติดตั้ง API BaaS 10 โฮสต์

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

ดูตัวอย่างไฟล์การกําหนดค่าที่สมบูรณ์ได้ที่การติดตั้ง API BaaS

นอกจากนี้ คุณต้องตรวจสอบว่าพอร์ต 2551 เปิดอยู่ในโหนด Stack ทั้งหมดเพื่อให้เข้าถึงจากโหนด Stack อื่นๆ ทั้งหมดได้

ดูรายการโทโปโลยีการติดตั้งและจำนวนโหนดได้ที่โทโปโลยีการติดตั้ง

1. อัปเดต Cassandra ในเครื่อง 8, 9 และ 10
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
2. อัปเดต ElasticSearch ในเครื่องที่ 1, 2 และ 3
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
3. อัปเดต API BaaS Stack ในเครื่องที่ 4, 5 และ 6
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
4. อัปเดตพอร์ทัล API BaaS ในเครื่อง 7
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

สําหรับการติดตั้งที่ไม่ใช่มาตรฐาน

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

1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge ซึ่งหมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลําดับคือโหนดที่มีเซิร์ฟเวอร์ Qpid, เซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ และเราเตอร์
   หมายเหตุ: หากโหนดติดตั้งทั้งเซิร์ฟเวอร์ Qpid และเซิร์ฟเวอร์ Postgres ให้เรียกใช้ขั้นตอนโปรไฟล์ "-c edge"
6. UI ของ Edge