Windows에서 PowerShell로 InfluxDB와 CLI 설치: 초보자를 위한 가이드

 

 

 

 

 

 

 

 

 

안녕하세요! 이번 포스팅에서는 Windows 환경에서 PowerShell을 이용해 InfluxDB와 InfluxDB CLI를 설치하는 방법을 정리해보려고 합니다. 실제로 제가 직접 설치해보고 경험했던 점들을 공유하며, 설치 과정 중 마주칠 수 있는 문제와 해결 방법까지 자세히 설명드릴게요.

 

InfluxDB란?

InfluxDB는 시계열 데이터(Time Series Data)를 저장하고 관리하는 데 최적화된 데이터베이스입니다. 로그 데이터, IoT 센서 데이터, 애플리케이션 모니터링 등 시간 기반 데이터 처리에 자주 사용됩니다. InfluxDB는 웹 기반 UI와 CLI를 통해 데이터를 관리하고 쿼리할 수 있는 강력한 도구를 제공합니다.

 

설치 환경

• 운영체제: Windows 10
• 도구: PowerShell (관리자 권한)
• 설치할 버전: InfluxDB 2.7.11 및 InfluxDB CLI 2.7.5

설치 전 준비

설치 전에 반드시 PowerShell을 관리자 권한으로 실행해야 합니다. 그렇지 않으면 시스템 경로에 파일을 쓰거나 실행하는 과정에서 문제가 발생할 수 있어요.

PowerShell 관리자 권한 실행 방법:

1. Windows 검색창에 PowerShell을 입력합니다.
2. 검색 결과에서 Windows PowerShell을 마우스 오른쪽 클릭하고 관리자 권한으로 실행을 선택합니다.

   

3. PowerShell 창 상단에 "관리자" 문구가 포함되어 있는지 확인합니다.

   

1. InfluxDB 설치

https://www.influxdata.com/influxdata-downloads/

InfluxDB OSS 2.x

wget https://download.influxdata.com/influxdb/releases/influxdb2-2.7.11-windows.zip -UseBasicParsing -OutFile influxdb2-2.7.11-windows.zip
Expand-Archive .\influxdb2-2.7.11-windows.zip -DestinationPath 'C:\Program Files\InfluxData\influxdb\'

 

InfluxDB CLI for 2.x

wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-windows-amd64.zip -UseBasicParsing -OutFile influxdb2-client-2.7.5-windows-amd64.zip
Expand-Archive .\influxdb2-client-2.7.5-windows-amd64.zip -DestinationPath 'C:\Program Files\InfluxData\influxdb2-client\'

 

바로 아래에도 있지만 복사 붙여넣기 편하시게 참고하세요, 자 그럼 PowerShell을 통해 InfluxDB를 설치해보겠습니다.

1-1. InfluxDB 다운로드

아래 명령어를 PowerShell에서 실행하여 InfluxDB 설치 파일을 다운로드합니다:

wget https://download.influxdata.com/influxdb/releases/influxdb2-2.7.11-windows.zip -UseBasicParsing -OutFile influxdb2-2.7.11-windows.zip

1-2. 압축 해제

압축 파일을 InfluxDB를 설치할 경로로 해제합니다. 저는 C:\Program Files\InfluxData\influxdb2\ 경로를 사용했고, 1-1 실행 후 바로 붙여 넣어도 무관해요. :

Expand-Archive .\influxdb2-2.7.11-windows.zip -DestinationPath 'C:\Program Files\InfluxData\influxdb\'

참고: C:\Program Files 경로에 설치하기 위해 PowerShell이 반드시 관리자 권한으로 실행되어야 합니다.

1-3. 환경 변수 설정

InfluxDB 실행 파일을 어디서든 실행할 수 있도록 환경 변수에 추가합니다:

$env:Path += ";C:\Program Files\InfluxData\influxdb2\"

 

2. InfluxDB 실행

설치가 완료되었으니 이제 InfluxDB 서버를 실행해봅시다.

2-1. InfluxDB 서버 실행

아래 명령어를 입력하여 InfluxDB 서버를 시작합니다(CMD 사용):

경로이동   > C:\Program Files\InfluxData\influxdb2
실행명령어 > influxd.exe

서버가 정상적으로 실행되면 아래와 같은 메시지가 나타납니다:

2-2. InfluxDB 초기 설정

브라우저에서 http://localhost:8086으로 접속하면 InfluxDB 초기 설정 화면이 나타납니다. 다음 정보를 입력하여 설정을 완료합니다:

• Username: 관리자 계정 이름 (예: admin).
• Password: 비밀번호.
• Organization: 조직 이름 (예: my_org).
• Bucket: 데이터 저장소 이름 (예: my_bucket).

초기 설정 후 접속 시 로그인 화면

로그인 후 메인화면

3. InfluxDB CLI 설치

InfluxDB CLI는 서버 관리와 데이터 쿼리를 명령줄에서 간단히 실행할 수 있는 도구입니다.

3-1. CLI 다운로드

다음 명령어로 CLI 설치 파일을 다운로드합니다:

wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-windows-amd64.zip -UseBasicParsing -OutFile influxdb2-client-2.7.5-windows-amd64.zip

3-2. 압축 해제

CLI를 원하는 경로에 압축 해제합니다. 저는 C:\Program Files\InfluxData\influxdb2-client\에 설치했습니다:

Expand-Archive .\influxdb2-client-2.7.5-windows-amd64.zip -DestinationPath 'C:\Program Files\InfluxData\influxdb2-client\'

3-3. 환경 변수 설정

CLI 실행 파일 경로를 환경 변수에 추가합니다:

$env:Path += ";C:\Program Files\InfluxData\influxdb2-client\"

3-4. CLI 테스트

설치가 완료되었는지 확인하려면 다음 명령어를 실행합니다:

influx version

정상적으로 설치되었다면 CLI 버전 정보가 출력됩니다.

설치 중 마주친 문제와 해결 방법

1. 압축 해제 중 액세스 거부 오류
   • C:\Program Files 경로에 설치하려면 반드시 PowerShell을 관리자 권한으로 실행해야 합니다.
   • 관리자 권한 없이 설치하려면, 사용자 디렉터리(예: C:\Users\<사용자 이름>\InfluxDBClient\)로 설치 경로를 변경하세요.
2. 환경 변수 추가 후 CLI 인식 안 됨
   • 환경 변수를 추가한 후 PowerShell을 재시작해야 변경 내용이 반영됩니다.

 

여러분도 이 글을 참고하여 쉽게 설치를 완료하시길 바랍니다!