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

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

이 기능에 대한 자세한 내용은 SAP HANA용 Backint 기반 백업 및 복구를 참조하세요.

Backint를 사용하여 SAP HANA에서 백업 및 복구 작업을 수행하는 방법에 대한 자세한 내용은 Backint를 사용하여 백업 및 복구 수행을 참조하세요.

시작하기 전에

SAP용 Google Cloud 에이전트 버전 3.2(최신)가 설치되었는지 확인합니다. 자세한 안내는 시나리오별 설치 가이드를 참조하세요.
베어메탈 솔루션 서버에 에이전트를 설치했다면, 필요한 기본 요건을 완료하고 서비스 계정을 설정했는지 확인합니다. 자세한 내용은 Linux에서 SAP용 Google Cloud 에이전트 구성을 참조하세요.
Compute Engine 가상 머신(VM) 인스턴스 또는 베어메탈 솔루션 서버 이외의 호스트에서 실행되는 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 버킷을 만드는 방법은 다음과 같습니다.

Google Cloud Console

Google Cloud Console에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷 페이지로 이동
버킷 만들기를 클릭합니다.
버킷 만들기 페이지에서 버킷 정보를 입력합니다. 다음 단계로 이동하려면 계속을 클릭합니다.
- 버킷 이름 지정에서 버킷 이름 지정 요구사항을 충족하는 이름을 입력합니다.
- 데이터를 저장할 위치 선택에서 다음을 수행합니다.
  - 위치 유형 옵션을 선택합니다.
  - 위치 옵션을 선택합니다.
- 데이터의 기본 스토리지 클래스 선택에서 스토리지 클래스를 선택합니다.
- 객체 액세스를 제어하는 방식 선택에서 액세스 제어 옵션을 선택합니다.
- 고급 설정(선택사항)에서 암호화 방법, 보관 정책 또는 버킷 라벨을 지정합니다.
만들기를 클릭합니다.

명령줄

STORAGE_CLASS를 원하는 스토리지 클래스로 바꿉니다.
LOCATION을 원하는 위치 (ASIA, EU, US) 로 바꿉니다.
BUCKET_NAME을 버킷 이름 요구사항을 충족하는 버킷 이름으로 바꿉니다.

gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

IAM 역할 설정

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

서비스 계정에 이 역할을 추가하려면 다음 단계를 따르세요.

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

IAM으로 이동
Google Cloud 프로젝트를 선택합니다.
역할을 추가할 서비스 계정을 찾습니다.
- 서비스 계정이 주 구성원 목록에 아직 없는 경우 어떠한 역할도 할당되지 않은 것입니다. 추가를 클릭하고 서비스 계정의 이메일 주소를 클릭하세요.
- 서비스 계정이 주 구성원 목록에 이미 있는 경우 기존 역할이 있는 것입니다. 수정하려는 서비스 계정에서 수정 버튼을 클릭합니다.
사용 가능한 역할 목록에서 스토리지 객체 관리자를 선택합니다.
추가 또는 저장을 클릭하여 서비스 계정에 역할을 적용합니다.

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

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

Cloud Storage 액세스인 경우, storage.googleapis.com
Compute Engine VM 인스턴스 메타데이터 서버의 경우:
- 인증용인 경우, oauth2.googleapis.com
- 169.254.169.254
- metadata.google.internal

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

Backint 기능 사용 설정

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

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

호스트가 Compute Engine VM이면 Google Cloud 콘솔의 VM 인스턴스 페이지에서 해당 VM 인스턴스에 대한 SSH 버튼을 클릭하거나 선호하는 SSH 메서드를 사용합니다.
SAP HANA 시스템 관리자로 전환합니다.
```
sudo su - SID_LCadm
```
SID_LC를 SID로 바꿉니다. 모든 문자는 소문자를 사용하세요.

또한 이 명령어는 SAP HANA 데이터베이스의 SID로 설정된 $SAPSYSTEMNAME을 비롯한 여러 환경 변수를 설정합니다.
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 에이전트에서 업그레이드를 참조하세요.
Backint 기능을 구성합니다.
명령어 실행
에이전트의 Backint 기능을 구성하려면 configurebackint 명령어를 실행합니다. Backint 구성 파일을 수정하는 것보다 이 방법을 사용하는 것이 좋습니다.
```
/usr/bin/google_cloud_sap_agent configurebackint \
  -f="PATH_TO_PARAMETERS_FILE" \
  -bucket="BUCKET_NAME"
```
다음을 바꿉니다.
- PATH_TO_PARAMETERS_FILE: PARAMETERS.json Backint 구성 파일의 경로입니다.
- BUCKET_NAME: SAP HANA 백업을 저장할 Cloud Storage 버킷의 이름을 지정합니다.
  
  필요한 경우 이 명령어를 실행하는 동안 더 많은 매개변수를 설정할 수 있습니다. 이러한 매개변수에 대한 자세한 내용은 구성 매개변수를 참조하세요.
구성 파일 수정
에이전트의 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. 선택적으로 다른 구성 매개변수를 수정할 수 있습니다. 이러한 매개변수에 대한 자세한 내용은 구성 매개변수를 참조하세요.
4. 구성 파일을 저장합니다.

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 시스템을 구성해야 합니다.

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

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

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

백업 및 복구 확인

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

테스트를 위해 에이전트에 내장된 자체 진단 도구를 사용할 수 있습니다. 이 기본 제공 도구를 사용하여 백업 및 복구를 검증하려면 다음 명령어를 실행합니다.

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 파일에 대한 경로입니다.

호스트에 Backint 에이전트를 설치한 경우 SAP용 Google Cloud 에이전트를 사용하여 백업 작업을 처음 실행하면 SAP용 Google Cloud 에이전트가 .txt 구성 파일의 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`	`String` SAP용 Google Cloud 에이전트가 읽고 쓰는 Cloud Storage 버킷의 이름을 지정합니다. 에이전트는 버킷의 스토리지 클래스로 백업 객체를 만들고 모든 스토리지 클래스를 지원합니다. 에이전트는 Compute Engine 기본 암호화를 사용하여 저장 데이터를 암호화합니다.
`recovery_bucket`	`String` (선택사항) 에이전트가 `RESTORE` 작업 중에 읽는 Cloud Storage 버킷의 이름을 지정합니다. 이 매개변수를 지정하지 않으면 에이전트가 모든 작업(`BACKUP`, `RESTORE`, `INQUIRE`, `DELETE`, `DIAGNOSE` 작업)에 `bucket` 매개변수에 지정된 버킷을 사용합니다.
`log_to_cloud`	`Boolean` (선택사항) SAP용 Google Cloud 에이전트의 Backint 관련 로그를 Cloud Logging으로 리디렉션하려면 `true`를 지정합니다. 기본값은 `true`입니다. Backint 관련 로그 파일에 대한 자세한 내용은 Logging을 참조하세요.
`log_level`	`String` (선택사항) SAP용 Google Cloud 에이전트의 Backint 기능의 로깅 수준을 지정하고 필요한 값을 설정합니다. 사용 가능한 로그 수준은 다음과 같습니다. `DEBUG` `INFO` `WARNING` `ERROR` 기본값은 `INFO`입니다. Cloud Customer Care에서 별도로 안내하지 않는 한 로깅 수준을 변경하지 마세요.
`compress`	`Boolean` (선택사항) SAP용 Google Cloud 에이전트가 Cloud Storage 버킷에 백업을 작성하는 동안 압축을 사용 설정할지 여부를 지정합니다. 기본값은 `false`입니다. 압축을 사용 설정하지 않는 것이 좋습니다. 압축은 Cloud Storage의 백업 비용을 줄이지만 백업 작업 중에는 더 많은 CPU 처리가 필요하며 유효한 백업 처리 속도가 느려집니다. 이 매개변수에 관계없이 SAP용 Google Cloud 에이전트는 복원 작업 시 압축된 백업 파일과 압축되지 않은 백업 파일을 모두 지원합니다.
`encryption_key`	`String` (선택사항) 백업을 암호화하는 데 사용하도록 Cloud Storage 버킷을 구성한 고객 제공 암호화 키의 경로를 지정합니다. base64로 인코딩된 AES-256 키의 정규화된 경로를 지정해야 합니다. `kms_key` 또는 `parallel_streams` 매개변수로 `encryption_key` 매개변수를 지정할 수 없습니다.
`kms_key`	`String` (선택사항) 백업을 암호화하는 데 사용하도록 Cloud Storage 버킷을 구성한 고객 관리 암호화 키의 경로를 지정합니다. `projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KMS_KEY_NAME` 형식을 사용하여 경로를 지정합니다. 각 항목의 의미는 다음과 같습니다. `KMS_PROJECT_ID`: KMS 키가 있는 Google Cloud 프로젝트의 ID입니다. `LOCATION`: KMS 키가 있는 Cloud KMS 위치입니다. `KEY_RING_NAME`: KMS 키가 포함된 키링의 이름입니다. `KMS_KEY_NAME`: KMS 키의 이름입니다. SAP HANA 시스템이 Compute Engine VM에서 실행 중인 경우 VM에서 키에 액세스할 수 있어야 합니다. SAP HANA 시스템이 Compute Engine VM 이외의 호스트에서 실행되는 경우 SAP용 Google Cloud 에이전트가 사용하는 서비스 계정에 Cloud KMS 키에 액세스할 수 있어야 합니다. 자세한 내용은 서비스 계정을 참조하세요. `encryption_key` 또는 `parallel_streams` 매개변수로 `kms_key` 매개변수를 지정할 수 없습니다.
`folder_prefix`	`String` 선택사항입니다. SAP용 Google Cloud 에이전트가 쓰고 읽는 Cloud Storage 버킷의 폴더에 대해 프리픽스를 설정하도록 지정합니다. 이 매개변수를 사용하여 동일한 Cloud Storage 버킷에 여러 SAP HANA 인스턴스의 백업을 구성할 수 있습니다. `folder1`와 같은 단일 폴더 또는 `folder1/folder2/folder3`과 같은 폴더의 다중 수준 경로를 지정할 수 있습니다. 이 프리픽스는 Cloud Storage에서 SAP HANA 백업 경로의 `BUCKET_NAME` 및 `SID` 값 사이에 폴더로 삽입됩니다. 자세한 내용은 버킷의 조직 백업을 참조하세요.
`recovery_folder_prefix`	`String` 선택사항입니다. `RESTORE` 작업 중에 에이전트가 읽는 Cloud Storage 버킷의 폴더에 대해 프리픽스를 설정하도록 지정합니다. 이 매개변수를 사용하여 동일한 Cloud Storage 버킷에 여러 SAP HANA 인스턴스의 백업을 구성할 수 있습니다. `folder1`와 같은 단일 폴더 또는 `folder1/folder2/folder3`과 같은 폴더의 다중 수준 경로를 지정할 수 있습니다.
`retries`	`Int` SAP용 Google Cloud 에이전트가 Cloud Storage 읽기 또는 쓰기에 실패한 시도를 재시도하는 최대 횟수를 지정합니다. 기본값은 `5`이며 권장 값이기도 합니다.
`parallel_streams`	`Int` (선택사항) 동시 업로드를 사용 설정하고 Google Cloud의 SAP 에이전트가 사용할 수 있는 최대 동시 업로드 스트림 수를 지정합니다. 기본값 `1`은 동시 업로드를 사용 중지합니다. 최댓값은 32입니다. 이 값을 초과하는 값은 32로 제한됩니다. 스트리밍 데이터에 동시 업로드를 사용 설정하거나 Cloud Storage 버킷에 보관 정책이 있는 경우 `xml_multipart_upload`도 `true`로 설정해야 합니다. 다음 중 하나라도 해당하는 경우 동시 업로드를 사용 설정하지 마세요. 대상 Cloud Storage 버킷은 보관 정책을 사용합니다. `encryption_key` 또는 `kms_key` 매개변수를 지정했습니다. 앞의 조건 중 하나가 충족되면 에이전트가 `1` 상태로 종료됩니다. 동시 업로드에 대한 자세한 내용은 동시 업로드를 참조하세요.
`xml_multipart_upload`	`Boolean` 선택사항입니다. Cloud Storage 버킷에 백업을 쓸 때 XML API 멀티파트 업로드 메서드를 사용할지 여부를 지정합니다. 기본값은 `false`입니다. XML API 멀티파트 업로드 메서드를 사용하려면 `parallel_streams`의 값이 `1`보다 커야 합니다. `xml_multipart_upload`는 로그 또는 카탈로그 백업을 동시에 처리할 때만 사용하는 것이 좋습니다. 데이터 백업을 동시에 처리하려면 `global.ini` 파일의 `backup` 섹션에서 `parallel_data_backup_backint_channels`를 설정하는 것이 좋습니다. 로그 및 데이터 백업을 위한 별도의 매개변수 파일을 만드는 방법 또는 `parallel_data_backup_backint_channels`의 값을 설정하는 방법은 Backint 기능을 위한 SAP HANA 구성을 참조하세요. 오류가 발생하면 XML 멀티파트 업로드가 자동으로 취소되고 업로드 중인 데이터가 삭제됩니다. 또한 업로드 작업이 실패할 경우 데이터가 삭제되도록 AbortIncompleteMultipartUpload의 수명 주기 조건을 설정하는 것이 좋습니다.
`storage_class`	`String` 선택사항입니다. Cloud Storage 버킷에 백업을 쓸 때 사용되는 스토리지 클래스를 지정합니다. 사용 가능한 스토리지 클래스는 다음과 같습니다. `STANDARD` `NEARLINE` `COLDLINE` `ARCHIVE` 기본값은 `STANDARD`입니다.
`rate_limit_mb`	`Int` 선택사항입니다. 백업 또는 복원 작업 시 Compute Engine의 아웃바운드 네트워크 대역폭 상한(MB)을 지정합니다. 기본적으로 Google Cloud는 SAP용 Google Cloud 에이전트의 네트워크 대역폭을 제한하지 않습니다. 이 매개변수를 설정하면 처리량이 달라질 수 있지만 지정한 한도를 초과하지는 않습니다.
`service_account_key`	`String` SAP용 Google Cloud의 에이전트가 Compute Engine VM에서 실행되지 않는 경우 JSON으로 인코딩된 Google Cloud 서비스 계정의 정규화된 경로를 지정합니다. SAP용 Google Cloud의 에이전트가 Compute Engine VM에서 실행되는 경우 이 매개변수를 지정하지 않고 Compute Engine 기본 인증을 사용하는 것이 좋습니다. 이 매개변수를 지정하면 SAP용 Google Cloud 에이전트가 Cloud Storage에 인증할 때 서비스 계정 키를 사용합니다.
`threads`	`Int` 이는 고급 미세 조정 매개변수입니다(선택사항). 고객 관리에서 별도로 요청하지 않는 한 이 매개변수를 수정하지 마세요. 기본값은 수정할 필요가 거의 없습니다. 작업자 스레드 수를 지정합니다. 기본값은 호스트의 프로세서 수입니다.
`file_read_timeout_ms`	`Int` 이는 고급 미세 조정 매개변수입니다(선택사항). 고객 관리에서 별도로 요청하지 않는 한 이 매개변수를 수정하지 마세요. 기본값은 수정할 필요가 거의 없습니다. SAP용 Google Cloud 에이전트가 백업 파일을 열 때까지 대기하는 최대 시간(밀리초)을 지정합니다. 기본값은 `60000`(60초)입니다.
`buffer_size_mb`	`Int` 이는 고급 미세 조정 매개변수입니다(선택사항). 고객 관리에서 별도로 요청하지 않는 한 이 매개변수를 수정하지 마세요. 기본값은 수정할 필요가 거의 없습니다. 백업 또는 복원 작업 시 Cloud Storage에 대한 HTTPS 요청 크기를 제어하려면 이 매개변수를 지정합니다. 기본 단위 크기는 100MB입니다. 즉, 100MB 데이터가 전송될 때까지 Cloud Storage와의 단일 HTTP 요청 스트림이 열린 상태로 유지됩니다. SAP용 Google Cloud 에이전트는 작업을 실패로 처리하기 전에 실패한 HTTP 요청을 여러 번 다시 시도하므로 버퍼 크기가 100MB보다 작으면 요청이 실패할 때 다시 전송해야 하는 데이터가 줄어듭니다. 반면 버퍼 사이즈가 커지면 처리량은 늘어나지만 메모리 사용량이 더욱 증가하고 요청 실패 시 데이터를 재전송하는 데 더 많은 시간이 걸릴 수 있습니다.
`retry_backoff_initial`	`Int` 이는 고급 미세 조정 매개변수입니다(선택사항). 고객 관리에서 별도로 요청하지 않는 한 이 매개변수를 수정하지 마세요. 기본값은 수정할 필요가 거의 없습니다. 지수 백오프 네트워크 재시도에 사용된 재시도 기간(초)을 초 단위로 지정하세요. 기본값은 `10`입니다.
`retry_backoff_max`	`Int` 이는 고급 미세 조정 매개변수입니다(선택사항). 고객 관리에서 별도로 요청하지 않는 한 이 매개변수를 수정하지 마세요. 기본값은 수정할 필요가 거의 없습니다. 지수 백오프 네트워크 재시도에 사용된 재시도 기간 최댓값을 초 단위로 지정하세요. 기본값은 `300`입니다.
`retry_backoff_multiplier`	`Float` 이는 고급 미세 조정 매개변수입니다(선택사항). 고객 관리에서 별도로 요청하지 않는 한 이 매개변수를 수정하지 마세요. 기본값은 수정할 필요가 거의 없습니다. 지수 백오프 네트워크 재시도에 사용된 재시도 기간의 배수를 지정하세요. 배수는 `1`보다 커야 하며 기본값은 `2`입니다.
`log_delay_sec`	`Int` 이는 고급 미세 조정 매개변수입니다(선택사항). 고객 관리에서 별도로 요청하지 않는 한 이 매개변수를 수정하지 마세요. 기본값은 수정할 필요가 거의 없습니다. Cloud Storage 버킷에 대한 읽기 및 쓰기 중 진행 상황 업데이트의 로깅 지연 시간(초)을 지정합니다. 기본값은 `60`입니다.
`client_endpoint`	`String` 이는 고급 미세 조정 매개변수입니다(선택사항). 고객 관리에서 별도로 요청하지 않는 한 이 매개변수를 수정하지 마세요. 기본값은 수정할 필요가 거의 없습니다. Cloud Storage 클라이언트의 엔드포인트를 지정합니다. 기본값은 `storage.googleapis.com`입니다.

문제 해결

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

지원 받기

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