إعداد مكونات صنف SAP

يستخدم SAP on Azure Deployment Automation Framework فاتورة المواد (BOM). تساعد قائمة مكونات الصنف في تكوين أنظمة SAP الخاصة بك.

يحتوي مستودع GitHub لإطار عمل الأتمتة على مجموعة من نماذج قوائم مكونات الصنف التي يمكنك استخدامها للبدء. من الممكن أيضاً إنشاء قوائم مكونات الصنف لتطبيقات SAP وقواعد البيانات الأخرى.

إذا كنت تريد إنشاء قائمة مكونات الصنف التي تتضمن ارتباطات ثابتة، فاتبع الخطوات لإنشاء هذا النوع من قائمة مكونات الصنف.

إشعار

يغطي هذا الدليل مواضيع التوزيع المتقدمة. للحصول على شرح أساسي لكيفية نشر إطار عمل الأتمتة، راجع دليل البدء بدلاً من ذلك.

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

• احصل على وسائط تثبيت SAP والملفات ذات الصلة وقم بتنزيلها وإعدادها إذا لم تكن قد قمت بذلك بالفعل.
  • تطبيق SAP (DB) أو وسائط HANA في حساب تخزين Azure الخاص بك.
• محرر YAML للعمل مع ملف قائمة مكونات الصنف.
• قوالب تثبيت التطبيق ل:
  • خدمات SAP المركزية (SCS)
  • خادم التطبيق الأساسي SAP (PAS)
  • خادم التطبيقات الإضافي SAP (AAS)
• تنزيلات ملفات المكدس الضرورية إلى المجلد الذي أنشأته من أجل الحصول على وسائط SAP. لمزيد من المعلومات، راجع دليل كيفية إعداد قائمة مكونات الصنف الأساسي.
• نسخة من بيان سلة تنزيل SAP (DownloadBasket.json)، تم تنزيله إلى المجلد الذي أنشأته للحصول على وسائط SAP.
  • تثبيت أداة Postman.
• اشتراك Azure. إذا لم يكن لديك اشتراك Azure بالفعل، باشر بإنشاء حساب مجاني.
• حساب SAP مع أذونات للعمل مع قاعدة البيانات التي تريد استخدامها.
• نظام يقوم بتشغيل أوامر من نوع Linux للتحقق من صحة قائمة مكونات الصنف. قم بتثبيت الأمرين yamllint وansible-lint على النظام.

عملية إنشاء البرامج النصية

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

1. انتقل إلى مجلد ملفات المكدس.

   cd stackfiles
   

2. قم بتشغيل البرنامج النصي لإنشاء قائمة مكونات الصنف. استبدل مسار المثال بالمسار الصحيح إلى مجلد الأدوات المساعدة. على سبيل المثال:

   cd ~/Azure_SAP_Automated_Deployment/deploy/scripts/generate_bom.sh >../bom.yml
   

3. بالنسبة لمعلمة المنتج (product)، أدخل اسم منتج SAP. على سبيل المثال، SAP_S4HANA_1809_SP4. إذا لم تقم بإدخال قيمة، يحاول البرنامج النصي تحديد الاسم من ملف XML المكدس.

4. افتح الملف الذي تم إنشاؤه bom.yml للمراجعة.

5. راجع قسم القوالب (templates). تأكد من صحة قيمتي file وoverride_target_location. إذا لزم الأمر، فقم بتحرير هذه السطور والتعليق عليها. على سبيل المثال:

   templates:
     # - name:     "S4HANA_2020_ISS_v001 ini file"
     #   file:     S4HANA_2020_ISS_v001.inifile.params
     #   override_target_location: "{{ target_media_location }}/config"
   

6. راجع قسم ملفات المكدس (stackfiles). تأكد من صحة أسماء العناصر والملفات. إذا لزم الأمر، فقم بتحرير هذه الأسطر.

قيود البرنامج النصي

تتضمن عملية إنشاء قائمة مكونات الصنف المبرمجة القيود التالية.

تحتوي البرمجة النصية على تبعية تعليمات برمجية مضمّنة في HANA2. قم بتحرير ملف قائمة مكونات الصنف يدوياً لمطابقة اسم التبعية المطلوب. على سبيل المثال:

dependencies:
  - name: "HANA2"

لا توجد قيم افتراضية لمعلمات الوسائط override_target_filename: وoverride_target_location وversion:. قم بتحرير ملف قائمة مكونات الصنف يدوياً لتغيير هذه المعلمات. على سبيل المثال:

   - name:     SAPCAR
     archive:  SAPCAR_1320-80000935.EXE
     override_target_filename: SAPCAR.EXE

   - name: "SWPM20SP07"
     archive: "SWPM20SP07_2-80003424.SAR"
     override_target_filename: SWPM.SAR
     sapurl: "https://softwaredownloads.sap.com/file/0020000001812632020"

يقوم البرنامج النصي فقط بإنشاء إدخالات لملفات الوسائط التي يحددها مخطط صيانة SAP فقط. يحدث هذا القيد لأنه يعالج ملف المكدس .xsl. إذا قمت بإضافة أي ملفات إلى سلة التنزيل بشكلٍ منفصل، على سبيل المثال من خلال SAP Launchpad، فيجب عليك إضافة هذه الملفات إلى قائمة مكونات الصنف يدوياً.

عملية الإنشاء اليدوي

يمكنك إنشاء قائمة مكونات الصنف من خلال العملية اليدوية التالية. هناك خيار آخر هو استخدام عملية إنشاء البرنامج النصي للقيام بنفس الخطوات.

1. افتح مجلد التنزيلات الذي أنشأته من أجل للحصول على وسائط SAP

2. أنشئ ملف YAML فارغاً باسم bom.yml.

3. افتح bom.yml في محرر.

4. أضف رأس قائمة مكونات الصنف مع أسماء للإنشاء والهدف. يجب أن تكون القيمة name هي نفس اسم مجلد قائمة مكونات الصنف في حساب التخزين الخاص بك. على سبيل المثال:

   name:    'S4HANA_2020_ISS_v001'
   target:  'ABAP PLATFORM 2020'
   

5. أضف قسماً افتراضياً بالموقع المستهدف. استخدم المسار إلى المجلد الموجود على الخادم الهدف حيث تريد نسخ ملفات التثبيت. عادة، استخدم {{ target_media_location }} على النحو التالي:

   defaults:
     target_location: "{{ target_media_location }}/download_basket"
   

6. أضف قسم معرّفات المنتجات. يمكنك ملء هذه القيم لاحقاً كجزء من إعداد القالب. على سبيل المثال:

   product_ids:
     scs:
     db:
     pas:
     aas:
     web:
   

7. إضافة قسم المواد لتحديد قائمة المواد المطلوبة. أضف أي تبعيات على قوائم مكونات الصنف الأخرى في هذا القسم. على سبيل المثال:

   materials:
   dependencies:
       - name:     HANA2
   

8. الحصول على قائمة بالوسائط لتضمينها في قائمة مكونات الصنف الخاصة بك.

   1. افتح جدول بيانات سلة التنزيل. يتم عرض هذا الملف بتنسيق XML.

   2. قم بتنسيق محتوى XML ليكون قابلاً للقراءة البشرية، إذا لزم الأمر.

   3. لكل عنصر في سلة التنزيل، قم بتدوين البيانات String وNumber. توفر بيانات String اسم الملف (على سبيل المثال، igshelper_17-10010245.sar) ووصفاً مألوفاً (على سبيل المثال، SAP IGS Fonts and Textures). يمكنك تجيل بيانات Number بعد كل إدخال في قائمة مكونات الصنف.

9. أضف قائمة الوسائط إلى bom.yml. لا يهم ترتيب هذه العناصر، ومع ذلك، قد ترغب في تجميع العناصر ذات الصلة معاً لسهولة القراءة. أضف SAPCAR بشكلٍ منفصل، على الرغم من أن سلة تنزيل SAP تحتوي على هذه الأداة المساعدة. على سبيل المثال:

   media:
       - name:     SAPCAR
         archive:  SAPCAR_1320-80000935.EXE
   
       name: "SAP IGS Fonts and Textures"
         archive: "igshelper_17-10010245.sar"
         # 61489
   
       <...>
   

10. اختيارياً، إذا كنت بحاجة إلى تجاوز موقع الوسائط المستهدف، فأضف المعلمة override_target_location إلى عنصر وسائط. على سبيل المثال، override_target_location: "{{ target_media_location }}/config".

11. إضافة قسم قوالب فارغة.

    templates:
    

12. إنشاء قسم ملفات مكدسة. على سبيل المثال:

    stackfiles:
      - name: Download Basket JSON Manifest
         file: downloadbasket.json
    
      - name: Download Basket Spreadsheet
         file: MP_Excel_2001017452_20201030_SWC.xls
    

13. حفظ التغييرات إلى bom.yml.

الروابط الثابتة

يمكنك تلقائياً إنشاء قائمة مكونات الصنف الأساسية التي تعمل. ومع ذلك، لا تنشئ قائمة مكونات الصنف عناوين URL دائمة (روابط ثابتة) إلى وسائط SAP بشكلٍ افتراضي. إذا كنت ترغب في إنشاء روابط ثابتة، فستحتاج إلى تنفيذ المزيد من الخطوات قبل الحصول على وسائط SAP.

إشعار

يستغرق الإنشاء اليدوي لقائمة مكونات الصنف SAP الكاملة باستخدام الروابط الثابتة حوالي ضعف مدة إعداد قائمة مكونات الصنف الأساسية يدوياً.

لإنشاء قائمة مكونات الصنف باستخدام الروابط الثابتة:

1. افتح DownloadBasket.json في المحرر الخاص بك.

2. لكل نتيجة، قم بتدوين محتويات السطر Value. على سبيل المثال:

        "Value": "0020000000703122018|SP_B|SAP IGS Fonts and Textures|61489|1|20201023150931|0"
   

3. انسخ القيمتين الأولى والرابعة مفصولتين بأشرطة عمودية.

   1. القيمة الأولى هي رقم الملف. على سبيل المثال، 0020000000703122018.

   2. القيمة الرابعة هي الرقم الذي ستستخدمه لمطابقته مع قائمة الوسائط الخاصة بك. على سبيل المثال، 61489.

   3. اختيارياً، انسخ القيمة الثانية لأسفل، والتي تشير إلى نوع الملف. على سبيل المثال، SP_B لملفات kernel الثنائية، SPAT وللملفات الثنائية بخلاف kernel، وCD لصادرات قاعدة البيانات.

4. استخدم القيمة الرابعة كمفتاح لمطابقة سلة التنزيل مع قائمة الوسائط. طابق القيم (على سبيل المثال، 61489) مع القيم التي أضفتها كتعليقات لعناصر الوسائط (على سبيل المثال، # 61489).

5. لكل إدخال مطابق في bom.yml، أضف قيمة جديدة لعنوان URL لـ SAP. بالنسبة إلى عنوان URL، استخدم https://softwaredownloads.sap.com/file/ بالإضافة إلى القيمة الثالثة لهذا العنصر (على سبيل المثال، 0020000000703122018). على سبيل المثال:

   - name: "SAP IGS Fonts and Textures"
     archive: "igshelper_17-10010245.sar"
     sapurl: "https://softwaredownloads.sap.com/file/0020000000703122018"
   

مثال على ملف قائمة مكونات الصنف

النموذج التالي هو جزء صغير من مثال ملف قائمة مكونات الصنف لـ S/4HANA 1909 SP2.

step|BOM Content

---

name:    'S4HANA_2020_ISS_v001'
target:  'ABAP PLATFORM 2020'

defaults:
  target_location: "{{ target_media_location }}/download_basket"

product_ids:
  scs:
  db:
  pas:
  aas:
  web:

materials:
dependencies:
    - name:     HANA2

media:
    - name:     SAPCAR
      archive:  SAPCAR_1320-80000935.EXE

    - name:     SWPM
      archive:  SWPM20SP06_6-80003424.SAR

    - name:     SAP IGS HELPER
      archive:  igshelper_17-10010245.sar

    - name:     SAP HR 6.08
      archive:  SAP_HR608.SAR

    - name:     S4COREOP 104
      archive:  S4COREOP104.SAR

templates:
    - name:     "S4HANA_2020_ISS_v001 ini file"
      file:     S4HANA_2020_ISS_v001.inifile.params
      override_target_location: "{{ target_media_location }}/config"

stackfiles:
    - name: Download Basket JSON Manifest
      file: downloadbasket.json
      override_target_location: "{{ target_media_location }}/config"

    - name: Download Basket Spreadsheet
      file: MP_Excel_2001017452_20201030_SWC.xls
      override_target_location: "{{ target_media_location }}/config"

    - name: Download Basket Plan doc
      file: MP_Plan_2001017452_20201030_.pdf
      override_target_location: "{{ target_media_location }}/config"

    - name: Download Basket Stack text
      file: MP_Stack_2001017452_20201030_.txt
      override_target_location: "{{ target_media_location }}/config"

    - name: Download Basket Stack XML
      file: MP_Stack_2001017452_20201030_.xml
      override_target_location: "{{ target_media_location }}/config"

    - name: Download Basket permalinks
      file: myDownloadBasketFiles.txt
      override_target_location: "{{ target_media_location }}/config"

التحقق من صحة قائمة مكونات الصنف

يمكنك التحقق من صحة بنية قائمة مكونات الصنف من أي نظام تشغيل يقوم بتشغيل أوامر من نوع Linux. بالنسبة لنظام التشغيل Windows، استخدم نظام Windows الفرعي لنظام التشغيل Linux (WSL). هناك خيار آخر هو تشغيل التحقق من الصحة من الموزع الخاص بك إذا كانت هناك نسخة من ملف قائمة مكونات الصنف هناك.

1. قم بتشغيل البرنامج النصي check_bom.sh للتحقق من الصحة من الدليل الذي يحتوي على قائمة مكونات الصنف. على سبيل المثال:

   cd ~/Azure_SAP_Automated_Deployment/deploy/scripts/check_bom.sh bom.yml
   

2. راجع الإخراج.

التحقق من الصحة بنجاح

يظهر التحقق الناجح الإخراج التالي. لقد قمت بالفعل بتثبيت الأمرين yamllint وansible-lint في المتطلبات الأساسية.

... yamllint [ok]
... ansible-lint [ok]
... bom structure [ok]

التحقق من الصحة غير ناجح

تحتوي عملية التحقق غير الناجحة على معلومات خطأ. على سبيل المثال:

../documentation/ansible/system-design-deployment/examples/S4HANA_2020_ISS_v001/bom_with_errors.yml
  178:16    error    too many spaces after colon  (colons)
  179:16    error    too many spaces after colon  (colons)
  180:16    error    too many spaces after colon  (colons)
    
... yamllint [errors]
... ansible-lint [ok]
  - Expected to find key 'defaults' in 'bom' (Check name: S4HANA_2020_ISS_v001)
  - Unexpected key 'default in 'bom' (Check name: S4HANA_2020_ISS_v001)
  - Unexpected key 'overide_target_location in 'bom.materials.stackfiles' (Check name: Download Basket Stack text)
... bom structure [errors]

تحميل قائمة مكونات الصنف الخاصة بك

لاستخدام قائمة مكونات الصنف مع الروابط الثابتة:

1. التحقق من صحة قائمة مكونات الصنف.

2. سجل الدخول إلى مدخل Azure.

3. ضمن Azure services، اختر Resource groups. أو أدخِل resource groups في شريط البحث.

4. حدد مجموعة الموارد لمكتبة SAP خاصتك.

5. في صفحة مجموعة الموارد، حدد حساب التخزين saplib في جدول الموارد.

6. في قائمة صفحة حساب التخزين، حدد الحاويات ضمن تخزين البيانات.

7. حدد الحاوية sap bits.

8. في صفحة الحاوية، بادر بتحميل المحفوظات والأدوات خاصتك.

   1. حدد الزر تحميل.

   2. حدد تحديد ملف.

   3. انتقل إلى دليل التنزيل الذي قمت بإنشائه مسبقاً.

الخطوات التالية

كيفية إنشاء قائمة مكونات الصنف لتطبيق SAP