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

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

قبل از نصب، اطمینان حاصل کنید که:

• شما در حال نصب بر روی نسخه 64 بیتی یک نسخه پشتیبانی شده از Red Hat Enterprise Linux، CentOS یا Oracle هستید. لیست نسخه های پشتیبانی شده را اینجا ببینید.
• Yum نصب شده است.
• از نصب های موجود نسخه پشتیبان تهیه می کنید. اگر کدی را در هسته دروپال یا هر ماژول غیر سفارشی تغییر داده اید، تغییرات شما رونویسی می شود. این شامل موارد دیگر، هر تغییری است که ممکن است در htaccess . شما باید فرض کنید که هر چیزی خارج از فهرست /sites متعلق به دروپال است. یک استثنا از این قانون robots.txt است. اگر این فایل در ریشه وب وجود داشته باشد، برای شما حفظ خواهد شد. قبل از ادامه نصب، از کل فهرست اصلی وب دروپال خود یک نسخه پشتیبان تهیه کنید. محل نصب پیش فرض /var/www/html است، اما ممکن است در زمان نصب آن را تغییر داده باشید. پس از انجام مراحل نصب شرح داده شده در زیر، می توانید سفارشی سازی های خود را از پشتیبان بازیابی کنید.

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

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

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

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

2. اتصال خود را به Apigee Edge تست کنید

اتصال خود را به سرور مدیریت 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. نسخه های قبل از 7.0 PHP را حذف کنید

اسکریپت نصب، قبل از شروع نصب، نسخه های قبل از 7.0 PHP را در سیستم بررسی می کند. اگر نسخه های قبل از 7.0 PHP وجود داشته باشد، پیام هشدار زیر نمایش داده می شود:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

برای CentOS و Red Hat Enterprise Linux (RHEL)، بسته های PHP را با استفاده از دستور زیر حذف کنید:

yum remove <package-name>

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

بر اساس این که آیا در حال نصب روی سرور با یا بدون اتصال به اینترنت هستید، از یکی از روش های زیر برای نصب پورتال استفاده کنید.

در سرور با اتصال به اینترنت:

برای نصب Developer Channel Services روی سروری با اتصال اینترنت:

1. به عنوان root یا superuser وارد سرور شوید.
2. یک دایرکتوری برای فایل های نصب مانند پورتال ایجاد کنید.
3. سی دی را به فهرست پورتال جدید وارد کنید و فایل Developer Channel Services DeveloperServices_ x.yz .tar را دانلود کنید، جایی که xyz با شماره نسخه پورتال مطابقت دارد.
   
   می توانید یک فایل را از لینکی که توسط Apigee برای شما ارسال شده در مرورگر دانلود کنید یا با کپی کردن آن و سپس اضافه کردن آن به دستور cURL زیر:
   > curl -kOL <پیوند پیوند در اینجا>
4. محتویات فایل Developer Channel Services .tar را با استفاده از دستور زیر استخراج کنید:
   > tar -xvf <tar file>
5. سی دی به DeveloperServices-4.xyz .
6. اسکریپت نصب را با استفاده از دستور زیر اجرا کنید:
   > ./networked-install.sh
7. به درخواست ها پاسخ دهید.

در سرور بدون اتصال به اینترنت:

ابتدا یک اسکریپت نصب غیر شبکه ای در سیستمی که اتصال اینترنت دارد ایجاد کنید:

1. به عنوان root یا superuser وارد سیستمی با اتصال اینترنت شوید.
2. یک دایرکتوری برای فایل های نصب مانند portal_tar ایجاد کنید.
3. سی دی را به دایرکتوری portal_tar وارد کنید و فایل 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 جدید برای نصب غیر شبکه ای ایجاد می شود.

1. به عنوان root یا superuser وارد سرور شوید.
2. یک دایرکتوری برای فایل های نصب مانند پورتال ایجاد کنید.
3. سی دی به دایرکتوری پورتال .
4. فایل tar.gz را که برای نصب غیر شبکه ای ایجاد کرده اید (در روش بالا) در دایرکتوری پورتال کپی کنید.
5. با استفاده از دستور زیر محتویات فایل .tar.gz را استخراج کنید:
   > tar -xvf <tar file>
6. سی دی به دایرکتوری ایجاد شده توسط دستور tar.
7. مجوزها را در اسکریپت install-from-rpm-bundle.sh تنظیم کنید:
   > chmod 755 install-from-rpm-bundle.sh
8. اسکریپت install-from-rpm-bundle.sh را با استفاده از دستور اجرا کنید:
   > ./install-from-rpm-bundle.sh
9. به درخواست ها پاسخ دهید.

5. پورتال توسعه دهنده خود را پیکربندی کنید

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

برای پیکربندی پورتال توسعه دهنده خود:

1. در یک مرورگر به URL سرور بروید، مانند:
   http://localhost . یا اگر IP یا DNS خاصی را پیکربندی کرده‌اید، به http://IP_address یا http://DNS_name بروید.
   
   شما به صفحه پیکربندی پایگاه داده پروفایل Apigee هدایت می شوید.
   
   توجه : به طور معمول، شما قبلاً یک نام میزبان را پیکربندی کرده و آن را در سرور DNS خود ثبت کرده اید تا مجبور نباشید از http://localhost استفاده کنید.
2. اتصال به پایگاه داده را پیکربندی کنید. اگر پایگاه داده روی یک ماشین راه دور است، بخش Advanced Options را گسترش دهید و اطلاعات اتصال به آن دستگاه را وارد کنید، سپس Save را انتخاب کنید و ادامه دهید .
3. با وارد کردن اطلاعات زیر، اتصال به نقطه پایانی Apigee را پیکربندی کنید و سپس Save را انتخاب کنید.
   برای اطلاعات بیشتر در مورد این مقادیر، به «اطلاعات مورد نیاز قبل از شروع نصب» در Developer Services Portal الزامات مراجعه کنید.
   1. مدیریت API Org
   2. URL نقطه پایانی مدیریت API
   3. کاربر تایید شده نقطه پایانی
   4. رمز عبور تایید شده کاربران
4. کاربر مدیر را با وارد کردن اطلاعات زیر پیکربندی کنید و سپس Save را انتخاب کنید. توجه داشته باشید که دروپال به طور پیش‌فرض یک کاربر ادمین به نام admin ایجاد می‌کند، بنابراین از «admin» به عنوان نام کاربری استفاده نکنید.
   اگر این مرحله را رد کنید، همچنان می توانید از Drush برای ایجاد یک سرپرست همانطور که در زیر در 4 توضیح داده شده است استفاده کنید. یک کاربر مدیر ایجاد کنید.
   1. نام و نام خانوادگی توسعه دهنده
   2. نام کاربری پورتال توسعه دهنده
   3. کلمه عبور
   4. آدرس ایمیل
5. پس از اتمام نصب، مجوزها را در فایل settings.php تنظیم کنید:
   > chmod 640 /var/www/html/sites/default/settings.php
6. به صفحه اصلی پورتال در http://localhost/ یا به نام DNS پورتال خود بروید.
7. با استفاده از اطلاعات کاربری مدیر وارد پورتال شوید.

6. ایجاد یک کاربر ادمین (اختیاری)

از 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. mod_ssl را برای پشتیبانی از HTTPS (اختیاری) نصب کنید

ماژول 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 می‌شود که در آن می‌توانید اطلاعات بیشتری بیابید: