데스크톱 앱은 Windows 와 macOS 에 설치해 사용합니다. 앱은 DB 접속을 맡는 로컬 서버를 기기에서 함께 띄우므로, 사내망이나 기기의 DB 에도 접속할 수 있습니다. 웹 앱은 설치하지 않고 브라우저에서 엽니다. 두 앱의 차이는 웹과 데스크톱 에서 설명합니다.
설치 파일 선택하기
| OS | 설치 파일 |
|---|---|
| macOS, Apple Silicon(M1 이후 칩) | NeoSQL-mac-arm64.dmg |
| macOS, Intel 칩 | NeoSQL-mac-x64.dmg |
| Windows 64비트 | NeoSQL-win-x64-Setup.exe |
- 설치 파일은 NeoSQL 홈페이지에서 다운로드합니다. 홈페이지는 접속한 기기의 OS 를 알아보고 맞는 파일을 먼저 보여 줍니다. 파일은 GitHub 의 NeoSQL 최신 릴리스에서 다운로드합니다.
- Mac 의 칩 종류는 Apple 메뉴 › 이 Mac에 관하여 에서 확인합니다.
- Java 나 JDBC 드라이버를 따로 설치하지 않습니다. 앱 안에 Java 실행 환경, 로컬 서버, 지원하는 DBMS 의 JDBC 드라이버가 들어 있습니다.
macOS 에 설치하기
- 칩에 맞는
.dmg파일을 다운로드합니다. - 다운로드한 파일을 열고 NeoSQL 아이콘을 응용 프로그램(Applications) 폴더로 드래그 앤 드롭합니다.
- 응용 프로그램 폴더나 Launchpad 에서 NeoSQL 을 엽니다. 인터넷에서 다운로드한 앱을 처음 열 때 macOS 가 열지 물으면 열기를 선택합니다.
macOS 설치 파일은 Apple 개발자 인증서로 서명하고 Apple 의 공증을 받아 배포합니다. 홈페이지가 아닌 곳에서 전달받은 파일은 사용하지 마세요.
Windows 에 설치하기
NeoSQL-win-x64-Setup.exe파일을 다운로드합니다.- 다운로드한 파일을 실행합니다. 설치 마법사 없이 바로 설치되고, 설치가 끝나면 NeoSQL 이 열립니다.
- 다음부터는 바탕화면이나 시작 메뉴의 NeoSQL 바로가기로 엽니다.
- 관리자 권한 없이 지금 로그인한 Windows 사용자에게 설치됩니다(
%LOCALAPPDATA%\Programs\neosql). 설치 경로는 선택할 수 없고, 같은 기기의 다른 Windows 사용자는 따로 설치합니다. - 설치 파일은 unvus Co.,Ltd. 명의로 코드 서명되어 있습니다. 서명한 파일이라도 다운로드 기록이 충분히 쌓이기 전에는 브라우저나 Windows SmartScreen 이 경고를 띄울 수 있습니다. 경고 창의 자세한 정보에서 게시자가 unvus Co.,Ltd. 인지 확인한 뒤 실행하세요.
- 회사 기기에서 설치가 차단되면 IT 관리자에게 설치 파일을 허용해 달라고 요청하세요.
- 앱을 제거해도 기기에 저장한 로컬 프로젝트와 설정은 삭제되지 않습니다. 다시 설치하면 이어서 사용할 수 있습니다.
업데이트
자동 업데이트
데스크톱 앱은 시작할 때, 그리고 새 버전이 나왔다는 알림을 NeoSQL 서버에서 받을 때 새 버전이 있는지 확인합니다.
- 새 버전이 있으면 바로 다운로드하기 시작합니다. 업데이트 안내 알림이 표시되고, 다운로드하는 동안 하단 상태바에 진행이 보입니다.
- 다운로드가 끝나면 업데이트 준비 완료 창이 표시됩니다.
- 지금 재시작 버튼: 저장하지 않은 변경이 있으면 먼저 묻고, 앱을 닫아 새 버전을 설치한 뒤 다시 엽니다.
- 나중에 버튼: 지금은 그대로 사용하고, 앱을 종료할 때 새 버전을 설치합니다.
- 나중으로 미루면 헤더의 로고 옆에 vx.y.z 재시작하여 업데이트 버튼이 남습니다. 클릭하면 같은 창이 다시 표시됩니다.
- 업데이트하다 문제가 생기면 오류 알림이 표시되고, 헤더의 로고 옆에 업데이트 오류 표시가 남습니다.
직접 확인하기
- 헤더 왼쪽 끝의 앱 메뉴 단추를 클릭합니다.
- 항목을 클릭합니다.
- 결과를 확인합니다.
| 결과 | 보이는 것 |
|---|---|
| 최신 버전을 사용하고 있습니다 | 최신 버전입니다 알림 |
| 새 버전이 있습니다 | 다운로드하기를 시작합니다. 이미 다운로드해 두었으면 업데이트 준비 완료 창을 다시 띄웁니다. |
| 새 버전은 나왔지만 받을 파일이 아직 없습니다 | 배포본을 아직 찾지 못했습니다 알림. 잠시 뒤 다시 확인하세요. |
| 확인하지 못했습니다(네트워크 문제 등) | 업데이트 확인 실패 알림 |
지금 사용하는 버전은 헤더의 로고 옆에 v 로 시작하는 숫자로 보입니다.
릴리즈 노트
- 새 버전으로 처음 시작하면 릴리즈노트 — x.y.z 창이 한 번 표시됩니다. 처음 설치한 뒤 첫 실행에도 표시됩니다. 창을 닫거나 확인 버튼을 클릭하면 안내한 버전에서는 다시 표시되지 않습니다.
- 한국어 화면에서는 한국어 릴리즈 노트를 보여 주고, 한국어가 없으면 영어를 보여 줍니다. 영어 화면에서는 영어 릴리즈 노트만 보여 줍니다.
- 릴리즈 노트를 받지 못하면(인터넷이 차단된 경우 등) 창이 표시되지 않습니다.
웹 앱의 업데이트
웹 앱은 설치하지 않으므로 직접 업데이트할 것이 없습니다. NeoSQL 이 새 버전을 배포하면 열어 둔 웹 앱에 새 버전이 배포되었습니다 안내가 표시됩니다. 작성 중인 내용을 저장한 뒤 새로고침 버튼을 클릭하면 새 버전으로 다시 열립니다.
인터넷이 차단된 환경에서 사용하기
데스크톱 앱은 로그인하지 않으면 인터넷 없이도 사용할 수 있습니다. 로컬 프로젝트는 기기에 저장되고, 로컬 서버가 기기에서 돌며, DB 에는 기기에서 바로 접속합니다.
| 할 일 | 인터넷이 차단된 환경에서 |
|---|---|
| 설치 | 인터넷이 되는 기기에서 설치 파일을 다운로드해 옮겨 설치합니다. |
| 업데이트 | 새 버전 확인(NeoSQL 서버)과 다운로드하기(GitHub) 모두 인터넷이 필요합니다. 접속할 수 없으면 오류 없이 넘어갑니다. 새 버전은 IT 관리자가 새 설치 파일로 배포하고, 새 설치 파일로 다시 설치해도 프로젝트와 설정은 보존됩니다. |
| 로그인과 계정 프로젝트 | 사용할 수 없습니다. 로그인은 브라우저에서 NeoSQL 서버에 접속해야 합니다. |
| Store | 홈의 스토어에서 가져오기 메뉴로 공개 템플릿 팩과 도메인 팩을 받을 수 없습니다. |
| 릴리즈 노트와 공지 | 보이지 않습니다. |
- 앱이 외부와 주고받는 통신(사용 통계, 업데이트 확인, 공지 조회)은 접속할 수 없어도 조용히 넘어가고 작업을 차단하지 않습니다. 무엇이 나가는지는 보안과 데이터가 나가는 곳 에서 설명합니다. 사용 통계는 화면의 사용 통계 전송 항목에서 비활성화합니다.
- 로컬 서버는 기기 안(127.0.0.1)에서만 접속을 받습니다. 포트는 52080 번부터(NeoSQLEnterprise 는 52180 번부터) 비어 있는 번호를 찾아 사용합니다.
관련 페이지
- 처음 실행하기: 설치한 뒤 첫 프로젝트를 만드는 순서입니다.
- 웹과 데스크톱: 두 앱에서 사용할 수 있는 것과 없는 것입니다.
- 보안과 데이터가 나가는 곳: 앱이 기기 외부로 보내는 정보입니다.