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

Edge สำหรับ Private Cloud เวอร์ชัน 4.16.09

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

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

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

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

  1. แก้ไข /<inst_root>/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. เปิด /<inst_root>/apigee/apigee-cassandra/conf/cassandra-topology.properties ในเครื่องมือแก้ไข คุณควรเห็นที่อยู่ IP เดิมและการตั้งค่าเริ่มต้นในแบบฟอร์ม
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

    บันทึกข้อมูลดังกล่าว
  4. แก้ไข /<inst_root>/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

    หลังจากพบที่อยู่ IP เริ่มต้น และระบุ IP เริ่มต้นเป็นขั้นตอนด้านบน\n

    หลังจากพบที่อยู่ IP เริ่มต้นแล้ว ให้ระบุเป็น IP เริ่มต้น\n
  5. รีสตาร์ท Cassandra:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra launch
  6. หากจำเป็นให้ซ่อมแซม ZooKeeper (ดูด้านล่าง) ให้รีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทั้งหมดโดยเริ่มต้นจากเซิร์ฟเวอร์การจัดการ

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

  1. หากโหนดที่เปลี่ยนแปลงเป็นโหนดตั้งต้น ให้แก้ไขไฟล์ /<inst_root>/apigee/customer/application/cassandra.properties ในแต่ละระบบในริง และเปลี่ยนพารามิเตอร์ conf_cassandra_seeds ให้รวม IP ใหม่ของระบบที่แก้ไขแล้ว หากไม่มีไฟล์ cassandra.properties ให้สร้างขึ้นมา
  2. แก้ไข /<inst_root>/apigee/customer/application/cassandra.properties ในระบบที่ได้รับการแก้ไข และเปลี่ยนพารามิเตอร์ต่อไปนี้
    • ตั้งค่า conf_cassandra_listen_address เพื่อใช้ที่อยู่ IP ใหม่
    • ตั้งค่า conf_cassandra_rpc_address เพื่อใช้ที่อยู่ IP ใหม่หรือ 0.0.0.0 (ซึ่งอนุญาตให้ Cassandra Thrift รับข้อมูลบนอินเทอร์เฟซทั้งหมด)
  3. เปิด /<inst_root>/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:dc1 information:default=ra-1
    default=dc-ra-1
    default
  4. แก้ไข /<inst_root>/apigee/customer/application/cassandra.properties เพื่อเปลี่ยนที่อยู่ IP เก่าที่ระบุไว้เป็นที่อยู่ IP ใหม่:
    /<inst_root>/apigee/customer/application/cassandra.properties

    n192.168.56.104
  5. รีสตาร์ท Cassandra ในระบบที่แก้ไขแล้ว หากระบบที่แก้ไขเป็นโหนดตั้งต้น ให้รีสตาร์ทแต่ละระบบที่ใช้โหนดเริ่มต้นที่แก้ไขแล้วด้วย
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra รีสตาร์ท
  6. เรียกใช้คำสั่ง nodetool ring ในโหนดที่แก้ไขแล้วเพื่อให้มั่นใจว่าการดำเนินการดังกล่าวเสร็จสมบูรณ์ ดูยูทิลิตีได้ที่ <inst_root>/apigee/apigee-cassandra/bin
    > nodetool -h localhost ring
  7. เรียกใช้การซ่อมแซมโหนดบนโหนดที่แก้ไขแล้ว โปรดทราบว่ากระบวนการนี้อาจใช้เวลาสักครู่ เราจึงแนะนำว่าไม่ควรดำเนินการในช่วงที่มีการรับส่งข้อมูล API สูงสุด
    > nodetool -h localhost แน่
  8. หากจำเป็น ให้ซ่อมแซม ZooKeeper (ดูด้านล่าง) จากนั้นรีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทั้งหมดโดยเริ่มต้นจากเซิร์ฟเวอร์การจัดการ

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

  1. ค้นหา UUID ของการจดทะเบียนพื้นที่เก็บข้อมูลที่ระบุที่อยู่ IP เก่าได้โดยใช้คำสั่งด้านล่าง จดพารามิเตอร์ "type" และ "UUID" ไว้
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=central" | egrep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway" | egrep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=analytics" | egrep -i '(type|internalip|uuid|region)'
  2. ลงทะเบียนที่อยู่ IP ใหม่โดยใช้คำสั่งอย่างใดอย่างหนึ่งด้านล่าง คำสั่งที่จำเป็นจะขึ้นอยู่กับประเภทของโหนดที่เปลี่ยนแปลง

    หมายเหตุ: พารามิเตอร์ REGION ด้านล่างอ้างอิงศูนย์ข้อมูลที่มีคลัสเตอร์นั้น ตัวอย่างเช่น สำหรับความพร้อมใช้งานสูง โดยทั่วไปคุณจะมีคลัสเตอร์ใน dc-1 (Dater Center 1) และคลัสเตอร์ใน dc-2 (Data Center 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 encrypted 'content-type: application/x-POST-form-Xurl
    • สำหรับ 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}&pod-contentth}"
    • สำหรับ 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-url
  3. ลบการจดทะเบียนเก่าสำหรับ UUID ของระบบที่มีการเปลี่ยนแปลงที่อยู่ IP สำหรับปัญหา UUID ต่อไปนี้
    curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

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

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

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

  1. เปิด /<inst_root>/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.101:2888:3888
    Server.2=192.168.56.102:2888:3888
    Server.3=192.168.56.10
  2. ในแต่ละโหนด ZooKeeper ให้แก้ไขไฟล์ /<inst_root>/apigee/customer/application/zookeeper.properties เพื่อตั้งค่าพร็อพเพอร์ตี้ conf_zoo_quorum เป็นที่อยู่ IP ที่ถูกต้อง หากไม่มีไฟล์ ให้สร้างขึ้นมาconf_zoo_quorum=server.1=192.168.56.101:2888:3888nserver.2=192.168.56.102:2888:3888nserver.3=192.168.56.104:2888:3888n
  3. ค้นหาผู้นำของชุด ZooKeeper โดยใช้คำสั่งต่อไปนี้ (แทนที่ <node> ด้วยที่อยู่ IP ของเครื่อง Zookeeper):
    echo srvr | nc <node> 2181

    บรรทัดโหมดในเอาต์พุตควรเป็น "ผู้นำ"
  4. รีสตาร์ท ZooKeeper อีกครั้งหลังจากอีกตัวหนึ่งขึ้นต้นด้วยผู้นำและลงท้ายด้วยโหนดที่มีการเปลี่ยนแปลงที่อยู่ IP หากมีโหนด Zookeeper มากกว่า 1 รายการเปลี่ยนที่อยู่ IP คุณอาจจำเป็นต้องรีสตาร์ทโหนดทั้งหมด
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-zookeeper รีสตาร์ท
  5. ใช้คำสั่ง echo ที่อธิบายไว้ด้านบนเพื่อยืนยันโหนด ZooKeeper แต่ละรายการ

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

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

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

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

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

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

หากต้องการเปลี่ยนที่อยู่ IP ของโหนดประเภทต่างๆ ต่อไปนี้ (Router, Message Processor, Postgres Server (ไม่ใช่ postgresql) และ Qpid Server (ไม่ใช่ 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 ExternalIP=<ip>
    curl -u $ADMIN8:$PW -u $ADMIN8

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

  • เราเตอร์: curl http://<router_IP>:8081/v1/servers/self
  • ตัวประมวลผลข้อความ: 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