SAP BOM'u hazırlama

SAP on Azure Dağıtım Otomasyonu Çerçevesi bir Ürün Reçetesi (BOM) kullanır. BOM, SAP sistemlerinizi yapılandırmanıza yardımcı olur.

Otomasyon çerçevesinin GitHub deposu, başlamanız için kullanabileceğiniz bir dizi Örnek Malzeme Listesi içerir. Diğer SAP Uygulamaları ve veritabanları için ürün reçeteleri oluşturmak da mümkündür.

Kalıcı bağlantılar içeren bir ürün reçetesi oluşturmak istiyorsanız , bu tür bir ürün reçetesi oluşturma adımlarını izleyin.

Uyarı

Bu kılavuzda gelişmiş dağıtım konuları ele alınır. Otomasyon çerçevesinin nasıl dağıtılacağına ilişkin temel bir açıklama için bunun yerine kullanmaya başlama kılavuzuna bakın.

Önkoşullar

• Henüz yapmadıysanız SAP yükleme medyanızı ve ilgili dosyalarınızı alın, indirin ve hazırlayın.
  • Azure depolama hesabınızda SAP Uygulaması (DB) veya HANA medyası.
• BOM dosyasıyla çalışmak için bir YAML düzenleyicisi.
• Uygulama yükleme şablonları:
  • SAP Central Services (SCS)
  • SAP Birincil Uygulama Sunucusu (PAS)
  • SAP Ek Uygulama Sunucusu (AAS)
• SAP medyası edinmek için oluşturduğunuz klasöre gerekli dosyaların indirilmesi. Daha fazla bilgi için temel ürün reçetesi hazırlama nasıl yapılır kılavuzuna bakın.
• SAP Download Basket bildiriminizin bir kopyası, SAP medyası almak için oluşturduğunuz klasöre indirildi.
  • Postman yardımcı programının yüklemesi.
• Bir Azure aboneliği. Henüz bir Azure aboneliğiniz yoksa ücretsiz bir hesap oluşturun.
• Kullanmak istediğiniz veritabanıyla çalışma izinlerine sahip bir SAP hesabı.
• BOM'u doğrulamak için Linux türünde komutlar çalıştıran bir sistem. yamllint ve ansible-lint komutlarını sisteme yükleyin.

Betikli oluşturma işlemi

Bu işlem , el ile ürün reçetesi oluşturma işlemiyle aynı adımları otomatikleştirir. Bu işlemi kullanmadan önce betik sınırlamalarını gözden geçirin.

1. Yığın dosyaları klasörünüze gidin.

   cd stackfiles
   

2. Malzeme Listesi oluşturma betiğini çalıştırın. Örnek yolu yardımcı programlar klasörünüz için doğru yolla değiştirin. Örneğin:

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

3. Ürün parametresi ()product için SAP ürün adını girin. Örneğin, SAP_S4HANA_1809_SP4. Bir değer girmezseniz, betik üst üste binmiş XML dosyasından adı belirlemeye çalışır.

4. Oluşturulan bom.yml dosyayı gözden geçirmek üzere açın.

5. Şablonlar bölümünü (templates) gözden geçirin. file ve override_target_location değerlerinin doğru olduğundan emin olun. Gerekirse, bu satırları düzenleyin ve açıklama satırı ekleyin. Örneğin:

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

6. Yığın dosyaları bölümünü (stackfiles) gözden geçirin. Öğe adlarının ve dosyalarının doğru olduğundan emin olun. Gerekirse bu satırları düzenleyin.

Betik sınırlamaları

Otomatik ürün reçetesi oluşturma süreci aşağıdaki sınırlamalara sahiptir.

Betiğin HANA2'ye sabit kodlanmış bir bağımlılığı vardır. Parça listesi (BOM) dosyanızı gerekli bağımlılık adıyla eşleşecek şekilde el ile düzenleyin. Örneğin:

dependencies:
  - name: "HANA2"

Medya parametreleri override_target_filename:, override_target_location ve version: için varsayılan değer yoktur. Bu parametreleri değiştirmek için Malzeme Listesi (BOM) dosyanızı el ile düzenleyin. Örneğin:

   - 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 Bakım Planlayıcısı'nın tanımladığı medya dosyaları için betik yalnızca girdiler oluşturur. Bu sınırlama, yığın .xsl dosyasını işlediğinden oluşur. İndirme sepetinize SAP Launchpad gibi yollarla dosyalar eklediğinizde, bu dosyaları Ürün Ağaçları Listesi'ne elle eklemeniz gerekir.

El ile oluşturma işlemi

Ürün reçetenizi aşağıdaki manuel işlemi kullanarak oluşturabilirsiniz. Bir diğer seçenek de aynı adımları gerçekleştirmek için betik oluşturma işlemini kullanmaktır.

1. SAP medyası almak için oluşturduğunuz indirmeler klasörünü açın

2. adlı bom.ymlboş bir YAML dosyası oluşturun.

3. bom.yml'ı bir düzenleyicide açın.

4. Derleme ve hedef adlarını içeren bir BOM üst bilgisi ekleyin. Değer name , depolama hesabınızdaki BOM klasörü adıyla aynı olmalıdır. Örneğin:

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

5. Hedef konuma sahip bir varsayılanlar bölümü ekleyin. Yükleme dosyalarını kopyalamak istediğiniz hedef sunucudaki klasörün yolunu kullanın. Genellikle aşağıdaki gibi kullanın {{ target_media_location }} :

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

6. Ürün tanımlayıcıları bölümü ekleyin. Bu değerleri daha sonra şablon hazırlığı kapsamında doldurursunuz. Örneğin:

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

7. Gerekli malzemelerin listesini belirtmek için bir malzeme bölümü ekleyin. Bu bölüme diğer ürün reçetelerine bağımlılıkları ekleyin. Örneğin:

   materials:
   dependencies:
       - name:     HANA2
   

8. BOM'unuza dahil edilecek medya listesini alın.

   1. İndirme sepeti çalışma sayfanızı açın. Bu dosya XML olarak işlenir.

   2. Gerekirse XML içeriğini insan tarafından okunabilir olacak şekilde biçimlendirin.

   3. İndirme sepetindeki her öğe için String ve Number verilerini not edin. Veriler String dosya adını (örneğin, igshelper_17-10010245.sar) ve anlaşılır bir açıklama (örneğin, SAP IGS Fonts and Textures) sağlar. Ürün reçetesinizdeki her girdiden Number sonra verileri kaydedersiniz.

9. Medya listesini bom.yml öğesine ekleyin. Bu öğelerin sırası önemli değildir, ancak okunabilirlik için ilgili öğeleri birlikte gruplandırmak isteyebilirsiniz. SAP indirme sepetiniz bu yardımcı programı içerse bile ayrı olarak ekleyin SAPCAR . Örneğin:

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

10. İsteğe bağlı olarak, hedef medya konumunu geçersiz kılmanız gerekiyorsa, parametresini override_target_location bir medya öğesine ekleyin. Örneğin, override_target_location: "{{ target_media_location }}/config".

11. Boş şablonlar bölümü ekleyin.

    templates:
    

12. Yığın dosyaları bölümü oluşturun. Örneğin:

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

13. Değişikliklerinizi olarak bom.ymlkaydedin.

Kalıcı bağlantılar

İşlevleri olan temel bir ürün reçetesini otomatik olarak oluşturabilirsiniz. Ancak, BOM varsayılan olarak SAP medyasına kalıcı URL'ler (kalıcı bağlantılar) oluşturmaz. Kalıcı bağlantılar oluşturmak istiyorsanız SAP medyasını edinmeden önce daha fazla adım uygulamanız gerekir.

Uyarı

Tam SAP BOM'un kalıcı bağlantılarla el ile oluşturulması , temel ürün reçetesinin el ile hazırlanmasından yaklaşık iki kat daha uzun sürer.

Permalink'leri olan bir BOM oluşturmak için:

1. DownloadBasket.json düzenleyicide açın.

2. Her sonuç için satırın içeriğini not edin Value . Örneğin:

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

3. İlk ve dördüncü değerleri dikey çubuklarla ayırarak aşağı kopyalayın.

   1. İlk değer dosya numarasıdır. Örneğin, 0020000000703122018.

   2. Dördüncü değer, medya listenizle eşleştirmek için kullanacağınız sayıdır. Örneğin, 61489.

   3. İsteğe bağlı olarak, dosya türünü gösteren ikinci değeri kopyalayın. Örneğin, SP_B çekirdek ikili dosyaları için, SPAT çekirdek olmayan ikili dosyalar için ve CD veritabanı dışarı aktarmaları için.

4. İndirme sepetinizi medya listenize eşleştirmek için dördüncü değeri anahtar olarak kullanın. Değerleri (örneğin, 61489) medya öğeleri için açıklama olarak eklediğiniz değerlerle (örneğin, # 61489) eşleştirin.

5. bom.yml içinde eşleşen her giriş için, SAP URL'si adına yeni bir değer ekleyin. URL için, https://softwaredownloads.sap.com/file/ ve bu öğenin üçüncü değerini (örneğin, 0020000000703122018) kullanın. Örneğin:

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

Örnek ürün reçetesi dosyası

Aşağıdaki örnek, S/4HANA 1909 SP2 için örnek bom dosyasının küçük bir parçasıdır.

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"

BOM'u Doğrula

Bom yapınızı Linux türü komutları çalıştıran herhangi bir işletim sisteminden doğrulayabilirsiniz. Windows için Linux için Windows Alt Sistemi 'ni (WSL) kullanın. Başka bir seçenek, BOM dosyasının bir kopyası varsa dağıtımı gerçekleştiren uygulamanızdan doğrulamayı çalıştırmaktır.

1. BOM'unuzu içeren dizinden doğrulama betiğini check_bom.sh çalıştırın. Örneğin:

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

2. Çıktıyı gözden geçirin.

Başarılı doğrulama

Başarılı bir doğrulama aşağıdaki çıkışı gösterir. Eğitici gereksinimler kısmında yamllint ve ansible-lint komutlarını zaten yüklediniz.

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

Başarısız doğrulama

Başarısız bir doğrulama hata bilgileri içeriyor. Örneğin:

../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]

Malzeme listenizi yükleyin

Malzeme Listesini (BOM) kalıcı bağlantılarla kullanmak için:

1. Ürün reçetesini doğrulayın.

2. Azure portalınaoturum açın.

3. Azure hizmetleri'nin altında Kaynak grupları'yı seçin. Alternatif olarak, arama çubuğuna da girin resource groups .

4. SAP Kitaplığınız için kaynak grubunu seçin.

5. Kaynak grubu sayfasında Kaynaklar tablosunda depolama hesabını saplib seçin.

6. Depolama hesabı sayfasının menüsünde Veri depolama altında Kapsayıcılar'ı seçin.

7. Kapsayıcıyı sap bits seçin.

8. Kapsayıcı sayfasında arşivlerinizi ve araçlarınızı karşıya yükleyin.

   1. "Yükle düğmesini seçin."

   2. Dosya Seç seçin.

   3. Daha önce oluşturduğunuz indirme dizinine gidin.

Sonraki adımlar

SAP Uygulama Ürün Reçetesi nasıl oluşturulur?