การย้ายเซิร์ฟเวอร์ Apigee

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

คอมโพเนนต์ Apigee ใช้ที่อยู่ IP เพื่อสื่อสารกัน การย้ายคอมโพเนนต์จากเครื่องหนึ่งไปยังอีกเครื่องหนึ่งอาจทำให้การกำหนดค่าไม่ตรงกัน หากต้องการแก้ไขการกำหนดค่าที่ไม่ตรงกัน ให้ทำตามวิธีการที่เกี่ยวข้องด้านล่าง

การเปลี่ยนที่อยู่ IP ของโหนด Cassandra

หากต้องการเปลี่ยนที่อยู่ IP ของโหนด Cassandra ให้ทำตามขั้นตอนต่อไปนี้

สำหรับการกำหนดค่าที่มีโหนด Cassandra โหนดเดียว

1. แก้ไข /opt/apigee/customer/application/cassandra.properties ในระบบที่กำลังแก้ไข หากไม่มีไฟล์ ให้สร้างไฟล์
2. เปลี่ยนพารามิเตอร์ต่อไปนี้
   • ตั้งค่าพารามิเตอร์ conf_cassandra_seeds และ conf_cassandra_listen_address เพื่อระบุที่อยู่ IP ใหม่ของระบบ
   • เปลี่ยน conf_cassandra_rpc_address เพื่อใช้ที่อยู่ IP ใหม่หรือ 0.0.0.0 (ซึ่งช่วยให้ Cassandra Thrift ฟังอินเทอร์เฟซทั้งหมดได้)
3. เปิด /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties ในเครื่องมือแก้ไข คุณควรเห็นที่อยู่ IP เดิมและการตั้งค่าเริ่มต้นในรูปแบบต่อไปนี้
   192.168.56.101=dc-1:ra-1
   default=dc-1:ra-1
   
   บันทึกข้อมูลดังกล่าว
4. แก้ไข /opt/apigee/customer/application/cassandra.properties เพื่อเปลี่ยนที่อยู่ IP เดิมที่ระบุเป็นที่อยู่ IP ใหม่
   conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n
   
   ตรวจสอบว่าคุณได้แทรก "\n" หลังที่อยู่ IP และระบุการตั้งค่าเริ่มต้นเดียวกันกับที่พบในขั้นตอนที่ 3 ด้านบน
5. รีสตาร์ท Cassandra:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
6. หากจำเป็น ให้ซ่อมแซม ZooKeeper ด้วย (ดูด้านล่าง) หรือรีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทุกรายการโดยเริ่มจาก Management Server

สำหรับการกำหนดค่าที่มีโหนด Cassandra หลายโหนด (ริง)

1. หากโหนดที่กำลังเปลี่ยนแปลงเป็นโหนดเริ่มต้น ให้แก้ไขไฟล์ /opt/apigee/customer/application/cassandra.properties ในแต่ละระบบในวงแหวน และเปลี่ยนพารามิเตอร์ conf_cassandra_seeds ให้รวม IP ใหม่ของระบบที่แก้ไข หากไม่มีไฟล์ cassandra.properties ให้สร้างขึ้นมา
2. แก้ไข /opt/apigee/customer/application/cassandra.properties ในระบบที่กำลังแก้ไข และเปลี่ยนพารามิเตอร์ต่อไปนี้
   • ตั้งค่า conf_cassandra_listen_address ให้ใช้ที่อยู่ IP ใหม่
   • ตั้งค่า conf_cassandra_rpc_address ให้ใช้ที่อยู่ IP ใหม่หรือ 0.0.0.0 (ซึ่งช่วยให้ Cassandra Thrift ฟังอินเทอร์เฟซทั้งหมดได้)
3. เปิด /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties ในเครื่องมือแก้ไข คุณควรเห็นที่อยู่ IP ของ Cassandra ทั้งหมดและการตั้งค่าเริ่มต้นในรูปแบบต่อไปนี้
   192.168.56.101=dc-1:ra-1
   192.168.56.102=dc-1:ra-1
   192.168.56.103=dc-1:ra-1
   default=dc-1:ra-1
   
   บันทึกข้อมูลดังกล่าว
4. แก้ไข /opt/apigee/customer/application/cassandra.properties เพื่อเปลี่ยนที่อยู่ IP เดิมที่ระบุเป็นที่อยู่ IP ใหม่:
   conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n
   
   ตรวจสอบว่าคุณใส่ "\n" หลังที่อยู่ IP แต่ละรายการ และใช้การตั้งค่าเริ่มต้นเดียวกันกับที่บันทึกไว้ด้านบนในขั้นตอนที่ 3
5. รีสตาร์ท Cassandra ในระบบที่แก้ไข หากระบบที่แก้ไขเป็นโหนดเริ่มต้น ให้รีสตาร์ทแต่ละระบบที่ใช้โหนดเริ่มต้นที่แก้ไขด้วย
   > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
6. เรียกใช้คำสั่ง nodetool ring ในโหนดที่แก้ไขเพื่อให้แน่ใจว่าวงแหวนสมบูรณ์ โดยจะดูยูทิลิตีได้ที่ opt/apigee/apigee-cassandra/bin
   > nodetool -h localhost ring
7. เรียกใช้ nodetool repair ในโหนดที่แก้ไข โปรดทราบว่ากระบวนการนี้อาจใช้เวลาสักครู่ เราจึงขอแนะนำอย่างยิ่งว่าไม่ควรดำเนินการนี้ในช่วงที่มีการเข้าชม API สูงสุด
   > nodetool -h localhost repair
8. หากจำเป็น ให้ซ่อมแซม ZooKeeper (ดูด้านล่าง) จากนั้นรีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทุกรายการโดยเริ่มจาก Management Server

อัปเดตการลงทะเบียน Datastore

1. ค้นหา UUID ของการลงทะเบียน Datastore ที่ระบุที่อยู่ IP เดิมโดยใช้คำสั่งด้านล่าง จดบันทึกพารามิเตอร์ "type" และ "UUID" ดังนี้
   • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=central&region=DC" | egrep -i '(type|internalip|uuid|region)'
   • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '(type|internalip|uuid|region)'
   • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '(type|internalip|uuid|region)'
     
     โดยที่ DC คือชื่อศูนย์ข้อมูล ในการติดตั้งศูนย์ข้อมูลเดียว ค่ามักจะเป็น "dc-1"
2. ลงทะเบียนที่อยู่ IP ใหม่โดยใช้คำสั่งใดคำสั่งหนึ่งด้านล่าง คำสั่งที่จำเป็นจะขึ้นอยู่กับประเภทของโหนดที่เปลี่ยนแปลง
   
   หมายเหตุ: พารามิเตอร์ REGION ด้านล่างหมายถึงศูนย์ข้อมูลที่คลัสเตอร์อยู่ ตัวอย่างเช่น สำหรับความพร้อมใช้งานสูง โดยทั่วไปคุณจะมีคลัสเตอร์ใน dc-1 (ศูนย์ข้อมูล 1) และคลัสเตอร์ใน dc-2 (ศูนย์ข้อมูล 2) พารามิเตอร์นี้จะกำหนดไว้ ณ เวลาที่ติดตั้ง ค่าเริ่มต้นคือ dc-1
   • สำหรับ type="application-datastore":
     curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=application-datastore&Type=audit-datastore&InternalIP=${NEWIP}&region=${REGION}&pod=central" -H 'content-type: application/x-www-form-urlencoded' -X POST
   • สำหรับ type="kms-datastore":
     curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore &InternalIP=${NEWIP}&region=${REGION}&pod=${GATEWAY_POD}" -H 'content-type: application/x-www-form-urlencoded' -X POST
   • สำหรับ type="reportcrud-datastore":
     curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers" -d "Type=reportcrud-datastore&InternalIP=${NEW_IP}&region=${REGION}&pod=analytics" -H 'content-type: application/x-www-form-urlencoded' -X POST
3. ลบการลงทะเบียนเก่าสำหรับ UUID ของระบบที่มีการเปลี่ยนแปลงที่อยู่ IP สำหรับปัญหา UUID แต่ละรายการ ให้ใช้คำสั่งต่อไปนี้
   curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

การเปลี่ยนที่อยู่ IP ของโหนด ZooKeeper

ทำตามขั้นตอนด้านล่างเพื่อเปลี่ยนที่อยู่ IP ของโหนด ZooKeeper

เปลี่ยนที่อยู่ IP และรีสตาร์ท ZooKeeper Ensemble (สำหรับการกำหนดค่า Ensemble แบบหลายโหนดเท่านั้น)

1. เปิด /opt/apigee/apigee-zookeeper/conf/zoo.cfg ในเครื่องมือแก้ไข คุณควรเห็นที่อยู่ IP ของ ZooKeeper ทั้งหมดและการตั้งค่าเริ่มต้นในรูปแบบต่อไปนี้
   server.1=192.168.56.101:2888:3888
   server.2=192.168.56.102:2888:3888
   server.3=192.168.56.103:2888:3888
   
   บันทึกข้อมูลดังกล่าว
2. ในแต่ละโหนด ZooKeeper ให้แก้ไขไฟล์ /opt/apigee/customer/application/zookeeper.properties เพื่อตั้งค่าพร็อพเพอร์ตี้ conf_zoo_quorum เป็นที่อยู่ IP ที่ถูกต้อง หากไม่มีไฟล์ ให้สร้างไฟล์
   conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\n
   
   ตรวจสอบว่าคุณได้ใส่ "\n" หลังที่อยู่ IP แต่ละรายการ และรายการต่างๆ อยู่ในลำดับเดียวกันในทุกโหนด
3. ค้นหาผู้นำของกลุ่ม ZooKeeper โดยใช้คำสั่งต่อไปนี้ (แทนที่ <node> ด้วยที่อยู่ IP ของเครื่อง Zookeeper):
   echo srvr | nc <node> 2181
   
   บรรทัดโหมดในเอาต์พุตควรระบุว่า "leader"
4. รีสตาร์ท ZooKeeper ทีละรายการโดยเริ่มจาก Leader และสิ้นสุดที่โหนดที่มีการเปลี่ยนแปลงที่อยู่ IP หากโหนด Zookeeper มากกว่า 1 โหนดเปลี่ยนที่อยู่ IP คุณอาจต้องรีสตาร์ทโหนดทั้งหมด
   > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
5. ใช้คำสั่ง echo ที่อธิบายไว้ข้างต้นเพื่อยืนยันโหนด ZooKeeper แต่ละโหนด

แจ้งโหนด Apigee เกี่ยวกับการกำหนดค่าที่เปลี่ยนแปลง

1. ในโหนดเราเตอร์แต่ละโหนด ให้แก้ไขไฟล์ /opt/apigee/customer/application/router.properties ดังนี้ หากไม่มีไฟล์ ให้สร้างไฟล์
   • เปลี่ยนพารามิเตอร์ conf_zookeeper_connection.string เพื่อรวมที่อยู่ IP ใหม่
   • เปลี่ยนพารามิเตอร์ conf_zookeeper_zk1.host ให้รวมที่อยู่ IP ใหม่
2. ในโหนด Message Processor ทุกโหนด ให้แก้ไขไฟล์ /opt/apigee/customer/application/message-processor.properties ดังนี้ หากไม่มีไฟล์ ให้สร้างไฟล์
   • เปลี่ยนพารามิเตอร์ conf_zookeeper_connection.string เพื่อรวมที่อยู่ IP ใหม่
   • เปลี่ยนพารามิเตอร์ conf_zookeeper_zk1.host ให้รวมที่อยู่ IP ใหม่
3. ในโหนดเซิร์ฟเวอร์การจัดการ ให้แก้ไขไฟล์ /opt/apigee/customer/application/management-server.properties ดังนี้ หากไม่มีไฟล์ ให้สร้างไฟล์
   • เปลี่ยนพารามิเตอร์ conf_zookeeper_connection.string เพื่อรวมที่อยู่ IP ใหม่
   • เปลี่ยนพารามิเตอร์ conf_zookeeper_zk1.host ให้รวมที่อยู่ IP ใหม่
4. รีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทั้งหมดโดยเรียกใช้คำสั่งต่อไปนี้ในแต่ละโหนด
   /opt/apigee/apigee-service/bin/apigee-all restart

การเปลี่ยนที่อยู่ IP ของเซิร์ฟเวอร์ LDAP (OpenLDAP)

หากต้องการเปลี่ยนที่อยู่ IP ของโหนด OpenLDAP ให้ทำดังนี้

1. ในโหนด Management Server ให้แก้ไขไฟล์ /opt/apigee/customer/application/management-server.properties หากไม่มีไฟล์ ให้สร้างไฟล์
2. ในไฟล์ management-server.properties ให้ตั้งค่าพารามิเตอร์ conf_security_ldap.server.host เป็นที่อยู่ IP ใหม่
3. รีสตาร์ทเซิร์ฟเวอร์การจัดการ:
   > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

การเปลี่ยนที่อยู่ IP ของโหนด Apigee ประเภทอื่นๆ

หากต้องการเปลี่ยนที่อยู่ IP ของโหนดประเภทใดประเภทหนึ่งต่อไปนี้ (เราเตอร์, Message Processor, เซิร์ฟเวอร์ Postgres (ไม่ใช่ postgresql) และเซิร์ฟเวอร์ Qpid (ไม่ใช่ qpidd)) ให้ทำดังนี้

1. ใช้คำสั่ง cURL ต่อไปนี้เพื่อลงทะเบียนที่อยู่ IP ภายในและภายนอกใหม่
   curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
   curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d InternalIP=<ip>
   
   โดยที่ uuid คือ UUID ของ โหนด

หากไม่ทราบ UUID ของโหนด คุณสามารถใช้คำสั่งต่อไปนี้เพื่อแสดง UUID ได้

• เราเตอร์: curl http://<router_IP>:8081/v1/servers/self
• Message Processor: curl http://<mp_IP>:8082/v1/servers/self
• Qpid: curl http://<qp_IP>:8083/v1/servers/self
• Postgres: curl http://<pg_IP>:8084/v1/servers/self