[ OracleDB ] EM Express 활성화

📌 개요

Oracle Enterprise Manager Database Express (EM Express)는 Oracle Database에 통합된 웹 기반 관리 도구입니다. 데이터베이스 상태 확인, SQL 실행, 성능 분석 등
가벼운 관리 작업을 웹 브라우저에서 직접 수행할 수 있도록 지원합니다. 특히 OCI에서 제공되는 Oracle DB는 기본적으로 EM Express 을 제공하며 기능이 활성화 후, 포트와 방화벽 설정을 통해 외부 접근이 가능합니다.

---

1. EM Express 포트 설정 (DB 작업)

✅ CDB 및 PDB 포트 지정

-- CDB 포트 (예: 5500)
SQL> exec DBMS_XDB_CONFIG.SETHTTPSPORT(5500);

-- PDB 포트 (예: 5501)
SQL> exec DBMS_XDB_CONFIG.SETHTTPSPORT(5501);

-- 현재 설정된 포트 확인
SQL> select dbms_xdb_config.getHttpsPort() from dual;

참고: 포트 번호는 환경에 맞게 자유롭게 변경 가능

---

2. 방화벽 포트 오픈 (OS 작업)

# CDB 포트 5500 허용
$ iptables -I INPUT 8 -p tcp -m state --state NEW -m tcp --dport 5500 -j ACCEPT -m comment --comment "Required for EM Express CDB."

# PDB 포트 5501 허용
$ iptables -I INPUT 8 -p tcp -m state --state NEW -m tcp --dport 5501 -j ACCEPT -m comment --comment "Required for EM Express PDB."

# 방화벽 설정 저장 및 재시작
$ /sbin/service iptables save
$ service iptables restart
$ service iptables status

---

3. EM Express 접속 URL 예시

대상	주소
CDB	https://<서버IP>:5500/em
PDB	https://<서버IP>:5501/em

반드시 HTTPS로 접속해야 하며, 브라우저 인증서 경고는 무시해도 무방합니다.

---

4. 장애 상황 예시 및 해결

🔧 Case 1. Wallet 파일 권한 문제

# Wallet 파일 경로로 이동
cd /u01/app/oracle/product/12.2.0.1/dbhome_1/admin/<DB_NAME>/xdb_wallet

# 기존 권한 확인 (예: 너무 제한적이면 오류 발생)
ls -alh
-rw------- 1 oracle asmadmin 3912 Apr 12 11:13 cwallet.sso
-rw------- 1 oracle asmadmin 3867 Apr 12 11:13 ewallet.p12

# 권한 조정: group read 권한 추가
chmod 640 *

# 적용 후 상태 확인
ls -alh
-rw-r----- 1 oracle asmadmin 3912 Apr 12 11:13 cwallet.sso
-rw-r----- 1 oracle asmadmin 3867 Apr 12 11:13 ewallet.p12

🔧 Case 2. Listener 설정 누락

# lsnrctl status 결과 확인 시 tcps 포트가 노출되지 않으면 listener.ora 설정 필요
# (보통 EM Express는 TCPS 기반으로 통신)

---

5. 참고 문서 및 링크

• EM Express 개요 공식 문서
• My Oracle Support: EM Express Not Working (Doc ID 1604062.1)

---

✅ 요약

• EM Express는 별도 설치 없이 Oracle DB에 통합되어 있는 웹 UI 관리 도구입니다.
• CDB, PDB 각각에 포트를 설정하고 해당 포트를 방화벽에서 허용해야 합니다.
• Wallet 권한 문제, Listener 누락 등이 접속 오류의 주요 원인이므로 사전 점검이 필요합니다.
• OCI 환경에서는 기본적으로 활성화되어 있으며 VCN 보안 목록 및 보안 그룹 설정도 함께 고려해야 합니다.