서버 이전하기

Linux에 설치한 스페이스빌더를 새 서버로 옮기는 방법을 안내합니다. 설정 폴더와 데이터 저장 경로를 새 서버로 복사한 뒤, 새 서버에 라이선스를 다시 등록합니다.

시작하기 전에

• 기존 서버와 새 서버의 터미널에서 진행합니다.
• 이전하는 동안 접속이 끊기므로 사용자가 적은 시간에 진행합니다.
• 새 서버에 기존 데이터를 담을 저장 공간이 충분한지 확인합니다.
• 새 서버에서도 기존 서버와 같은 이름의 사용자 계정과 같은 경로를 사용할 것을 권장합니다. 경로가 달라지면 설정 파일을 수정해야 합니다.

옮길 항목 확인하기

데이터 저장 경로는 기존 서버에서 다음 명령으로 확인합니다.

~/setfn-spacebuilder homepath get

기존 서버에서 준비하기

1. 관리자 홈의 라이선스 관리에서 라이선스 해제를 진행합니다. 라이선스는 기기에 연결되므로 해제해야 새 서버에 등록할 수 있습니다.
2. 스페이스빌더를 멈춥니다.

   sudo systemctl stop setfn-spacebuilder
   

3. 설정 폴더와 데이터 저장 경로를 새 서버의 같은 경로로 복사합니다. 다음은 rsync를 사용하는 예입니다.

   rsync -a ~/.config/SetFN/ <사용자>@<새 서버 주소>:~/.config/SetFN/
   rsync -a <데이터 저장 경로>/ <사용자>@<새 서버 주소>:<데이터 저장 경로>/
   

새 서버에서 시작하기

1. Linux에 설치하기에 따라 기존 서버와 같은 버전의 설치 파일을 준비합니다. 버전은 기존 서버에서 ~/setfn-spacebuilder version으로 확인합니다.
2. 데이터 저장 경로가 기존 서버와 달라졌다면 ~/.config/SetFN/config.yaml에서 경로를 수정합니다.

   server:
     homeFolder: <새 데이터 저장 경로>
   

3. Linux에 설치하기의 자동 시작 설정을 진행하고 스페이스빌더를 시작합니다.

   sudo systemctl start setfn-spacebuilder
   

4. 관리자 페이지에 로그인해 라이선스 관리에서 라이선스를 다시 등록합니다.
5. 사용자가 접속하는 주소가 새 서버를 가리키도록 변경합니다. 접속 주소 확인 (로컬/내부망)과 외부 접속 방식 선택을 참고합니다.

이전 결과 확인하기

• 기존 계정으로 로그인되는지 확인합니다.
• 팀 폴더와 개인 폴더의 파일이 보이는지 확인합니다.
• 관리자 홈에서 라이선스 상태를 확인합니다.
• Qdrant나 Milvus 같은 외부 벡터 DB를 사용한다면 새 서버에서 해당 서버에 연결되는지 지식 저장소에서 확인합니다.

기존 서버와 함께 운영하기

기존 서버를 계속 운영하면서 복사한 서버를 따로 운영하려면, 복사한 서버를 처음 시작하기 전에 다음 명령을 실행합니다.

~/setfn-spacebuilder admin vector-instance-id
~/setfn-spacebuilder admin prepare-clone <출력된 UUID>

첫 번째 명령은 현재 인스턴스 UUID를 출력합니다. 두 번째 명령은 복사한 서버에 새 인스턴스 UUID를 부여하고, 함께 복사된 지식 인덱스를 따로 보관합니다. 서버를 시작하면 저장된 파일로 지식 인덱스를 다시 만듭니다.

복사한 서버에도 라이선스를 등록해야 합니다. 운영할 수 있는 서버 수는 요금제에 따라 다릅니다.

알아두기

• 이전이 끝나고 새 서버가 정상인지 확인한 뒤에 기존 서버의 데이터를 삭제합니다. 삭제 방법은 스페이스빌더 제거하기를 참고합니다.
• 명령은 스페이스빌더를 멈춘 상태에서 실행합니다. 자세한 내용은 명령어로 서버 관리하기를 참고합니다.

관련 문서

• Linux에 설치하기
• 라이선스 관리
• 스페이스빌더 업데이트하기
• 스페이스빌더 제거하기