호스트 목록에서 기기 생성/연결하기
SMPLY Agent가 설치된 기기(호스트)의 인벤토리를 관리하고, 호스트 정보를 바탕으로 신규 기기를 한 번에 생성·연결하는 방법을 안내합니다.
호스트 목록에서 기기 생성/연결하기
섹션 제목: “호스트 목록에서 기기 생성/연결하기”호스트(Host) 는 SMPLY Agent가 설치된 기기(엔드포인트)의 인벤토리 레코드입니다. 에이전트가 수집한 하드웨어·OS·로그인 정보를 기반으로 호스트와 SMPLY 기기를 연결해 관리합니다.
1. 호스트 목록 페이지
섹션 제목: “1. 호스트 목록 페이지”경로: 사이드바 호스트 메뉴 → /host/list
페이지 제목: 호스트 설명: “SMPLY 에이전트가 설치된 호스트 목록을 확인합니다.”
우측 상단 — 에이전트 다운로드 버튼
섹션 제목: “우측 상단 — 에이전트 다운로드 버튼”메인 버튼은 에이전트 다운로드 (설치 패키지 받기). 드롭다운에는 설치 안내 가 있어 아직 설치 안 된 구성원에게 일괄로 안내 메일을 보낼 수 있습니다.
상태 탭
섹션 제목: “상태 탭”| 탭 | 의미 |
|---|---|
| 전체 | 모든 호스트 |
| 활성 | 정상 동작 중 |
| 아카이브 | 더 이상 사용하지 않는 호스트 (보관 처리) |
| 연결 대기 | SMPLY가 기기 연결 제안을 만든 호스트. 건수가 0이면 숨겨집니다. 주황색 텍스트로 강조 표시 |
“연결 대기” 탭은 일반 목록 대신 승인 전용 패널로 전환됩니다. 호스트별로 제안이 묶여 표시되고, 후보가 여럿인 경우 라디오 버튼으로 하나를 고른 뒤 선택한 것만 한 번에 승인할 수 있습니다. 자세한 동작은 5. “연결 대기” 패널에서 제안 승인을 참고하세요.
2. 목록에 보이는 열
섹션 제목: “2. 목록에 보이는 열”기본으로 보이는 열 순서:
- 호스트명
- 상태 — 호스트 상태(활성 / 아카이브) 배지
- 플랫폼 (macOS / Windows 등)
- 기기 — 연결된 SMPLY 기기(관리번호). 미연결이면
연결하기링크(추천이 있으면 주황색!배지)와추가하기링크가 함께 뜹니다 - 사용자 — 연결된 기기의 사용자를 따라가 보여 주는 읽기 전용 칸입니다. 여기서 연결하거나 해제하지 않습니다
- OS 버전
- 하드웨어 모델
- 시리얼 번호
- 에이전트 버전
- 에이전트 확인 — 이 칸에는 마지막 확인 시각(상대 시간)과 에이전트 상태 배지가 표시됩니다. 기본 정렬은 이 열 내림차순입니다
사용자 칸에 이름이 없을 때는 왜 없는지를 표시합니다.
| 표시 | 뜻 | 할 일 |
|---|---|---|
기기 없음 | 이 호스트에 연결된 기기가 없음 | 연결하기 또는 추가하기 |
미지정 | 기기는 있는데 그 기기에 사용자가 없음 | 기기 상세에서 사용자 지정 |
에이전트 상태 배지는 다음 네 가지입니다.
| 상태 | 의미 |
|---|---|
| 정상 | 에이전트가 최근 정상적으로 확인됨 |
| 오프라인 | 한동안 확인되지 않음 |
| 장기 미확인 | 오랫동안 확인되지 않음(주의) |
| 비활성화 | 에이전트가 비활성 처리됨 |
3. 호스트에 기기 연결하기
섹션 제목: “3. 호스트에 기기 연결하기”각 호스트 행의 기기 칸에서 연결·제거합니다. 미연결이면 연결하기 링크가 뜨고, 추천이 있으면 옆에 주황색 ! 배지가 표시됩니다.
3-1. SMPLY 기기 연결하기
섹션 제목: “3-1. SMPLY 기기 연결하기”단계 1: 연결 창 열기
- 기기 칸의
연결하기링크를 클릭합니다. - “기기 연결하기” 창이 열립니다.
단계 2: 기존 기기 선택 또는 신규 등록
- 추천: 시리얼 번호 등이 일치하는 기기가 있으면 추천 배지로 자동 추천되어, 관리번호·시리얼·모델명을 확인하고
연결하기로 바로 연결할 수 있습니다. - 직접 선택: 검색창에서 관리번호·시리얼·모델명으로 기기를 찾아 선택합니다.
- 신규 등록: 대장에 그 기기가 아예 없으면
추가하기로기기 추가 승인화면에서 등록합니다 (4. 대장에 없는 단말 등록하기).
3-2. 이미 다른 호스트에 연결된 기기를 연결할 때
섹션 제목: “3-2. 이미 다른 호스트에 연결된 기기를 연결할 때”연결하려는 기기에 이미 다른 호스트가 연결돼 있으면 확인 창이 뜹니다 — “이 기기에는 이미 호스트 {호스트명} 가 연결돼 있습니다. 그래도 연결하면 두 호스트가 한 기기에 함께 연결됩니다.”
기존 연결이 해제되지 않습니다. 두 호스트가 그 기기에 나란히 붙습니다.
4. 대장에 없는 단말 등록하기 — 기기 추가 승인
섹션 제목: “4. 대장에 없는 단말 등록하기 — 기기 추가 승인”기기 칸의 추가하기 를 누르면 기기 추가 승인 화면으로 갑니다. “관측된 호스트를 기기로 등록합니다.” — 대장에 없는 호스트들을 표로 놓고 한 번에 등록하는 자리입니다.
기다리는 호스트가 없으면 추가 대기 중인 호스트가 없습니다 와 “에이전트가 설치된 새 기기가 추가 요청을 보내면 여기에 표시됩니다.” 가 뜹니다.
표에서 채우는 칸
| 칸 | 어떻게 채워지나 |
|---|---|
| 관리번호 | 다음 번호가 자동 제안됩니다 — 기존 기기 번호를 이어 채우고, 없으면 카테고리명 기준으로 시작합니다. 직접 바꾸셔도 됩니다 |
| 카테고리 | 직접 고릅니다 |
| 사용자 | 호스트에서 관측된 사용 정보와 일치 후보가 정확히 1명일 때만 자동으로 채워집니다 |
| 모델명 · 시리얼번호 · OS | 호스트가 알려 온 값으로 채워집니다 |
빈 관리번호가 여럿이면 관리번호 자동생성 으로 카테고리별 다음 번호를 한 번에 채울 수 있습니다. 이미 번호가 있거나 카테고리가 없는 행은 그대로 둡니다.
등록
- 관리번호가 비었거나 표 안에서 겹치거나 이미 등록된 번호면
에러로 표시됩니다.전체·유효·에러로 걸러 보고, 고친 뒤재검증을 누릅니다. 등록을 누르면 기기가 만들어지고 해당 호스트와 자동으로 연결됩니다.- 호스트 목록의 해당 행 기기 칸에 관리번호가 표시됩니다.
5. “연결 대기” 패널에서 제안 승인
섹션 제목: “5. “연결 대기” 패널에서 제안 승인”“연결 대기” 탭은 SMPLY가 만든 기기 연결 제안을 호스트별로 묶어 보여주는 전용 패널입니다.
- 각 호스트 아래에 추천된 기기와 추천 근거(
시리얼번호 일치·관리번호 일치·커스텀 필드 일치· 담당자로 찾은 경우)가 표시됩니다. - 값이 맞아 뜬 후보가 하나뿐(1:1) 인 호스트는 자동으로 체크되어 있습니다. 담당자로 찾은 후보는 하나뿐이어도 자동으로 체크하지 않습니다.
- 후보가 여럿 인 호스트는 라디오 버튼으로 하나를 먼저 골라야 체크할 수 있습니다.
- 이미 다른 호스트가 쓰고 있는 후보는 “이미 {호스트명} 이(가) 쓰는 중” 으로 표시되고 고를 수 없습니다.
- 좌측 체크박스로 호스트를 선택/해제하고, 상단 체크박스로 전체 선택할 수 있습니다.
상단 우측 선택 항목 승인 (N) 버튼을 누르면 선택된 제안이 한 번에 처리되고, 처리 결과(N건 승인 완료 · 실패 시 N건 실패)가 표시됩니다.
6. 기기 목록에서 에이전트 값으로 여러 대를 한 번에 채우기
섹션 제목: “6. 기기 목록에서 에이전트 값으로 여러 대를 한 번에 채우기”호스트와 연결된 기기의 하드웨어·식별 정보를 에이전트가 수집한 값으로 한 번에 맞출 수 있습니다. 자산 실사를 마친 뒤 OS·CPU·RAM 같은 값을 수십에서 수백 대 단위로 채워야 할 때 씁니다.
단계 1: 대상 기기 선택
- 기기 목록(
/device)으로 이동합니다. - 체크박스로 값을 채울 기기를 여러 대 고릅니다.
- 하단 일괄 작업 바에서
에이전트 정보로 덮어쓰기를 누릅니다.
단계 2: 무엇이 무엇으로 바뀌는지 확인
이 창은 필드 목록이 아니라 값 단위로 보여줍니다. 어떤 칸의 어떤 값이 어떤 값으로 바뀌고 그런 기기가 몇 대인지 한 줄씩 나오며, 두 묶음으로 나뉩니다.
| 묶음 | 하는 일 | 처음 상태 |
|---|---|---|
| 빈칸 채우기 | 비어 있던 칸을 채웁니다 | 켜짐 |
| 기존 값 바꾸기 | 이미 적혀 있던 값을 덮습니다 | 꺼짐 |
잃을 것이 없는 쪽만 켜 둔 채로 열립니다. 사람이 손으로 적어 둔 값을 덮는 쪽은 직접 켜야 합니다. 다룰 수 있는 칸은 OS · CPU · RAM · 그래픽 · MAC 주소 · 메인보드 · 모델명 · 브랜드 · 사용자 · 시리얼번호입니다. 켜지 않은 항목은 “선택하지 않은 항목은 덮어쓰기에서 제외되어 에이전트와 계속 다릅니다.” 라고 안내됩니다.
덮을 수 없는 기기는 실행 전에 사유와 함께 걸러 보여줍니다. “선택한 {N}대 중 {M}대를 덮습니다. {K}대는 건너뜁니다:” 처럼 표시되며, 연결된 에이전트가 없는 기기와 등록된 시리얼번호가 에이전트 수집값과 다른 기기가 여기 걸립니다.
하드웨어 정보를 담을 커스텀 필드가 그 카테고리에 없으면 “카테고리에 없는 하드웨어 커스텀 필드가 있습니다” 안내와 함께 카테고리 설정 열기 링크가 표시됩니다.
단계 3: 되돌릴 파일을 먼저 받아 두기
덮어쓰기 전 값 다운로드 를 누르면 지금 값이 엑셀 파일로 저장됩니다. 되돌리고 싶을 때 이 파일을 기기 일괄 등록에 그대로 올리면 됩니다.
단계 4: 확정
다음을 누르면 “이대로 덮어쓸까요?” 확인 창이 열립니다. “기기 {N}대에서 값 {M}개가 바뀝니다.” 와 “덮어쓴 값은 자동으로 되돌아가지 않습니다.” 가 함께 표시됩니다.덮어쓰기를 누르면 반영됩니다.
7. 호스트 상태 관리 (아카이브)
섹션 제목: “7. 호스트 상태 관리 (아카이브)”단건 — 행 메뉴
섹션 제목: “단건 — 행 메뉴”행의 ⋯ 메뉴에서 호스트 상태를 변경할 수 있습니다.
- 활성 호스트:
아카이브선택 → 더 이상 사용하지 않는 호스트로 표시. 기본 목록에서 숨겨지고 관리 대수에서 제외됩니다. - 아카이브 호스트:
아카이브 해제선택 → 다시 활성 상태로 복귀
여러 대 한 번에 — 하단 일괄 작업 바
섹션 제목: “여러 대 한 번에 — 하단 일괄 작업 바”여러 호스트를 한 번에 아카이브하거나 해제할 수 있습니다.
- 좌측 체크박스로 대상 호스트를 여러 개 선택합니다.
- 하단에 나타나는
일괄 작업바에서아카이브또는아카이브 해제를 선택합니다. - “선택한 {N}개 호스트를 아카이브합니다…” 확인 창에서 진행합니다.
8. 시트 제한 안내
섹션 제목: “8. 시트 제한 안내”플랜에 호스트 시트 수 제한이 있는 경우, 목록 상단에 안내 배너가 표시됩니다.
- 여유가 있을 때(녹색): “{관리 중}/{시트}대 관리 중” 또는 “최대 {시트}대 관리 가능”.
- 초과했을 때(주황색 경고): “최대 {시트}대 관리 가능 · {초과}대 초과 · 추가 관리는 담당 매니저에게 문의하세요” 와 함께
담당 매니저에게 문의버튼이 표시됩니다.
초과분 호스트는 🔒 아이콘으로 잠김 표시됩니다. 계속 관리하려면 플랜 업그레이드 또는 오래된 호스트 아카이브가 필요합니다.
9. 권한 안내
섹션 제목: “9. 권한 안내”| 작업 | 필요 권한 |
|---|---|
| 호스트 목록 조회 | 기본 구성원 이상 |
| 기기 연결·연결 제거 | 관리자(Admin) |
대장에 없는 단말 등록하기 (기기 추가 승인) | 관리자(Admin) |
| 아카이브 / 해제 (단건·일괄) | 관리자(Admin) |
| 에이전트 설치 안내 메일 발송 | 관리자(Admin) |
| 기기 목록에서 에이전트 값으로 여러 대 채우기 | 기기 수정 권한 |
플랜이 만료되면 편집 기능이 비활성화됩니다.
10. 자주 묻는 질문
섹션 제목: “10. 자주 묻는 질문”Q: 기기 연결 제안이 자동으로 만들어지는 기준은 무엇인가요
섹션 제목: “Q: 기기 연결 제안이 자동으로 만들어지는 기준은 무엇인가요”값이 맞은 기기를 추천하고, 근거를 함께 보여 줍니다.
| 근거 | 뜻 |
|---|---|
시리얼번호 일치 | 호스트가 알려 온 시리얼과 기기 일련번호가 같음 |
관리번호 일치 | 호스트가 알려 온 값과 기기 관리번호가 같음 |
커스텀 필드 일치 | 직접 만든 칸의 값이 같음 |
{이메일} 님이 담당인 기기 | 값이 맞는 기기가 없어, 에이전트가 관찰한 사용자가 담당인 기기를 후보로 올린 것 |
무엇을 맞출지는 설정에서 고릅니다 — 기기 자동 연결 기준 정하기 를 보세요.
한 호스트에 후보가 여럿 나올 수 있으며, 이 경우 연결 대기 패널에서 라디오 버튼으로 하나를 골라 승인합니다. 이미 다른 호스트가 쓰고 있는 후보는 “이미 {호스트명} 이(가) 쓰는 중” 으로 표시되고 고를 수 없습니다.
Q: 호스트에서 자동 채움된 정보가 잘못되어요
섹션 제목: “Q: 호스트에서 자동 채움된 정보가 잘못되어요”- 호스트 수집 정보(특히 모델명·OS)가 잘못된 경우가 간헐적으로 있습니다.
- 기기 생성 후 기기 상세 페이지에서 해당 필드를 직접 수정할 수 있습니다.
- 반복적으로 틀린다면 채널톡으로 호스트 정보를 보내주세요.
Q: “추천 번호” 버튼이 이상한 번호를 제안해요
섹션 제목: “Q: “추천 번호” 버튼이 이상한 번호를 제안해요”관리번호 추천은 기존 번호들의 공통 패턴을 분석해서 다음 값을 예측합니다. 번호 체계를 바꿨거나 부서별 규칙이 있다면 수동 입력을 권장합니다.
Q: 호스트를 삭제할 수 있나요
섹션 제목: “Q: 호스트를 삭제할 수 있나요”직접 삭제 대신 아카이브 를 사용합니다. 에이전트가 제거되어 오래 확인되지 않은 호스트는 에이전트 상태가 자동으로 장기 미확인 으로 전환됩니다.
Q: 이 외의 문제
섹션 제목: “Q: 이 외의 문제”채널톡으로 문의해 주세요.