Panduan konektor untuk penginstalan dan pengoperasian LaMa

Panduan ini membahas penginstalan dan konfigurasi Google Cloud Connector untuk SAP Landscape Management (Konektor untuk LaMa), serta tugas operasional setelah konektor diinstal.

Guna menginstal dan mengonfigurasi Connector untuk LaMa, lakukan langkah-langkah tingkat tinggi berikut:

  • Mengonfigurasi autentikasi dan otorisasi ke Google Cloud API.
  • Download arsip penginstalan dari Google Cloud.
  • Instal Connector untuk LaMa di host yang sama dengan SAP Landscape Management. Host dapat berupa mesin virtual (VM) Compute Engine atau mesin virtual atau fisik yang tidak ada di Google Cloud.
  • Konfigurasikan fungsi Cloud Manager untuk Google Cloud di Pengelolaan Lanskap SAP.
  • Instal library penyimpanan dan file operasi di setiap VM yang menghosting sistem SAP yang akan dikelola oleh SAP Landscape Management.

Prasyarat

Sebelum dapat menginstal Connector for LaMa, Anda harus menginstal dan mengonfigurasi versi SAP Landscape Management yang didukung. Untuk versi yang didukung, lihat Persyaratan software.

Instal SAP Landscape Management sesuai dengan panduan penginstalan SAP Landscape Management dan prinsip Desain Adaptif SAP Landscape Management.

Untuk informasi selengkapnya, lihat:

Mengonfigurasi autentikasi dan otorisasi ke Google Cloud API

Anda harus mengonfigurasi sertifikat CA dan, jika memerlukan kontrol akses yang lebih ketat, akun layanan IAM.

Mengupload Sertifikat CA untuk komunikasi Google API

Connector for LaMa memerlukan sertifikat CA yang sesuai agar dapat berkomunikasi dengan Google Cloud API. Pastikan sertifikat berikut tersedia di tampilan CA Tepercaya dari tampilan SAP NetWeaver Java KeyStore Storage:

  • GTS CA 1C3
  • WR2
  1. Buka repositori Layanan Kepercayaan Google di https://pki.goog/repository/

  2. Di bagian Download sertifikat CA pada Subordinate CA, download sertifikat CA GTS CA 1C3 dan WR2. Perhatikan bahwa sertifikat WR2 menggantikan sertifikat GTS CA 1C3 pada tahun 2024 untuk API tertentu.

  3. Impor sertifikat dengan mengikuti petunjuk dalam dokumentasi SAP NetWeaver: Menggunakan AS Java Key Storage.

Membuat akun layanan IAM

Kecuali jika Anda ingin menggunakan akun layanan instance VM hosting sebagai akun layanan default, Anda harus membuat akun layanan IAM untuk Connector for LaMa.

Untuk membuat akun layanan bagi Connector untuk LaMa:

  1. Di konsol Google Cloud, buka halaman Service accounts:

    Buka Akun Layanan

  2. Pilih project Google Cloud Anda.

  3. Klik Buat Akun Layanan.

  4. Tentukan nama untuk akun layanan dan deskripsi (opsional).

  5. Klik Create and Continue.

  6. Pada langkah Grant this service account access to project, berikan peran yang berisi semua izin yang diperlukan SAP Landscape Management pada akun layanan. Peran dapat berupa peran yang telah ditetapkan, seperti Compute Admin, atau peran khusus yang Anda buat yang berisi izin yang tercantum dalam Izin resource IAM yang diperlukan untuk Connector for LaMa

  7. Klik Done.

  8. Pada halaman Service accounts di Google Cloud Console, klik akun layanan yang baru saja Anda buat.

  9. Di bawah nama akun layanan, klik tab Keys.

  10. Klik menu Add Key, lalu pilih Create new key untuk membuat a service account key.

  11. Terima JSON sebagai jenis kunci dan klik Create. Kunci pribadi disimpan ke komputer Anda. Simpan file kunci JSON di tempat yang aman. Kemudian, saat mengonfigurasi SAP Landscape Management fungsi Cloud Manager, salin dan tempel konten file kunci ke dalam SAP Landscape Management.

Menyetel JVM agar menggunakan Internet Protocol versi 4

Gunakan alat Java System Properties dari Administrator SAP Netweaver atau alat SAP NetWeaver Config untuk menentukan -Djava.net.preferIPv4Stack=true dalam parameter sistem JVM.

Jika -Djava.net.preferIPv4Stack=true ditentukan, SAP NetWeaver hanya akan menggunakan Internet Protocol versi 4 (IPv4).

Untuk mengetahui informasi selengkapnya, lihat Persyaratan Protokol Internet versi 4 (IPv4).

Mendownload Connector untuk LaMa

Anda mendownload Connector untuk LaMa dari Google Cloud dalam file tar, gcp-connectorversion.tar, yang berisi file berikut:

  • Connector untuk LaMa dalam file Java Enterprise Archive, lvm.cloud.gcp-version.ear.
  • Library penyimpanan Cloud Manager OS:
    • Untuk linux: libsapacosprep_gcp-version.so
    • Untuk Windows: libsapacosprep_gcp-version.dll
  • Definisi operasi yang disesuaikan untuk Google Cloud.
  • Skrip operasi yang sesuai dengan definisi operasi.

Untuk mendownload Connector untuk LaMa versi terbaru, hubungi Cloud Customer Care. Untuk menemukan informasi kontak Layanan Pelanggan, buka halaman RIngkasan dukungan di Konsol Google Cloud. Untuk informasi selengkapnya, lihat Mendapatkan dukungan untuk SAP di Google Cloud.

Dengan file tar yang dikompresi, Google Cloud juga menyediakan file tanda tangan asc, gcp-connectorversion.tar.asc, yang dapat Anda gunakan untuk mengonfirmasi bahwa file gcp-connectorversion.tar didownload dengan benar.

Simpan file tar di bucket Cloud Storage yang dapat diakses oleh server SAP Landscape Management dan server yang akan dikelola, atau upload melalui fungsi upload Cloud Shell seperti yang dijelaskan dalam Mentransfer file ke instance.

Menginstal Konektor untuk LaMa di server SAP Landscape Management

Guna menginstal Connector for LaMa, Anda harus men-deploy file EAR ke SAP NetWeaver dan mengonfigurasi Cloud Manager untuk Google Cloud di SAP Landscape Management.

Men-deploy Konektor untuk LaMa di SAP NetWeaver

Instal file EAR yang berisi Connector untuk LaMa menggunakan salah satu metode deployment SAP NetWeaver Java berikut (diperlukan akun pengguna SAP):

Mengonfigurasi fungsi Cloud Manager di SAP Landscape Management

Setelah menginstal Connector untuk LaMa, di antarmuka SAP Landscape Management, Anda akan mengonfigurasi fungsi Cloud Manager untuk Google Cloud.

Prosedur umum untuk mengonfigurasi Cloud Manager didokumentasikan oleh SAP di bagian Mengonfigurasi Cloud Manager.

Langkah-langkah berikut khusus digunakan untuk mengonfigurasi Cloud Manager untuk Google Cloud.

Untuk mengonfigurasi Cloud Manager baru untuk Google Cloud, lakukan langkah-langkah konfigurasi berikut:

  1. Di SAP Landscape Management, buka SAP Landscape Management Infrastructure > Cloud Managers.
  2. Buat Cloud Manager baru dengan mengeklik Add.
  3. Dari daftar Jenis Cloud Manager yang Terinstal, pilih Google Cloud Adapter.
  4. Di bagian Basic properties:
    • Di kolom Label, masukkan nama Cloud Manager untuk Google Cloud.
    • Dalam Interval Pemantauan, terima nilai default 300 detik.
    • Biarkan kolom lain kosong.
  5. Jika Anda menggunakan akun layanan khusus bagi Connector untuk LaMa, tempelkan konten file kunci JSON akun layanan ke dalam kolom Service Account di bagian Additional properties.
  6. Jika Anda menggunakan akun layanan VM for Connector untuk LaMa, kosongkan Service Account.
  7. Jalankan "Test Configuration" untuk memvalidasi setelan dan menguji koneksi ke URL Google Cloud API.
  8. Pilih Next dan Save to new Cloud Manager.

Entri di tampilan Virtualization dan Storage Manager akan dibuat secara otomatis.

Hanya konfigurasi Cloud Manager yang dapat diubah; pengeditan dinonaktifkan di tampilan lain.

Mengonfigurasi dukungan untuk alamat IP duplikat

Jika jaringan internal dalam lanskap SAP yang dikelola menyertakan alamat IP duplikat, konfigurasikan SAP Landscape Management agar menggunakan nama host yang sepenuhnya memenuhi syarat untuk memetakan sistem SAP yang dikelola.

Untuk menggunakan nama host yang sepenuhnya memenuhi syarat, di setelan pemantauan SAP Landscape Management, centang kotak Use FQDN Hostnames Only. Untuk informasi selengkapnya, lihat Mengonfigurasi Setelan Pemantauan.

Menginstal Agen Google Cloud untuk SAP

Untuk dukungan dan pemantauan, Google Cloud menyediakan Agen untuk SAP, untuk workload SAP yang berjalan di instance Compute Engine dan server Solusi Bare Metal.

Sebagaimana diamanatkan oleh SAP, untuk mendapatkan dukungan dari SAP dan agar SAP dapat memenuhi perjanjian tingkat layanan (SLA), Anda harus menginstal Agen Google Cloud untuk SAP di semua instance Compute Engine dan server Solusi Bare Metal yang menjalankan sistem SAP apa pun. Untuk informasi selengkapnya tentang prasyarat dukungan, lihat Catatan SAP 2456406 - SAP di Google Cloud Platform: Prasyarat Dukungan.

Versi 3.6 (terbaru) Agen Google Cloud untuk SAP adalah penerus agen pemantauan Google Cloud untuk SAP NetWeaver versi 2, agen pemantauan untuk SAP HANA versi 2, dan agen Backint Cloud Storage untuk SAP HANA. Oleh karena itu, selain pengumpulan metrik, Agen Google Cloud untuk SAP versi 3.6 (terbaru) menyertakan fitur opsional: Pencadangan dan pemulihan berbasis Backint untuk SAP HANA. Anda dapat memilih untuk menggunakan fitur ini yang mengaktifkan produk dan layanan, seperti Workload Manager untuk workload SAP.

Anda menginstal Agen Google Cloud untuk SAP di host bersama dengan sistem SAP. Untuk petunjuk tentang cara menginstal dan mengonfigurasi agen, memvalidasi penginstalan Anda, dan memastikan bahwa agen berjalan seperti yang diharapkan, lihat Menginstal agen di instance Compute Engine.

Jika Anda menggunakan OS image RHEL atau SLES "for SAP" berikut yang disediakan Google Cloud, Agen Google Cloud untuk SAP akan dikemas dengan OS image:

  • RHEL: semua image "for SAP"
  • SLES: SLES 15 SP4 untuk SAP dan versi yang lebih baru

Menginstal library penyimpanan OS dan definisi operasi di VM terkelola

File gcp-connectorversion.tar menyertakan library penyimpanan OS dan definisi operasi dengan skrip yang sesuai.

Anda harus menginstal library penyimpanan OS dan file operasi di setiap instance VM yang dikelola oleh SAP Landscape Management.

Untuk menginstal library penyimpanan OS dan definisi operasi di VM yang dikelola oleh SAP Landscape Management:

  1. Download atau salin file gcp-connectorversion.tar ke VM target.
  2. Ekstrak file dalam file gcp-connectorversion.tar ke direktori sementara.
  3. Jalankan skrip penginstalan:

    • Di Linux, masukkan:
      sudo bash install.sh
    • Di Windows, dengan hak istimewa administrator, masukkan:
      install.cmd

    Skrip penginstalan akan menyalin library penyimpanan OS ke direktori Agen Host SAP yang aktif, /usr/sap/hostctrl/exe, dan file operasi ke subdirektori, /operations.d. Skrip ini menetapkan kepemilikan file ke root:sapsys dan menetapkan hak akses yang sesuai untuk setiap jenis file.

    file ./storage/libsapacosprep_gcp-2.2.15.96.so copied to /usr/sap/hostctrl/exe/libsapacosprep_gcp.so
    file ./storage/Operations/AcActivateIP copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/AcActivateIP
    file ./storage/Operations/AcDeactivateIP copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/AcDeactivateIP
    file ./storage/Operations/ActivateIP.sh copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/ActivateIP.sh
    file ./storage/Operations/DeactivateIP.sh copied to /usr/sap/hostctrl/exe/operations.d/sapacosprep/DeactivateIP.sh

Mengelola sistem SAP di Google Cloud dengan SAP Landscape Management

Setelah Connector untuk LaMa diinstal dan fungsi Cloud Manager dikonfigurasi dalam SAP Landscape Management, Anda dapat menggunakan SAP Landscape Management untuk mengelola sistem SAP di Google Cloud. Untuk informasi tentang cara menggunakan SAP Landscape Management, lihat dokumentasi SAP Landscape Management, edisi perusahaan.

Mengupdate dari rilis sebelumnya

Guna mengupdate Connector untuk LaMa dari versi sebelumnya, lakukan langkah-langkah berikut.

  1. Di SAP Landscape Management, cadangkan semua Cloud Manager yang ada untuk konfigurasi Google Cloud sebelum mengupdate Connector untuk LaMa. Untuk mengetahui informasi selengkapnya, lihat Mengekspor data konfigurasi.
  2. Instal ulang Connector untuk LaMa. Untuk mengetahui petunjuknya, lihat Men-deploy Connector untuk LaMa di SAP NetWeaver.
  3. Ganti library penyimpanan OS dan file operasi yang ada dalam sistem terkelola dengan mengikuti petunjuk dalam Menginstal library penyimpanan OS dan definisi operasi.
  4. Setelah deployment, mulai ulang SAP Landscape Management.

Pemecahan masalah

Secara default, sistem SAP Landscape Management beroperasi di Google Cloud menggunakan identitas akun layanan IAM. Jika Anda mengalami error otorisasi, coba gunakan perintah gcloud terlebih dahulu untuk melakukan tindakan yang sama seperti yang menerima error dari dalam sistem operasi tamu. Contoh:

Tindakan SAP Landscape Management Perintah gcloud yang setara
Berhenti/mulai gcloud compute instances stop/start
Clone gcloud compute disks snapshot
gcloud compute disks create
Pindahkan gcloud compute instances attach-disk
gcloud compute instances detach-disk

Output perintah gcloud memberi Anda indikasi apakah Anda tidak memiliki otorisasi untuk menjalankan tindakan tertentu. Jika berhasil, tetapi error tetap berlanjut, hubungi Dukungan seperti yang dijelaskan di bagian berikut.

Dukungan

Jika Anda mengalami masalah dengan pengoperasian sistem SAP Landscape Management yang perlu bantuan untuk diselesaikan, catat pesan dukungan melalui Portal Dukungan SAP di bagian BC-VCM-LVM.

Jika Anda menentukan bahwa akar masalah ada di Connector untuk LaMa, pilih sub-komponen BC-VCM-LVM-GOOGLE; tetapi, jika tidak yakin dengan penyebab masalah, pilih komponen BC-VCM-LVM, sehingga dukungan SAP dapat menganalisis masalah tersebut terlebih dahulu.

Informasi yang harus disertakan:

  • Versi SAP Landscape Management
  • Versi Connector untuk LaMa
  • Versi kernel SAP NetWeaver
  • Versi sistem SAP yang dikelola, termasuk versi agen host
  • Deskripsi perilaku yang diharapkan