إعداد مؤسسة

Edge for Private Cloud الإصدار 4.17.05

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

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

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

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

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

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

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

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

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=adminPassword     # 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
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

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

ملاحظات:

إجراء الإعداد

  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" من الوصول إلى ملف الإعداد أو قراءته.

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

بعد إكمال عملية الإعداد، تحقَّق من حالة النظام من خلال إصدار أوامر 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، يمكنك الآن إنشاء أول خادم وكيل لواجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء أول خادم وكيل لواجهة برمجة التطبيقات.

      يمكنك أيضًا الاطّلاع على الأقسام الخاصة بالنماذج، بما في ذلك قائمة العيّنات وواجهات برمجة التطبيقات RESTful المستهدفة الوهمية التي يمكنك استخدامها في تجارب إنشاء واجهات برمجة التطبيقات الخاصة بك على Mock Target API.