Příprava kusovníku SAP

Článek
04/06/2022
6 min ke čtení

Rozhraní SAP pro automatizaci nasazení v Azure používá kusovník (BOM). BOM vám pomůže nakonfigurovat systémy SAP.

úložiště GitHub rozhraní automation obsahuje sadu ukázkových kusovníků , které můžete použít k zahájení práce. Je také možné vytvořit kusovníky pro jiné aplikace a databáze SAP.

Pokud chcete vygenerovat kusovník, který obsahuje trvalé odkazování, postupujte podle kroků pro vytvoření tohoto typu kusovníku.

Poznámka

Tato příručka popisuje Pokročilá témata týkající se nasazení. Základní vysvětlení, jak nasadit rozhraní Automation, naleznete místo toho v příručce Začínáme .

Požadavky

Pokud jste to ještě neudělali , můžete získat, stáhnout a připravit instalační média SAP a související soubory .
- Aplikace SAP (DB) nebo médium HANA ve vašem účtu služby Azure Storage.
Editor YAML pro práci se souborem kusovníku.
Šablony instalace aplikace pro:
- Služby SAP Central Services (SCS)
- Primární aplikační Server SAP (PAS)
- Další aplikační Server SAP (AAS)
Soubory ke stažení potřebných souborů Stack do složky, kterou jste vytvořili pro získání média SAP. Další informace najdete v tématu Průvodce základní dopravou kusovníku.
Kopii manifestu vašeho košíku stažení pro SAP ( DownloadBasket.json ) staženého do složky, kterou jste vytvořili pro získání média SAP.
- Instalace Nástroje pro vystavování.
Předplatné Azure. Pokud ještě nemáte předplatné Azure, Vytvořte si bezplatný účet.
Účet SAP s oprávněními pro práci s databází, kterou chcete použít.
Systém, který spouští příkazy typu Linux pro ověření kusovníku. Nainstalujte příkazy yamllint a ansible-lint v systému.

Proces vytváření skriptu

Tento proces automatizuje stejné kroky jako ruční proces tvorby kusovníku. Před použitím tohoto procesu zkontrolujte omezení skriptu .

Přejděte do složky soubory zásobníku.
```
cd stackfiles
```
Spusťte skript generování kusovníku. Nahraďte ukázkovou cestu správnou cestou ke složce Utilities. Například:
```
cd ~/Azure_SAP_Automated_Deployment/deploy/scripts/generate_bom.sh >../bom.yml
```
Pro parametr produktu ( product ) zadejte název produktu SAP. Například, SAP_S4HANA_1809_SP4. Pokud nezadáte hodnotu, skript se pokusí určit název ze souboru zásobníku XML.
Otevřete vygenerovaný bom.yml soubor pro kontrolu.
Projděte si část šablony ( templates ). Ujistěte se file , že hodnoty a override_target_location jsou správné. V případě potřeby upravte a komentovat tyto řádky. Například:
```
templates:
  # - name:     "S4HANA_2020_ISS_v001 ini file"
  #   file:     S4HANA_2020_ISS_v001.inifile.params
  #   override_target_location: "{{ target_media_location }}/config"
```
Projděte si část soubory zásobníku ( stackfiles ). Ujistěte se, že jsou názvy a soubory položek správné. V případě potřeby tyto řádky upravte.

Omezení skriptu

Proces vytváření skriptových kusovníků má následující omezení.

Skriptování má pevně zakódované závislosti v HANA2. Upravte soubor BOM ručně tak, aby odpovídal požadovanému názvu závislosti. Například:

dependencies:
  - name: "HANA2"

Pro parametry override_target_filename: média nejsou k dispozici žádné výchozí hodnoty, override_target_location a version: . Upravte soubor kusovníku ručně, abyste tyto parametry změnili. Například:

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

Skript vytvoří pouze položky mediálních souborů, které identifikuje Plánovač údržby SAP. K tomuto omezení dochází, protože zpracovává soubor zásobníku .xsl . Pokud do košíku ke stažení přidáte jakékoli soubory samostatně, například prostřednictvím služby SAP hlavní panel, musíte tyto soubory do kusovníku přidat ručně.

Proces ručního vytvoření

Svůj kusovník můžete vytvořit pomocí následujícího ručního procesu. Další možností je použít skript vytvoření skriptu ke stejnému postupu.

Otevřete složku stažené soubory, kterou jste vytvořili pro získání média SAP .
Vytvořte prázdný soubor YAML s názvem bom.yml .
Otevřete bom.yml v editoru.
Přidejte hlavičku kusovníku s názvy pro sestavení a cíl. nameHodnota musí být stejná jako název složky kusovníku ve vašem účtu úložiště. Například:
```
name:    'S4HANA_2020_ISS_v001'
target:  'ABAP PLATFORM 2020'
```
Přidejte oddíl Defaults s cílovým umístěním. Použijte cestu ke složce na cílovém serveru, kam chcete zkopírovat instalační soubory. Obvykle použijte {{ target_media_location }} následujícím způsobem:
```
defaults:
  target_location: "{{ target_media_location }}/download_basket"
```
Přidejte část s identifikátory produktu. Tyto hodnoty naplníte později v rámci přípravy šablony. Například:
```
product_ids:
  scs:
  db:
  pas:
  aas:
  web:
```
Přidejte část materiály a určete seznam požadovaných materiálů. Přidejte jakékoli závislosti na jiné kusovníky v této části. Například:
```
materials:
dependencies:
    - name:     HANA2
```
Získejte seznam médií, která se mají zahrnout do vašeho kusovníku.
1. Otevřete tabulku košíků ke stažení. Tento soubor se vykresluje jako XML.
2. V případě potřeby naformátujte obsah XML tak, aby byl čitelný.
3. Pro každou položku v košíku stažení si poznamenejte String data a Number . StringData poskytují název souboru (například igshelper_17-10010245.sar ) a popisný popis (například SAP IGS Fonts and Textures ). Data zaznamenáte Number za každou položku v kusovníku.
Přidejte seznam médií do bom.yml . Pořadí těchto položek však nezáleží na tom, aby bylo možné seskupit související položky dohromady pro účely čitelnosti. Přidejte SAPCAR samostatně, a to i v případě, že Váš košík stahování SAP obsahuje tento nástroj. Například:
```
media:
    - name:     SAPCAR
      archive:  SAPCAR_1320-80000935.EXE

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

    <...>
```
Případně, pokud potřebujete přepsat cílové umístění médií, přidejte parametr override_target_location do položky média. Například, override_target_location: "{{ target_media_location }}/config".
Přidejte oddíl prázdné šablony.
```
templates:
```

Vytvořte oddíl soubory zásobníku. Například:

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

  - name: Download Basket Spreadsheet
     file: MP_Excel_2001017452_20201030_SWC.xls

Uložte změny do bom.yml .

Trvalé odkazování

Můžete automaticky vygenerovat základní kusovník, který funguje. Ve výchozím nastavení ale BOM nevytváří trvalé adresy URL (trvalých odkazů) na médium SAP. Pokud chcete vytvořit trvalý odkaz, musíte provést další kroky, než budete moct získat médium SAP.

Poznámka

Ruční generace plného kusovníku SAP s trvalými akcemi trvá přibližně dvakrát, dokud Ruční připraví základní kusovník.

Chcete-li vygenerovat kusovník s trvalými odkazci:

Otevřete DownloadBasket.json v editoru.

Pro každý výsledek si poznamenejte obsah Value řádku. Například:

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

Zkopíruje první a čtvrtou hodnotu oddělené svislými pruhy.
1. První hodnotou je číslo souboru. Například, 0020000000703122018.
2. Čtvrtá hodnota je číslo, které budete používat ke spárování se seznamem médií. Například, 61489.
3. Volitelně můžete zkopírovat druhou hodnotu, která označuje typ souboru. Například SP_B pro binární soubory jádra, SPAT pro binární soubory jiné než jádro a CD pro exporty databáze.
Použijte čtvrtou hodnotu jako klíč, aby odpovídala vašemu předplatnému ke stažení na váš mediální seznam. Porovnává hodnoty (například 61489 ) s hodnotami, které jste přidali jako komentáře pro položky médií (například # 61489 ).
U každého odpovídajícího záznamu v bom.yml nástroji přidejte novou hodnotu pro adresu URL SAP. Pro adresu URL použijte https://softwaredownloads.sap.com/file/ znaménko plus třetí hodnota položky (například 0020000000703122018 ). Například:
```
- name: "SAP IGS Fonts and Textures"
  archive: "igshelper_17-10010245.sar"
  sapurl: "https://softwaredownloads.sap.com/file/0020000000703122018"
```

Ukázkový soubor kusovníku

Následující ukázka je malá část ukázkového souboru kusovníku pro S/4HANA 1909 SP2.

několik úplných, použitelných souborů BOM můžete najít ve složce úložiště GitHub .

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"

Ověřit kusovník

Strukturu kusovníku můžete ověřit z libovolného operačního systému, který spouští příkazy Linux-Type. pro Windows použijte Subsystém Windows pro Linux (WSL). Další možností je spustit ověřování z nástroje pro nasazení, pokud existuje kopie souboru kusovníku.

Spusťte ověřovací skript check_bom.sh z adresáře, který obsahuje váš kusovník. Například:
```
cd ~/Azure_SAP_Automated_Deployment/deploy/scripts/check_bom.sh bom.yml
```
Zkontrolujte výstup.

Úspěšné ověření

Po úspěšném ověření se zobrazí následující výstup. Už jste nainstalovali yamllint příkazy a ansible-lint v požadavcích.

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

Neúspěšné ověření

Neúspěšné ověření obsahuje informace o chybě. Například:

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

Upload kusovníku

Použití kusovníku s trvalými akcemi:

Ověřte kusovník.
Přihlaste se k webu Azure Portal.
V části služby Azurevyberte skupiny prostředků. Nebo zadejte resource groups do panelu hledání.
Vyberte skupinu prostředků pro knihovnu SAP.
Na stránce skupina prostředků vyberte účet saplib úložiště v tabulce Resources (prostředky ).
V nabídce na stránce účtu úložiště v části úložiště datvyberte kontejnery .
sap bitsVyberte kontejner.
Na stránce kontejner nahrajte své archivy a nástroje.
1. Vyberte tlačítko Nahrát.
2. Vyberte Vybrat soubor.
3. Přejděte do adresáře pro stahování, který jste vytvořili dříve.

Další kroky

Generování kusovníku aplikace SAP