# Configurar o Oracle APEX e o Oracle Rest Data Services (ORDS)
O tópico a seguir lista as etapas necessárias para configurar o Oracle APEX e o ORDS.
**Topics**
+ [
## Adicionar as opções APEX e APEX-DEV à sua instância de banco de dados
](#Appendix.Oracle.Options.APEX.Add)
+ [
## Desbloquear a conta de usuário público em sua instância de banco de dados
](#Appendix.Oracle.Options.APEX.PublicUser)
+ [
## Configuração de serviços RESTful para o Oracle APEX
](#Appendix.Oracle.Options.APEX.ConfigureRESTful)
+ [
## Preparar-se para instalar o ORDS em um host separado
](#Appendix.Oracle.Options.APEX.ORDS.ords-setup)
+ [
## Configurar o Oracle APEX Listener
](#Appendix.Oracle.Options.APEX.Listener)
## Adicionar as opções APEX e APEX-DEV à sua instância de banco de dados
Para adicionar as opções `APEX` e `APEX-DEV` à instância de banco de dados do RDS para Oracle, faça o seguinte:
1. Crie um novo grupo de opções, ou copie ou modifique um existente.
1. Adicione as opções `APEX` e `APEX-DEV` ao grupo de opções.
1. Associe o grupo de opções à instância de banco de dados.
Quando você adiciona as opções `APEX` e `APEX-DEV`, ocorre uma breve interrupção enquanto a instância de banco de dados é reiniciada automaticamente.
**nota**
`APEX_MAIL` está disponível quando a opção `APEX` está instalada. O privilégio de execução referente ao pacote `APEX_MAIL` é concedido a `PUBLIC`. Portanto, você não precisa da conta administrativa do APEX para usá-lo.
**Como adicionar as opções APEX e APEX-DEV à instância de banco de dados**
1. Determine o grupo de opções que você deseja usar. Você pode criar um novo grupo de opções ou usar um existente. Se você quiser usar um grupo de opções existente, vá para a próxima etapa. Caso contrário, crie um grupo de opções de banco de dados personalizado com as seguintes configurações:
1. Para **Engine (Mecanismo)**, escolha a edição do Oracle que deseja usar. As opções `APEX` e `APEX-DEV` podem usadas em todas as edições.
1. Para **Major engine version (Versão do mecanismo principal)**, escolha a versão da sua instância de banco de dados.
Para ter mais informações, consulte [Criar um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create).
1. Adicione opções ao grupo de opções. Se você quiser implantar somente o ambiente de tempo de execução do Oracle APEX, adicione apenas a opção `APEX`. Para implantar o ambiente de desenvolvimento completo, adicione as opções `APEX` e `APEX-DEV`.
Em **Versão**, escolha a versão do Oracle APEX que você deseja usar.
**Importante**
Se você adicionar as opções `APEX` e `APEX-DEV` a um grupo de opções existente que já esteja anexado a uma ou mais instâncias de banco de dados, ocorrerá uma breve interrupção. Durante essa interrupção, todas as instâncias de banco de dados são automaticamente reiniciadas.
Para mais informações sobre a adição de opções, consulte [Adicionar uma opção a um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).
1. Aplique o grupo de opções a uma instância de banco de dados nova ou existente:
+ Para uma nova instância de banco de dados, você aplica o grupo de opções ao executar a instância. Para ter mais informações, consulte [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md).
+ Para uma instância de banco de dados existente, você aplica o grupo de opções modificando a instância e anexando o novo grupo de opções. Quando você adiciona as opções `APEX` e `APEX-DEV` a uma instância de banco de dados existente, ocorre uma breve interrupção enquanto a instância de banco de dados é reiniciada automaticamente. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
## Desbloquear a conta de usuário público em sua instância de banco de dados
Depois que as opções `APEX` e `APEX-DEV` da instância de banco de dados forem instaladas, faça o seguinte:
1. Altere a senha para a conta `APEX_PUBLIC_USER`.
1. Desbloqueie a conta.
Você pode fazer isso usando o utilitário de linha de comando Oracle SQL\$1Plus. Conecte-se à sua instância de banco de dados como usuário principal e emita os comandos a seguir. Substitua `new_password` por uma senha da sua escolha.
```
1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
```
## Configuração de serviços RESTful para o Oracle APEX
Para configurar serviços RESTful no Oracle APEX (não necessário para o Oracle APEX 4.1.1.V1), use o SQL\$1Plus para se conectar à instância de banco de dados como usuário principal. Depois que você fizer isso, execute o procedimento armazenado `rdsadmin.rdsadmin_run_apex_rest_config`. Ao executar o procedimento armazenado, você fornece senhas para os seguintes usuários:
+ `APEX_LISTENER`
+ `APEX_REST_PUBLIC_USER`
O procedimento armazenado executa o script `apex_rest_config.sql` que cria novas contas de banco de dados para esses usuários.
**nota**
A configuração não é obrigatória para o Oracle APEX versão 4.1.1.v1. Apenas para esta versão Oracle APEX, você não precisa executar o procedimento armazenado.
O comando a seguir executa o procedimento armazenado.
```
1. EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');
```
## Preparar-se para instalar o ORDS em um host separado
Instale o ORDS em um host separado, como uma instância do Amazon EC2 em um servidor on-premises na sua empresa ou no seu computador desktop. Nos exemplos desta seção, suponha que o host execute Linux e tenha o nome `myapexhost.example.com`.
Antes de instalar o ORDS, é necessário criar um usuário de SO não privilegiado e, depois, baixar e descompactar o arquivo de instalação do Oracle APEX.
**Como se preparar para a instalação do ORDS**
1. Faça login em `myapexhost.example.com` como `root`.
1. Crie um usuário de SO sem privilégios para ser o proprietário da instalação do listener. O comando a seguir cria um novo usuário chamado *apexuser*.
```
useradd -d /home/apexuser apexuser
```
O comando a seguir atribui uma senha ao novo usuário.
```
passwd apexuser;
```
1. Faça login em `myapexhost.example.com` como `apexuser` e baixe o arquivo de instalação do Oracle APEX no Oracle no diretório `/home/apexuser`:
+ [http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html)
+ [Oracle application Express prior release archives](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html)
1. Descompacte o arquivo no diretório `/home/apexuser`.
```
unzip apex_version.zip
```
Depois que você descompactar o arquivo, haverá um diretório `apex` no diretório `/home/apexuser`.
1. Enquanto você ainda está conectado no `myapexhost.example.com` como `apexuser`, baixe o arquivo do Oracle REST Data Services no diretório `/home/apexuser`: [http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html).
## Configurar o Oracle APEX Listener
**nota**
O Oracle APEX Listener está defasado.
O Amazon RDS para Oracle continua a oferecer suporte ao Oracle APEX versão 4.1.1 e ao Oracle APEX Listener versão 1.1.4. Recomendamos que você use as versões com suporte mais recentes do Oracle APEX e do ORDS.
Instale o Oracle APEX Listener em um host separado, como uma instância do Amazon EC2, um servidor local na sua empresa ou seu computador desktop. Supomos que o nome do host é `myapexhost.example.com` e o seu host está sendo executado em Linux.
### Preparar-se para instalar o Oracle APEX Listener
Antes de instalar o Oracle APEX Listener, é necessário criar um usuário de SO não privilegiado e, depois, baixar e descompactar o arquivo de instalação do Oracle APEX.
**Como se preparar para a instalação do Oracle APEX Listener**
1. Faça login em `myapexhost.example.com` como `root`.
1. Crie um usuário de SO sem privilégios para ser o proprietário da instalação do listener. O comando a seguir cria um novo usuário chamado *apexuser*.
```
useradd -d /home/apexuser apexuser
```
O comando a seguir atribui uma senha ao novo usuário.
```
passwd apexuser;
```
1. Faça login em `myapexhost.example.com` como `apexuser` e baixe o arquivo de instalação do Oracle APEX no Oracle no diretório `/home/apexuser`:
+ [http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html)
+ [Oracle application Express prior release archives](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html)
1. Descompacte o arquivo no diretório `/home/apexuser`.
```
unzip apex_.zip
```
Depois que você descompactar o arquivo, haverá um diretório `apex` no diretório `/home/apexuser`.
1. Enquanto ainda estiver conectado ao `myapexhost.example.com` como `apexuser`, baixe o arquivo do Oracle APEX Listener no diretório `/home/apexuser`.
#### Instalar e configurar o Oracle APEX Listener
Antes de usar o Oracle APEX, é necessário baixar o arquivo `apex.war`, usar o Java para instalar o Oracle APEX Listener e iniciar o Listener.
**Como instalar e configurar o Oracle APEX Listener**
1. Crie um diretório baseado no Oracle APEX Listener e abra o arquivo do listener.
Execute o seguinte código:
```
mkdir /home/apexuser/apexlistener
cd /home/apexuser/apexlistener
unzip ../apex_listener.version.zip
```
1. Execute o código a seguir.
```
java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war
```
1. Insira as seguintes informações para os prompts do programa:
+ O nome de usuário do administrador do APEX Listener. O padrão é *adminlistener*.
+ A senha para o administrador do APEX Listener.
+ O nome de usuário do gerente do APEX Listener. O padrão é *managerlistener*.
+ A senha para o administrador do APEX Listener.
O programa imprime um URL necessário para concluir a configuração, conforme mostrado a seguir:
```
INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
Database is not yet configured
```
1. Deixe o Oracle APEX Listener em execução para que você possa usar o Oracle Application Express. Quando você concluir o procedimento de configuração, poderá executar o ouvinte em segundo plano.
1. No navegador, acesse o URL fornecido pelo programa Oracle APEX Listener. A janela de administração do Oracle Application Express Listener é exibida. Insira as seguintes informações:
+ **Nome de usuário** – `APEX_PUBLIC_USER`
+ **Senha** – a senha de *APEX\$1PUBLIC\$1USER*. Essa é a senha que você especificou anteriormente quando configurou o repositório do Oracle APEX. Para obter mais informações, consulte [Desbloquear a conta de usuário público em sua instância de banco de dados](#Appendix.Oracle.Options.APEX.PublicUser).
+ **Tipo de conexão** – básica
+ **Nome de host** – o endpoint da instância de banco de dados do Amazon RDS, como `mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com`.
+ **Porta** – 1521
+ **SID** – o nome do banco de dados na sua instância de banco de dados do Amazon RDS, como `mydb`.
1. Escolha **Apply (Aplicar)**. A janela de administração do Oracle APEX é exibida.
1. Defina uma senha para o usuário `admin` do Oracle APEX. Para fazer isso, use o SQL\$1Plus para conectar à sua instância de banco de dados como o usuário principal e execute os comandos a seguir.
```
1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
2. grant APEX_ADMINISTRATOR_ROLE to master;
3. @/home/apexuser/apex/apxchpwd.sql
```
Substitua `master` pelo seu nome de usuário principal. Quando o script `apxchpwd.sql` solicitar, insira uma nova senha `admin`.
1. Volte para a janela de administração do Oracle APEX no navegador e escolha **Administração**. Em seguida, escolha **Application Express Internal Administration (Administração interna do Application Express)**. Quando forem solicitadas as credenciais, insira as seguintes informações:
+ **Nome de usuário** – `admin`
+ **Senha** – a senha configurada com o script `apxchpwd.sql`
Escolha **Login (Fazer login)** e, em seguida, defina uma nova senha para o usuário `admin`.
Agora o listener está pronto para ser usado.