에지 장비의 설치

1 에지 장비 설치 개요
2 에지 장비의 목록 생성
- 2.1 개별 등록
- 2.2 CSV Import
3 에지 장비 설치 승인
4 에지 장비 설치
- 4.1 자동 설치
- 4.2 수동 설치
5 에지 장비의 패치
6 트러블슈팅

에지 장비 설치 개요

이 장은 고객사에 직접 설치되는 에지 장비에 대한 관리 절차를 설명한다.

CEMS의 관리 대상이 되는 에지 장비는 고객의 데이터를 수집하는 하드웨어로서 안정적으로 동작하고, 관리되어야 한다. 특히, 외부의 침입으로부터 안전하게 보호되어야 하며, 내부에 저장된 데이터에 대한 관리도 더더욱 중요하다.

따라서, 이러한 조건을 만족하기 위해 CEMS에서는 다음과 같은 절차로 에지 장비의 설치가 진행된다.

에지 장비의 목록 생성
1. 이 과정은 파트너 관리 페이지에서 향후 설치될 에지에 대한 명세 정보를 기록한다.
2. 즉, 이 명세가 기록되지 않은 에지 장비는 클라우드 서비스를 활용할 수도 없고, 등록될 수도 없다.
3. 이는 파트너 관리자에 의해 정확하게 미리 정의된 에지 장비만을 등록하고, 계획되지 않거나 비정상적으로 등록을 시도하는 에지 장비를 방지하는 역할을 한다.
에지 장비 설치 승인
1. 에지 장비의 실제 설치를 승인해 주는 과정이다.
2. 등록된 에지장비도 승인 절차를 거치지 않으면 설치가 완료되어도 CEMS에 등록이 되지않는다.
3. 실제 설치작업을 실행하기 전에 수행해 주면된다. 에지 장비를 켜면 자동으로 설치작업이 진행되므로 실수로 등록이 진행되는 것을 막기위한 안전장치이다.
에지 장비 설치
1. 이는 실제 고객 사이트에서 물리적인 에지 장비에 대한 설치를 수행하는 과정이다.
2. 인증된 에지 장비에 대한 파워를 연결하고, 네트워크를 설정하면, 파트너 페이지에서 설치 정보를 받아서 필요한 파일을 다운로드하고 설치를 진행한다.
에지 장비 CEMS등록
1. 파트너 관리 페이지에서 설치가 승인되어 있다면 CEMS에 등록작업이 진행된다.
2. 미리 설치 승인을 해두지 않았다면 설치가 완료되어도 CEMS에 등록이 되지않는다. 이 경우에는 파트너 관리 페이지에서 설치 승인을 해야지만 등록을 진행할 수 있다.
3. 등록이 완료된 에지 장비는 그 즉시 사용자의 데이터를 수집하고, 이를 클라우드로 전송하게 된다.

아래는 위의 과정에 대한 상세한 내용을 기술한다.

에지 장비의 목록 생성

아래와 같이 EQUIPMENT 메뉴에서 장비의 명세를 기록하고, 승인을 위한 준비를 수행한다.

개별 등록

[CREATE] 버튼을 누르면 장비 입력 창이 나타난다. 이 입력창에 필요한 정보를 입력하여 등록한다. 등록할 장비의 수가 적을 경우 사용하기 편리하다.

EQUIPMENT NAME은 장비의 명칭이다. 수집된 Tag 데이터가 서버로 전송될 때 Tag Name의 앞에 이 값이 추가된다. 따라서 식별하기 편리하고 너무 길지않게 설정하는 것이 좋다.
EQUIPMENT IP는 참고용 항목입니다. 실제 내부 IP를 입력하면 장비 식별용으로 사용할 수 있지만 127.0.0.1로 입력하여도 무방하다.

CSV Import

미리 등록할 장비의 정보를 csv 파일로 구성한 후 Import하여 일괄등록한다. 많은 수의 장비를 등록할 때 사용한다.

[IMPORT] 버튼을 누르면 CSV Import 창이 나타난다.

[SELECT FILE] 버튼을 눌러서 CSV 파일을 선택한다.
가운데에 있는 [GET SAMPLE CSV] 버튼을 누르면 CSV 샘플을 다운로드 받을 수 있다. company_id, package_id, application_id는 각각 Company, Package, Application메뉴의 상세정보창에서 확인할 수 있다.

에지 장비 설치 승인

등록이 된 에지 장비는 전원과 네트워크가 연결되면 자동으로 설치가 진행이 된다. 하지만 설치 승인(Assign)이 되어야지만 CEMS에 등록되어 데이터를 수집할 수 있다. 실수로 에지 장비가 CEMS에 등록되는 것을 막기위한 안전장치이다.

에지 장비를 설치하기 전에 승인절차를 진행하면 된다.

승인할 장비를 선택하고 [ASSIGN] 버튼을 누른다.
승인되지 않은 장비의 경우 설치후 APPLY 단계가 진행되지 않는다. 이 경우에는 승인작업을 한 후 에지 장비에 접속해서 직접 APPLY 단계를 수행하면 된다.(다음 단계인 ‘에지 장비 설치’ 참조)

에지 장비 설치

에지 장비의 전원을 켜고 네트워크 설정을 마치고 에지장비를 재시작하면 자동으로 설치가 진행된다.

웹브라우저로 에지장비에 접속하면 설치 진행 정보를 현장에서 확인할 수 있다.(http://에지장비IP:18180)

자동 설치

자동설치란 장비의 명세가 관리 페이지에 등록되고 설치 승인이 된 상태를 의미한다. 이 경우에는 파워와 네트워크의 연결을 수행하는 즉시, 모든 에지의 설치 및 등록이 자동으로 수행된다.

설치 진행과정을 확인하려면 웹 브라우저로 에지장비에 접속한다.(접속 url : http://에지장비IP:18180)

장비정보 확인 (DEVICE)
- 에지 장비의 Serial 번호와 승인여부(Assigned)를 확인한다. 파트너 관리 페이지의 에지 장비 목록에 시리얼이 등록되어 있다면 이 화면이 나타나서 파일 다운로드 및 프로그램 설치를 진행한다.
설치 진행 (INSTALL)
- 설치 진행 단계를 확인한다. 아래의 화면은 설치가 완료된 상태의 화면이다.
- 설치는 DOWNLOAD → INSTALL→ APPLY의 순서로 진행된다. 설치 진행단계는 파트너 관리 페이지의 EQUIPMENT 메뉴의 Status에서도 확인이 가능하다.
- Software Information은 실제 프로그램의 설치 과정을 표시한다. 만약 설치 중 문제가 생겼다면 문제 해결 후 남은 설치 작업은 이곳에서 직접 버튼을 눌러서 진행한다.
- Preset Information은 에지 장비의 구성을 다운로드받아서 환경을 설정하고 에지 장비를 CEMS에 등록한다.(APPLY)
- APPLY 단계는 파트너 관리 페이지에 에지 장비 설치 승인(Assign)이 되어 있어야 진행된다.
- APPLY 단계는 Machbase의 DB를 생성하고 필요한 테이블을 만드는 작업등을 수행하므로 생각보다 많은 시간이 소요될 수 있다.
에지 프로그램 제어 (CONTROL)
- 에지 Client 프로그램을 Start / Stop 시킨다. Command History에는 CEMS 서버에서 전달되는 명령을 처리하는 로그도 표시된다.
로그 확인 (LOG)
- 로그를 확인하고 필요한 경우 파트너 관리 페이지로 전송한다.
- 로그의 종류(Installer / Command)를 선택 할 수 있다.
- 로그를 확인하고 필요한 경우 [UPLOAD] 기능으로 로그를 서버로 전송한다. 이 내용은 파트너 관리 페이지의 EQUIPMENT 페이지에서 확인할 수 있다.

수동 설치

수동 설치란 관리자 페이지 등록되지 않은 에지 장비에 대해 설치를 수행하는 것을 의미한다. 이는 현장에서 모든 장비 명세의 생성과 설치, 승인, 최종 등록을 직접 수행하는 과정이다.

등록되지 않은 에지장비에 접속을 하면 아래와 같은 화면이 계속 유지된다. 등록된 에지장비의 경우는 Serial이 등록된 것이 확인되면 자동설치 화면으로 전환된다.

Company 생성시에 등록한 Installer ID 를 사용하여 로그인하면 에지 장비가 서버에 등록이 된다.
이후는 자동 설치의 화면으로 전환되어 설치가 진행되는데 INSTALL 탭에서 [RIVISE] 버튼을 눌러서 설치할 Software와 Preset을 선택해 주어야 한다.
이후 수동으로 DOWNLOAD → INSTALL → APPLY를 차례대로 진행하면 된다.
자동설치와 마찬가지로 관리 페이지에서 장비를 승인해야지만 APPLY를 수행해서 장비를 등록할 수 있다.
다음의 이유로 이 모드는 사용을 권장하지 않는다.
- Equipment Name과 Tag prefix가 시리얼 번호로 설정되므로 장비 및 Tag의 식별이 불편하게 된다.
- 승인작업을 하려면 어차피 파트너 관리 페이지에 접속을 해야하므로, 장비등록 후 승인 작업을 자동설치로 진행하는 것이 편리하다.

에지 장비의 패치

여러가지 환경의 변화에 따라 이미 설치된 에지 장비의 소프트웨어를 변경하거나 업그레이드 해야 하는 경우가 발생한다. 이를 위해 CEMS는 아래와 같은 순서를 통해 이 과정을 수행할 수 있다.

트러블슈팅

실제 설치하는 과정에서 나타나는 이슈에 대해 해결책을 설명한다.

에지의 설치 화면에 어떻게 접속하나요?

웹 브라우저로 http://에지장비IP:18180 에 접속한다.

파트너 관리 페이지에 장비의 시리얼이 등록되었다면 설치화면으로 이동한다.

에지의 설치 화면으로 이동하지 않고 계속 로그인 화면입니다.

파트너 관리 페이지에 시리얼이 등록되지 않은 경우 입니다. 로그인 화면에 표시되는 시리얼이 관리 페이지의 EQUIPMENT 메뉴에 등록되어 있는지 확인하여야 합니다.

시리얼이 등록되어 있다면 시리얼 번호에 앞뒤 공백이나 안보이는 특수문자등이 섞여있을 수 있으니 수정으로 시리얼 번호를 확인합니다.

설치중 다운로드 오류가 발생해서 설치가 멈췄습니다.

아래의 순서대로 진행합니다. 설치 오류가 발생한 대부분의 경우 같은 방법으로 처리합니다.

웹 브라우저로 에지장비에 접속하여 LOG를 확인한다.(접속 url : http://에지장비IP:18180)
다운로드 오류가 맞다면 INSTALL 탭으로 이동한다.
DOWNLOAD 버튼이 활성화 되어 있다면 DOWNLOAD를 누르면 다시 다운로드를 진행한다.(비활성화 된 경우 DELETE 버튼을 누르면 됩니다.)
다운로드가 끝나면 INSTALL → APPLY 순으로 직접 버튼을 눌러주어야 한다.

에지의 설치가 끝났는데도 CEMS에서 확인할 수 없습니다.

설치와 CEMS 등록이 완료된 장비는 CEMS의 EQUIPMENT 메뉴에서 확인할 수 있습니다. Ungrouped 아래에 표시됩니다. 이 장비들을 원하는 Group으로 이동시키면 됩니다.

만약 Ungrouped에서도 찾을 수 없다면 파트너 관리 페이지의 EQUIPMENT 메뉴에서 해당 장비의 Status를 확인해 봅니다. Status가 RUNNING 이어야지만 CEMS에서 확인할 수 있습니다.

RUNNING이 아닌 경우 설치 및 CEMS 등록이 완료되지 않은 경우 입니다.