mySysPortal — DVHAM

dvham 프로그램 구조dvham program map

/opt 폴더pm2systemdcron웹 주소파일 · 폴더설명

dvham (Ubuntu, Apache 2.4 · pm2 · fail2ban)
│
├─ /opt/dvhamCore ············ pm2 dvhamCore   통합 백엔드 (BM 로그인, Admin 2단계, LogBook, 설정 편집기)
│   ├─ src/ web/ scripts/ data/ migrations/
│   └─ cron 09:00 scripts/droidstar-watch.js
│
├─ /opt/dvex ·················· 데이터 수집 · API
│   ├─ expressServer7012.js ·· pm2 ex7012       API (+ expressVersionManagerApi.js /api/vmgr)
│   ├─ mqttlh/lhdmr.js ······· pm2 mqttLHDMR    DMR last heard
│   ├─ mqttlh/lhdvref.js ····· pm2 mqttLHDVREF  반사기 last heard
│   ├─ makeHosts.js ·········· cron 19:20 → Hosts/
│   ├─ qsorank/ ·············· QSO 순위 JSON (cron 02:24 일별 파일 정리)
│   └─ dvinfo/ config/ json/ log/
│
├─ /opt/svcAppWeb ············· 서비스별 웹 (Apache Alias)
│   ├─ mySysPortal/ ·········· /mySysPortal (이 목록), /mySysPortal/<보기> = DVHAM Monitor
│   ├─ dvhamPortal/ ·········· / (포털), /servertip
│   ├─ kUSRP/ ················ /kusrp · 버전관리 · kusrpUsers · download|image|info/kUSRP
│   ├─ USRP/ ················· /usrp · 버전관리 · usrpUsers · download|image|info/USRP
│   ├─ HomeAssistant/ ········ /homeassistant
│   └─ md380-firmware/
│
├─ /opt/dvsw ·················· /dvsw 공개 폴더 (작업 폴더는 .htaccess 로 막음)
│   ├─ dvswitch/
│   │   ├─ kdvs/v1/ ·········· kdvs 배포 (install.sh · amd64 · arm64 · armhf)
│   │   ├─ dvsmu/web/ ········ dvsmu-web 배포
│   │   └─ STFU/ tgdb/ dvsw/ DVS_Dashboard/ AR-modes/ AR_patch/
│   ├─ kdvs/ · dvsmu/ ········ 작업 폴더
│   ├─ userInfo/ ············· PHOTO · FLAG (kdvs · USRP 카드)
│   ├─ FreeDMR/ dvref/ dvsys/ rpi/ setup/ manual/ program/ scripts/ Vocoder/ vumeter/
│   └─ lhmon*.html · *Mqtt.html · dvsysMonitor.html · myHomeAuto.html …
│
├─ /opt/dvham ················· 예전 웹 루트 (dvham.html → /mySysPortal/all)
│   └─ watch/ ················ pm2 watchSvc
│
├─ /opt/mqstat ················ pm2 mqstat7014   기기 접속 통계 (/mqstat)
├─ /opt/dvauth ················ pm2 dvauth        BrandMeister 로그인
├─ /opt/lvmon ················· pm2 webrx         LVMON
├─ /opt/lhmon
├─ /opt/geoip-monitor ········· pm2 geoip
├─ /opt/svcRadioMusic ········· pm2 svcRadioMusic7010
├─ /opt/wsPdfReader(My) ······· pm2 pdf7007 · pdf7008
├─ /opt/sysInfo ··············· systemd sysInfo.service
│
└─ cron
    ├─ 19:20 makeHosts.js
    ├─ 02:21~02:25 로그 정리 (pm2 로그 · *.gz · qsorank 일별 · journal 3일)
    └─ 09:00 droidstar-watch.js

2026-11-07 기준 · /opt, pm2, systemd, Apache, cron 에서 정리As of 2026-11-07 · from /opt, pm2, systemd, Apache and cron

mySysPortal

🛡 dvham 이중화 (dvham ↔ dvham-sub) 운영 안내

상태 확인 중…

2026-11-08 구축 · 평소엔 신경 쓸 일 없음 — dvham 이 죽으면 dvham-sub 가 약 15초 안에 자동으로 이어받습니다. 복귀(failback)만 사람이 합니다.

구성 동작 명령 상황별 동기화 주의 오늘 작업 파일

1. 구성 한눈에

dvham192.168.0.11 · HP t630 · Ubuntu 24.04주 서버 (ACTIVE) · 우선순위 150

dvham-sub192.168.0.12 · HP t630 · Ubuntu 24.04대기 서버 (STANDBY) · 우선순위 100 · 이름 DVHAM-Sub

VIP 192.168.0.13가상 IP — 지금 일하는 서버가 가짐공유기 포트포워드 7개 · LAN sysInfo · PC 모두 이 주소로

t620 (dvt620)192.168.1.11 · Debian 13AllStarLink 54866 · allmon3 · FreeDMR (이중화 대상 아님)

🌐 인터넷 → ipTIME 공유기포트포워드 80 443 1883 7010 7012 7015 9001

▼

VIP 192.168.0.13지금 ACTIVE 인 서버가 가짐

▼

dvham .11 — ACTIVE웹 · MQTT · Kakao · cron 모두 동작

5분마다 rsync + DB 스냅샷 ▶

dvham-sub .12 — STANDBY웹 앱만 대기, 데이터 받기만

2. 어떻게 동작하나

keepalived (VRRP) 가 두 서버 사이에서 1초마다 신호를 주고받습니다 (unicast, VRID 13, nopreempt).
dvham 신호가 끊기면 → dvham-sub 가 VIP .13 을 가져가고 dvham-promote.sh 가 자동 실행 → 약 15초 뒤 sub 가 ACTIVE.
ACTIVE 서버에서만 도는 것: watchSvc (Kakao)mqttLHDVREFmqttLHDMRwebrx사용자 crontabcertbot. 나머지 웹 앱은 양쪽 모두 상시 실행.
nopreempt 라서 dvham 이 다시 켜져도 VIP 를 자동으로 빼앗지 않습니다 → 복귀는 dvham-failback.sh 로 직접.
VIP 를 누가 가질 수 있는지는 /etc/keepalived/dvham-hold (0 = 가질 수 있음, 1 = 양보) 로 정합니다. 스크립트가 알아서 바꿉니다.
전환·복귀 때 Kakao 알림: [dvham-sub] ACTIVE 전환[dvham] ACTIVE 복귀

3. 자주 쓰는 명령 (모두 dvham-sub 에서)

하고 싶은 일	명령	시간
지금 상태 보기 (누가 ACTIVE? VIP? 동기화?)	`ssh dvham-sub` `sudo dvham-role`	즉시
계획 전환 — dvham 리부팅·점검 전에 sub 로 넘기기	`sudo dvham-promote.sh --planned`	약 30초
복귀 — sub → dvham 으로 되돌리기 (자동 전환 뒤에도 이것)	`sudo dvham-failback.sh`	약 35~40초
미리 보기만 (실제로 아무것도 안 바꿈)	`sudo dvham-promote.sh --dry-run` `sudo ASSUME_ACTIVE=1 dvham-failback.sh --dry-run`	즉시
지금 바로 동기화 한 번	`sudo dvham-sync.sh`	약 25초
자동 전환 끄기 (점검 중 원치 않는 전환 막기)	`echo 0 \| sudo tee /etc/keepalived/dvham-auto` `echo 1 \| sudo tee /etc/keepalived/dvham-hold`	즉시
자동 전환 켜기 (현재 상태 = 켜짐)	`echo 1 \| sudo tee /etc/keepalived/dvham-auto` `echo 0 \| sudo tee /etc/keepalived/dvham-hold`	즉시
로그 보기	`tail -f /var/log/dvham-role.log` (전환) `tail -f /var/log/dvham-sync.log` (동기화)

4. 상황별로 할 일

🔧 dvham 을 리부팅·업데이트·점검할 때

sudo dvham-promote.sh --planned (sub 에서)
dvham 작업 · 리부팅
dvham 이 다 올라오면 sudo dvham-failback.sh
sudo dvham-role 로 standby 확인

⚡ dvham 이 갑자기 죽었을 때 (정전·고장)

할 일 없음 — 15초 안에 sub 가 자동 ACTIVE, Kakao 로 알림
dvham 을 고치고 켬 (BIOS 전원 복구 = On 으로 설정됨)
dvham 정상 확인 뒤 sub 에서 sudo dvham-failback.sh

📨 Kakao "동기화 실패" 알림이 왔을 때

5분 주기 동기화가 3번 연속 실패한 것 (그 뒤 1시간마다 다시 알림)
tail -50 /var/log/dvham-sync.log 로 원인 확인 (dvham 꺼짐·ssh·디스크)
고쳐지면 자동으로 "복구됨" 알림

🔧 dvham-sub 를 리부팅·점검할 때

그냥 해도 됨 — 서비스 영향 없음 (VIP 는 dvham 에 있음)
올라온 뒤 sudo dvham-role 로 BACKUP · 동기화 확인

5. 동기화 — 무엇이 넘어가고 무엇이 안 넘어가나

✅ 자동으로 넘어감 (5분마다)

/opt 전체 (삭제도 반영)
/home/ubuntu (.ssh · .pm2 제외)
/opt/dvsw/userInfo
SQLite DB — 안전한 온라인 백업으로 스냅샷 (dvhamcore.db, mqstat.db 등) → 전환 때 적용
dvham /etc · crontab 은 sub 의 /root/from-dvham/ 에 보관 → 전환 때 apache · letsencrypt · mosquitto 적용

❌ 자동으로 안 넘어감 — 직접 양쪽에!

apt 패키지 새로 설치
systemd 서비스 추가·변경
pm2 앱 새로 추가 (양쪽에 등록, ACTIVE 전용이면 active-apps.json 에도)
Apache 사이트 새로 enable (설정 파일은 넘어가지만 a2ensite 는 직접)
/opt/sysInfo/sysInfo.txt (서버마다 다름: DVHAM-Main / DVHAM-Sub)
/opt/dvham/watch/outbox (Kakao 중복 방지)
/opt/dvsw (DVSwitch · kdvs 는 이중화 대상 아님)

6. 꼭 기억할 것

sub 가 ACTIVE 인 동안 바뀐 데이터는 failback 때 dvham 으로 되돌려 보냅니다 (DB 포함, dvham 옛 DB 는 ~/backup-failback-* 에 보관). failback 은 꼭 sub 에서 실행.
공유기: 포트포워드 7개 (80 443 1883 7010 7012 7015 9001) 는 .13 으로. ipTIME 은 NAT 루프백이 없어 서버·PC 는 /etc/hosts 로 dvham.freeddns.org 를 내부 주소로 씁니다. .13 은 DHCP 등록 불필요.
PC (.10) hosts: 192.168.0.13 dvham.freeddns.org (kUSRP.exe · KPi.exe 용). AhnLab Safe Transaction 이 hosts 를 0 바이트로 지울 수 있음 → 백업 hosts.bak-20261108 에서 복원.
LAN sysInfo: V2026.11.08-01 부터 192.168.0.x 에서는 VIP .13 (실패 시 .11 → .12) 로 MQTT 접속. 옛 버전은 .11 고정이라 전환 때 끊김.
BIOS: dvham 은 After Power Loss = On (11-08 수정, 예전 정전 장애 원인). t620 · dvham-sub 도 On.
스크립트 수정은 dvham-sub 의 /usr/local/bin 에서. dvham 쪽엔 /usr/local/sbin/dvham-vrrp-notify.sh 만 있음.

7. 오늘(2026-11-08) 한 일

오전	dvdeb(.1.12) ASL · FreeDMR 를 PC 에 백업, 옛 t620 전체 백업 (약 50 GB)
18:17	t620 (192.168.1.11) Debian 13 새로 설치 → ASL 54866 · allmon3 · FreeDMR 이전, 공유기 포워드 .1.11 로
저녁	dvdeb → Ubuntu 24.04 dvham-sub (192.168.0.12) 로 재설치, /opt · home · 설정 첫 복사
	5분 동기화 + DB 스냅샷, promote / demote / failback 스크립트, keepalived VIP .13, 공유기 포워드 7개 → .13
	sysInfo V2026.11.08-01 배포 (LAN 에서 VIP 접속), sysInfo.txt 동기화 제외, 이름 DVHAM-Sub
21:35	1차 실전 전환 — 503 발견 (sub 의 dvsw vhost 꺼짐) · 옛 MQTT 접속 잔류 → 수정
22:04	2차 수동 전환 ✅ promote 31초 · failback 33초 (kUSRP 약 28명 접속 중)
22:22	3차 자동 전환 ✅ dvham 장애 → 15초 만에 sub ACTIVE · failback 34초 → 자동 전환 켬
22:38	dvham 실제 리부팅 (커널 6.8.0-147) — 계획 전환 32초 · failback 41초 ✅, BIOS 전원 복구 Off → On
밤	PC hosts → .13, 동기화 실패 Kakao 알림 추가

정리할 것 (11-12 무렵, 승인 후): sub /var/lib/dvham-sync/promote-*, dvham ~/backup-failback-*, PC D:\backup\dvdeb-20261108 · t620-20261108.

8. 파일 위치

파일	내용
`/usr/local/bin/dvham-sync.sh`	5분 동기화 + 실패 알림 (cron `/etc/cron.d/dvham-sync`)
`/usr/local/bin/dvham-promote.sh`	sub → ACTIVE (`--planned --dry-run --no-sync --force`)
`/usr/local/bin/dvham-failback.sh`	dvham 으로 복귀 (`--dry-run --yes`)
`/usr/local/bin/dvham-demote.sh`	sub → STANDBY (failback 이 자동 호출)
`/usr/local/bin/dvham-role`	상태 보기
`/usr/local/lib/dvham-sync/active-apps.json`	ACTIVE 전용 pm2 앱 4개
`/etc/keepalived/keepalived.conf` · `dvham-hold` · `dvham-auto`	VIP 설정 · 보유 허용(0/1) · 자동 전환(1=켬)
`/usr/local/sbin/dvham-vrrp-notify.sh`	VIP 이동 때 실행 (양쪽 서버)
`/var/lib/dvham-sync/`	DB 스냅샷 · 알림 상태 · promote 백업
PC `D:\claude\dvham2-ubuntu-setup.md`	전체 작업 기록 (t620 은 `t620-debian-setup.md`)