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

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`\$1`--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
```