4.4 KiB
4.4 KiB
라이선스 관리 시스템 사용 가이드 (Usage Guide)
이 문서는 라이선스 관리 시스템을 웹 UI 및 터미널(CLI)에서 사용하는 방법을 설명합니다.
1. 웹 관리 UI 사용법
시스템 배포 후 브라우저를 통해 접속하여 라이선스를 관리할 수 있습니다.
로그인
- 주소:
http://[NAS-IP 또는 도메인]:3006 - 초기 계정:
admin/admin1234
Important
보안을 위해 최초 접속 후 우측 상단 사용자 이름 아래의 '비밀번호 변경' 버튼을 클릭하여 비밀번호를 반드시 수정해 주시기 바랍니다.
라이선스 신규 발급
- 왼쪽 '라이선스 신규 발급' 패널에서 각 항목을 입력하거나 선택합니다.
- 모듈 시스템: 발급 대상 시스템 선택
- 자산 관리 (
asset) - 생산 관리 (
production) - 자재/재고 관리 (
material) - 품질 관리 (
quality) - CCTV 관제 (
cctv)
- 자산 관리 (
- 유형 (License Type):
sub: 정식 구독용 (기본 만료일 365일 자동 설정)demo: 데모 체험용 (기본 만료일 30일 자동 설정)dev: 개발 및 유지보수용 (만료일 제한 없음, 영구)
- 구독자 ID (Subscriber ID): 플랫폼의 [서버 환경 설정] 메뉴에 등록된 ID와 대소문자까지 정확히 일치해야 합니다. (예:
SAMSUNG-01,SOKUREE-DEMO) - 만기 일자 (Expiry Date): 라이선스 종료일 지정 (
YYYY-MM-DD형식,dev유형은 입력 불필요)
- 모듈 시스템: 발급 대상 시스템 선택
- 모든 정보 확인 후 '라이선스 발급' 버튼을 클릭합니다.
라이선스 관리 및 복사
- 검색: 상단 검색바를 통해 특정 구독자 ID를 조회할 수 있습니다.
- 상태 확인:
등록 대기(발급됨),활성화됨(Smart IMS 등록됨) 상태를 확인합니다. - 키 복사: 발급된 라이선스 키의 아이콘을 클릭하여 클립보드에 복사할 수 있습니다.
- 삭제: 필요 없는 라이선스는 쓰레기통 아이콘으로 삭제 가능합니다.
모듈 시스템 설정 (카테고리 관리)
새로운 모듈이 추가되거나 명칭 변경이 필요한 경우 사용자가 직접 수정할 수 있습니다.
- 우측 상단 사용자명 옆의 설정(아이콘) 버튼을 클릭합니다.
- '모듈 카테고리 설정' 창에서 신규 모듈 코드(영문)와 이름(한글)을 입력하여 추가합니다.
- 등록된 모듈은 라이선스 발급 시 선택 목록에 즉시 반영됩니다.
- 더 이상 사용하지 않는 모듈은 목록에서 삭제 가능합니다.
2. 터미널(CLI) 작업 가이드
개발자 또는 관리자가 NAS 터미널(SSH)에서 시스템을 점검하거나 제어할 때 사용합니다.
작업 위치
모든 작업은 프로젝트 루트 디렉토리 및 서버 디렉토리에서 수행합니다.
- 기본 위치:
/volume1/[사용자폴더]/smart_ims_license - 서버 소스:
/volume1/[사용자폴더]/smart_ims_license/server
주요 관리 명령어
서비스 상태 확인 (PM2)
# 전체 서비스 리스트 확인
pm2 list
# 실시간 로그 모니터링
pm2 logs license-manager
# 서비스 재시작 (코드 수정 반영 등)
pm2 restart license-manager
DB 초기화 및 관리
수동으로 DB를 초기화하거나 스키마를 업데이트해야 할 경우 사용합니다.
(작업 위치: server/)
# DB 스키마 생성 및 초기 관리자 생성
node init_db.js
# 테스트 데이터 초기화 (주의: 기존 데이터 삭제될 수 있음)
node reset_test_data.js
환경 변수 수정
DB 접속 정보나 포트를 변경해야 할 경우:
# 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상태인지 확인하세요.