[Oracle] Oracle Instant Client rpm 설치 가이드 (for Linux x86-64)

Oracle Instant Client란?

오라클 데이터베이스에 연결하여 애플리케이션을 개발 및 배포할 때 필요한 라이브러리(OCI, OCCI, JDBC, ODBC 등)와 도구를 경량으로 패키징한 무료 소프트웨어입니다. 복잡한 설치 과정 없이 압축 해제와 환경 설정(PATH)만으로 즉시 사용할 수 있어 디스크 공간을 적게 차지하며, 온프레미스 및 클라우드 환경에서 오라클 DB와 연동하는 데 주로 사용됩니다. 

rpm 파일 다운로드

https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html

Instant Client for Linux x86-64 (64-bit)

 

다운로드 파일은 크게 Base와 Tools로 나뉘어져 있는데

 

Base 파일은 필수

 

이후 패키지에 따라서 Tools에서 선택 다운로드입니다.

 

저는 Tools에서 "sqlplus"만 다운로드 했습니다.

설치 과정

1) Base(basic) 파일 설치

root 계정으로 접속 후 basic.rpm 파일 설치

# yum install -y oracle-instantclient19.30-basic-19.30.0.0.0-1.x86_64.rpm

참고)
rpm으로 설치하면 ORACLE_HOME과 TNS_ADMIN의 경로가 정해집니다.
* ORACLE_HOME = /usr/lib/oracle/<버전>/client64
* TNS_ADMIN = /usr/lib/oracle/<버전>/client64/bin

2) Tools(sqlplus) 파일 설치

root 계정으로 접속 후 sqlplus.rpm 파일 설치

# yum install -y oracle-instantclient19.30-sqlplus-19.30.0.0.0-1.x86_64.rpm

참고)
base 파일 설치가 선행되지 않은 채로 tools 파일 설치를 진행하면 basic 파일이 필요하다는 에러가 발생

3) oracle.sh 파일 생성

"/etc/profile.d/oracle.sh" 생성 후 아래와 같이 $ORACLE_HOME, $TNS_ADMIN 내용 추가

# vi /etc/profile.d/oracle.sh
export ORACLE_HOME=/usr/lib/oracle/19.15/client64
export TNS_ADMIN=/usr/lib/oracle/19.15/client64/bin

4) 환경변수 설정

oracle instant client를 사용하려는 OS 계정으로 접속 후

OS 계정의 .bash_profile에 아래와 같이 환경 변수 설정 추가 

$ vi ~/.bash_profile
export NLS_LANG=AMERICAN_AMERICA.AL32UTF8
export ORACLE_HOME=/usr/lib/oracle/19.30/client64
export TNS_ADMIN=/usr/lib/oracle/19.30/client64/bin
export PATH=${PATH}:$HOME/bin:$ORACLE_HOME/bin
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$ORACLE_HOME/lib

 

.bash_profile 적용

$ . ./.bash_profile

5) tnsname 설정

oracle instant client에서 oracle server로 접속(sqlplus)을 위해서 tnsnames.ora 작성

HOST, PORT, SID에는 oracle server의 정보를 명시

$ vi $TNS_ADMIN/tnsnames.ora
xxx =
  (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = xxx.xxx.xxx.xxx)(PORT = xxxx))
        (CONNECT_DATA =
                (SERVER = DEDICATED)
                (SID = xxx)
        )
 )

6) 접속(sqlplus) 확인

oracle server로 접속(sqlplus) 확인

• id : DB 계정
• passwd : DB 계정 비밀번호
• serviceName : tnsnames.ora에서 작성한 서비스명

$ sqlplus id/passwd@serviceName

SQL*Plus: Release 19.0.0.0.0 - Production on 금 2월 25 16:15:19 2026
Version 19.30.0.0.0
Copyright (c) 1982, 2026, Oracle.  All rights reserved.
마지막 성공한 로그인 시간: 금 2월  25 2026 16:14:30 +09:00
다음에 접속됨:
Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
Version 19.3.0.0.0

SQL>

---

참고

https://gomu92.tistory.com/72

[oracle] Oracle Instant Client(linux) 설치 & 설정 & sqlplus 접속 가이드.(oracle19c instant client 설치 & 설정 & sql