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

إعداد مؤسسة

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

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

تنفيذ إعداد الإعداد

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

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

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

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

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

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

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