إعداد مؤسسة

Edge for Private Cloud - الإصدار 4.16.05

استخدِم الأمر setup-org لتنفيذ عملية الإعداد. يجب عليك تشغيل الأمر في عقدة Management Server.

كجزء من عملية الإعداد، يجب مراعاة ما يلي:

بشكل اختياري، يتم إنشاء مستخدم جديد ليعمل كمشرف للمؤسسة.

  • إنشاء المؤسسة.
  • إضافة المستخدم المحدَّد بصفته مشرف المؤسسة يجب أن يكون المستخدم موجودًا من قبل، وإلا سيصدر النص البرمجي خطأ.
  • تربط المؤسسة بمجموعة إعلانات متسلسلة، ويتم ربطها تلقائيًا بمجموعة الإعلانات المتسلسلة الخاصة بـ "البوابة".
  • خلق بيئة.
  • إنشاء مضيف افتراضي للبيئة.
  • ربط البيئة بجميع معالِجات الرسائل
  • تفعِّل هذه الميزة الإحصاءات.

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

مرِّر ملف الإعداد إلى الأمر setup-org. يمكنك استدعاء الأمر setup-org وتحديد الخيار -f، بما في ذلك المسار إلى ملف الإعداد الصامت:

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

الشرط الوحيد في عمليات التثبيت الصامتة هو أن يتمكن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته. على سبيل المثال، ضَع الملف في دليل /tmp على العقدة.

في ما يلي مثال على ملف إعداد صامت. عدِّله حسب الضرورة لتلبية المتطلبات:

IP1=192.168.1.1

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

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

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

#
# Set the organization administrator.
# Do not use sys admin as 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
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com

# 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

# 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".

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

الإعداد

  1. ثبِّت apigee-provision على عقدة خادم الإدارة:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. نفِّذ الأمر في عقدة خادم الإدارة:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    يجب أن يتمكن مستخدم "apigee" من الوصول إلى ملف الإعداد أو قراءته. على سبيل المثال، ضَع الملف في دليل /tmp على العقدة.

التأكّد من الإعداد

بعد إكمال عملية الإعداد، تحقَّق من حالة النظام من خلال إصدار أوامر CURL التالية في عقدة خادم الإدارة.

  1. تحقَّق من حالة المستخدم والمؤسسة على خادم الإدارة من خلال إصدار أوامر CURL التالية:
    > curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<adminpasswd> http://localhost:8080 curl -u <adminEmail>
  2. في حال تفعيل الإحصاءات، استخدِم هذا الأمر:
    > curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/محادثة/axstatus
  3. يمكنك أيضًا التحقّق من حالة قاعدة بيانات PostgreSQL من خلال تنفيذ الأمر التالي على Machine 2 لبدء تشغيل psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    في موجه الأوامر، أدخِل الأمر التالي لعرض جدول إحصاءات البيانات التالي:
    : : إدراج


  4. يمكنك الوصول إلى واجهة مستخدم Apigee Edge باستخدام متصفّح ويب. وتذكَّر أنّك لاحظت بالفعل عنوان URL الخاص بـ "وحدة تحكّم الإدارة" في نهاية التثبيت.
    1. شغِّل متصفّحك المفضّل وأدخِل عنوان URL لواجهة مستخدم Edge. ويبدو مشابهًا لما يلي، حيث يكون عنوان IP للجهاز 1، أو لأي جهاز تم تثبيت واجهة المستخدم عليه لعمليات الضبط البديلة:
      http://192.168.56.111:9000/login

      9000 هو رقم المنفذ الذي تستخدمه واجهة المستخدم. إذا كنت تبدأ تشغيل المتصفِّح مباشرةً على الخادم الذي يستضيف واجهة مستخدم Edge، يمكنك استخدام عنوان URL على النحو التالي:
      http://localhost:9000/login

      ملاحظة: تأكَّد من فتح المنفذ 9000.
    2. في صفحة تسجيل الدخول إلى وحدة التحكّم، حدِّد اسم المستخدم/كلمة المرور لمشرف نظام Apigee.
      ملاحظة: هذه هي كلمة مرور مشرف النظام العام التي تم ضبطها أثناء عملية التثبيت. بدلاً من ذلك، يمكنك:
  5. اشترِك للحصول على حساب مستخدم جديد على Apigee واستخدِم بيانات اعتماد المستخدم الجديدة لتسجيل الدخول.
    1. انقر على "تسجيل الدخول"، يعيد المتصفّح التوجيه إلى:
      http://192.168.56.111:9000/platform/#/<orgname>/

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