Menyiapkan SAP BOM

2025-04-03

Kerangka Kerja Otomatisasi Penyebaran SAP di Azure menggunakan Bill of Materials (BOM). BOM membantu mengonfigurasi sistem SAP Anda.

Repositori GitHub kerangka otomatisasi berisi sekumpulan BOM Sampel yang dapat Anda gunakan untuk memulai. Dimungkinkan juga untuk membuat BOM untuk Aplikasi dan database SAP lainnya.

Jika Anda ingin membuat BOM yang menyertakan permalink, ikuti langkah-langkah untuk membuat jenis BOM ini.

Nota

Panduan ini mencakup topik penyebaran tingkat lanjut. Untuk penjelasan dasar tentang cara menyebarkan kerangka kerja otomatisasi, lihat panduan memulai sebagai gantinya.

Prasyarat

Dapatkan, unduh, dan siapkan media penginstalan SAP Anda dan file terkait jika Anda belum melakukannya.
- Aplikasi SAP (DB) atau media HANA di akun penyimpanan Azure Anda.
Editor YAML untuk bekerja dengan file BOM.
Templat penginstalan aplikasi untuk:
- Layanan Pusat SAP (SCS)
- Server Aplikasi Utama SAP (PAS)
- Server Aplikasi Tambahan SAP (AAS)
Unduhan file tumpukan yang diperlukan ke folder yang Anda buat untuk memperoleh media SAP. Untuk informasi selengkapnya, lihat panduan panduan persiapan BOM dasar.
Salinan manifes SAP Download Basket Anda (DownloadBasket.json), diunduh ke folder yang Anda buat untuk memperoleh media SAP.
- Penginstalan utilitas Postman.
Langganan Azure. Jika Anda belum memiliki langganan Azure, buat akun gratis.
Akun SAP dengan izin untuk bekerja dengan database yang ingin Anda gunakan.
Sistem yang menjalankan perintah jenis Linux untuk memvalidasi BOM. Instal perintah yamllint dan ansible-lint pada sistem.

Proses pembuatan skrip

Proses ini mengotomatiskan langkah yang sama dengan proses pembuatan BOM manual. Tinjau batasan skrip sebelum menggunakan proses ini.

Navigasikan ke folder file tumpukan Anda.
```
cd stackfiles
```
Jalankan skrip generasi BOM. Ganti jalur contoh dengan jalur yang benar ke folder utilitas Anda. Contohnya:
```
cd ~/Azure_SAP_Automated_Deployment/deploy/scripts/generate_bom.sh >../bom.yml
```
Untuk parameter produk (product), masukkan nama produk SAP. Contohnya, SAP_S4HANA_1809_SP4. Jika Anda tidak memasukkan nilai, skrip mencoba menentukan nama dari file XML tumpukan.
Buka file yang dihasilkan bom.yml untuk ditinjau.

Tinjau bagian templat (templates). Pastikan nilai file dan override_target_location sudah benar. Jika perlu, edit dan komentari baris tersebut. Contohnya:

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

Tinjau bagian file tumpukan (stackfiles). Pastikan nama item dan file sudah benar. Jika perlu, edit baris tersebut.

Batasan skrip

Proses pembuatan BOM berskrip memiliki batasan berikut.

Pembuatan skrip memiliki ketergantungan yang dikodekan secara permanen pada HANA2. Edit file BOM Anda secara manual agar sesuai dengan nama dependensi yang diperlukan. Contohnya:

dependencies:
  - name: "HANA2"

Tidak ada nilai bawaan untuk parameter override_target_filename:, override_target_location, dan version:. Edit file BOM Anda secara manual untuk mengubah parameter ini. Contohnya:

   - 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"

Skrip hanya menghasilkan entri untuk file media yang diidentifikasi oleh Perencana Pemeliharaan SAP. Batasan ini terjadi karena memproses file tumpukan .xsl . Jika Anda menambahkan file apa pun ke ke basket unduhan Anda secara terpisah, seperti melalui Launchpad SAP, Anda harus menambahkan file tersebut ke BOM secara manual.

Proses pembuatan secara manual

Anda dapat membuat BOM melalui proses manual berikut. Opsi lain adalah menggunakan proses pembuatan skrip untuk melakukan langkah yang sama.

Buka folder unduhan yang Anda buat untuk memperoleh media SAP
Buat file YAML kosong bernama bom.yml.
Buka bom.yml dalam editor.
Tambahkan header BOM yang memberikan nama untuk pembangunan dan target. Nilai name harus sama dengan nama folder BOM di akun penyimpanan Anda. Contohnya:
```
name:    'S4HANA_2020_ISS_v001'
target:  'ABAP PLATFORM 2020'
```
Tambahkan bagian default dengan lokasi target. Gunakan jalur ke folder di server target tempat Anda ingin menyalin file penginstalan. Biasanya, gunakan {{ target_media_location }} sebagai berikut:
```
defaults:
  target_location: "{{ target_media_location }}/download_basket"
```
Tambahkan bagian pengidentifikasi produk. Anda mengisi nilai-nilai ini nanti sebagai bagian dari persiapan templat. Contohnya:
```
product_ids:
  scs:
  db:
  pas:
  aas:
  web:
```
Tambahkan bagian bahan untuk menentukan daftar materi yang diperlukan. Tambahkan dependensi apa pun pada BOM lain di bagian ini. Contohnya:
```
materials:
dependencies:
    - name:     HANA2
```
Dapatkan daftar media untuk disertakan dalam BOM Anda.
1. Buka spreadsheet keranjang unduhan Anda. File ini dirender sebagai XML.
2. Format konten XML agar dapat dibaca manusia, jika perlu.
3. Untuk setiap item dalam keranjang unduhan, perhatikan data String dan Number. Data String menyediakan nama file (misalnya, igshelper_17-10010245.sar) dan deskripsi yang ramah (misalnya, SAP IGS Fonts and Textures). Anda akan mencatat data Number setelah setiap entri dalam Daftar Kebutuhan Material (BOM) Anda.
Tambahkan daftar media ke bom.yml. Urutan item ini tidak masalah, namun, Anda mungkin ingin mengelompokkan item terkait bersama-sama untuk keterbacaan. Tambahkan SAPCAR secara terpisah, meskipun keranjang unduhan SAP Anda berisi utilitas ini. Contohnya:
```
media:
    - name:     SAPCAR
      archive:  SAPCAR_1320-80000935.EXE

    name: "SAP IGS Fonts and Textures"
      archive: "igshelper_17-10010245.sar"
      # 61489

    <...>
```
Secara opsional, jika Anda perlu mengambil alih lokasi media target, tambahkan parameter override_target_location ke item media. Contohnya, override_target_location: "{{ target_media_location }}/config".
Tambahkan bagian templat kosong.
```
templates:
```

Buat bagian berkas tumpukan. Contohnya:

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

  - name: Download Basket Spreadsheet
     file: MP_Excel_2001017452_20201030_SWC.xls

Simpan perubahan Anda ke bom.yml.

Permalink

Anda dapat secara otomatis menghasilkan BOM dasar yang berfungsi. Namun, BOM tidak membuat URL permanen (permalink) ke media SAP secara default. Jika Anda ingin membuat permalink, Anda perlu melakukan lebih banyak langkah sebelum memperoleh media SAP.

Nota

Pembuatan manual BOM SAP penuh dengan permalink membutuhkan waktu sekitar dua kali lebih lama dari menyiapkan BOM dasar secara manual.

Untuk menghasilkan BOM dengan permalink:

Buka DownloadBasket.json di editor Anda.

Untuk setiap hasil, perhatikan konten Value baris. Contohnya:

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

Salin nilai pertama dan keempat yang dipisahkan oleh bilah vertikal.
1. Nilai pertama adalah nomor file. Contohnya, 0020000000703122018.
2. Nilai keempat adalah angka yang akan Anda gunakan untuk mencocokkan dengan daftar media Anda. Contohnya, 61489.
3. Secara opsional, salin nilai kedua, yang menunjukkan jenis file. Misalnya, SP_B untuk file biner kernel, SPAT untuk file biner non-kernel, dan CD untuk ekspor database.
Gunakan nilai keempat sebagai kunci untuk mencocokkan keranjang unduhan Anda dengan daftar media Anda. Cocokkan nilai (misalnya, 61489) dengan nilai yang Anda tambahkan sebagai komentar untuk item media (misalnya, # 61489).
Untuk setiap entri yang cocok di bom.yml, tambahkan nilai baru untuk URL SAP. Untuk URL, gunakan https://softwaredownloads.sap.com/file/ ditambah nilai ketiga untuk item tersebut (misalnya, 0020000000703122018). Contohnya:
```
- name: "SAP IGS Fonts and Textures"
  archive: "igshelper_17-10010245.sar"
  sapurl: "https://softwaredownloads.sap.com/file/0020000000703122018"
```

Contoh file BOM

Sampel berikut adalah bagian kecil dari contoh file BOM untuk 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"

Memvalidasi BOM

Anda dapat memvalidasi struktur BOM Anda dari OS apa pun yang menjalankan perintah jenis Linux. Untuk Windows, gunakan Subsistem Windows untuk Linux (WSL). Opsi lain adalah menjalankan validasi dari penyebar Anda jika ada salinan file BOM di sana.

Jalankan skrip check_bom.sh validasi dari direktori yang berisi BOM Anda. Contohnya:
```
cd ~/Azure_SAP_Automated_Deployment/deploy/scripts/check_bom.sh bom.yml
```
Tinjau output.

Validasi berhasil

Validasi yang berhasil menunjukkan output berikut. Anda sudah menginstal yamllint dan ansible-lint perintah dalam prasyarat.

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

Validasi tidak berhasil

Validasi yang tidak berhasil berisi informasi kesalahan. Contohnya:

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

Unggah BOM Anda

Untuk menggunakan BOM dengan permalink:

Validasi BOM.
Masuk ke portal Azure.
Di bawah Layanan Azure, pilih Grup sumber daya. Atau, masukkan resource groups di bilah pencarian.
Pilih grup sumber daya untuk Pustaka SAP Anda.
Pada halaman grup sumber daya, pilih akun saplib penyimpanan di tabel Sumber Daya .
Pada menu halaman akun penyimpanan, pilih Kontainer di bawah Penyimpanan data.
Pilih kontainer sap bits.
Pada halaman kontainer, unggah arsip dan alat Anda.
1. Pilih tombol Unggah .
2. Pilih Pilih file.
3. Navigasikan ke direktori unduhan yang Anda buat sebelumnya.

Langkah berikutnya

Cara menghasilkan BOM Aplikasi SAP