이 문서가 해결하는 문제#
새벽 세 시에 전송이 멈춰 있습니다. 누군가 일어나서 판단해야 합니다.
- 대상 장비의 디스크가 찼습니다. 기다릴까요, 이 장비만 건너뛸까요?
- 보내는 중에 원본 파일이 바뀌었습니다. 다시 보낼까요, 건너뛸까요?
- 어제 실행이 아직 안 끝났는데 오늘 예약 시각이 됐습니다. 겹쳐 돌릴까요, 이번은 건너뛸까요?
이 판단을 미리 적어 두는 자리가 Error handling 입니다. 적어 두면 사람이 깨지 않아도 INNORIX가 그대로 처리하고, 무엇을 왜 그렇게 했는지 실행 기록에 남깁니다.
그리고 아홉 가지는 아예 정할 필요가 없습니다. INNORIX가 늘 알아서 처리합니다.
적용 대상과 대표 상황#
| 누가 | 언제 |
|---|---|
| 운영 담당자 | 야간, 주말에 무인으로 도는 전송을 맡을 때 |
| 시스템 관리자 | 장비가 많아 일부는 늘 문제가 있는 환경일 때 |
| 보안, 감사 담당자 | 문제가 났을 때의 처리가 정책과 맞아야 할 때 |
시작 전 준비#
- Flow 하나와 수정 권한.
- 성공 조건을 먼저 정해 두면 좋습니다. 조치가 성공 판정에 영향을 주기 때문입니다. 전송 성공 조건을 Assurance Contract로 정의하기 를 먼저 보세요.
설정하는 자리#
- Flows → Flow 선택 → Edit flow.
- 도구줄의 Assurance 배지를 누릅니다.
- 창 아래쪽 Error handling 을 폅니다. 요약줄은 INNORIX 권장값 그대로일 때
INNORIX recommended, 다른 것이 있으면N custom으로 뜹니다. - 묶음마다 이슈가 있고 이슈마다 조치를 고릅니다.
- Apply 를 누르고 창을 닫은 뒤 Save & activate 로 저장합니다.
위쪽
Success conditions줄의 Reset to defaults 는 성공 조건만이 아니라 여기 정한 조치까지 함께 되돌립니다. 돌아가는 자리는 이 워크스페이스의 기본값입니다. 워크스페이스에 따로 정한 것이 없으면 INNORIX 권장값으로 갑니다. 창의 Cancel 은 창을 열었을 때의 값으로 돌려놓습니다.
정할 수 있는 것#
아래 표의 "기본 조치" 는 INNORIX 권장값입니다. 그대로 두어도 됩니다.
먼저 읽어 주세요. Flow 가 실제로 시작하는 값은 이 워크스페이스의 Assurance 기본값입니다. 워크스페이스에서 조치를 바꿔 두었다면 아래 표와 다른 값으로 시작합니다.
구별하는 방법이 있습니다.
보이는 것 뜻 줄 옆 배지가 Default그 줄은 INNORIX 권장값 그대로 줄 옆 배지가 Workspace그 줄은 워크스페이스 기본값에서 왔음 Flow 이름 옆 배지가 Workspace defaults이 Flow 는 워크스페이스 기본값을 그대로 쓰는 중 Error handling 요약줄이 아무것도 바꾸지 않았는데 N custom정상입니다. 이 요약은 INNORIX 권장값과 비교하므로, 워크스페이스가 정해 둔 값도 "다름" 으로 셉니다 워크스페이스 기본값은 워크스페이스 설정의 Assurance defaults 에 있습니다. 누구나 볼 수 있고, 바꾸는 것은 워크스페이스 소유자나 관리자만 할 수 있습니다.
Network#
| 이슈 | 기본 조치 | 뜻 |
|---|---|---|
Insufficient storage |
Keep retrying |
대상 디스크가 찼습니다. 공간이 생길 때까지 계속 다시 시도합니다 |
Recovery not progressing |
Keep retrying |
복구가 진척되지 않습니다. 계속 시도합니다 |
Source#
| 이슈 | 기본 조치 | 뜻 |
|---|---|---|
Source changed |
Transfer the file again |
보내는 중 원본이 바뀌었습니다. 바뀐 내용으로 다시 보냅니다 |
Source deleted |
Skip the file |
원본이 사라졌습니다. 그 파일만 건너뜁니다 |
Source file in use |
Skip the file |
다른 프로그램이 쓰고 있습니다. 그 파일만 건너뜁니다 |
Destination#
| 이슈 | 기본 조치 | 뜻 |
|---|---|---|
Destination file exists |
Keep both |
같은 이름이 있습니다. 둘 다 남깁니다. 창이 적어 둡니다 — "Set in each step's save options." 즉 실제 규칙은 단계의 저장 옵션에서 정합니다 |
Destination file in use |
Skip the file |
대상 파일을 다른 프로그램이 쓰고 있습니다 |
File system naming conflict |
Skip the file |
파일 시스템이 받을 수 없는 이름입니다 |
Schedule and time#
| 이슈 | 기본 조치 | 뜻 |
|---|---|---|
Schedule overlap |
Skip this run |
앞 실행이 안 끝났는데 예약 시각이 왔습니다. 이번 회차를 건너뜁니다 |
Deadline missed |
Continue |
기한을 넘겼습니다. 전송은 계속합니다. 다만 Contract는 위반으로 판정됩니다 |
고를 수 있는 조치#
| 조치 | 무엇이 일어나나 | 언제 |
|---|---|---|
Keep retrying |
될 때까지 계속 시도 | 일시적인 문제. 공간 부족, 잠깐의 점유 |
Retry later |
나중에 다시. 그동안 다른 파일은 멈춰 두고 기다립니다. 끝내 안 되면 그 파일을 건너뜁니다 | 곧 풀릴 것이 확실할 때 |
Transfer the file again |
그 파일을 처음부터 다시 | 원본이 바뀌었을 때 |
Skip the file |
그 파일만 빼고 나머지는 진행 | 한 파일 때문에 전체를 멈출 수 없을 때 |
Skip this device |
그 장비만 빼고 나머지 장비는 진행 | 장비 하나의 문제가 배포 전체를 막으면 안 될 때 |
Skip this run |
이번 회차를 통째로 건너뜀 | 예약이 겹쳤을 때 |
Queue one |
이번 회차를 거르지 않고 줄 세움. 앞 실행이 끝나면 이어서 돈다 | 거르면 안 되는 회차일 때 |
Continue |
기록만 남기고 그대로 진행 | 알고는 있어야 하지만 멈출 일은 아닐 때 |
Stop the run |
실행을 멈춤 | 더 진행하면 위험할 때 |
Request review |
사람이 볼 때까지 대기 | 자동으로 정하면 안 되는 판단 |
Keep both |
같은 이름을 둘 다 남김 | 덮어쓰면 안 될 때 |
Overwrite |
같은 이름을 덮어씀 | 늘 최신만 있으면 되는 때. Destination file exists 에서만 고를 수 있습니다 |
이슈마다 고를 수 있는 조치가 다릅니다. 위 표는 조치 열두 가지 전체이고, 창에서 한 이슈의 목록을 열면 그중 둘에서 넷만 나옵니다. 없는 조치는 그 이슈에 쓸 수 없다는 뜻입니다.
이슈 고를 수 있는 것 Insufficient storageKeep retrying/Skip this device/Stop the runRecovery not progressingKeep retrying/Request review/Skip this device/Stop the runSource changedTransfer the file again/Skip the file/Stop the runSource deletedSkip the file/Stop the runSource file in useRetry later/Skip the fileDestination file in useRetry later/Skip the fileFile system naming conflictSkip the file/Stop the runSchedule overlapSkip this run/Queue oneDeadline missedContinue/Stop the run
Destination file exists는 이 창에서 고르지 않습니다. 값(Keep both/Skip the file/Overwrite)은 단계의 저장 옵션에서 정하고 창은 그 결과만 보여 줍니다.
Request review로 둔 이슈가 생기면 Assurance 화면의Runs requiring attention에Pending approval로 잡힙니다. 카드에N devices are waiting for your review가 뜨고, 그 장비들의 재시도는 누군가 정할 때까지 멈춥니다("Retries are paused for these devices until someone decides.").View report 를 누르면 맨 위에 검토 상자가 서고 고를 것이 셋입니다.
고르는 것 무슨 뜻 Resume보았고 그대로 이어서 돌린다 Skip this device그 장비만 빼고 나머지는 계속 Stop the flow run실행을 멈춘다 고르면 검토 상자가 사라지고
Activity에 무엇을 누가 골랐는지가 남습니다 --Review resolved: resumed by …꼴입니다. 기다리는 동안Contract는Pending이고 조건 줄은Judged when the run finishes로 비어 있습니다.이것은 전송을 시작하기 전에 받는 승인이 아닙니다. 시작 전 승인은 Portal 쪽 기능입니다.
고른 것이 적용되지 않는 때#
조치를 고르는 것과 그 조치가 일어나는 것은 다릅니다. 사이에 끼어들 수 있는 것이 넷이고, 넷 다 화면에 표시가 납니다. 설정이 고장 났다고 판단하기 전에 먼저 보세요.
| 보이는 것 | 뜻 | 할 일 |
|---|---|---|
이슈 옆에 Applied |
서버가 이 이슈를 강제합니다. 고른 값이 실제로 돕니다 | 없음 |
이슈 옆에 Coming in a later update |
이 이슈는 에이전트가 강제하는데 아직 못 합니다. 고른 값이 지금은 아무 일도 하지 않습니다 | 표시가 사라질 때까지 그 이슈는 처리되지 않는 것으로 보세요 |
이슈 옆에 Agent 표시 |
에이전트가 강제하며, "Devices with older agents use the default handling" 이 붙습니다 | 에이전트를 올리거나, 구버전 장비가 다르게 움직일 것을 감안하세요 |
| "Choices are recorded but not applied yet." | 정책 전체가 관찰 모드입니다. 결정은 기록만 되고 실행되지 않습니다 | 이 화면에서 할 것은 없습니다. 모드는 서버 쪽에서 정합니다 |
놀라는 것은 관찰 모드입니다. 건너뛰었어야 할 장비가 건너뛰어지지 않습니다. Activity 에는 정책이 "했을 것" 을 적어 둡니다 -- "Policy would skip this device (observe mode)" 같은 문장이고, 이 글귀는 서버가 만듭니다. 그리고 결정 태그가 Applied 가 아니라 Observe 로 붙습니다. 정책이 돈 것처럼 보이는데 실제로는 아무 일도 없습니다.
Schedule overlap에는 표시가 붙지 않습니다. 겹친 회차를 거르는 것은 제품이 원래 하는 일이라 따로 강제할 것이 없습니다.
정할 필요가 없는 아홉 가지#
창의 Handled by INNORIX 묶음입니다. "9 items, handled automatically" 라고 적혀 있고, 끄거나 바꾸지 않습니다.
| 묶음 | 이슈 | INNORIX가 하는 일 |
|---|---|---|
| Network | Connection interrupted |
Automatic reconnect and resume — 다시 연결해 이어서 보냅니다 |
Transfer process restarted |
Resume from the last confirmed point — 마지막으로 확인된 지점부터 |
|
Transfer stalled |
Detect and reconnect — 멈춘 것을 감지해 다시 연결 |
|
Receiver backpressure |
Slow down and continue — 받는 쪽이 벅차면 속도를 낮춰 계속 |
|
| Destination | Integrity mismatch |
Transfer the file again; fail if it repeats — 다시 보내고 또 틀리면 실패 처리 |
| Security | Malware detected |
Follows the security integration setting — 연동한 보안 도구의 설정을 따름 |
Encryption key mismatch |
Fail |
|
Retry blocked by device policy |
Stop the run |
|
Audit logging unavailable |
Record and continue; notify admins — 기록을 남기고 계속하되 관리자에게 알림 |
끊김 관련 네 가지가 여기 있다는 것이 중요합니다. 회선이 끊어져도 이어서 전송되는지 묻는 고객에게는 이 묶음이 답입니다. 설정하지 않아도 동작합니다.
업무 상황별 설정 예시#
| 상황 | 바꿀 것 | 왜 |
|---|---|---|
| 매장 단말 배포, 일부는 늘 꺼져 있음 | Insufficient storage → Skip this device |
한 매장 때문에 전국 배포가 밤새 매달리지 않게 |
| 생산 설비 레시피, 잘못된 파일이 가면 안 됨 | Source changed → Stop the run |
보내는 중 원본이 바뀌면 멈추고 사람이 확인 |
| 야간 로그 수집, 다음 날 아침이 기한 | Schedule overlap → Skip this run (기본값 유지) |
어제 것이 안 끝났으면 오늘은 거르는 편이 안전 |
| 금융 증빙 전송 | Destination file exists → Keep both (기본값 유지) |
덮어쓰기로 증빙이 사라지면 안 됨 |
| 의료 영상 | Source file in use → Retry later |
촬영 중인 파일은 끝나면 가져오면 됨 |
결과 읽기#
정책이 작동하면 Assurance Report에 남습니다. 실제 예입니다.
Signage update · 50 devices
Transfer Status Success 49 / 50 1 skipped
Contract Status Satisfied All 4 conditions met
Conditions All 4 conditions met
✓ Target completion 49 / 49 targets 1 skipped ≥ 95% Passed
✓ File accuracy 49 passed MD5 Passed
✓ Stored at destination 49 / 49 Passed
✓ Security & evidence no violations Passed
Devices 50 devices Skipped (left out of the rate) 1 Completed 49
Issues & Recovery 1 recorded event · 3 recovery attempts · on 1 device
1 unresolved
Activity 8 events · 1 policy decision반드시 이해해야 할 것 — 건너뛴 장비는 분모에서 빠집니다#
위 예에서 대상은 50대인데 Target completion 이 49 / 49 입니다. 건너뛴 한 대가 비율 계산에서 제외되었습니다. 그래서 95% 조건을 통과했습니다.
위의 두 블록은 장비를 다르게 묶고 있습니다. 이쪽은
Skipped와Completed, 아래 깨끗한 실행은On time입니다. 결과가 아니라 계약을 따릅니다. 기한을 걸면Late와On time, 걸지 않으면Completed,Completed with issues,Not started입니다.Skipped와Failed는 어느 쪽에서나 따로 섭니다. 자세한 것은 장비별 전송 결과와 누락 확인하기 에 있습니다.
이것은 의도된 동작입니다. 정책이 "이 장비는 건너뛴다" 고 정했으니 성공 판정에서도 빼는 것입니다. 다만 "50대 중 49대가 받았는데 100% 성공" 으로 읽힐 수 있으니, 운영 보고에는 Devices 의 Skipped 수를 함께 적어야 합니다.
건너뛴 장비를 그냥 두면 안 됩니다. Issues & Recovery 의 Unresolved 가 그것을 알려 줍니다. 그 장비는 다시 보내기 로 따로 채웁니다.
No issues 가 "아무 일도 없었다" 는 뜻은 아닙니다#
어떤 기록은 이슈가 아니라 알림입니다. 같은 이름 파일이 name(1) 로 저장된 것, 파일명이 정규화된 것, 타임스탬프가 넘어가지 않은 것, 저장 경로가 바뀐 것 같은 일입니다. 전송이 규칙대로 처리했으므로 서버가 결과에서도, 셈에서도, Issues & Recovery 에서도 빼 버립니다.
그래서 이름이 겹친 파일을 전부 번호를 붙여 저장한 실행은 Recovery: Verified, Contract: Satisfied, Issues & Recovery: No issues 로 뜹니다. 이름이 바뀌었다는 사실이 그 화면 어디에도 없습니다.
Activity에는 남아 있습니다. "이름이 바뀐 것이 있나, 타임스탬프가 빠진 것이 있나" 는 거기서만 답할 수 있습니다. 이렇게 다루는 것이 열두 가지이고File name conflict(DST-03),Duplicate file delivery(DST-02),File name normalized(SRC-12),Timestamp not preserved(DST-13) 등이 들어갑니다.
Keep both 을 골랐을 때 특히 중요합니다. 동작은 하는데 눈에 띄는 자리에는 기록이 없고, 목적지에는 번호 붙은 사본이 조용히 쌓입니다.
문제가 없었을 때#
Devices 100 devices On time 100
Issues & Recovery No issuesNo issues 이면 정책이 한 번도 발동하지 않은 것입니다.
오류와 예외#
| 무엇이 보이나 | 뜻 | 할 일 |
|---|---|---|
배지가 Defaults apply |
설정을 못 불러왔습니다 | 권장값으로 돕니다. 서버 연결을 확인합니다 |
Pending approval 로 멈춰 있음 |
Request review 로 둔 이슈가 생겼습니다 |
View report 의 검토 상자에서 Resume, Skip this device, Stop the flow run 중 하나를 고릅니다 |
1 unresolved 가 남음 |
복구되지 않은 이슈가 있습니다 | 리포트에서 어떤 이슈인지 보고 해당 장비를 따로 처리합니다 |
Deadline missed 인데 전송은 계속됨 |
INNORIX 권장값이 Continue 입니다 |
멈춰야 한다면 Stop the run 으로 바꿉니다 |
| 같은 이슈가 매일 반복됨 | 설정이 아니라 환경 문제입니다 | 장비 상태와 디스크를 봅니다. 조치를 바꿔 덮지 않습니다 |
운영할 때 주의할 것#
Keep retrying를 기한과 함께 쓰면 충돌합니다. 계속 재시도하다 기한을 넘기면 Contract는 위반입니다. 기한이 중요한 Flow에서는Skip this device가 맞을 때가 많습니다.- 파일을 건너뛰는 것과 장비를 건너뛰는 것은 계약에서 결과가 다릅니다. 저장 공간이 없는 장비를
Skip this device로 뺀 실행은 그 장비가 분모에서 빠져 계약이Satisfied로 끝났습니다. 반면 원본이 바뀌어Skip the file로 파일 하나를 뺀 실행은Stored at destination이 어긋나 계약이Violated가 되었습니다. 둘 다 "건너뛴다" 고 읽히지만 판정이 반대입니다. Retry later도 결국 건너뜁니다. 기다리다 안 되면 그 파일을 빼고 가므로 위의Skip the file과 같은 결말이 됩니다.Activity의 정책 결정에 몇 번 시도하고 건너뛰었는지가 남습니다.Skip this device는 분모를 바꿉니다. 위에 적은 대로입니다. 비율 조건을 느슨하게 만드는 효과가 있으니Required devices로 핵심 장비를 따로 묶어 두세요.Stop the run은 신중하게. 장비 하나의 문제로 1,200대 배포가 통째로 멈춥니다.- 기본값을 먼저 믿어 보세요.
INNORIX recommended는 대부분의 환경에 맞게 정해져 있습니다. 운영하며 실제로 걸리는 것만 바꾸는 편이 낫습니다. - 바꾼 설정은 다음 실행부터 적용됩니다.
- 조치를 바꾸기 전에
Activity줄의N policy decisions를 보세요(하나면1 policy decision). 실제로 얼마나 자주 발동하는지 알 수 있습니다.
업종별 활용#
| 업종 | 어떻게 쓰나 |
|---|---|
| 제조 | 레시피와 설비 설정은 Source changed → Stop the run. 잘못된 파일이 설비에 가는 것이 가장 큰 위험 |
| 유통 | 매장 단말은 Insufficient storage → Skip this device. 영업시간 외 창이 짧아 기다릴 수 없음 |
| 금융 | 덮어쓰기 금지가 원칙이라 Keep both 유지. Audit logging unavailable 이 자동으로 관리자에게 알리는 것을 감사에 활용 |
| 의료 | 촬영 중 파일은 Retry later. Integrity mismatch 는 자동 처리라 따로 둘 것이 없음 |
| 공공, 국방 | Request review 를 넓게 써서 자동 판단을 줄이고 사람이 결정 |
| 방송 | 송출 기한이 절대적이라 Deadline missed → Stop the run 으로 바꿔 늦은 파일이 나가지 않게 |
함께 보기#
- 전송 성공 조건을 Assurance Contract로 정의하기 — 같은 창의
Success conditions - 다시 보내기 네 가지를 구분해서 쓰기 — 건너뛴 장비와 실패한 파일 채우기
- 장비별 전송 결과와 누락 확인하기 — 조치의 결과가 장비 묶음에 어떻게 보이는지
- 예약이 겹치거나 놓쳤을 때 대처하기 —
Schedule and time묶음의 두 이슈를 깊이 - 전송 파일에 보안 검사 붙이기 —
Malware detected가 따르는 보안 연동 설정 - 네트워크 중단 후 파일 전송을 자동으로 재개하기