SAP HANA용 Backint 에이전트 문제 해결

중요: 새로 설치하는 경우 SAP HANA용 Cloud Storage Backint 에이전트를 사용하는 대신 후속 버전인 Google Cloud SAP용 에이전트를 사용하는 것이 좋습니다. SAP용 Google Cloud 에이전트 버전 3.0부터는 SAP 호스트 에이전트 측정항목 수집을 SAP HANA용 Backint 기반 백업 및 복구 같은 다른 기능과 결합합니다.

Backint 에이전트를 사용하는 경우 Backint 에이전트에 대한 지원이 중단되기 전에 가능한 빨리 SAP용 Google Cloud 에이전트 버전 3.3(최신)을 사용하도록 전환하는 것이 좋습니다. 업그레이드 안내는 다른 Google Cloud 에이전트에서 SAP용 Google Cloud 에이전트로 업그레이드를 참조하세요.

Backint 에이전트 지원은 2025년 2월에 종료됩니다. 2024년 2월 이후에 정식 버전(GA)으로 출시된 Compute Engine 머신 유형에서는 이 에이전트가 지원되지 않습니다.

백업 또는 복구 실행 중에 오류가 발생하면 SAP HANA Studio 또는 SAP HANA Cockpit에 오류 메시지가 표시되므로 먼저 거기서 오류 원인에 대한 정보를 확인합니다. 이 정보는 backup.log 및 backint.log 추적 파일에 표시될 수 있습니다. MDC(multitenant database container)를 사용하는 경우 관련 데이터베이스 이름을 선택해야 합니다.

Backint 에이전트를 sidadm 사용자로 설치했는지 확인합니다.

로그 파일

오류가 발생하면 다음 로그를 검토하세요.

• SAP HANA 백업 및 복구 작업에 대한 정보가 포함된 SAP HANA backup.log.
• Backint 에이전트 및 다른 외부 백업 도구에서 사용하는 백업 인터페이스에 대한 호출이 포함된 SAP HANA backint.log.
• Backint 에이전트 설치 및 작업 이벤트가 포함된 Backint 에이전트 로그 파일입니다. Backint 에이전트 로그 파일은 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs에 있습니다. Backint 에이전트 로그에는 Cloud Storage와의 통신 오류 표시 및 관련 구성이나 권한 문제가 포함될 수 있습니다.
• Backint 에이전트가 사용하는 서비스 계정과 관련된 오류가 포함될 수 있는 Google Cloud 로그입니다. Google Cloud 로그를 검토하려면 Google Cloud 콘솔의 로그 탐색기 페이지를 참조하세요.

또한 SAP HANA 호스트의 디스크 및 네트워크 I/O 정보를 확인하여 활동을 확인합니다.

Backint 에이전트 로깅에 대한 자세한 내용은 Backint 에이전트 로깅을 참조하세요.

연결 문제

Backint 에이전트를 Cloud Storage 버킷에 연결할 수 없는 경우 구성 단계를 검토합니다. 특히 다음 항목을 확인합니다.

• 실패한 백업 또는 복원을 다시 시도하여 오류가 일시적인 연결 문제가 아닌지 확인합니다.
• 호스트 VM의 서비스 계정을 Backint 에이전트와 함께 사용할 경우 스토리지의 액세스 범위는 Google Cloud 콘솔의 VM 인스턴스 세부정보 페이지에서 Cloud API 액세스 범위 아래 읽기 쓰기로 표시됩니다. 그렇지 않으면 인스턴스를 중지하고 액세스 범위를 수정합니다.
• Backint 에이전트에 대한 서비스 계정을 생성한 경우 다음 항목을 확인합니다.
  • Google Cloud 콘솔의 Bucket 세부정보 페이지에 있는 권한 탭에서 Backint 에이전트 서비스 계정이 표시되어 있는지, 해당 계정에 스토리지 객체 관리 역할이 있는지 확인합니다.
  • 비공개 키를 만들어 SAP HANA 호스트에 저장하고 Backint 에이전트 구성 파일 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt에 JSON 키 파일 경로를 올바르게 지정했는지 확인합니다.
• 모든 매개변수가 parameters.txt Backint 에이전트 구성 파일 및 SAP HANA global.ini 파일에 올바르게 지정됩니다.

Google Cloud CLI에 포함된 Cloud Storage gsutil 도구를 사용하여 SAP HANA 호스트에서 Cloud Storage 버킷에 대한 액세스를 테스트할 수 있습니다. gsutil 도구를 사용하여 Cloud Storage 버킷의 텍스트 파일을 저장하고 액세스합니다.

1. 기본 서비스 계정을 사용하지 않는 경우에는 Google Cloud에서 Cloud Storage 버킷이나 Backint 에이전트 서비스 계정에 승인된 사용자로 인증됩니다.

   gcloud auth login user-account

   또는:

   gcloud auth activate-service-account --key-file=/path/key-file-name.json

   서비스 계정의 Cloud Storage 인증에 대한 자세한 내용은 gsutil 인증을 참조하세요.

2. 버킷에 저장된 객체를 나열할 수 있는지 확인합니다.

   gsutil ls gs://bucket/

3. 테스트 파일을 만듭니다.

   touch test.txt

4. 버킷에 테스트 파일을 쓸 수 있는지 확인합니다.

   gsutil cp test.txt gs://bucket/test.txt

5. 버킷에서 테스트 파일을 읽을 수 있는지 확인합니다.

   gsutil cp gs://bucket/test.txt

낮은 처리량

처리량이 예상보다 낮은 경우 압축이 사용 중지되었는지 확인합니다.

압축을 사용 중지하려면 #DISABLE_COMPRESSION 플래그를 Backint 에이전트 parameters.txt 파일에 추가합니다.

멀티스트리밍 오류

멀티스트리밍 중 오류가 발생하는 경우, 스트림 수를 1로 변경하고 오류가 스트림 수와 관련이 있는지 확인합니다.

Backint 에이전트 로깅에 대한 자세한 내용은 Backint 에이전트로 멀티스트리밍 데이터 백업을 참조하세요.