از کار انداختن مرکز داده

گاهی اوقات ممکن است لازم باشد یک مرکز داده را از کار بیندازید. به عنوان مثال، اگر سیستم عامل خود را ارتقا می دهید ، باید سیستم عامل جدید را در یک مرکز داده جدید نصب کنید و سپس مرکز داده قدیمی را از کار بیندازید. بخش‌های زیر نمونه‌ای از از کار انداختن یک مرکز داده را ارائه می‌کنند که در آن دو مرکز داده، dc-1 و dc-2، در یک نصب خوشه‌ای 12 گره وجود دارد:

• dc-1 مرکز داده ای است که باید از رده خارج شود.
• dc-2 یک مرکز داده ثانویه است که در روند از کار انداختن استفاده می شود.

اگر سیستم عامل خود را ارتقا می دهید، dc-2 می تواند مرکز داده ای باشد که نسخه جدید سیستم عامل (OS) را در آن نصب کرده اید. با این حال، نصب یک سیستم عامل جدید برای از کار انداختن مرکز داده لازم نیست.

ملاحظات قبل از از کار انداختن یک مرکز داده

هنگام از کار انداختن یک مرکز داده، ملاحظات زیر را در نظر داشته باشید:

• تمام ترافیک مدیریت و زمان اجرا را به مرکز داده در حال از کار انداختن مسدود کنید و آنها را به مراکز داده دیگر هدایت کنید.
• پس از از کار انداختن مرکز داده، در خوشه Apigee خود ظرفیت کمتری خواهید داشت. برای جبران آن، افزایش ظرفیت در مراکز داده باقیمانده یا اضافه کردن مراکز داده پس از از کار انداختن را در نظر بگیرید.
• در طول فرآیند از کار انداختن، بسته به اینکه کدام مؤلفه های تجزیه و تحلیل در مرکز داده در حال از کار افتادن نصب شده باشند، احتمال از دست رفتن داده های تحلیلی وجود دارد. می توانید جزئیات بیشتری را در افزودن یا حذف گره های Qpid بیابید.
• قبل از اینکه یک مرکز داده را از کار بیندازید، باید بدانید که چگونه همه مؤلفه ها در همه مراکز داده، به ویژه سرورهای OpenLDAP، ZooKeeper، Cassandra و Postgres پیکربندی شده اند. همچنین باید از تمام اجزا و تنظیمات آنها نسخه پشتیبان تهیه کنید.

قبل از شروع

• مدیریت سرور: تمام مراحل از کار افتادن به شدت به سرور مدیریت وابسته است. اگر فقط یک سرور مدیریت در دسترس دارید، توصیه می کنیم قبل از از کار انداختن سرور مدیریت در dc-1، یک مؤلفه مدیریت سرور جدید را در مرکز داده ای غیر از dc-1 نصب کنید و مطمئن شوید که یکی از سرورهای مدیریت همیشه در دسترس است. .
• روتر: قبل از از کار انداختن روتر، دسترسی روترها را با مسدود کردن پورت 15999 غیرفعال کنید. مطمئن شوید که هیچ ترافیکی در زمان اجرا به سمت روترهایی که از کار افتاده اند هدایت نمی شود.

• Cassandra و ZooKeeper: بخش های زیر نحوه از کار انداختن dc-1 را در راه اندازی دو مرکز داده توضیح می دهد. اگر بیش از دو مرکز داده دارید، مطمئن شوید که تمام ارجاعات به گره در حال از کار انداختن (در این مورد dc-1) را از تمام فایل‌های پیکربندی بی‌صدا در تمام مراکز داده باقیمانده حذف کنید. برای گره‌های Cassandra که قرار است از رده خارج شوند، آن میزبان‌ها را از CASS_HOSTS حذف کنید. گره های کاساندرا باقی مانده باید در ترتیب اولیه CASS_HOSTS باقی بمانند.

• Postgres: اگر Master Postgres را از کار انداختید، مطمئن شوید که هر یک از گره های آماده به کار موجود را به عنوان یک Master Postgres جدید تبلیغ کنید. در حالی که سرور QPID یک بافر را در صف نگه می دارد، اگر Postgres Master برای مدت طولانی تری در دسترس نباشد، خطر از دست دادن داده های تجزیه و تحلیل را دارید.

پیش نیازها

• قبل از از کار انداختن هر کامپوننت، توصیه می کنیم که یک نسخه پشتیبان کامل از تمام گره ها انجام دهید. از رویه نسخه فعلی Edge برای انجام پشتیبان استفاده کنید. برای اطلاعات بیشتر در مورد پشتیبان‌گیری، به پشتیبان‌گیری و بازیابی مراجعه کنید.

  توجه: اگر چندین گره Cassandra یا ZooKeeper دارید، هر بار از آنها نسخه پشتیبان تهیه کنید، زیرا فرآیند پشتیبان گیری به طور موقت ZooKeeper را خاموش می کند.

• با استفاده از دستور زیر، مطمئن شوید که Edge قبل از از کار افتادن فعال است:

  /opt/apigee/apigee-service/bin/apigee-all status

• اطمینان حاصل کنید که در حال حاضر هیچ ترافیکی در زمان اجرا به مرکز داده ای که در حال از کار انداختن آن هستید نمی رسد.

ترتیب قطعات از کار انداختن

اگر Edge را برای Private Cloud روی چندین گره نصب می‌کنید، باید اجزای Edge را در آن گره‌ها به ترتیب زیر از کار بیندازید:

1. Edge UI (edge-ui)
2. سرور مدیریت (Edge-management-server)
3. OpenLDAP (apigee-openldap)
4. روتر (Edge-Router)
5. پردازشگر پیام (پردازنده پیام لبه)
6. سرور Qpid و Qpidd (سرور edge-qpid و apigee-qpidd)
7. پایگاه داده Postgres و PostgreSQL (edge-postgres-server و apigee-postgresql)
8. ZooKeeper (apigee-zookeeper)
9. کاساندرا (apigee-cassandra)

بخش های زیر نحوه از کار انداختن هر جزء را توضیح می دهد.

رابط کاربری لبه

برای توقف و حذف کامپوننت Edge UI dc-1، دستورات زیر را وارد کنید:

/opt/apigee/apigee-service/bin/apigee-service edge-ui stop

/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

سرور مدیریت

برای از کار انداختن سرور مدیریت در dc-1، مراحل زیر را انجام دهید:

1. سرور مدیریت را در dc-1 متوقف کنید:

   apigee-service edge-management-server stop

2. UUID سرور مدیریت ثبت شده در dc-1 را پیدا کنید:

   curl -u <AdminEmailID>:'<AdminPassword>' \
   -X GET “http://{MS_IP}:8080/v1/servers?pod=central&region=dc-1&type=management-server”

3. نوع سرور لغو ثبت:

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
   -d "type=management-server&region=dc-1&pod=central&uuid=UUID&action=remove"

4. سرور را حذف کنید. توجه: اگر اجزای دیگری نیز روی این سرور نصب شده اند، قبل از حذف UUID ابتدا همه آنها را از ثبت خارج کنید.

   curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/{UUID}

5. مولفه مدیریت سرور را در dc-1 حذف نصب کنید:

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

LDAP را باز کنید

این بخش نحوه از کار انداختن OpenLDAP در dc-1 را توضیح می دهد.

توجه: اگر بیش از دو مرکز داده دارید، تنظیمات با بیش از دو مرکز داده را در زیر ببینید.

برای از کار انداختن OpenLDAP در dc-1، مراحل زیر را انجام دهید:

1. با دنبال کردن مراحل در نحوه تهیه نسخه پشتیبان از گره OpenLDAP dc-1 نسخه پشتیبان تهیه کنید.

2. با اجرای مراحل زیر در هر دو مرکز داده، تکثیر داده بین دو مرکز داده dc-1 و dc-2 را قطع کنید.

   1. وضعیت فعلی را بررسی کنید:

      ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {credentials} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

      خروجی باید مشابه موارد زیر باشد:

      olcSyncrepl: {0}rid=001 provider=ldap://{HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={credentials} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1

   2. یک فایل break_repl.ldif حاوی دستورات زیر ایجاد کنید:

      dn: olcDatabase={2}bdb,cn=config
      changetype: modify
      delete: olcSyncRepl
      
      dn: olcDatabase={2}bdb,cn=config
      changetype: modify
      delete: olcMirrorMode

   3. دستور ldapmodify را اجرا کنید:

      ldapmodify -x -w {credentials} -D "cn=admin,cn=config" -H "ldap://{HOST}:{PORT}/" -f path/to/file/break_repl.ldif

      خروجی باید مشابه موارد زیر باشد:

      modifying entry "olcDatabase={2}bdb,cn=config"
      modifying entry "olcDatabase={2}bdb,cn=config"

3. با ایجاد یک ورودی در LDAP dc-2 و اطمینان از اینکه در LDAP dc-1 نمایش داده نمی شود، می توانید تأیید کنید که dc-2 دیگر به dc-1 تکرار نمی شود.

   به صورت اختیاری، می توانید مراحل زیر را دنبال کنید، که یک کاربر فقط خواندنی در گره OpenLDAP dc-2 ایجاد می کند و سپس بررسی می کند که آیا کاربر تکرار شده است یا خیر. کاربر متعاقبا حذف می شود.

   1. یک فایل readonly-user.ldif در dc-2 با محتویات زیر ایجاد کنید:

      dn: uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com
      objectClass: organizationalPerson
      objectClass: person
      objectClass: inetOrgPerson
      objectClass: top
      cn: readonly-user
      sn: readonly-user
      userPassword: {testPassword}

   2. اضافه کردن کاربر با دستور 'ldapadd' در dc-2:

      ldapadd -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" -f path/to/file/readonly-user.ldif

      خروجی مشابه موارد زیر خواهد بود:

      adding new entry "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"

   3. کاربر را در dc-1 جستجو کنید تا مطمئن شوید که کاربر تکرار نشده است. اگر کاربر در dc-1 حضور نداشته باشد، مطمئن خواهید بود که هر دو LDAP دیگر تکرار نمی شوند:

      ldapsearch -H ldap://{HOST}:{PORT} -x -w {credentials} -D "cn=manager,dc=apigee,dc=com" -b uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com -LLL

      خروجی باید مشابه موارد زیر باشد:

      No such object (32)
      Matched DN: ou=users,ou=global,dc=apigee,dc=com

   4. کاربر فقط خواندنی را که قبلاً اضافه کرده اید حذف کنید:

      ldapdelete -v -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"

4. توقف OpenLDAP در dc-1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

5. کامپوننت OpenLDAP را در dc-1 حذف نصب کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap uninstall

روتر

این بخش نحوه از کار انداختن روتر را توضیح می دهد. برای جزئیات بیشتر در مورد حذف روتر به حذف سرور مراجعه کنید.

مراحل زیر روتر را از dc-1 خارج می کند. اگر چندین گره روتر در dc-1 پیکربندی شده است، مراحل را در تمام گره های روتر یک به یک انجام دهید.

توجه: در اینجا فرض بر این است که پورت بررسی سلامت روتر 15999 در بار متعادل کننده شما پیکربندی شده است و مسدود کردن پورت 15999 روتر را غیرقابل دسترسی می کند. ممکن است برای مسدود کردن پورت به دسترسی روت نیاز داشته باشید.

برای از کار انداختن روتر، مراحل زیر را انجام دهید:

1. با مسدود کردن پورت 15999، پورت بررسی سلامت، دسترسی روترها را غیرفعال کنید. اطمینان حاصل کنید که ترافیک زمان اجرا در این مرکز داده مسدود شده است:

   iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT

2. بررسی کنید که روتر در دسترس است:

   curl -vvv -X GET http://{ROUTER_IP}:15999/v1/servers/self/reachable

   خروجی باید مشابه موارد زیر باشد:

   About to connect() to 10.126.0.160 port 15999 (#0)
   Trying 10.126.0.160...
   Connection refused
   Failed connect to 10.126.0.160:15999; Connection refused
   Closing connection 0
   curl: (7) Failed connect to 10.126.0.160:15999; Connection refused

3. همانطور که در Get UUID ها توضیح داده شد، UUID روتر را دریافت کنید.
4. روتر را متوقف کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

5. با دستور زیر gateway pod های موجود در سازمان را فهرست کنید:

   curl -u  <AdminEmailID>:<AdminPassword> -X GET "http://{MS_IP}:8080/v1/organizations/{ORG}/pods"

   درباره Pods را ببینید.

6. نوع سرور را لغو ثبت کنید:

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
   -d "type=router&amp;region=dc-1&amp;pod=gateway-1&amp;uuid=UUID&amp;action=remove"

7. سرور را حذف کنید:

   curl -u <AdminEmailID>:'<AdminPassword>’ -X DELETE http://{MS_IP}:8080/v1/servers/UUID

8. حذف نصب edge-router :

   /opt/apigee/apigee-service/bin/apigee-service edge-router uninstall

   به حذف سرور مراجعه کنید.
9. برای فعال کردن پورت مسدود شده 15999، قوانین iptables را فلاش کنید:

   iptables -F

پردازشگر پیام

این بخش نحوه از کار انداختن پردازشگر پیام از dc-1 را شرح می دهد. برای جزئیات بیشتر در مورد حذف پردازشگر پیام، به حذف سرور مراجعه کنید.

از آنجایی که فرض می کنیم dc-1 یک نصب خوشه ای 12 گره ای دارد، دو گره پردازشگر پیام در dc-1 پیکربندی شده اند. دستورات زیر را در هر دو گره انجام دهید.

1. UUID های پردازشگرهای پیام را همانطور که در Get UUID توضیح داده شده است، دریافت کنید.
2. متوقف کردن پردازشگر پیام:

   apigee-service edge-message-processor stop

3. نوع سرور را لغو ثبت کنید:

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers  \
   -d "type=message-processor&amp;region=dc-1&amp;pod=gateway-1&amp;uuid=UUID&amp;action=remove"/pre>

4. Disassociate an environment from the Message Processor.

   Note: You need to remove the bindings on each org/env that associates the Message Processor UUID.

   curl -H "Content-Type:application/x-www-form-urlencoded" -u <AdminEmailID>:''  \
   -X POST http://{MS_IP}:8080/v1/organizations/{ORG}/environments/{ENV}/servers \
   -d "action=remove&uuid=UUID"

5. نوع سرور را لغو ثبت کنید:

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=message-processor&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"

6. پردازشگر پیام را حذف کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor uninstall

7. حذف ثبت سرور:

   curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/UUID

سرور Qpid و Qpidd

این بخش نحوه از کار انداختن سرور Qpid ( edge-qpid-server ) و Qpidd ( apigee-qpidd ) را توضیح می دهد. دو گره Qpid در dc-1 پیکربندی شده است، بنابراین باید مراحل زیر را برای هر دو گره انجام دهید:

1. همانطور که در Get UUID توضیح داده شد، UUID را برای Qpidd دریافت کنید.
2. توقف edge-qpid-server و apigee-qpidd :

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

3. لیستی از Analytics و گروه های مصرف کننده را دریافت کنید:

   curl -u <AdminEmailID>:'<AdminPassword>' -X GET http://{MS_IP}:8080/v1/analytics/groups/ax

4. Qpid را از گروه مصرف کننده حذف کنید:

   curl -u <AdminEmailID>:'<AdminPassword>' -H "Content-Type: application/json"  -X DELETE \ "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/consumer-groups/{consumer_group}/consumers/{QPID_UUID}"

5. Qpid را از گروه تجزیه و تحلیل حذف کنید:

   curl -v -u <AdminEmailID>:'<AdminPassword>' \
   -X DELETE "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/servers?uuid={QPID_UUID}&type=qpid-server"

6. سرور Qpid را از نصب Edge حذف کنید:

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
   -d "type=qpid-server&region=dc-1&pod=central&uuid={QPID_UUID}&action=remove"

7. سرور Qpid را از نصب Edge حذف کنید:

   curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID

8. همه اجزای edge-qpid-server را در همه گره ها راه اندازی مجدد کنید تا مطمئن شوید که تغییر توسط آن مؤلفه ها برداشته شده است:

   $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready

9. حذف نصب edge-qpid-server و apigee-qpidd:

   $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
   $ /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

Postgres و Postgresql

مرکز داده ای که شما در حال از کار انداختن آن هستید می تواند یک Master Postgres یا یک Postgres Standby داشته باشد. بخش های زیر نحوه از کار انداختن آنها را توضیح می دهد:

• از کار افتادن استاد Postgres
• از کار انداختن آماده به کار Postgres

از کار افتادن استاد Postgres

توجه: اگر Master Postgres را از کار انداختید، مطمئن شوید که هر یک از گره‌های آماده به کار موجود را به عنوان یک Master Postgres جدید تبلیغ کنید. در حالی که QPID صف‌های داده‌ها را بافر می‌کند، اگر Master Postgres برای مدت طولانی در دسترس نباشد، خطر از دست دادن داده‌های تحلیلی را دارید.

برای از کار انداختن Master Postgres:

1. با دنبال کردن دستورالعمل‌های موجود در پیوندهای زیر، از گره اصلی dc-1 Postgres نسخه پشتیبان تهیه کنید:
   • پشتیبان گیری و بازیابی
   • نحوه پشتیبان گیری
2. UUID سرورهای Postgres را همانطور که در Get UUID توضیح داده شده است دریافت کنید.
3. در dc-1، edge-postgres-server و apigee-postgresql روی master فعلی متوقف کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

4. در گره آماده به کار در dc-2، دستور زیر را وارد کنید تا آن را به گره اصلی تبدیل کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql promote-standby-to-master <IP of OLD Progress master>

   توجه: اگر بیش از یک گره آماده به کار Postgres دارید، باید ورودی های میزبان را در اصلی جدید اضافه کنید و تنظیمات تکرار را برای همه گره های آماده به کار postgres موجود به روز کنید.

   برای افزودن ورودی‌های میزبان به Master Postgres جدید: مراحل مربوط به بخش زیر را دنبال کنید:

   اگر فقط یک گره آماده به کار باقی مانده باشد

   به عنوان مثال، فرض کنید قبل از از کار انداختن، سه گره Postgres پیکربندی شده بودند. شما استاد موجود را از کار انداختید و یکی از گره های آماده به کار postgres باقی مانده را به استاد ارتقا دادید. گره آماده به کار باقی مانده را با مراحل زیر پیکربندی کنید:

   1. در اصلی جدید، فایل پیکربندی را ویرایش کنید تا تنظیم کنید:

      PG_MASTER=IP_or_DNS_of_new_PG_MASTER
      PG_STANDBY=IP_or_DNS_of_PG_STANDBY

   2. فعال کردن تکرار در استاد جدید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle

   اگر بیش از یک گره آماده به کار باقی مانده باشد

   1. پیکربندی زیر را در /opt/apigee/customer/application/postgresql.properties اضافه کنید:

      conf_pg_hba_replication.connection=host replication apigee standby_1_ip/32 trust \n host replication apigee standby_2_ip/32 trust

   2. مطمئن شوید که فایل /opt/apigee/customer/application/postgresql.properties متعلق به کاربر apigee است:

            chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

   3. راه اندازی مجدد apigee-postgresql :

      apigee-service apigee-postgresql restart

   برای به روز رسانی تنظیمات تکرار در یک گره آماده به کار:

   1. فایل پیکربندی /opt/silent.conf را تغییر دهید و فیلد PG_MASTER را با آدرس IP استاد جدید Postgres به روز کنید.
   2. با دستور زیر تمام داده های قدیمی Postgres را حذف کنید:

      rm -rf /opt/apigee/data/apigee-postgresql/

   3. تکرار را در گره آماده به کار تنظیم کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   4. با وارد کردن دستور زیر در dc-2 مطمئن شوید که Postgres master به درستی تنظیم شده است:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

   5. سرورهای Postgresql را از گروه تجزیه و تحلیل و گروه مصرف کننده حذف و اضافه کنید.
      1. سرور قدیمی Postgres را از گروه تجزیه و تحلیل به دنبال دستورالعمل های موجود در حذف سرور Postgres از گروه تجزیه و تحلیل حذف کنید.
      2. به دنبال دستورالعمل‌های موجود در افزودن سرور Postgres موجود به یک گروه تجزیه و تحلیل، یک سرور postgres جدید به گروه تجزیه و تحلیل اضافه کنید.
   6. سرور قدیمی postgres را از dc-1 حذف کنید:

      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server&region=dc-1&pod=analytics&uuid=UUID&action=remove"<

   7. سرور postgres قدیمی را از dc-1 حذف کنید:

      curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID

   8. استاد قدیمی Postgres اکنون در خطر از کار افتادن است. حذف نصب edge-postgres-server و apigee-postgresql :

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall

   از کار انداختن آماده به کار Postgres

   توجه: مستندات نصب خوشه ای 12 گره، گره dc-1 postgresql را به عنوان اصلی نشان می دهد، اما برای راحتی، در این بخش فرض می شود که گره dc-1 postgresql آماده به کار است و گره dc-2 postgresql اصلی است.

   برای از کار انداختن حالت آماده به کار Postgres، مراحل زیر را انجام دهید:

   1. UUID سرورهای Postgres را با پیروی از دستورالعمل‌های دریافت UUID دریافت کنید.
   2. توقف apigee-postgresql در گره آماده به کار فعلی در dc-1:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. سرورهای Postgresql را از گروه تجزیه و تحلیل و گروه مصرف کننده حذف و اضافه کنید.
      1. سرور قدیمی Postgres را از گروه تجزیه و تحلیل به دنبال دستورالعمل های موجود در حذف سرور Postgres از گروه تجزیه و تحلیل حذف کنید.
      2. به دنبال دستورالعمل‌های موجود در افزودن سرور Postgres موجود به یک گروه تجزیه و تحلیل، یک سرور postgres جدید به گروه تجزیه و تحلیل اضافه کنید.
   4. سرور قدیمی postgres را از dc-1 حذف کنید:

      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server&region=dc-1&pod=analytics&uuid=UUID&action=remove"<

   5. سرور postgres قدیمی را از dc-1 حذف کنید:

      curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID

   6. استاد قدیمی Postgres اکنون در خطر از کار افتادن است. حذف نصب edge-postgres-server و apigee-postgresql :

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall

   ZooKeeper و Cassandra

   این بخش نحوه از کار انداختن سرورهای ZooKeeper و Cassandra را در راه اندازی دو مرکز داده توضیح می دهد.

   اگر بیش از دو مرکز داده دارید، مطمئن شوید که تمام ارجاعات به گره در حال از کار انداختن (در این مورد dc-1) را از تمام فایل‌های پیکربندی بی‌صدا در تمام مراکز داده باقیمانده حذف کنید. برای گره‌های Cassandra که قرار است از رده خارج شوند، آن میزبان‌ها را از CASS_HOSTS حذف کنید. گره های کاساندرا باقی مانده باید در ترتیب اولیه CASS_HOSTS باقی بمانند.

   نکته در مورد ZooKeeper: شما باید در حین اصلاح ویژگی ZK_HOST در فایل پیکربندی، حد نصاب گره های رای دهنده را حفظ کنید تا اطمینان حاصل کنید که مجموعه ZooKeeper عملکردی باقی می ماند. شما باید تعداد فرد گره رأی دهنده را در پیکربندی خود داشته باشید. برای اطلاعات بیشتر، به وظایف نگهداری Apache ZooKeeper مراجعه کنید.

   برای از کار انداختن سرورهای ZooKeeper و Cassandra:

   1. با دنبال کردن دستورالعمل‌های موجود در پیوندهای زیر، از گره‌های dc-1 Cassandra و ZooKeeper نسخه پشتیبان تهیه کنید:
      • پشتیبان گیری و بازیابی
      • نحوه پشتیبان گیری

   2. UUID سرورهای ZooKeeper و Cassandra را در مرکز داده ای که گره های Cassandra در شرف از بین رفتن هستند، فهرست کنید.

      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin <AdminEmailID> --pwd '<AdminPassword>' --host localhost

   3. نوع سرور را لغو ثبت کنید:

      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=user-settings-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=UUID&action=remove"

   4. حذف ثبت سرور:

      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID

   5. فایل پیکربندی را با IP گره های از کار افتاده حذف شده از ZK_HOSTS و CASS_HOSTS به روز کنید.

      مثال: فرض کنید IPهای $IP1 $IP2 $IP3 در dc-1 و $IP4 $IP5 $IP6 در dc-2 دارید و در حال از کار انداختن dc-1 هستید. سپس باید IP های $IP1 $IP2 $IP3 از فایل های پیکربندی حذف کنید.

      • ورودی های فایل پیکربندی موجود:

        ZK_HOSTS="$IP1 $IP2 $IP3 $IP4 $IP5 $IP6"
        CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1, $IP4:2,1 $IP5:2,1 $IP6:2,1”

      • ورودی های فایل پیکربندی جدید:

        ZK_HOSTS="$IP4 $IP5 $IP6"
        CASS_HOSTS="$IP4:2,1 $IP5:2,1 $IP6:2,1"

   6. فایل پیکربندی بی صدا (اصلاح شده در مرحله e) را با IP های گره های از کار افتاده حذف شده به روز کنید و نمایه سرور مدیریت را در تمام گره های میزبان سرورهای مدیریت اجرا کنید:

      /opt/apigee/apigee-setup/bin/setup.sh -p ms -f updated_config_file

   7. فایل پیکربندی را با IP گره های حذف شده به روز کنید و نمایه MP/RMP را در تمام گره های روتر و پردازشگر پیام اجرا کنید:
      • اگر Edge Router و Message Processor روی یک گره پیکربندی شده اند، وارد کنید:

        /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f updated_config_file

      • اگر Edge Router و Message Processor روی گره‌های جداگانه پیکربندی شده‌اند، موارد زیر را وارد کنید:

        برای روتر:

        /opt/apigee/apigee-setup/bin/setup.sh -p r -f updated_config_file

        برای پردازشگر پیام:

        /opt/apigee/apigee-setup/bin/setup.sh -p mp -f updated_config_file

   8. پیکربندی مجدد تمام گره های Qpid، با حذف IP گره های از کار افتاده از Response File:

      /opt/apigee/apigee-setup/bin/setup.sh -p qs -f updated_config_file

   9. پیکربندی مجدد تمام گره های Postgres، با حذف IP گره های از کار افتاده از Response File:

      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updated_config_file

   10. فضای کلید system_auth را تغییر دهید. اگر احراز هویت Cassandra را در یک گره Cassandra موجود فعال کرده‌اید، با اجرای دستور زیر، ضریب تکرار فضای کلید system_auth را به‌روزرسانی کنید:

       ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-2': '3'};

       این دستور ضریب تکرار را روی '3' تنظیم می کند که نشان دهنده سه گره Cassandra در خوشه است. در صورت لزوم این مقدار را تغییر دهید.

       پس از انجام این مرحله، توپولوژی کاساندرا نباید در هیچ یک از فضاهای کلیدی dc-1 داشته باشد.

   11. گره های کاساندرا را در dc-1 تک تک از کار خارج کنید.

       برای از کار انداختن گره های کاساندرا، دستور زیر را وارد کنید:

       /opt/apigee/apigee-cassandra/bin/nodetool -h cassIP -u cassandra -pw '<AdminPassword>' decommission

   12. اتصال گره های کاساندرا از dc-1 را با استفاده از یکی از دستورات زیر بررسی کنید:

       /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p '<AdminPassword>'

       یا دستور تأیید ثانویه برای اجرا در گره از کار افتاده:

       /opt/apigee/apigee-cassandra/bin/nodetool netstats

       دستور بالا باید برگردد:

       Mode: DECOMMISSIONED

   13. نمایه DS را برای تمام گره های Cassandra و ZooKeeper در dc-2 اجرا کنید:

       /opt/apigee/apigee-setup/bin/setup.sh -p ds -f updated_config_file

   14. توقف apigee-cassandra و apigee-zookeeper در dc-1:

       apigee-service apigee-cassandra stop
       apigee-service apigee-zookeeper stop

   15. apigee-cassandra و apigee-zookeeper در dc-1 حذف نصب کنید:

       apigee-service apigee-cassandra uninstall
       apigee-service apigee-zookeeper uninstall

   اتصالات را از dc-1 حذف کنید

   برای حذف اتصالات از dc-1، مراحل زیر را انجام دهید:

   1. اتصالات را از dc-1 حذف کنید.
      1. فهرست تمام پادهای موجود در سازمان:

         curl -v -u  <AdminEmailID>:<AdminPassword> -X GET "http://MS_IP:8080/v1/o/ORG/pods"

      2. برای بررسی اینکه آیا تمام اتصالات حذف شده اند، UUID سرورهای مرتبط با پادها را دریافت کنید:

         curl -v -u  <AdminEmailID>:<AdminPassword> \
         -X GET "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1/servers"

         اگر این دستور هیچ UUID را برنگرداند، مراحل قبلی تمام اتصالات را حذف کرده است و می‌توانید از مرحله بعدی رد شوید. در غیر این صورت مرحله بعدی را انجام دهید.

      3. تمام اتصالات سرور برای UUID های به دست آمده در مرحله قبل را حذف کنید:

         curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID

      4. سازمان را از غلاف جدا کنید:

         curl -v -u  <AdminEmailID>:<AdminPassword>  "http://MS_IP:8080/v1/o/ORG/pods" -d "action=remove&region=dc-1&pod=gateway-1" -H "Content-Type: application/x-www-form-urlencoded" -X POST

   2. غلاف ها را حذف کنید:

      curl -v -u <AdminEmailID>:<AdminPassword> "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1" -X DELETE

   3. منطقه را حذف کنید.

      curl -v -u <AdminEmailID>:<AdminPassword>  "http://MS_IP:8080/v1/regions/dc-1" -X DELETE

   توجه: اگر یکی از مراحل حذف سرورها را از دست بدهید، مرحله بالا یک پیغام خطا نشان می دهد که سرور خاصی در پاد هنوز وجود دارد. بنابراین، با دنبال کردن مراحل عیب یابی زیر، آنها را حذف کنید، در حالی که انواع را در دستور curl سفارشی کنید.

   در این مرحله شما عملیات انحلال dc-1 را کامل کرده اید.

   ضمیمه

   عیب یابی

   اگر پس از انجام مراحل قبلی، هنوز سرور در برخی از پادها وجود دارد، مراحل زیر را برای لغو ثبت و حذف سرورها انجام دهید. توجه: در صورت لزوم انواع و غلاف را تغییر دهید.

   1. UUID ها را با استفاده از دستور زیر دریافت کنید:

      apigee-adminapi.sh servers list -r dc-1 -p POD -t  --admin <AdminEmailID> --pwd  '<AdminPassword>’ --host localhost

   2. نوع سرور لغو ثبت:

      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MP_IP:8080/v1/servers -d "type=TYPE=REGION=dc-1&pod=POD&uuid=UUID&action=remove"

   3. سرورها را یکی یکی حذف کنید:

      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MP_IP:8080/v1/servers/UUID

   اعتبار سنجی

   با استفاده از دستورات زیر می توانید از کار افتادن را تأیید کنید.

   سرور مدیریت

   دستورات زیر را از سرورهای مدیریت در تمام مناطق اجرا کنید.

   curl -v  -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=central&region=dc-1
   curl -v  -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=gateway&region=dc-1
   curl -v -u  <AdminEmailID>:'<AdminPassword>'  http://MS_IP:8080/v1/servers?pod=analytics&region=dc-1

   برای بررسی الزامات پورت برای همه پورت های مدیریتی، دستور زیر را بر روی تمام اجزاء اجرا کنید.

   curl -v http://MS_IP:8080/v1/servers/self

   گروه تجزیه و تحلیل را بررسی کنید.

   curl  -v  -u  <AdminEmailID>:'<AdminPassword>' "http://MS_IP:8080}/v1/o/ORG/e/ENV/provisioning/axstatus"
   curl -v  -u  <AdminEmailID>:'<AdminPassword>'  http://MS_IP:8080/v1/analytics/groups/ax

   گره های Cassandra/ZooKeeper

   در تمام گره های کاساندرا وارد کنید:

   /opt/apigee/apigee-cassandra/bin/nodetool -h <host> statusthrift

   این یک وضعیت running یا not running آن گره خاص را برمی گرداند.

   در یک گره وارد کنید:

   /opt/apigee/apigee-cassandra/bin/nodetool -h <host> ring

   /opt/apigee/apigee-cassandra/bin/nodetool -h <host> status

   دستورات بالا اطلاعات مرکز داده فعال را برمی گرداند.

   در گره های ZooKeeper، ابتدا وارد کنید:

   echo ruok | nc <host> 2181

   این دستور imok را برمی گرداند.

   سپس وارد کنید:

   echo stat | nc <host> 2181 | grep Mode

   مقدار Mode که توسط دستور بالا برگردانده می شود یکی از موارد زیر خواهد بود: observer ، leader یا follower .

   در یک گره ZooKeeper:

   /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh >> /tmp/zk-tree.out.txt

   در گره اصلی Postgres، اجرا کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

   تأیید کنید که پاسخ می گوید گره اصلی است.

   در گره آماده به کار:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

   تأیید کنید که پاسخ می گوید گره در حالت آماده به کار است.

   با استفاده از دستور وارد پایگاه داده PostgreSQL شوید

   psql -h localhost -d apigee -U postgres

   هنگامی که از شما خواسته شد، رمز عبور کاربر "postgres" را به عنوان 'postgres' وارد کنید. max(client_received_start_timestamp) از تجزیه و تحلیل انتخاب کنید.

   ”$org.$env.fact” limit 1 ;

   سیاههها

   سیاهههای مربوط به اجزا را بررسی کنید تا مطمئن شوید که خطایی وجود ندارد.