Oracle Application Express(APEX)

사용할 옵션 그룹을 결정합니다. 새 옵션 그룹을 생성하거나 기존 옵션 그룹을 사용합니다. 기존 옵션 그룹을 사용하려면 다음 단계로 건너뛰십시오. 그렇지 않으면 다음 설정을 사용하여 사용자 지정 DB 옵션을 생성합니다.

1. [Engine]에서 사용할 Oracle 버전을 선택합니다. 모든 버전에서 APEX 옵션이 지원됩니다.

2. 메이저 엔진 버전에서 DB 인스턴스의 버전을 선택합니다.

자세한 내용은 옵션 그룹 생성 섹션을 참조하세요.

해당 옵션을 옵션 그룹에 추가합니다. Oracle APEX 런타임 환경만 배포하려면 APEX 옵션만 추가합니다. 전체 개발 환경을 배포하려면 APEX 및 APEX-DEV 옵션을 모두 추가합니다.

[ Version]에서 사용하고자 하는 APEX 버전을 선택합니다.

옵션 추가에 대한 자세한 내용은 옵션 그룹에 옵션 추가 섹션을 참조하세요.

옵션 그룹을 새 DB 인스턴스 또는 기존 DB 인스턴스에 적용합니다:

myapexhost.example.com에 root로 로그인합니다.

리스너 설치를 소유할 권한 없는 OS 사용자를 생성합니다. 다음 명령은 apexuser라는 새 사용자를 생성합니다.

useradd -d /home/apexuser apexuser

다음 명령은 새로운 사용자에게 암호를 할당합니다.

passwd apexuser;

myapexhost.example.com에 apexuser로 로그인하고, Oracle의 APEX 설치 파일을 /home/apexuser 디렉터리에 다운로드합니다.

/home/apexuser 디렉터리에서 파일의 압축을 풉니다.

unzip apex_version.zip

파일의 압축을 풀면 apex 디렉터리에 /home/apexuser 디렉터리가 있습니다.

myapexhost.example.com에 apexuser로 로그인한 상태에서 Oracle REST Data Services 파일을 Oracle에서 /home/apexuser 디렉터리로 다운로드합니다. http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html

Oracle REST data services로 이동하여 Readme를 검토합니다. 필요한 버전의 Java를 설치했는지 확인합니다.

ORDS 설치를 위한 새 디렉터리를 만듭니다.

mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS

Oracle REST 데이터 서비스에서 ords.version.number.zip 파일을 다운로드합니다.

/home/apexuser/ORDS 디렉터리에 파일의 압축을 풉니다.

다중 테넌트 데이터베이스에 ORDS를 설치하는 경우 /home/apexuser/ORDS/params/ords_params.properties 파일에 다음 줄을 추가합니다.

pdb.disable.lockdown=false

마스터 사용자에게 ORDS를 설치하는 데 필요한 권한을 부여합니다.

Amazon RDS APEX 옵션이 설치된 후 마스터 사용자에게 ORDS 스키마를 설치하는 데 필요한 권한을 부여합니다. 이렇게 하려면 데이터베이스에 연결하고 다음 명령을 실행합니다. MASTER_USER를 마스터 사용자의 대문자 이름으로 바꿉니다.

exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true);

다운로드한 ords.war 파일을 사용하여 ORDS 스키마를 설치합니다.

java -jar ords.war install advanced

프로그램에서 다음 정보를 묻는 메시지를 표시합니다. 기본값은 괄호 안에 표시되어 있습니다. 자세한 내용은 Oracle 설명서의 Introduction to Oracle REST Data Services를 참조하세요.

APEX admin 사용자용 암호를 설정합니다. 이를 위해 SQL*Plus를 사용하여 DB 인스턴스에 마스터 사용자로 연결하고 다음 명령을 실행합니다.

EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql

master를 마스터 사용자 이름으로 바꿉니다. apxchpwd.sql 스크립트에서 메시지가 표시되면 새 admin 암호를 입력합니다.

ORDS 리스너를 시작합니다. 다음 코드를 실행합니다.

java -jar ords.war

ORDS를 처음으로 시작할 때 APEX 고정 리소스의 위치를 제공하라는 메시지가 나타납니다. 이 이미지 폴더는 APEX 설치 디렉터리의 /apex/images 디렉터리에 위치합니다.

브라우저에서 APEX 관리 창으로 돌아가서 [Administration]을 선택합니다. 그런 다음 [Application Express Internal Administration]을 선택합니다. 자격 증명을 요구하는 메시지가 표시되면 다음 정보를 입력합니다.

[Login]을 선택한 다음 admin 사용자용 새 암호를 설정합니다.

Oracle REST data services로 이동하여 다운로드하려는 ORDS 버전에 대한 Readme를 검토합니다. 필요한 버전의 Java를 설치했는지 확인합니다.

ORDS 설치를 위한 새 디렉터리를 만듭니다.

mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS

Oracle REST data services에서 ords.version.number.zip 또는 ords-latest.zip 파일을 다운로드합니다.

/home/apexuser/ORDS 디렉터리에 파일의 압축을 풉니다.

마스터 사용자에게 ORDS를 설치하는 데 필요한 권한을 부여합니다.

Amazon RDS APEX 옵션이 설치된 후 마스터 사용자에게 ORDS 스키마를 설치하는 데 필요한 권한을 부여합니다. 이렇게 하려면 데이터베이스에 로깅하여 다음 명령을 실행합니다. MASTER_USER를 마스터 사용자의 대문자 이름으로 바꿉니다.

exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true);

exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_LOB', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_ASSERT', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_OUTPUT', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SCHEDULER', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('HTP', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('OWA', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPG_DOCLOAD', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_CRYPTO', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_METADATA', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SQL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('UTL_SMTP', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_NETWORK_ACL_ADMIN', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('SESSION_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_USERS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACL_PRIVILEGES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACLS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_REGISTRY', 'MASTER_USER', 'SELECT', true);

다운로드한 ords 스크립트를 사용하여 ORDS 스키마를 설치합니다. 구성 파일 및 로그 파일을 포함할 디렉터리를 지정합니다. Oracle Corporation은 이러한 디렉터리를 ORDS 제품 소프트웨어가 포함되어 있는 디렉터리 내에 배치하지 말 것을 권장합니다.

mkdir -p /home/apexuser/ords_config /home/apexuser/ords_logs

/home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config \
  install --interactive --log-folder /home/apexuser/ords_logs

컨테이너 데이터베이스(CDB) 아키텍처를 실행하는 DB 인스턴스의 경우 ORDS 23.2 이상을 사용하고 ORDS를 설치할 때 --pdb-skip-disable-lockdown 인수를 전달합니다.

/home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config \
  install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown

프로그램에서 다음 정보를 묻는 메시지를 표시합니다. 기본값은 괄호 안에 표시되어 있습니다. 자세한 내용은 Oracle 설명서의 Introduction to Oracle REST Data Services를 참조하세요.

APEX admin 사용자용 암호를 설정합니다. 이를 위해 SQL*Plus를 사용하여 DB 인스턴스에 마스터 사용자로 연결하고 다음 명령을 실행합니다.

EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql

master를 마스터 사용자 이름으로 바꿉니다. apxchpwd.sql 스크립트에서 메시지가 표시되면 새 admin 암호를 입력합니다.

serve 명령과 함께 ords 스크립트를 사용하여 독립형 모드에서 ORDS를 실행합니다. 프로덕션 배포의 경우 Apache Tomcat 또는 Oracle WebLogic Server 등의 지원되는 Java EE 애플리케이션 서버를 사용하는 것이 좋습니다. 자세한 내용은 Oracle 데이터베이스 설명서의 Oracle REST Data Services 배포 및 모니터링을 참조하세요.

/home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config serve \
  --port 8193 \
  --apex-images /home/apexuser/apex/images

ORDS가 실행 중이지만 APEX 설치에 액세스할 수 없는 경우, 특히 비CDB 인스턴스에서 다음 오류가 표시될 수 있습니다.

The procedure named apex_admin could not be accessed, it may not be declared, or the user executing this request may not have been granted execute privilege on the procedure, or a function specified by security.requestValidationFunction configuration property has prevented access.

이 오류를 해결하려면 config 명령으로 ords 스크립트를 실행하여 ORDS에서 사용하는 요청 검증 함수를 변경합니다. 기본적으로 ORDS는 CDB 인스턴스에서만 지원되는 ords_util.authorize_plsql_gateway 프로시저를 사용합니다. 비CDB 인스턴스의 경우 이 프로시저를 wwv_flow_epg_include_modules.authorize 패키지로 변경할 수 있습니다. 사용 사례에 적합한 요청 검증 기능을 구성하는 모범 사례는 Oracle 데이터베이스 설명서 및 Oracle 지원을 참조하세요.

브라우저에서 APEX 관리 창으로 돌아가서 [Administration]을 선택합니다. 그런 다음 [Application Express Internal Administration]을 선택합니다. 자격 증명을 요구하는 메시지가 표시되면 다음 정보를 입력합니다.

[Login]을 선택한 다음 admin 사용자용 새 암호를 설정합니다.

myapexhost.example.com에 root로 로그인합니다.

리스너 설치를 소유할 권한 없는 OS 사용자를 생성합니다. 다음 명령은 apexuser라는 새 사용자를 생성합니다.

useradd -d /home/apexuser apexuser

다음 명령은 새로운 사용자에게 암호를 할당합니다.

passwd apexuser;

myapexhost.example.com에 apexuser로 로그인하고, Oracle의 APEX 설치 파일을 /home/apexuser 디렉터리에 다운로드합니다.

/home/apexuser 디렉터리에서 파일의 압축을 풉니다.

unzip apex_<version>.zip                

파일의 압축을 풀면 apex 디렉터리에 /home/apexuser 디렉터리가 있습니다.

myapexhost.example.com에 apexuser로 여전히 로그인되어 있는 경우, Oracle의 Oracle APEX 리스너 파일을 /home/apexuser 디렉터리에 다운로드합니다.

Oracle APEX Listener를 기반으로 새 디렉터리를 생성하고 리스너 파일을 엽니다.

다음 코드를 실행합니다.

mkdir /home/apexuser/apexlistener
cd /home/apexuser/apexlistener 
unzip ../apex_listener.version.zip

다음 코드를 실행합니다.

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

다음 프로그램 프롬프트에 정보를 입력합니다.

다음과 같이 구성을 완료하는 데 필요한 URL이 인쇄됩니다.

INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
Database is not yet configured 

Oracle Application Express를 사용할 수 있도록 Oracle APEX Listener를 계속 실행합니다. 이 구성 절차를 마치면 Listener를 백그라운드에서 실행할 수 있습니다.

웹 브라우저에서 APEX Listener 프로그램에 제공된 URL로 이동합니다. Oracle Application Express Listener 관리 창이 나타납니다. 다음 정보를 입력합니다.

적용을 선택합니다. APEX 관리 창이 나타납니다.

APEX admin 사용자용 암호를 설정합니다. 이를 위해 SQL*Plus를 사용하여 DB 인스턴스에 마스터 사용자로 연결하고 다음 명령을 실행합니다.

EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql

master를 마스터 사용자 이름으로 바꿉니다. apxchpwd.sql 스크립트에서 메시지가 표시되면 새 admin 암호를 입력합니다.

브라우저에서 APEX 관리 창으로 돌아가서 [Administration]을 선택합니다. 그런 다음 [Application Express Internal Administration]을 선택합니다. 자격 증명을 요구하는 메시지가 표시되면 다음 정보를 입력합니다.

[Login]을 선택한 다음 admin 사용자용 새 암호를 설정합니다.