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

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

قبل تثبيت بوابة خدمات مطوّري البرامج في Apigee (أو البوابة)، يُرجى التأكُّد مما يلي:

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

لا تتضمّن أداة التثبيت سوى الوحدات التي تساهم بها Drupal والمطلوبة من قِبل بوابة Apigee Developer Services (أو ببساطة البوابة). لمزيد من المعلومات عن تثبيت الوحدات الأخرى التي ساهمت بها، يُرجى الاطّلاع على توسيع نطاق عمل Drupal 7.

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

لتثبيت البوابة، عليك تنفيذ الخطوات التالية. يتم وصف كل خطوة من هذه الخطوات في بمزيد من التفصيل في الأقسام التالية.

1. اختبار الاتصال
2. إزالة الإصدارات السابقة على 7.0 للغة PHP
3. تثبيت Postgres
4. تثبيت البوابة
5. التأكُّد من تفعيل "مدير التحديثات"
6. (اختياري) ضبط Apache Solr
7. (اختياري) تثبيت Smart Docs
8. (اختياري) ضبط JQuery

إيقاف موقع SMTPSSL

لقد استخدمت السمة SMTPSSL في الإصدارات السابقة لتنفيذ ما يلي: تعيين البروتوكول الذي يستخدمه خادم SMTP المتصل بالمدخل. تم استخدام هذا الموقع نهائيًا.

أنت الآن تستخدم السمة SMTP_PROTOCOL، بدلاً من السمة SMTPSSL، وذلك لضبط والبروتوكول الذي يستخدمه خادم SMTP المتصل بالمدخل. القيم الصالحة هي: "standard", "ssl" أو "tls".

إنشاء ملف إعداد البوابة

يظهر أدناه مثال على ملف إعداد صامت لتثبيت بوابة. تعديل هذا الملف حسب ما يلزم لتهيئتك. استخدِم الخيار -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=PORTAL_ADMIN_PASSWORD
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=ORG_ADMIN_PASSWORD

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

# Optionally configure the SMTP server used by the portal.
# If you do, 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

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the
# SMTPSSL property. That property has been deprecated.
SMTP_PROTOCOL="standard"

# 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=YOUR_EMAIL_PASSWORD

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.

في حال نجاح الإجراء، تعرض curl ردًا مشابهًا لما يلي:

{
  "createdAt" : 1348689232699,
  "createdBy" : "USERNAME",
  "displayName" : "cg",
  "environments" : [ "test", "prod" ],
  "lastModifiedAt" : 1348689232699,
  "lastModifiedBy" : "foo@bar.com",
  "name" : "cg",
  "properties" : {
    "property" : [ ]
  },
  "type" : "trial"
}

2. إزالة الإصدارات السابقة على 7.0 للغة PHP

يفحص البرنامج النصي للتثبيت إصدارات PHP ما قبل 7.0 على النظام قبل بدء التثبيت. في حال وجود إصدارات أقدم من 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

قم بإزالة حزم PHP باستخدام الأمر التالي:

yum remove package_name

إذا لم تكن متأكدًا من تثبيت لغة PHP على خادمك، فاستخدم الأمر التالي:

rpm -qa | grep -i php

3- تثبيت Postgres

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

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

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

لتثبيت تطبيق Postgres بشكل مستقل:

1. تثبيت أداة Edge apigee-setup على العقدة باستخدام إجراءً عبر الإنترنت أو غير متصل بالإنترنت. عرض ثبِّت الأداة المساعدة لإعداد apigee من Edge للحصول على المزيد من المعلومات.
2. أنشئ ملف إعداد Postgres، كما يبيِّن المثال التالي:

   # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost
   HOSTIP=$(hostname -i)
   
   # The pod and region of Postgres. Use the default values shown below.
   MP_POD=gateway
   REGION=dc-1
   
   # Set the Postgres password. The default value is 'postgres'.
   PG_PWD=postgres

3. في موجه الأوامر، شغّل النص البرمجي للإعداد لتثبيت Postgres:

   /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f postgres_config_file

   يحدِّد الخيار -p pdb تثبيت Postgre. يجب أن يمكن الوصول إليها أو قراءتها بواسطة "apigee" المستخدم.

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

قبل أن تتمكن من تثبيت البوابة، تأكد من إجراء ما يلي كما هو موضح في 3. تثبيت Postgres:

1. تثبيت أداة Edge apigee-setup على عقدة البوابة
2. تثبيت Postgres، إما بشكل مستقل أو كجزء من تثبيت Edge

لتثبيت البوابة:

1. في موجِّه الأوامر، شغِّل النص البرمجي "setup":

   /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile

   المكان:

   • configFile هو ملف إعداد البوابة كما هو موضَّح في إنشاء ملف إعداد البوابة
   • توجه -p dp النص البرمجي setup لتثبيت البوابة.

للتحقُّق من تثبيت البوابة بنجاح:

1. الانتقال إلى صفحة البوابة الرئيسية على http://localhost:8079 أو إلى اسم نظام أسماء النطاقات للبوابة.
2. سجِّل الدخول إلى البوابة باستخدام بيانات اعتماد المشرف التي ضبطتها في البوابة. ملف الإعداد.
3. اختَر التقارير >. تقرير الحالة في قائمة Drupal للتأكد من أنك الاطّلاع على الحالة الحالية للبوابة.
4. تأكَّد من نجاح الاتصال بخادم الإدارة. إذا لم يكن كذلك:
   1. انتقِل إلى صفحة "ضبط اتصال البوابة" (على سبيل المثال، http://portal_IP:8079/admin/config/devconnect).
   2. انقر على زر اختبار الاتصال. إذا كان الاتصال ناجحًا، لقد انتهيتَ. إذا تعذَّر الاتصال، يمكنك المتابعة.
   3. تحقَّق من إعدادات المصادقة ونقطة النهاية:
      • عنوان URL لنقطة نهاية واجهة برمجة تطبيقات الإدارة: تأكَّد من أنّ البروتوكول (HTTP أو HTTPS) واسم IP أو اسم نظام أسماء النطاقات ورقم المنفذ؛ على سبيل المثال:

        http://10.10.10.10:8080/v1

      • مستخدم تمت مصادقته لنقطة النهاية: اسم المستخدم.
      • كلمة مرور المستخدم التي تمت مصادقتها: كلمة مرور مشرف المؤسسة وكلمة المرور.

      تعكس القيم التلقائية الإعدادات في ملف إعدادات البوابة الذي أنشأته التي تم إنشاؤها أثناء عملية التثبيت.

      يجب أن تتطابق هذه القيم مع ms_IP_or_DNS وemail و password قيمة استخدمتها في الخطوة 1: اختبِر اتصالك بـ Apigee Edge. يجب أن يتطابق اسم المستخدم وكلمة المرور أيضًا مع قيم USER_NAME. وUSER_PWD في ملف إعداد عملية الإعداد أو بيانات اعتماد أي مستخدم يكون دوره مشرف المؤسسة.

   4. بعد الاتصال بخادم الإدارة بنجاح، انقر على زر حفظ الضبط في أسفل الصفحة لحفظ التغييرات.

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

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

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

drush pm-info update

عليك تنفيذ هذا الأمر من الدليل الجذري للموقع الإلكتروني. بشكل افتراضي، تم تثبيت البوابة في /opt/apigee/apigee-drupal/wwwroot. ولذلك، يجب أولاً تغيير الدليل إلى /opt/apigee/apigee-drupal/wwwroot قبل تشغيل الأمر. إذا لم تقم بتثبيت البوابة في الدليل الافتراضي، فقم بالتغيير إلى دليل التثبيت.

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

6- إعداد محرك بحث Apache Solr (اختياري)

يتم تلقائيًا إيقاف وحدات Drupal التي تتصل بمحرك بحث Apache Solr في حال تقوم بتثبيت البوابة. تستخدم معظم البوابات محرك البحث الداخلي Drupal، وبالتالي لا وحدات Drupal Solr.

إذا قررت استخدام Solr كمحرك بحث، يجب تثبيت Solr محليًا على خادمك ثم تفعيل وضبط وحدات Drupal Solr على البوابة.

لتفعيل وحدات Drupal Solr:

1. سجِّل الدخول إلى البوابة كمستخدم لديه امتيازات المشرف أو امتياز إنشاء المحتوى.
2. اختَر الوحدات في قائمة Drupal.
3. تفعيل وحدة إطار عمل Apache Solr وApache Solr البحث.
4. احفظ التغييرات.
5. اضبط Solr على النحو الموضَّح في https://drupal.org/node/1999280.

7. تثبيت Smart Docs (اختياري)

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

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

عليك أيضًا تفعيل Smart Docs على البوابة. لمزيد من المعلومات حول تطبيق Smart Docs، يمكنك الاطّلاع على استخدام Smart Docs لتوثيق API.

8. ضبط وحدة تحديث JQuery لعمليات التثبيت التي لا تتم على الإنترنت (اختياري)

في حال تثبيت وحدة تحديث JQuery واستخدامها في عملية تثبيت غير متصلة بالإنترنت، يجب عليك إجراء ما يلي: تهيئة الوحدة لاستخدام الإصدار المحلي من JQuery. إذا قمت بتهيئة الوحدة لاستخدام شبكة توصيل محتوى (CDN) بالنسبة إلى التثبيت غير المتصل بالإنترنت، سيحاول الوصول إلى شبكة توصيل المحتوى (CDN) والتسبب في تأخير الصفحة. قيد التحميل. لمزيد من المعلومات حول وحدة تحديث JQuery، راجع https://www.drupal.org/project/jquery_update.

لإعداد وحدة تحديث JQuery لاستخدام الإصدار المحلي من JQuery:

1. سجِّل الدخول إلى البوابة كمستخدم لديه امتيازات المشرف أو امتياز إنشاء المحتوى.
2. حدد الإعداد > التطوير > تعديل JQuery في قائمة Drupal.
3. انقر على الأداء في شريط التنقّل الأيمن.
4. في القائمة المنسدلة JQuery وJQuery UI CDN، اختَر بلا.
5. انقر على حفظ الإعداد.

9. الخطوات التالية

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