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

Edge สำหรับ 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 เริ่มต้นไปหลังจากการตั้งค่า IP เดียวกัน\n

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

สำหรับการกำหนดค่าที่มีโหนด 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:dc1 information:default=ra-1
    default=dc-ra-1
    default
  4. แก้ไข /opt/apigee/customer/application/cassandra.properties เพื่อเปลี่ยนที่อยู่ IP เดิมที่ระบุเป็นที่อยู่ IP ใหม่
    /opt/apigee/customer/application/cassandra.properties

  5. รีสตาร์ท Cassandra ในระบบที่แก้ไขแล้ว หากระบบที่แก้ไขเป็นโหนดตั้งต้น ให้รีสตาร์ทแต่ละระบบที่ใช้โหนดเริ่มต้นที่แก้ไขแล้วด้วย
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandraในส่วนรีสตาร์ท
  6. เรียกใช้คำสั่ง nodetool ring ในโหนดที่แก้ไขแล้วเพื่อให้มั่นใจว่าการดำเนินการดังกล่าวเสร็จสมบูรณ์ ดูยูทิลิตีได้ที่ opt/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&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 (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. เปิด /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.101:2888:3888
    Server.2=192.168.56.102:2888:3888
    Server.3=192.168.56.10
  2. ในแต่ละโหนด ZooKeeper ให้แก้ไขไฟล์ /opt/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 คุณอาจจำเป็นต้องรีสตาร์ทโหนดทั้งหมด
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeperเกี่ยวกับการรีสตาร์ท
  5. ใช้คำสั่ง echo ที่อธิบายไว้ด้านบนเพื่อยืนยันโหนด ZooKeeper แต่ละรายการ

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

  1. ที่โหนดเราเตอร์แต่ละโหนด ให้แก้ไขไฟล์ /opt/apigee/customer/application/router.properties ดังนี้ หากไม่มีไฟล์ ให้สร้างขึ้นมา
    • เปลี่ยนพารามิเตอร์ conf_zookeeper_connection.string เพื่อรวมที่อยู่ IP ใหม่
    • เปลี่ยนพารามิเตอร์ conf_zookeeper_zk1.host ให้รวมที่อยู่ IP ใหม่
  2. ในโหนดตัวประมวลผลข้อมูลข้อความทุกโหนด ให้แก้ไขไฟล์ /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. ในโหนดเซิร์ฟเวอร์การจัดการ ให้แก้ไขไฟล์ /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บ้างไหม

การเปลี่ยนที่อยู่ 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 $ADMINX

หากไม่ทราบ 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