تثبيت وتكوين وإدارة إضافة Z Understand and Refactor في نشر IBM Bob المحلي القائم.

Z Understand and Refactor هي إضافة IBM Z Premium Package اختيارية لـ IBM Bob المحلي. تُوسّع نشر Bob Core الأساسي بقدرات تحليل تطبيقات z/OS وتحديثها. يجب تفعيل الإضافة على مستوى البنية التحتية وتعيينها للمستخدمين قبل استخدامها. لمزيد من المعلومات، راجع إدارة الاستحقاقات.

يوفر Z Understand تحليلاً آلياً لأصول تطبيقات z/OS بما فيها كود COBOL وPL/I وJCL وHLASM. يعرض Refactor الخدمات التي يستخدمها ملحق IBM Bob IDE لتوليد توصيات التحديث.

المتطلبات الأساسية

قبل تثبيت وتكوين حِمل عمل Z Understand and Refactor، تأكد من استيفاء المتطلبات الأساسية التالية:

تم تثبيت نشر IBM Bob المحلي وتشغيله. لمزيد من المعلومات، راجع التثبيت.

تتوفر قاعدة بيانات علائقية مدعومة ويمكن الوصول إليها من مجموعة Red Hat OpenShift Container Platform (OCP):

Db2: المنفذ الافتراضي 50000
Microsoft SQL Server: المنفذ الافتراضي 1433

تتوفر صلاحيات cluster-admin، أو صلاحيات معادلة، لمجموعة OCP المستهدفة.

تم تكوين ملف config.yaml بقيمة instanceNamespace المناسبة لنشرك.

نظرة عامة على الإعداد

تفعيل حِمل العمل

في config.yaml، فعّل Z Understand:

bob:
  understand:
    enabled: true

طبّق التكوين:

# تثبيت جديد
./bobctl install

# تثبيت قائم
./bobctl upgrade

تكوين Z Understand

أنشئ ملف تكوين setup.json من النموذج الخاص بقاعدة البيانات:

لـ Db2:

cp setup.sample.ocp.db2.json setup.json

لـ SQL Server:

cp setup.sample.ocp.sqlserver.json setup.json

عدّل setup.json واستبدل جميع العناصر النائبة <INSERT_...> بقيم بيئتك:

الحقل	الوصف
`relationalDatabaseServer.host`	اسم مضيف أو عنوان IP لخادم قاعدة البيانات العلائقية.
`relationalDatabaseServer.port`	المنفذ المستخدم للاتصال بخادم قاعدة البيانات. استخدم `50000` لـ Db2 أو `1433` لـ Microsoft SQL Server.
`relationalDatabaseServer.username`	اسم مستخدم حساب قاعدة البيانات الذي يمتلك صلاحيات القراءة والكتابة.
`relationalDatabaseServer.password`	كلمة مرور حساب مستخدم قاعدة البيانات.
`graphDatabaseServer.password`	كلمة مرور خدمة قاعدة البيانات الرسومية الداخلية. قم بتكوينها أثناء الإعداد واحفظها بشكل آمن.
`userAccess.password`	كلمة مرور حساب مسؤول Z Understand.

ملاحظة:

لا يتطلب generalSettings.ip تكويناً يدوياً. يكتشف المتحكم تلقائياً اسم مضيف دخول المجموعة المناسب ويملأه أثناء النشر.

تشغيل الإعداد

شغّل أمر الإعداد لتخزين التكوين كـ Kubernetes Secret وتحديث Bob CR لتفعيل حِمل العمل ومراقبة حالة النشر:

./bobctl understand setup --config setup.json

يقوم الأمر بما يلي:

إنشاء Kubernetes Secret يحتوي على بيانات اعتماد قاعدة البيانات.
تحديث الموارد المخصصة لـ Bob للإشارة إلى السر.
الانتظار حتى يصل حِمل العمل إلى حالة Ready.

قد تستغرق عملية الإعداد ما يصل إلى 15 دقيقة.

العلَم	مطلوب	الافتراضي	الوصف
`--config <filepath>`	نعم	لا شيء	المسار إلى ملف تكوين `setup.json`.
`--secret-name <name>`	لا	`bobz-understand-setup`	اسم Kubernetes Secret المنشأ لتخزين التكوين.
`--no-wait`	لا	لا شيء	الخروج فوراً دون انتظار وصول حِمل العمل إلى حالة `Ready`.
`--dry-run`	لا	لا شيء	التحقق من صحة التغييرات ومعاينتها دون تطبيقها على المجموعة.

ملاحظة: لا يمكن تشغيل أمر setup إلا مرة واحدة أثناء النشر الأولي. لإدارة دورة الحياة اللاحقة، استخدم أمري enable وdisable.

التحقق من النشر

تحقق من تشغيل pods Z Understand and Refactor:

oc get pods -n <instance-namespace> -l app=ibm-bobz-understand
oc get pods -n <instance-namespace> -l app=ibm-bobz-refactor

تحقق من حالة حِمل العمل:

oc get bob <cr-name> -n <instance-namespace> \
  -o jsonpath='{.status.understand.status}'

الحالة المتوقعة: Ready

Z Understand and Refactor