نمای کلی نصب Edge

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

فرآیند نصب

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

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

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

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

    به نصب اجزای لبه روی یک گره مراجعه کنید.

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

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

  8. همانطور که در مثال زیر نشان داده شده است، پس از اتمام نصب، مؤلفه Classic UI را در هر گره مجدداً راه اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (توصیه می شود) پس از اتمام نصب اولیه، Apigee توصیه می کند که رابط کاربری جدید Edge (که نام مؤلفه آن edge-management-ui است) را نصب کنید که یک رابط کاربری پیشرفته برای توسعه دهندگان و مدیران Apigee Edge برای Private Cloud است.

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

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

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

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

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

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

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

هر کاربری که بخواهد همه دستورات دیگر را غیر از دستورات نشان داده شده در بالا اجرا کند، باید کاربری با دسترسی کامل sudo به کاربر "apigee" باشد. این دستورات عبارتند از:

  • دستورات کاربردی apigee-service ، از جمله:
    • دستورات apigee-service مانند start, stop, restart, configure .
    • apigee-همه دستورات مانند 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. مالک فایل را به "apigee:apigee" chown یا اگر کاربری که سرویس Edge را اجرا می کند از کاربر "apigee" تغییر داده اید، فایل را برای کاربری که سرویس Edge را اجرا می کند، انتخاب کنید.

جداسازی وظایف نصب Edge بین کاربر روت و غیر روت

در حالی که اجرای کل فرآیند نصب Edge به صورت روت یا توسط کاربری که دسترسی کامل به sudo دارد ساده‌ترین کار است، اما همیشه این امکان وجود ندارد. در عوض، می‌توانید فرآیند را به وظایفی که توسط روت انجام می‌شوند و کارهایی که توسط کاربر با دسترسی کامل sudo به کاربر "apigee" انجام می‌شود، جدا کنید.

  1. وظایف انجام شده توسط روت:
    1. فایل bootstrap_4.53.00.sh را دانلود و اجرا کنید: 
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
sudo bash /tmp/bootstrap_4.53.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

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

  2. پس از اینکه کاربر root RPM های Edge را روی گره نصب کرد، کاربر با دسترسی کامل sudo به کاربر "apigee" فرآیند پیکربندی را تکمیل می کند:
    1. از ابزار setup.sh برای تکمیل پیکربندی اجزای 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 UI را در هر گره ای که روی آن اجرا می شود، مجدداً راه اندازی کنید.

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

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

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

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

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

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

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

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

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

رفع وابستگی نصب RPM

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

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

دستورات رایج یام

ابزارهای نصب Edge برای لینوکس به 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 استفاده می کند.

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

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

فایل های گزارش برای هر جزء در پوشه /opt/apigee/var/log موجود است. هر کامپوننت زیرشاخه مخصوص به خود را دارد. به عنوان مثال، گزارش‌های مربوط به سرور مدیریت در دایرکتوری قرار دارند:

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

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

جزء مکان

سرور مدیریت

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

روتر

 /opt/apigee/var/log/edge-router

Edge Router با استفاده از Nginx پیاده سازی شده است. برای گزارش های اضافی، نگاه کنید به:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

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

 /opt/apigee/var/log/edge-message-processor

سرور Apigee Qpid

 /opt/apigee/var/log/edge-qpid-server
سرور Apigee Postgres /opt/apigee/var/log/edge-postgres-server
رابط کاربری کلاسیک (نه رابط کاربری Edge جدید که نام مؤلفه آن edge-management-ui است) /opt/apigee/var/log/edge-ui
باغ وحش /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
کاساندرا /opt/apigee/var/log/apigee-cassandra/system.log
Qpidd /opt/apigee/var/log/apigee-qpidd
پایگاه داده PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

داده ها

جزء مکان
سرور مدیریت /opt/apigee/data/edge-management-server
روتر /opt/apigee/data/edge-router
پردازشگر پیام /opt/apigee/data/edge-message-processor
عامل Apigee Qpid /opt/apigee/data/edge-qpid-server
نماینده Apigee Postgres /opt/apigee/data/edge-postgres-server
باغ وحش /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
کاساندرا /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
پایگاه داده PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

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

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

ENABLE_SYSTEM_CHECK=y

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

،

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

فرآیند نصب

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

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

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

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

    به نصب اجزای لبه روی یک گره مراجعه کنید.

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

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

  8. همانطور که در مثال زیر نشان داده شده است، پس از اتمام نصب، مؤلفه Classic UI را در هر گره مجدداً راه اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (توصیه می شود) پس از اتمام نصب اولیه، Apigee توصیه می کند که رابط کاربری جدید Edge (که نام مؤلفه آن edge-management-ui است) را نصب کنید که یک رابط کاربری پیشرفته برای توسعه دهندگان و مدیران Apigee Edge برای Private Cloud است.

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

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

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

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

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

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

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

هر کاربری که بخواهد همه دستورات دیگر را غیر از دستورات نشان داده شده در بالا اجرا کند، باید کاربری با دسترسی کامل sudo به کاربر "apigee" باشد. این دستورات عبارتند از:

  • دستورات کاربردی apigee-service ، از جمله:
    • دستورات apigee-service مانند start, stop, restart, configure .
    • apigee-همه دستورات مانند 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. مالک فایل را به "apigee:apigee" chown یا اگر کاربری که سرویس Edge را اجرا می کند از کاربر "apigee" تغییر داده اید، فایل را برای کاربری که سرویس Edge را اجرا می کند، انتخاب کنید.

جداسازی وظایف نصب Edge بین کاربر روت و غیر روت

در حالی که اجرای کل فرآیند نصب Edge به صورت روت یا توسط کاربری که دسترسی کامل به sudo دارد ساده‌ترین کار است، اما همیشه این امکان وجود ندارد. در عوض، می‌توانید فرآیند را به وظایفی که توسط روت انجام می‌شوند و کارهایی که توسط کاربر با دسترسی کامل sudo به کاربر "apigee" انجام می‌شود، جدا کنید.

  1. وظایف انجام شده توسط روت:
    1. فایل bootstrap_4.53.00.sh را دانلود و اجرا کنید: 
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
sudo bash /tmp/bootstrap_4.53.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

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

  2. پس از اینکه کاربر root RPM های Edge را روی گره نصب کرد، کاربر با دسترسی کامل sudo به کاربر "apigee" فرآیند پیکربندی را تکمیل می کند:
    1. از ابزار setup.sh برای تکمیل پیکربندی اجزای 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 UI را در هر گره ای که روی آن اجرا می شود، مجدداً راه اندازی کنید.

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

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

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

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

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

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

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

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

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

رفع وابستگی نصب RPM

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

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

دستورات رایج یام

ابزارهای نصب Edge برای لینوکس به 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 استفاده می کند.

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

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

فایل های گزارش برای هر جزء در پوشه /opt/apigee/var/log موجود است. هر کامپوننت زیرشاخه مخصوص به خود را دارد. به عنوان مثال، گزارش‌های مربوط به سرور مدیریت در دایرکتوری قرار دارند:

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

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

جزء مکان

سرور مدیریت

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

روتر

 /opt/apigee/var/log/edge-router

Edge Router با استفاده از Nginx پیاده سازی شده است. برای گزارش های اضافی، نگاه کنید به:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

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

 /opt/apigee/var/log/edge-message-processor

سرور Apigee Qpid

 /opt/apigee/var/log/edge-qpid-server
سرور Apigee Postgres /opt/apigee/var/log/edge-postgres-server
رابط کاربری کلاسیک (نه رابط کاربری Edge جدید که نام مؤلفه آن edge-management-ui است) /opt/apigee/var/log/edge-ui
باغ وحش /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
کاساندرا /opt/apigee/var/log/apigee-cassandra/system.log
Qpidd /opt/apigee/var/log/apigee-qpidd
پایگاه داده PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

داده ها

جزء مکان
سرور مدیریت /opt/apigee/data/edge-management-server
روتر /opt/apigee/data/edge-router
پردازشگر پیام /opt/apigee/data/edge-message-processor
عامل Apigee Qpid /opt/apigee/data/edge-qpid-server
نماینده Apigee Postgres /opt/apigee/data/edge-postgres-server
باغ وحش /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
کاساندرا /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
پایگاه داده PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

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

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

ENABLE_SYSTEM_CHECK=y

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

،

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

فرآیند نصب

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

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

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

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

    به نصب اجزای لبه روی یک گره مراجعه کنید.

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

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

  8. همانطور که در مثال زیر نشان داده شده است، پس از اتمام نصب، مؤلفه Classic UI را در هر گره مجدداً راه اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (توصیه می شود) پس از اتمام نصب اولیه، Apigee توصیه می کند که رابط کاربری جدید Edge (که نام مؤلفه آن edge-management-ui است) را نصب کنید که یک رابط کاربری پیشرفته برای توسعه دهندگان و مدیران Apigee Edge برای Private Cloud است.

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

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

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

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

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

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

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

هر کاربری که بخواهد همه دستورات دیگر را غیر از دستورات نشان داده شده در بالا اجرا کند، باید کاربری با دسترسی کامل sudo به کاربر "apigee" باشد. این دستورات عبارتند از:

  • دستورات کاربردی apigee-service ، از جمله:
    • دستورات apigee-service مانند start, stop, restart, configure .
    • apigee-همه دستورات مانند 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. مالک فایل را به "apigee:apigee" chown یا اگر کاربری که سرویس Edge را اجرا می کند از کاربر "apigee" تغییر داده اید، فایل را برای کاربری که سرویس Edge را اجرا می کند، انتخاب کنید.

جداسازی وظایف نصب Edge بین کاربر روت و غیر روت

در حالی که اجرای کل فرآیند نصب Edge به صورت روت یا توسط کاربری که دسترسی کامل به sudo دارد ساده‌ترین کار است، اما همیشه این امکان وجود ندارد. در عوض، می‌توانید فرآیند را به وظایفی که توسط روت انجام می‌شوند و کارهایی که توسط کاربر با دسترسی کامل sudo به کاربر "apigee" انجام می‌شود، جدا کنید.

  1. وظایف انجام شده توسط روت:
    1. فایل bootstrap_4.53.00.sh را دانلود و اجرا کنید: 
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
sudo bash /tmp/bootstrap_4.53.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

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

  2. پس از اینکه کاربر root RPM های Edge را روی گره نصب کرد، کاربر با دسترسی کامل sudo به کاربر "apigee" فرآیند پیکربندی را تکمیل می کند:
    1. از ابزار setup.sh برای تکمیل پیکربندی اجزای 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 .

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

برای اطلاعات بیشتر به اجزای نصب Edge روی یک گره مراجعه کنید.

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

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

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

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

برای نصب لبه روی یک گره ، گره باید بتواند به مخزن Apigee دسترسی پیدا کند:

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

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

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

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

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

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

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

حل وابستگی های نصب RPM

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

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

دستورات یوم مشترک

ابزارهای نصب Edge برای لینوکس برای نصب و به روزرسانی قطعات به YUM متکی هستند. ممکن است برای مدیریت نصب روی یک گره از چندین دستور YUM استفاده کنید.

  • تمام انبارهای یوم را تمیز کنید: 
    sudo yum clean all
  • برای به روزرسانی یک مؤلفه لبه: 
    sudo yum update componentName

    به عنوان مثال: 

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

ساختار سیستم پرونده

Edge تمام پرونده ها را در فهرست /opt/apigee نصب می کند.

در این راهنما و در راهنمای عملیات Edge ، فهرست نصب ریشه به این شرح داده شده است:

/opt/apigee

نصب از ساختار سیستم فایل زیر برای استقرار لبه Apigee برای ابر خصوصی استفاده می کند.

پرونده ها

پرونده ورود به سیستم برای apigee-setup و script setup.sh به /tmp/setup-root.log نوشته شده است.

پرونده های ورود به سیستم برای هر مؤلفه در فهرست /opt/apigee/var/log موجود است. هر مؤلفه زیر مجموعه خاص خود را دارد. به عنوان مثال ، سیاهههای مربوط به سرور مدیریت در فهرست قرار دارند:

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

در جدول های زیر محل پرونده های ورود به سیستم لیست شده است:

جزء مکان

سرور مدیریت

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

روتر

 /opt/apigee/var/log/edge-router

روتر Edge با استفاده از NGINX اجرا می شود. برای گزارش های اضافی ، به:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

پردازنده پیام

 /opt/apigee/var/log/edge-message-processor

سرور QPID Apigee

 /opt/apigee/var/log/edge-qpid-server
سرور Apigee Postgres /opt/apigee/var/log/edge-postgres-server
UI کلاسیک (نه Edge UI جدید ، که نام آن نام جزء edge-management-ui است) /opt/apigee/var/log/edge-ui
باغ وحش /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
کاساندرا /opt/apigee/var/log/apigee-cassandra/system.log
qpidd /opt/apigee/var/log/apigee-qpidd
پایگاه داده postgresql /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

داده ها

جزء مکان
سرور مدیریت /opt/apigee/data/edge-management-server
روتر /opt/apigee/data/edge-router
پردازنده پیام /opt/apigee/data/edge-message-processor
عامل qpid apigee /opt/apigee/data/edge-qpid-server
نماینده Apigee Postgres /opt/apigee/data/edge-postgres-server
باغ وحش /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
کاساندرا /opt/apigee/data/apigee-cassandra/data
qpidd /opt/apigee/data/apigee-qpid/data
پایگاه داده postgresql /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

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

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

ENABLE_SYSTEM_CHECK=y

اگر این ویژگی را روی "y" تنظیم کنید ، نصب کننده بررسی می کند که سیستم با CPU و نیازهای حافظه برای مؤلفه نصب شده مطابقت دارد. مقدار پیش فرض "N" برای غیرفعال کردن چک است.

،

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

فرآیند نصب

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

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

      برای اطلاعات بیشتر به نصب ابزار Edge Apigee-Setup مراجعه کنید.

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

    اجزای Edge را روی یک گره مشاهده کنید.

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

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

  8. بعد از اتمام نصب ، مؤلفه کلاسیک UI را روی هر گره مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (توصیه می شود) پس از اتمام نصب اولیه ، Apigee توصیه می کند UI Edge New Edge را نصب کنید (نام جزء آنها edge-management-ui است) ، که یک رابط کاربری پیشرفته برای توسعه دهندگان و سرپرستان Apigee Edge برای Cloud Private است.

    برای اطلاعات بیشتر ، به نصب UI Edge جدید مراجعه کنید.

پس از اتمام نصب ، این لیست از اقدامات مشترک پس از نصب را بررسی کنید.

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

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

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

  • ابزار خدمات Apigee :
    • دستورات Apigee-Service : install, uninstall, update .
    • دستورات APIGEE-ALL : install, uninstall, update .
  • Setup.sh Script برای نصب اجزای Edge (مگر اینکه قبلاً از " apigee-service install " برای نصب RPM های مورد نیاز استفاده کرده باشید. در صورت لزوم دسترسی به ریشه یا کامل SUDO.)
  • Script Update.sh برای به روزرسانی اجزای Edge

همچنین ، Edge Installer کاربر جدیدی را در سیستم شما با نام "Apigee" ایجاد می کند. بسیاری از دستورات Edge از SUDO دعوت می کنند تا به عنوان کاربر "Apigee" اجرا شوند.

هر کاربری که می خواهد تمام دستورات دیگر را نسبت به مواردی که در بالا نشان داده شده است اجرا کند ، باید کاربر با دسترسی کامل به سودو به کاربر "apigee" باشد. این دستورات عبارتند از:

  • دستورات ابزار خدمات Apigee ، از جمله:
    • دستورات خدمات Apigee مانند start, stop, restart, configure .
    • دستورات Apigee-ALL مانند start, stop, restart, configure .

ایجاد یک کاربر با دسترسی کامل به سودو به کاربر "apigee"

برای پیکربندی یک کاربر برای دسترسی کامل به سودو به کاربر "Apigee" ، از دستور "Visudo" برای ویرایش پرونده sudoers برای افزودن استفاده کنید:

installUser        ALL=(apigee)      NOPASSWD: ALL

جایی که installUser نام کاربری شخصی است که با Edge کار می کند.

تنظیم مجوزها در پرونده های پیکربندی

هر پرونده یا منابع مورد استفاده توسط دستورات Edge باید برای کاربر "Apigee" قابل دسترسی باشد. این شامل پرونده مجوز Edge و هر پرونده پیکربندی است.

هنگام ایجاد یک فایل پیکربندی ، می توانید صاحب آن را به "Apigee: Apigee" تغییر دهید تا از دسترسی به دستورات Edge اطمینان حاصل شود:

  1. پرونده را به عنوان هر کاربر در یک ویرایشگر ایجاد کنید.
  2. صاحب پرونده به "Apigee: Apigee" یا اگر کاربر را تغییر دادید که سرویس Edge را از کاربر "Apigee" اجرا می کند ، پرونده را به کاربر که سرویس Edge را اجرا می کند ، تغییر chown .

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

در حالی که انجام کل فرآیند نصب Edge به عنوان ریشه یا توسط کاربر که دسترسی کامل به سودو را دارد ساده ترین است ، اما همیشه امکان پذیر نیست. درعوض ، می توانید فرآیند را به وظایف انجام شده توسط root و وظایف انجام شده توسط یک کاربر با دسترسی کامل سودو به کاربر "apigee" انجام دهید.

  1. وظایف انجام شده توسط root:
    1. پرونده bootstrap_4.53.00.sh را بارگیری و اجرا کنید: 
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
sudo bash /tmp/bootstrap_4.53.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. برای نصب RPM های لبه بر روی گره از ابزار apigee-setup استفاده کنید: 
      /opt/apigee/apigee-service/bin/apigee-service compName install

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

  2. بعد از اینکه کاربر root لبه های لبه را روی گره نصب کرد ، کاربر با دسترسی کامل به سودو به کاربر "apigee" فرآیند پیکربندی را تکمیل می کند:
    1. برای تکمیل پیکربندی اجزای لبه روی گره از ابزار setup.sh استفاده کنید. شکل این دستور به مؤلفه هایی که روی گره نصب کرده اید بستگی دارد. برای یک لیست کامل ، به اجزای نصب 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 .

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

برای اطلاعات بیشتر به اجزای نصب Edge روی یک گره مراجعه کنید.

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

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

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

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

برای نصب لبه روی یک گره ، گره باید بتواند به مخزن Apigee دسترسی پیدا کند:

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

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

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

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

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

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

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

حل وابستگی های نصب RPM

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

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

دستورات یوم مشترک

ابزارهای نصب Edge برای لینوکس برای نصب و به روزرسانی قطعات به YUM متکی هستند. ممکن است برای مدیریت نصب روی یک گره از چندین دستور YUM استفاده کنید.

  • تمام انبارهای یوم را تمیز کنید: 
    sudo yum clean all
  • برای به روزرسانی یک مؤلفه لبه: 
    sudo yum update componentName

    به عنوان مثال: 

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

ساختار سیستم پرونده

Edge تمام پرونده ها را در فهرست /opt/apigee نصب می کند.

در این راهنما و در راهنمای عملیات Edge ، فهرست نصب ریشه به این شرح داده شده است:

/opt/apigee

نصب از ساختار سیستم فایل زیر برای استقرار لبه Apigee برای ابر خصوصی استفاده می کند.

پرونده ها

پرونده ورود به سیستم برای apigee-setup و script setup.sh به /tmp/setup-root.log نوشته شده است.

پرونده های ورود به سیستم برای هر مؤلفه در فهرست /opt/apigee/var/log موجود است. هر مؤلفه زیر مجموعه خاص خود را دارد. به عنوان مثال ، سیاهههای مربوط به سرور مدیریت در فهرست قرار دارند:

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

در جدول های زیر محل پرونده های ورود به سیستم لیست شده است:

جزء مکان

سرور مدیریت

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

روتر

 /opt/apigee/var/log/edge-router

روتر Edge با استفاده از NGINX اجرا می شود. برای گزارش های اضافی ، به:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

پردازنده پیام

 /opt/apigee/var/log/edge-message-processor

سرور QPID Apigee

 /opt/apigee/var/log/edge-qpid-server
سرور Apigee Postgres /opt/apigee/var/log/edge-postgres-server
UI کلاسیک (نه Edge UI جدید ، که نام آن نام جزء edge-management-ui است) /opt/apigee/var/log/edge-ui
باغ وحش /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
کاساندرا /opt/apigee/var/log/apigee-cassandra/system.log
qpidd /opt/apigee/var/log/apigee-qpidd
پایگاه داده postgresql /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

داده ها

جزء مکان
سرور مدیریت /opt/apigee/data/edge-management-server
روتر /opt/apigee/data/edge-router
پردازنده پیام /opt/apigee/data/edge-message-processor
عامل qpid apigee /opt/apigee/data/edge-qpid-server
نماینده Apigee Postgres /opt/apigee/data/edge-postgres-server
باغ وحش /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
کاساندرا /opt/apigee/data/apigee-cassandra/data
qpidd /opt/apigee/data/apigee-qpid/data
پایگاه داده postgresql /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

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

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

ENABLE_SYSTEM_CHECK=y

اگر این ویژگی را روی "Y" تنظیم کنید ، نصب کننده بررسی می کند که سیستم با CPU و نیازهای حافظه برای مؤلفه نصب شده را برآورده می کند. مقدار پیش فرض "N" برای غیرفعال کردن چک است.