الزامات نصب، الزامات نصب

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

شما باید حداقل الزامات سخت‌افزاری زیر را برای یک زیرساخت با قابلیت دسترسی بالا در یک محیط عملیاتی برآورده کنید.

ویدیوی زیر راهنمایی‌های جامعی در مورد اندازه‌های نصب به شما ارائه می‌دهد:

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

در این جداول، الزامات هارد دیسک علاوه بر فضای هارد دیسک مورد نیاز سیستم عامل ذکر شده است. بسته به برنامه‌ها و ترافیک شبکه شما، نصب شما ممکن است به منابع بیشتر یا کمتری از آنچه در زیر ذکر شده است، نیاز داشته باشد.

علاوه بر این، در صورت تمایل به نصب سرویس‌های کسب درآمد (که در نصب All-in-One پشتیبانی نمی‌شوند)، موارد زیر نیازمندی‌های سخت‌افزاری را فهرست می‌کنند:

الزامات پهنای باند شبکه کاساندرا

کاساندرا از پروتکل Gossip برای تبادل اطلاعات با سایر گره‌ها در مورد توپولوژی شبکه استفاده می‌کند. استفاده از Gossip، همراه با ماهیت توزیع‌شده کاساندرا - که شامل ارتباط با چندین گره برای عملیات خواندن و نوشتن است - منجر به انتقال داده‌های قابل توجهی در سراسر شبکه می‌شود.

کاساندرا به حداقل پهنای باند شبکه ۱ گیگابیت بر ثانیه برای هر گره نیاز دارد. برای نصب‌های عملیاتی، پهنای باند بالاتری توصیه می‌شود.

حداکثر یا ۹۹ درصد تأخیر برای کاساندرا باید زیر ۱۰۰ میلی‌ثانیه باشد.

الزامات سیستم عامل و نرم‌افزارهای شخص ثالث

این دستورالعمل‌های نصب و فایل‌های نصب ارائه شده روی سیستم عامل‌ها و نرم‌افزارهای شخص ثالث ذکر شده در بخش نرم‌افزارهای پشتیبانی‌شده و نسخه‌های پشتیبانی‌شده آزمایش شده‌اند.

پیش‌نیاز: فعال کردن مخزن EPEL

قبل از ادامه نصب، مطمئن شوید که مخزن EPEL (بسته‌های اضافی برای لینوکس سازمانی) فعال است. از دستورات زیر بر اساس نسخه سیستم عامل خود استفاده کنید:

• برای Red Hat/CentOS/Oracle 8.X:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

  sudo rpm -ivh epel-release-latest-8.noarch.rpm

• برای Red Hat/CentOS/Oracle 9.X:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

  sudo rpm -ivh epel-release-latest-9.noarch.rpm

جاوا

قبل از نصب، به یک نسخه پشتیبانی‌شده از جاوا ۱.۸ روی هر دستگاه نیاز دارید. JDKهای پشتیبانی‌شده در بخش نرم‌افزارهای پشتیبانی‌شده و نسخه‌های پشتیبانی‌شده فهرست شده‌اند.

مطمئن شوید که متغیر محیطی JAVA_HOME برای کاربری که نصب را انجام می‌دهد، به ریشه JDK اشاره می‌کند.

SELinux

بسته به تنظیمات شما برای SELinux، مرورگر اج می‌تواند در نصب و راه‌اندازی اجزای اج با مشکلاتی مواجه شود. در صورت لزوم، می‌توانید SELinux را غیرفعال کنید یا آن را در حین نصب روی حالت مجاز تنظیم کنید و پس از نصب دوباره آن را فعال کنید. برای اطلاعات بیشتر به نصب ابزار apigee-setup اج مراجعه کنید.

ایجاد کاربر 'apigee'

مراحل نصب، یک کاربر سیستم یونیکس به نام 'apigee' ایجاد می‌کند. دایرکتوری‌ها و فایل‌های Edge و همچنین فرآیندهای Edge متعلق به 'apigee' هستند. این بدان معناست که اجزای Edge به عنوان کاربر 'apigee' اجرا می‌شوند. در صورت لزوم، می‌توانید اجزا را به عنوان یک کاربر دیگر اجرا کنید.

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

به طور پیش‌فرض، نصب‌کننده تمام فایل‌ها را در دایرکتوری /opt/apigee می‌نویسد. شما نمی‌توانید مکان این دایرکتوری را تغییر دهید. اگرچه نمی‌توانید این دایرکتوری را تغییر دهید، می‌توانید یک symlink برای نگاشت /opt/apigee به مکان دیگری ایجاد کنید، همانطور که در بخش ایجاد یک symlink از /opt/apigee توضیح داده شده است.

در دستورالعمل‌های این راهنما، دایرکتوری نصب به صورت /opt/apigee ذکر شده است.

ایجاد یک پیوند نمادین از /opt/apigee

قبل از ایجاد سیملینک، ابتدا باید یک کاربر و گروه به نام "apigee" ایجاد کنید. این همان گروه و کاربری است که توسط نصاب Edge ایجاد شده است.

برای ایجاد سیملینک، قبل از دانلود فایل bootstrap_4.53.01.sh، این مراحل را انجام دهید. شما باید تمام این مراحل را با دسترسی root انجام دهید:

1. کاربر و گروه "apigee" را ایجاد کنید:

   groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee

2. یک لینک نمادین از /opt/apigee به ریشه نصب مورد نظر خود ایجاد کنید:

   ln -Ts /srv/myInstallDir /opt/apigee

   که در آن /srv/myInstallDir محل مورد نظر برای فایل‌های Edge است.

3. مالکیت ریشه نصب و لینک نمادین را به کاربر "apigee" تغییر دهید:

   chown -h apigee:apigee /srv/myInstallDir /opt/apigee

تنظیمات شبکه

شرکت Apigee توصیه می‌کند که قبل از نصب، تنظیمات شبکه را بررسی کنید. نصب‌کننده انتظار دارد که همه دستگاه‌ها آدرس IP ثابتی داشته باشند. برای تأیید تنظیمات از دستورات زیر استفاده کنید:

• hostname نام دستگاه را برمی‌گرداند
• hostname -i آدرس IP مربوط به نام میزبان را که می‌تواند از سایر ماشین‌ها آدرس‌دهی شود، برمی‌گرداند.

بسته به نوع و نسخه سیستم عامل شما، اگر نام میزبان به درستی تنظیم نشده باشد، ممکن است لازم باشد /etc/hosts و /etc/sysconfig/network ویرایش کنید. برای اطلاعات بیشتر به مستندات مربوط به سیستم عامل خاص خود مراجعه کنید.

اگر یک سرور چندین کارت رابط داشته باشد، دستور "hostname -i" لیستی از آدرس‌های IP را که با فاصله از هم جدا شده‌اند، برمی‌گرداند. به طور پیش‌فرض، نصب‌کننده Edge از اولین آدرس IP برگردانده شده استفاده می‌کند که ممکن است در همه شرایط صحیح نباشد. به عنوان یک جایگزین، می‌توانید ویژگی زیر را در فایل پیکربندی نصب تنظیم کنید:

ENABLE_DYNAMIC_HOSTIP=y

با تنظیم این ویژگی روی "y"، نصب‌کننده از شما می‌خواهد که آدرس IP مورد استفاده در فرآیند نصب را انتخاب کنید. مقدار پیش‌فرض "n" است. برای اطلاعات بیشتر به مرجع فایل پیکربندی Edge مراجعه کنید.

بسته‌بندی‌های TCP

بسته‌های TCP می‌توانند ارتباط برخی از پورت‌ها را مسدود کنند و بر نصب OpenLDAP، Postgres و Cassandra تأثیر بگذارند. در آن گره‌ها، /etc/hosts.allow و /etc/hosts.deny را بررسی کنید تا مطمئن شوید که هیچ محدودیت پورتی روی پورت‌های مورد نیاز OpenLDAP، Postgres و Cassandra وجود ندارد.

آی‌پی‌تیبل‌ها

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

sudo/etc/init.d/iptables stop

دسترسی به دایرکتوری

جدول زیر فهرست دایرکتوری‌های روی گره‌های Edge را که الزامات خاصی از فرآیندهای Edge دارند، نشان می‌دهد:

کاساندرا

همه گره‌های کاساندرا باید به یک حلقه متصل باشند. کاساندرا کپی‌های داده‌ها را روی چندین گره ذخیره می‌کند تا قابلیت اطمینان و تحمل خطا را تضمین کند. استراتژی تکثیر برای هر فضای کلید Edge، گره‌های کاساندرا را که کپی‌ها در آنها قرار می‌گیرند، تعیین می‌کند. برای اطلاعات بیشتر، به «درباره ضریب تکثیر کاساندرا و سطح سازگاری» مراجعه کنید.

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

پس از نصب Edge برای Private Cloud، می‌توانید با بررسی فایل /opt/apigee/apigee-cassandra/conf/cassandra.yaml از پیکربندی صحیح Cassandra اطمینان حاصل کنید. به عنوان مثال، مطمئن شوید که اسکریپت نصب Edge برای Private Cloud ویژگی‌های زیر را تنظیم کرده است:

• cluster_name
• initial_token
• partitioner
• seeds
• listen_address
• rpc_address
• snitch

پایگاه داده پستگرس‌کیوال

پس از نصب Edge، می‌توانید تنظیمات پایگاه داده PostgreSQL زیر را بر اساس میزان رم موجود در سیستم خود تنظیم کنید:

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

برای تنظیم این مقادیر:

1. فایل postgresql.properties را ویرایش کنید:

   vi /opt/apigee/customer/application/postgresql.properties

   اگر فایل وجود ندارد، آن را ایجاد کنید.

2. ویژگی‌های ذکر شده در بالا را تنظیم کنید.
3. ویرایش‌های خود را ذخیره کنید.
4. پایگاه داده PostgreSQL را مجدداً راه اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

پیکربندی محلی برای Rocky 9.X

اگر از Rocky 9.X استفاده می‌کنید، مطمئن شوید که سیستم شما با LANG=en_US.utf8 در تنظیمات محلی سیستم پیکربندی شده است. برای پیکربندی این مورد، دستورات زیر را اجرا کنید:

dnf -y -q install langpacks-en
localectl set-locale LANG=en_US.utf8
reboot

محدودیت‌های سیستم

مطمئن شوید که محدودیت‌های سیستمی زیر را روی گره‌های کاساندرا و پردازنده پیام تنظیم کرده‌اید:

• در گره‌های کاساندرا، محدودیت‌های نرم‌افزاری و سخت‌افزاری memlock، nofile و فضای آدرس (as) را برای کاربر نصب (پیش‌فرض "apigee" است) در /etc/security/limits.d/90-apigee-edge-limits.conf مطابق شکل زیر تنظیم کنید:

  apigee soft memlock unlimited
  apigee hard memlock unlimited
  apigee soft nofile 32768
  apigee hard nofile 65536
  apigee soft as unlimited
  apigee hard as unlimited
  apigee soft nproc 32768
  apigee hard nproc 65536

• در گره‌های پردازشگر پیام، حداکثر تعداد توصیف‌گرهای فایل باز را در /etc/security/limits.d/90-apigee-edge-limits.conf مطابق شکل زیر روی ۶۴ کیلوبایت تنظیم کنید:

  apigee soft nofile 32768
  apigee hard nofile 65536

  در صورت لزوم، می‌توانید آن محدودیت را افزایش دهید. به عنوان مثال، اگر تعداد زیادی فایل موقت را همزمان باز دارید.

• اگر تا به حال خطای زیر را در system.log روتر یا پردازشگر پیام مشاهده کردید، ممکن است محدودیت‌های توصیف‌گر فایل شما خیلی کم تنظیم شده باشد:

  "java.io.IOException: Too many open files"

  می‌توانید محدودیت‌های کاربر خود را با اجرای دستور زیر بررسی کنید:

  # su - apigee
  $ ulimit -n
  100000
  

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

خدمات امنیت شبکه (NSS)

سرویس‌های امنیت شبکه (NSS) مجموعه‌ای از کتابخانه‌ها هستند که از توسعه برنامه‌های کلاینت و سرور با قابلیت امنیتی پشتیبانی می‌کنند. شما باید مطمئن شوید که NSS نسخه ۳.۱۹ یا بالاتر را نصب کرده‌اید.

برای بررسی نسخه فعلی خود:

yum info nss

برای به‌روزرسانی NSS:

yum update nss

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

غیرفعال کردن جستجوی DNS در IPv6 هنگام استفاده از NSCD (Name Service Cache Daemon)

اگر NSCD (Name Service Cache Daemon) را نصب و فعال کرده باشید، پردازشگرهای پیام دو جستجوی DNS انجام می‌دهند: یکی برای IPv4 و دیگری برای IPv6. هنگام استفاده از NSCD، باید جستجوی DNS را روی IPv6 غیرفعال کنید.

برای غیرفعال کردن جستجوی DNS در IPv6:

1. در هر گره پردازشگر پیام، فایل /etc/nscd.conf را ویرایش کنید.
2. ویژگی زیر را تنظیم کنید:

   enable-cache hosts no

غیرفعال کردن IPv6 در RHEL 8 و بالاتر

اگر Edge را روی RHEL 8 یا نسخه‌های بعدی در Google Cloud Platform نصب می‌کنید، باید IPv6 را روی تمام گره‌های Qpid غیرفعال کنید.

برای دستورالعمل‌های غیرفعال کردن IPv6، لطفاً به مستندات ارائه شده توسط فروشنده سیستم عامل خود مراجعه کنید. به عنوان مثال، می‌توانید اطلاعات مربوطه را در مستندات Red Hat Enterprise Linux بیابید.

پیش‌نیازهای آمازون لینوکس

قبل از انجام نصب جدید روی آمازون لینوکس 2023.7/2023.8/2023.9 ​​یا ارتقاء از 4.52.02 به 4.53.01 (روی آمازون لینوکس 2023.7/2023.8/2023.9)، فایل /etc/yum.repos.d/amazonlinux.repo را ویرایش کنید. بخشی که شامل [amazonlinux] است باید شامل موارد زیر باشد تا اطمینان حاصل شود که بسته‌ها از apigee-thirdparty دانلود شده‌اند و نه از آمازون: exclude=postgresql17 , luajit* .

ابزارها

نصب‌کننده از ابزارهای یونیکس زیر در نسخه استاندارد که توسط EL5 یا EL6 ارائه شده‌اند، استفاده می‌کند.

همگام‌سازی زمان

شرکت Apigee توصیه می‌کند که زمان سرورهای شما همگام‌سازی شود. اگر از قبل پیکربندی نشده باشد، ابزار ntpdate یا ابزاری معادل آن می‌تواند با تأیید همگام‌سازی زمانی سرورها، این هدف را برآورده کند. به عنوان مثال، می‌توانید از دستور yum install ntp یا دستوری معادل آن برای نصب این ابزار استفاده کنید. این امر به ویژه برای تکرار تنظیمات LDAP مفید است. لطفاً توجه داشته باشید که باید منطقه زمانی سرور را روی UTC تنظیم کنید.

فایروال‌ها و میزبان‌های مجازی

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

• ماشین‌های مجازی (VM) : الزامی نیست، اما برخی از پیاده‌سازی‌ها از فناوری VM برای ایجاد سرورهای ایزوله برای اجزای Apigee خود استفاده می‌کنند. میزبان‌های VM، مانند میزبان‌های فیزیکی، می‌توانند رابط‌های شبکه و فایروال داشته باشند.
• میزبان‌های مجازی : نقاط پایانی وب، مشابه یک میزبان مجازی آپاچی.

یک روتر در یک ماشین مجازی می‌تواند میزبان‌های مجازی متعددی را در معرض نمایش قرار دهد (تا زمانی که نام مستعار میزبان یا پورت رابط آنها با یکدیگر متفاوت باشد).

به عنوان مثالی از نامگذاری، یک سرور فیزیکی A ممکن است دو ماشین مجازی با نام‌های "VM1" و "VM2" را اجرا کند. فرض کنید "VM1" یک رابط اترنت مجازی را در معرض نمایش قرار می‌دهد که در داخل ماشین مجازی "eth0" نامگذاری می‌شود و آدرس IP آن توسط ماشین مجازی‌سازی یا یک سرور DHCP شبکه 111.111.111.111 تعیین می‌شود؛ و سپس فرض کنید VM2 یک رابط اترنت مجازی را نیز با نام "eth0" در معرض نمایش قرار می‌دهد و آدرس IP آن 111.111.111.222 تعیین می‌شود.

ممکن است یک روتر Apigee در هر یک از دو ماشین مجازی داشته باشیم. روترها نقاط پایانی میزبان مجازی را مانند این مثال فرضی در معرض نمایش قرار می‌دهند:

روتر Apigee در VM1 سه میزبان مجازی را روی رابط eth0 خود (که دارای آدرس IP خاصی است) نمایش می‌دهد: api.mycompany.com:80 ، api.mycompany.com:443 و test.mycompany.com:80 .

روتر موجود در VM2 آدرس api.mycompany.com:80 را نمایش می‌دهد (همان نام و پورتی که توسط VM1 نمایش داده شده بود).

سیستم عامل میزبان فیزیکی ممکن است دارای یک فایروال شبکه باشد؛ در این صورت، آن فایروال باید طوری پیکربندی شود که ترافیک TCP را برای پورت‌های در معرض دید در رابط‌های مجازی ( 111.111.111.111:{80, 443} و 111.111.111.222:80 ) عبور دهد. علاوه بر این، هر سیستم عامل ماشین مجازی ممکن است فایروال مخصوص به خود را در رابط eth0 خود ارائه دهد و این پورت‌ها نیز باید به ترافیک پورت‌های 80 و 443 اجازه اتصال دهند.

مسیر پایه سومین مؤلفه‌ای است که در مسیریابی فراخوانی‌های API به پروکسی‌های API مختلفی که ممکن است مستقر کرده باشید، نقش دارد. بسته‌های پروکسی API در صورت داشتن مسیرهای پایه مختلف، می‌توانند یک نقطه پایانی مشترک داشته باشند. به عنوان مثال، یک مسیر پایه می‌تواند به صورت http://api.mycompany.com:80/ و دیگری به صورت http://api.mycompany.com:80/salesdemo تعریف شود.

در این حالت، شما به یک متعادل‌کننده بار یا نوعی مدیر ترافیک نیاز دارید که ترافیک http://api.mycompany.com:80/ را بین دو آدرس IP ( 111.111.111.111 در VM1 و 111.111.111.222 در VM2) تقسیم کند. این عملکرد مختص نصب خاص شما است و توسط گروه شبکه محلی شما پیکربندی می‌شود.

مسیر پایه هنگام استقرار یک API تنظیم می‌شود. از مثال بالا، می‌توانید دو API، mycompany و testmycompany ، را برای سازمان mycompany-org با میزبان مجازی که نام مستعار میزبان api.mycompany.com و پورت تنظیم شده روی 80 دارد، مستقر کنید. اگر در هنگام استقرار، مسیر پایه را اعلام نکنید، روتر نمی‌داند درخواست‌های ورودی را به کدام API ارسال کند.

با این حال، اگر API testmycompany با آدرس پایه /salesdemo مستقر کنید، کاربران با استفاده از http://api.mycompany.com:80/salesdemo به آن API دسترسی پیدا می‌کنند. اگر API mycompany خود را با آدرس پایه / مستقر کنید، کاربران شما با آدرس http://api.mycompany.com:80/ به API دسترسی پیدا می‌کنند.

صدور مجوز

هر نصب Edge به یک فایل مجوز منحصر به فرد نیاز دارد که از Apigee دریافت می‌کنید. هنگام نصب سرور مدیریت، باید مسیر فایل مجوز را ارائه دهید، به عنوان مثال /tmp/license.txt.

نصب‌کننده، فایل لایسنس را در /opt/apigee/customer/conf/license.txt کپی می‌کند.

اگر فایل لایسنس معتبر باشد، سرور مدیریت، تاریخ انقضا و تعداد پردازنده پیام (MP) مجاز را تأیید می‌کند. اگر هر یک از تنظیمات لایسنس منقضی شده باشد، می‌توانید گزارش‌ها را در مسیر زیر پیدا کنید: /opt/apigee/var/log/edge-management-server/logs . در این صورت می‌توانید برای جزئیات مهاجرت با پشتیبانی Apigee Edge تماس بگیرید.

اگر هنوز مجوز ندارید، با Apigee Sales تماس بگیرید.