Luiz Aguiar Blog

Tutorial Como Instalar Oracle APEX

Luiz Sabença's photo
Luiz Sabença
·

3 min read

Table of contents

Este tutorial visa fornecer um guia de instalação do Oracle APEX em português para a comunidade brasileira. Em ambientes de desenvolvimento o servidor de aplicação (Tomcat) pode ser instalado na mesma máquina do banco de dados, já para ambientes mais críticos recomendo que sejam em máquinas separadas.

Instalação do Oracle APEX Release 22.1 e Oracle REST Data Services 22.2.

Extrair o software

Defina os caminhos. Eles serão utilizados para instalar APEX, ORDS e Tomcat.

Personalize caso precise ajustar o nome dos diretórios de acordo com as versões escolhidas.

export JAVA_HOME=/u01/oracle/jdk-18.0.1 
export JAVA_OPTS="-Dconfig.url=${ORDS_CONFIG}" 
export APEX_HOME=/u01/oracle/apex 
export ORDS_HOME=/u01/oracle/ords 
export ORDS_CONFIG=/u01/oracle/ords 
export TOMCAT_HOME=/u01/oracle/apache-tomcat-8.5.78 
export PATH=$ORDS_HOME/bin:$JAVA_HOME/bin:$PATH 
export SOFTWARE_BINARIES=/u01/software

Baixar o software Java, APEX, ORDS e Tomcat.

Personalize caso precise ajustar os links para download.

cd ${SOFTWARE_BINARIES} 
wget --no-check-certificate https://download.oracle.com/java/18/latest/jdk-18_linux-x64_bin.tar.gz wget --no-check-certificate https://download.oracle.com/otn_software/apex/apex-latest.zip 
wget --no-check-certificate https://download.oracle.com/otn_software/java/ords/ords-latest.zip 
wget --no-check-certificate https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.78/bin/apache-tomcat-8.5.78.tar.gz

Extrair o Java.

cd /u01/oracle gtar -xzvf ${SOFTWARE_BINARIES}/jdk-18_linux-x64_bin.tar.gz

Extrair o APEX.

cd /u01/oracle unzip ${SOFTWARE_BINARIES}/apex-latest.zip

Extrair o ORDS.

mkdir -p ${ORDS_HOME} cd ${ORDS_HOME} unzip ${SOFTWARE_BINARIES}/ords-latest.zip

Extrair o Tomcat.

cd /u01/oracle tar xvf ${SOFTWARE_BINARIES}/apache-tomcat-8.5.78.tar.gz

Copiar imagens da pasta extraída do APEX para o Tomcat webapps, e renomear a pasta de "images" para "i".

cp -Rp ${APEX_HOME}/images ${TOMCAT_HOME}/webapps

mv ${TOMCAT_HOME}/webapps/images ${TOMCAT_HOME}/webapps/i

Alterar a configuração do Tomcat para permitir que o console Tomcat Manager seja acessado fora do localhost.

vi ${TOMCAT_HOME}/webapps/manager/META-INF/context.xml

Comente a entrada <Valve>

Alterar a configuração do Tomcat para criar um usuário para acessar o console Tomcat Manager.

vi ${TOMCAT_HOME}/conf/tomcat-users.xml Adicione a seguinte entrada:

Instalar os esquemas APEX

Copiar ${APEX_HOME} para o seu servidor de banco de dados.

Acesse a pasta do APEX (no seu servidor de banco de dados).

cd ${APEX_HOME}

Conectar-se ao banco de dados como SYS.

sqlplus "/ as sysdba"

Execute vários scripts SQL APEX. Se cada script sair do prompt do sqlplus, basta reconectar e executar o próximo script.

SQL> @apexins APEX APEX TEMP /i/ 
SQL> @apxchpwd.sql 
SQL> ALTER USER apex_public_user IDENTIFIED BY "welcome1" ACCOUNT UNLOCK; 
SQL> @apex_rest_config.sql

Instalar ORDS

Volte para o host do middleware.

Execute o comando:

cd ${ORDS_HOME} ords install

O sistema te dará 3 opções. Escolha a 2.

oracle@hostname:/u01/oracle/ords> ords install
2022-05-20T12:34:07.142Z INFO
Your configuration folder /u01/oracle/ords is located in ORDS product folder.
Oracle recommends to use a different configuration folder.

ORDS: Release 22.1 Production on Fri May 20 12:34:07 2022

Copyright (c) 2010, 2022, Oracle.

Configuration:
  /u01/oracle/ords/

The configuration folder /u01/oracle/ords does not contain any configuration files.

Oracle REST Data Services - Interactive Install

  Enter a number to select the type of installation
    [1] Install or upgrade ORDS in the database only
    [2] Create or update a database pool and install/upgrade ORDS in the database
    [3] Create or update a database pool only

Selecione Criar ou atualizar um pool de banco de dados e instalar/atualizar o ORDS no banco de dados.

Selecione Básico (nome do host, porta, nome do serviço).

Insira suas informações do banco de dados:

Nome do host: dbhost

Porta: 1521

Nome do serviço: nomedoservico

Insira a senha do SYSTEM.

Selecione Instalar o ORDS no banco de dados, que usa os tablespaces SYSAUX e TEMP (você pode alterar os esquemas se quiser).

Selecione Ações do banco de dados (todos os recursos).

Selecione Configurar e iniciar o ORDS em modo standalone.

Selecione protocolo HTTP.

  • HTTP port: 8080

  • APEX static resources: /u01/oracle/apache-tomcat-8.5.78/webapps/i/

Crie um usuário no banco de dados para iniciar o desenvolvimento e atribua as permissões:

CREATE USER apex_mycustom IDENTIFIED BY "welcome1"; 
GRANT resource, connect TO apex_mycustom; 
GRANT create dimension TO apex_mycustom; 
GRANT create job TO apex_mycustom; 
GRANT create materialized view TO apex_mycustom; 
GRANT create synonym TO apex_mycustom; 
GRANT create view TO apex_mycustom;

Inicializando o Tomcat

Copiar o arquivo do ORDS com extensão .war para a pasta do Tomcat /webapps.

cp ${ORDS_HOME}/ords.war ${TOMCAT_HOME}/webapps

Iniciar Tomcat.

cd ${TOMCAT_HOME}/bin ./startup.sh

Faça login no APEX como workspace INTERNAL e usuário ADMIN usando a senha definida na execução do script @apxchpwd.sql.

hostname:8080/ords

Thanks to Ahmed Aboulnaga on https://chronicler.tech/apex-ords-installation/

#oracle-apexorclapexTutorialInstallationTomcat