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

إعداد مؤسسة

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

لإعداد مؤسسة، عليك إنشاء ملف إعداد إعداد ثم تمريره إلى الأمر 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) إلى واجهة برمجة تطبيقات للسحابة الإلكترونية الخاصة.
لا يمكنك إنشاء مؤسستين بالاسم نفسه. في هذه الحالة، لن تنجح عملية الإنشاء الثانية.

تنفيذ setup-org

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

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

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

لتنفيذ 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 عليه.

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

التحقّق من الخطوات الإرشادية

عند اكتمال عملية الإعداد، تحقَّق من حالة النظام من خلال إصدار طلبات 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).

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

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

في ما يلي مراجع أخرى قد تكون مفيدة: