2025/20.개발산출물/02.개발문서(설계서,설치가이드) » IITP-DABT-Analysis_설치가이드.md
/* PDF 변환 시 페이지 머리글 및 번호 표시 */
@page {
@top-left {
content: "IITP DABT Analysis 배포 설치 가이드";
font-size: 10pt;
color: #666;
font-family: Arial, sans-serif;
}
@bottom-center {
content: counter(page) " / " counter(pages);
font-size: 10pt;
color: #666;
font-family: Arial, sans-serif;
}
}
IITP DABT Analysis
배포 설치 가이드
문서 버전: 1.0.0
작성일: 2025-11-26
(주)스위트케이
문서 History
| 버전 | 일자 | 작성자 | 변경 내용 |
|---|---|---|---|
| 1.0.0 | 2025-11-26 | (주)스위트케이 | 최초 작성 |
목차
메타베이스 설치
3.1. Docker 설치 확인
3.2. 메타베이스 이미지 다운로드
3.3. 메타베이스 컨테이너 실행
3.4. 접속 확인메타베이스 실행
4.1. 컨테이너 목록 확인
4.2. 컨테이너 시작
4.3. 실행 여부 확인백업 및 복구
5.1. H2 DB 백업 절차
5.2. H2 DB 복구 절차
부록. Docker 설치 방법
1. 개요
1.1. 문서 목적
본 문서는 IITP DABT Analysis 프로젝트의 메타베이스(Metabase) 설치 및 실행, 그리고 백업 및 복구 절차를 안내하기 위해 작성되었습니다.
1.2. 문서 범위
본 문서는 다음 내용을 포함합니다:
- 메타베이스 설치 가이드
- 메타베이스 실행 방법
- H2 DB(기본 내장 DB) 사용 시 백업 및 복구 절차
1.3. 참고 사항
- 본 문서는 Ubuntu 22+ 이상 운영체제를 기준으로 작성되었습니다.
- Docker 설치 방법은 부록. Docker 설치 방법을 참고하시기 바랍니다.
2. 시스템 요구사항
2.1. 운영체제
- Ubuntu 22.04 이상
2.2. 필수 소프트웨어
- Docker
- 메타베이스 기본 포트: 3000번 포트
3. 메타베이스 설치
3.1. Docker 설치 확인
Docker 설치 여부를 확인합니다.
docker ps
Docker가 설치되어 있지 않은 경우, Docker 설치 후 다음 단계로 진행합니다.
- Docker 설치 방법은 부록. Docker 설치 방법을 참고하시기 바랍니다.
Docker가 이미 설치되어 있는 경우, 다음 단계로 진행합니다.
3.2. 메타베이스 이미지 다운로드
메타베이스 Docker 이미지를 다운로드합니다.
docker pull metabase/metabase:latest
3.3. 메타베이스 컨테이너 실행
메타베이스 컨테이너를 실행합니다.
docker run -d -p 3000:3000 --name metabase metabase/metabase
3.4. 접속 확인
메타베이스의 기본 포트는 3000번 포트이므로 서버주소:3000으로 접속 확인합니다.
4. 메타베이스 실행
4.1. 컨테이너 목록 확인
컨테이너 목록을 확인합니다.
docker ps -a
→ 여기서 metabase 라는 이름과 d9ee671b6b02... 같은 ID를 확인할 수 있습니다.
4.2. 컨테이너 시작
컨테이너를 시작합니다.
docker start metabase
또는
docker start d9ee671b6b02
4.3. 실행 여부 확인
실행 여부를 확인합니다.
docker ps
→ STATUS 가 Up 으로 표시되면 정상 실행 중입니다.
5. 백업 및 복구
5.1. H2 DB 백업 절차
H2 DB(기본 내장 DB)를 사용하는 경우의 백업 절차입니다.
1. 컨테이너 중지 (데이터 무결성 확보)
docker stop metabase
2. DB 파일 복사
docker cp metabase:/metabase.db ./metabase-backup
→ ./metabase-backup/metabase.db.mv.db 파일이 생김
주의: H2는 파일 기반이라, 실행 중에 바로 복사하면 깨질 수 있습니다. 꼭 중지 후 복사 권장합니다.
3. 컨테이너 설정(환경변수, 포트)도 함께 기록
docker inspect metabase > metabase-config.json
4. 이미지 백업 (선택사항)
docker commit metabase metabase_with_data:backup
docker save -o metabase_with_data.tar metabase_with_data:backup
5.2. H2 DB 복구 절차
H2 DB(기본 내장 DB)를 사용하는 경우의 복구 절차입니다.
1. 기존 백업 디렉토리 준비
mkdir ./metabase-restore
cp ./metabase-backup/metabase.db.mv.db ./metabase-restore/
2. 새 컨테이너 실행
docker run -d -p 3000:3000 \
-v $(pwd)/metabase-restore:/metabase.db \
--name metabase metabase/metabase
이렇게 하면 기존 데이터로 새 컨테이너가 복원됩니다.
부록. Docker 설치 방법
본 부록은 Ubuntu 환경에서 Docker를 설치하는 방법을 안내합니다.
1. 패키지 인덱스 업데이트
Ubuntu의 패키지 리스트를 최신 상태로 업데이트합니다.
sudo apt-get update
2. 패키지 설치
apt가 HTTPS를 통해 저장소에서 패키지를 다운로드할 수 있도록 필요한 패키지들을 설치합니다.
sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
3. Docker의 공식 GPG 키 추가
Docker 저장소의 공식 GPG 키를 시스템에 추가합니다.
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
4. Docker 저장소 추가
시스템의 apt 소스 리스트에 Docker의 공식 저장소를 추가합니다.
sudo add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"
5. 패키지 인덱스 업데이트
새로운 저장소를 추가한 후에는 다시 한번 패키지 인덱스를 업데이트합니다.
sudo apt-get update
6. Docker CE 설치
Docker CE(커뮤니티 에디션) 및 CLI 도구를 설치합니다.
sudo apt-get install docker-ce docker-ce-cli containerd.io
7. Docker 서비스 시작 및 자동 시작 설정
Docker 서비스를 시작하고, 시스템 부팅 시 자동으로 시작되도록 설정합니다.
sudo systemctl start docker
sudo systemctl enable docker
8. Docker 그룹에 사용자 추가
sudo 없이 Docker 명령을 실행하기 위해 설정합니다. (계정명은 확인 후 변경 필요)
sudo usermod -aG docker sweetk # sudo usermod -aG docker ${USER}
newgrp docker
9. 설치 확인
Docker가 성공적으로 설치되었는지 확인하기 위해, 설치된 Docker의 버전을 출력합니다.
docker --version