تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

إعداد مؤسسة

لإعداد مؤسسة، عليك إنشاء ملف إعدادات ثم تمريره إلى الأمر setup-org. يتم شرح كل خطوة من هذه الخطوات في الأقسام التالية.

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

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

يتضمّن هذا القسم نموذجًا لملف إعداد من أجل إعداد مؤسسة باستخدام 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". إذا لم يكن لديك سجلّ نظام أسماء نطاقات حتى الآن، يمكنك استخدام عنوان IP الخاص بجهاز التوجيه.

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

تنفيذ setup-org

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

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

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

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

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

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

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