نمای کلی نصب Edge

Edge for Private Cloud نسخه ۴.۱۸.۰۱

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

فرایند نصب

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

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

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

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

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

• apigee-service utility:
  • فرمان‌های apigee-service: نصب، حذف نصب، به‌روزرسانی.
  • فرمان‌های apigee-all: نصب، حذف نصب، به‌روزرسانی.
• setup.sh script to install Edge components (Unless you have already used "apigee-service install" to install the required RPMs. سپس دسترسی sudo کامل یا ریشه درصورت نیاز.)
• update.sh script to update Edge components

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

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

• apigee-service فرمان‌های کمکی، ازجمله:
  • فرمان‌های apigee-service مانند شروع، توقف، بازراه‌اندازی، پیکربندی.
  • فرمان‌های apigee-all مانند شروع، توقف، بازراه‌اندازی، پیکربندی.

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

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

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

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

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

1. تکالیف انجام‌شده توسط root:
   1. فایل bootstrap_4.18.01.sh را بارگیری و اجرا کنید:؟؟
      > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
      
      این مرحله ابزار کمکی apigee-service را نصب می‌کند و کاربر «apigee» را ایجاد می‌کند.
   2. کاربری را پیکربندی کنید تا دسترسی sudo کامل به کاربر «apigee» داشته باشد، همان‌طور که در بالا توضیح داده شد.
   3. برنامه کمکی apigee-setup را نصب کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   4. از ابزار apigee-setup برای نصب Edge RPMs در گره استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service compName install
      
      Edge RPMs که در گره نصب می‌کنید به توپولوژی شما بستگی دارد. فهرست مؤلفه‌های دردسترس شامل این موارد است: apigee-provision،‏ apigee-validate،‏ apigee-zookeeper،‏ apigee-cassandra،‏ apigee-openldap،‏ edge-ui،‏ edge-management-server،‏ edge-ui،‏ edge-router،‏ edge-message-processor،‏ apigee-postgresql،‏ apigee-qpidd،‏ edge-postgres-server،‏ edge-qpid-server.
2. پس‌از اینکه کاربر ریشه Edge RPM را در گره نصب کرد، کاربر با دسترسی کامل 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» تغییر دهید.

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

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

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

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

نصب با اینترنت یا بدون اینترنت

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

• گره‌های دارای اتصال اینترنت خارجی
  
  گره‌های دارای اتصال اینترنت خارجی برای نصب RPMهای Edge و وابستگی‌ها به مخزن Apigee دسترسی دارند.
• گره‌های بدون اتصال اینترنت خارجی
  
  گره‌های بدون اتصال اینترنت خارجی می‌توانند به نسخه آینه‌ای مخزن Apigee که به‌صورت داخلی راه‌اندازی کرده‌اید دسترسی داشته باشند. این مخزن حاوی همه RPMهای Edge است، اما باید مطمئن شوید که همه وابستگی‌های دیگر را از مخازن موجود در شبکه داخلی دردسترس دارید.
  
  توجه: Apigee همه وابستگی‌های شخص ثالث را در مخازن عمومی ما میزبانی نمی‌کند. باید این وابستگی‌ها را از مخازن دردسترس عموم بارگیری و نصب کنید.
  
  برای ایجاد مخزن 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 انجام دهید.

پیکربندی مؤلفه‌های Edge پس‌از نصب

برای پیکربندی Edge پس‌از نصب، از ترکیبی از فایل‌های .properties و ابزارهای کمکی Edge استفاده می‌کنید. برای مثال، برای پیکربندی TLS/SSL در Edge UI، فایل‌های .properties را ویرایش می‌کنید تا ویژگی‌های لازم را تنظیم کنید. تغییرات در فایل‌های .properties مستلزم این است که جزء Edge تحت‌تأثیر قرارگرفته را بازراه‌اندازی کنید.

فایل‌های .properties در دایرکتوری /opt/apigee/customer/application قرار دارند. هر مؤلفه فایل .properties خودش را در آن فهرست راهنما دارد. برای مثال، router.properties و management-server.properties.

برای تنظیم ویژگی برای یک مؤلفه، فایل .properties مربوطه را ویرایش کنید، و سپس مؤلفه را بازراه‌اندازی کنید:

> /opt/apigee/apigee-service/bin/apigee-service component restart

برای مثال:

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

وقتی Edge را به‌روز می‌کنید، فایل‌های .properties در دایرکتوری /opt/apigee/customer/application خوانده می‌شوند. یعنی به‌روزرسانی هر ویژگی‌ای را که در مؤلفه تنظیم کرده‌اید حفظ می‌کند.

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

درحال فراخوانی فرمان‌ها در مؤلفه‌های Edge

Edge ابزارهای مدیریت را در /opt/apigee/apigee-service/bin نصب می‌کند که می‌توانید از آن‌ها برای مدیریت نصب Edge استفاده کنید. برای مثال، می‌توانید از ابزار کمکی apigee-all برای شروع، توقف، بازراه‌اندازی، یا تعیین وضعیت همه مؤلفه‌های Edge در گره استفاده کنید:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

از ابزار کمکی apigee-service برای کنترل و پیکربندی مؤلفه‌های جداگانه استفاده کنید. ابزار apigee-service این فرم را دارد:

/opt/apigee/apigee-service/bin/apigee-service component action

برای مثال، برای بازراه‌اندازی Edge Router:

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

می‌توانید فهرست مؤلفه‌های نصب‌شده در گره را با بررسی دایرکتوری /opt/apigee تعیین کنید. آن فهرست راهنما حاوی یک زیرفهرست راهنما برای هر مؤلفه Edge نصب‌شده در گره است. هر زیرفهرست راهنما با این پیشوند شروع می‌شود:

• apigee - مؤلفه شخص ثالثی که Edge از آن استفاده می‌کند. برای مثال، apigee-cassandra.
• edge - مؤلفه Edge از Apigee. برای مثال، edge-management-server.
• edge-mint - یک مؤلفه درآمدزایی. برای مثال edge-mint-management-server.
• baas - یک مؤلفه API BaaS. برای مثال baas-usergrid.

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

• شروع، توقف، بازراه‌اندازی
• وضعیت، نسخه
• پشتیبان‌گیری، بازیابی
• نصب، حذف نصب