본문으로 건너뛰기

릴리즈 노트

버전별 변경 이력입니다. 최신이 위에 옵니다.

이 문서는 사람이 읽는 문서입니다

박스의 실제 버전은 화면 우측 상단 배지 또는 GET /api/v1/system/version 에서 확인하세요. 버전 판정의 단일 기준은 META-INF/VERSION.JSON 이며, 이 문서를 버전 확인 용도로 쓰지 마세요.

같은 내용을 설치 전에도 볼 수 있습니다 — product.kopens.io/plantpulse-edge/RELEASE-NOTES.md

2026.08​

보안​

  • 인증 없이 PLC 에 값을 쓸 수 있던 통로를 막았습니다. 원격 쓰기 요청은 이제 반드시 인증을 거칩니다. 아울러 로그인 무차별 대입(비밀번호 반복 시도) 차단과 로그인 시 세션 재발급을 추가했습니다.
  • REST 인증 설정이 비어 있으면 이제 차단이 기본입니다. 예전에는 설정이 없으면 인증 없이 열리는 쪽으로 동작했습니다.
  • 연동 키(API 키)가 더 이상 평문으로 방송되지 않습니다. 키를 태그처럼 실어 MQTT·OPC UA· 시계열 저장소로 흘려보내던 경로를 걷어내고, 플랫폼 등록 과정에서만 전달합니다.
  • 설치 이미지에 개발 박스의 신원(엣지 ID)이 섞여 나가던 문제를 바로잡았습니다. 이전 이미지는 설치한 모든 박스가 같은 ID 로 보고할 수 있었습니다. 이제 이미지에서 신원 설정을 제외하고, 빌드가 이를 검사해 섞이면 실패합니다. 설치 파일에도 개발용 설정을 담지 않습니다.

수집 · 저장​

  • 저장 실패가 조용히 넘어가던 구간을 없앴습니다. 여러 건을 묶어 저장할 때 일부가 실패해도 보고되지 않아 데이터가 소리 없이 사라질 수 있었습니다. 이제 실패한 건만 분리해 남깁니다.
  • 큰 정수 값이 변형되던 문제를 고쳤습니다. 64비트 정수 태그의 값이 저장 과정에서 정밀도를 잃던 것을 바로잡았습니다.
  • 값이 빈 문자열로 바뀌는 순간을 놓치지 않습니다. 이전 값이 있다가 빈 값이 된 변화가 유실됐습니다.
  • 삭제한 OPC 연결이 되살아나거나, 주인 없는 수집기가 남아 도는 현상을 정리했습니다. 수집 주기가 유령처럼 중복 실행되던 경우도 함께 잡았습니다.

안정성​

  • 조회량이 많아도 메모리가 터지지 않습니다. 기간 제한 없이 시계열을 조회하면 서버 메모리를 모두 소진할 수 있었습니다. OPC UA 참조가 계속 쌓이던 것과 통신 자원 누수도 함께 고쳤습니다.
  • 부팅 중 한 번 실패하면 영영 복구되지 않던 문제들을 고쳤습니다. 로그 기록기가 멈춘 채로 굳거나, 실제로는 준비되지 않았는데 정상으로 보고하던 상태가 사라졌습니다.
  • 설정 폴더가 없을 때 조용히 기본값으로 뜨지 않습니다. 잘못된 설정으로 운영되는 것을 막기 위해 명확히 실패하고 알립니다.

플랫폼 연결​

  • 박스가 부팅할 때 플랫폼에 스스로 등록합니다. 플랫폼이 잠시 꺼져 있었더라도 연결이 살아나면 자동으로 다시 등록을 시도하며, 현재 등록 상태를 화면에서 확인할 수 있습니다. 이전에는 부팅 시점에 한 번만 시도해, 그때 플랫폼이 내려가 있으면 박스가 목록에 보이지 않은 채 남았습니다.
  • 플랫폼이 접속해 올 주소(콜백 주소)를 설정 화면에서 지정할 수 있습니다. 비워 두면 박스가 자동으로 고릅니다 — 자동 선택 기준을 1번 랜(LAN1)으로 바로잡아, 외부와 통하지 않는 포트가 잘못 선택되던 문제를 없앴습니다.
  • 이중화(HA) 상태에 짝 박스 정보가 함께 보고됩니다. 장애 감지 기본 시간은 2초로 통일했습니다.

릴리즈 구성품​

  • 릴리즈에 개발판 라이브러리가 섞이던 문제를 바로잡았습니다. 이전 릴리즈는 드라이버·수식·PLC 프로토콜 라이브러리를 확정판이 아닌 개발판(SNAPSHOT)으로 실어 나가고 있었습니다. 개발판은 같은 이름으로 내용이 계속 바뀌기 때문에, 같은 버전을 설치해도 박스마다 다른 코드가 들어갈 수 있었습니다. 지금은 릴리즈 빌드가 확정판만 담고, 어긋나면 빌드가 실패합니다.
  • 동봉 라이브러리가 전부 당월 확정판으로 통일됐습니다. 오래된 2026.06 라이브러리가 29개 중 7개 섞여 있던 것을 정리했습니다. 안 쓰는 라이브러리도 함께 걷어내 설치 용량이 줄었습니다.

화면​

  • AI 어시스턴트 답변의 표가 제대로 보입니다. 표가 세로줄(|)이 그대로 노출된 문단으로 뭉개져 나오던 것을 고쳤습니다.
  • 모바일 홈 상단에 엣지 아이디 배지가 표시됩니다. 여러 박스를 오갈 때 지금 보고 있는 게 어느 박스인지 한눈에 구분됩니다.

성능 · 안정성​

  • 메모리 정리(GC) 방식을 세대형으로 바꿔 멈춤이 줄었습니다. 데이터베이스의 최대 멈춤 시간이 630ms 에서 212ms 로, 웹 서버의 전체 정리 횟수는 144회에서 0회로 줄었고 메모리 사용량도 9.9GB 에서 4.1GB 로 내려갔습니다.
  • 시계열 저장 시각의 정밀도 누락을 완결했습니다.

배포 · 다운로드​

  • 제품 다운로드 주소가 product.kopens.io 로 바뀌었습니다. 기존 download.kopens.io 는 발행이 중단됩니다. 오프라인(에어갭) 설치용 이미지도 같은 주소에서 받습니다.

2026.07​

수집 · 저장​

  • 배열 태그가 시계열에 저장됩니다. DInt[4], Word[300] 같은 배열 타입은 그동안 수집은 되는데 시계열 적재 단계에서 통째로 버려지고 있었습니다. 이제 원소별로 펼쳐 TAG_NAME[0] … TAG_NAME[n-1] 독립 메트릭으로 저장되어, 원소별 추이 그래프와 집계가 가능합니다.
  • 알 수 없는 데이터 타입도 더 이상 버리지 않습니다. 지원 목록에 없는 타입이 들어오면 값을 텍스트로 보존하고 경고만 남깁니다. 이전에는 조용히 사라졌습니다.
  • 태그명 규칙이 강제됩니다 — 대문자 · 숫자 · 밑줄(_)만 허용합니다. 백업 복구 시 옛 형식 이름은 자동 변환되며, 무엇이 어떤 이름으로 바뀌었는지 복구 결과 화면에 표시됩니다.

안정성​

  • 서비스가 멈추던 문제를 해결했습니다. 브라우저 탭을 닫아도 서버가 알아채지 못해 연결이 계속 쌓였고, 누적되면 웹 요청 전체가 무응답이 됐습니다. 프로세스와 포트는 살아 있어 감시 도구로는 정상으로 보이는 상태였습니다. 이제 유한 타임아웃과 주기적 확인으로 끊긴 연결을 즉시 정리합니다.
  • 연결 백업 복구가 빨라졌습니다. OPC 43개 기준 120초를 넘겨 실패하던 것이 3초대로 줄었습니다. 복구는 설정 저장까지만 기다리고, 수집기 기동은 뒤에서 이어집니다.
  • 클라이언트가 먼저 연결을 끊는 것은 정상 상황이므로 더 이상 오류로 기록하지 않습니다.

화면​

  • 연결 복구 결과 화면을 새로 만들었습니다. 적용 건수만 보여주던 것을, 건너뛴 항목과 그 사유, 자동 변환된 태그명까지 표로 보여줍니다. 이전에는 일부가 실패해도 "복구 완료"로만 보였습니다.
  • 백업 · 복구 진행 중 로딩 표시를 추가했습니다(수 초간 반응이 없어 중복 클릭을 부르던 문제).
  • 모바일 화면을 정리했습니다 — 검색 결과 없음 안내, 로그 레벨 색상(ERROR 빨강 / WARN 주황), 버튼 아이콘, SUIT 폰트 적용.
  • 화면 이동 13곳에서 발생하던 접근 거부 오류와 로그 다운로드 링크 오류를 고쳤습니다.

기타​

  • AI 채팅이 공식 SDK 기반으로 교체됐습니다(응답 실패 시 기존 방식으로 자동 전환).
  • API 문서(Swagger) 오류를 고쳤습니다.
  • 사용하지 않는 라이브러리를 제거해 설치 용량이 소폭 줄었습니다.

운영자 주의사항​

배열 태그는 원소 수만큼 메트릭을 만듭니다

Word[300] 태그 하나가 메트릭 300개를 생성합니다. 대형 배열 태그를 여러 개 등록할 때는 저장소 부하를 함께 확인하세요.

태그명 규칙 변경

이 릴리즈부터 태그명에 소문자 · 공백 · 특수문자를 쓸 수 없습니다. 기존 태그는 자동 변환되지만, 외부 시스템이 옛 태그명을 참조하고 있다면 확인이 필요합니다.