

# Amazon RDS Custom for Oracle の DB に関する問題のトラブルシューティング
<a name="custom-troubleshooting"></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 の責任共有モデルは、OS シェルレベルのアクセスとデータベース管理者アクセスを提供します。RDS Custom は、システムアカウントでリソースを実行する Amazon RDS とは異なり、アカウント内でリソースを実行します。アクセスが増えるほど、責任も重くなります。以降のセクションで、Amazon RDS Custom DB インスタンスに関する問題のトラブルシューティング方法を学ぶことができます。

**注記**  
このセクションでは RDS Custom for Oracle をトラブルシューティングする方法について説明します。RDS Custom for SQL Server のトラブルシューティングについては、「[Amazon RDS Custom for SQL Server の DB に関する問題のトラブルシューティング](custom-troubleshooting-sqlserver.md)」を参照してください。

**Topics**
+ [RDS Custom イベントの表示](#custom-troubleshooting.support-perimeter.viewing-events)
+ [RDS Custom イベントへのサブスクライブ](#custom-troubleshooting.support-perimeter.subscribing)
+ [DB インスタンス作成に関する問題のトラブルシューティング](#custom-troubleshooting.creation-issues)
+ [RDS Custom for Oracle のカスタムエンジンバージョン作成のトラブルシューティング](#custom-troubleshooting.cev)
+ [RDS Custom for Oracle でサポートされていない構成の修正](#custom-troubleshooting.fix-unsupported)
+ [RDS Custom for Oracle のアップグレードに関するトラブルシューティング](#custom-troubleshooting-upgrade)
+ [RDS Custom for Oracle のレプリカプロモーションのトラブルシューティング](#custom-troubleshooting-promote)

## RDS Custom イベントの表示
<a name="custom-troubleshooting.support-perimeter.viewing-events"></a>

イベントを表示する手順は、RDS Custom とAmazon RDS DB インスタンスでは同じです。詳細については、「[Amazon RDS イベントの表示](USER_ListEvents.md)」を参照してください。

 AWS CLIを使用してRDS Custom イベント通知を表示するには、`describe-events`コマンドを使用します。RDS Custom では、いくつかの新しいイベントを導入しています。イベントカテゴリは Amazon RDS の場合と同じです。イベントのリストについては、[ Amazon RDS イベントカテゴリとイベントメッセージ](USER_Events.Messages.md)を参照してください。

次の例では、指定した RDS Custom DB インスタンスで発生したイベントの詳細を取得します。

```
1. aws rds describe-events \
2.     --source-identifier my-custom-instance \
3.     --source-type db-instance
```

## RDS Custom イベントへのサブスクライブ
<a name="custom-troubleshooting.support-perimeter.subscribing"></a>

イベント受信の手順は、RDS Custom とAmazon RDS DB インスタンスでは同じです。詳細については、「[Amazon RDS イベント通知にサブスクライブする](USER_Events.Subscribing.md)」を参照してください。

CLI を使用して RDS Custom イベント通知をサブスクライブするには、`create-event-subscription` コマンドを使用します。以下の必須パラメータを含めます。
+ `--subscription-name`
+ `--sns-topic-arn`

次の例では、現在のAWSアカウントのRDS Custom DB インスタンスのバックアップおよびリカバリイベントの受信を作成します。通知は、`--sns-topic-arn`で指定されたAmazon Simple Notification Service (Amazon SNS) のトピックに送信されます。

```
1. aws rds create-event-subscription \
2.     --subscription-name my-instance-events \
3.     --source-type db-instance \
4.     --event-categories '["backup","recovery"]' \
5.     --sns-topic-arn arn:aws:sns:us-east-1:123456789012:interesting-events
```

## DB インスタンス作成に関する問題のトラブルシューティング
<a name="custom-troubleshooting.creation-issues"></a>

環境が正しく設定されていないか、必要なアクセス許可がない場合、RDS Custom for Oracle DB インスタンスを作成または復元することはできません。DB インスタンスを作成または復元しようとすると、Amazon RDS は環境を検証し、問題を検出した場合に特定のエラーメッセージを返します。

すべての問題を解決したら、RDS Custom for Oracle DB インスタンスの作成または復元を再試行してください。

### アクセス許可に関する一般的な問題
<a name="custom-troubleshooting.creation-issues.permissions"></a>

RDS Custom for Oracle インスタンスを作成または復元すると、Amazon RDS は環境に必要なアクセス許可があることを確認します。アクセス許可が欠落または拒否された場合、オペレーションは特定のエラーメッセージで失敗します。


| 問題タイプ | エラーメッセージ | アクション | 
| --- | --- | --- | 
| IAM ロールアクセスポリシー | You can't create the DB instance because of incompatible resources. The host environment validation failed for the following permissions: <permission> on resource: <resource> due to permissions issue with message: User: <user> is not authorized to perform: <permission> on resource: <resource> because no identity-based policy allows the <permission> action. | リストされている必要なアクセス許可が存在し、適切なリソースが含まれているアクセスポリシーで `Allow` に設定されていることを確認します。 | 
| アクセス許可の境界 | You can't create the DB instance because of incompatible resources. The host environment validation failed for the following permissions: <permission> on resource: <resource> due to permissions issue with message: User: <user> is not authorized to perform: <permission> on resource: <resource> with an explicit deny in a permissions boundary. | インスタンスロールにアタッチされたアクセス許可の境界が、リストされている必要なアクセス許可とリソースを制限していないことを確認します。 | 
| サービスコントロールポリシー | You can't create the DB instance because of incompatible resources. The host environment validation failed for the following permissions: <permission> on resource: <resource> due to permissions issue with message: User: <user> is not authorized to perform: <permission> on resource: <resource> with an explicit deny in a service control policy. | AWS Organizations 管理者に連絡し、アカウントにアタッチされたサービスコントロールポリシーが、リストされている必要なアクセス許可とリソースを制限していないことを確認します。 | 
| リソースコントロールポリシー | You can't create the DB instance because of incompatible resources. The host environment validation failed for the following permissions: <permission> on resource: <resource> due to permissions issue with message: User: <user> is not authorized to perform: <permission> on resource: <resource> with an explicit deny in a resource control policy. | AWS Organizations 管理者に連絡し、アカウントにアタッチされたリソースコントロールポリシーが、リストされている必要なアクセス許可とリソースを制限していないことを確認します。 | 
| VPC エンドポイントポリシー | You can't create the DB instance because of incompatible resources. The host environment validation failed for the following permissions: <permission> on resource: <resource> due to permissions issue with message: User: <user> is not authorized to perform: <permission> on resource: <resource> with an explicit deny in a VPC endpoint policy. | 必要な VPC エンドポイントが存在し、それらにアタッチされたポリシーが、リストされている必要なアクセス許可とリソースを制限していないことを確認します。 | 

### ネットワーキングの問題
<a name="custom-troubleshooting.creation-issues.networking"></a>

[ステップ 6: RDS Custom for Oracle 用に VPC を設定する](custom-setup-orcl.md#custom-setup-orc.vpc-config) の確認に加えて、以下が正しく設定され、必要な AWS のサービスへのアクセスが制限されていないことを確認します。

**Amazon EC2 インスタンスにアタッチされているセキュリティグループ**  
セキュリティグループが RDS Custom オペレーションに必要なすべてのインバウンドトラフィックとアウトバウンドトラフィックを許可していることを確認します。

**VPC にアタッチされたセキュリティグループ**  
VPC セキュリティグループが、必要な AWS のサービスとの間のトラフィックを許可していることを確認します。

**VPC エンドポイント**  
必要なすべての VPC エンドポイントが正しく設定され、アクセス可能であることを確認します。

**ネットワークアクセスコントロールリスト**  
ネットワーク ACL が RDS Custom 機能に必要なトラフィックをブロックしていないことを確認します。

## RDS Custom for Oracle のカスタムエンジンバージョン作成のトラブルシューティング
<a name="custom-troubleshooting.cev"></a>

CEV の作成に失敗すると、RDS Custom はメッセージ`Creation failed for custom engine version {{major-engine-version.cev_name}}`とともに`RDS-EVENT-0198`を発行し、これは障害に関する詳細を含んでいます。例えば、イベントは不足ファイルを出力します。

次の問題が原因で、CEV の作成に失敗することがあります。
+ インストールファイルの入った Amazon S3 バケットが、CEV と同じ AWS リージョンにありません。
+ AWS リージョンで初めて CEV 作成をリクエストすると、RDS Custom は RDS Custom リソース (CEV アーティファクト、AWS CloudTrailログ、トランザクションログなど) を保存するための S3 バケットを作成します。

  RDS Custom が S3 バケットを作成できないと、CEV の作成は失敗します。「[ステップ 5: IAM ユーザーまたはロールに必要なアクセス許可を付与する](custom-setup-orcl.md#custom-setup-orcl.iam-user)」で説明されているように、発信者に S3 権限がないか、あるいは S3 バケットの数が制限に達しています。
+ 発信者には、インストールメディアファイルが含まれている S3 バケットからファイルを取得する権限がありません。これらの権限については、[ステップ 7: 必要な IAM アクセス許可を追加する](custom-cev.preparing.md#custom-cev.preparing.iam)を参照してください。
+ IAM ポリシーには `aws:SourceIp` 条件があります。「*AWS Identity and Access Management ユーザーガイド*」の「[AWS: 送信元 IP に基づいて AWS へのアクセスを拒否する](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_aws_deny-ip.html)」に記載されている推奨事項に、必ず従ってください。また呼び出し元に、「[ステップ 5: IAM ユーザーまたはロールに必要なアクセス許可を付与する](custom-setup-orcl.md#custom-setup-orcl.iam-user)」で説明した S3 へのアクセス許可があることを確認します。
+ CEV マニフェストに記載されているインストールメディアファイルが S3 バケットにありません。
+ インストールファイルの SHA-256 チェックサムは RDS Custom で不明です。

  提供されたファイルの SHA-256 チェックサムが、Oracle Web サイトの SHA-256 チェックサム と一致していることを確認します。チェックサム が一致する場合は、失敗した CEV 名、ファイル名、およびチェックサムを[AWSサポート](https://aws.amazon.com/premiumsupport)に連絡してください。
+ Opatch バージョンはパッチファイルとの互換性がありません。次のメッセージが表示される場合があります。`OPatch is lower than minimum required version. Check that the version meets the requirements for all patches, and try again`。Oracle パッチを適用するには、互換性のあるバージョンの OPatch ユーティリティを使用する必要があります。Opatch ユーティリティの必要なバージョンは、パッチの readme ファイルにあります。My Oracle Support から最新の OPatch ユーティリティをダウンロードし、CEV を再度作成してください。
+ CEV マニフェストで指定されたパッチの順序が間違っています。

RDS イベントは、RDS コンソール (ナビゲーションペインで**イベント**) を選択) で、または`describe-events` AWS CLIコマンドを使用して表示できます。デフォルトの期間は 60 分間です。イベントが返されない場合は、次の例のようにより長い期間を指定します。

```
aws rds describe-events --duration 360
```

現在、Amazon S3 からファイルをインポートして CEV を作成する MediaImport サービスは、AWS CloudTrailと統合されていません。そのため、CloudTrail で Amazon RDS のデータログを有効にすると、`CreateCustomDbEngineVersion`イベントのようなMediaImport サービスの呼び出しはログに記録されません。

ただし、Amazon S3 バケットにアクセスする API Gateway からの呼び出しが表示される場合があります。これらの呼び出しは、`CreateCustomDbEngineVersion`イベントの MediaImport サービスから出されます。

## RDS Custom for Oracle でサポートされていない構成の修正
<a name="custom-troubleshooting.fix-unsupported"></a>

共有責任モデルでは、RDS Custom for Oracle DB インスタンスを `unsupported-configuration` 状態にする設定上の問題は、お客様の責任で解決していただく必要があります。問題が AWS インフラストラクチャにある場合は、コンソールや AWS CLI を使用して修正できます。OS またはデータベースの設定に問題がある場合は、ホストにログインして修正できます。

**注記**  
このセクションでは RDS Custom for Oracle でサポートされていない構成を修正する方法について説明します。RDS Custom for SQL Server の詳細については、「[RDS Custom for SQL Server DB でサポートされていない構成の修正](custom-troubleshooting-sqlserver.md#custom-troubleshooting-sqlserver.fix-unsupported)」を参照してください。

次の表では、サポートペリメーターが送信する通知とイベント、その修正方法について説明します。これらの通知とサポートペリメーターは変更されることがあります。サポート周辺の背景については、「[RDS Custom サポート範囲](custom-concept.md#custom-troubleshooting.support-perimeter)」を参照してください。イベントの説明については、「[ Amazon RDS イベントカテゴリとイベントメッセージ](USER_Events.Messages.md)」を参照してください。


| イベント ID | 設定 | RDS イベントメッセージ | アクション | 
| --- | --- | --- | --- | 
| `SP-O0000` | サポートされていない手動設定 | The RDS Custom DB instance status is set to [Unsupported configuration] because of: {{reason}}. | この問題を解決するには、サポートケースを作成します。 | 

**AWS リソース (インフラストラクチャ)**


| イベント ID | 設定 | RDS イベントメッセージ | アクション | 
| --- | --- | --- | --- | 
| SP-O1001 | Amazon Elastic Block Store (Amazon EBS) ボリューム | The following EBS volumes were added to EC2 instance {{ec2\_id}}: {{volume\_id}}. To resolve the issue, detach the specified volumes from the instance. | RDS Custom は、Amazon マシンイメージ (AMI) から作成したルートボリュームのほか、2 種類の EBS ボリュームを作成して EC2 インスタンスに関連付けます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />DB インスタンスを作成する際に指定したストレージ設定により、データボリュームが設定されます。<br />サポートペリメーターは、次のことをモニタリングします。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />次の CLI コマンドを使用して、EBS ボリュームの詳細と RDS Custom for Oracle インスタンスの詳細のボリュームタイプを比較します。<pre>aws rds describe-db-instances \ <br />    --db-instance-identifier db-instance-name | grep StorageType</pre> | 
| SP-O1002 | Amazon Elastic Block Store (Amazon EBS) ボリューム | EBS volume {{volume\_id}} has been detached from EC2 instance [{{ec2\_id}}]. You can't detach the original volume from this instance. To resolve the issue, re-attach {{volume\_id}} to {{ec2\_id}}. | RDS Custom は、Amazon マシンイメージ (AMI) から作成したルートボリュームのほか、2 種類の EBS ボリュームを作成して EC2 インスタンスに関連付けます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />DB インスタンスを作成する際に指定したストレージ設定により、データボリュームが設定されます。<br />サポートペリメーターは、次のことをモニタリングします。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />次の CLI コマンドを使用して、EBS ボリュームの詳細と RDS Custom for Oracle インスタンスの詳細のボリュームタイプを比較します。<pre>aws rds describe-db-instances \ <br />    --db-instance-identifier db-instance-name | grep StorageType</pre> | 
| SP-O1003 | Amazon Elastic Block Store (Amazon EBS) ボリューム | The original EBS volume {{volume\_id}} attached to EC2 instance {{ec2\_id}} has been modified as follows: size [{{X}}] to [{{Y}}], type [{{N}}] to [{{M}}], or IOPS [{{J}}] to [{{K}}]. To resolve the issue, revert the modification. | RDS Custom は、Amazon マシンイメージ (AMI) から作成したルートボリュームのほか、2 種類の EBS ボリュームを作成して EC2 インスタンスに関連付けます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />DB インスタンスを作成する際に指定したストレージ設定により、データボリュームが設定されます。<br />サポートペリメーターは、次のことをモニタリングします。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />次の CLI コマンドを使用して、EBS ボリュームの詳細と RDS Custom for Oracle インスタンスの詳細のボリュームタイプを比較します。<pre>aws rds describe-db-instances \ <br />    --db-instance-identifier db-instance-name | grep StorageType</pre> | 
| SP-O1004 | Amazon EC2 インスタンスの状態 | Automated recovery left EC2 instance [{{ec2\_id}}] in an impaired state. To resolve the issue, see [Troubleshooting instance recovery failures](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-recover.html#TroubleshootingInstanceRecovery). | DB インスタンスのステータスを確認するには、コンソールを使用するか、次の AWS CLI コマンドを実行します。<pre>aws rds describe-db-instances \ <br />    --db-instance-identifier {{db-instance-name}} |grep DBInstanceStatus </pre> | 
| SP-O1005 | Amazon EC2 インスタンス属性 | EC2 instance [{{ec2\_id}}] was modified as follows: attribute [{{att1}}] changed from [{{val-old}}] to [{{val-new}}], attribute [{{att2}}] changed from [{{val-old}}] to [{{val-new}}]. To resolve the issue, revert to the original value. |  | 
| SP-O1006 | Amazon EC2 インスタンスの状態 | EC2 instance [{{ec2\_id}}] was terminated or can't be found. To resolve the issue, delete the RDS Custom DB instance. | サポートペリメーターは、 EC2 インスタンスの状態変更通知をモニタリングします。EC2 インスタンスは常に実行されている必要があります。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html) | 
| SP-O1007 | Amazon EC2 インスタンスの状態 | EC2 instance [{{ec2\_id}}] was stopped. To resolve the issue, start the instance. | サポートペリメーターは、 EC2 インスタンスの状態変更通知をモニタリングします。EC2 インスタンスは常に実行されている必要があります。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html) | 
| SP-1008 | Amazon SQS のアクセス許可 | Permissions are missing for Amazon SQS. Check the permissions for the IAM instance profile, VPC endpoint policy, and dependent service connections, and then try again. |  これは、ホストに関連付けられた IAM プロファイルに次のアクセス許可があることを確認することで解決できます。<pre>"SQS:SendMessage"<br />"SQS:ReceiveMessage"<br />"SQS:DeleteMessage"<br />"SQS:GetQueueUrl"</pre> | 
| SP-1009 | Amazon Simple Queue Service (Amazon SQS) | The SQS queue [%s] was deleted and couldn't be recovered. この問題を解決するには、キューを再作成します。 | Amazon SQS キュー を再作成します。 | 

**オペレーティングシステム**


| イベント ID | 設定 | RDS イベントメッセージ | アクション | 
| --- | --- | --- | --- | 
| SP-O2001 | RDS カスタムエージェントステータス | The RDS Custom agent isn't running on EC2 instance [{{ec2\_id}}]. Make sure the agent is running on [{{ec2\_id}}]. | RDS Custom for Oracle では、RDS カスタムエージェントが停止すると、DB インスタンスはサポートペリメーターを外れます。エージェントは、30 秒ごとに`IamAlive`メトリクスを Amazon CloudWatch に公開します。メトリクスが 30 秒間公開されないと、アラームがトリガーされます。サポート境界は、1 分ごとにホストの RDS Custom エージェントプロセスの状態をモニタリングします。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />RDS Custom エージェントが再び実行されると、`IamAlive`メトリクスが Amazon CloudWatch に公開され、アラームが`OK`状態に切り替わります。この切り替えは、エージェントが実行中であることをサポートペリメーターに通知します。 | 
| `SP-O2002` | AWS Systems Manager エージェント (SSM エージェント) ステータス | The Systems Manager agent on EC2 instance [{{ec2\_id}}] is unreachable. Make sure that you that have correctly configured the network, agent, and IAM permissions.   | SSM Agent は常に実行されている必要があります。RDS Custom エージェントは、Systems Manager Agent が実行されていることを確認するロールがあります。SSM Agent が終了して再起動した場合、RDS Custom エージェントはメトリクス `SSM_Agent_Restarted_Or_NotFound` を CloudWatch に発行します。RDS Custom エージェントには、過去 3 分ごとに再起動があった場合にトリガーするように設定されたメトリクス `do-not-delete-rds-custom-ssm-agent-restarted-or-notfound-{{ec2-id}}` のアラームがあります。サポート境界は、ホスト上の SSM Agent のプロセス状態も 30 分ごとにモニタリングします。<br />詳細については、「[SSM Agent のトラブルシューティング](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-ssm-agent.html)」を参照してください。 | 
| `SP-O2003` | AWS Systems Manager エージェント (SSM エージェント) ステータス | The Systems Manager agent on EC2 instance [{{ec2\_id}}] crashed multiple times. For more information, see the SSM Agent troubleshooting documentation. | 詳細については、「[SSM Agent のトラブルシューティング](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-ssm-agent.html)」を参照してください。 | 
| SP-O2004 | OS のタイムゾーン | The time zone on EC2 instance [{{ec2\_id}}] was changed. To resolve this issue, revert the timezone to the previous setting of [{{previous-time-zone}}]. Then use an RDS options group to change the time zone. | RDS オートメーションは、ホストのタイムゾーンがオプショングループを使用せずに変更されたことを検出しました。このホストレベルの変更により RDS オートメーションが失敗する可能性があるため、EC2 インスタンスは `unsupported-configuration` 状態になります。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />DB インスタンスは 30 分以内に利用可能になります。将来ペリメーターから外れないようにするため、オプショングループを使用してタイムゾーンを変更します。詳細については、「[Oracle のタイムゾーン](custom-managing.timezone.md)」を参照してください。 | 
| SP-O2005 | `sudo` 設定 | The sudo configurations on EC2 instance [{{ec2\_id}}] lack necessary permissions. To resolve this issue, revert the recent changes to the sudo configurations. | サポートペリメーターは、特定の OS ユーザーがホスト上で特定のコマンドを実行できることを検証します。`sudo` 設定をモニタリングし、サポートされている状態と比較します。<br />`sudo` の設定がサポートされていない場合、RDS Custom は以前のサポートされた状態に上書きして戻そうとします。上書きが成功すると、RDS Custom は次の通知を送信します。<br />RDS Custom が設定を上書きしました。<br />上書きが失敗した場合、DB インスタンスの設定はサポートされていない状態のままになります。この問題を解決するには、`sudoers.d/` ファイル内の変更を元に戻すか、アクセス許可を修正します。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />サポート境界が `sudo` 設定に対応していると判断すると、30 分以内に RDS Custom for Oracle DB インスタンスが利用できるようになります。 | 
| SP-O2006 | S3 バケットのアクセシビリティ | RDS Custom automation can't download files from the S3 bucket on EC2 instance [{{ec2\_id}}]. Check your networking configuration and make sure the instance allows connections to and from S3.   |  | 
| SP-2007 | 高可用性ソフトウェアソリューションバージョン | The HA solution of your instance differs from the expected version. この問題を解決するには、AWS サポート ケースを作成します。 | AWS サポート ケースを作成する。 | 

**データベース**


| イベント ID | 設定 | RDS イベントメッセージ | アクション | 
| --- | --- | --- | --- | 
| SP-O3001 | データベースアーカイブ遅延ターゲット | The ARCHIVE\_LAG\_TARGET parameter on EC2 instance [{{ec2\_id}}] is out of the recommended range {{value\_range}}. To resolve the issue, set the parameter to a value within value\_range.   | サポート境界は、DB インスタンスの最新の復元可能時間が妥当な範囲内であることを確認するため、`ARCHIVE_LAG_TARGET` データベースパラメータをモニタリングします。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />DB インスタンスは 30 分以内に利用可能になります。 | 
| SP-O3002 | Oracle Data Guard ロール | The database role [{{role\_name}}] isn't supported for Oracle Data Guard on EC2 instance [{{ec2\_id}}]. To resolve the issue, set the DATABASE\_ROLE parameter to either PRIMARY or PHYSICAL STANDBY. | サポートペリメーターは、 15 秒ごとに現在のデータベースロールをモニタリングし、データベースロールが変更されると CloudWatch 通知を送信します。Oracle Data Guard`DATABASE_ROLE`パラメータは`PRIMARY`または`PHYSICAL STANDBY`のいずれかである必要があります。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />サポートペリメーターがデータベースロールがサポートされると判断すると、RDS Custom for Oracle DB インスタンスは 15 秒以内に利用可能になります。 | 
| SP-O3003 | データベースのヘルス | The SMON process of the Oracle database is in a zombie state. To resolve the issue, manually recover the database on EC2 instance [{{ec2\_id}}], open the database, and then immediately back it up. For more help, contact サポート. | サポートペリメーターは DB インスタンスの状態をモニタリングします。また、前の 1 時間と前日に、何回再起動が発生したかをモニタリングします。インスタンスがまだ存在する状態にあるときに通知されますが、インスタンスと対話することはできません。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)<br />DB インスタンスの再起動後、RDS Custom エージェントは DB インスタンスが無応答の状態ではなくなったことを検出します。次に、DB インスタンスの状態を再評価するようサポートペリメーターに通知します。 | 
| SP-O3004 | データベースログモード | The database log mode on EC2 instance [{{ec2\_id}}] was changed to [{{value\_b}}]. To resolve the issue, set the log mode to [{{value\_a}}].   | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)RDS Custom エージェントは DB インスタンスを再起動し、ログモードを `ARCHIVELOG` に設定します。DB インスタンスは 30 分以内に利用可能になります。 | 
| SP-O3005 | Oracle ホームパス | The Oracle home on EC2 instance [{{ec2\_id}}] was changed to {{new\_path}}. To resolve the issue, revert the setting to {{old\_path}}. |  | 
| SP-O3006 | データベースの一意の名前 | The database unique name on EC2 instance [{{ec2\_id}}] was changed to {{new\_value}}. To resolve the issue, revert the name to {{old\_value}}.   | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-troubleshooting.html)RDS Custom エージェントは DB インスタンスを再起動し、ログモードを `ARCHIVELOG` に設定します。DB インスタンスは 30 分以内に利用可能になります。 | 

## RDS Custom for Oracle のアップグレードに関するトラブルシューティング
<a name="custom-troubleshooting-upgrade"></a>

RDS Custom for Oracle インスタンスのアップグレードに失敗する場合があります。以下では、RDS Custom DB for Oracle DB インスタンスのアップグレード時に使用できるテクニックを紹介します。
+ DB インスタンスの `/tmp` ディレクトリにあるアップグレード出力ログファイルを確認します。ログの名前は、DB エンジンのバージョンによって異なります。例えば、`catupgrd` または `catup` という文字列を含むログが表示される場合があります。
+ `/rdsdbdata/log/trace` ディレクトリにある `alert.log` ファイルを確認します。
+ `grep` ディレクトリで以下の `root` コマンドを実行し、アップグレード OS のプロセスを追跡します。このコマンドは、ログファイルが書き込まれる場所を示し、アップグレードプロセスの状態を判断します。

  ```
  ps -aux | grep upg
  ```

  出力例を次に示します。

  ```
  root     18884  0.0  0.0 235428  8172 ?        S<   17:03   0:00 /usr/bin/sudo -u rdsdb /rdsdbbin/scripts/oracle-control ORCL op_apply_upgrade_sh RDS-UPGRADE/2.upgrade.sh
  rdsdb    18886  0.0  0.0 153968 12164 ?        S<   17:03   0:00 /usr/bin/perl -T -w /rdsdbbin/scripts/oracle-control ORCL op_apply_upgrade_sh RDS-UPGRADE/2.upgrade.sh
  rdsdb    18887  0.0  0.0 113196  3032 ?        S<   17:03   0:00 /bin/sh /rdsdbbin/oracle/rdbms/admin/RDS-UPGRADE/2.upgrade.sh
  rdsdb    18900  0.0  0.0 113196  1812 ?        S<   17:03   0:00 /bin/sh /rdsdbbin/oracle/rdbms/admin/RDS-UPGRADE/2.upgrade.sh
  rdsdb    18901  0.1  0.0 167652 20620 ?        S<   17:03   0:07 /rdsdbbin/oracle/perl/bin/perl catctl.pl -n 4 -d /rdsdbbin/oracle/rdbms/admin -l /tmp catupgrd.sql
  root     29944  0.0  0.0 112724  2316 pts/0    S+   18:43   0:00 grep --color=auto upg
  ```
+ 以下の SQL クエリを実行してコンポーネントの現在の状態を確認し、DB インスタンスにインストールされているデータベースのバージョンとオプションを見つけます。

  ```
  SET LINESIZE 180
  COLUMN COMP_ID FORMAT A15
  COLUMN COMP_NAME FORMAT A40 TRUNC
  COLUMN STATUS FORMAT A15 TRUNC
  SELECT COMP_ID, COMP_NAME, VERSION, STATUS FROM DBA_REGISTRY ORDER BY 1;
  ```

  出力は以下のようになります。

  ```
  COMP_NAME                                STATUS               PROCEDURE
  ---------------------------------------- -------------------- --------------------------------------------------
  Oracle Database Catalog Views            VALID                DBMS_REGISTRY_SYS.VALIDATE_CATALOG
  Oracle Database Packages and Types       VALID                DBMS_REGISTRY_SYS.VALIDATE_CATPROC
  Oracle Text                              VALID                VALIDATE_CONTEXT
  Oracle XML Database                      VALID                DBMS_REGXDB.VALIDATEXDB
  
  4 rows selected.
  ```
+ 以下の SQL クエリを実行して、アップグレードプロセスに干渉する可能性のある無効なオブジェクトがないかチェックします。

  ```
  SET PAGES 1000 LINES 2000
  COL OBJECT FOR A40
  SELECT SUBSTR(OWNER,1,12) OWNER,
         SUBSTR(OBJECT_NAME,1,30) OBJECT,
         SUBSTR(OBJECT_TYPE,1,30) TYPE, STATUS,
         CREATED
  FROM   DBA_OBJECTS 
  WHERE  STATUS <>'VALID' 
  AND    OWNER IN ('SYS','SYSTEM','RDSADMIN','XDB');
  ```

## RDS Custom for Oracle のレプリカプロモーションのトラブルシューティング
<a name="custom-troubleshooting-promote"></a>

コンソール、`promote-read-replica` AWS CLI コマンド、または `PromoteReadReplica` API を使用して、RDS Custom for Oracle のマネージド Oracle レプリカを昇格させることができます。プライマリ DB インスタンスを削除し、すべてのレプリカが正常であれば、RDS Custom for Oracle はマネージドレプリカをスタンドアロンインスタンスに自動的に昇格させます。レプリカが自動化を一時停止しているか、サポートペリメーター外にある場合は、RDS Custom が自動的にレプリカを昇格させる前にレプリカを修正する必要があります。詳細については、「[RDS Custom for Oracle レプリカをスタンドアロン DB インスタンスに昇格させる](custom-rr.promoting.md)」を参照してください。

以下の状況では、レプリカのプロモーションワークフローが停止することがあります。
+ プライマリ DB インスタンスは、`STORAGE_FULL` 状態です。
+ プライマリデータベースは、すべてのオンライン REDO ログをアーカイブできるわけではありません。
+ Oracle レプリカとプライマリデータベースのアーカイブ REDO ログファイルの間にギャップが存在します。

**停止したワークフローに対応するには**

1. Oracle レプリカ DB インスタンスの REDO ログギャップを同期します。

1. 適用された最新の REDO ログにリードレプリカを強制的に昇格させます。SQL\*Plus の次のコマンドを実行します。

   ```
   ALTER DATABASE ACTIVATE STANDBY DATABASE;
   SHUTDOWN IMMEDIATE
   STARTUP
   ```

1. サポートに連絡し、DB インスタンスを `available` ステータスに移行してもらいます。