BYOM 엔진 버전 및 DB 인스턴스 문제 해결
다음 표는 RDS for SQL Server용 기존 보유 미디어 사용(BYOM) 엔진 버전 및 DB 인스턴스를 생성하고 관리할 때 발생하는 일반적인 문제를 진단 및 해결하는 데 도움이 됩니다.
| 오류 메시지 / 증상 | 원인 | 권장 수정 사항 |
|---|---|---|
InvalidParameterValue: RDS can't create the custom engine version because the provided <Name>.ISO file doesn't match the expected installer file for engine version 15.00.4435.7.v1 |
업로드한 RTM 파일이 명령에 지정된 SQL Server 메이저 버전 또는 에디션과 일치하지 않습니다. 예를 들어 2019 엔진 버전(15.xx)을 대상으로 하면서 SQL Server 2022 ISO를 업로드하는 경우입니다. | 1. 엔진 버전 접두사가 ISO와 일치하는지 확인합니다. 15.xx = SQL Server 2019, 16.xx = SQL Server 2022. 2. 엔진 파라미터가 에디션과 일치하는지 확인합니다. sqlserver-ee = Enterprise, sqlserver-se = Standard. 3. 올바른 RTM 파일을 S3에 업로드합니다. 4. 생성된 경우 실패한 BYOM 엔진 버전을 삭제합니다. 5. 일치하는 ISO를 사용하여 create-custom-db-engine-version을 다시 시도합니다. |
CreateCustomDBEngineVersionFault: RDS was unable to access the specified installer file in the S3 bucket. |
RDS가 S3 버킷에 액세스할 수 없거나 지정된 S3 위치에서 ISO 파일을 찾을 수 없습니다. | 1. S3 버킷에 RDS 서비스 액세스를 차단하는 정책이 없는지 확인합니다. 2. --database-installation-files-s3-bucket-name에서 S3 버킷 이름을 확인합니다. 3. --database-installation-files의 파일 이름이 정확히 일치하는지 확인합니다. 4. 버킷이 BYOM 엔진 버전과 동일한 리전에 있는지 확인합니다. 5. 액세스를 차단할 수 있는 SCP 또는 VPC 엔드포인트 정책이 있는지 확인합니다. 6. 다시 해 보세요.create-custom-db-engine-version |
InvalidParameterValue: RDS can't create the custom engine version because the provided file doesn't match the expected installer file for engine version |
CU 파일이 대상 엔진 버전과 일치하지 않습니다. | 1. 대상 마이너 버전의 올바른 CU KB 번호를 식별합니다. 2. 일치하는 CU 버전으로 create-custom-db-engine-version을 다시 시도합니다. |
InvalidParameterValue: The custom engine version isn't valid. Names can include only lowercase letters (a-z), dashes (-), underscores (_), and periods (.). Specify a valid CEV, refer to https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.create, and try again. |
CEV 이름이 지원되는 문자만 사용하고 BYOM 지원 SQL Server 에디션 또는 버전을 사용하고 있는지 확인합니다. | 1. 지원되는 엔진을 사용하고 있는지 확인합니다. sqlserver-ee 또는 sqlserver-se. 2. 엔진 버전이 SQL Server 2019(15.xx) 또는 SQL Server 2022(16.xx)인지 확인합니다. 3. 지원되는 에디션 및 버전으로 다시 시도합니다. |
InvalidCustomDBEngineVersionStateFault: You can't delete custom engine version sqlserver-ee 15.00.4465.1.v1. At least one instance and one backup is using the CEV. Change the version or delete the instances and backups, and try again. |
DB 인스턴스, 스냅샷 또는 읽기 복제본이 여전히 BYOM 버전을 사용하고 있습니다. | 1. 이 버전을 사용하는 리소스를 식별합니다. aws rds describe-db-instances --query "DBInstances[?EngineVersion=='<version>']". 2. 스냅샷을 식별합니다. aws rds describe-db-snapshots --query "DBSnapshots[?EngineVersion=='<version>']". 3. 인스턴스를 다른 버전으로 마이그레이션하거나 삭제합니다. 4. 연결된 스냅샷 및 자동 백업을 삭제합니다. 5. 다시 해 보세요.delete-custom-db-engine-version |
InvalidParameterCombination: The LicenseModel parameter is required for configurations with multiple options. |
BYOM이 이 버전에 대해 활성화되었지만 --license-model이 생략되었습니다. |
명령에 --license-model bring-your-own-media 또는 --license-model license-included를 추가합니다. |
The combination of engine sqlserver-se and version <version> isn't valid. Enter a valid custom engine version, and try again. |
이 오류는 (1) 대상 엔진 버전에 BYOM 엔진 버전이 존재하지 않는 경우, (2) 대상 BYOM 엔진 버전이 incompatible-media 또는 inactive 상태인 경우, (3) 지정된 엔진 버전이 지원되는 메이저/마이너 조합이 아닌 경우에 발생합니다. |
지원되는 엔진 버전을 확인하려면 먼저 describe-db-engine-versions를 실행하고 create-custom-db-engine-version을 사용하여 BYOM 엔진 버전을 생성합니다. |
InvalidParameterCombination: RDS can't perform the operation because the custom engine version <version> is in incompatible-installation-media status. Choose a custom engine version in one of the following statuses and try again: available, creating, pending-validation, validating. |
BYOM 엔진 버전 검증 실패 상태입니다. | 실패한 BYOM 엔진 버전을 삭제하고 올바른 설치 미디어를 다시 업로드한 다음 새 BYOM 엔진 버전을 생성합니다. |
InvalidParameterCombination: RDS does not support creating a DB instance with the following combination: DBInstanceClass=<instance class>, Engine=<Edition>, EngineVersion=<version>, LicenseModel=bring-your-own-media. For supported combinations of instance class and database engine version, see the documentation. |
지정한 인스턴스 유형이 BYOM에서 지원되지 않습니다. | 인스턴스 클래스가 BYOM을 지원하는지 확인하려면 describe-orderable-db-instance-options API:를 사용합니다. aws rds describe-orderable-db-instance-options --engine sqlserver-ee --engine-version <version> --db-instance-class <instance-class> --region <region> --query "OrderableDBInstanceOptions[?LicenseModel=='bring-your-own-media']". 또는 지원되는 인스턴스 클래스에 대한 Amazon RDS for SQL Server 요금 페이지 |
InvalidParameterCombination: The combination of engine and version isn't valid. Enter a valid custom engine version, and try again.에서ModifyDBInstance |
BYOM 인스턴스를 업그레이드하려면 대상 버전에 대한 BYOM 엔진 버전이 있어야 하며 적어도 available 상태여야 합니다. 대상 엔진 버전에 BYOM 엔진 버전이 없는 경우, 대상 BYOM 엔진 버전이 incompatible-media 또는 inactive 상태인 경우, 대상 버전이 ValidUpgradeTarget 배열에 없는 경우 modify-db-instance 직접 호출이 거부됩니다. |
describe-db-engine-versions 명령을 사용하여 유효한 마이너 버전 업그레이드 대상을 나열합니다. BYOM 인스턴스에 마이너 버전 업그레이드를 적용하기 전에 대상 버전에 유효한 BYOM 엔진 버전이 있는지 확인합니다. 그렇지 않은 경우 엔진 버전을 하나 생성하고 사용할 수 있을 때까지 기다립니다. |