Przygotowywanie rozwiązania SAP BOM

2025-04-08

Platforma SAP w usłudze Azure Deployment Automation Framework używa pakietu Bill of Materials (BOM). BOM pomaga skonfigurować systemy SAP.

Repozytorium GitHub platformy automatyzacji zawiera zestaw przykładowych modułów BOM , których można użyć do rozpoczęcia pracy. Istnieje również możliwość utworzenia modułów BOM dla innych aplikacji i baz danych SAP.

Jeśli chcesz wygenerować model BOM zawierający linki permalinki, wykonaj kroki tworzenia tego typu modelu BOM.

Uwaga

W tym przewodniku opisano zaawansowane tematy dotyczące wdrażania. Aby uzyskać podstawowe wyjaśnienie sposobu wdrażania platformy automatyzacji, zobacz zamiast tego przewodnik Wprowadzenie .

Wymagania wstępne

Uzyskaj, pobierz i przygotuj nośnik instalacyjny SAP oraz powiązane pliki, jeśli jeszcze tego nie zrobiłeś.
- Aplikacja SAP (DB) lub nośnik HANA na koncie usługi Azure Storage.
Edytor YAML do pracy z plikiem BOM.
Szablony instalacji aplikacji dla:
- SAP Central Services (SCS)
- Podstawowy serwer aplikacji SAP (PAS)
- Dodatkowy serwer aplikacji SAP (AAS)
Pobieranie niezbędnych plików stosu do folderu utworzonego do uzyskania nośnika SAP. Aby uzyskać więcej informacji, zobacz podstawowe instrukcje dotyczące przygotowywania BOM.
Kopia manifestu SAP Download Basket (DownloadBasket.json) pobrana do folderu utworzonego do uzyskiwania multimediów SAP.
- Instalacja narzędzia Postman.
Subskrypcja platformy Azure. Jeśli nie masz jeszcze subskrypcji platformy Azure, utwórz bezpłatne konto.
Konto SAP z uprawnieniami do pracy z bazą danych, której chcesz użyć.
System, który uruchamia polecenia typu Linux do sprawdzania poprawności modelu BOM. Zainstaluj polecenia yamllint i ansible-lint w systemie.

Proces tworzenia skryptów

Ten proces automatyzuje te same kroki co proces ręcznego tworzenia modelu BOM. Przed rozpoczęciem korzystania z tego procesu zapoznaj się z ograniczeniami skryptu .

Przejdź do folderu plików stosu.
```
cd stackfiles
```
Uruchom skrypt generowania BOM. Zastąp przykładową ścieżkę poprawną ścieżką do swojego folderu narzędzi. Na przykład:
```
cd ~/Azure_SAP_Automated_Deployment/deploy/scripts/generate_bom.sh >../bom.yml
```
Dla parametru produktu (product) wprowadź nazwę produktu SAP. Na przykład SAP_S4HANA_1809_SP4. Jeśli nie wprowadzisz wartości, skrypt podejmie próbę określenia nazwy z pliku XML stosu.
Otwórz wygenerowany bom.yml plik do przeglądu.
Przejrzyj sekcję szablonów (templates). Upewnij się, że file wartości i override_target_location są poprawne. W razie potrzeby zmodyfikuj te wiersze i oznacz je jako komentarz. Na przykład:
```
templates:
  # - name:     "S4HANA_2020_ISS_v001 ini file"
  #   file:     S4HANA_2020_ISS_v001.inifile.params
  #   override_target_location: "{{ target_media_location }}/config"
```
Przejrzyj sekcję plików stosu (stackfiles). Upewnij się, że nazwy elementów i pliki są poprawne. W razie potrzeby zmodyfikuj te wiersze.

Ograniczenia skryptu

Skryptowy proces tworzenia modelu BOM ma następujące ograniczenia.

Skrypty mają ustaloną zależność od platformy HANA2. Ręcznie edytuj plik BOM, aby był zgodny z wymaganą nazwą zależności. Na przykład:

dependencies:
  - name: "HANA2"

Brak wartości domyślnych parametrów override_target_filename:nośnika , override_target_locationi version:. Ręcznie edytuj plik BOM, aby zmienić te parametry. Na przykład:

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

Skrypt generuje tylko wpisy dla plików multimedialnych zidentyfikowanych przez planistę konserwacji SAP. To ograniczenie występuje, ponieważ przetwarza plik stosu .xsl . W przypadku oddzielnego dodawania plików do koszyka pobierania, na przykład za pomocą programu SAP Launchpad, należy ręcznie dodać te pliki do modelu BOM.

Proces ręcznego tworzenia

Model BOM można utworzyć za pomocą następującego procesu ręcznego. Inną opcją jest użycie procesu tworzenia skryptów w celu wykonania tych samych kroków.

Otwórz folder pobierania utworzony do uzyskiwania nośnika SAP
Utwórz pusty plik YAML o nazwie bom.yml.
Otwórz bom.yml w edytorze.
Dodaj nagłówek BOM z nazwami kompilacji i elementu docelowego. Wartość name musi być taka sama jak nazwa folderu BOM na koncie magazynu. Na przykład:
```
name:    'S4HANA_2020_ISS_v001'
target:  'ABAP PLATFORM 2020'
```
Dodaj sekcję ustawień domyślnych z lokalizacją docelową. Użyj ścieżki do folderu na serwerze docelowym, na którym chcesz skopiować pliki instalacyjne. Zazwyczaj należy użyć {{ target_media_location }} w następujący sposób:
```
defaults:
  target_location: "{{ target_media_location }}/download_basket"
```
Dodaj sekcję identyfikatorów produktów. Te wartości zostaną wypełnione później w ramach przygotowania szablonu. Na przykład:
```
product_ids:
  scs:
  db:
  pas:
  aas:
  web:
```
Dodaj sekcję materiałów, aby określić listę wymaganych materiałów. Dodaj wszelkie zależności od innych modułów BOM w tej sekcji. Na przykład:
```
materials:
dependencies:
    - name:     HANA2
```
Pobierz listę multimediów do uwzględnienia w modelu BOM.
1. Otwórz arkusz kalkulacyjny koszyka pobierania. Ten plik jest renderowany jako XML.
2. W razie potrzeby sformatuj zawartość XML jako czytelną dla człowieka.
3. Dla każdego elementu w koszyku pobierania zanotuj dane String i Number . Dane String udostępniają nazwę pliku (na przykład igshelper_17-10010245.sar) i przyjazny opis (na przykład SAP IGS Fonts and Textures). Będziesz rejestrować dane Number po każdym wpisie w BOM.
Dodaj listę multimediów do bom.yml. Kolejność tych elementów nie ma znaczenia, jednak możesz zgrupować powiązane elementy w celu zapewnienia czytelności. Dodaj SAPCAR oddzielnie, mimo że koszyk pobierania SAP zawiera to narzędzie. Na przykład:
```
media:
    - name:     SAPCAR
      archive:  SAPCAR_1320-80000935.EXE

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

    <...>
```
Opcjonalnie, jeśli chcesz zastąpić docelową lokalizację nośnika, dodaj parametr override_target_location do elementu nośnika. Na przykład override_target_location: "{{ target_media_location }}/config".
Dodaj pustą sekcję szablonów.
```
templates:
```

Utwórz sekcję plików stosu. Na przykład:

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

  - name: Download Basket Spreadsheet
     file: MP_Excel_2001017452_20201030_SWC.xls

Zapisz zmiany w pliku bom.yml.

Permalinki

Możesz automatycznie wygenerować podstawowy model BOM, który działa. Jednak BOM domyślnie nie tworzy permanentnych adresów URL (permalinków) do materiałów SAP. Zanim uzyskasz dostęp do nośnika SAP, musisz wykonać więcej kroków, jeśli chcesz utworzyć permalinki.

Uwaga

Ręczne generowanie pełnego modelu SAP BOM z permalinkami trwa około dwa razy dłużej niż ręczne przygotowywanie podstawowego modelu BOM.

Aby wygenerować model BOM z permalinkami:

Otwórz DownloadBasket.json w edytorze.

Zanotuj zawartość wiersza Value dla każdego wyniku. Na przykład:

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

Skopiuj pierwsze i czwarte wartości rozdzielone pionowymi słupkami.
1. Pierwsza wartość to numer pliku. Na przykład 0020000000703122018.
2. Czwarta wartość to liczba, której użyjesz do dopasowania z listą multimediów. Na przykład 61489.
3. Opcjonalnie skopiuj drugą wartość, która określa typ pliku. Na przykład SP_B w przypadku plików binarnych jądra dla SPAT plików binarnych innych niż jądra i CD eksportu bazy danych.
Użyj czwartej wartości jako klucza, aby dopasować koszyk pobierania do listy multimediów. Dopasuj wartości (na przykład 61489) z wartościami dodanymi jako komentarze dla elementów multimedialnych (na przykład # 61489).
Dla każdego pasującego wpisu w pliku bom.ymldodaj nową wartość adresu URL systemu SAP. W przypadku adresu URL użyj https://softwaredownloads.sap.com/file/ razem z trzecią wartością dla tego elementu (na przykład 0020000000703122018). Na przykład:
```
- name: "SAP IGS Fonts and Textures"
  archive: "igshelper_17-10010245.sar"
  sapurl: "https://softwaredownloads.sap.com/file/0020000000703122018"
```

Przykładowy plik BOM

Poniższy przykład jest niewielką częścią przykładowego pliku BOM dla oprogramowania 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"

Weryfikowanie modelu BOM

Możesz zweryfikować strukturę BOM z dowolnego systemu operacyjnego z uruchomionymi poleceniami typu Linux. W przypadku systemu Windows użyj podsystemu Windows dla systemu Linux (WSL). Inną opcją jest uruchomienie weryfikacji z narzędzia wdrażania, jeśli istnieje tam kopia pliku BOM.

Uruchom skrypt check_bom.sh weryfikacji z katalogu zawierającego Twój BOM. Na przykład:
```
cd ~/Azure_SAP_Automated_Deployment/deploy/scripts/check_bom.sh bom.yml
```
Przejrzyj dane wyjściowe.

Pomyślna walidacja

Pomyślna walidacja pokazuje następujące dane wyjściowe. Już zainstalowano polecenia yamllint i ansible-lint w ramach wymagań wstępnych.

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

Nieudana walidacja

Niepowodzenie walidacji zawiera informacje o błędzie. Na przykład:

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

Prześlij swój BOM

Aby użyć modelu BOM z permalinkami:

Zweryfikuj model BOM.
Zaloguj się do portalu Azure.
W obszarze Usługi platformy Azure wybierz pozycję Grupy zasobów. Lub wprowadź resource groups w pasku wyszukiwania.
Wybierz grupę zasobów dla biblioteki SAP.
Na stronie grupy zasobów, wybierz konto pamięci masowej saplib w tabeli Zasoby.
W menu strony konta magazynu wybierz pozycję Kontenery w obszarze Magazyn danych.
sap bits Wybierz kontener.
Na stronie kontenera przekaż archiwa i narzędzia.
1. Wybierz przycisk Przekaż.
2. Wybierz Wybierz plik.
3. Przejdź do utworzonego wcześniej katalogu pobierania.

Następne kroki

Jak wygenerować model BOM aplikacji SAP