บางครั้งคุณอาจต้องเลิกใช้ศูนย์ข้อมูล ตัวอย่างเช่น หากคุณกำลังอัปเกรดระบบปฏิบัติการ คุณต้องติดตั้งระบบปฏิบัติการใหม่ในศูนย์ข้อมูลใหม่ แล้วยกเลิกการทำงานของศูนย์ข้อมูลเก่า ส่วนต่อไปนี้จะแสดงตัวอย่างของการเลิกใช้งานศูนย์ข้อมูลซึ่งมีศูนย์ข้อมูล 2 แห่ง คือ dc-1 และ dc-2 ในการติดตั้งคลัสเตอร์แบบ 12 โหนด
- dc-1 คือศูนย์ข้อมูลที่จะหยุดให้บริการ
- dc-2 เป็นศูนย์ข้อมูลแห่งที่ 2 ซึ่งใช้ในขั้นตอนการเลิกใช้
หากคุณกำลังอัปเกรดระบบปฏิบัติการ dc-2 อาจเป็นศูนย์ข้อมูลที่คุณได้ติดตั้งระบบปฏิบัติการ (OS) เวอร์ชันใหม่ อย่างไรก็ตาม คุณไม่จำเป็นต้องติดตั้งระบบปฏิบัติการใหม่ เพื่อเลิกใช้ศูนย์ข้อมูล
ข้อควรพิจารณาก่อนการเลิกใช้งานศูนย์ข้อมูล
โปรดคำนึงถึงข้อควรพิจารณาต่อไปนี้เมื่อคุณเลิกใช้งานศูนย์ข้อมูล
- บล็อกการรับส่งข้อมูลด้านรันไทม์และการจัดการทั้งหมดไปยังศูนย์ข้อมูลที่กำลังจะหยุดให้บริการ และเปลี่ยนเส้นทาง การเข้าชมไปยังศูนย์ข้อมูลอื่นๆ
- หลังจากเลิกใช้งานศูนย์ข้อมูล ความจุของคลัสเตอร์ Apigee จะลดลง เพื่อชดเชย ให้ลองเพิ่มความจุของศูนย์ข้อมูลที่เหลืออยู่หรือเพิ่มศูนย์ข้อมูลหลังการหยุดให้บริการ
- ในระหว่างกระบวนการเลิกใช้งาน ข้อมูลวิเคราะห์อาจสูญหายได้ โดยขึ้นอยู่กับคอมโพเนนต์การวิเคราะห์ที่ติดตั้งในศูนย์ข้อมูลที่กำลังจะหยุดให้บริการ ดูรายละเอียดเพิ่มเติมได้ในเพิ่มหรือนำโหนด Qpid ออก
- ก่อนจะเลิกใช้ศูนย์ข้อมูล คุณควรทำความเข้าใจวิธีกำหนดค่าคอมโพเนนต์ทั้งหมดในศูนย์ข้อมูลทั้งหมด โดยเฉพาะเซิร์ฟเวอร์ OpenLDAP, ZooKeeper, Cassandra และ Postgres คุณควรสำรองข้อมูลคอมโพเนนต์ทั้งหมดและการกำหนดค่าไว้ด้วย
ก่อนจะเริ่ม
- เซิร์ฟเวอร์การจัดการ: ขั้นตอนการเลิกใช้งานทั้งหมดจะขึ้นอยู่กับเซิร์ฟเวอร์การจัดการ หากคุณมีเซิร์ฟเวอร์การจัดการเพียงเครื่องเดียว เราขอแนะนำให้คุณติดตั้งคอมโพเนนต์เซิร์ฟเวอร์การจัดการใหม่ในศูนย์ข้อมูลอื่นที่ไม่ใช่ dc-1 ก่อนที่จะยกเลิกการทำงานของเซิร์ฟเวอร์การจัดการใน dc-1 และตรวจสอบว่ามีเซิร์ฟเวอร์การจัดการใดเซิร์ฟเวอร์หนึ่งพร้อมใช้งานเสมอ
- เราเตอร์: ก่อนการเลิกใช้งานเราเตอร์ ให้ปิดใช้ความสามารถในการเข้าถึงของเราเตอร์โดยบล็อกพอร์ต 15999 ตรวจสอบว่าไม่ได้กำหนดเส้นทางการรับส่งข้อมูลรันไทม์ไปยังเราเตอร์ที่เลิกใช้งานแล้ว
Cassandra และ ZooKeeper: ส่วนด้านล่างอธิบายวิธียกเลิกการทำงานของ dc-1 ในการตั้งค่าศูนย์ข้อมูล 2 แห่ง หากคุณมีศูนย์ข้อมูลมากกว่า 2 แห่ง ให้นำการอ้างอิงทั้งหมดไปยังโหนดที่กำลังเลิกใช้งาน (ในกรณีนี้คือ dc-1) ออกจากไฟล์การกำหนดค่าแบบเงียบทั้งหมดในศูนย์ข้อมูลที่เหลือทั้งหมด สำหรับโหนด Cassandra ที่กำลังจะเลิกใช้งาน ให้ทิ้งโฮสต์เหล่านั้นจาก
CASS_HOSTS
โหนด Cassandra ที่เหลือควรอยู่ในลำดับเดิมของCASS_HOSTS
Postgres: หากคุณเลิกใช้งานต้นแบบ Postgres อย่าลืมโปรโมตโหนดสแตนด์บายใดโหนดหนึ่งที่มีอยู่เป็นต้นแบบ Postgres ใหม่ แม้ว่าเซิร์ฟเวอร์ QPID จะเก็บบัฟเฟอร์ในคิว แต่ในกรณีที่ต้นแบบ Postgres ไม่พร้อมใช้งานเป็นเวลานานขึ้น คุณก็อาจเสี่ยงต่อการสูญเสียข้อมูลวิเคราะห์
ข้อกำหนดเบื้องต้น
ก่อนการเลิกใช้งานคอมโพเนนต์ เราขอแนะนำให้คุณสำรองข้อมูลโหนดทั้งหมดให้ครบถ้วน โปรดใช้ขั้นตอนสำหรับ Edge เวอร์ชันปัจจุบันเพื่อสำรองข้อมูล ดูข้อมูลเพิ่มเติมเกี่ยวกับการสำรองข้อมูลได้ที่การสำรองและกู้คืนข้อมูล
หมายเหตุ: หากคุณมีโหนด Cassandra หรือ ZooKeeper หลายรายการ ให้สำรองข้อมูลทีละรายการ เนื่องจากกระบวนการสำรองข้อมูลจะปิด ZooKeeper ชั่วคราว
- ตรวจสอบว่า Edge พร้อมทำงานก่อนการเลิกใช้งานโดยใช้คำสั่งต่อไปนี้
/opt/apigee/apigee-service/bin/apigee-all status
- ตรวจสอบว่าขณะนี้ไม่มีการรับส่งข้อมูลรันไทม์ที่มาถึงศูนย์ข้อมูลที่คุณจะ กำลังจะเลิกใช้งาน
ลำดับของคอมโพเนนต์ที่เลิกใช้
หากติดตั้ง Edge สำหรับ Private Cloud บนหลายโหนด คุณควรยกเลิกการทำงานของคอมโพเนนต์ Edge บนโหนดเหล่านั้นตามลำดับต่อไปนี้
- UI ของ Edge (edge-UI)
- เซิร์ฟเวอร์การจัดการ (เซิร์ฟเวอร์การจัดการ Edge)
- OpenLDAP (apigee-openldap)
- เราเตอร์ (EDGE-เราเตอร์)
- ตัวประมวลผลข้อความ (edge-message-processor)
- Qpid Server และ Qpidd (edge-qpid-server และ apigee-qpidd)
- ฐานข้อมูล Postgres และ PostgreSQL (edge-postgres-server และ apigee-postgresql)
- ZooKeeper (Apigee-zookeeper)
- Cassandra (Apigee-cassandra)
ส่วนต่อไปนี้อธิบายวิธียกเลิกการทำงานของแต่ละคอมโพเนนต์
UI ของ Edge
หากต้องการหยุดและถอนการติดตั้งคอมโพเนนต์ Edge UI ของ dc-1 ให้ป้อนคำสั่งต่อไปนี้
/opt/apigee/apigee-service/bin/apigee-service edge-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall
เซิร์ฟเวอร์การจัดการ
หากต้องการเลิกการทำงานของเซิร์ฟเวอร์การจัดการบน dc-1 ให้ทำตามขั้นตอนต่อไปนี้
- หยุดเซิร์ฟเวอร์การจัดการใน dc-1:
apigee-service edge-management-server stop
- ค้นหา UUID ของเซิร์ฟเวอร์การจัดการที่ลงทะเบียนไว้ใน dc-1:
curl -u <AdminEmailID>:'<AdminPassword>' \ -X GET “http://{MS_IP}:8080/v1/servers?pod=central®ion=dc-1&type=management-server”
- ยกเลิกการลงทะเบียนประเภทของเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \ -d "type=management-server®ion=dc-1&pod=central&uuid=UUID&action=remove"
- ลบเซิร์ฟเวอร์ หมายเหตุ: หากมีการติดตั้งคอมโพเนนต์อื่นในเซิร์ฟเวอร์นี้ด้วย ให้ยกเลิกการลงทะเบียนคอมโพเนนต์ทั้งหมดก่อนที่จะลบ UUID
curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/{UUID}
- ถอนการติดตั้งคอมโพเนนต์เซิร์ฟเวอร์การจัดการใน dc-1:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server uninstall
เปิด LDAP
ส่วนนี้อธิบายวิธียกเลิกการใช้งาน OpenLDAP ใน dc-1
หมายเหตุ: หากคุณมีศูนย์ข้อมูลมากกว่า 2 แห่ง โปรดดูการตั้งค่าที่มีศูนย์ข้อมูลมากกว่า 2 แห่งด้านล่าง
หากต้องการเลิกใช้ OpenLDAP บน dc-1 ให้ทำตามขั้นตอนต่อไปนี้
- สำรองข้อมูลโหนด dc-1 OpenLDAP โดยทำตามขั้นตอนในวิธีสำรองข้อมูล
แบ่งการจำลองข้อมูลระหว่างศูนย์ข้อมูล 2 แห่ง คือ dc-1 และ dc-2 โดยทำตามขั้นตอนต่อไปนี้ในศูนย์ข้อมูลทั้ง 2 แห่ง
- ตรวจสอบสถานะปัจจุบัน:
ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {credentials} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl
เอาต์พุตควรมีลักษณะดังนี้
olcSyncrepl: {0}rid=001 provider=ldap://{HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={credentials} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1
- สร้างไฟล์
break_repl.ldif
ที่มีคำสั่งต่อไปนี้dn: olcDatabase={2}bdb,cn=config changetype: modify delete: olcSyncRepl dn: olcDatabase={2}bdb,cn=config changetype: modify delete: olcMirrorMode
- เรียกใช้คำสั่ง
ldapmodify
ดังนี้ldapmodify -x -w {credentials} -D "cn=admin,cn=config" -H "ldap://{HOST}:{PORT}/" -f path/to/file/break_repl.ldif
เอาต์พุตควรมีลักษณะดังนี้
modifying entry "olcDatabase={2}bdb,cn=config" modifying entry "olcDatabase={2}bdb,cn=config"
- ตรวจสอบสถานะปัจจุบัน:
คุณสามารถยืนยันว่า dc-2 ไม่ได้จำลองเป็น dc-1 แล้วด้วยการสร้างรายการใน dc-2 LDAP และตรวจสอบว่ารายการจะไม่แสดงใน LDAP ของ dc-1
(ไม่บังคับ) คุณสามารถทำตามขั้นตอนด้านล่าง ซึ่งจะสร้างผู้ใช้แบบอ่านอย่างเดียวในโหนด dc-2 OpenLDAP จากนั้นตรวจสอบว่ามีผู้ใช้ซ้ำหรือไม่ หลังจากนั้นระบบจะลบผู้ใช้ออก
- สร้างไฟล์
readonly-user.ldif
ใน dc-2 ที่มีเนื้อหาต่อไปนี้dn: uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com objectClass: organizationalPerson objectClass: person objectClass: inetOrgPerson objectClass: top cn: readonly-user sn: readonly-user userPassword: {testPassword}
- เพิ่มผู้ใช้ด้วยคำสั่ง "ldapadd" ใน dc-2:
ldapadd -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" -f path/to/file/readonly-user.ldif
ผลลัพธ์จะคล้ายกับ
adding new entry "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"
- ค้นหาผู้ใช้ใน dc-1 เพื่อตรวจสอบว่าไม่มีการจำลองผู้ใช้นี้ หากผู้ใช้ไม่ได้อยู่ใน dc-1 คุณจะต้องตรวจสอบว่า LDAP ทั้งสองไม่ได้จำลองข้อมูลอีกต่อไปแล้ว:
ldapsearch -H ldap://{HOST}:{PORT} -x -w {credentials} -D "cn=manager,dc=apigee,dc=com" -b uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com -LLL
ผลลัพธ์ควรมีลักษณะดังนี้
No such object (32) Matched DN: ou=users,ou=global,dc=apigee,dc=com
- นำผู้ใช้ที่มีสิทธิ์อ่านอย่างเดียวที่คุณเพิ่มไว้ก่อนหน้านี้ออก:
ldapdelete -v -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"
- สร้างไฟล์
- หยุด OpenLDAP ใน dc-1:
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop
- ถอนการติดตั้งคอมโพเนนต์ OpenLDAP ใน dc-1:
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap uninstall
เราเตอร์
ส่วนนี้อธิบายวิธีเลิกใช้เราเตอร์ ดูรายละเอียดเพิ่มเติมเกี่ยวกับการนำเราเตอร์ออกใน นำเซิร์ฟเวอร์ออก
ขั้นตอนต่อไปนี้จะปิดใช้งานเราเตอร์จาก dc-1 หากมีโหนดเราเตอร์หลายโหนดที่กำหนดค่าใน dc-1 ให้ทำตามขั้นตอนในโหนดเราเตอร์ทั้งหมดทีละรายการ
หมายเหตุ: ในที่นี้มีสมมติฐานว่ามีการกำหนดค่าพอร์ตการตรวจสอบประสิทธิภาพการทำงาน 15999 ของเราเตอร์ในตัวจัดสรรภาระงาน และพอร์ตที่บล็อก 15999 จะทำให้เราเตอร์เข้าถึงเราเตอร์ไม่ได้ คุณอาจต้องมีสิทธิ์เข้าถึงรูทเพื่อบล็อกพอร์ต
หากต้องการเลิกใช้เราเตอร์ ให้ทำตามขั้นตอนต่อไปนี้
ปิดใช้ความสามารถในการเข้าถึงของเราเตอร์โดยบล็อกพอร์ต 15999 ซึ่งเป็นพอร์ตการตรวจสอบประสิทธิภาพการทำงาน ตรวจสอบว่าการเข้าชมรันไทม์ถูกบล็อกในศูนย์ข้อมูลนี้
iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT
ตรวจสอบว่าเราเตอร์เข้าถึงได้ โดยทำดังนี้
curl -vvv -X GET http://{ROUTER_IP}:15999/v1/servers/self/reachable
เอาต์พุตควรมีลักษณะดังนี้
About to connect() to 10.126.0.160 port 15999 (#0) Trying 10.126.0.160... Connection refused Failed connect to 10.126.0.160:15999; Connection refused Closing connection 0 curl: (7) Failed connect to 10.126.0.160:15999; Connection refused
- รับ UUID ของเราเตอร์ตามที่อธิบายไว้ในรับ UUID
- หยุดเราเตอร์ดังนี้
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
- แสดงรายการพ็อดเกตเวย์ที่ใช้ได้ในองค์กรด้วยคำสั่งต่อไปนี้
curl -u <AdminEmailID>:<AdminPassword> -X GET "http://{MS_IP}:8080/v1/organizations/{ORG}/pods"
- ยกเลิกการลงทะเบียนประเภทของเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \ -d "type=router&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"
- ยกเลิกการลงทะเบียนเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword>’ -X DELETE http://{MS_IP}:8080/v1/servers/UUID
- ถอนการติดตั้ง
edge-router
:/opt/apigee/apigee-service/bin/apigee-service edge-router uninstall
ดู นำเซิร์ฟเวอร์ออก - ล้างกฎ
iptables
เพื่อเปิดใช้พอร์ต 15999 ที่ถูกบล็อก:iptables -F
Message Processor
หัวข้อนี้จะอธิบายวิธีการยกเลิกการทำงานของ Message Processor จาก dc-1 โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับการนำตัวประมวลผลข้อความออกที่ นำเซิร์ฟเวอร์ออก
เนื่องจากเราสมมติว่า dc-1 มีการติดตั้งที่คลัสเตอร์ 12 โหนด จึงมีโหนดตัวประมวลผลข้อความ 2 โหนดที่กำหนดค่าใน dc-1 ใช้คำสั่งต่อไปนี้ในโหนดทั้ง 2 แบบ
- รับ UUID ของผู้ประมวลผลข้อความตามที่อธิบายไว้ในรับ UUID
- หยุดตัวประมวลผลข้อความโดยทำดังนี้
apigee-service edge-message-processor stop
- ยกเลิกการลงทะเบียนประเภทของเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \ -d "type=message-processor&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"/pre>
- Disassociate an environment from the Message Processor.
Note: You need to remove the bindings on each org/env that associates the Message Processor UUID.
curl -H "Content-Type:application/x-www-form-urlencoded" -u <AdminEmailID>:'
' \ -X POST http://{MS_IP}:8080/v1/organizations/{ORG}/environments/{ENV}/servers \ -d "action=remove&uuid=UUID" - ยกเลิกการลงทะเบียนประเภทของเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=message-processor®ion=dc-1&pod=gateway-1&uuid=UUID&action=remove"
- ถอนการติดตั้งตัวประมวลผลข้อความ:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor uninstall
- ยกเลิกการลงทะเบียนเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/UUID
เซิร์ฟเวอร์ Qpid และ Qpidd
ส่วนนี้อธิบายวิธียกเลิกการทำงานของเซิร์ฟเวอร์ Qpid (edge-qpid-server
) และ Qpidd
(apigee-qpidd
)
มีโหนด Qpid 2 โหนดที่กำหนดค่าไว้ใน dc-1 คุณจึงต้องทำตามขั้นตอนต่อไปนี้กับทั้ง 2 โหนด
- รับ UUID สำหรับ Qpidd ตามที่อธิบายไว้ในรับ UUID
- หยุด
edge-qpid-server
และapigee-qpidd
:/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
- ดูรายการ Analytics และกลุ่มผู้ใช้ทั่วไป
curl -u <AdminEmailID>:'<AdminPassword>' -X GET http://{MS_IP}:8080/v1/analytics/groups/ax
- นำ Qpid ออกจากกลุ่มผู้ใช้ทั่วไป:
curl -u <AdminEmailID>:'<AdminPassword>' -H "Content-Type: application/json" -X DELETE \ "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/consumer-groups/{consumer_group}/consumers/{QPID_UUID}"
- นำ Qpid ออกจากกลุ่มข้อมูลวิเคราะห์:
curl -v -u <AdminEmailID>:'<AdminPassword>' \ -X DELETE "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/servers?uuid={QPID_UUID}&type=qpid-server"
- ยกเลิกการลงทะเบียนเซิร์ฟเวอร์ Qpid จากการติดตั้ง Edge:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \ -d "type=qpid-server®ion=dc-1&pod=central&uuid={QPID_UUID}&action=remove"
- นําเซิร์ฟเวอร์ Qpid ออกจากการติดตั้ง Edge โดยทำดังนี้
curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
- รีสตาร์ทคอมโพเนนต์ edge-qpid-server ทั้งหมด ในโหนดทั้งหมดเพื่อให้แน่ใจว่าคอมโพเนนต์เหล่านั้นเข้าใจการเปลี่ยนแปลง
$ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready
- ถอนการติดตั้ง edge-qpid-server และ apigee-qpidd:
$ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall $ /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall
Postgres และ Postgresql
ศูนย์ข้อมูลที่คุณกำลังยกเลิกใช้งานอาจมีต้นแบบ Postgres หรือสแตนด์บาย Postgres ส่วนต่อไปนี้จะอธิบายถึงวิธีการเลิกใช้งาน
ต้นแบบ Postgres ของการเลิกใช้การทำงาน
หมายเหตุ: หากคุณเลิกใช้งานต้นแบบ Postgres โปรดโปรโมตโหนดสแตนด์บายใดโหนดหนึ่งที่มีอยู่เป็นต้นแบบ Postgres ใหม่ แม้ว่า QPID จะจัดคิวข้อมูลบัฟเฟอร์ แต่ต้นแบบ Postgres จะใช้งานไม่ได้เป็นเวลานาน คุณก็อาจเสี่ยงต่อการสูญเสียข้อมูลวิเคราะห์
วิธียกเลิกการมอบหมายต้นแบบ Postgres
- สำรองข้อมูลโหนดหลัก dc-1 Postgres โดยทำตามวิธีการในลิงก์ต่อไปนี้
- รับ UUID ของเซิร์ฟเวอร์ Postgres ตามที่อธิบายไว้ใน รับ UUID
- บน dc-1 ให้หยุด
edge-postgres-server
และapigee-postgresql
บนต้นแบบปัจจุบัน/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- ในโหนดสแตนด์บายบน dc-2 ให้ป้อนคำสั่งต่อไปนี้เพื่อทำให้เป็นโหนดหลัก:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql promote-standby-to-master <IP of OLD Progress master>
หมายเหตุ: หากมีโหนด Postgres สแตนด์บายมากกว่า 1 โหนด คุณต้องเพิ่มรายการโฮสต์ในต้นแบบใหม่และอัปเดตการตั้งค่าการจำลองสำหรับโหนด Postgres สแตนด์บายที่มีทั้งหมด
หากต้องการเพิ่มรายการโฮสต์ไปยังต้นแบบ Postgres ใหม่ ให้ทำตามขั้นตอนในส่วนที่เกี่ยวข้องด้านล่าง
หากมีโหนดสแตนด์บายเหลืออยู่เพียง 1 โหนด
ตัวอย่างเช่น สมมติว่าก่อนการเลิกใช้งาน มีโหนด Postgres ที่กำหนดค่าไว้ 3 รายการ คุณได้เลิกใช้โหนดหลักที่มีอยู่และเลื่อนระดับโหนดสแตนด์บาย Postgres ที่เหลืออยู่ 1 โหนดให้เป็นต้นแบบ กำหนดค่าโหนดสแตนด์บายที่เหลือด้วยขั้นตอนต่อไปนี้
- ในต้นฉบับใหม่ ให้แก้ไขไฟล์การกำหนดค่า
เพื่อตั้งค่า:
PG_MASTER=IP_or_DNS_of_new_PG_MASTER PG_STANDBY=IP_or_DNS_of_PG_STANDBY
- เปิดใช้การจำลองในต้นแบบใหม่:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle
หากมีโหนดสแตนด์บายเหลืออยู่มากกว่า 1 โหนด
- เพิ่มการกำหนดค่าต่อไปนี้ใน
/opt/apigee/customer/application/postgresql.properties
:conf_pg_hba_replication.connection=host replication apigee standby_1_ip/32 trust \n host replication apigee standby_2_ip/32 trust
- ตรวจสอบว่าไฟล์ /opt/apigee/customer/application/postgresql.properties เป็นของผู้ใช้ Apigee:
chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
- รีสตาร์ท
apigee-postgresql
:apigee-service apigee-postgresql restart
- แก้ไขไฟล์การกำหนดค่า
/opt/silent.conf
และอัปเดตช่องPG_MASTER
ด้วยที่อยู่ IP ของต้นแบบ Postgres ใหม่ - นำข้อมูล Postgres เก่าออกด้วยคำสั่งต่อไปนี้
rm -rf /opt/apigee/data/apigee-postgresql/
- ตั้งค่าการจำลองในโหนดสแตนด์บาย:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- ตรวจสอบว่าได้ตั้งค่าต้นแบบ Postgres อย่างถูกต้องโดยป้อนคำสั่งต่อไปนี้ใน dc-2:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
- นำเซิร์ฟเวอร์ Postgresql ออกจากกลุ่มข้อมูลวิเคราะห์และกลุ่มผู้บริโภค
- นำเซิร์ฟเวอร์ Postgres เก่าออกจากกลุ่มการวิเคราะห์โดยทำตามวิธีการในหัวข้อ นำเซิร์ฟเวอร์ Postgres ออกจากกลุ่มข้อมูลวิเคราะห์
- เพิ่มเซิร์ฟเวอร์ Postgres ใหม่ลงในกลุ่ม Analytics โดยทำตามวิธีการใน เพิ่มเซิร์ฟเวอร์ Postgres ที่มีอยู่ลงในกลุ่มข้อมูลวิเคราะห์
- ยกเลิกการลงทะเบียนเซิร์ฟเวอร์ Postgres เก่าจาก dc-1:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \ -d "type=postgres-server®ion=dc-1&pod=analytics&uuid=UUID&action=remove"<
- ลบเซิร์ฟเวอร์ Postgres เก่าออกจาก dc-1:
curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
- ตอนนี้ผู้เชี่ยวชาญ Postgres รุ่นเดิมปลอดภัยที่จะเลิกใช้งานแล้ว ถอนการติดตั้ง
edge-postgres-server
และapigee-postgresql
:/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall
วิธีอัปเดตการตั้งค่าการจำลองในโหนดสแตนด์บาย
กำลังเลิกใช้งานโหมด Postgres
หมายเหตุ: เอกสารประกอบสำหรับการติดตั้งคลัสเตอร์ 12 โหนดจะแสดงโหนด dc-1 postgresql เป็นต้นแบบ แต่เพื่อความสะดวก ในส่วนนี้จะถือว่าโหนด dc-1 postgresql อยู่ในโหมดสแตนด์บายและโหนด dc-2 postgresql เป็นโหนดหลัก
หากต้องการเลิกใช้งานการสแตนด์บาย Postgres ให้ทำตามขั้นตอนต่อไปนี้
- รับ UUID ของเซิร์ฟเวอร์ Postgres โดยทำตามวิธีการในรับ UUID
- หยุด
apigee-postgresql
ในโหนดสแตนด์บายปัจจุบันใน dc-1:/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- นำเซิร์ฟเวอร์ Postgresql ออกจากกลุ่มข้อมูลวิเคราะห์และกลุ่มผู้บริโภค
- นำเซิร์ฟเวอร์ Postgres เก่าออกจากกลุ่มการวิเคราะห์โดยทำตามวิธีการในหัวข้อ นำเซิร์ฟเวอร์ Postgres ออกจากกลุ่มข้อมูลวิเคราะห์
- เพิ่มเซิร์ฟเวอร์ Postgres ใหม่ลงในกลุ่ม Analytics โดยทำตามวิธีการใน เพิ่มเซิร์ฟเวอร์ Postgres ที่มีอยู่ลงในกลุ่มข้อมูลวิเคราะห์
- ยกเลิกการลงทะเบียนเซิร์ฟเวอร์ Postgres เก่าจาก dc-1:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \ -d "type=postgres-server®ion=dc-1&pod=analytics&uuid=UUID&action=remove"<
- ลบเซิร์ฟเวอร์ Postgres เก่าออกจาก dc-1:
curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
- ตอนนี้ผู้เชี่ยวชาญ Postgres รุ่นเดิมปลอดภัยที่จะเลิกใช้งานแล้ว ถอนการติดตั้ง
edge-postgres-server
และapigee-postgresql
:/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall
ZooKeeper และ Cassandra
ส่วนนี้จะอธิบายวิธีเลิกใช้เซิร์ฟเวอร์ ZooKeeper และ Cassandra ในการตั้งค่าศูนย์ข้อมูล 2 รายการ
หากคุณมีศูนย์ข้อมูลมากกว่า 2 แห่ง ให้นำการอ้างอิงทั้งหมดไปยังโหนดที่กำลังเลิกใช้งาน (ในกรณีนี้คือ dc-1) ออกจากไฟล์การกำหนดค่าแบบเงียบทั้งหมดในศูนย์ข้อมูลที่เหลือทั้งหมด สำหรับโหนด Cassandra ที่กำลังจะเลิกใช้งาน ให้ทิ้งโฮสต์เหล่านั้นจาก
CASS_HOSTS
โหนด Cassandra ที่เหลือควรอยู่ในลำดับเดิมของCASS_HOSTS
หมายเหตุเกี่ยวกับ ZooKeeper: คุณต้องรักษาโควต้าของโหนดผู้โหวตขณะแก้ไขพร็อพเพอร์ตี้
ZK_HOST
ในไฟล์การกำหนดค่า เพื่อให้แน่ใจว่าชุด ZooKeeper ยังคงใช้งานได้ คุณต้องมีโหนดผู้โหวตจำนวนคี่ในการกำหนดค่า ดูข้อมูลเพิ่มเติมได้ที่งานบำรุงรักษา Apache ZooKeeperวิธีเลิกใช้งานเซิร์ฟเวอร์ ZooKeeper และ Cassandra ให้ทำดังนี้
- สำรองข้อมูลโหนด dc-1 Cassandra และ ZooKeeper โดยทำตามวิธีการในลิงก์ต่อไปนี้
ระบุ UUID ของเซิร์ฟเวอร์ ZooKeeper และ Cassandra ในศูนย์ข้อมูลที่กําลังจะเลิกใช้โหนด Cassandra
apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin <AdminEmailID> --pwd '<AdminPassword>' --host localhost
- ยกเลิกการลงทะเบียนประเภทของเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=user-settings-datastore&type=auth-datastore®ion=dc-1&pod=central&uuid=UUID&action=remove"
- ยกเลิกการลงทะเบียนเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID
- อัปเดตไฟล์การกำหนดค่าโดยนำ IP ของโหนดที่เลิกใช้งานแล้วออกจาก
ZK_HOSTS
และCASS_HOSTS
ตัวอย่างเช่น สมมติว่าคุณมี IP
$IP1 $IP2 $IP3
ใน dc-1 และ$IP4 $IP5 $IP6
ใน dc-2 และคุณกำลังยกเลิกการทำงานของ dc-1 จากนั้นคุณควรนำ IP$IP1 $IP2 $IP3
ออกจากไฟล์การกำหนดค่า- รายการไฟล์การกำหนดค่าที่มีอยู่:
ZK_HOSTS="$IP1 $IP2 $IP3 $IP4 $IP5 $IP6" CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1, $IP4:2,1 $IP5:2,1 $IP6:2,1”
- รายการไฟล์การกำหนดค่าใหม่:
ZK_HOSTS="$IP4 $IP5 $IP6" CASS_HOSTS="$IP4:2,1 $IP5:2,1 $IP6:2,1"
- รายการไฟล์การกำหนดค่าที่มีอยู่:
- อัปเดตไฟล์การกำหนดค่าเงียบ (แก้ไขในขั้นตอนที่ e) ด้วย IP ของโหนดที่เลิกใช้งานแล้วซึ่งนำออกแล้ว และเรียกใช้โปรไฟล์เซิร์ฟเวอร์การจัดการในโหนดทั้งหมดที่โฮสต์เซิร์ฟเวอร์การจัดการ:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f updated_config_file
- อัปเดตไฟล์การกำหนดค่าด้วย IP ของโหนดที่เลิกใช้งานแล้วที่นำออก และเรียกใช้โปรไฟล์ MP/RMP บนโหนดเราเตอร์และผู้ประมวลผลข้อมูลข้อความทั้งหมดโดยทำดังนี้
- หากมีการกำหนดค่า Edge Router และเครื่องมือประมวลผลข้อความในโหนดเดียวกัน ให้ป้อน
/opt/apigee/apigee-setup/bin/setup.sh -p rmp -f updated_config_file
หากมีการกำหนดค่า Edge Router และเครื่องมือประมวลผลข้อความในโหนดแยกกัน ให้ป้อนข้อมูลต่อไปนี้
สำหรับเราเตอร์:
/opt/apigee/apigee-setup/bin/setup.sh -p r -f updated_config_file
สำหรับเครื่องมือประมวลผลข้อความ
/opt/apigee/apigee-setup/bin/setup.sh -p mp -f updated_config_file
- หากมีการกำหนดค่า Edge Router และเครื่องมือประมวลผลข้อความในโหนดเดียวกัน ให้ป้อน
- กำหนดค่าโหนด Qpid ทั้งหมดใหม่โดยนำ IP ของโหนดที่เลิกใช้งานแล้วออกจากไฟล์ตอบกลับ:
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f updated_config_file
- กำหนดค่าโหนด Postgres ทั้งหมดอีกครั้งโดยนำ IP ของโหนดที่เลิกใช้งานแล้วออกจากไฟล์ตอบกลับ:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updated_config_file
- เปลี่ยนแป้นวรรค
system_auth
หากคุณเปิดใช้การตรวจสอบสิทธิ์ Cassandra บนโหนด Cassandra ที่มีอยู่ ให้อัปเดตปัจจัยการจำลองของพื้นที่คีย์system_auth
ด้วยการเรียกใช้คำสั่งต่อไปนี้:ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-2': '3'};
คำสั่งนี้ตั้งค่าปัจจัยการจำลองเป็น
'3'
ซึ่งบ่งชี้โหนด Cassandra 3 โหนดในคลัสเตอร์ แก้ไขค่านี้ตามที่จำเป็นเมื่อทำขั้นตอนนี้เสร็จแล้ว โทโพโลยีของ Cassandra ไม่ควรมี
dc-1
ในแป้นใดๆ - ปิดใช้งานโหนด Cassandra บน dc-1 ทีละรายการ
หากต้องการเลิกใช้โหนด Cassandra ให้ป้อนคำสั่งต่อไปนี้
/opt/apigee/apigee-cassandra/bin/nodetool -h cassIP -u cassandra -pw '<AdminPassword>' decommission
- ตรวจสอบการเชื่อมต่อโหนด Cassandra จาก dc-1 โดยใช้คำสั่งใดคำสั่งหนึ่งต่อไปนี้
/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p '<AdminPassword>'
หรือคำสั่งยืนยันรองที่จะเรียกใช้ในโหนดที่เลิกใช้งานแล้ว:
/opt/apigee/apigee-cassandra/bin/nodetool netstats
คำสั่งด้านบนควรแสดงผล:
Mode: DECOMMISSIONED
- เรียกใช้โปรไฟล์ DS สำหรับโหนด Cassandra และ ZooKeeper ทั้งหมดใน dc-2:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f updated_config_file
- หยุด
apigee-cassandra
และapigee-zookeeper
ใน dc-1:apigee-service apigee-cassandra stop
apigee-service apigee-zookeeper stop
- ถอนการติดตั้ง
apigee-cassandra
และapigee-zookeeper
ใน dc-1:apigee-service apigee-cassandra uninstall
apigee-service apigee-zookeeper uninstall
ลบการเชื่อมโยงจาก dc-1
หากต้องการลบการเชื่อมโยงจาก dc-1 ให้ทำตามขั้นตอนต่อไปนี้
- ลบการเชื่อมโยงจาก dc-1
- แสดงรายการพ็อดทั้งหมดที่ใช้ได้ภายใต้องค์กร:
curl -v -u <AdminEmailID>:<AdminPassword> -X GET "http://MS_IP:8080/v1/o/ORG/pods"
- หากต้องการตรวจสอบว่ามีการนำการเชื่อมโยงทั้งหมดออกแล้วหรือไม่ ให้รับ UUID ของเซิร์ฟเวอร์ที่เชื่อมโยงกับพ็อดโดยทำดังนี้
curl -v -u <AdminEmailID>:<AdminPassword> \ -X GET "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1/servers"
หากคำสั่งนี้ไม่แสดง UUID แสดงว่าขั้นตอนก่อนหน้าได้นําการเชื่อมโยงทั้งหมดออก และคุณก็ข้ามขั้นตอนถัดไปได้ หรือมิฉะนั้น ให้ทำตามขั้นตอนถัดไป
- นำการเชื่อมโยงเซิร์ฟเวอร์ทั้งหมดสำหรับ UUID ที่ได้รับในขั้นตอนก่อนหน้าออก:
curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID
- ยกเลิกการเชื่อมโยงองค์กรจากพ็อด:
curl -v -u <AdminEmailID>:<AdminPassword> "http://MS_IP:8080/v1/o/ORG/pods" -d "action=remove®ion=dc-1&pod=gateway-1" -H "Content-Type: application/x-www-form-urlencoded" -X POST
- แสดงรายการพ็อดทั้งหมดที่ใช้ได้ภายใต้องค์กร:
- ลบพ็อด:
curl -v -u <AdminEmailID>:<AdminPassword> "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1" -X DELETE
- ลบภูมิภาค
curl -v -u <AdminEmailID>:<AdminPassword> "http://MS_IP:8080/v1/regions/dc-1" -X DELETE
หมายเหตุ: หากลบเซิร์ฟเวอร์ออกจากขั้นตอนใดขั้นตอนหนึ่ง ขั้นตอนข้างต้นจะแสดงข้อความแสดงข้อผิดพลาดว่ายังมีเซิร์ฟเวอร์ในพ็อดอยู่ ดังนั้น ให้ลบออกโดยทำตามขั้นตอนการแก้ปัญหาด้านล่าง ขณะปรับแต่งประเภทในคำสั่ง
curl
ณ จุดนี้ คุณได้ยกเลิกการทำงานของ dc-1 เรียบร้อยแล้ว
ภาคผนวก
การแก้ปัญหา
หากหลังจากทำตามขั้นตอนก่อนหน้านี้แล้ว ยังมีเซิร์ฟเวอร์ในพ็อดบางรายการอยู่ ให้ทำตามขั้นตอนต่อไปนี้เพื่อยกเลิกการลงทะเบียนและลบเซิร์ฟเวอร์ หมายเหตุ: เปลี่ยนประเภทและพ็อดตามความจำเป็น
- รับ UUID โดยใช้คำสั่งต่อไปนี้
apigee-adminapi.sh servers list -r dc-1 -p POD -t --admin <AdminEmailID> --pwd '<AdminPassword>’ --host localhost
- ยกเลิกการลงทะเบียนประเภทของเซิร์ฟเวอร์:
curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MP_IP:8080/v1/servers -d "type=TYPE=REGION=dc-1&pod=POD&uuid=UUID&action=remove"
- ลบเซิร์ฟเวอร์ทีละรายการ:
curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MP_IP:8080/v1/servers/UUID
การตรวจสอบความถูกต้อง
คุณสามารถตรวจสอบการเลิกใช้งานได้โดยใช้คำสั่งต่อไปนี้
เซิร์ฟเวอร์การจัดการ
เรียกใช้คำสั่งต่อไปนี้จากเซิร์ฟเวอร์การจัดการในทุกภูมิภาค
curl -v -u <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=central®ion=dc-1 curl -v -u <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=gateway®ion=dc-1 curl -v -u <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=analytics®ion=dc-1
เรียกใช้คำสั่งต่อไปนี้กับคอมโพเนนต์ทั้งหมดเพื่อตรวจสอบข้อกำหนดของพอร์ตสำหรับพอร์ตการจัดการทั้งหมด
curl -v http://MS_IP:8080/v1/servers/self
ตรวจสอบกลุ่มข้อมูลวิเคราะห์
curl -v -u <AdminEmailID>:'<AdminPassword>' "http://MS_IP:8080}/v1/o/ORG/e/ENV/provisioning/axstatus" curl -v -u <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/analytics/groups/ax
โหนด Cassandra/ZooKeeper
ในโหนด Cassandra ทั้งหมด ให้ป้อน
/opt/apigee/apigee-cassandra/bin/nodetool -h <host> statusthrift
การดำเนินการนี้จะแสดงสถานะ
running
หรือnot running
สำหรับโหนดที่เฉพาะเจาะจงใน 1 โหนด ให้ป้อน
/opt/apigee/apigee-cassandra/bin/nodetool -h <host> ring
/opt/apigee/apigee-cassandra/bin/nodetool -h <host> status
คำสั่งข้างต้นจะแสดงข้อมูลของศูนย์ข้อมูลที่ใช้งานอยู่
ในโหนด ZooKeeper ให้ป้อนดังนี้
echo ruok | nc <host> 2181
คำสั่งนี้จะส่งคืน
imok
จากนั้นป้อน
echo stat | nc <host> 2181 | grep Mode
ค่าของ
Mode
ที่คำสั่งด้านบนแสดงผลจะเป็นค่าใดค่าหนึ่งต่อไปนี้observer
leader
หรือfollower
ในโหนด ZooKeeper เดียว:
/opt/apigee/apigee-zookeeper/contrib/zk-tree.sh >> /tmp/zk-tree.out.txt
ในโหนดหลักของ Postgres ให้เรียกใช้คำสั่งต่อไปนี้
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
ตรวจสอบว่าการตอบสนองระบุว่าโหนดเป็นโหนดหลัก
ในโหนดสแตนด์บาย:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
ตรวจสอบว่าการตอบกลับระบุว่าโหนดอยู่ในโหมดสแตนด์บาย
เข้าสู่ระบบฐานข้อมูล PostgreSQL โดยใช้คำสั่ง
psql -h localhost -d apigee -U postgres
เมื่อได้รับข้อความแจ้ง ให้ป้อนรหัสผ่านของผู้ใช้ "postgres" เป็น
'postgres'
เลือกmax(client_received_start_timestamp)
จาก Analytics”$org.$env.fact” limit 1
;บันทึก
ตรวจสอบบันทึกของคอมโพเนนต์เพื่อให้แน่ใจว่าไม่มีข้อผิดพลาด
- ในต้นฉบับใหม่ ให้แก้ไขไฟล์การกำหนดค่า
เพื่อตั้งค่า: