الزامات درگاه «سرویس‌های توسعه‌دهنده»

Developer Services Portal v. 4.16.05

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

سخت‌افزار

الزام

سیستم‌عامل

این دستورالعمل‌های نصب و فایل‌های نصب ارائه‌شده در سیستم‌عامل‌های فهرست‌شده در اینجا آزمایش شده‌اند: https://apigee.com/docs/api-services/reference/supported-software

حافظه دسترسی تصادفی (RAM)

۱ گیگابایت

دیسک سخت

۱۰ گیگابایت

میانای شبکه

اتصال اینترنت فعال لازم است.

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

برای مثال، درخواست به https://drupal.org/ کد وضعیت HTTP 301 را برمی‌گرداند و به https://www.drupal.org/ هدایت می‌کند.

پراکسی شما باید به‌گونه‌ای پیکربندی شود که رمز وضعیت HTTP 200 را با محتوای درخواست‌شده از تغییرمسیر برگرداند.

برای نصب SAP، اگر محیط شما برای درخواست‌های HTTPS خروجی پراکسی راه‌اندازی شده است، پراکسی شما باید از TLSv1.0 پشتیبانی کند. OpenSSL 0.9.8 از TLSv1.1 یا TLSv1.2 پشتیبانی نمی‌کند، فقط از TLSv1.0 پشتیبانی می‌کند.

الزامات پایگاه داده MySQL

اگر تصمیم بگیرید MySQL Server را روی همان دستگاهی نصب کنید که Developer Channel Services نصب شده است (توپولوژی تک‌دستگاهی)، نصب‌کننده Developer Channel Services از شما می‌خواهد نام پایگاه داده و کاربر پایگاه داده را وارد کنید و سپس MySQL Server را نصب می‌کند و طرح‌واره پایگاه داده را برای شما ایجاد می‌کند. نسخه نصب‌شده جدیدترین نسخه دردسترس برای سیستم‌عامل شما است.

اگر می‌خواهید MySQL Server در سیستم جداگانه‌ای نصب شود، باید MySQL Server را پیش‌از شروع نصب‌کننده Developer Channel Services در آن سیستم نصب کرده باشید. باید MySQL نسخه ۵.۰.۱۵ یا بالاتر را نصب کرده باشید.

نصب‌کننده Developer Channel Services نیاز دارد که MySQL Server حاوی پایگاه داده‌ای با طرح‌واره پایگاه داده خالی باشد. نصب‌کننده Developer Channel Services از شما می‌خواهد نام میزبان پایگاه داده، نام پایگاه داده، و کاربر پایگاه داده را وارد کنید. سپس نصب‌کننده به پایگاه داده متصل می‌شود تا جدول‌ها و داده‌های پیش‌فرض پایگاه داده را ایجاد کند.

«سرویس‌های کانال توسعه‌دهنده» از کاربر پایگاه داده برای اتصال به پایگاه داده استفاده می‌کند و این کاربر باید امتیازات زیر را داشته باشد: SELECT،‏ INSERT،‏ UPDATE،‏ DELETE،‏ CREATE،‏ DROP،‏ INDEX،‏ ALTER،‏ CREATE TEMPORARY TABLES،‏ LOCK TABLES.

برای مثال، برای ایجاد پایگاه داده‌ای به‌نام devportal و کاربری به‌نام devportal:

  1. MySQL Server را در سیستم نصب کنید.
  2. بااستفاده از این فرمان، به‌عنوان کاربر ریشه به سیستم MySQL وارد شوید:
    > mysql -u root -p
  3. وقتی از شما خواسته شد، گذرواژه ریشه را وارد کنید.
  4. At the mysql> prompt, enter the following to create the devportal user:
    mysql>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  5. در پیام‌واره سیستم، پایگاه داده devportal را ایجاد کنید:
    > mysqladmin -u devportal -p create devportal

    گذرواژه devportal را وارد کنید.
  6. به MySQL وارد شوید و از IP سرور درگاه به devportal دسترسی اعطا کنید:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';

    که در آن portalIP نشانی IP سرور پورتال است و devportalPW گذرواژه کاربر devportal است.
  7. etc /my.cnf/را ویرایش کنید تا bind-address را روی نشانی IP سرور MySQL تنظیم کنید.
  8. MySQL را بازراه‌اندازی کنید:
    > /etc/init.d/mysqld restart
  9. مطمئن شوید درگاه ۳۳۰۶ در سرور MySQL باز باشد. این روش براساس سیستم‌عامل شما است. برای مثال، برای Linux، از این فرمان استفاده کنید:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

هنگام نصب Developer Channel Services، مشخص کنید که MySQL Server به‌صورت محلی نصب نشود. سپس از شما خواسته می‌شود نشانی IP، نام کاربری، و نام پایگاه داده پایگاه داده راه دور را وارد کنید.

الزامات Red Hat Enterprise Linux (RHEL)

RHEL الزامات بیشتری دارد زیرا برای دسترسی به بارگیری‌های نرم‌افزار از Red Hat به اشتراک نیاز است. سرور باید بتواند به اینترنت متصل شود تا RPMها را ازطریق yum بارگیری کند. اگر از RHEL استفاده می‌کنید، سرور باید در Red Hat Network (RHN) ثبت شده باشد و در کانال اختیاری سرور ثبت شده باشد.

الزامات Red Hat درطول نصب بررسی می‌شود و اگر RHEL ازقبل ثبت نشده باشد، نصب‌کننده درگاه از شما درخواست می‌کند. اگر ازقبل اعتبارنامه ورود به سیستم Red Hat دارید، می‌توانید از فرمان زیر برای ثبت RHEL قبل‌از شروع فرایند نصب استفاده کنید:

> subscription-manager register --username=my_username --password=my_password --auto-attach

my_username و my_password را با اطلاعات اعتباری Red Hat خودتان جایگزین کنید.

اگر نسخه آزمایشی RHEL را دارید، می‌توانید پروانه آزمایشی ۳۰ روزه دریافت کنید. برای اطلاعات بیشتر، به https://access.redhat.com/solutions/32790 مراجعه کنید.

الزامات SMTP

به‌طور پیش‌فرض، درگاه بااستفاده از تابع mail() PHP ایمیل ارسال می‌کند. PHP تلاش می‌کند بااستفاده از sendmail در سیستم محلی ایمیل ارسال کند، که می‌توان آن را در فایل php.ini در PHP پیکربندی کرد.

در محیط تولید، Apigee از شما می‌خواهد که سرور SMTP را برای ارسال پیام‌های ایمیل از پورتال پیکربندی کنید. بنابراین، باید مطمئن شوید که Drupal می‌تواند به درگاه لازم در سرور SMTP دسترسی داشته باشد. برای SMTP غیر TLS، شماره درگاه معمولاً ۲۵ است. برای SMTP با TLS فعال، اغلب ۴۶۵ است، اما با ارائه‌دهنده SMTP خود بررسی کنید.

الزامات اضافی

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

الزامات معماری استقرار

«سرویس‌های کانال توسعه‌دهنده» یک میانای واحد با «سرور مدیریت Apigee» ازطریق REST API دارد تا اطلاعات مربوط به برنامه‌های کاربر را ذخیره و بازیابی کند. Developer Channel Services باید بتواند ازطریق HTTP یا HTTPS به Management Server متصل شود، بسته به نصب شما.

اطلاعات موردنیاز قبل‌از شروع نصب

قبل‌از شروع نصب، باید اطلاعات زیر را دردسترس داشته باشید:

  1. کدام پلاتفرم را پیکربندی می‌کنید: Red Hat یا CentOS؟ اگر این نصب Red Hat است، دستگاه باید در Red Hat Network ثبت شده باشد تا RPMها را بارگیری کند.
  2. آیا قصد دارید MySQL را در ماشین محلی نصب کنید؟ برخی‌از نصب‌های HA نیاز دارند که MySQL در دستگاهی متفاوت از دستگاهی که صفحه‌های وب درگاه را ارائه می‌دهد قرار داشته باشد. اگر این‌طور است، MySQL را به‌صورت محلی نصب نکنید. اگر می‌خواهید نصب ساده‌ای داشته باشید که همه چیز در یک دستگاه باشد، MySQL را به‌صورت محلی نصب کنید.
  3. اگر قصد دارید به سرور MySQL ازراه‌دور دسترسی داشته باشید، نام میزبان، درگاه، نام پایگاه داده، نام کاربری، و گذرواژه سرور MySQL ازراه‌دور. سرور MySQL راه دور باید قبل‌از شروع نصب پیکربندی شده باشد.
  4. نام دامنه کاملاً واجدشرایط سرور وب چیست؟ (این اطلاعات به /etc/hosts اضافه خواهد شد.) این باید نشانی IP یا نام میزبان باشد، مثل portalserver.example.com. مقدار پیش‌فرض localhost است.
  5. آیا می‌خواهید از پیکربندی پیش‌فرض Apigee برای میزبان مجازی Apache استفاده کنید؟ یک میزبان مجازی با نام میزبانی که در مرحله ۷ بالا مشخص کرده‌اید ایجاد می‌شود.
  6. سه بخش اطلاعات وجود دارد که به درگاه شما اجازه می‌دهد با سرور مدیریت Apigee Edge ارتباط برقرار کند. این اطلاعات به‌شرح زیر است:
    1. نشانی وب نقطه پایانی Apigee Management API: این نشانی وب می‌تواند نام میزبان یا نشانی IP باشد. این نقطه پایانی REST است که همه تماس‌ها برای ایجاد برنامه‌ها و ثبت توسعه‌دهندگان برای کلیدهای برنامه با آن برقرار می‌شود. نقطه پایانی پیش‌فرض https://api.enterprise.apigee.com/v1 است.

      برای نصب Edge for Private Cloud، نشانی وب به این شکل است:
      http://EdgeIp:8080/v1

      یا:
      https://EdgeIp:SSLport/v1

      که در آن EdgeIp نشانی IP سرور مدیریت Edge و SSLport درگاه SSL برای Edge management API است. برای مثال، 8443.
    2. نام سازمان Apigee: بین پورتال‌ها و سازمان‌های Apigee Edge رابطه وجود دارد. هنگام راه‌اندازی «نقطه پایانی Management API»، سازمان پیش‌فرض را راه‌اندازی خواهید کرد. مقدار پیش‌فرض my-org است.
    3. نام کاربری و گذرواژه برای نقطه پایانی API مدیریت: تماس‌ها از درگاه به Edge باید توسط سرپرست سازمان شما انجام شود.

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

      برای مثال:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd