افزودن گره «پردازشگر پیام» یا «رهیاب»

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

افزودن رهیاب

پس‌از نصب Edge در گره، از روال زیر برای افزودن «رهیاب» استفاده کنید:

  1. Edge را بااستفاده از روش اینترنتی یا غیر اینترنتی که در راهنمای نصب Edge شرح داده شده است روی گره نصب کنید.
  2. در پیام‌واره فرمان، اسکریپت apigee-setup.sh را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r -f configFile

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

  3. وقتی نصب تکمیل شد، اسکریپت UUID «رهیاب» را نمایش می‌دهد. اگر لازم است بعداً UUID را تعیین کنید، از فرمان cURL زیر در میزبانی که «رهیاب» را در آن نصب کرده‌اید استفاده کنید: 
    curl http://router_IP:8081/v1/servers/self
  4. اگر از اصالت‌سنجی Cassandra استفاده می‌کنید، «رهیاب» را برای اتصال به Cassandra فعال کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router store_cassandra_credentials -u username -p password

    برای اطلاعات بیشتر، فعال کردن اصالت‌سنجی Cassandra را ببینید.

  5. برای بررسی پیکربندی، می‌توانید فرمان curl زیر را اجرا کنید: 
    curl -v -u adminEmail:pword "http://ms_IP:8080/v1/servers?pod=pod_name"

    که pod_name دروازه یا نام پاد سفارشی شما است. باید شناسه UUID همه «رهیاب‌ها»، ازجمله «رهیابی» را که به‌تازگی اضافه کردید، ببینید.

    اگر Router UUID در خروجی نشان داده نشد، فرمان cURL زیر را برای افزودن آن اجرا کنید:

    curl -v -u adminEmail:pword \
  -X POST http://ms_IP:8080/v1/regions/region_name/pods/pod_name/servers \
  -d "action=add&uuid=router_UUID&type=router"

    ms_IP را با نشانی IP «سرور مدیریت»، region_name را با نام منطقه پیش‌فرض dc-1 یا نام منطقه سفارشی‌تان، و pod_name را با نام pod سفارشی‌تان یا gateway جایگزین کنید.

  6. برای آزمایش کردن رهیاب، باید بتوانید ازطریق نشانی IP یا نام ساناد رهیاب، درخواست‌هایی به میاناهای برنامه‌سازی کاربردی خود ارسال کنید. برای مثال: 
    http://newRouter_IP:port/v1/apiPath

    برای مثال، اگر اولین آموزش گام‌به‌گام را که در آن Weather API را ایجاد کردید تکمیل کرده‌اید: 

    http://newRouter_IP:port/v1/weather/forecastrss?w=12797282

افزودن پردازشگر پیام

پس‌از نصب Edge در گره، از روال زیر برای افزودن «پردازشگر پیام» استفاده کنید:

  1. Edge را بااستفاده از روش اینترنتی یا غیراینترنتی که در راهنمای نصب Edge شرح داده شده است در گره نصب کنید.
  2. در پیام‌واره فرمان، اسکریپت apigee-setup.sh را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mp -f configFile

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

  3. وقتی نصب تکمیل شد، اسکریپت UUID «پردازشگر پیام» را نمایش می‌دهد. این UUID را یادداشت کنید چون برای تکمیل فرایند پیکربندی به آن نیاز دارید. اگر لازم است UUID را تعیین کنید، از فرمان curl زیر در میزبانی که «پردازشگر پیام» را در آن نصب کرده‌اید استفاده کنید: 
    curl http://mp_IP:8082/v1/servers/self
  4. برای هر محیط در هر سازمان در نصب خود، از دستور curl زیر برای مرتبط کردن «پردازشگر پیام» با محیط استفاده کنید: 
    curl -v -u adminEmail:pword \
  -H "Content-Type: application/x-www-form-urlencoded" -X POST
  "http://ms_IP:8080/v1/o/org_name/e/env_name/servers" \
  -d "action=add&uuid=mp_UUID"

    ms_IP را با نشانی IP مربوط به Management Server و org_name و env_name را با سازمان و محیط مرتبط با Message Processor جایگزین کنید.

  5. برای بررسی پیکربندی، می‌توانید فرمان curl زیر را اجرا کنید: 
    curl -v -u adminEmail:pword \
  "http://ms_IP:8080/v1/o/org_name/e/env_name/servers"

    که org_name نام سازمان شما است، و env_name محیط است. باید UUID همه «پردازشگرهای پیام» مرتبط با سازمان و محیط را ببینید، ازجمله «پردازشگر پیامی» که به‌تازگی اضافه کرده‌اید.

  6. اگر از اصالت‌سنجی Cassandra استفاده می‌کنید، «پردازشگر پیام» را برای اتصال به Cassandra فعال کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor store_cassandra_credentials -u username -p password

    برای اطلاعات بیشتر، فعال کردن اصالت‌سنجی Cassandra را ببینید.

بازراه‌اندازی رهیاب‌ها

پس‌از افزودن همه گره‌های «پردازشگر پیام»، توصیه می‌شود «مسیریاب‌ها» را بازراه‌اندازی کنید:

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

افزودن Router و Message Processor

پس‌از نصب Edge در گره، از روال زیر برای افزودن هم‌زمان «رهیاب» و «پردازشگر پیام» استفاده کنید:

  1. در پیام‌واره فرمان، اسکریپت apigee-setup را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile

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

  2. برای پیکربندی «رهیاب» و «پردازشگر پیام»، روال‌های بالا را دنبال کنید.