# RDS Custom for Oracle DB インスタンスのアップグレード
<a name="custom-upgrading-modify"></a>

**注記**  
サポート終了通知: AWS は、2027 年 3 月 31 日に、Amazon RDS Custom for Oracle のサポートを終了します。2027 年 3 月 31 日以降、RDS Custom for Oracle コンソールまたは RDS Custom for Oracle リソースにアクセスできなくなります。詳細については、「[RDS Custom for Oracle のサポート終了](RDS-Custom-for-Oracle-end-of-support.md)」を参照してください。

RDS Custom for Oracle DB インスタンスをアップグレードするには、新しい CEV を使用するように変更します。この CEV には、新しいデータベースバイナリまたは新しい AMI を含めることができます。例えば、Oracle Linux 7.9 DB インスタンスを Oracle Linux 8 にアップグレードするには、Oracle Linux 8 を使用する最新の AMI を指定します。データベースと OS をアップグレードする場合は、2 つのアップグレードを別々に実行する必要があります。

**注記**  
データベースをアップグレードする場合、RDS Custom はプライマリ DB インスタンスをアップグレードした後にリードレプリカを自動的にアップグレードします。OS をアップグレードする際は、レプリカを手動でアップグレードする必要があります。

始める前に、[RDS Custom for Oracle のアップグレードの要件](custom-upgrading.md#custom-upgrading-reqs) と [RDS Custom for Oracle のデータベースアップグレードに関する考慮事項](custom-upgrading-considerations.md) を確認してください。

## コンソール
<a name="custom-upgrading-modify.CON"></a>

**RDS Custom Oracle DB インスタンスをアップグレードするには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、**[データベース]** を選択し、アップグレードする RDS Custom for SQL Server DB インスタンスを選択します。

1. **[Modify]** (変更) を選択します。**Modify DB instance** ページが表示されます。

1. **DB エンジンバージョン**の場合は、新しい CEV を選択してください。以下の操作を実行します。
   + データベースにパッチを適用する場合は、CEV が DB インスタンスで使用されているものとは異なるデータベースバイナリを指定し、指定した AMI が DB インスタンスが現在使用している AMI と違っていないことを確認してください。
   + OS にパッチを適用する場合は、CEV が DB インスタンスで使用されている AMI とは異なる AMI を指定し、異なるデータベースバイナリを指定していないことを確認してください。
**警告**  
OS にパッチを適用すると、ルートボリュームデータや既存の OS カスタマイズは失われます。

1. **継続する** を選択して、変更の概要をチェックします。

   変更をすぐに反映させるには、**すぐに申し込む** を選択します。

1. 変更が正しい場合は、**[Modify DB Instance]** (DB インスタンスを変更) を選択します。または、[**戻る**] を選択して変更を編集するか、**キャンセル**を選択して変更をキャンセルします。

## AWS CLI
<a name="custom-upgrading-modify.CLI"></a>

以下の例は、考えられるアップグレードシナリオを示しています。この例では、RDS Custom for Oracle DB インスタンスを次の特性で作成したという前提です。
+ `my-custom-instance` という DB インスタンス名
+ `19.my_cev1` という名前の CEV
+ CDB 以外のアーキテクチャを使用した Oracle Database 19c
+ AMI `ami-1234` を使用する Oracle Linux 8

サービスが提供している最新の AMI は `ami-2345` です。CLI コマンド `describe-db-engine-versions` を実行して、エンドポイントを見つけることができます。

**Topics**
+ [OS のアップグレード](#custom-upgrading-modify.CLI.os)
+ [データベースのアップグレード](#custom-upgrading-modify.CLI.db)

### OS のアップグレード
<a name="custom-upgrading-modify.CLI.os"></a>

この例では、`ami-1234` を、サービスが提供している最新の AMIである `ami-2345` にアップグレードしたいと考えています。OS をアップグレードするため、データベースバイナリ `ami-1234` および `ami-2345` は同じである必要があります。`19.my_cev1` に基づいて `19.my_cev2` という名前の CEV を新規作成します。

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds create-custom-db-engine-version \
    --engine {{custom-oracle-ee}} \
    --engine-version {{19.my_cev2}} \
    --description {{"Non-CDB CEV based on ami-2345"}} \
    --kms-key-id {{key-name}} \
    --source-custom-db-engine-version-identifer {{arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12345678-ab12-1234-cde1-abcde123456789}} \
    --image-id {{ami-2345}}
```
Windows の場合:  

```
aws rds create-custom-db-engine-version ^
    --engine {{custom-oracle-ee}} ^
    --engine-version {{19.my_cev2}} ^
    --description {{"Non-CDB CEV based on ami-2345"}} ^
    --kms-key-id {{key-name}} ^
    --source-custom-db-engine-version-identifer {{arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12345678-ab12-1234-cde1-abcde123456789}} ^
    --image-id {{ami-2345}}
```

RDS Custom DB インスタンスをアップグレードするには、[modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) AWS CLIコマンドを次のパラメータを指定します。
+ `--db-instance-identifier` — アップグレードする RDS Custom for Oracle DB インスタンスを指定します。
+ `--engine-version` — 新しい AMI が搭載されている CEV を指定します。
+ `--no-apply-immediately`\|`--apply-immediately` - アップグレードをすぐに実行するか、あるいはスケジュールされたメンテナンスウィンドウまで待つかを指定します。

次の例では、`my-custom-instance`バージョンを`19.my_cev2`にアップグレードします。OS のみがアップグレードされます。

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-instance \
    --db-instance-identifier {{my-custom-instance}} \
    --engine-version {{19.my_cev2}} \
    --apply-immediately
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier {{my-custom-instance}} ^
    --engine-version {{19.my_cev2}} ^
    --apply-immediately
```

### データベースのアップグレード
<a name="custom-upgrading-modify.CLI.db"></a>

この例では、RDS for Oracle DB インスタンスに Oracle パッチ p35042068 を適用します。[OS のアップグレード](#custom-upgrading-modify.CLI.os) で OS をアップグレードしたため、DB インスタンスでは現在 `19.my_cev2` を使用していますが、これは `ami-2345` に基づいています。また `ami-2345` も使用する `19.my_cev3` という名前の新しい CEV を作成しますが、`$MANIFEST` 環境変数には新しい JSON マニフェストを指定します。そのため、新しい CEV とインスタンスが現在使用している CEV で異なるのは、データベースバイナリのみです。

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds create-custom-db-engine-version \
    --engine {{custom-oracle-ee}} \
    --engine-version {{19.my_cev3}} \
    --description {{"Non-CDB CEV with p35042068 based on ami-2345"}} \
    --kms-key-id {{key-name}} \
    --image-id {{ami-2345}} \
    --manifest {{$MANIFEST}}
```
Windows の場合:  

```
aws rds create-custom-db-engine-version ^
    --engine {{custom-oracle-ee}} ^
    --engine-version {{19.my_cev3}} ^
    --description {{"Non-CDB CEV with p35042068 based on ami-2345"}} ^
    --kms-key-id {{key-name}} ^
    --image-id {{ami-2345}} ^
    --manifest {{$MANIFEST}}
```

次の例では、`my-custom-instance` をエンジンバージョン`19.my_cev3` にアップグレードします。データベースのみがアップグレードされます。

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-instance \
    --db-instance-identifier {{my-custom-instance}} \
    --engine-version {{19.my_cev3}} \
    --apply-immediately
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier {{my-custom-instance}} ^
    --engine-version {{19.my_cev3}} ^
    --apply-immediately
```