시스템 관리_33 오라클 ORA-12541 TNS no listener 연결 실패 오류 원인 분석 및 완벽 복구 가이드

# 1. 클라이언트 관점: tnsping 도구로 TNS 별칭 및 대상 리스너 도달 가능 여부 테스트
$ tnsping orcl
# TNS Ping Utility for Linux: Version 19.0.0.0.0 - Production on 15-OCT-2026 10:15:30
# Used parameter files:
# /u01/app/oracle/product/19.0.0/dbhome_1/network/admin/sqlnet.ora
# Used TNSNAMES.ORA entry to resolve name:
# (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = orcl)))
# TNS-12541: TNS:no listener

# 2. 클라이언트 관점: IP와 포트(1521) 직통 TCP 연결 가능 여부 확인 (Connection refused 여부)
$ nc -zv -w 3 192.168.1.100 1521
# nc: connect to 192.168.1.100 port 1521 (tcp) failed: Connection refused
# 또는 curl을 이용한 포트 오픈 검사:
$ curl -v telnet://192.168.1.100:1521

# 3. DB 서버 관점: 오라클 리스너 데몬의 실행 상태 점검
$ lsnrctl status
# Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=dbserver)(PORT=1521)))
# TNS-12541: TNS:no listener
#  TNS-12560: TNS:protocol adapter error
#   TNS-00511: No listener
#    Linux Error: 111: Connection refused
# -> 리스너 프로세스가 다운되었거나 기동되지 않은 상태 확인

# 4. DB 서버 관점: 1521 포트를 리스닝 중인 프로세스 점검
$ sudo ss -tulpn | grep :1521
# 아무것도 출력되지 않는다면 리스너가 실제로 꺼져 있음을 의미

# 5. DB 서버 관점: 방화벽 정책에서 1521 포트 차단 여부 점검
$ sudo firewall-cmd --list-ports | grep 1521
$ sudo iptables -L INPUT -v -n | grep 1521

#!/bin/bash
# diagnose_oracle_listener.sh - Diagnose ORA-12541 TNS:no listener and Oracle Net Listener status

export ORACLE_SID=${ORACLE_SID:-"orcl"}
export ORAENV_ASK=NO
[ -f /usr/local/bin/oraenv ] && . /usr/local/bin/oraenv >/dev/null 2>&1

echo "=========================================="
echo " [오라클 리스너 및 ORA-12541 진단]"
echo " ORACLE_HOME: ${ORACLE_HOME:-"미설정"}"
echo "=========================================="

# 1. lsnrctl 명령어 존재 여부 점검
if ! command -v lsnrctl &>/dev/null; then
    echo "  [오류] lsnrctl 명령어를 찾을 수 없습니다. 오라클 환경변수(PATH)를 점검하세요."
    exit 1
fi

# 2. 리스너 프로세스(tnslsnr) OS 실행 여부 확인
echo -e "\n[1] OS 레벨 리스너 프로세스 점검:"
LSNR_PID=$(pgrep -f "tnslsnr" | head -n 1)

if [ -z "$LSNR_PID" ]; then
    echo "  [경고] tnslsnr 프로세스가 실행되어 있지 않습니다."
    echo "  -> 리스너 다운이 ORA-12541 오류의 직접 원인입니다."
else
    echo "  [정상] tnslsnr 프로세스 감지 (PID: ${LSNR_PID})"
fi

# 3. 1521 포트 리스닝 상태 확인
echo -e "\n[2] TCP 1521 포트 바인딩 점검:"
PORT_INFO=$(ss -tulpn | grep -E ':1521\s')

if [ -z "$PORT_INFO" ]; then
    echo "  [오류] 1521 포트가 LISTEN 상태가 아닙니다."
else
    echo "  [정상] 1521 포트 수신 대기 중:"
    echo "  $PORT_INFO"
fi

# 4. listener.ora 파일 구성 및 호스트명 점검
ADMIN_DIR="${ORACLE_HOME}/network/admin"
LISTENER_ORA="${ADMIN_DIR}/listener.ora"
echo -e "\n[3] listener.ora 설정 점검 (${LISTENER_ORA}):"

if [ -f "$LISTENER_ORA" ]; then
    grep -vE "^#|^$" "$LISTENER_ORA" | sed 's/^/    /'
    
    # 호스트명 바인딩 불일치 검사
    CONFIG_HOST=$(grep -i "HOST" "$LISTENER_ORA" | grep -oE "HOST\s*=\s*[^)]+" | awk -F'=' '{print $2}' | tr -d ' ')
    CURRENT_HOSTNAME=$(hostname)
    echo "  - listener.ora 설정 호스트: ${CONFIG_HOST}"
    echo "  - 실제 시스템 호스트명    : ${CURRENT_HOSTNAME}"
    
    if [ "$CONFIG_HOST" != "0.0.0.0" ] && [ "$CONFIG_HOST" != "$CURRENT_HOSTNAME" ] && [ "$CONFIG_HOST" != "localhost" ]; then
        echo "  [주의] 호스트명이 불일치하여 리스너 기동 실패 가능성이 있습니다. /etc/hosts 파일을 확인하세요."
    fi
else
    echo "  [안내] listener.ora 파일이 없습니다. 기본 파라미터로 구동 여부를 확인합니다."
fi

# 5. lsnrctl status 명령 실행 결과 점검
echo -e "\n[4] lsnrctl status 실행 테스트:"
STATUS_RES=$(lsnrctl status 2>&1)
if echo "$STATUS_RES" | grep -q "TNS-12541"; then
    echo "  [실패] 리스너가 중지 상태입니다 (TNS-12541 감지)."
    echo "  -> 복구 조치: 'lsnrctl start' 명령을 실행하여 리스너를 기동하십시오."
elif echo "$STATUS_RES" | grep -q "STATUS of the LISTENER"; then
    echo "  [성공] 리스너가 정상 작동 중입니다."
    # 등록된 서비스 개수 추출
    SVC_COUNT=$(echo "$STATUS_RES" | grep -c "Service.*has.*instance")
    echo "  - 서비스에 등록된 인스턴스 수: ${SVC_COUNT}개"
else
    echo "  [기타 응답]:"
    echo "$STATUS_RES" | head -n 10 | sed 's/^/    /'
fi

echo -e "\n=========================================="
echo " [진단 완료]"
echo "=========================================="

# 리스너 시작
lsnrctl start

# 리스너 상태 확인
lsnrctl status

lsnrctl reload
# 또는
lsnrctl stop && lsnrctl start