نصب درگاه «سرویس‌های توسعه‌دهنده»

Developer Services Portal v. 4.16.05

برای نصب درگاه «سرویس‌های کانال توسعه‌دهنده»، این مراحل را دنبال کنید.

قبل‌از ادامه نصب، از کل دایرکتوری ریشه وب Drupal خود نسخه پشتیبان تهیه کنید. مکان نصب پیش‌فرض /var/www/html است، اما ممکن است آن را در زمان نصب تغییر داده باشید. پس‌از انجام مراحل نصب شرح‌داده‌شده در زیر، می‌توانید سفارشی‌سازی‌هایتان را از نسخه پشتیبان بازیابی کنید.

۱. دریافت بسته Developer Channel Services

به http://community.apigee.com/content/apigee-customer-support بروید و «ورود به سیستم درگاه پشتیبانی» را انتخاب کنید تا فایل tar. «سرویس‌های کانال توسعه‌دهنده» را به یکی از دو روش زیر درخواست کنید:

• درخواست دسترسی به فهرست راهنمای بارگیری Edge for Private Cloud.
• درخواست نشانی وب برای فایل tar. «سرویس‌های کانال توسعه‌دهنده».

۲. مطمئن شوید که سیستمتان ملزومات سیستم را برآورده می‌کند

قبل‌از نصب درگاه، سرورتان باید الزامات زیر را برآورده کند:

1. مطمئن شوید که نصب را روی نسخه ۶۴ بیتی از نسخه پشتیبانی‌شده Red Hat Enterprise Linux،‏ CentOS، یا Oracle انجام می‌دهید. فهرست نسخه‌های پشتیبانی‌شده را در اینجا ببینید.
2. مطمئن شوید Yum نصب شده باشد.
3. (برای نصب روی سرور بدون اتصال اینترنت) ابتدا باید همه فایل‌های ضروری را در سروری با اتصال اینترنت به‌صورت یک فایل tar.gz.بارگیری کنید. سپس آن فایل tar .gz.را بدون اتصال اینترنت به سرور کپی می‌کنید تا نصب را انجام دهید.
   1. با اتصال اینترنت به‌عنوان کاربر ریشه یا کاربر ممتاز به سرور وارد شوید.
   2. فهرست راهنمایی برای فایل‌های نصب ایجاد کنید، مثلاً portal_tar.
   3. به دایرکتوری جدید بروید و فایل Developer Channel Services DeveloperServices_x.y.z.tar را بارگیری کنید، که در آن x.y.z با شماره نسخه پورتال مطابقت دارد.
   4. محتویات فایل tar .مربوط به Developer Channel Services را بااستفاده از این فرمان استخراج کنید:
      > tar -xvf <tar file>
   5. به DeveloperServices-4.x.y.z بروید.
   6. بااستفاده از این فرمان، فایل .tar.gz درگاه را ایجاد کنید:
      > ./non-networked-install.sh
      
      این فرمان همه فایل‌های لازم را بارگیری می‌کند و آن‌ها را در یک فایل .tar.gz قرار می‌دهد. سپس آن فایل tar .gz.را در سرورتان که اتصال اینترنت ندارد کپی می‌کنید تا نصب تکمیل شود.
4. اتصال خود به سرور مدیریت Edge را با اجرای فرمان cURL زیر از خط فرمان در سرور پورتال آزمایش کنید:
   > curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   که در آن EMAIL و PASSWORD نشانی ایمیل و گذرواژه سرپرست ORGNAME است.
   
   حتماً نام میزبان و شماره درگاه مختص نصب Edge را مشخص کنید. درگاه 8080 درگاه پیش‌فرضی است که Edge استفاده می‌کند. اگر به سازمانی در فضای ابری متصل می‌شوید، نشانی وب درخواست این است:
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   اگر موفقیت‌آمیز باشد، این فرمان پاسخی مشابه پاسخ زیر برمی‌گرداند:
   {
   "createdAt" : 1348689232699,
   "createdBy" : "USERNAME",
   "displayName" : "cg",
   "environments" : [ "test", "prod" ],
   "lastModifiedAt" : 1348689232699,
   "lastModifiedBy" : "foo@bar.com",
   "name" : "cg",
   "properties" : {
   "property" : [ ]
   },
   "type" : "trial"
   }

۳. نصب «سرویس‌های کانال توسعه‌دهنده» بااستفاده از دستورگان نصب خودکار

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

1. به‌عنوان کاربر ریشه یا اَبَرکاربر به سیستم سرور وارد شوید.
2. فهرست راهنمایی برای فایل‌های نصب ایجاد کنید، مثلاً portal.
3. در سروری با اتصال اینترنت:
   1. به دایرکتوری پورتال جدید بروید و فایل Developer Channel Services DeveloperServices_x.y.z.tar را بارگیری کنید، که در آن x.y.z با شماره نسخه پورتال مطابقت دارد.
      
      می‌توانید فایلی را از پیوندی که Apigee برایتان ارسال کرده است در مرورگر بارگیری کنید یا آن را کپی کنید و سپس به فرمان cURL زیر اضافه کنید:
      > curl -kOL <paste link here>
   2. محتویات فایل tar .مربوط به Developer Channel Services را بااستفاده از این فرمان استخراج کنید:
      > tar -xvf <tar file>
   3. به DeveloperServices-4.x.y.z بروید.
   4. دستورگان نصب را بااستفاده از فرمان زیر اجرا کنید:
      > ./networked-install.sh
4. در سروری بدون اتصال اینترنت:
   1. فایل tar .gz.را که در بخش ۲ در بالا ایجاد کردید کپی کنید. مطمئن شوید که سیستم شما ملزومات سیستم را دارد.
   2. محتویات فایل tar .gz.را بااستفاده از این فرمان استخراج کنید:
      > tar -xvf <tar file>
   3. به دایرکتوری ایجادشده توسط فرمان tar بروید.
   4. اجازه‌ها را در اسکریپت install-from-rpm-bundle.sh تنظیم کنید:
      > chmod 755 install-from-rpm-bundle.sh
   5. دستورگان install-from-rpm-bundle.sh را بااستفاده از فرمان زیر اجرا کنید:
      > ./install-from-rpm-bundle.sh
5. به پیام‌واره‌ها پاسخ دهید.
6. پس‌از تکمیل نصب، در مرورگر به نشانی وب سرور بروید، مثلاً:
   http://localhost. یا اگر IP یا ساناد خاصی پیکربندی شده است، به http://IP_address یا http://DNS_name بروید.
   
   به صفحه پیکربندی پایگاه داده نمایه Apigee هدایت می‌شوید.
   
   توجه: معمولاً قبلاً نام میزبان را پیکربندی کرده‌اید و آن را در سرور ساناد خود ثبت کرده‌اید تا مجبور نباشید از http://localhost استفاده کنید.
7. اتصال به MySQL را پیکربندی کنید. اگر MySQL در دستگاهی ازراه‌دور است، بخش گزینه‌های پیشرفته را ازهم باز کنید و اطلاعات اتصال به آن دستگاه را وارد کنید، سپس ذخیره و ادامه را انتخاب کنید.
8. با وارد کردن اطلاعات زیر، اتصال به «نقطه پایانی Apigee» را پیکربندی کنید، و سپس ذخیره را انتخاب کنید:
   برای اطلاعات بیشتر درباره این مقادیر، به «اطلاعات لازم قبل‌از شروع نصب» در الزامات درگاه سرویس‌های توسعه‌دهنده مراجعه کنید.
   1. Dev Portal Org
   2. نشانی وب نقطه پایانی درگاه توسعه‌دهنده
   3. کاربر اصالت‌سنجی‌شده نقطه پایان
   4. گذرواژه کاربران اصالت‌سنجی‌شده
9. وقتی درخواست شد، دکمه نصب نمونه SmartDocs WADL را انتخاب کنید تا نمونه SmartDocs WADL نصب شود. اگر از این مرحله رد شوید، نمونه SmartDocs API در درگاه شما نشان داده نخواهد شد.
   توجه: اگر درگاه شما به نصب Apigee Edge برای Private Cloud متصل می‌شود و آن نصب Edge اتصال اینترنت خارجی ندارد، باید پیکربندی اضافی ماژول SmartDocs را قبل‌از اینکه بتوانید از SmartDocs استفاده کنید انجام دهید. برای اطلاعات بیشتر درباره SmartDocs، به http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis مراجعه کنید.
10. تنظیمات سرور SMTP را پیکربندی کنید. Apigee از شما می‌خواهد که سرور SMTP را برای ارسال پیام‌های ایمیل از پورتال پیکربندی کنید.
    برای اطلاعات بیشتر، http://apigee.com/docs/developer-services/content/configuring-email را ببینید.
11. کاربر سرپرست را با وارد کردن اطلاعات زیر پیکربندی کنید، سپس «ذخیره» را انتخاب کنید. توجه داشته باشید که Drupal به‌طور پیش‌فرض کاربر سرپرستی به‌نام «admin» ایجاد می‌کند، بنابراین از «admin» به‌عنوان نام کاربری استفاده نکنید.
    اگر این مرحله را رد کنید، همچنان می‌توانید از Drush برای ایجاد سرپرست استفاده کنید، همان‌طور که در زیر در بخش ۴ توضیح داده شده است. کاربر سرپرست ایجاد کنید.
    1. نام و نام خانوادگی توسعه‌دهنده
    2. نام کاربری درگاه توسعه‌دهنده
    3. گذرواژه
    4. نشانی ایمیل
12. پس‌از تکمیل نصب، اجازه‌ها را در فایل settings.php تنظیم کنید:
    > chmod 640 /var/www/html/sites/default/settings.php
13. به صفحه اصلی درگاه در http://localhost/ یا به نام ساناد درگاهتان بروید.
14. بااستفاده از اطلاعات کاربری سرپرست، به سیستم درگاه وارد شوید.

۴. ایجاد کاربر سرپرست

از Drush برای ایجاد کاربر سرپرست برای نصب «سرویس‌های کانال توسعه‌دهنده» استفاده کنید. Drupal به‌طور خودکار کاربر سرپرستی به‌نام «admin» به‌طور پیش‌فرض ایجاد می‌کند، بنابراین از «admin» به‌عنوان نام کاربری استفاده نکنید.

1. CD به دایرکتوری drupal_root/sites/default. مکان استاندارد برای دایرکتوری ریشه Drupal ‎ /var/www/html است:
   > cd <drupal_root>/sites/default
2. مطمئن شوید که در فایل‌های خصوصی Drupal اجازه نوشتن دارید:
   > drush vget file_private_path
   
   این فرمان مسیر فایل‌های خصوصی Drupal را برمی‌گرداند، برای مثال:
   file_private_path: 'sites/default/private'
   
   مطابق با /var/www/html/sites/default/private/. از فرمان زیر استفاده کنید تا مطمئن شوید که این دایرکتوری توسط مالک و گروه قابل‌نوشتن است:
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. فرمان‌های زیر را برای ایجاد کاربر سرپرست وارد کنید و فرمان‌های داخل «< >» را با مقادیر خودتان جایگزین کنید:
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. بااستفاده از نام کاربری و گذرواژه مشخص‌شده در بالا، به‌عنوان سرپرست به درگاه توسعه‌دهندگان وارد شوید.

۵. تنظیم گذرواژه ریشه MySQL

اگر MySQL را به‌عنوان بخشی از نصب پورتال نصب کرده‌اید، اسکریپت نصب، گذرواژه ریشه MySQL را روی مقدار پیش‌فرض آن که خالی است باقی می‌گذارد.

از فرمان زیر برای تنظیم گذرواژه ریشه استفاده کنید:

> mysqladmin -u root password NEWPASSWORD

اگر قبلاً گذرواژه ریشه را تنظیم کرده‌اید و می‌خواهید آن را تغییر دهید، از فرمان زیر استفاده کنید:

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

همچنین باید گذرواژه را در فایل /var/www/html/sites/default/settings.php به‌روز کنید.

‫۶. مطمئن شوید واحد «مدیر به‌روزرسانی» فعال باشد

برای دریافت اعلان‌های به‌روزرسانی‌های Drupal، مطمئن شوید که ماژول Drupal Update manager فعال است. از منو Drupal، Modules (واحدها) را انتخاب کنید و به پایین پیمایش کنید تا به واحد Update manager (مدیر به‌روزرسانی) برسید. اگر فعال نیست، آن را فعال کنید.

پس‌از فعال کردن، می‌توانید بااستفاده از گزینه منو گزارش‌ها > به‌روزرسانی‌های دردسترس، به‌روزرسانی‌های دردسترس را ببینید. همچنین می‌توانید از فرمان Drush زیر استفاده کنید:

> drush pm-info update

از گزینه منو گزارش‌ها > به‌روزرسانی‌های دردسترس > تنظیمات برای پیکربندی ماژول استفاده کنید تا وقتی به‌روزرسانی‌ها دردسترس هستند برایتان ایمیل ارسال شود و تناوب بررسی به‌روزرسانی‌ها را تنظیم کنید.

‫۷. اختیاری - پیاده‌سازی در سرور تولید

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

1. اسکریپت زیر را برای ایمن کردن نصب MySQL اجرا کنید:
   > /usr/bin/mysql_secure_installation
   
   این اسکریپت گذرواژه ریشه را تنظیم می‌کند و به شما این امکان را می‌دهد که دسترسی ریشه را فقط به میزبان محلی محدود کنید و پایگاه‌های داده آزمایشی و کاربر ناشناس ایجادشده به‌طور پیش‌فرض را بردارید. اجرای این دستورگان برای سرورهای تولید به‌شدت توصیه می‌شود.
2. اگر خط‌مشی‌های شرکتی شما ایجاب می‌کند، SELinux را فعال و پیکربندی کنید.

‫۸. اختیاری - پیکربندی موتور جستجوی Apache Solr

به‌طور پیش‌فرض، ماژول‌های Drupal که به موتور جستجوی Apache Solr متصل می‌شوند، هنگام نصب درگاه غیرفعال هستند. اکثر درگاه‌ها از موتور جستجوی داخلی Drupal استفاده می‌کنند و بنابراین به مدول‌های Drupal Solr نیاز ندارند.

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

برای فعال کردن واحدهای Drupal Solr:

1. به‌عنوان کاربری با امتیازات سرپرست یا ایجاد محتوا به سیستم درگاهتان وارد شوید.
2. Modules (واحدها) را در منو Drupal انتخاب کنید.
3. واحد Apache Solr Framework و واحد Apache Solr Search را فعال کنید.
4. تغییراتتان را ذخیره کنید.
5. Solr را همان‌طور که در https://drupal.org/node/1999280 شرح داده شده است پیکربندی کنید.

‫۹. اختیاری - mod_ssl را برای پشتیبانی از HTTPS نصب کنید

«سرور اچ‌تی‌تی‌پی آپاچی» از ماژول mod_ssl برای ارائه صفحه‌های وب ازطریق HTTPS استفاده می‌کند. اگر می‌خواهید از HTTPS استفاده کنید، از فرمان زیر برای نصب mod_ssl استفاده کنید:

> yum install mod_ssl

برای اطلاعات بیشتر درباره پیکربندی درگاه برای استفاده از SSL، به http://apigee.com/docs/developer-services/content/using-ssl-portal مراجعه کنید.

‫۱۰. اختیاری - نصب SmartDocs

SmartDocs به شما امکان می‌دهد میاناهای برنامه‌سازی کاربردی خود را در درگاه «سرویس‌های توسعه‌دهنده» به‌گونه‌ای مستند کنید که مستندات میانای برنامه‌سازی کاربردی کاملاً تعاملی شود. اما برای استفاده از SmartDocs با درگاه، ابتدا باید SmartDocs را در Edge نصب کنید.

• اگر درحال اتصال پورتال به نصب Edge Cloud هستید، SmartDocs ازقبل نصب شده است و پیکربندی بیشتری لازم نیست.
• اگر درحال اتصال پورتال به نصب Edge for Private Cloud هستید، باید مطمئن شوید که SmartDocs در Edge نصب شده باشد. برای اطلاعات بیشتر درباره نصب Edge و SmartDocs، به نصب SmartDocs مراجعه کنید.

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

‫۱۱. گام بعدی چیست؟

مراحل بعدی شما پس‌از نصب درگاه «خدمات توسعه‌دهنده» پیکربندی و سفارشی‌سازی آن برای الزامات خاص شما است. اسناد موجود در وب‌سایت Apigee حاوی همه اطلاعات مربوط به پیکربندی، سبک‌بندی، و مدیریت درگاه است. به اسناد در http://apigee.com/docs/developer-services/content/what-developer-portal دسترسی پیدا کنید.

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