Apigee সার্ভার সরানো

আপনি যদি আপনার কম্পোনেন্ট কনফিগারেশন ফাইলগুলিতে আইপি ঠিকানাগুলিকে সিঙ্কে না রাখেন তবে উপাদানগুলিকে এক মেশিন থেকে অন্য মেশিনে স্থানান্তর করার ফলে কনফিগারেশনের অমিল হতে পারে।

এই বিভাগটি বর্ণনা করে কিভাবে কনফিগারেশনের অমিলগুলি নির্ণয় এবং ঠিক করা যায়।

আইপি ঠিকানা বনাম হোস্ট নাম

আপনার উপাদান কনফিগারেশন ফাইলগুলিতে হোস্ট নামের পরিবর্তে আপনার আইপি ঠিকানাগুলি ব্যবহার করা উচিত।

যদিও কিছু কম্পোনেন্ট কনফিগারেশন ফাইল আপনাকে আইপি ঠিকানার পরিবর্তে হোস্ট নাম ব্যবহার করার অনুমতি দেয়, হোস্ট নাম ব্যবহার করা সমস্যা সমাধানকে জটিল করতে পারে। উদাহরণস্বরূপ, হোস্টের নামগুলি DNS সার্ভার সংযোগ, লুকআপ ব্যর্থতা এবং সিঙ্ক্রোনাইজেশন সম্পর্কিত সমস্যার উত্স হতে পারে।

ফলস্বরূপ, Apigee দৃঢ়ভাবে সমস্ত উপাদান কনফিগারেশনের জন্য আইপি ঠিকানা ব্যবহার করার সুপারিশ করে। কিছু ক্ষেত্রে, যেমন ক্যাসান্দ্রার সাথে, আপনাকে অবশ্যই আইপি ঠিকানা ব্যবহার করতে হবে এবং হোস্টের নাম ব্যবহার করতে পারবেন না। ডকুমেন্টেশনের বেশিরভাগ উদাহরণ উপাদান কনফিগারেশনের জন্য আইপি ঠিকানা ব্যবহার করে।

হোস্টের নাম এবং IP ঠিকানাগুলির জন্য, Apigee সার্ভারগুলি সরানোর সময় নিম্নলিখিত পরিস্থিতিগুলির প্রভাব বিবেচনা করুন:

একটি ক্যাসান্দ্রা নোডের আইপি ঠিকানা পরিবর্তন করা হচ্ছে

একটি Cassandra নোডের IP ঠিকানা পরিবর্তন করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:

একটি একক ক্যাসান্ড্রা নোডের সাথে কনফিগারেশনের জন্য

1. পরিবর্তন করা সিস্টেমে /opt/apigee/customer/application/cassandra.properties সম্পাদনা করুন। যদি ফাইলটি বিদ্যমান না থাকে তবে এটি তৈরি করুন।
2. নিম্নলিখিত পরামিতি পরিবর্তন করুন:
   • সিস্টেমের নতুন IP ঠিকানা নির্দিষ্ট করতে conf_cassandra_seeds এবং conf_cassandra_listen_address প্যারামিটার সেট করুন।
   • নতুন IP ঠিকানা বা 0.0.0.0 ব্যবহার করতে conf_cassandra_rpc_address পরিবর্তন করুন (যা Cassandra Thrift কে সমস্ত ইন্টারফেসে শোনার অনুমতি দেয়)।
3. একটি সম্পাদকে /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties খুলুন। আপনি ফর্মে পুরানো আইপি ঠিকানা এবং ডিফল্ট সেটিং দেখতে পাবেন:

   192.168.56.101=dc-1:ra-1
   default=dc-1:ra-1

   সেই তথ্য সংরক্ষণ করুন।

4. নতুন আইপি ঠিকানায় নির্দিষ্ট করা পুরানো আইপি ঠিকানা পরিবর্তন করতে /opt/apigee/customer/application/cassandra.properties সম্পাদনা করুন:

   conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

   নিশ্চিত করুন যে আপনি IP ঠিকানার পরে "\n" সন্নিবেশ করাচ্ছেন, এবং ধাপ 3-এ আপনি উপরে যেভাবে পেয়েছেন সেই একই ডিফল্ট সেটিংস উল্লেখ করুন৷

5. ক্যাসান্দ্রা পুনরায় চালু করুন:

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

6. প্রয়োজনে ZooKeeperও মেরামত করুন (নীচে দেখুন), অন্যথায় ম্যানেজমেন্ট সার্ভার থেকে শুরু করে প্রতিটি Apigee প্ল্যাটফর্ম উপাদান পুনরায় চালু করুন।

একাধিক ক্যাসান্ড্রা নোড (রিং) সহ কনফিগারেশনের জন্য

1. পরিবর্তন করা নোডটি যদি একটি বীজ নোড হয়, তাহলে রিংয়ের প্রতিটি সিস্টেমে /opt/apigee/customer/application/cassandra.properties ফাইলটি সম্পাদনা করুন এবং পরিবর্তিত সিস্টেমের নতুন আইপি অন্তর্ভুক্ত করতে conf_cassandra_seeds প্যারামিটার পরিবর্তন করুন। cassandra.properties ফাইলটি বিদ্যমান না থাকলে, এটি তৈরি করুন।
2. পরিবর্তন করা সিস্টেমে /opt/apigee/customer/application/cassandra.properties সম্পাদনা করুন এবং নিম্নলিখিত পরামিতিগুলি পরিবর্তন করুন:
   • নতুন আইপি ঠিকানা ব্যবহার করতে conf_cassandra_listen_address সেট করুন।
   • নতুন IP ঠিকানা বা "0.0.0.0" ব্যবহার করতে conf_cassandra_rpc_address সেট করুন (যা ক্যাসান্দ্রা থ্রিফ্টকে সমস্ত ইন্টারফেসে শোনার অনুমতি দেয়)।
3. একটি সম্পাদকে /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties খুলুন। আপনি ফর্মে সমস্ত ক্যাসান্ড্রা আইপি ঠিকানা এবং ডিফল্ট সেটিং দেখতে পাবেন:

   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 সম্পাদনা করুন:

   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

   নিশ্চিত করুন যে আপনি প্রতিটি IP ঠিকানার পরে "\n" সন্নিবেশ করান, এবং ধাপ 3-এ আপনি উপরে রেকর্ড করা একই ডিফল্ট সেটিংস ব্যবহার করুন৷

5. পরিবর্তিত সিস্টেমে ক্যাসান্দ্রা পুনরায় চালু করুন। যদি পরিবর্তিত সিস্টেমটি একটি বীজ নোড হয়, তবে পরিবর্তিত বীজ নোড ব্যবহার করা প্রতিটি সিস্টেম পুনরায় চালু করুন।

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

6. রিং সম্পূর্ণ হয়েছে তা নিশ্চিত করতে পরিবর্তিত নোডে nodetool ring কমান্ডটি চালান। ইউটিলিটিটি /opt/apigee/apigee-cassandra/bin এ পাওয়া যাবে।

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

   আপনি যদি ক্যাসান্দ্রার জন্য JMX প্রমাণীকরণ সক্ষম করেন তবেই আপনাকে আপনার ব্যবহারকারীর নাম এবং পাসওয়ার্ড পাস করতে হবে।

7. পরিবর্তিত নোডে nodetool repair চালান। মনে রাখবেন যে এই প্রক্রিয়াটিতে কিছু সময় লাগতে পারে, তাই এটি অত্যন্ত বাঞ্ছনীয় যে পিক API ট্র্যাফিক সময়ের সময় এটি না করা।

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

8. যদি প্রয়োজন হয়, ZooKeeper মেরামত করুন (নীচে দেখুন), তারপর ম্যানেজমেন্ট সার্ভার থেকে শুরু করে প্রতিটি Apigee প্ল্যাটফর্ম উপাদান পুনরায় চালু করুন।

ডেটাস্টোর নিবন্ধন আপডেট করুন

1. নীচের কমান্ডগুলি ব্যবহার করে পুরানো IP ঠিকানা নির্দিষ্ট করে ডেটাস্টোর নিবন্ধনের UUID খুঁজুন। "টাইপ" এবং "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. নীচের কমান্ডগুলির একটি ব্যবহার করে নতুন আইপি ঠিকানাগুলি নিবন্ধন করুন৷ প্রয়োজনীয় কমান্ডটি পরিবর্তিত নোডের ধরণের উপর নির্ভর করবে।
   • 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

   • টাইপ="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. যে সিস্টেমে IP ঠিকানা পরিবর্তন করা হয়েছিল তার UUID-এর জন্য পুরানো নিবন্ধগুলি মুছুন। এই প্রতিটি UUID সমস্যাগুলির জন্য:

   curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE

একটি ZooKeeper নোডের IP ঠিকানা পরিবর্তন করা হচ্ছে

একটি ZooKeeper নোডের IP ঠিকানা পরিবর্তন করতে নীচের পদক্ষেপগুলি অনুসরণ করুন:

IP ঠিকানা পরিবর্তন করুন এবং ZooKeeper ensemble পুনরায় চালু করুন (শুধুমাত্র মাল্টি-নোড ensemble কনফিগারেশনের জন্য)

1. একটি সম্পাদকে /opt/apigee/apigee-zookeeper/conf/zoo.cfg খুলুন। আপনি ফর্মে সমস্ত ZooKeeper IP ঠিকানা এবং ডিফল্ট সেটিং দেখতে পাবেন:

   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 সম্পত্তি সঠিক আইপি ঠিকানায় সেট করতে। যদি ফাইলটি বিদ্যমান না থাকে তবে এটি তৈরি করুন।

   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" সন্নিবেশ করান এবং প্রতিটি নোডে এন্ট্রি একই ক্রমে রয়েছে।

3. নিম্নলিখিত কমান্ডটি ব্যবহার করে ZooKeeper ensemble এর নেতা খুঁজুন (Zookeeper মেশিনের IP ঠিকানা দিয়ে node প্রতিস্থাপন করুন):

   echo srvr | nc node 2181

   আউটপুটে মোড লাইনটি "লিডার" বলতে হবে।

4. একটি ZooKeeper পুনরায় চালু করুন লিডার দিয়ে শুরু করে এবং যে নোডটিতে IP ঠিকানা পরিবর্তন করা হয়েছিল তার সাথে শেষ করুন। যদি একাধিক চিড়িয়াখানা নোড আইপি ঠিকানা পরিবর্তন করে তবে সমস্ত নোড পুনরায় চালু করার প্রয়োজন হতে পারে।

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart

5. প্রতিটি ZooKeeper নোড যাচাই করতে উপরে বর্ণিত echo কমান্ডটি ব্যবহার করুন।

পরিবর্তিত কনফিগারেশনের Apigee নোডগুলিকে অবহিত করুন

1. প্রতিটি রাউটার নোডে, /opt/apigee/customer/application/router.properties ফাইলটি নিম্নরূপ সম্পাদনা করুন। যদি ফাইলটি বিদ্যমান না থাকে তবে এটি তৈরি করুন।
   • নতুন আইপি ঠিকানা অন্তর্ভুক্ত করতে conf_zookeeper_connection.string প্যারামিটার পরিবর্তন করুন
   • নতুন আইপি ঠিকানা অন্তর্ভুক্ত করতে conf_zookeeper_zk1.host প্যারামিটার পরিবর্তন করুন
2. প্রতিটি মেসেজ প্রসেসর নোডে, ফাইল /opt/apigee/customer/application/message-processor.properties সম্পাদনা করুন। যদি ফাইলটি বিদ্যমান না থাকে তবে এটি তৈরি করুন।
   • নতুন আইপি ঠিকানা অন্তর্ভুক্ত করতে conf_zookeeper_connection.string প্যারামিটার পরিবর্তন করুন
   • নতুন আইপি ঠিকানা অন্তর্ভুক্ত করতে conf_zookeeper_zk1.host প্যারামিটার পরিবর্তন করুন
3. ম্যানেজমেন্ট সার্ভার নোডে, নিম্নরূপ ফাইল /opt/apigee/customer/application/management-server.properties সম্পাদনা করুন। যদি ফাইলটি বিদ্যমান না থাকে তবে এটি তৈরি করুন।
   • নতুন আইপি ঠিকানা অন্তর্ভুক্ত করতে conf_zookeeper_connection.string প্যারামিটার পরিবর্তন করুন
   • নতুন আইপি ঠিকানা অন্তর্ভুক্ত করতে conf_zookeeper_zk1.host প্যারামিটার পরিবর্তন করুন
4. প্রতিটি নোডে নিম্নলিখিত কমান্ডটি চালিয়ে সমস্ত Apigee প্ল্যাটফর্ম উপাদান পুনরায় চালু করুন:

   /opt/apigee/apigee-service/bin/apigee-all restart

একটি LDAP সার্ভারের IP ঠিকানা পরিবর্তন করা হচ্ছে (OpenLDAP)

একটি OpenLDAP নোডের IP ঠিকানা পরিবর্তন করতে, নিম্নলিখিতগুলি করুন:

1. ম্যানেজমেন্ট সার্ভার নোডে, /opt/apigee/customer/application/management-server.properties ফাইলটি সম্পাদনা করুন। যদি ফাইলটি বিদ্যমান না থাকে তবে এটি তৈরি করুন।
2. management-server.properties ফাইলে, নতুন IP ঠিকানায় conf_security_ldap.server.host প্যারামিটার সেট করুন।
3. ম্যানেজমেন্ট সার্ভার পুনরায় চালু করুন:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

অন্যান্য Apigee নোড প্রকারের IP ঠিকানা পরিবর্তন করা হচ্ছে

এই নোডের যে কোনো প্রকারের আইপি ঠিকানা পরিবর্তন করতে (রাউটার, মেসেজ প্রসেসর, পোস্টগ্রেস সার্ভার (পোস্টগ্রেসকিউএল নয়) এবং কিউপিড সার্ভার (কিউপিডিডি নয়):

1. নতুন অভ্যন্তরীণ এবং বাহ্যিক আইপি ঠিকানা নিবন্ধন করতে নিম্নলিখিত curl কমান্ডটি ব্যবহার করুন:

   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 পান দেখুন।