Configurar o APEX e o Oracle Rest Data Services (ORDS) - Amazon Relational Database Service
Adicionar opções do APEXDesbloquear a conta de usuário público Configuração de serviços RESTfulPreparar-se para instalar o ORDS em um host separadoConfigurar o Oracle APEX Listener

Configurar o APEX e o Oracle Rest Data Services (ORDS)

O tópico a seguir lista as etapas necessárias para configurar o APEX e o ORDS

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.

  2. Adicione as opções APEX e APEX-DEV ao grupo de opções.

  3. Associe o grupo de opções à instância de banco de dados.

Quando você adiciona as opções do APEX do Amazon RDS, ocorre uma breve interrupção enquanto sua 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.

Para adicionar as opções do APEX a uma instância do 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 do APEX são compatíveis em todas as edições.

    2. 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.

  2. 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 Version (Versão), escolha a versão do APEX que você deseja usar.

    Importante

    Se você adiciona as opções do APEX a um grupo de opções existente que já está 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.

  3. 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.

    • 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 do APEX a uma instância de banco de dados existente, ocorre uma breve interrupção enquanto sua instância de banco de dados é reiniciada automaticamente. Para ter mais informações, consulte Modificar uma instância de banco de dados do Amazon RDS.

Desbloquear a conta de usuário público em sua instância de banco de dados

Depois que as opções APEX do Amazon RDS forem instaladas na instância de banco de dados, faça o seguinte:

  1. Altere a senha da conta de usuário público do APEX.

  2. Desbloqueie a conta.

Você pode fazer isso usando o utilitário de linha de comando Oracle SQL*Plus. 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. 

ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;

Configuração de serviços RESTful para o Oracle APEX

Para configurar serviços RESTful no APEX (não necessário para o APEX 4.1.1.V1), use o SQL*Plus para se conectar à sua instância de banco de dados como usuário mestre. 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.

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 APEX.

Como se preparar para a instalação do ORDS

  1. Faça login em myapexhost.example.com como root.

  2. 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;

  3. Faça login em myapexhost.example.com como apexuser e baixe o arquivo de instalação APEX do Oracle no diretório /home/apexuser:

  4. 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.

  5. 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.

Configurar o Oracle APEX Listener

nota

O Oracle APEX Listener está defasado.

O Amazon RDS for Oracle continua a oferecer suporte ao 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 APEX.

Como se preparar para a instalação do Oracle APEX Listener

  1. Faça login em myapexhost.example.com como root.

  2. 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;

  3. Faça login em myapexhost.example.com como apexuser e baixe o arquivo de instalação APEX do Oracle no diretório /home/apexuser:

  4. 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.

  5. 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 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

  2. Execute o código a seguir.

    java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war

  3. 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

  4. 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.

  5. No navegador, acesse o URL fornecido pelo programa 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_PUBLIC_USER. Esta é a senha que você especificou anteriormente quando configurou o repositório do APEX. Para ter mais informações, consulte Desbloquear a conta de usuário público em sua instância de banco de dados.

    • 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.

  6. Escolha Apply (Aplicar). A janela de administração do APEX é exibida.

  7. Defina uma senha para o usuário admin do APEX. Para fazer isso, use o SQL*Plus para conectar à sua instância de banco de dados como o usuário principal e execute os comandos a seguir.

    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/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.

  8. Volte para a janela de administração do APEX no navegador e escolha Administration (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.