نمای کلی نصب Edge

یک نصب معمولی Edge شامل مؤلفه‌های Edge است که در چندین گره توزیع شده‌اند. پس‌از نصب Edge در گره، یک یا چند مؤلفه Edge را در گره نصب و پیکربندی می‌کنید.

فرایند نصب

نصب Edge روی گره یک فرایند چندمرحله‌ای است:

1. SELinux را در گره غیرفعال کنید یا آن را روی حالت مجاز تنظیم کنید. برای اطلاعات بیشتر، نصب ابزار کمکی Edge apigee-setup را ببینید.
2. تصمیم بگیرید که آیا می‌خواهید اصالت‌سنجی Cassandra را فعال کنید یا نه.
3. تصمیم بگیرید که آیا می‌خواهید تکرار اصلی-آماده‌به‌کار را برای Postgres راه‌اندازی کنید یا نه.
4. پیکربندی Edge خود را از فهرست توپولوژی‌های توصیه‌شده انتخاب کنید. برای مثال، می‌توانید Edge را روی یک گره برای آزمایش، یا روی ۱۳ گره برای تولید نصب کنید. برای اطلاعات بیشتر، به توپولوژی‌های نصب مراجعه کنید.
5. در هر گره در توپولوژی انتخابی‌تان، ابزار apigee-setup Edge را نصب کنید:
   • فایل Edge bootstrap_4.54.00.sh را در /tmp/bootstrap_4.54.00.sh بارگیری کنید.
   • ابزار و وابستگی‌های Edge apigee-service را نصب کنید.
   • برنامه کمکی Edge apigee-setup و وابستگی‌ها را نصب کنید.

     برای اطلاعات بیشتر، نصب ابزار کمکی apigee-setup در Edge را ببینید.

6. از ابزار apigee-setup برای نصب یک یا چند مؤلفه Edge در هر گره براساس توپولوژی انتخابی‌تان استفاده کنید.

   به نصب عناصر Edge در گره مراجعه کنید.

7. در گره «سرور مدیریت»، از ابزار apigee-setup برای نصب apigee-provision استفاده کنید، ابزارهایی که برای ایجاد و مدیریت سازمان‌های Edge استفاده می‌کنید.

   برای اطلاعات بیشتر، به‌کارگیری سازمان را ببینید.

8. پس‌از تکمیل نصب، جزء «واسط کاربر New Edge» را در هر گره بازراه‌اندازی کنید، همان‌طور که در مثال زیر نشان داده شده است:

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

9. اصالت‌سنجی و تنظیمات اختیاری را برای New Edge UI (که نام مؤلفه‌های آن edge-management-ui و edge-management-ui-static است) پیکربندی کنید.

   برای اطلاعات بیشتر، پیکربندی واسط کاربر New Edge را ببینید.

پس‌از تکمیل نصب، این فهرست از اقدامات رایج پس‌از نصب را بررسی کنید.

چه کسی می‌تواند نصب را انجام دهد

فایل‌های توزیع Apigee Edge به‌عنوان مجموعه‌ای از RPMها و وابستگی‌ها نصب می‌شوند. برای نصب، حذف نصب، و به‌روزرسانی Edge RPM، فرمان‌ها باید توسط کاربر ریشه یا کاربری که دسترسی کامل sudo دارد اجرا شود. برای دسترسی کامل sudo، یعنی کاربر برای انجام همان عملیات ریشه، دسترسی sudo دارد.

هر کاربری که می‌خواهد فرمان‌ها یا دستورگان‌های زیر را اجرا کند باید ریشه باشد یا کاربری باشد که دسترسی کامل sudo دارد:

• apigee-service utility:
  • فرمان‌های apigee-service: install, uninstall, update.
  • فرمان‌های apigee-all: install, uninstall, update.
• دستورگان setup.sh برای نصب مؤلفه‌های Edge (مگراینکه قبلاً از «apigee-service install» برای نصب RPMهای لازم استفاده کرده باشید. سپس دسترسی ریشه یا sudo کامل اگر لازم نباشد.)
• برنامه update.sh برای به‌روزرسانی عناصر Edge

همچنین، نصب‌کننده Edge کاربر جدیدی به‌نام «apigee» در سیستم شما ایجاد می‌کند. بسیاری از فرمان‌های Edge sudo را برای اجرا به‌عنوان کاربر «apigee» فراخوانی می‌کنند.

هر کاربری که بخواهد همه دستورات دیگر را به‌جز دستورات نشان‌داده‌شده در بالا اجرا کند باید کاربری با دسترسی کامل sudo به کاربر «apigee» باشد. این فرمان‌ها شامل موارد زیر است:

• فرمان‌های کمکی apigee-service، ازجمله:
  • فرمان‌های apigee-service مانند start, stop, restart, configure.
  • فرمان‌های apigee-all مثل start, stop, restart, configure.

درحال ایجاد کاربری با دسترسی کامل sudo به کاربر «apigee»

برای پیکربندی کاربری که دسترسی کامل sudo به کاربر «apigee» داشته باشد، از فرمان «visudo» برای ویرایش فایل sudoers برای افزودن موارد زیر استفاده کنید:

installUser        ALL=(apigee)      NOPASSWD: ALL

که installUser نام کاربری فردی است که با Edge کار می‌کند.

تنظیم اجازه‌ها در فایل‌های پیکربندی

هر فایل یا منبعی که توسط دستورات Edge استفاده می‌شود باید برای کاربر «apigee» قابل‌دسترسی باشد. این شامل فایل پروانه Edge و هرگونه فایل پیکربندی می‌شود.

هنگام ایجاد فایل پیکربندی، می‌توانید مالک آن را به «apigee:apigee» تغییر دهید تا مطمئن شوید که برای فرمان‌های Edge قابل‌دسترسی است:

1. فایل را در ویرایشگر به‌عنوان هر کاربری ایجاد کنید.
2. chown مالک فایل را به «apigee:apigee» تغییر دهید یا اگر کاربری را که سرویس Edge را اجرا می‌کند از کاربر «apigee» تغییر داده‌اید، مالک فایل را به کاربری که سرویس Edge را اجرا می‌کند تغییر دهید.

جدا کردن وظایف نصب Edge بین کاربر ریشه و غیر ریشه

اگرچه ساده‌ترین راه این است که کل فرایند نصب Edge را به‌عنوان ریشه یا توسط کاربری که دسترسی کامل sudo دارد انجام دهید، اما این کار همیشه ممکن نیست. به‌جای آن، می‌توانید فرایند را به تکالیفی که توسط root انجام می‌شود و تکالیفی که توسط کاربری با دسترسی کامل sudo به کاربر «apigee» انجام می‌شود تقسیم کنید.

1. تکالیف انجام‌شده توسط root:
   1. فایل bootstrap_4.54.00.sh را بارگیری و اجرا کنید:

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      این مرحله ابزار apigee-service را نصب می‌کند و کاربر «apigee» را ایجاد می‌کند.

   2. کاربری را پیکربندی کنید تا همان‌طور که در ایجاد کاربر با دسترسی کامل sudo به کاربر «apigee» توضیح داده شده است، دسترسی کامل sudo به کاربر «apigee» داشته باشد.
   3. برنامه کمکی apigee-setup را نصب کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. از ابزار apigee-setup برای نصب Edge RPM در گره استفاده کنید:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      «بسته‌های Edge RPM» که در گره نصب می‌کنید به توپولوژی شما بستگی دارد. فهرست مؤلفه‌های دردسترس شامل این موارد است: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. پس از اینکه کاربر ریشه RPMهای Edge را در گره نصب کرد، کاربر با دسترسی کامل sudo به کاربر «apigee» فرایند پیکربندی را تکمیل می‌کند:
   1. از ابزار setup.sh برای تکمیل پیکربندی عناصر Edge در گره استفاده کنید. شکل فرمان به مؤلفه‌هایی بستگی دارد که در گره نصب کرده‌اید. برای مشاهده فهرست کامل، به نصب کردن عناصر Edge در گره مراجعه کنید.

      برای مثال، برای تکمیل نصب ZooKeeper و Cassandra، از فرمان زیر استفاده کنید:

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

      که configFile فایل پیکربندی Edge است.

      یا برای نصب همه‌جانبه، از فرمان زیر استفاده کنید:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

مکان فایل‌های پیکربندی نصب

باید فایل پیکربندی را به ابزار کمکی apigee-setup که حاوی اطلاعات مربوط به نصب Edge است ارسال کنید. تنها الزام برای نصب‌های بی‌صدا این است که فایل پیکربندی باید برای کاربر «apigee» دردسترس یا خوانا باشد. برای مثال، فایل را در دایرکتوری /usr/local/var یا /usr/local/share در گره قرار دهید و آن را به «apigee:apigee» chown کنید.

همه اطلاعات موجود در فایل پیکربندی، به‌جز گذرواژه سرپرست سیستم Edge، الزامی است. اگر گذرواژه را حذف کنید، ابزار apigee-setup از شما می‌خواهد آن را در خط فرمان وارد کنید.

برای اطلاعات بیشتر، نصب عناصر Edge در گره را ببینید.

رسیدگی به خطای نصب

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

پس‌از نصب یا ارتقا، حتماً مؤلفه «میانای کاربری Edge جدید» را در هر گره‌ای که در آن اجرا می‌شود بازراه‌اندازی کنید.

نصب اینترنتی یا غیر اینترنتی

برای نصب Edge در گره، گره باید بتواند به مخزن Apigee دسترسی داشته باشد:

• گره‌های دارای اتصال اینترنت خارجی

  گره‌های دارای اتصال اینترنت خارجی برای نصب RPM و وابستگی‌های Edge به مخزن Apigee دسترسی پیدا می‌کنند.

• گره‌های بدون اتصال اینترنت خارجی

  گره‌های بدون اتصال اینترنت خارجی می‌توانند به نسخه آینه‌ای مخزن Apigee که به‌صورت داخلی راه‌اندازی کرده‌اید دسترسی داشته باشند. این مخزن حاوی همه RPMهای Edge است، اما باید مطمئن شوید که همه وابستگی‌های دیگر را از مخازن موجود در شبکه داخلی دردسترس دارید.

  برای ایجاد مخزن Apigee داخلی، به گره‌ای با دسترسی به اینترنت خارجی نیاز دارید تا بتوانید RPMهای Edge و وابستگی‌ها را بارگیری کنید. پس‌از ایجاد مخزن داخلی، می‌توانید آن را به گره دیگری منتقل کنید یا آن گره را برای نصب در دسترس گره‌های Edge قرار دهید.

استفاده از مخزن Edge محلی برای حفظ نسخه Edge

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

درحال حل کردن وابستگی‌های نصب RPM

فایل‌های توزیع Apigee Edge به‌عنوان مجموعه‌ای از فایل‌های RPM نصب می‌شوند که هرکدام می‌توانند زنجیره وابستگی‌های نصب خود را داشته باشند. بسیاری از این وابستگی‌ها توسط عناصر طرف سوم تعریف می‌شوند که خارج از کنترل Apigee هستند و می‌توانند در هر زمانی تغییر کنند. بنابراین، مستندات شماره نسخه صریح هر وابستگی را فهرست نمی‌کند.

اگر نصب را روی ماشینی با دسترسی به اینترنت انجام می‌دهید، گره می‌تواند ‫RPM و وابستگی‌های لازم را بارگیری کند. بااین‌حال، اگر از گره‌ای بدون دسترسی به اینترنت نصب می‌کنید، معمولاً یک مخزن داخلی حاوی تمام وابستگی‌های لازم راه‌اندازی می‌کنید. تنها راه تضمین اینکه همه وابستگی‌ها در مخزن محلی شما گنجانده شده‌اند این است که نصب را امتحان کنید، وابستگی‌های ازدست‌رفته را شناسایی کنید، و آن‌ها را در مخزن محلی کپی کنید تا نصب موفقیت‌آمیز شود.

فرمان‌های رایج Yum

ابزارهای نصب Edge برای Linux برای نصب و به‌روزرسانی مؤلفه‌ها به Yum متکی هستند. ممکن است برای مدیریت نصب در یک گره، مجبور شوید از چندین فرمان Yum استفاده کنید.

• همه حافظه‌های نهان Yum را پاک کنید:

  sudo yum clean all

• برای به‌روزرسانی یک مؤلفه Edge:

  sudo yum update componentName

  برای مثال:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

ساختار سیستم فایل

‫Edge همه فایل‌ها را در دایرکتوری /opt/apigee نصب می‌کند.

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

/opt/apigee

نصب از ساختار سیستم فایل زیر برای استقرار Apigee Edge برای Private Cloud استفاده می‌کند.

فایل‌های گزارش

فایل گزارش برای apigee-setup و کد setup.sh در /tmp/setup-root.log نوشته شده است.

فایل‌های گزارش برای هر مؤلفه در فهرست راهنمای /opt/apigee/var/log قرار دارد. هر مؤلفه زیرفهرست راهنمای خودش را دارد. برای مثال، گزارش‌های «سرور مدیریت» در این دایرکتوری قرار دارد:

/opt/apigee/var/log/edge-management-server

جدول‌های زیر مکان فایل‌های گزارش را فهرست می‌کند:

داده

فعال کردن بررسی سیستم در هنگام نصب

فایل پیکربندی نصب Edge از ویژگی زیر پشتیبانی می‌کند:

ENABLE_SYSTEM_CHECK=y

اگر این ویژگی را روی «y» تنظیم کنید، نصب‌کننده بررسی می‌کند که سیستم الزامات CPU و حافظه را برای مؤلفه درحال نصب برآورده می‌کند یا نه. مقدار پیش‌فرض «n» است تا بررسی را غیرفعال کند.