teraWeb/demo-guide/07-system-improvements-20260914.md

2026-09-14 수정본 확인 절차

현재 상태: 192.168.0.223 장비 배포 완료, 준비 상태 12/12 및 바이너리 해시 일치 확인. 대시보드 위치는 사용자 정정에 따라 1~48번으로 고정했습니다. 아래 절차로 실제 기능을 확인합니다. 기존 문서의 포트 고급 설정, 별칭 위치, 로그 삭제 확인 문구는 이 문서로 대체합니다.

현재 환경의 기준은 관리 주소 192.168.0.223, PC 192.168.0.100, 외부 장비가 연결된 CH20입니다. eth1의 192.168.200.4는 이전 DHCP 주소이므로 적용 전 네트워크 화면에서 다시 확인합니다. COM4는 TERA 관리 콘솔이며 CH20 송수신 시험 창과 다릅니다.

기능	UI 설정·시험	확인할 결과
별칭	포트 상태 → 포트 별칭에서 CH20 선택 → 구분 가능한 긴 이름 입력 → 변경	다시 CH20을 선택해 같은 이름 확인. 대시보드 포트 위치는 1~48번으로 고정되고 채널·상태가 같은 줄에 표시. 아래 별칭은 넘칠 때 …, 마우스를 올리면 전체 이름 표시
상태·이벤트	포트 상태 표와 로그 → 포트 상태 이벤트 확인	별칭 열과 이벤트의 채널 옆 별칭 표시. 링크 변화가 없으면 새 이벤트가 생기지 않아도 정상
설정 변경	포트 설정에서 다른 채널의 개별 보기 선택 → 해당 채널 설정 변경	기존 채널의 설정을 PATCH로 변경. 개별 보기로 이동하면 이전의 다중 변경 대상이 따라붙지 않음. 여러 채널 적용은 ‘변경 대상’을 명시적으로 선택
포트 설정 탭	Port 1 설정을 열고 포트 선택에서 26 클릭	기존 탭의 같은 위치에서 ‘포트 26 설정’으로 바뀌며 탭이 추가되지 않음. 새로고침해도 포트 설정 탭은 하나만 유지
변경 대상 체크박스	확대된 카드에서 ‘변경 대상’ 옆 체크박스를 선택·해제	체크와 카드 선택색이 함께 바뀜. 카드 위쪽 숫자는 개별 설정 전환, 아래 체크박스는 여러 포트의 변경 대상 선택
포트 선택 별칭	포트 상태 화면에서 별칭을 설정한 후 포트 설정으로 이동	선택 카드의 번호·상태 아래에 같은 별칭 표시. 긴 이름은 …, 마우스를 올리면 전체 이름 확인
순간적인 응답 누락	CH20·CH26을 연결한 채 대시보드와 상태 이벤트를 관찰	마지막 CR 응답 후 15초 이내의 일시적인 누락은 UP 유지. 계속 응답이 없으면 Unknown(미확인). CR 무응답만으로 케이블이 끊겼다고 판단하거나 DOWN 알림을 발생시키지 않음
동작 1	포트 설정 → CH20 → 동작 설정 1 · eth0에서 Reverse SSH, 최대 세션 2 설정	Listen Port는 10020 고정. PC PuTTY에서 관리 주소 192.168.0.223, SSH, 포트 10020으로 접속. 장비에 등록된 로그인 계정 사용
동작 2	동작 설정 2 · eth1에서 Reverse Telnet 설정	Listen Port 10020, 최대 세션 2가 읽기 전용으로 표시. 두 설정을 합쳐 2개까지 접속 가능
동작 2 충돌 수정	CH01의 동작 1을 SSH로 두고 동작 2를 Telnet으로 설정 → 적용	두 인터페이스의 Listen Port 10001이 함께 허용됨. operation_1 and operation_2 포트 충돌 오류가 발생하지 않아야 함. 데이터 로그의 형식 이름은 ASCII·HEX로 표시
합산 제한	위 SSH 연결을 유지하고 eth1 주소의 10020에 Telnet으로 접속. 그 뒤 세 번째 연결 시도	앞의 두 연결은 유지되고 세 번째는 Too many clients로 거절. 포트 상태에서 세션 1·2 IP 확인. 하나를 종료하면 해당 칸이 비워지고 다시 연결 가능
eth1 접근 조건	PC에서 현재 eth1 주소까지 통신 가능한지 먼저 확인	지금 PC가 관리망에만 연결돼 있고 eth1 경로가 없으면 SSH/Telnet 혼합 시험은 아직 수행할 수 없음. 이것을 세션 제한 실패로 판정하지 않음. 관리망의 SSH 두 창으로 총 세션·IP 표시부터 시험 가능
수신 로그	CH20 → 데이터 로그에서 Receive 기록, ASCII 선택. CH20 상대 장비의 기존 인터페이스 입력 화면에서 d 입력	Invalid interface가 실제 수신되어 포트 로그에 표시. 줄바꿈과 ASCII 대소문자 유지. HEX로 바꾸고 같은 동작을 반복하면 A~F 대문자 표시
키워드 알림	기타 설정 → 알림 설정 → 시리얼 이벤트, CH20, 수신 키워드 감지 켜기, Invalid interface, 메일 전달 켜기 → 적용	같은 CH20 화면에서 d 입력 후 감지·메일 결과 확인. 삭제된 포트 고급 설정 탭으로 이동하지 않음. SMTP 자체 전달 여부는 기존 Gmail → Daum 메일 시험으로 먼저 확인
로그 삭제	관리자 로그인 → 로그 화면에서 대상 선택 → 로그 클리어 → 현재 로그인 계정의 비밀번호	틀린 비밀번호는 거절, 기존 로그 유지. 올바른 비밀번호는 지정 범위 삭제. 취소는 삭제 요청을 보내지 않음
전체 삭제 범위	포트 로그에서 전체 포트 선택 / 상태 이벤트 / 시스템 로그를 각각 시험	포트 통신 로그 전체 / 상태 이벤트 전체 / 시스템·감사 로그가 각각 삭제. 필터 기간·화면 표시 개수와 무관하며, 새로 발생한 로그는 계속 저장
관리자 제한	포트 운영자로 로그인	포트 로그 메뉴·데이터 로그 설정 탭 접근 불가. 관련 API 변경도 관리자 권한 필요
저장 공간	로그 화면의 저장 공간 확인	90% 고정 표시. 파일시스템 최소 10% 여유 공간을 확보하고, 클래스별 저장 한도나 여유 공간 한도에 걸리면 오래된 로그 세그먼트부터 회수. 원격 전송만 켜더라도 기존 기본 로컬 기록은 유지
직접 연결	직접 연결 모드 열기	기존 포트 디버그의 새 이름. 데이터 형식 선택은 ASCII, HEX 순서. 내려받은 직접 연결 기록도 ASCII 다음 HEX
진단	관리자 운영 → 진단 도구에서 PC 192.168.0.100 핑	진단 결과 표시. 별칭 편집 항목 없음. 네트워크 고급 설정은 유지
백업·복원	현재 설정 백업 → 구분 가능한 별칭 변경 → 백업 복원	복원 적용·영구 저장 성공 후 ‘복원 완료’ 알림과 자동 재시작. 재접속해서 백업 당시 별칭 확인. 복원이 실패하면 재시작하지 않음
초기화	백업 확보 후 공장 초기화 → 현재 계정 비밀번호 → 최종 확인 버튼	문자 ‘공장 초기화’ 입력 불필요. 잘못된 비밀번호로는 초기화되지 않음. 승인·인증 성공 후 초기화 및 재시작

비밀번호 변경은 사이드바 메뉴만 제거했습니다. 최초 로그인 필수 변경과 관리자의 계정 비밀번호 재설정은 유지한 상태입니다.

검증 범위

• 백엔드 전체 Go 테스트 통과. 이후 수정한 API·저장소·로그 정책·포트 서비스도 재검증했습니다.
• 프런트엔드 전체 Go 테스트 통과.
• Edge의 로컬 시험 데이터로 대시보드 고정 위치·말줄임표, 포트 상태의 세션 IP 4열, 별칭 PATCH, 동작 2 세션 읽기 전용, 삭제 비밀번호 입력·취소를 확인했습니다.
• Linux ARM64 실행 파일 3종을 만들었습니다. .pkg 펌웨어 패키지나 장비 배포 완료를 뜻하지 않습니다.
• 추가 수정본은 API·웹을 다시 배포했습니다. 포트 위치 1~48 유지, 기존 포트 탭 통합, 체크박스 선택·해제와 새로고침, 1440/1024/800/480px 화면 너비, 콘솔 아이콘 제거를 로컬 Edge에서 확인했습니다. 장비 준비 상태 12/12 및 설치 파일·정적 JS 해시 일치를 확인했습니다.
• 장비 CH26에서 100ms 응답 대기 두 번 실패 후 다음 주기 정상 응답을 직접 관찰했습니다. 15초 재확인 및 지속 무응답의 미확인 판정은 Go 회귀 테스트로 검증했습니다. 케이블을 실제로 뽑는 시험은 진행하지 않았습니다.
• eth0/eth1 동일 포트 바인딩은 장비의 일반 사용자 권한으로 검증했습니다. 실제 SSH/Telnet 혼합 접속, 실제 저장 공간 회전, 실제 복원·초기화 후 재부팅은 장비에 실행하지 않았습니다. 종전 부팅 지연도 해결됐다고 판정하지 않았습니다.