جابجایی سرورهای Apigee

Edge for Private Cloud نسخه 4.17.01

اجزای Apigee از آدرس های IP برای برقراری ارتباط با یکدیگر استفاده می کنند. انتقال اجزا از یک ماشین به ماشین دیگر ممکن است باعث عدم تطابق پیکربندی شود. برای رفع عدم تطابق پیکربندی، دستورالعمل های مربوطه را در زیر دنبال کنید.

تغییر آدرس IP گره کاساندرا

برای تغییر آدرس IP یک گره کاساندرا، مراحل زیر را انجام دهید:

برای پیکربندی با یک گره کاساندرا

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
   پیش فرض=dc-1:ra-1
   
   آن اطلاعات را ذخیره کنید.
4. برای تغییر آدرس IP قدیمی مشخص شده به آدرس IP جدید، /opt/apigee/customer/application/cassandra.properties را ویرایش کنید:
   conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n
   
   اطمینان حاصل کنید که "\n" را بعد از آدرس IP وارد کرده اید، و همان تنظیمات پیش فرض را که در مرحله 3 در بالا پیدا کردید، مشخص کنید.
5. کاساندرا را مجددا راه اندازی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
6. در صورت لزوم، ZooKeeper را نیز تعمیر کنید (به زیر مراجعه کنید)، در غیر این صورت، هر مؤلفه پلتفرم Apigee را با شروع مدیریت سرور، مجدداً راه اندازی کنید.

برای پیکربندی با چندین گره کاساندرا (حلقه)

1. اگر گره در حال تغییر یک گره seed است، فایل /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 کاساندرا و تنظیمات پیش‌فرض را به شکل زیر ببینید:
   192.168.56.101=dc-1:ra-1
   192.168.56.102=dc-1:ra-1
   192.168.56.103=dc-1:ra-1
   پیش فرض=dc-1:ra-1
   
   آن اطلاعات را ذخیره کنید.
4. برای تغییر آدرس IP قدیمی مشخص شده به آدرس IP جدید، /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
   
   مطمئن شوید که "\n" را بعد از هر آدرس IP وارد کرده اید و از همان تنظیمات پیش فرضی که در مرحله 3 در بالا ثبت کرده اید استفاده کنید.
5. Cassandra را در سیستم اصلاح شده مجدداً راه اندازی کنید. اگر سیستم اصلاح شده یک گره بذری است، هر سیستمی را که از گره بذر اصلاح شده استفاده کرده است، مجددا راه اندازی کنید.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
6. دستور حلقه nodetool را روی گره اصلاح شده اجرا کنید تا مطمئن شوید که حلقه کامل است. این ابزار را می توان در opt/apigee/apigee-cassandra/bin پیدا کرد.
   > حلقه nodetool -h localhost
7. تعمیر nodetool را روی گره اصلاح شده اجرا کنید. توجه داشته باشید که این فرآیند ممکن است کمی طول بکشد، بنابراین به شدت توصیه می‌شود این کار در ساعات اوج ترافیک API انجام نشود.
   > تعمیر لوکال هاست nodetool -h
8. در صورت لزوم، ZooKeeper را تعمیر کنید (به زیر مراجعه کنید)، سپس هر مؤلفه پلتفرم Apigee را با شروع مدیریت سرور راه اندازی مجدد کنید.

ثبت نام های فروشگاه داده را به روز کنید

1. با استفاده از دستورات زیر، UUID ثبت‌های فروشگاه داده را که آدرس IP قدیمی را مشخص می‌کنند، بیابید. به پارامترهای "نوع" و "UUID" توجه داشته باشید:
   • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=central&region= DC " | egrep -i '(نوع|داخلی|uuid|منطقه)'
   • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway&region= DC " | egrep -i '(نوع|داخلی|uuid|منطقه)'
   • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=analytics&region= DC " | egrep -i '(نوع|داخلی|uuid|منطقه)'
     
     که در آن DC نام مرکز داده است. در یک نصب مرکز داده واحد، مقدار معمولاً " dc-1 " است.
2. آدرس های IP جدید را با استفاده از یکی از دستورات زیر ثبت کنید. دستور مورد نیاز به نوع گره تغییر یافته بستگی دارد.
   
   توجه : پارامتر REGION زیر به دیتاسنتری که خوشه در آن قرار دارد اشاره دارد. برای مثال، برای دسترسی بالا، معمولاً یک خوشه در dc-1 (Dater Center 1) و یک خوشه در dc-2 (مرکز داده 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 'نوع محتوا: برنامه/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-IPdatastore&Internal 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 'محتوا -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:288\n:
   
   اطمینان حاصل کنید که "\n" را بعد از هر آدرس IP وارد کرده اید و ورودی ها در هر گره به یک ترتیب هستند.
3. با استفاده از دستور زیر رهبر گروه ZooKeeper را پیدا کنید (آدرس IP ماشین Zookeeper را جایگزین <node> کنید):
   echo srvr | nc <node> 2181
   
   خط Mode در خروجی باید "لیدر" را نشان دهد.
4. یکی پس از دیگری ZooKeeper را مجدداً راه اندازی کنید که با لیدر شروع می شود و با گره ای که آدرس IP در آن تغییر کرده است خاتمه می یابد. اگر بیش از یک گره نگهبان باغ وحش آدرس های 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. در هر گره پردازشگر پیام، فایل /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 restart

تغییر آدرس IP سایر انواع گره Apigee

برای تغییر آدرس IP هر یک از این انواع گره (روتر، پردازشگر پیام، سرور 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 گره را نمی دانید، می توانید از دستور زیر برای نمایش آن استفاده کنید:

• روتر : 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