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

الإصدار 4.17.01 من Edge for Private Cloud

قبل التثبيت، تأكَّد مما يلي:

• يجب تثبيت Postgres قبل تثبيت المدخل. يمكنك تثبيت Postgres كجزء من تثبيت Edge، أو تثبيت Postgres المستقل لاستخدامه من قِبل البوابة.
  • إذا ثبّت Postgres بشكل مستقل، يمكن أن يكون على العقدة نفسها مثل البوابة.
  • في حال الاتصال بـ Postgres المثبَّت كجزء من Edge، وتم ضبط Postgres في وضع "الرئيسي/الاحتياطي"، حدِّد عنوان IP لخادم Postgres الرئيسي.
• أنّك تُجري عملية التثبيت على الإصدار 64 بت من إصدار متوافق من Red Hat Enterprise Linux أو CentOS أو Oracle يمكنك الاطّلاع على قائمة الإصدارات المتوافقة في البرامج والإصدارات المتوافقة.
• تم تثبيت Yum.

نظرة عامة على عملية التثبيت

بعد تثبيت الأداة المساعدة apigee-setup في Edge على عقدة، استخدِم هذه الأداة المساعدة لتثبيت البوابة على العقدة. تتّخذ الأداة المساعدة apigee-setup الشكل التالي:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

مرِّر ملف إعداد إلى الأداة المساعدة apigee-setup التي تحتوي على معلومات حول عملية التثبيت. إذا كان ملف الإعداد لا يتضمّن أي معلومات مطلوبة، ستطلب منك أداة apigee-setup إدخالها في سطر الأوامر.

الشرط الوحيد هو أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل مستخدم "apigee".

على سبيل المثال، استخدِم الأمر التالي لتثبيت البوابة:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig

لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.

إنشاء ملف إعداد

في ما يلي مثال على ملف إعداد صامت لتثبيت بوابة. عدِّل هذا الملف حسب الضرورة لضبط الإعدادات. استخدِم الخيار ‎-f مع setup.sh لتضمين هذا الملف.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres. 
PG_NAME=devportal 

# Specify the Postgres admin credentials. 
# The portal connects to Postgres by using the 'apigee' user. 
# If you changed the Postgres password from the default of 'postgres' 
# then set PG_PWD accordingly. 
# If connecting to a Postgres node installed with Edge, 
# contact the Edge sys admin to get these credentials. 
PG_USER=apigee 
PG_PWD=postgres 

# The IP address of the Postgres server. 
# If it is installed on the same node as the portal, specify that IP. 
# If connecting to a remote Postgres server,specify its IP address. 
PG_HOST=$IP1 

# The Postgres user credentials used by the portal 
# to access the Postgres database, 
# This account is created if it does not already exist. 
DRUPAL_PG_USER=drupaladmin 
DRUPAL_PG_PASS=portalSecret 

# Specify 'postgres' as the database. 
DEFAULT_DB=postgres 

# Specify the Drupal admin account details. 
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin. 
# The installer creates this user on the portal. 
DEVPORTAL_ADMIN_FIRSTNAME=firstName 
DEVPORTAL_ADMIN_LASTNAME=lastName 
DEVPORTAL_ADMIN_USERNAME=userName 
DEVPORTAL_ADMIN_PWD=pWord 
DEVPORTAL_ADMIN_EMAIL=foo@bar.com 

# Edge connection details. 
# If omitted, you can set them in the portal UI. 
# Specify the Edge organization associated with the portal. 
EDGE_ORG=edgeOrgName 

# Specify the URL of the Edge management API. 
# For a Cloud based installation of Edge, the URL is: 
# https://api.enterprise.apigee.com/v1 
# For a Private Cloud installation, it is in the form: 
# http://<ms_ip_or_DNS>:8080/v1 or 
# https://<ms_ip_or_DNS>:TLSport/v1 
MGMT_URL=https://api.enterprise.apigee.com/v1 

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword. 
# The portal uses this information to connect to Edge. 
DEVADMIN_USER=orgAdmin@myCorp.com 
DEVADMIN_PWD=pWord 

# The PHP port. 
# If omitted, it defaults to 8888. 
PHP_FPM_PORT=8888 

# You must configure the SMTP server used by the portal. 
# The properties SMTPHOST and SMTPPORT are required. 
# The others are optional with a default value as notated below. 
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com. 
SMTPHOST=smtp.gmail.com 

# Use SSL for SMTP: 'y' or 'n' (default). 
SMTPSSL="n" 

# SMTP port (usually 25). 
# The value can be different based on the selected encryption protocol. 
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS. 
SMTPPORT=25 

# Username used for SMTP authentication, defaults is blank. 
SMTPUSER=your@email.com 

# Password used for SMTP authentication, default is blank. 
SMTPPASSWORD=yourEmailPassword

1. اختبار الاتصال بـ Apigee Edge

اختبِر الاتصال بخادم إدارة Edge من خلال تنفيذ أمر cURL التالي من موجّه الأوامر على خادم المدخل:

> curl -u {EMAIL}:{PASSWORD} http://<ms_ip_or_DNS>:8080/v1/organizations/{ORGNAME}

أو:

> curl -u {EMAIL}:{PASSWORD} https://<ms_ip_or_DNS>:TLSPort/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"
}

2. إزالة إصدارات PHP الأقدم من 7.0

يتحقّق نص التثبيت البرمجي من إصدارات PHP السابقة للإصدار 7.0 على النظام قبل بدء التثبيت. إذا كانت هناك إصدارات من PHP أقدم من 7.0، ستظهر رسالة التحذير التالية:

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 وRedHat Enterprise Linux (RHEL)، يمكنك إزالة حِزم PHP باستخدام الأمر التالي:

yum remove <package-name>

3- تثبيت Postgres

تتطلّب البوابة تثبيت Postgres قبل أن تتمكّن من تثبيت البوابة. يمكنك إما تثبيت Postgres كجزء من تثبيت Edge، أو تثبيت Postgres بشكل مستقل لاستخدامه من قِبل البوابة.

• إذا كنت تتصل بـ Postgres المثبَّت كجزء من Edge، وتم ضبط Postgres في الوضع الرئيسي/الاحتياطي، حدِّد عنوان IP لخادم Postgres الرئيسي.
• إذا ثبّت Postgres بشكل مستقل، يمكن أن يكون على العقدة نفسها مثل البوابة.

للحصول على معلومات حول تثبيت Postgres كجزء من تثبيت Edge، يُرجى الاطّلاع على تثبيت مكوّنات Edge على عقدة.

لتثبيت Postgres المستقل:

1. ثبِّت الأداة المساعدة apigee-setup في Edge على العقدة باستخدام إجراء الإنترنت أو إجراء غير الإنترنت. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.
2. أنشئ ملف إعداد لـ Postgres، كما هو موضّح أدناه:
   
   # The pod and region of Postgres. استخدِم القيم التلقائية الموضّحة أدناه.
   MP_POD=gateway
   REGION=dc-1
   
   # Set the Postgres password. القيمة التلقائية هي "postgres".
   PG_PWD=postgres
3. في موجِّه الأوامر، شغِّل نص التهيئة البرمجي لتثبيت Postgres:
   > /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile
   
   يحدِّد الخيار "‎-p pdb" تثبيت Postgres.
   
   يجب أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل مستخدم "apigee".

4. تثبيت البوابة

لتثبيت البوابة، اتّبِع الخطوات التالية:

1. ثبِّت الأداة المساعدة apigee-setup في Edge على العقدة باستخدام الإجراء المتصل بالإنترنت أو غير المتصل بالإنترنت. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.
2. تأكَّد من تثبيت Postgres، إما Postgres المستقل أو كجزء من تثبيت Edge.
3. في موجّه الأوامر، شغِّل نص التهيئة البرمجي:
   > /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
   
   يحدّد الخيار "‎-p dp" تثبيت البوابة.
   
   يجب أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل مستخدم "apigee".
4. انتقِل إلى الصفحة الرئيسية للبوابة على http://localhost:8079 أو إلى اسم نظام أسماء النطاقات لبوابتك.
5. سجِّل الدخول إلى البوابة باستخدام بيانات اعتماد المشرف التي ضبطتها في ملف الإعداد.

5- تأكَّد من تفعيل وحدة "مدير التحديث" (Update manager)

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

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

> drush pm-info update

عليك تنفيذ هذا الأمر من الدليل الجذري للموقع الإلكتروني. By default, the Developer Portal is installed at /opt/apigee/apigee-drupal. لذلك، يجب أولاً تغيير الدليل إلى ‎/opt/apigee/apigee-drupal قبل تشغيل الأمر. إذا لم تثبّت البوابة في الدليل التلقائي، انتقِل إلى دليل التثبيت.

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

6. ضبط محرك بحث 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.

7. تثبيت SmartDocs (اختياري)

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

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

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

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

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

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