نصب پورتال خدمات توسعه دهنده

پورتال خدمات توسعه دهنده نسخه 4.16.05

برای نصب پورتال Developer Channel Services این مراحل را دنبال کنید.

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

1. بسته Developer Channel Services را دریافت کنید

به http://community.apigee.com/content/apigee-customer-support بروید و ورود به پورتال پشتیبانی خود را انتخاب کنید تا فایل tar Developer Channel Services را به یکی از دو روش درخواست کنید:

• درخواست دسترسی به فهرست دانلود Edge for Private Cloud کنید.
• یک URL به فایل tar. خدمات کانال توسعه دهنده درخواست کنید.

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

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

1. مطمئن شوید که نصب را روی نسخه 64 بیتی یک نسخه پشتیبانی شده از Red Hat Enterprise Linux، CentOS یا Oracle انجام می دهید. لیست نسخه های پشتیبانی شده را اینجا ببینید.
2. مطمئن شوید که Yum نصب شده است.
3. (برای نصب روی سرور بدون اتصال به اینترنت) ابتدا باید تمام فایل های لازم را به عنوان یک فایل .tar.gz روی سروری با اتصال اینترنت دانلود کنید. سپس آن فایل .tar.gz را بدون اتصال به اینترنت در سرور کپی می کنید تا نصب انجام شود.
   1. به عنوان root یا superuser به سروری با اتصال اینترنت وارد شوید.
   2. یک دایرکتوری برای فایل های نصب مانند portal_tar ایجاد کنید.
   3. سی دی را به دایرکتوری جدید وارد کنید و فایل Developer Channel Services DeveloperServices_ x.yz .tar را دانلود کنید، جایی که xyz با شماره نسخه پورتال مطابقت دارد.
   4. محتویات فایل Developer Channel Services .tar را با استفاده از دستور زیر استخراج کنید:
      > tar -xvf <tar file>
   5. سی دی به DeveloperServices-4.xyz .
   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 است. اگر به یک سازمان در فضای ابری متصل می شوید، URL درخواست این است:
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   در صورت موفقیت آمیز بودن، این دستور پاسخی شبیه به زیر برمی گرداند:
   {
   "createdAt" : 1348689232699،
   "createdBy" : "USERNAME"،
   "displayName" : "cg",
   "محیط" : [ "تست"، "تولید"]،
   "lastModifiedAt" : 1348689232699،
   "lastModifiedBy" : "foo@bar.com"،
   "نام": "cg"،
   "خواص" : {
   "مالکیت" : [ ]
   }،
   "نوع" : "آزمایشی"
   }

3. Developer Channel Services را با استفاده از اسکریپت نصب خودکار نصب کنید

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

1. به عنوان root یا superuser وارد سرور شوید.
2. یک دایرکتوری برای فایل های نصب مانند پورتال ایجاد کنید.
3. در سرور با اتصال به اینترنت:
   1. سی دی را به فهرست پورتال جدید وارد کنید و فایل Developer Channel Services DeveloperServices_ x.yz .tar را دانلود کنید، جایی که xyz با شماره نسخه پورتال مطابقت دارد.
      
      می توانید یک فایل را از لینکی که توسط Apigee برای شما ارسال شده در مرورگر دانلود کنید یا با کپی کردن آن و سپس اضافه کردن آن به دستور cURL زیر:
      > curl -kOL <پیوند پیوند در اینجا>
   2. محتویات فایل Developer Channel Services .tar را با استفاده از دستور زیر استخراج کنید:
      > tar -xvf <tar file>
   3. سی دی به DeveloperServices-4.xyz .
   4. اسکریپت نصب را با استفاده از دستور زیر اجرا کنید:
      > ./networked-install.sh
4. در سرور بدون اتصال به اینترنت:
   1. فایل tar.gz را که در بالا ایجاد کردید در بخش 2 کپی کنید. مطمئن شوید که سیستم شما نیازهای سیستم را برآورده می کند.
   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. پس از اتمام نصب، در یک مرورگر به URL سرور بروید، مانند:
   http://localhost . یا اگر IP یا DNS خاصی را پیکربندی کرده‌اید، به http://IP_address یا http://DNS_name بروید.
   
   شما به صفحه پیکربندی پایگاه داده پروفایل Apigee هدایت می شوید.
   
   توجه : به طور معمول، شما قبلاً یک نام میزبان را پیکربندی کرده و آن را در سرور DNS خود ثبت کرده اید تا مجبور نباشید از http://localhost استفاده کنید.
7. اتصال به MySQL را پیکربندی کنید. اگر MySQL روی یک ماشین راه دور است، بخش Advanced Options را گسترش دهید و اطلاعات اتصال به آن دستگاه را وارد کنید، سپس Save را انتخاب کنید و ادامه دهید .
8. با وارد کردن اطلاعات زیر، اتصال به نقطه پایانی Apigee را پیکربندی کنید و سپس Save را انتخاب کنید:
   برای اطلاعات بیشتر در مورد این مقادیر، به «اطلاعات مورد نیاز قبل از شروع نصب» در Developer Services Portal الزامات مراجعه کنید.
   1. Dev Portal Org
   2. URL نقطه پایانی پورتال توسعه‌دهنده
   3. کاربر تایید شده نقطه پایانی
   4. رمز عبور تایید شده کاربران
9. وقتی از شما خواسته شد، دکمه Install Sample 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. کاربر مدیر را با وارد کردن اطلاعات زیر پیکربندی کنید و سپس Save را انتخاب کنید. توجه داشته باشید که دروپال به طور پیش‌فرض یک کاربر ادمین به نام admin ایجاد می‌کند، بنابراین از «admin» به عنوان نام کاربری استفاده نکنید.
    اگر این مرحله را رد کنید، همچنان می توانید از Drush برای ایجاد یک سرپرست همانطور که در زیر در 4 توضیح داده شده است استفاده کنید. یک کاربر مدیر ایجاد کنید.
    1. نام و نام خانوادگی توسعه دهنده
    2. نام کاربری پورتال توسعه دهنده
    3. رمز عبور
    4. آدرس ایمیل
12. پس از اتمام نصب، مجوزها را در فایل settings.php تنظیم کنید:
    > chmod 640 /var/www/html/sites/default/settings.php
13. به صفحه اصلی پورتال در http://localhost/ یا به نام DNS پورتال خود بروید.
14. با استفاده از اطلاعات کاربری مدیر وارد پورتال شوید.

4. یک کاربر ادمین بسازید

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

1. سی دی به پوشه drupal_root/sites/default شما. محل استاندارد دایرکتوری ریشه دروپال /var/www/html است:
   > سی دی <drupal_root>/sites/default
2. اطمینان حاصل کنید که مجوز نوشتن در فایل های خصوصی دروپال را دارید:
   > drush vget file_private_path
   
   این دستور مسیر فایل های خصوصی دروپال را برمی گرداند، به عنوان مثال:
   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. با استفاده از نام کاربری و رمز عبور مشخص شده در بالا، به عنوان یک مدیر وارد پورتال توسعه دهنده شوید.

5. رمز عبور ریشه MySQL را تنظیم کنید

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

برای تنظیم رمز عبور root از دستور زیر استفاده کنید:

> mysqladmin -u root password NEWPASSWORD

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

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

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

6. مطمئن شوید که ماژول مدیر به روز رسانی فعال است

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

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

> drush pm-info update

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

7. اختیاری - استقرار در سرور تولید

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

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

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

به طور پیش فرض، ماژول های دروپال که به موتور جستجوی Apache Solr متصل می شوند، هنگام نصب پورتال غیرفعال می شوند. اکثر پورتال ها از موتور جستجوی داخلی دروپال استفاده می کنند و بنابراین نیازی به ماژول های دروپال 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 توضیح داده شده پیکربندی کنید.

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

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

> yum install mod_ssl

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

10. اختیاری - SmartDocs را نصب کنید

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

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

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

11. بعدش چی؟

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

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