85 lines
3.3 KiB
Markdown
85 lines
3.3 KiB
Markdown
# 라이선스 관리 시스템 사용 가이드 (Usage Guide)
|
|
|
|
이 문서는 라이선스 관리 시스템을 웹 UI 및 터미널(CLI)에서 사용하는 방법을 설명합니다.
|
|
|
|
## 1. 웹 관리 UI 사용법
|
|
|
|
시스템 배포 후 브라우저를 통해 접속하여 라이선스를 관리할 수 있습니다.
|
|
|
|
### 로그인
|
|
- **주소**: `http://[NAS-IP 또는 도메인]:3006`
|
|
- **초기 계정**: `admin` / `admin1234`
|
|
|
|
> [!IMPORTANT]
|
|
> 보안을 위해 최초 접속 후 우측 상단 사용자 이름 아래의 **'비밀번호 변경'** 버튼을 클릭하여 비밀번호를 반드시 수정해 주시기 바랍니다.
|
|
|
|
### 라이선스 신규 발급
|
|
1. 왼쪽 **'라이선스 신규 발급'** 패널에서 정보를 입력합니다.
|
|
- **모듈 시스템**: 자산관리, 생산관리, 모니터링 중 선택
|
|
- **유형**: SUB(구독형), DEMO(체험판), DEV(영구 프로젝트용)
|
|
- **구독자 ID**: 고객사 식별 ID (예: `SOKUREE-2024-01`)
|
|
- **만기 일자**: 라이선스 종료일 지정
|
|
2. **'라이선스 발급'** 버튼을 클릭합니다.
|
|
|
|
### 라이선스 관리 및 복사
|
|
- **검색**: 상단 검색바를 통해 특정 구독자 ID를 조회할 수 있습니다.
|
|
- **상태 확인**: `등록 대기`(발급됨), `활성화됨`(Smart IMS 등록됨) 상태를 확인합니다.
|
|
- **키 복사**: 발급된 라이선스 키의 아이콘을 클릭하여 클립보드에 복사할 수 있습니다.
|
|
- **삭제**: 필요 없는 라이선스는 쓰레기통 아이콘으로 삭제 가능합니다.
|
|
|
|
---
|
|
|
|
## 2. 터미널(CLI) 작업 가이드
|
|
|
|
개발자 또는 관리자가 NAS 터미널(SSH)에서 시스템을 점검하거나 제어할 때 사용합니다.
|
|
|
|
### 작업 위치
|
|
모든 작업은 프로젝트 루트 디렉토리 및 서버 디렉토리에서 수행합니다.
|
|
- **기본 위치**: `/volume1/[사용자폴더]/smart_ims_license`
|
|
- **서버 소스**: `/volume1/[사용자폴더]/smart_ims_license/server`
|
|
|
|
### 주요 관리 명령어
|
|
|
|
#### 서비스 상태 확인 (PM2)
|
|
```bash
|
|
# 전체 서비스 리스트 확인
|
|
pm2 list
|
|
|
|
# 실시간 로그 모니터링
|
|
pm2 logs license-manager
|
|
|
|
# 서비스 재시작 (코드 수정 반영 등)
|
|
pm2 restart license-manager
|
|
```
|
|
|
|
#### DB 초기화 및 관리
|
|
수동으로 DB를 초기화하거나 스키마를 업데이트해야 할 경우 사용합니다.
|
|
(작업 위치: `server/`)
|
|
```bash
|
|
# DB 스키마 생성 및 초기 관리자 생성
|
|
node init_db.js
|
|
|
|
# 테스트 데이터 초기화 (주의: 기존 데이터 삭제될 수 있음)
|
|
node reset_test_data.js
|
|
```
|
|
|
|
#### 환경 변수 수정
|
|
DB 접속 정보나 포트를 변경해야 할 경우:
|
|
```bash
|
|
# vi 또는 nano 편집기로 .env 수정
|
|
vi .env
|
|
```
|
|
*(수정 후 `pm2 restart license-manager` 필수)*
|
|
|
|
### 수동 라이선스 생성 (CLI 도구)
|
|
웹 UI 없이 터미널에서 즉시 라이선스 키를 생성하고 싶을 때:
|
|
`server/debug_license.js` 등의 도구를 활용할 수 있습니다 (추가 구현 시 제공).
|
|
|
|
---
|
|
|
|
## 3. 문제 해결 (Troubleshooting)
|
|
|
|
- **로그인 실패**: `server/.env`의 `JWT_SECRET`이 설정되어 있는지 확인하세요.
|
|
- **DB 연결 오류**: `server/.env`의 DB 설정 정보와 Synology MariaDB 10의 정보가 일치하는지 확인하세요.
|
|
- **웹 페이지 접속 안됨**: Synology 방화벽에서 3006 포트가 허용되어 있는지, PM2 서비스가 `online` 상태인지 확인하세요.
|