الزامات نصب

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

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

ویدیو زیر راهنمایی کلی درباره اندازه‌گیری برای نصب ارائه می‌دهد:

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

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

علاوه‌براین، فهرست زیر الزامات سخت‌افزاری را درصورتی‌که بخواهید «سرویس‌های درآمدزایی» را نصب کنید (در نصب «همه در یک» پشتیبانی نمی‌شود) ارائه می‌دهد:

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

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

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

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

الزامات سیستم‌عامل و نرم‌افزار طرف سوم

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

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

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

• برای 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

جاوا

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

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

SELinux

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

درحال ایجاد کاربر «apigee»

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

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

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

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

درحال ایجاد پیوند نمادین از /opt/apigee

قبل‌از ایجاد پیوند نمادین، ابتدا باید کاربر و گروهی به‌نام «apigee» ایجاد کنید. این همان گروه و کاربری است که نصب‌کننده Edge ایجاد کرده است.

برای ایجاد پیوند نمادین، این مراحل را قبل‌از بارگیری فایل bootstrap_4.53.01.sh انجام دهید. باید همه این مراحل را به‌عنوان ریشه انجام دهید:

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

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

sudo/etc/init.d/iptables stop

دسترسی به فهرست راهنما

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

Cassandra

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

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

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

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

پایگاه داده PostgreSQL

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

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

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

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

• در گره‌های Cassandra، محدودیت‌های 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 را ببینید.

غیرفعال کردن جستجوی ساناد در IPv6 هنگام استفاده از NSCD (خدمات نام حافظه نهان)

اگر NSCD (خدمات نام حافظه نهان شیطان) را نصب و فعال کرده باشید، «پردازشگرهای پیام» دو جستجوی ساناد انجام می‌دهند: یکی برای IPv4 و دیگری برای IPv6. هنگام استفاده از NSCD، باید جستجوی ساناد را در IPv6 غیرفعال کنید.

برای غیرفعال کردن جستجوی ساناد در 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 پیدا کنید.

پیش‌نیازهای Amazon Linux

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

ابزارها

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

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

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

دیوارهای آتش و میزبان‌های مجازی

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

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

رهیاب در ماشین مجازی می‌تواند چندین میزبان مجازی را نمایان کند (به‌شرطی که در نام مستعار میزبان یا در درگاه واسط خود با یکدیگر متفاوت باشند).

به‌عنوان مثال نام‌گذاری، یک سرور فیزیکی واحد A ممکن است دو ماشین مجازی را اجرا کند که «VM1» و «VM2» نام‌گذاری شده‌اند. فرض کنیم «VM1» یک میانای اترنت مجازی را نمایان می‌کند که در داخل ماشین مجازی «eth0» نامیده می‌شود و نشانی IP 111.111.111.111 ازطریق ماشین مجازی‌سازی یا سرور DHCP شبکه به آن اختصاص داده می‌شود؛ و سپس فرض کنیم 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 ارائه دهد و این دیوار آتش‌ها نیز باید به ترافیک پورت‌های ۸۰ و ۴۴۳ اجازه دهند متصل شوند.

مسیر پایه سومین عنصر درگیر در مسیریابی تماس‌های 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 ارسال کند.

بااین‌حال، اگر میانای برنامه‌سازی کاربردی testmycompany را با نشانی وب پایه /salesdemo پیاده‌سازی کنید، کاربران بااستفاده از http://api.mycompany.com:80/salesdemo به آن میانای برنامه‌سازی کاربردی دسترسی پیدا می‌کنند. اگر API شرکت من را با نشانی وب پایه / پیاده‌سازی کنید، کاربرانتان با نشانی وب 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 تماس بگیرید.