إعداد مؤسسة

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

استخدِم الأمر setup-org لإجراء عملية الإعداد. يجب تشغيل الأمر على عقدة خادم الإدارة.

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

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

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

ملف الإعداد التلقائي للإعداد

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

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

الشرط الوحيد في عمليات التثبيت التلقائي هو أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل مستخدم "apigee". على سبيل المثال، يمكنك وضع الملف في الدليل ‎ /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".

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

الإعداد

  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>:<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/<orgname>/deployments
  2. إذا فعّلت الإحصاءات، استخدِم هذا الأمر:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. يمكنك أيضًا التحقّق من حالة قاعدة بيانات PostgreSQL من خلال تشغيل الأمر التالي على "الجهاز 2" لبدء psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    في موجه الأوامر، أدخِل الأمر التالي لعرض جدول الإحصاءات لمؤسستك:
    apigee=# : \d analytics."<orgname>.prod.fact"

    استخدِم الأمر التالي للخروج من psql:
    apigee=# \q
  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، يمكنك الآن إنشاء أول خادم وكيل لواجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء أول خادم وكيل لواجهة برمجة التطبيقات.