การย้ายคอมโพเนนต์จากเครื่องหนึ่งไปยังอีกเครื่องหนึ่งอาจทำให้เกิดการกำหนดค่าไม่ตรงกัน หากคุณไม่ซิงค์ที่อยู่ IP ในไฟล์การกำหนดค่าคอมโพเนนต์
ส่วนนี้จะอธิบายวิธีการวินิจฉัยและแก้ไขการกำหนดค่าที่ไม่ตรงกัน
ที่อยู่ IP กับชื่อโฮสต์
คุณควรใช้ที่อยู่ IP แทนชื่อโฮสต์ในไฟล์การกำหนดค่าคอมโพเนนต์
แม้ว่าไฟล์การกำหนดค่าคอมโพเนนต์บางไฟล์จะอนุญาตให้คุณใช้ชื่อโฮสต์แทนที่อยู่ IP แต่การใช้ชื่อโฮสต์อาจทําให้การแก้ปัญหามีความซับซ้อนได้ เช่น ชื่อโฮสต์อาจเป็นต้นตอของปัญหาที่เกี่ยวข้องกับการเชื่อมต่อเซิร์ฟเวอร์ DNS, การค้นหาล้มเหลว และการซิงค์ข้อมูล
ด้วยเหตุนี้ Apigee จึงขอแนะนำให้ใช้ที่อยู่ IP สำหรับการกำหนดค่าคอมโพเนนต์ทั้งหมด ในบางกรณี เช่น เมื่อใช้ Cassandra คุณจะต้องใช้ที่อยู่ IP และจะใช้ชื่อโฮสต์ไม่ได้ ตัวอย่างส่วนใหญ่ในเอกสารใช้ที่อยู่ IP สำหรับการกำหนดค่าคอมโพเนนต์
สำหรับชื่อโฮสต์และที่อยู่ IP ให้พิจารณาผลที่ตามมาจากสถานการณ์ต่อไปนี้เมื่อย้ายเซิร์ฟเวอร์ Apigee
สถานการณ์ | ผลกระทบต่อเซิร์ฟเวอร์ที่ย้าย |
---|---|
การเปลี่ยนแปลงที่อยู่ IP | อัปเดตไฟล์ที่เกี่ยวข้องทั้งหมดที่อ้างอิงที่อยู่ IP เดิม |
เปลี่ยนชื่อโฮสต์โดยไม่เปลี่ยนที่อยู่ IP | ไม่ได้ส่งผลอะไร |
เปลี่ยนชื่อโฮสต์โดยมีการเปลี่ยนแปลงที่อยู่ IP | เหมือนกับการเปลี่ยนแปลงที่อยู่ IP |
การเปลี่ยนที่อยู่ IP ของโหนด Cassandra
หากต้องการเปลี่ยนที่อยู่ IP ของโหนด Cassandra ให้ทำตามขั้นตอนต่อไปนี้
สำหรับการกำหนดค่าที่มีโหนด Cassandra เดี่ยว
- แก้ไข
/opt/apigee/customer/application/cassandra.properties
ในระบบที่กำลังแก้ไข หากไม่มีไฟล์ ให้สร้างขึ้นมา - เปลี่ยนพารามิเตอร์ต่อไปนี้
- ตั้งค่าพารามิเตอร์
conf_cassandra_seeds
และconf_cassandra_listen_address
เพื่อระบุที่อยู่ IP ใหม่ของระบบ - เปลี่ยน
conf_cassandra_rpc_address
เพื่อใช้ที่อยู่ IP ใหม่หรือ 0.0.0.0 (ซึ่งอนุญาตให้ Cassandra Thrift รับฟังได้บนอินเทอร์เฟซทั้งหมด)
- ตั้งค่าพารามิเตอร์
- เปิด
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
ในเครื่องมือแก้ไข คุณควรเห็นที่อยู่ IP เดิมและการตั้งค่าเริ่มต้นในแบบฟอร์ม:192.168.56.101=dc-1:ra-1 default=dc-1:ra-1
บันทึกข้อมูลนั้น
- แก้ไข
/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
- รีสตาร์ท Cassandra โดยทําดังนี้
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- หากจำเป็นให้ซ่อมแซม ZooKeeper (ดูด้านล่าง) ให้รีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทั้งหมดโดยเริ่มต้นจากเซิร์ฟเวอร์การจัดการ
สำหรับการกำหนดค่าที่มีโหนด Cassandra หลายรายการ (วงแหวน)
- หากโหนดที่เปลี่ยนแปลงเป็นโหนดตั้งต้น ให้แก้ไขไฟล์
/opt/apigee/customer/application/cassandra.properties
ในแต่ละระบบในริงและเปลี่ยนพารามิเตอร์conf_cassandra_seeds
ให้รวม IP ใหม่ของระบบที่แก้ไข หากไม่มีไฟล์ cassandra.properties ให้สร้างขึ้นมา - แก้ไข
/opt/apigee/customer/application/cassandra.properties
ในระบบที่กําลังแก้ไขและเปลี่ยนพารามิเตอร์ต่อไปนี้- ตั้งค่า
conf_cassandra_listen_address
เพื่อใช้ที่อยู่ IP ใหม่ - ตั้งค่า
conf_cassandra_rpc_address
เพื่อใช้ที่อยู่ IP ใหม่หรือ "0.0.0.0" (ซึ่งอนุญาตให้ Cassandra Thrift ฟังอินเทอร์เฟซทั้งหมด)
- ตั้งค่า
- เปิด
/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
บันทึกข้อมูลนั้น
- แก้ไข
/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
- รีสตาร์ท Cassandra ในระบบที่แก้ไขแล้ว หากระบบที่แก้ไขเป็นโหนดตั้งต้น ให้รีสตาร์ทแต่ละระบบที่ใช้โหนดเริ่มต้นที่แก้ไขแล้วด้วย
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- เรียกใช้คำสั่ง
nodetool ring
ในโหนดที่แก้ไขเพื่อให้การสร้างวงแหวนเสร็จสมบูรณ์ ดูยูทิลิตีได้ที่/opt/apigee/apigee-cassandra/bin
nodetool [-u username -pw password] -h localhost ring
คุณจะต้องส่งชื่อผู้ใช้และรหัสผ่านต่อเมื่อเปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra เท่านั้น
- เรียกใช้
nodetool repair
ในโหนดที่แก้ไขแล้ว โปรดทราบว่ากระบวนการนี้อาจใช้เวลาสักครู่ เราจึงแนะนำว่าไม่ควรดำเนินการในช่วงที่มีการรับส่งข้อมูล API สูงสุดnodetool [-u username -pw password] -h localhost repair -pr
- หากจำเป็น ให้ซ่อมแซม ZooKeeper (ดูด้านล่าง) จากนั้นรีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทั้งหมดโดยเริ่มจากเซิร์ฟเวอร์การจัดการ
อัปเดตการลงทะเบียนพื้นที่เก็บข้อมูล
- ค้นหา UUID ของการจดทะเบียนพื้นที่เก็บข้อมูลที่ระบุที่อยู่ IP เก่าได้โดยใช้คำสั่งด้านล่าง จดพารามิเตอร์ "type" และ "UUID" ไว้
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central®ion=DC" | egrep -i '[type|internalip|uuid|region]'
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway®ion=DC" | egrep -i '[type|internalip|uuid|region]'
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics®ion=DC" | egrep -i '[type|internalip|uuid|region]'
โดย DC คือชื่อศูนย์ข้อมูล ในการติดตั้งศูนย์ข้อมูลเดียว ค่าโดยทั่วไปจะเป็น "dc-1"
-
- ลงทะเบียนที่อยู่ IP ใหม่โดยใช้คำสั่งอย่างใดอย่างหนึ่งด้านล่าง คำสั่งที่ต้องใช้จะขึ้นอยู่กับประเภทของโหนดที่เปลี่ยนแปลง
- สำหรับ type="application-datastore":
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \ "Type=application-datastore&Type=audit-datastore&InternalIP=NEWIP®ion=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®ion=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®ion=REGION&pod=analytics" \ -H 'content-type: application/x-www-form-urlencoded' -X POST
- สำหรับ type="application-datastore":
- ลบการจดทะเบียนเก่าสำหรับ UUID ของระบบที่มีการเปลี่ยนแปลงที่อยู่ IP สำหรับแต่ละปัญหา UUID ต่อไปนี้
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE
การเปลี่ยนที่อยู่ IP ของโหนด ZooKeeper
ทำตามขั้นตอนด้านล่างเพื่อเปลี่ยนที่อยู่ IP ของโหนด ZooKeeper
เปลี่ยนที่อยู่ IP และรีสตาร์ทชุด ZooKeeper (สำหรับการกำหนดค่าชุดโหนดหลายโหนดเท่านั้น)
- เปิด
/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
บันทึกข้อมูลนั้น
- ในแต่ละโหนด 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 แต่ละรายการ และรายการที่อยู่ในลำดับเดียวกันในทุกโหนด
- ค้นหาผู้นำของชุด ZooKeeper โดยใช้คำสั่งต่อไปนี้ (แทนที่ node ด้วยที่อยู่ IP ของเครื่อง Zookeeper)
echo srvr | nc node 2181
บรรทัดโหมดในเอาต์พุตควรเป็น "ผู้นำ"
- รีสตาร์ท ZooKeeper อีกครั้งหลังจากอีกตัวหนึ่งขึ้นต้นด้วยผู้นำและลงท้ายด้วยโหนดที่มีการเปลี่ยนแปลงที่อยู่ IP หากมีโหนด Zookeeper มากกว่า 1 รายการเปลี่ยนที่อยู่ IP คุณอาจจำเป็นต้องรีสตาร์ทโหนดทั้งหมด
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
- ใช้คำสั่ง
echo
ที่อธิบายไว้ข้างต้นเพื่อยืนยันโหนด ZooKeeper แต่ละรายการ
แจ้งโหนด Apigee ของการกำหนดค่าที่เปลี่ยนแปลง
- ที่โหนดเราเตอร์แต่ละโหนด ให้แก้ไขไฟล์
/opt/apigee/customer/application/router.properties
ดังนี้ หากไม่มีไฟล์ ให้สร้างขึ้นมา- เปลี่ยนพารามิเตอร์
conf_zookeeper_connection.string
ให้รวมที่อยู่ IP ใหม่ - เปลี่ยนพารามิเตอร์
conf_zookeeper_zk1.host
ให้รวมที่อยู่ IP ใหม่
- เปลี่ยนพารามิเตอร์
- ในโหนดตัวประมวลผลข้อความทุกโหนด ให้แก้ไขไฟล์
/opt/apigee/customer/application/message-processor.properties
ดังนี้ หากไม่มีไฟล์ ให้สร้างขึ้นมา- เปลี่ยนพารามิเตอร์
conf_zookeeper_connection.string
ให้รวมที่อยู่ IP ใหม่ - เปลี่ยนพารามิเตอร์
conf_zookeeper_zk1.host
ให้รวมที่อยู่ IP ใหม่
- เปลี่ยนพารามิเตอร์
- ในโหนดของเซิร์ฟเวอร์การจัดการ ให้แก้ไขไฟล์
/opt/apigee/customer/application/management-server.properties
ดังนี้ หากไม่มีไฟล์ ให้สร้างขึ้นมา- เปลี่ยนพารามิเตอร์
conf_zookeeper_connection.string
ให้รวมที่อยู่ IP ใหม่ - เปลี่ยนพารามิเตอร์
conf_zookeeper_zk1.host
ให้รวมที่อยู่ IP ใหม่
- เปลี่ยนพารามิเตอร์
- รีสตาร์ทคอมโพเนนต์แพลตฟอร์ม Apigee ทั้งหมดโดยเรียกใช้คำสั่งต่อไปนี้ในแต่ละโหนด
/opt/apigee/apigee-service/bin/apigee-all restart
การเปลี่ยนที่อยู่ IP ของเซิร์ฟเวอร์ LDAP (OpenLDAP)
หากต้องการเปลี่ยนที่อยู่ IP ของโหนด OpenLDAP ให้ทำดังนี้
- แก้ไขไฟล์
/opt/apigee/customer/application/management-server.properties
ในโหนดเซิร์ฟเวอร์การจัดการ หากไม่มีไฟล์ ให้สร้างขึ้นมา - ในไฟล์
management-server.properties
ให้ตั้งค่าพารามิเตอร์conf_security_ldap.server.host
เป็นที่อยู่ IP ใหม่ - รีสตาร์ทเซิร์ฟเวอร์การจัดการโดยทำดังนี้
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
การเปลี่ยนที่อยู่ IP ของโหนด Apigee ประเภทอื่นๆ
หากต้องการเปลี่ยนที่อยู่ IP ของโหนดประเภทต่างๆ ต่อไปนี้ (Router, Message Processor, Postgres Server (ไม่ใช่ postgresql) และ Qpid Server (ไม่ใช่ qpidd) ให้ทำดังนี้
- ใช้คำสั่ง
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