افزودن یا برداشتن گره‌های Qpid

این سند نحوه افزودن و برداشتن سرور Qpid را در نصب Edge موجود شرح می‌دهد.

برای کسب اطلاعات درباره نحوه برداشتن «سرور مدیریت»، «پردازشگر پیام»، یا «مسیریاب»، به برداشتن سرور مراجعه کنید.

افزودن سرور Qpid

برای افزودن سرور Qpid:

  1. در «سرور مدیریت»، نام گروه‌های مصرف‌کننده و تجزیه‌وتحلیل را تعیین کنید.

    بسیاری از فرمان‌های زیر به این اطلاعات نیاز دارند. به‌طور پیش‌فرض، نام گروه تجزیه‌وتحلیل axgroup-001 و نام گروه مصرف‌کننده consumer-group-001 است. در فایل پیکربندی بی‌صدا برای یک منطقه، می‌توانید نام گروه Analytics را بااستفاده از ویژگی AXGROUP تنظیم کنید.

    اگر از نام گروه‌های مصرف‌کننده و تجزیه‌وتحلیل مطمئن نیستید، از فرمان زیر برای نمایش آن‌ها استفاده کنید:

    apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost

    این فرمان نام گروه Analytics را در فیلد name و نام گروه مصرف‌کننده را در فیلد consumer-groups برمی‌گرداند.

  2. برنامه کمکی Edge apigee-setup را بااستفاده از روش اینترنتی یا غیر اینترنتی که در نصب برنامه کمکی Edge apigee-setup شرح داده شده است در گره نصب کنید.
  3. از apigee-setup.sh برای نصب Qpid روی گره استفاده کنید:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

    گزینه «-p qs» نصب Qpid را مشخص می‌کند. برای کسب اطلاعات درباره ایجاد configFile، به نصب مؤلفه‌های Edge در گره مراجعه کنید.

    وقتی نصب کامل شد، متن UUID سرور Qpid را نمایش می‌دهد. اگر لازم است بعداً UUID را تعیین کنید، از فرمان cURL زیر در میزبانی که Qpid را در آن نصب کرده‌اید استفاده کنید:

    curl http://qpid_IP:8083/v1/servers/self
  4. افزودن Qpid به گروه تجزیه‌وتحلیل:
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X POST "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/servers?uuid=QPID_UUID&type=qpid-server"

    در خروجی، شناسه UUID گره Qpid را می‌بینید که به qpid-server ویژگی تحت axgroup-001 اضافه شده است:

    {
      "name" : "axgroup-001",
      "properties" : {},
      "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
      "uuids" : {
        "qpid-server" : [
          "d6d0480f-8393-465d-a2a1-b4a16a033c55",
          "8398a95c-3640-4bd9-bf7e-1eb89155810a"
        ]
      }
    }
  5. Qpid را به گروه مصرف‌کننده اضافه کنید:
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X POST "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/consumer-groups/CONSUMER_GROUP/consumers?uuid=QPID_UUID"

    در خروجی، UUID گره Qpid را می‌بینید که به ویژگی consumer-groups در consumer-group-001 اضافه شده است:

    "consumer-groups" : [ {
      "name" : "consumer-group-001",
      "consumers" : [
        "d6d0480f-8393-465d-a2a1-b4a16a033c55",
        "8398a95c-3640-4bd9-bf7e-1eb89155810a"
      ]
    } ]
  6. همه مؤلفه‌های 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

نصب کامل شد.

برداشتن سرور Qpid

برای برداشتن گره Qpid:

  1. در «سرور مدیریت»، نام گروه‌های مصرف‌کننده و تجزیه‌وتحلیل را تعیین کنید. بسیاری از فرمان‌های زیر به این اطلاعات نیاز دارند.

    به‌طور پیش‌فرض، نام گروه تجزیه‌وتحلیل axgroup-001 و نام گروه مصرف‌کننده consumer-group-001 است. در فایل پیکربندی بی‌صدا برای یک منطقه، می‌توانید نام گروه Analytics را بااستفاده از ویژگی AXGROUP تنظیم کنید.

    اگر از نام گروه‌های مصرف‌کننده و تجزیه‌وتحلیل مطمئن نیستید، از فرمان زیر برای نمایش آن‌ها استفاده کنید:

    apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost

    این فرمان نام گروه تجزیه‌وتحلیل را در فیلد نام و نام گروه مصرف‌کننده را در فیلد consumer-groups برمی‌گرداند.

  2. Qpid را از گروه مصرف‌کننده بردارید:
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/consumer-groups/CONSUMER_GROUP/consumers/QPID_UUID"
  3. برداشتن Qpid از گروه تجزیه‌وتحلیل:
    curl -v -u adminEmail:pword
      -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/servers?uuid=QPID_UUID&type=qpid-server"
  4. لغو ثبت سرور Qpid از نصب Edge:
    curl -u adminEmail:pword
      -X POST http://ms_IP:8080/v1/servers -d "type=qpid-server&region=dc-1&pod=central&uuid=QPID_UUID&action=remove"
  5. سرور Qpid را از نصب Edge بردارید:
    curl -u adminEmail:pword -X DELETE http://ms_IP:8080/v1/servers/QPID_UUID
  6. همه مؤلفه‌های 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
  7. Qpid را طبق روشی که در حذف نصب Edge توضیح داده شده است حذف نصب کنید.