Quick Start

AkasicDB를 설치하고, 데이터베이스 서버를 세팅하는 방법을 안내합니다.

Short version

sudo apt-get update
sudo apt-get install -y postgresql-client-15

docker pull ghcr.io/graphai-io/akasicdb:vX.X.X-community 

mkdir -p $HOME/.license
cp license.json $HOME/.licenses/akasicdb_license.json
chown -R 666 $HOME/.license/akasicdb_license.json

mkdir -p $HOME/akasicdb_data

docker run  --name akasicdb \
            -e POSTGRES_PASSWORD=mysecretpassword \
            -v $HOME/akasicdb_data:/var/lib/postgresql/data \
            -v $HOME/.license:/license \
            -p 127.0.0.1:5432:5432 \
            ghcr.io/graphai-io/akasicdb:vX.X.X-community 

psql -h 127.0.0.1 -p 5432 -U postgres

Docker 기반 설치

1. PostgreSQL 클라이언트 설치

sudo apt-get update
sudo apt-get install -y postgresql-client-15

Docker Container로 실행한 AkasicDB 서버를 외부에서 접속하기 위해 PostgreSQL 클라이언트를 설치합니다.

2. Docker Image 다운로드

docker pull ghcr.io/graphai-io/akasicdb:vX.X.X-community

AkasicDB의 이미지를 다운로드받습니다. 이때, 버전(v.X.X.X) 및 에디션(community/enterprise)은 사용하실 사양에 맞게 입력해주세요.

3. 라이선스 관련 세팅

mkdir -p $HOME/.license
cp {라이선스 파일 경로} $HOME/.licenses/akasicdb_license.json
chown -R 666 $HOME/.license/akasicdb_license.json

라이선스 파일을 원하는 경로에 akasicdb_license.json이라는 이름으로 저장해주세요. 본 문서에서는 $HOME/.license 디렉토리에 저장한다고 가정합니다.

4. 데이터 디렉토리 세팅

mkdir -p $HOME/akasicdb_data

AkasicDB의 데이터가 저장될 디렉토리를 생성합니다. 본 문서에서는 $HOME/akasicdb_data 디렉토리를 AkasicDB의 데이터 디렉토리로 가정합니다.

5. AkasicDB 컨테이너 실행

docker run  --name akasicdb \
            -e POSTGRES_PASSWORD=mysecretpassword \
            -v $HOME/akasicdb_data:/var/lib/postgresql/data \
            -v $HOME/.license:/license \
            -p 127.0.0.1:5432:5432 \
            ghcr.io/graphai-io/akasicdb:vX.X.X-community 

Docker Image를 통해 Docker 컨테이너를 실행합니다.

이때, -v 옵션으로 위에서 만든 라이선스 디렉토리와 데이터 디렉토리를 마운트해서, Docker 컨테이너가 해당 디렉토리를 사용하도록 합니다.

또한, 외부 접속을 가능하게 하기 위해 -p 옵션으로 호스트의 IP 및 포트 “127.0.0.1:5432”를 Docker 컨테이너의 5432번 포트와 연결합니다.

POSTGRES_PASSWORD의 경우 원하는 패스워드로 설정해주세요.

AkasicDB 접속 및 확장 활성화

AkasicDB 접속

psql -h 127.0.0.1 -p 5432 -U postgres

PostgreSQL 클라이언트를 통해 Docker 컨테이너로 실행된 AkasicDB에 접속합니다.

처음에는 postgres 유저만 존재하며, 이 유저는 superuser 권한을 가집니다.

AkasicDB 확장 활성화

CREATE EXTENSION IF NOT EXISTS akasicdb;

SELECT akasicdb_admin.initialize();

psql로 접속한 후에, AkasicDB 확장을 활성화합니다.

이 과정은 관리자 권한을 가진 계정으로만 수행할 수 있으며, AkasicDB를 실행하고 한번만 실행하면 활성화가 계속 유지됩니다.

마무리

이제 AkasicDB의 기능을 사용할 수 있습니다! AkasicDB의 그래프 및 벡터 기능에 대한 자세한 설명은 Usage 섹션과 Examples & Tutorials 섹션을 참고해주세요.