목차
위치와 사용자시작하기 전에1단계 — FirebirdSQL 확인2단계 — 원본 파일백업을 UTF-8로 준비하고 연결 / 연결 테스트3단계 — 테이블 목록과 옵션4단계 — 이전과 진행 상황5단계 — 결과와 대사유지 관리 패널자주 발생하는 오류Linux에서기존 프로그램에서 데이터 이전 (Firebird): 설정 › 데이터 이전
기존 프로그램(FirebirdSQL)의 데이터 — 거래처 및 재고 카드, 송장, 납품서, 수표, 레시피, 이미지와 문서 — 는 로그인한 뒤 설정 › 데이터 이전 (기존 프로그램에서) 섹션에서 HNR로 이전합니다. 초기 설정 마법사는 더 이상 데이터를 이전하지 않습니다. 이 섹션은 시스템 관리자만 볼 수 있으며, 휴대폰(정원 + 단계 인터페이스)에서는 같은 흐름이 단계별로 열립니다.
먼저 마법사로 회사를 만드세요. 데이터는 이미 만들어 둔 회사로 이전되며, 이 섹션은 새 회사를 만들지 않습니다. 이전하기 전에 대상 회사의 백업을 받으세요. 기존 프로그램의 데이터베이스는 읽기만 합니다. 이전 중에 단 한 행도 바뀌지 않습니다.
위치와 사용자
설정 › 데이터 이전 (기존 프로그램에서). 이 섹션은 시스템 관리자만 보고 사용할 수 있습니다. 관리자 권한이 없는 사용자에게는 “데이터 가져오기는 시스템 관리자만 사용할 수 있습니다.”라고 표시됩니다. 서버가 읽기 전용 모드(쓰기 게이트 닫힘)이면 이전이 시작되지 않습니다.
초기 설정 마법사의 “데이터베이스 가져오기(이전 회사에서 데이터 이전)” 버튼은 더 이상 데이터를 이전하지 않으며, 안내 메모만 보여 줍니다. 먼저 회사를 만들고, 로그인한 뒤 설정 › 데이터 이전 섹션을 여세요.
휴대폰(정원 + 단계 인터페이스)에서는 같은 섹션이 단계별로 열립니다. 각 단계는 별도의 화면이고, 버튼은 손가락으로 누르기 편한 크기이며, 표는 카드로 표시됩니다.
시작하기 전에
- 대상 회사가 만들어져 있어야 합니다. 초기 설정 마법사로 회사를 만들고 관리자로 로그인하세요.
- 대상 회사의 백업을 받으세요. 이전 작업은 회사에 많은 기록을 씁니다. 문제가 생기면 되돌아갈 수 있는 백업을 준비해 두세요.
- 이 컴퓨터에 FirebirdSQL 3.0, 4.0 또는 5.0이 설치되어 실행 중이어야 합니다. 1단계에서 이를 확인합니다.
- 기존 프로그램의 백업(.FBK) 또는 데이터베이스(.FDB) 파일에 이 컴퓨터에서 접근할 수 있어야 합니다. 이미지 및 문서 데이터베이스(EK1)가 있다면 같은 폴더에 두어야 합니다.
- SYSDBA 비밀번호를 준비해 두세요(Firebird 설치 시 바꾸지 않았다면 기본값은
masterkey). 백업(.FBK)을 선택할 경우 백업 크기의 약 4배에 해당하는 빈 디스크 공간을 남겨 두세요.
1단계 — FirebirdSQL 확인
페이지가 열리면 이 컴퓨터에 FirebirdSQL이 설치되어 있는지, 실행 중인지, 버전이 무엇인지 확인합니다. 기존 프로그램의 데이터는 이 컴퓨터의 FirebirdSQL로 읽습니다. 서버는 이 컴퓨터(localhost)이고, 포트는 3050(설치 시 바꾸었다면 firebird.conf의 RemoteServicePort 값)이며, 사용자는 SYSDBA입니다. 이 항목들은 묻지 않고 비밀번호만 입력받습니다.
| 상황 | 해야 할 일 |
|---|---|
| 설치되어 있지 않음. 화면에 “먼저 FirebirdSQL을 설치하세요.”라고 표시되고 계속할 수 없습니다. | “FirebirdSQL 다운로드 페이지”(firebirdsql.org) 링크에서 FirebirdSQL 3.0, 4.0 또는 5.0을 기본 설정(포트 3050, SYSDBA)으로 설치한 다음 “다시 확인”을 누르세요. |
| 설치되어 있지만 서비스가 실행되지 않음. 경고에 버전과 포트도 표시됩니다. | Windows 서비스를 열고 “Firebird Server - DefaultInstance” 서비스를 시작한 다음 “다시 확인”을 누르세요. |
| 지원되지 않는 버전. “이 FirebirdSQL 버전은 지원되지 않습니다” 경고가 나타납니다. | FirebirdSQL 3.0, 4.0 또는 5.0을 설치하세요. |
| 준비됨. 녹색 테두리 안에 “FirebirdSQL이 설치되어 실행 중입니다”와 함께 버전, localhost:포트, SYSDBA가 표시됩니다. | “계속”을 눌러 2단계로 넘어가세요. |
이 단계에서는 “가져오기 전에 대상 회사의 백업을 받으세요.” 경고도 표시됩니다. 이전에 이전 작업을 한 적이 있다면 “마지막 가져오기 결과 보기” 버튼으로 그 결과를 열 수 있습니다.
2단계 — 원본 파일
파일 선택 버튼은 Windows의 파일 열기 창을 엽니다. 기존 프로그램의 백업(.FBK) 또는 데이터베이스(.FDB)를 선택하세요. .BAK와 .GDB 확장자도 허용됩니다. 다른 종류의 파일을 선택하면 거부됩니다(KAYNAK_DOSYA_TURU).
EK1(이미지 및 문서 데이터베이스, 예: HESAP_EK1.FBK 또는 HESAP.FDB_EK1.FBK)은 따로 선택하지 않습니다. 같은 폴더에서 자동으로 찾아지며, 선택한 파일 아래에 “EK1을 찾았습니다”라고 표시됩니다. 찾지 못하면 “EK1을 찾지 못했습니다. 주 파일만 가져옵니다” 경고가 나타나고 이미지와 문서는 이전되지 않습니다. EK1을 주 파일과 같은 폴더에 넣고 파일을 다시 선택하세요.
HNR이 Windows 서비스로 실행될 때는 브라우저 자체의 파일 선택 창으로 파일을 선택합니다. 이 경우 주 파일과 함께 EK1 파일도 같은 창에서 (Ctrl 키로) 선택하세요. 선택한 파일은 백분율 표시와 함께 이 컴퓨터의 이전 폴더(aktarim\kaynak)로 복사되며, 원본 파일은 건드리지 않습니다.
큰 파일을 위한 빠른 방법: 수 GB 크기의 백업은 먼저 주 파일과 EK1 파일을 이 컴퓨터의 이전 폴더(aktarim\kaynak, 파일을 선택하기 전에 버튼 아래에 전체 경로가 표시됨)에 복사한 다음 파일 선택으로 주 파일만 선택하세요. 폴더에 이미 있는 같은 이름과 크기의 파일은 다시 복사하지 않으며, 화면에 “파일이 이미 가져오기 폴더에 있었으므로 다시 복사하지 않았습니다.”라고 표시되고 EK1은 같은 폴더에서 자동으로 찾습니다. 브라우저에서 업로드하는 큰 파일은 여러 조각으로 나누어 전송됩니다.
파일을 선택한 뒤에는 SYSDBA 비밀번호만 입력합니다. SYSDBA / masterkey는 Firebird의 초기값입니다. Firebird 설치 시 비밀번호를 바꾸었다면 그 비밀번호를 입력하세요.
백업을 UTF-8로 준비하고 연결 / 연결 테스트
백업(.FBK)을 선택했다면 버튼이 백업을 UTF-8로 준비하고 연결로 바뀝니다. 백업은 서버에서 복원되고(“백업을 복원하는 중…”), UTF-8로 변환된 뒤 내용이 검증됩니다(“UTF-8 변환 및 내용 검증…”). 진행 상황은 테이블 수와 행 수로 표시됩니다. 검증을 통과한 사본이 원본으로 사용되며, 원래 백업은 그대로 보존됩니다. 이 작업에는 백업 크기의 약 4배에 해당하는 빈 디스크 공간이 필요합니다.
데이터베이스(.FDB)를 선택했다면 버튼이 연결 테스트로 바뀝니다. 원본에 연결하여 버전, 테이블 수, EK1을 찾았는지 여부를 보여 줍니다. 성공하면 “연결되었습니다 · 버전 … · 테이블 …개”라고 표시되고 목록 읽기 버튼이 활성화됩니다.
3단계 — 테이블 목록과 옵션
목록 읽기는 원본의 모든 테이블을 나열하며, 어느 테이블도 조용히 빠지지 않습니다. 각 테이블에는 다음 네 가지 처리 방식 중 하나가 지정됩니다.
| 처리 방식 | 의미 |
|---|---|
| 객체 | 테이블에서 카드/문서를 만들어 회사 자체의 쓰기 경로로 저장합니다(예: MUSTERI → 거래처 카드). |
| 복사 | 대상에 같은 이름의 테이블이 있으면 공통 열을 행 단위로 복사합니다. |
| 파생 | 복사하지 않습니다. 거래처 잔액이나 재고 수량 같은 값은 쓰기 경로가 다시 만들어 냅니다. |
| 건너뜀 | 시스템 또는 로그 테이블. |
같은 단계에서 이전 옵션을 정합니다.
- 시험 실행 (아무것도 기록하지 않음): 대상에 쓰지 않고 이전을 시험합니다. 건수와 발생할 수 있는 오류를 미리 볼 수 있습니다. 실제 이전 전에 한 번 시험 실행을 하는 것이 좋습니다.
- 삭제된 문서 보관함도 가져오기와 과거 거래 내역도 가져오기: 기존 프로그램의 삭제된 문서 백업과 과거 거래 내역 테이블도 함께 옮깁니다.
- 이미지와 문서(EK1) 가져오기: EK1을 찾았다면 이미지와 문서 파일도 함께 옮깁니다.
- 대상에 데이터가 있어도 계속: 대상 회사에 이미 기록이 있으면 이전은 기본적으로 중단됩니다(
HEDEF_DOLU). 무엇을 하는지 잘 알고 백업을 받아 둔 경우에만 선택하세요. - 배치 크기: 이전이 한 번에 처리하는 기록 수(1–5000, 기본값 200).
문서 번호는 그대로 유지됩니다. 원본의 송장, 수표, 전표 번호가 대상에서도 똑같이 남습니다. 같은 원본을 두 번째로 이전해도 중복 기록은 쓰이지 않고, 이미 있는 기록은 건너뜁니다.
4단계 — 이전과 진행 상황
가져오기 시작은 서버에서 이전을 시작합니다. 화면에는 단계, 백분율, 경과 시간과 함께 테이블별 카드/문서/기록됨/건너뜀/오류 건수, 파일 수, 이전 로그의 마지막 줄이 표시됩니다. 엔진이 여러 스레드를 사용하면 그 수와 내역도 표시됩니다.
이전은 서버에서 계속 진행됩니다. 이 창이나 브라우저를 닫아도 작업은 멈추지 않습니다. 페이지를 다시 열면 진행 중인 이전을 찾아 진행 상황을 보여 줍니다. 중지는 작업을 멈추고 “가져오기를 중지했습니다.”라고 표시합니다.
5단계 — 결과와 대사
이전이 끝나면 “가져오기가 완료되었습니다.”라고 표시되고, 대사 표가 원본과 대상을 비교합니다. 거래처 잔액, 재고 수량, 수표, 송장, 레시피, 파일이 대상입니다. 각 행에는 항목, 출처, 대상, 차이, 상태(일치 / 편차 / 알려진 편차)가 표시되며, 테이블별 결과, 소요 시간, 예시 행 오류, 자동 보정 건수도 함께 나옵니다.
대사에 편차가 있으면 화면에 “가져오기가 끝났습니다 — 다만 대사에 편차가 있습니다.”라고 표시되고 편차가 난 기준이 나열됩니다. 이전된 회사를 사용하기 전에 대사 표를 검토하세요. 기존 시스템 대사 보고서 · PDF 버튼으로 보고서를 PDF로 받거나 인쇄로 인쇄할 수 있습니다.
오류가 난 행의 예시는 “예시 행 오류” 아래에 나열됩니다. 이전을 완료할 수 없으면 자세한 내용은 이전 로그를 확인하세요.
유지 관리 패널
2단계 아래의 유지 관리 패널에는 두 가지 작업이 있습니다.
- 미결 잔액 복구: 기존 프로그램에서 넘어온 송장의 잔여 금액(미결 잔액)이 비어 있으면 거래처 거래 내역으로 다시 계산합니다. 먼저 “미리보기”가 표시되며 아무것도 기록되지 않습니다(바뀔 송장 수, 이전 및 이후 합계, 건너뛴 거래처). 적절하다고 판단되면 “복구 적용”을 누르세요.
- 사전 다시 채우기: 인터페이스 번역에서 빠진 행을 추가합니다. 직접 편집한 번역은 바뀌지 않습니다. 몇 분 걸릴 수 있으니 이 창을 닫지 마세요.
자주 발생하는 오류
오류 메시지에는 서버의 상세 내용과 괄호 안의 오류 코드가 표시됩니다. 예: “백업 준비 도구가 서버에 구성되어 있지 않습니다. — gbak/gfix not found (KAYNAK_HAZIRLIK_AYAR)”. 지원팀에 문의할 때 코드를 함께 알려 주세요.
| 코드 | 의미와 해결 방법 |
|---|---|
FIREBIRD_KURULU_DEGIL | “이 컴퓨터에 FirebirdSQL이 설치되어 있지 않습니다.” FirebirdSQL 3.0, 4.0 또는 5.0을 설치하고 “다시 확인”을 누르세요. |
FIREBIRD_CALISMIYOR | FirebirdSQL이 설치되어 있지만 서버가 실행되지 않습니다. Windows 서비스에서 “Firebird Server - DefaultInstance” 서비스를 시작한 뒤 다시 확인하세요. |
KAYNAK_KIMLIK | “원본 데이터베이스의 사용자 이름 또는 비밀번호가 거부되었습니다.” SYSDBA 비밀번호를 다시 입력하세요. Firebird 설치 시 비밀번호를 바꾸었다면 그 비밀번호를 입력하세요(기본값 masterkey). |
KAYNAK_HAZIRLIK_AYAR | “백업 준비 도구가 서버에 구성되어 있지 않습니다.” 상세 내용에 gbak/gfix not found가 있으면 FirebirdSQL이 설치되어 있지 않은 것이고, Firebird server not running이 있으면 Firebird 서비스를 시작하세요. 설치와 서비스를 확인한 뒤 다시 시도하고, 계속되면 코드를 지원팀에 전달하세요. |
KAYNAK_HAZIRLIK_DISK | “백업을 복원하고 UTF-8 사본을 만들 디스크 공간이 부족합니다.” 이전 폴더가 있는 디스크에 백업 크기의 약 4배에 해당하는 공간을 확보한 뒤 다시 시도하세요. |
KAYNAK_YEDEK_GECERSIZ | “이 파일은 올바른 Firebird FBK/BAK 백업이 아닙니다.” 파일이 손상되었거나 다른 종류일 수 있습니다. 기존 프로그램에서 백업을 다시 받아 선택하거나 FDB 파일을 선택하세요. |
KAYNAK_DOSYA_TURU | “Firebird 데이터베이스 또는 백업 파일만 선택할 수 있습니다(.fbk, .fdb, .bak, .gdb).” 알맞은 확장자의 파일을 선택하세요. EK1 파일을 주 파일로 선택하지 마세요. |
HEDEF_DOLU | “대상 회사에 이미 기록이 있습니다.” 이미 사용한 회사라면 새 회사를 만드는 편이 더 안전합니다. 알고서 계속하려면 먼저 백업을 받고 3단계에서 “대상에 데이터가 있어도 계속” 체크박스를 선택하세요. |
한 회사에서는 한 번에 하나의 이전만 실행됩니다(“이 회사에서 데이터 가져오기가 이미 진행 중입니다.”). 서버가 읽기 전용 모드이면(“쓰기 게이트가 닫혀 있습니다”) 이전이 시작되지 않습니다.
Linux에서
FirebirdSQL은 사용 중인 배포판의 패키지 관리자나 firebirdsql.org에서 설치합니다. gbak과 gfix 도구가 PATH에 있거나 /opt/firebird 아래에 있어야 하며, 나머지 단계는 Windows와 같습니다.
관련 가이드
- 설정 및 로그 - 프로그램을 만들기설정 창에는 측면에서 측면으로 두 가지 유형의 설정이 포함되어 있습니다 : 너만의 (제목, 창의 배열。
- Data Cleanup — A Guide from ScratchOver the years the same customer gets opened two or three times ("ABC Ltd.
- 혼자 사용합니다: 10분 만에 시작하기혼자 프로그램을 쓰는 작은 가게·공방·프리랜서를 위한 안내: 설치부터 첫 송장, 월말까지의 단계입니다.
- 실용적인 사용자 매뉴얼이 페이지는 직원들이 프로그램을 처음으로 사용하고 안전하게 일상 작업을 완료해야합니다.
- 당신의 첫날 - 처음으로 프로그램에 앉아있는 사람들을위한이것은 모든 사람이 읽어야 할 첫 페이지이며, 그것이 필요합니다. 분간.
- 문서 체인 - 프로그램의 배경이 가이드는 하나의 창에 관한 것이 아니라 창문 사이의 링크. 새로 오는 사람의 머리 속의 실제 격차는 "이 버튼이 무엇을 하는가"가 아니라 "나는 인용문을 보。