

# Preparar-se para criar uma CEV
<a name="custom-cev.preparing"></a>

Para criar uma CEV, acesse os arquivos de instalação e os patches armazenados no bucket do Amazon S3 para qualquer uma das seguintes versões:
+ Oracle Database 19c
+ Oracle Database 18c
+ Oracle Database 12c Versão 2 (12.2)
+ Oracle Database 12c Versão 1 (12.1)

Por exemplo, é possível utilizar a RU/RUR de abril de 2021 para o Oracle Database 19c, ou qualquer combinação válida de arquivos de instalação e patches. Para ter mais informações sobre as regiões e as versões compatíveis com o RDS Custom para Oracle, consulte [RDS Custom with RDS for Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RDS_Fea_Regions_DB-eng.Feature.RDSCustom.html#Concepts.RDS_Fea_Regions_DB-eng.Feature.RDSCustom.ora) (RDS Custom com RDS para Oracle).

**Topics**
+ [Etapa 1 (opcional): Baixar os modelos de manifesto](#custom-cev.preparing.templates)
+ [Etapa 2: Baixar arquivos de instalação do banco de dados e patches do Oracle Software Delivery Cloud](#custom-cev.preparing.download)
+ [Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3](#custom-cev.preparing.s3)
+ [Etapa 4 (opcional): Compartilhar a mídia de instalação no S3 entreContas da AWS](#custom-cev.preparing.accounts)
+ [Etapa 5: Preparar o manifesto CEV](#custom-cev.preparing.manifest)
+ [Etapa 6 (opcional): Validar o manifesto CEV](#custom-cev.preparing.validating)
+ [Etapa 7: Adicionar permissões do IAM necessárias](#custom-cev.preparing.iam)

## Etapa 1 (opcional): Baixar os modelos de manifesto
<a name="custom-cev.preparing.templates"></a>

Um *manifesto CEV* é um documento JSON que inclui a lista de arquivos .zip de instalação do banco de dados para sua CEV. Para criar uma CEV, faça o seguinte:

1. Identifique os arquivos de instalação do banco de dados Oracle que você deseja incluir em sua CEV.

1. Baixe os arquivos de instalação.

1. Crie um manifesto JSON que liste os arquivos de instalação.

O RDS Custom para Oracle fornece modelos de manifesto JSON com nossos arquivos .zip recomendados para cada versão compatível do Oracle Database. Por exemplo, o modelo a seguir é para a RU 19.17.0.0.0.

```
{
    "mediaImportTemplateVersion": "2020-08-14",
    "databaseInstallationFileNames": [
        "V982063-01.zip"
    ],
    "opatchFileNames": [
        "p6880880_190000_Linux-x86-64.zip"
    ],
    "psuRuPatchFileNames": [
        "p34419443_190000_Linux-x86-64.zip",
        "p34411846_190000_Linux-x86-64.zip"
    ],
    "otherPatchFileNames": [
        "p28852325_190000_Linux-x86-64.zip",
        "p29997937_190000_Linux-x86-64.zip",
        "p31335037_190000_Linux-x86-64.zip",
        "p32327201_190000_Linux-x86-64.zip",
        "p33613829_190000_Linux-x86-64.zip",
        "p34006614_190000_Linux-x86-64.zip",
        "p34533061_190000_Linux-x86-64.zip",
        "p34533150_190000_Generic.zip",
        "p28730253_190000_Linux-x86-64.zip",
        "p29213893_1917000DBRU_Generic.zip",
        "p33125873_1917000DBRU_Linux-x86-64.zip",
        "p34446152_1917000DBRU_Linux-x86-64.zip"
    ]
}
```

Cada modelo tem um arquivo leiame associado que inclui instruções para baixar os patches, os URLs para os arquivos .zip e somas de verificação de arquivos. Você pode usar esses modelos como estão ou modificá-los com seus próprios patches. Para revisar os modelos, baixe o [custom-oracle-manifest.zip](samples/custom-oracle-manifest.zip) em seu disco local e abra-o com uma aplicação de arquivamento de arquivos. Para ter mais informações, consulte [Etapa 5: Preparar o manifesto CEV](#custom-cev.preparing.manifest).

## Etapa 2: Baixar arquivos de instalação do banco de dados e patches do Oracle Software Delivery Cloud
<a name="custom-cev.preparing.download"></a>

Depois de identificar os arquivos de instalação que deseja para sua CEV, baixe-os para o sistema local. Os patches e arquivos de instalação do Oracle Database estão hospedados na Oracle Software Delivery Cloud. Cada CEV exige uma versão de base, como o Oracle Database 19c ou o Oracle Database 12c Versão 2 (12.2) e uma lista opcional de patches.

**Como baixar os arquivos de instalação do banco de dados para o Oracle Database**

1. Acesse [https://edelivery.oracle.com/](https://edelivery.oracle.com/) e faça login.

1. Na caixa, insira **Oracle Database Enterprise Edition** ou **Oracle Database Standard Edition 2** e selecione **Pesquisar**.

1. Selecione uma das seguintes versões de base:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)

1. Escolha **Continuar**.

1. Limpe a caixa de diálogo **Download Queue** (Baixar fila).

1. Selecione a opção que corresponde à sua versão de base:
   + **Oracle Database 19.3.0.0.0: Long Term Release**.
   + **Oracle Database 18.0.0.0.0**
   + **Oracle Database 12.2.0.1.0**.
   + **Oracle Database 12.1.0.2.0**.

1. Escolha **Linux x86-64** em **Platform/Languages** (Plataforma/Idiomas).

1. Selecione **Continuar** e, depois, assine o Contrato de Licença da Oracle.

1. Selecione o arquivo .zip que corresponde à sua versão de base:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)

1. Baixe os patches Oracle desejados de `updates.oracle.com` ou `support.oracle.com` para seu sistema local. Você pode encontrar os URLs dos patches nos seguintes locais:
   + Os arquivos leiame no arquivo .zip que você baixou em [Etapa 1 (opcional): Baixar os modelos de manifesto](#custom-cev.preparing.templates)
   + Os patches listados em cada atualização de versão (RU) em [Notas de versão do Amazon Relational Database Service (Amazon RDS) para Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes)

## Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3
<a name="custom-cev.preparing.s3"></a>

Carregue seus arquivos de patch e instalação do Oracle no Amazon S3 utilizando a AWS CLI. O bucket do S3 que contém seus arquivos de instalação deve estar na mesma região da AWS que a CEV.

Os exemplos nesta seção usam os seguintes espaços reservados:
+ `install-or-patch-file.zip` – Arquivo de mídia de instalação do Oracle. Por exemplo, p32126828\$1190000\$1Linux-x86-64.zip é um patch.
+ `amzn-s3-demo-destination-bucket` – Seu bucket do Amazon S3 designado aos seus arquivos de instalação carregados.
+ `123456789012/cev1`: um prefixo opcional no bucket do Amazon S3.
+ `amzn-s3-demo-source-bucket`: um bucket do Amazon S3 no qual há a opção de preparar arquivos.

**Topics**
+ [Etapa 3a: Verifique se o bucket do S3 está no local correto Região da AWS](#custom-cev.preparing.s3.verify-region)
+ [Etapa 3b: Certifique-se de que sua política de bucket do S3 tenha as permissões corretas](#custom-cev.preparing.s3.verify-policy)
+ [Etapa 3c: Carregue seus arquivos usando os comandos cp ou sync](#custom-cev.preparing.s3.upload)
+ [Etapa 3: Listar os arquivos no bucket do S3](#custom-cev.preparing.s3.list)

### Etapa 3a: Verifique se o bucket do S3 está no local correto Região da AWS
<a name="custom-cev.preparing.s3.verify-region"></a>

Verifique se o bucket do S3 está na região do AWS na qual você planeja executar o comando `create-custom-db-engine-version`.

```
aws s3api get-bucket-location --bucket amzn-s3-demo-destination-bucket
```

### Etapa 3b: Certifique-se de que sua política de bucket do S3 tenha as permissões corretas
<a name="custom-cev.preparing.s3.verify-policy"></a>

É possível criar uma CEV do zero ou a partir de uma CEV de origem. Se você planeja criar um novo CEV a partir dos CEVs de origem, certifique-se de que sua política de bucket do S3 tenha as permissões corretas:

1. Identificar o bucket do S3, reservado pelo RDS Custom. O nome do bucket tem o formato`do-not-delete-rds-custom-account-region-string`. Por exemplo, ele pode ser `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE`.

1. Certifique-se de que a permissão a seguir esteja anexada à sua política de bucket do S3. Substitua `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE` pelo nome do seu bucket.

   ```
   {
       "Sid": "AWSRDSCustomForOracleCustomEngineVersionGetObject",
       "Effect": "Allow",
       "Principal": {
           "Service": "custom.rds.amazonaws.com"
       },
       "Action": [
           "s3:GetObject",
           "s3:GetObjectTagging"
       ],
       "Resource": "arn:aws:s3:::do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE/CustomEngineVersions/*"
   }, ...
   ```

### Etapa 3c: Carregue seus arquivos usando os comandos cp ou sync
<a name="custom-cev.preparing.s3.upload"></a>

Escolha uma das seguintes opções:
+ Use `aws s3 cp` para carregar um único arquivo .zip.

  Carregue cada arquivo .zip de instalação separadamente. Não combine os arquivos .zip em um único arquivo .zip.
+ Use `aws s3 sync` para carregar um diretório.

**Example**  
O exemplo a seguir carrega `install-or-patch-file.zip` na pasta `123456789012/cev1` do bucket do Amazon S3 do RDS Custom. Execute um comando `aws s3` separado para cada .zip que você deseja carregar.  
Para Linux, macOS ou Unix:  

```
1. aws s3 cp install-or-patch-file.zip \
2.     s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Para Windows:  

```
1. aws s3 cp install-or-patch-file.zip ^
2.     s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```

**Example**  
O exemplo a seguir carrega os arquivos da pasta *cev1* local na pasta *123456789012/cev1* do seu bucket do Amazon S3.  
Para Linux, macOS ou Unix:  

```
aws s3 sync cev1 \
    s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Para Windows:  

```
aws s3 sync cev1 ^
    s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```

**Example**  
O exemplo a seguir faz upload de todos os arquivos em `amzn-s3-demo-source-bucket` na pasta **`123456789012/cev1`** em seu bucket do Amazon S3.  
Para Linux, macOS ou Unix:  

```
aws s3 sync s3://amzn-s3-demo-source-bucket/ \
    s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Para Windows:  

```
aws s3 sync s3://amzn-s3-demo-source-bucket/ ^
    s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```

### Etapa 3: Listar os arquivos no bucket do S3
<a name="custom-cev.preparing.s3.list"></a>

O exemplo a seguir usa o `s3 ls` comando para listar os arquivos no bucket do Amazon S3 do RDS Custom.

```
aws s3 ls \
    s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```

## Etapa 4 (opcional): Compartilhar a mídia de instalação no S3 entreContas da AWS
<a name="custom-cev.preparing.accounts"></a>

Para os fins desta seção, o bucket do Amazon S3 que contém os arquivos de instalação do Oracle enviados é seu *bucket de mídia*. Sua organização pode usar várias Contas da AWS em uma Região da AWS. Se sim, você pode optar por usar uma Conta da AWS para preencher o bucket de mídia e outra Conta da AWS para criar CEVs. Se você não pretende compartilhar o bucket de mídia, vá para a próxima seção.

Esta seção supõe o seguinte: 
+ Você tem acesso à conta que criou o bucket de mídia e a uma conta diferente na qual pretende criar CEVs.
+ Você pretende criar CEVs em uma única Região da AWS. Se você pretende usar várias regiões, crie um bucket de mídia em cada região.
+ Você está usando a CLI. Se estiver usando o console do Amazon S3, adapte as etapas a seguir.

**Como configurar o bucket de mídia para compartilhamento entre Contas da AWS**

1. Faça login na Conta da AWS que contém o bucket do S3 no qual você fez upload da mídia de instalação.

1. Comece com um modelo de política JSON em branco ou com uma política existente que você possa adaptar.

   O comando a seguir recupera uma política existente e a salva como *my-policy.json*. Neste exemplo, o bucket do S3 que contém os arquivos de instalação é chamado de *amzn-s3-demo-bucket*.

   ```
   aws s3api get-bucket-policy \ 
       --bucket amzn-s3-demo-bucket \
       --query Policy \
       --output text > my-policy.json
   ```

1. Edite as permissões do bucket de mídia da seguinte forma:
   + No elemento `Resource` do modelo, especifique o bucket do S3 no qual você fez upload dos arquivos de instalação do Oracle Database.
   + No elemento `Principal`, especifique os ARNs de todas as Contas da AWS que você pretende usar para criar CEVs. Você pode adicionar a raiz, um usuário ou um perfil à lista de permissões do bucket do S3. Para ter mais informações, consulte [Identificadores do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html) no *Manual do usuário do AWS Identity and Access Management*.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "GrantAccountsAccess",
               "Effect": "Allow",
               "Principal": {
                   "AWS": [
                       "arn:aws:iam::111122223333:root",
                       "arn:aws:iam::444455556666:user/user-name-with-path",
                       "arn:aws:iam::123456789012:role/role-name-with-path"
                   ]
               },
               "Action": [
                   "s3:GetObject",
                   "s3:GetObjectAcl",
                   "s3:GetObjectTagging",
                   "s3:ListBucket",
                   "s3:GetBucketLocation"
               ],
               "Resource": [
                   "arn:aws:s3:::amzn-s3-demo-bucket",
                   "arn:aws:s3:::amzn-s3-demo-bucket/*"
               ]
           }
       ]
   }
   ```

------

1. Associe a política ao bucket de mídia.

   No exemplo a seguir, *amzn-s3-demo-bucket* é o nome do bucket do S3 que contém os arquivos de instalação e *my-policy.json* é o nome do arquivo JSON.

   ```
   aws s3api put-bucket-policy \
       --bucket amzn-s3-demo-bucket \
       --policy file://my-policy.json
   ```

1. Faça login em uma Conta da AWS na qual pretende criar CEVs.

1. Verifique se essa conta pode acessar o bucket de mídia na Conta da AWS que o criou.

   ```
   aws s3 ls --query "Buckets[].Name"
   ```

   Para ter mais informações, consulte [aws s3 ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) na *Referência de comandos da AWS CLI*.

1. Crie uma CEV seguindo as etapas em [Criar um CEV](custom-cev.create.md).

## Etapa 5: Preparar o manifesto CEV
<a name="custom-cev.preparing.manifest"></a>

Um manifesto de CEV é um documento JSON que inclui o seguinte conteúdo:
+ (Obrigatório) A lista de arquivos .zip carregados no Amazon S3. O RDS Custom aplica os patches na ordem em que eles estão listados no manifesto.
+ (Opcional) Parâmetros de instalação que definem valores não padrão para a base do Oracle, o Oracle home e o ID e o nome do usuário e grupo do UNIX/Linux. Lembre-se de que você não pode modificar os parâmetros de instalação de uma CEV existente ou de uma instância de banco de dados existente. Você também não pode realizar a atualização uma para outra CEV quando os parâmetros de instalação têm configurações diferentes.

Para obter exemplos de manifestos CEV, consulte os modelos JSON que você baixou em [Etapa 1 (opcional): Baixar os modelos de manifesto](#custom-cev.preparing.templates). Também é possível revisar os exemplos em [Exemplos de manifesto de CEV](#custom-cev.preparing.manifest.examples).

**Topics**
+ [Campos JSON no manifesto de CEV](#custom-cev.preparing.manifest.fields)
+ [Criar o manifesto de CEV](#custom-cev.preparing.manifest.creating)
+ [Exemplos de manifesto de CEV](#custom-cev.preparing.manifest.examples)

### Campos JSON no manifesto de CEV
<a name="custom-cev.preparing.manifest.fields"></a>

A tabela a seguir descreve os campos JSON no manifesto.


| Campo JSON | Descrição | 
| --- | --- | 
|  `MediaImportTemplateVersion`  |  Versão do manifesto de CEV. A data deve estar no formato `YYYY-MM-DD`.  | 
|  `databaseInstallationFileNames`  |  Lista ordenada de arquivos de instalação do banco de dados.  | 
|  `opatchFileNames`  |  Lista ordenada de instaladores OPatch utilizados para o mecanismo de banco de dados Oracle. Apenas um valor é válido. Valores para `opatchFileNames` devem começar com `p6880880_`.  | 
|  `psuRuPatchFileNames`  |  Os patches PSU e RU desse banco de dados.  Se você incluir `psuRuPatchFileNames`, `opatchFileNames` será obrigatório. Valores para `opatchFileNames` devem começar com `p6880880_`.   | 
|  `OtherPatchFileNames`  |  Os patches que não estão na lista de patches PSU e RU. O RDS Custom aplicará esses patches após a aplicação dos patches PSU e RU.  Se você incluir `OtherPatchFileNames`, `opatchFileNames` será obrigatório. Valores para `opatchFileNames` devem começar com `p6880880_`.    | 
|  `installationParameters`  |  Configurações não padrão para a base do Oracle, o Oracle Home e o ID e o nome do usuário e do grupo do UNIX/Linux. É possível definir os seguintes parâmetros: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)  | 

Cada versão do Oracle Database tem uma lista diferente de arquivos de instalação compatíveis. Ao criar seu manifesto de CEV, especifique somente os arquivos que são compatíveis com o RDS Custom para Oracle. Caso contrário, a criação da CEV falhará com um erro. Todos os patches listados em [Notas de versão do Amazon Relational Database Service (Amazon RDS) para Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes) são compatíveis.

### Criar o manifesto de CEV
<a name="custom-cev.preparing.manifest.creating"></a>

**Como criar um manifesto de CEV**

1. Liste todos os arquivos de instalação que você planeja aplicar, na ordem em que deseja aplicá-los.

1. Correlacione os arquivos de instalação com os campos JSON descritos em [Campos JSON no manifesto de CEV](#custom-cev.preparing.manifest.fields).

1. Realize um dos procedimentos a seguir:
   + Crie o manifesto de CEV como um arquivo de texto JSON.
   + Edite o modelo de manifesto de CEV ao criar a CEV no console. Para ter mais informações, consulte [Criar um CEV](custom-cev.create.md).

### Exemplos de manifesto de CEV
<a name="custom-cev.preparing.manifest.examples"></a>

Os exemplos a seguir mostram arquivos de manifesto de CEV para diferentes versões do Oracle Database. Se você incluir um campo JSON no manifesto, nunca deixe-o vazio. Por exemplo, o manifesto de CEV a seguir é inválido porque `otherPatchFileNames` está vazio.

```
{
    "mediaImportTemplateVersion": "2020-08-14",
    "databaseInstallationFileNames": [
        "V982063-01.zip"
    ],
    "opatchFileNames": [
        "p6880880_190000_Linux-x86-64.zip"
    ],
    "psuRuPatchFileNames": [
        "p32126828_190000_Linux-x86-64.zip"
    ],
    "otherPatchFileNames": [
    ]
}
```

**Tópicos**
+ [Sample CEV manifest for Oracle Database 12c Release 1 (12.1)](#oracle-cev-manifest-12.1)
+ [Sample CEV manifest for Oracle Database 12c Release 2 (12.2)](#oracle-cev-manifest-12.2)
+ [Sample CEV manifest for Oracle Database 18c](#oracle-cev-manifest-18c)
+ [Sample CEV manifest for Oracle Database 19c](#oracle-cev-manifest-19c)

**Example Exemplo de manifesto de CEV para Oracle Database 12c versão 1 (12.1)**  
No exemplo a seguir para a PSU de julho de 2021 do Oracle Database 12c versão 1 (12.1), o RDS Custom aplica os patches na sequência especificada. Assim, o RDS Custom aplica p32768233, depois p32876425, depois p18759211 e assim por diante. O exemplo define novos valores para o usuário e o grupo do UNIX, o Oracle home e a base do Oracle.  

```
{
    "mediaImportTemplateVersion":"2020-08-14",
    "databaseInstallationFileNames":[
        "V46095-01_1of2.zip",
        "V46095-01_2of2.zip"
    ],
    "opatchFileNames":[
        "p6880880_121010_Linux-x86-64.zip"
    ],
    "psuRuPatchFileNames":[
        "p32768233_121020_Linux-x86-64.zip"
    ],
    "otherPatchFileNames":[
        "p32876425_121020_Linux-x86-64.zip",
        "p18759211_121020_Linux-x86-64.zip",
        "p19396455_121020_Linux-x86-64.zip",
        "p20875898_121020_Linux-x86-64.zip",
        "p22037014_121020_Linux-x86-64.zip",
        "p22873635_121020_Linux-x86-64.zip",
        "p23614158_121020_Linux-x86-64.zip",
        "p24701840_121020_Linux-x86-64.zip",
        "p25881255_121020_Linux-x86-64.zip",
        "p27015449_121020_Linux-x86-64.zip",
        "p28125601_121020_Linux-x86-64.zip",
        "p28852325_121020_Linux-x86-64.zip",
        "p29997937_121020_Linux-x86-64.zip",
        "p31335037_121020_Linux-x86-64.zip",
        "p32327201_121020_Linux-x86-64.zip",
        "p32327208_121020_Generic.zip",
        "p17969866_12102210119_Linux-x86-64.zip",
        "p20394750_12102210119_Linux-x86-64.zip",
        "p24835919_121020_Linux-x86-64.zip",
        "p23262847_12102201020_Linux-x86-64.zip",
        "p21171382_12102201020_Generic.zip",
        "p21091901_12102210720_Linux-x86-64.zip",
        "p33013352_12102210720_Linux-x86-64.zip",
        "p25031502_12102210720_Linux-x86-64.zip",
        "p23711335_12102191015_Generic.zip",
        "p19504946_121020_Linux-x86-64.zip"
    ],
    "installationParameters": {
        "unixGroupName": "dba",
        "unixGroupId": 12345,
        "unixUname": "oracle",
        "unixUid": 12345,
        "oracleHome": "/home/oracle/oracle.12.1.0.2",
        "oracleBase": "/home/oracle"
    }
}
```

**Example Exemplo de manifesto de CEV para Oracle Database 12c versão 2 (12.2)**  
No exemplo a seguir para a PSU de outubro de 2021 do Oracle Database 12c versão 2 (12.2), o RDS Custom aplica p33261817, depois p33192662, depois p29213893 e assim por diante. O exemplo define novos valores para o usuário e o grupo do UNIX, o Oracle home e a base do Oracle.  

```
{
    "mediaImportTemplateVersion":"2020-08-14",
    "databaseInstallationFileNames":[
        "V839960-01.zip"
    ],
    "opatchFileNames":[
        "p6880880_122010_Linux-x86-64.zip"
    ],
    "psuRuPatchFileNames":[
        "p33261817_122010_Linux-x86-64.zip"
    ],
    "otherPatchFileNames":[
        "p33192662_122010_Linux-x86-64.zip",
        "p29213893_122010_Generic.zip",
        "p28730253_122010_Linux-x86-64.zip",
        "p26352615_12201211019DBOCT2021RU_Linux-x86-64.zip",
        "p23614158_122010_Linux-x86-64.zip",
        "p24701840_122010_Linux-x86-64.zip",
        "p25173124_122010_Linux-x86-64.zip",
        "p25881255_122010_Linux-x86-64.zip",
        "p27015449_122010_Linux-x86-64.zip",
        "p28125601_122010_Linux-x86-64.zip",
        "p28852325_122010_Linux-x86-64.zip",
        "p29997937_122010_Linux-x86-64.zip",
        "p31335037_122010_Linux-x86-64.zip",
        "p32327201_122010_Linux-x86-64.zip",
        "p32327208_122010_Generic.zip"
    ],
    "installationParameters": {
        "unixGroupName": "dba",
        "unixGroupId": 12345,
        "unixUname": "oracle",
        "unixUid": 12345,
        "oracleHome": "/home/oracle/oracle.12.2.0.1",
        "oracleBase": "/home/oracle"
    }
}
```

**Example Exemplo de manifesto de CEV para Oracle Database 18c**  
No exemplo a seguir para a PSU de outubro de 2021 do Oracle Database 18c, o RDS Custom aplica p32126855, depois p28730253, depois p27539475 e assim por diante. O exemplo define novos valores para o usuário e o grupo do UNIX, o Oracle home e a base do Oracle.  

```
{
    "mediaImportTemplateVersion":"2020-08-14",
    "databaseInstallationFileNames":[
        "V978967-01.zip"
    ],
    "opatchFileNames":[
        "p6880880_180000_Linux-x86-64.zip"
    ],
    "psuRuPatchFileNames":[
        "p32126855_180000_Linux-x86-64.zip"
    ],
    "otherPatchFileNames":[
        "p28730253_180000_Linux-x86-64.zip",
        "p27539475_1813000DBRU_Linux-x86-64.zip",
        "p29213893_180000_Generic.zip",
        "p29374604_1813000DBRU_Linux-x86-64.zip",
        "p29782284_180000_Generic.zip",
        "p28125601_180000_Linux-x86-64.zip",
        "p28852325_180000_Linux-x86-64.zip",
        "p29997937_180000_Linux-x86-64.zip",
        "p31335037_180000_Linux-x86-64.zip",
        "p31335142_180000_Generic.zip"
    ]
    "installationParameters": {
        "unixGroupName": "dba",
        "unixGroupId": 12345,
        "unixUname": "oracle",
        "unixUid": 12345,
        "oracleHome": "/home/oracle/18.0.0.0.ru-2020-10.rur-2020-10.r1",
        "oracleBase": "/home/oracle/"
    }
}
```

**Example Exemplo de manifesto de CEV para Oracle Database 19c**  
No exemplo a seguir do Oracle Database 19c, o RDS Custom aplica p32126828, depois p29213893 e depois p29782284 e assim por diante. O exemplo define novos valores para o usuário e o grupo do UNIX, o Oracle home e a base do Oracle.  

```
{
    "mediaImportTemplateVersion": "2020-08-14",
    "databaseInstallationFileNames": [
        "V982063-01.zip"
    ],
    "opatchFileNames": [
        "p6880880_190000_Linux-x86-64.zip"
    ],
    "psuRuPatchFileNames": [
        "p32126828_190000_Linux-x86-64.zip"
    ],
    "otherPatchFileNames": [
        "p29213893_1910000DBRU_Generic.zip",
        "p29782284_1910000DBRU_Generic.zip",
        "p28730253_190000_Linux-x86-64.zip",
        "p29374604_1910000DBRU_Linux-x86-64.zip",
        "p28852325_190000_Linux-x86-64.zip",
        "p29997937_190000_Linux-x86-64.zip",
        "p31335037_190000_Linux-x86-64.zip",
        "p31335142_190000_Generic.zip"
    ],
    "installationParameters": {
        "unixGroupName": "dba",
        "unixGroupId": 12345,
        "unixUname": "oracle",
        "unixUid": 12345,
        "oracleHome": "/home/oracle/oracle.19.0.0.0.ru-2020-04.rur-2020-04.r1.EE.1",
        "oracleBase": "/home/oracle"
    }
}
```

## Etapa 6 (opcional): Validar o manifesto CEV
<a name="custom-cev.preparing.validating"></a>

Opcionalmente, verifique se o manifesto é um arquivo JSON válido executando o script Python `json.tool`. Por exemplo, se você mudar para o diretório que contém um manifesto CEV chamado `manifest.json`, execute o comando a seguir.

```
python -m json.tool < manifest.json
```

## Etapa 7: Adicionar permissões do IAM necessárias
<a name="custom-cev.preparing.iam"></a>

Certifique-se de que o elemento principal do IAM que cria o CEV tenha as políticas necessárias descritas em [Etapa 5: Conceder as permissões necessárias ao usuário ou ao perfil do IAM](custom-setup-orcl.md#custom-setup-orcl.iam-user).