تثبيت بوابة "خدمات مطوِّري البرامج"

الإصدار 4.16.05 من بوابة خدمات المطوّرين

اتّبِع الخطوات التالية لتثبيت بوابة Developer Channel Services.

قبل المتابعة في عملية التثبيت، أنشِئ نسخة احتياطية من دليل جذر الويب بالكامل في Drupal. موقع التثبيت التلقائي هو /var/www/html، ولكن من المحتمل أن تكون قد غيّرته أثناء التثبيت. بعد تنفيذ خطوات التثبيت الموضّحة أدناه، يمكنك استعادة التخصيصات من النسخة الاحتياطية.

1. الحصول على حزمة Developer Channel Services

انتقِل إلى http://community.apigee.com/content/apigee-customer-support وانقر على "تسجيل الدخول إلى بوابة الدعم" لطلب ملف tar .الخاص بخدمات قناة المطوّرين بإحدى الطريقتَين التاليتَين:

• اطلب الوصول إلى دليل تنزيل Edge for Private Cloud.
• اطلب عنوان URL لملف ‎ .tar الخاص بخدمات قناة المطوّرين.

2. التأكّد من أنّ نظامك يستوفي متطلبات النظام

قبل تثبيت البوابة، يجب أن يستوفي الخادم المتطلبات التالية:

1. تأكَّد من إجراء التثبيت على الإصدار 64 بت من إصدار متوافق من 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 .الخاص بخدمات قناة المطوّرين باستخدام الأمر:
      > 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. في حال الاتصال بمؤسسة في السحابة الإلكترونية، يكون عنوان URL للطلب هو:
   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"
   }

3- تثبيت Developer Channel Services باستخدام نص التثبيت البرمجي الآلي

اتّبِع الإجراء التالي لتثبيت البوابة باستخدام نص التثبيت البرمجي المبرمَج. يعمل هذا الإجراء مع الخوادم التي تتصل أو لا تتصل بالإنترنت الخارجي.

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 .الخاص بخدمات قناة المطوّرين باستخدام الأمر:
      > tar -xvf <tar file>
   3. انتقِل إلى DeveloperServices-4.x.y.z.
   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 الشخصي.
   
   ملاحظة: من المفترض أن تكون قد ضبطت اسم مضيف وسجّلته في خادم نظام أسماء النطاقات لكي لا تضطر إلى استخدام http://localhost.
7. اضبط الاتصال بـ MySQL. إذا كان MySQL على جهاز عن بُعد، وسِّع قسم الخيارات المتقدّمة وأدخِل معلومات الاتصال بهذا الجهاز، ثم انقر على حفظ ومتابعة.
8. اضبط الاتصال بنقطة نهاية Apigee من خلال إدخال المعلومات التالية، ثم انقر على حفظ:
   لمزيد من المعلومات حول هذه القيم، يُرجى الاطّلاع على "المعلومات المطلوبة قبل بدء التثبيت" في متطلبات بوابة خدمات المطوّرين.
   1. Dev Portal Org
   2. عنوان URL لنقطة نهاية بوابة المطوّرين
   3. مستخدم تمت مصادقته من خلال نقطة النهاية
   4. كلمة مرور المستخدمين الذين تمت مصادقتهم
9. عندما يُطلب منك ذلك، انقر على الزر تثبيت نموذج SmartDocs WADL لتثبيت نموذج SmartDocs WADL. إذا تخطّيت هذه الخطوة، لن تظهر واجهة برمجة التطبيقات SmartDocs في المثال على بوابتك.
   ملاحظة: إذا كانت بوابتك تتصل بعملية تثبيت Apigee Edge for 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 لإنشاء مشرف كما هو موضّح أدناه في الخطوة 4. أنشئ مستخدمًا مشرفًا.
    1. الاسم الأول واسم العائلة للمطوّر
    2. اسم المستخدم في بوابة المطوّر
    3. كلمة المرور
    4. عنوان البريد الإلكتروني
12. بعد اكتمال التثبيت، اضبط الأذونات في ملف settings.php:
    > chmod 640 /var/www/html/sites/default/settings.php
13. انتقِل إلى الصفحة الرئيسية للبوابة على http://localhost/ أو إلى اسم نظام أسماء النطاقات لبوابتك.
14. سجِّل الدخول إلى البوابة باستخدام بيانات اعتماد المشرف.

4. إنشاء مستخدم مشرف

استخدِم Drush لإنشاء مستخدم إداري لتثبيت Developer Channel Services. ينشئ Drupal تلقائيًا مستخدمًا مشرفًا باسم "admin"، لذا لا تستخدم "admin" كاسم مستخدم.

1. انتقِل إلى دليل 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. سجِّل الدخول إلى بوابة مخصّصة للمطوّرين بصفتك مشرفًا باستخدام اسم المستخدم وكلمة المرور المحدّدَين أعلاه.

5- ضبط كلمة مرور جذر MySQL

إذا ثبّت MySQL كجزء من عملية تثبيت البوابة، سيترك نص التثبيت البرمجي كلمة مرور جذر MySQL مضبوطة على قيمتها التلقائية، وهي فارغة.

استخدِم الأمر التالي لضبط كلمة مرور الجذر:

> mysqladmin -u root password NEWPASSWORD

إذا سبق لك ضبط كلمة مرور الجذر وأردت تغييرها، استخدِم الأمر التالي:

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

يجب أيضًا تعديل كلمة المرور في ملف /var/www/html/sites/default/settings.php.

6. تأكَّد من تفعيل وحدة &quot;مدير التحديث&quot; (Update manager)

لتلقّي إشعارات بشأن تحديثات Drupal، تأكَّد من تفعيل وحدة إدارة تحديثات Drupal. من قائمة Drupal، اختَر الوحدات وانتقِل للأسفل إلى وحدة إدارة التحديثات. إذا لم يكن مفعَّلاً، فعِّله.

بعد تفعيل هذه الميزة، يمكنك الاطّلاع على التحديثات المتاحة من خلال عنصر القائمة التقارير > التحديثات المتاحة. يمكنك أيضًا استخدام أمر Drush التالي:

> drush pm-info update

استخدِم عنصر القائمة التقارير > التحديثات المتاحة > الإعدادات لضبط الوحدة لإرسال رسالة إلكترونية إليك عند توفّر تحديثات ولضبط معدّل تكرار البحث عن التحديثات.

7. اختياري - النشر على خادم إنتاج

إذا كنت تنشر البوابة على خادم إنتاج، عليك تنفيذ خطوات أمان إضافية، بما في ذلك:

1. شغِّل النص البرمجي التالي لتأمين تثبيت MySQL:
   > /usr/bin/mysql_secure_installation
   
   يضبط هذا النص البرمجي كلمة مرور الجذر ويمنحك خيار تقييد الوصول إلى الجذر على المضيف المحلي فقط وإزالة قواعد البيانات الاختبارية والمستخدم المجهول الهوية الذي تم إنشاؤه تلقائيًا. ننصح بشدة بتشغيل هذا النص البرمجي لخوادم الإنتاج.
2. فعِّل SELinux واضبطه إذا كانت سياسات شركتك تتطلب ذلك.

8. اختياري: ضبط محرك بحث Apache Solr

By default, the Drupal modules that connect to the Apache Solr search engine are disabled when you install the portal. تستخدم معظم البوابات محرك البحث الداخلي في 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.

9. اختياري: تثبيت mod_ssl لإتاحة HTTPS

يستخدم خادم Apache HTTP وحدة mod_ssl لعرض صفحات الويب عبر بروتوكول HTTPS. إذا كنت تريد استخدام HTTPS، استخدِم الأمر التالي لتثبيت mod_ssl:

> yum install mod_ssl

لمزيد من المعلومات حول ضبط البوابة لاستخدام طبقة المقابس الآمنة، يُرجى الاطّلاع على http://apigee.com/docs/developer-services/content/using-ssl-portal.

10. اختياري: تثبيت SmartDocs

تتيح لك SmartDocs توثيق واجهات برمجة التطبيقات على بوابة Developer Services بطريقة تجعل مستندات واجهة برمجة التطبيقات تفاعلية بالكامل. ومع ذلك، لاستخدام SmartDocs مع البوابة، يجب أولاً تثبيت SmartDocs على Edge.

• إذا كنت تربط البوابة بتثبيت Edge Cloud، يكون SmartDocs مثبّتًا بالفعل ولا يلزم إجراء أي ضبط إضافي.
• في حال ربط البوابة بتثبيت Edge for Private Cloud، عليك التأكّد من تثبيت SmartDocs على Edge. لمزيد من المعلومات حول تثبيت Edge وSmartDocs، يُرجى الاطّلاع على تثبيت SmartDocs.

لمزيد من المعلومات حول SmartDocs، يُرجى الاطّلاع على استخدام SmartDocs لتوثيق واجهات برمجة التطبيقات.

11. ما هي الخطوات التالية؟

تتمثل الخطوات التالية بعد تثبيت بوابة خدمات المطوّرين في ضبطها وتخصيصها وفقًا لمتطلباتك المحدّدة. تحتوي المستندات على موقع Apigee الإلكتروني على جميع المعلومات المتعلقة بإعداد البوابة وتصميمها وإدارتها. يمكنك الاطّلاع على المستندات على الرابط http://apigee.com/docs/developer-services/content/what-developer-portal.

يسرد الجدول التالي بعض المهام الأكثر شيوعًا التي يتم تنفيذها بعد التثبيت، ويتضمّن روابط إلى مستندات Apigee حيث يمكنك العثور على مزيد من المعلومات: