تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إعداد مؤسسة

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

استخدِم النص البرمجي setup-org لتنفيذ عملية الإعداد. يجب تشغيل النص البرمجي على عقدة "خادم الإدارة".

لإعداد مؤسسة:

ثبِّت apigee-provision على عقدة "خادم الإدارة":

/opt/apigee/apigee-service/bin/apigee-service apigee-provision install

شغِّل النص البرمجي setup-org في عقدة خادم الإدارة:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
يجب أن يكون ملف الإعداد قابلاً للقراءة من قِبل مستخدم "apigee". للحصول على مثال على ملف الإعداد ، يُرجى الاطّلاع على ملف إعداد الربط.
تأكَّد من أنّك أتممت عملية إعداد مؤسسة بنجاح. لإجراء ذلك، يمكنك تسجيل الدخول إلى واجهة المستخدم من خلال طلب عنوان URL التالي في متصفّح:
```
http://IP_address:9000/login
```
حيث يكون IP_address هو عنوان IP للخادم الذي تم تثبيت واجهة مستخدم Edge عليه.

لمعرفة خطوات التحقّق الإضافية، يُرجى الاطّلاع على مقالة التحقّق من عملية الإعداد.
أنشئ أول خادم وكيل لك.

ملف إعداد عملية الإعداد

لإجراء عملية ضبط صامتة باستخدام النص البرمجي setup-org، عليك تمرير ملف إعداد باستخدام الخيار -f، كما هو موضّح في المثال التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

يتضمّن هذا القسم نموذج ملف إعداد لإعداد مؤسسة باستخدام setup-org.

عند إعداد مؤسسة، ينفِّذ نص setup-org البرمجي ما يلي:

لإنشاء مؤسسة جديدة.
لإنشاء بيئة
تُنشئ مضيفًا افتراضيًا للبيئة.
تعيين المستخدم المحدّد كمشرف المؤسسة يُرجى مراعاة ما يلي:
- يمكنك استخدام مستخدم حالي أو إنشاء مستخدم جديد لمشرف المؤسسة.
- يجب ألّا يكون مشرف المؤسسة هو نفسه مشرف النظام.
تربط المؤسسة بمجموعة "المدخل". (هذا هو الخيار التلقائي ولا يمكن تغييره.)
ربط البيئة بجميع معالجات الرسائل.
تفعيل الإحصاءات

انسخ المثال التالي وعدِّله حسب الحاجة لإعداد مؤسستك:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator.
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name.
ENV_NAME=prod  # lowercase only

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host,
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001"

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.

# Specify the analytics group.
# AXGROUP=axgroup-001 # Default name is axgroup-001.

ملاحظات:

بالنسبة إلى VHOST_ALIAS، إذا كان لديك سجلّ نظام أسماء النطاقات الذي ستستخدمه للوصول إلى المضيف الافتراضي، حدِّد اسم مضيف البديل والمنفذ اختياريًا، على سبيل المثال، "myapi.example.com". إذا لم يكن لديك سجلّ DNS حتى الآن، يمكنك استخدام عنوان IP لجهاز التوجيه.

لمزيد من المعلومات حول كيفية ضبط المضيف الظاهري، يمكنك الاطّلاع على إعداد مضيف افتراضي.
لضبط بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL)، اطّلِع على ملفات تخزين المفاتيح وملفات تخزين الثقة وضبط إمكانية الوصول إلى بروتوكول أمان طبقة النقل (TLS) لواجهة برمجة التطبيقات في "سحابة خاصة" للحصول على مزيد من المعلومات عن إنشاء ملف JAR، وتفاصيل أخرى حول ضبط بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL).
لمزيد من المعلومات عن ضبط المضيفين الظاهريين، يُرجى الاطّلاع على مقالة ضبط الوصول إلى واجهة برمجة التطبيقات باستخدام بروتوكول النقل الآمن (TLS) في "السحابة الخاصة".
لا يمكنك إنشاء مؤسستَين بالاسم نفسه. في هذه الحالة، ستفشل عملية الإنشاء الثانية.

لمزيد من المعلومات عن استخدام Management API لإعداد مؤسسة، يُرجى الاطّلاع على مقالة إنشاء مؤسسة وبيئة ومضيف افتراضي.

التحقّق من عملية الإعداد

عند اكتمال عملية الإعداد، تحقَّق من حالة النظام من خلال إصدار أوامر CURL التالية على عقدة "خادم الإدارة":

تحقَّق من حالة المستخدم والمؤسسة على "خادم الإدارة" من خلال تنفيذ يليه: الأوامر:

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments

يمكنك التحقّق من الإحصاءات من خلال تنفيذ الأمر التالي:

curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus

تحقَّق من حالة قاعدة بيانات PostgreSQL من خلال تنفيذ الأوامر التالية على العقدة 2 (كما هو موضّح في تصاميم التركيب):
```
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
```
في موجه الأوامر، أدخِل الأمر التالي لعرض جدول الإحصاءات لمؤسستك:
```
\d analytics."org_name.env_name.fact"
```
استخدِم الأمر التالي للخروج من psql:
```
\q
```
الوصول إلى واجهة مستخدم Apigee Edge باستخدام متصفح ويب وتذكَّر أنّك لاحظت من قبل عنوان URL الخاص بوحدة تحكّم الإدارة في نهاية عملية التثبيت.
1. شغِّل متصفّحك المفضَّل وأدخِل عنوان URL لواجهة مستخدم Edge. ويشبه ما يلي، حيث يكون عنوان IP للعقدة 1 (كما هو موضّح في طوبولوجيات التثبيت)، أو أي عقدة تم تثبيت واجهة المستخدم عليها لإعدادات بديلة:
```
http://192.168.56.111:9000/login
```
  9000 هو رقم المنفذ الذي تستخدمه واجهة المستخدم.
  
  إذا كنت بصدد تشغيل المتصفّح مباشرةً على الخادم الذي يستضيف واجهة مستخدم Edge، يمكنك استخدام عنوان URL بالشكل التالي:
```
http://localhost:9000/login
```
  ملاحظة: تأكَّد من أنّ المنفذ 9000 مفتوح. في حال استخدام خدمة، مثل Google Cloud Engine، قد تحتاج إلى تعديل قواعد جدار الحماية كي تتمكّن من الوصول إلى خدمات Apigee عبر أحد المتصفحات.
2. في صفحة تسجيل الدخول إلى وحدة التحكّم، حدِّد اسم المستخدم أو كلمة المرور لمشرف نظام Apigee.
  ملاحظة: هذه هي كلمة مرور مشرف النظام الشاملة التي ضبطتها أثناء التثبيت.
اشترِك في حساب مستخدم جديد على Apigee واستخدِم بيانات اعتماد المستخدم الجديد لتسجيل الدخول. في صفحة تسجيل الدخول إلى وحدة التحكّم، انقر على الزر تسجيل الدخول.

يعيد المتصفّح التوجيه إلى http://192.168.56.111:9000/platform/#/org_name/ ويفتح لوحة بيانات تتيح لك ضبط المؤسسة التي أنشأتها (في حال تسجيل الدخول باستخدام بيانات اعتماد مشرف Apigee).

إنشاء أول خادم وكيل

بعد إعداد مؤسسة جديدة والتأكّد من نجاح عملية الإعداد، يمكنك الآن إنشاء الخادم الوكيل الأول. للمزيد من المعلومات، راجِع إنشاء أول خادم وكيل لواجهة برمجة التطبيقات.

تشمل المراجع الأخرى التي قد تجدها مفيدة ما يلي: