SAP HANA용 Backint 기반 백업 및 복구 구성

이 가이드에서는 SAP HANA에 대해 Backint 기반 백업 및 복구를 수행하도록 SAP용 Google Cloud 에이전트를 구성하는 방법을 보여줍니다.

구현 계획에 도움이 되는 이 기능에 관한 개념적 정보는 Backint를 사용하여 SAP HANA 백업 및 복구를 참고하세요.

Backint 기반 백업을 만들고 이를 사용하여 SAP HANA를 복구하는 방법에 대한 자세한 내용은 Backint를 사용하여 SAP HANA 백업 및 복구를 참고하세요.

시작하기 전에

• SAP용 Google Cloud 에이전트 버전 3.6(최신)이 설치되었는지 확인합니다. 자세한 안내는 시나리오별 설치 가이드를 참조하세요.
• 베어메탈 솔루션 서버에 에이전트를 설치했다면, 필요한 기본 요건을 완료하고 서비스 계정을 설정했는지 확인합니다. 자세한 내용은 Linux에서 SAP용 Google Cloud 에이전트 구성을 참조하세요.
• SAP HANA 데이터베이스가 온프레미스 환경에서 실행되는 경우 서비스 계정과 키를 설정해야 합니다. 방법에 관한 자세한 내용은 Linux에서 SAP용 Google Cloud 에이전트 구성을 참고하세요.
• Compute Engine 인스턴스 또는 베어메탈 솔루션 서버가 아닌 호스트에서 실행되는 SAP용 Google Cloud 에이전트의 인스턴스에 이 기능을 사용 설정해야 하는 경우 SAP와 Google Cloud 모두 구성을 평가할 수 있도록 BC-OP-LNX-GOOGLE 구성요소에 SAP 지원이 포함된 인시던트를 만들어야 합니다.
• SAP HANA를 설치합니다.
  • Terraform을 사용하여 Google Cloud에서 SAP HANA 설치를 자동화하는 방법은 시나리오별 배포 가이드를 참조하세요.
  • 베어메탈 솔루션용 SAP HANA 설치에 대한 자세한 내용은 베어메탈 솔루션용 SAP HANA 계획 가이드를 참조하세요.

Cloud Storage 버킷 만들기

SAP용 Google Cloud 에이전트의 Backint 기능을 사용 설정하기 전에 백업을 저장할 Cloud Storage 버킷이 있는지 확인합니다. Cloud Storage 버킷이 있으면 이 섹션을 건너뛰어도 됩니다.

Cloud Storage 버킷에 백업 저장에 대한 자세한 내용은 Cloud Storage 버킷에 백업 저장을 참조하세요.

Cloud Storage 버킷을 만드는 방법은 다음과 같습니다.

IAM 역할 설정

SAP용 Google Cloud의 에이전트가 SAP HANA에 대한 백업 및 복구 작업을 수행하려면 Compute Engine 인스턴스 또는 베어메탈 솔루션 서버에서 사용 중인 서비스 계정에 스토리지 객체 관리자 (storage.objectAdmin) IAM 역할이 포함되어 있는지 확인해야 합니다.

이 역할을 서비스 계정에 추가하려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.

   IAM으로 이동

2. Google Cloud 프로젝트를 선택합니다.

3. 역할을 추가할 서비스 계정을 찾습니다.

   • 서비스 계정이 주 구성원 목록에 아직 없는 경우 어떠한 역할도 할당되지 않은 것입니다. 추가를 클릭하고 서비스 계정의 이메일 주소를 클릭하세요.
   • 서비스 계정이 주 구성원 목록에 이미 있는 경우 기존 역할이 있는 것입니다. 수정하려는 서비스 계정에서 수정 버튼을 클릭합니다.

4. 사용 가능한 역할 목록에서 스토리지 객체 관리자를 선택합니다.

5. 추가 또는 저장을 클릭하여 서비스 계정에 역할을 적용합니다.

세분화된 액세스 수준의 경우 프로젝트 수준에서 서비스 계정의 맞춤 역할에 다음 IAM 권한을 설정할 수 있습니다.

• storage.objects.list
• storage.objects.create

또한 다음 IAM 권한을 사용자에게 부여하여 버킷에 IAM 정책을 설정해야 합니다.

• storage.objects.get
• storage.objects.update
• storage.objects.delete

멀티파트 업로드를 실행하려면 다음 권한을 추가합니다.

• storage.multipartUploads.create
• storage.multipartUploads.abort

커스텀 역할을 만드는 방법에 대한 자세한 내용은 커스텀 역할 만들기 및 관리를 참고하세요. 주 구성원에게 버킷 수준 액세스를 위한 맞춤 역할을 부여하는 방법에 관한 자세한 내용은 버킷 수준 정책에 주 구성원 추가를 참고하세요.

Cloud API 및 메타데이터 서버에 대한 액세스 사용 설정

SAP용 Google Cloud 에이전트는 백업 및 복구 작업 중 다음 Google Cloud IP 주소 및 호스트에 액세스해야 합니다.

• Cloud Storage에 액세스하기 위한 storage.googleapis.com
• Compute Engine 인스턴스 메타데이터 서버의 경우:
  • 인증을 위한 oauth2.googleapis.com
  • 169.254.169.254
  • metadata.google.internal

SAP용 Google Cloud 에이전트와 SAP HANA 시스템이 인터넷에 액세스할 수 없는 Compute Engine 인스턴스에서 실행 중인 경우 에이전트가 Cloud Storage와 상호작용할 수 있도록 비공개 Google 액세스를 구성해야 하며 전용 서비스 계정을 사용하는 경우 Google Cloud로 자신을 인증할 수 있습니다. 자세한 내용은 비공개 Google 액세스 구성을 참조하세요.

Backint 기능 사용 설정

SAP용 Google Cloud 에이전트의 Backint 기능을 사용 설정하려면 다음 단계를 수행합니다.

1. SSH를 사용하여 SAP HANA 호스트에 연결합니다.

   호스트가 Compute Engine 인스턴스인 경우 Google Cloud 콘솔의 VM 인스턴스 페이지에서 인스턴스의 SSH 버튼을 클릭하거나 선호하는 SSH 메서드를 사용합니다.

2. SAP HANA 시스템 관리자로 전환합니다.

   sudo su - SID_LCadm

   SID_LC를 SID로 바꿉니다. 모든 문자는 소문자를 사용하세요.

   또한 이 명령어는 SAP HANA 데이터베이스의 SID로 설정된 $SAPSYSTEMNAME을 비롯한 여러 환경 변수를 설정합니다.

3. SAP용 Google Cloud 에이전트에 대해 Backint 기능을 사용 설정합니다.

   /usr/bin/google_cloud_sap_agent installbackint

   또는 다른 SID로 호스트에 Backint 관련 파일을 설치하려면 sid 플래그를 포함합니다.

   /usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC

   DIFFERENT_SID_LC를 필요한 SAP HANA 인스턴스의 SID로 바꿉니다. 모든 문자에 소문자를 사용하세요.

   명령어가 성공적으로 실행되면 SAP용 Google Cloud 에이전트의 Backint 기능과 관련된 모든 파일이 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/ 디렉터리에 설치됩니다. 여기에는 SAP HANA와 에이전트를 통합하기 위해 필요한 파일이 포함됩니다. 또한 호스트에서 SAP HANA를 위한 Cloud Storage Backint 에이전트를 감지하고, 에이전트를 사용 중지하고, 파일을 호스트의 복구 가능한 디렉터리에 복사합니다. 자세한 내용은 Backint 에이전트에서 업그레이드를 참조하세요.

4. Backint 기능을 구성합니다.

   명령어 실행

   • SAP HANA 데이터베이스가 Compute Engine 인스턴스 또는 베어메탈 솔루션 서버에서 실행되는 경우 에이전트의 Backint 기능을 구성하려면 configurebackint 명령어를 실행합니다. 에이전트의 Backint 구성 파일을 수정하는 것보다 이 방법을 사용하는 것이 좋습니다.

     /usr/bin/google_cloud_sap_agent configurebackint \
      -f="PATH_TO_PARAMETERS_FILE" \
      -bucket="BUCKET_NAME"

   • SAP HANA 데이터베이스가 온프레미스 환경에서 실행 중인 경우 다음 명령어를 실행하여 에이전트의 Backint 기능을 구성합니다.

     /usr/bin/google_cloud_sap_agent configurebackint \
      -f="PATH_TO_PARAMETERS_FILE" \
      -bucket="BUCKET_NAME" \
      -service_account_key="PATH_TO_KEY" \
      -log_to_cloud=false \
      -send_metrics_to_monitoring=false

     다음을 바꿉니다.

     • PATH_TO_PARAMETERS_FILE: PARAMETERS.json Backint 구성 파일의 경로입니다.
     • BUCKET_NAME: SAP HANA 백업을 저장할 Cloud Storage 버킷의 이름입니다.
     • PATH_TO_KEY: 설정한 JSON 인코딩 Google Cloud 서비스 계정 키의 전체 경로입니다.

   필요한 경우 이 명령어를 실행하는 동안 더 많은 매개변수를 설정할 수 있습니다. 이러한 매개변수에 대한 자세한 내용은 구성 매개변수를 참조하세요.

   구성 파일 수정

   에이전트의 configurebackint 명령어를 실행하는 대신 Backint 구성 파일을 다음과 같이 수정합니다.

   1. Backint 구성 파일을 엽니다.

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

      SID를 Backint 관련 파일을 설치한 SAP 시스템의 SID로 바꿉니다.

      다음은 구성 파일에 포함된 항목의 예시입니다.

      {
       "bucket": "",
       "log_to_cloud": true
      }

   2. SAP용 Google Cloud 에이전트가 SAP HANA 시스템에 대해 Backint 기반 백업 및 복구 작업을 수행하도록 허용하려면 구성 파일을 수정한 후 다음 매개변수를 지정합니다.

      • bucket: SAP HANA 백업을 저장할 Cloud Storage 버킷의 이름을 지정합니다.
      • service_account_key: SAP용 Google Cloud 에이전트에 대한 서비스 계정을 만든 경우 해당 JSON 인코딩 서비스 계정 키를 업로드한 호스트의 디렉터리에 대한 절대 경로를 지정합니다.

      자세한 내용은 서비스 계정 고려사항을 참조하세요.

   3. SAP HANA 데이터베이스가 온프레미스 환경에서 실행되는 경우 다음도 설정해야 합니다.

      • "log_to_cloud": false
      • "send_metrics_to_monitoring": false

   4. 선택적으로 다른 구성 매개변수를 수정할 수 있습니다. 이러한 매개변수에 대한 자세한 내용은 구성 매개변수를 참조하세요.

   5. 구성 파일을 저장합니다.

Backint 구성 파일 맞춤설정

선택적으로 SAP용 Google Cloud 에이전트의 Backint 기능을 사용 설정한 후 다음 맞춤설정을 수행할 수 있습니다.

• parameters.json 파일 이름을 바꿉니다.

  이 이름 변경을 표시하기 위해 이 파일은 SAP용 Google Cloud 에이전트 문서에서 PARAMETERS.json라고 합니다.

• SAP HANA 데이터 볼륨, SAP HANA 로그 볼륨, SAP HANA 백업 카탈로그에 대해 각각 개별 구성 파일을 만듭니다.

  각 구성 파일에 대해 고유한 이름을 설정해야 합니다.

• 이러한 구성 파일을 다른 디렉터리로 이동합니다. 예를 들어 수평 확장 배포에서는 노드에 액세스할 수 있는 공유 디렉터리에 모든 노드의 Backint 관련 구성 파일을 저장할 수 있습니다. 이렇게 하면 이러한 파일을 더 쉽게 관리할 수 있습니다.

이러한 맞춤설정을 수행할 때는 SAP HANA의 global.ini 파일에서 매개변수의 파일 이름 및 경로를 올바르게 지정해야 합니다. 자세한 내용은 Backint 기능에 대한 SAP HANA 구성을 참조하세요.

Backint 기능에 대한 SAP HANA 구성

SAP용 Google Cloud 에이전트의 Backint 기능을 사용 설정한 후에는 이 기능을 사용하도록 SAP HANA 시스템을 구성해야 합니다.

1. SAP HANA Studio 또는 SAP HANA Cockpit을 사용하여 global.ini 구성 파일을 수정합니다.

2. global.ini 파일의 backup 섹션에서 다음 매개변수의 값을 지정합니다.

   매개변수	값
   data_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json.
   parallel_data_backup_backint_channels	멀티스트리밍 데이터 백업의 경우 사용 중인 Cloud Storage 버킷의 유형, 필요한 성능, 디스크 처리량을 고려하여 채널 수를 지정하세요.
   log_backup_using_backint	SAP HANA 백업 로그 볼륨에 대해 개별 구성 파일을 사용하는 경우 true 값을 지정합니다.
   log_backup_parameter_file	SAP HANA 백업 로그 볼륨에 대해 개별 구성 파일을 사용하는 경우 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json 값을 지정합니다. PARAMETERS_LOG를 SAP HANA 로그 볼륨 백업에 사용 중인 구성 파일의 이름으로 바꿉니다.
   catalog_backup_using_backint	SAP HANA 백업 카탈로그에 대해 개별 구성 파일을 사용하는 경우 true 값을 지정합니다.
   catalog_backup_parameter_file	SAP HANA 백업 카탈로그에 대해 개별 구성 파일을 사용하는 경우 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json 값을 지정합니다. PARAMETERS_CATALOG를 SAP HANA 백업 카탈로그의 백업에 사용하는 구성 파일의 이름으로 바꿉니다.

   다음은 SAP용 Google Cloud 에이전트의 Backint 기능을 사용하도록 구성된 global.ini 파일 예시입니다.

   [backup]
   log_backup_using_backint = true
   catalog_backup_using_backint = true
   parallel_data_backup_backint_channels = 16
   catalog_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.json
   data_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.json
   log_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.json

3. global.ini 파일의 persistence 섹션에서 다음 매개변수의 값을 지정합니다.

   • basepath_logbackup: 파일 시스템에서 Cloud Storage 버킷에 연결할 수 없는 경우 SAP HANA가 로그 백업을 저장할 수 있는 디렉터리를 지정합니다. 이 디렉터리에 백업을 저장할 공간이 충분해야 합니다.
   • basepath_catalogbackup: 파일 시스템에서 Cloud Storage 버킷에 연결할 수 없는 경우 SAP HANA 백업 카탈로그의 백업을 저장할 수 있는 디렉터리를 지정합니다. 이 디렉터리에 백업을 저장할 공간이 충분해야 합니다.

   

백업 및 복구 검증

SAP용 Google Cloud 에이전트의 Backint 기능을 사용 설정한 후에는 테스트 시스템에서 백업을 만들고 복원하여 검증해야 합니다.

테스트를 위해서는 에이전트의 기본 제공되는 자가 진단 도구를 사용할 수 있습니다. 이 기본 제공 도구를 실행하려면 파일 시스템에서 최소 18GB 이상의 사용 가능한 디스크 공간이 필요합니다. 이 기본 제공 도구를 사용하여 백업 및 복구를 검증하려면 다음 명령어를 실행합니다.

sudo /usr/bin/google_cloud_sap_agent backint -u=IDENTIFIER -p=PATH_TO_PARAMETERS_FILE -f=diagnose

다음을 바꿉니다.

• IDENTIFIER: 명령어 실행을 식별하는 값입니다. 이 식별자는 진단을 수행하는 동안 Cloud Storage 버킷에 생성된 임시 폴더에 이름을 지정하기 위해 사용됩니다.
• PATH_TO_PARAMETERS_FILE: PARAMETERS.json 파일의 경로입니다.

이 도구를 사용하는 동안 선택적인 diagnose_file_max_size_gb 및 diagnose_tmp_directory 매개변수를 사용할 수 있습니다. 이러한 매개변수에 대한 자세한 내용은 구성 매개변수에서 해당 설명을 참조하세요.

호스트에 Backint 에이전트를 설치한 경우 SAP용 Google Cloud 에이전트를 사용하여 백업 작업을 처음 실행하면 SAP용 Google Cloud 에이전트가 텍스트 구성 파일의 JSON 버전을 만듭니다. 자세한 내용은 Backint 에이전트에서 업그레이드를 참조하세요.

구성 파일 예시

다음은 SAP용 Google Cloud 에이전트의 Backint 기능에 대해 완료된 PARAMETERS.json 구성 파일입니다.

{
  "bucket": "example-bucket-backup",
  "recovery_bucket": "example-bucket-recovery",
  "parallel_streams": 8,
  "service_account_key": "path/to/key/file.json",
  "rate_limit_mb": 100,
  "log_to_cloud": true,
  "log_level": "DEBUG"
}

구성 매개변수

다음 표에서는 Backint 기능과 관련된 SAP용 Google Cloud 에이전트의 구성 매개변수를 보여줍니다.

Backint 에이전트와 SAP용 Google Cloud 에이전트의 구성 매개변수 간 매핑에 대해서는 구성 매개변수 매핑을 참조하세요.

측정항목 수집과 관련된 매개변수를 포함하여 SAP용 Google Cloud 에이전트의 구성 매개변수에 대해 자세히 알아보려면 해당 시나리오의 설치 가이드를 참조하세요.

{
  "bucket": "example-bucket-backup",
  "metadata": {"key1": "value1", "key2": "value2"},
  "log_to_cloud": true
}

{
  "bucket": "example-bucket-backup",
  "custom_time": "UTCNow+30d",
  "log_to_cloud": true
}

{
  "bucket": "example-bucket-backup",
  "custom_time": "2024-06-25T13:25:00Z",
  "log_to_cloud": true
}

문제 해결

SAP용 Google Cloud 에이전트 버전 3.6(최신)의 문제를 해결하려면 SAP용 Google Cloud 에이전트 문제 해결 가이드를 참조하세요.

지원 받기

SAP용 Google Cloud 에이전트 문제를 해결하는 데 도움이 필요하면 필요한 진단 정보를 수집하고 Cloud Customer Care에 문의하세요. 자세한 내용은 SAP HANA의 SAP용 Google Cloud 에이전트 진단 정보를 참조하세요.

다음 단계

• Backint 기반 백업을 만들고 이를 사용하여 SAP HANA 데이터베이스를 복구하는 방법을 알아보려면 Backint를 사용하여 SAP HANA 백업 및 복구를 참고하세요.