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

การย้ายคอมโพเนนต์จากเครื่องหนึ่งไปยังอีกเครื่องหนึ่งอาจทำให้เกิดการกำหนดค่าไม่ตรงกันหากคุณไม่ได้ซิงค์ที่อยู่ IP ในไฟล์การกำหนดค่าคอมโพเนนต์

ส่วนนี้จะอธิบายวิธีวินิจฉัยและแก้ไขการกำหนดค่าที่ไม่ตรงกัน

ที่อยู่ IP กับชื่อโฮสต์

คุณควรใช้ที่อยู่ IP แทนชื่อโฮสต์ในไฟล์การกำหนดค่าคอมโพเนนต์

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

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

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

สถานการณ์	ผลกระทบต่อการย้ายเซิร์ฟเวอร์
การเปลี่ยนแปลงที่อยู่ IP	อัปเดตไฟล์ที่เกี่ยวข้องทั้งหมดซึ่งอ้างอิงถึงที่อยู่ IP เดิม
การเปลี่ยนชื่อโฮสต์โดยไม่มีการเปลี่ยนแปลงที่อยู่ IP	ไม่ได้ส่งผลอะไร
การเปลี่ยนชื่อโฮสต์เมื่อมีการเปลี่ยนแปลงที่อยู่ IP	เหมือนกับการเปลี่ยนแปลงที่อยู่ 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 ด้วย (ดูการเปลี่ยนที่อยู่ IP ของโหนด 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. สำหรับโหนดอื่นๆ ทั้งหมด ให้ทำซ้ำการเปลี่ยนแปลงที่ทำในขั้นตอนที่ 3 และ 4 เพื่อแจ้งให้ทราบเกี่ยวกับตำแหน่งของโหนดนี้ในวงแหวน Cassandra นอกจากนี้ ให้เปลี่ยน IP ของโหนดเริ่มต้นตามที่อธิบายไว้ในขั้นตอนที่ 1
7. รีสตาร์ทโหนด Cassandra ที่เหลือทีละโหนด

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

8. เรียกใช้คำสั่ง nodetool ring ในโหนดที่แก้ไขเพื่อให้แน่ใจว่าวงแหวนเสร็จสมบูรณ์ คุณสามารถดูยูทิลิตีได้ที่ /opt/apigee/apigee-cassandra/bin

   nodetool [-u username -pw password] -h localhost ring

9. เรียกใช้ nodetool repair ในโหนดที่แก้ไข โปรดทราบว่ากระบวนการนี้อาจใช้เวลาสักครู่ ดังนั้นเราขอแนะนำอย่างยิ่งว่าอย่าดำเนินการในช่วงเวลาที่มีการเข้าชม API สูงสุด

   nodetool [-u username -pw password] -h localhost repair -pr

10. หากจำเป็น ให้ซ่อมแซม ZooKeeper (ดูการเปลี่ยนที่อยู่ IP ของโหนด ZooKeeper) จากนั้นรีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทุกรายการ โดยเริ่มจากเซิร์ฟเวอร์การจัดการ

อัปเดตการลงทะเบียน ที่เก็บข้อมูล

1. ค้นหา UUID ของการลงทะเบียนพื้นที่เก็บข้อมูลที่ระบุที่อยู่ 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 ใหม่โดยใช้คำสั่งใดคำสั่งหนึ่งด้านล่าง คำสั่งที่จำเป็นจะ ขึ้นอยู่กับประเภทของโหนดที่เปลี่ยนแปลง
   • สำหรับ 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 (สำหรับการกำหนดค่ากลุ่มแบบหลายโหนดเท่านั้น)

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

   บรรทัด Mode ในเอาต์พุตควรระบุว่า "leader"

4. รีสตาร์ท ZooKeeper ทีละรายการโดยเริ่มจากลีดเดอร์และจบด้วยโหนดที่เปลี่ยนที่อยู่ 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 (SymasLDAP)

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

1. ในโหนดเซิร์ฟเวอร์การจัดการ ให้แก้ไขไฟล์ /opt/apigee/customer/application/management-server.properties file หากไม่มีไฟล์ ให้สร้างไฟล์
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