인벤토리 템플릿 포멧을 Excel Template형태로 다운로드 받아, 업로드 할수 있습니다.
이후 업로드된 파일은 자동 분석되어 각 Services, Servers, Middlewares, Application, Databases에 리스트로 보여지게 됩니다.
업로드 시, 파일 데이터의 정상 여부에 따라 리스트에 Upload Status가 기록되게 되며 업로드 성공 시 Uploaded Records를 기록으로 확인 할 수 있습니다
Upload File
화면에서 파일을 업로드 하는 방법은 두가지가 있습니다.
최초에 Playce RoRo 설치 후 리스트에 업로드 된 파일이 없을 경우 리스트에서 클릭하여 생성된 팝업 화면에서 File을 Add하는 방법과,
상단의 UPLOAD FILE 버튼을 눌러 팝업에서 다운로드 한 파일을 업로드 하는 방법이 있습니다.
간단한 인벤토리 업로드 절차는 아래와 같습니다.
Upload File버튼을 클릭합니다.
생성된 팝업(Upload File)에서 Add File을 클릭합니다.
File Explorer 혹은 디렉터리 폴더에서 업로드할 Excel Template파일을 첨부합니다.
업로드가 시작 되고, 이후 결과 내용이 표시됩니다.
업로드 된 이후 각 서버와 미들웨어, 어플리케이션, 데이터 베이스는 메뉴로 이동되며 자동 분석이 시작됩니다.
<그림 1. 인벤토리 업로드 절차>
인벤토리 업로드 전 반드시 아래 사항을 확인 후 시행 되어야 합니다.
인벤토리 업로드 확인 사항
업로드 프로세스
등록 프로세스는 서비스 - 서버 - 미들웨어 - 어플리케이션 - 데이터 베이스 순으로 진행됩니다.
다른 시트에 데이터가 없다고 해서 데이터가 있는 시트의 내용이 업로드에 실패하지는 않습니다.
Excel Template시트에 목록(Combo Box) 형태로 선택할 수 있는 항목들이 있습니다, 서비스 화면-Playce RoRo 메뉴 화면의 데이터와 동일한 형태로 제공되는 항목입니다.
만약 신규로 서비스와 서버를 동시에 생성하려고 할 경우에는 생성할 서비스의 name으로 mapping할 수 있습니다.
예를 들어 A라는 서비스를 처음 생성 시 - A 서비스가 없을 경우,
서비스 아이디(service_id)는 비워둔 채 Sever/Middleware/Application/DataBase에 A 서비스명(service_name)을 넣고 생성합니다.
파일 데이터 등록/업데이트
서비스(Services) 이름은 중복해서 업로드 할 수 없습니다, 단 다른 시트의 경우 이름의 중복을 허용합니다
데이터의 업데이트/신규 등록은 id 데이터 유무를 기반으로 합니다, 즉 id가 있을 경우 기존에 등록되어 있는 데이터를 신규 데이터로 업데이트를 진행할 수 있습니다.
id가 없을 경우 해당 데이터는 신규 데이터로 판단되어 신규 데이터로 생성합니다.
그렇기 때문에 Service id나 name 중 하나의 값은 반드시 존재해야 합니다.
각 시트의 필수 컬럼 데이터는 아래 항목을 참고합니다.
데이터 입력 시 참고 사항
데이터는 실제 서비스 화면의 필수 값과 동일합니다.
서버 등록 시 Authentication을 Private Key File로 했을 경우 아래와 같이 기록합니다
데이터는 실제 서비스 화면의 필수 값과 동일합니다.
서버 등록 시 Authentication을 Private Key File로 했을 경우 아래와 같이 기록합니다
key_file_name - AWS는 key pair파일의 Name, GCP에서는 SSH key구성 절차를 따라 진행하여 생성된 키의 Name을 등록합니다.
key_file_path - 설치 후 아래와 같은 형태로 디렉터리를 위치를 확인해서 입력 할 수 있습니다.
입력할 데이터의 예시는 아래와 같습니다./roro/keyFiles/hostIpAddress-ramdomNum.pem
key_file_string - .pem , json파일의 data를 모두 입력합니다.
입력할 데이터의 예시는 아래와 같습니다.-----BEGIN RSA PRIVATE KEY----- MIIEogIBAAKCAQEAgUmDbdUjzQ6gdQUj/SdP8T39CrJfxbu++gokz96zzzd123423rwsdfasdfas ---------------------------------------------------------------------------- ---------------------------------------------------------------------------- fy3UshII1MLUs3xEHHNxRQOZqniWKwC6SDo51zLUQCLsNEeE9KZyIp76mR1rE0BNXcE= -----END RSA PRIVATE KEY-----
Upload Inventory Excel 시트 컬럼 Data설명
업로드 인벤토리에서 Template으로 제공되는 파일의 데이터 설명입니다
Sheet명 | 컬럼 | 설명 |
|---|---|---|
Service | ||
각 시트의 필수 컬럼/데이터(*가 있을 경우 필수 데이터 입니다)
Service | Server | Middleware | Application | DataBase |
|---|---|---|---|---|
id(Service)* - number | id(server) - number | service_id* - number | service_id* - number | service_id* - number |
name(Service name)* - string | name(server name)* - string | service_name* - string | service_name* - string | service_name* - string |
business_code* - string | service_id* - number | server_id* - number | server_id* - number | server_id* - number |
business_category* - string | service_name - string | server_name* - string | server_name* - string | server_name* - string |
labels | migration_type(Migration Type) - string | id(middleware) - number | id(application) - number | id(database) - number |
description - string | windows_yn(Windows Y/N)* - y/n(boolean) | name(middleware name)* - string | name(application)* - string | name(database)* - string |
migration_yn(Migration Y/N)* - y/n(boolean) | ip_address(IP Address)* - string | type - string | type(application type) - string | type(database type) - string |
man_month - number | port(SSH Port)* - string | vendor - string | deploy_path(배포경로) - string | port(database port) - string |
Environment Configuration Schedule - date(YYYY-MM-DD-hh:mm:ss)
| username* - string | solution_name - string | analyze_application_uri(Application URI) - string | db_service_name(Database Service Name) - string |
Application Test - date(YYYY-MM-DD-hh:mm:ss) Schedule
| password* | solution_version - string | analyze_file_name(Application File) - string | connection_url(JDBC Connection URL) - string |
Cut-Over Date - date(YYYY-MM-DD-hh:mm:ss)
| Private key file* - string
| solution_path - string | analyze_file_path(Application path) - string | username - string |
severity - string | server_location - string | instance_path - string | anlz_target_lib_list(Library Assessment) - string | password |
Configure Manager - string
| environment - string | run_user -string | anlz_target_str_list(String) - string | access_control(Access Control)- String |
hypervisor - string | java_version - string | Configure Manager - string
| Configure Manager - string
| |
access_control - string | Configure Manager - string
| description - string | description - string | |
tpmc - string | description - string | label | label | |
purchase_date - date | label | |||
manufacturer -string | ||||
model - string | ||||
serial_number - string | ||||
labels | ||||
description - string | ||||
Configure Manager - string
| ||||
cluster_type - string |
기타
Settings Sheet의 데이터를 빼거나, 수정/삭제 해서는 안됩니다
Sheet에 데이터가 없는 빈 Row를 통해 업로드를 시도할 경우 업로드에 실패할 수 있습니다
Sheet에 동일한 데이터의 Row를 생성해서 업로드를 시도할 경우 업로드에 실패할 수 있습니다.
기존에 있던 서식에 엑셀 서식을 추가로 변경하거나 수정할 경우 업로드에 실패할 수 있습니다
Excel Template
엑셀 템플릿 파일을 다운로드 해서 수정 후 이용할 수 있습니다.
파일을 다운로드 할 경우 사용자의 Download directory에 “RoRo-Inventory-Template.xlsx”파일이 신규 생성 됩니다
다운로드 이후, 생성된 파일의 내용을 확인할 경우 필수로 입력해야 하는 값에 대한 설명이 메모에 기록되어 있으며 가이드에 따라 해당하는 열과 행 값을 입력해야 합니다.
해당 파일의 내용을 수정 하는 것은 문제가 발생하지 않으나, 파일의 확장자를 수정할 경우 문제가 발생할 수 있습니다.
지원 하는 확장자의 경우 .xlsx/.xls 두가지 이며 다른 확장자일 경우 이용 할 수 없습니다.
Upload List
업로드 이후 리스트에는 성공 했을 경우 SUCCSESS 로, 실패 했을 경우 FAILURE 로 보이게 됩니다.
또한 Uploaded Records는 업로드에 성공한 Row를 설명하며 File Download를 통해 실패한 파일을 다운로드 할 수 있게 됩니다.
업로드에 실패 하였을 경우에는 팝업 창에서 실패한 부분에 대한 에러를 파일 형태로 다운받아 확인 할 수 있습니다.