GSM Metal

스마트공장 구축 및 고도화 사업

운영 메뉴얼

2022.  05. 05.

작성(공급기업)  성명    심 윤 섭(인)

검토(공급기업)  성명    심 윤 섭(인)

승인(도입기업)  성명    유 병 택(인)

(주)쓰리뷰

스마트공장 구축 및 고도화 사업                                                     메뉴얼

목 차

운영 메뉴얼

(1) FactoryView API 서버 설치 정보	1

1) 시스템 운영 및 실행 환경	1

2) 서버 환경설정 파일 수정	5

(2) 프로그램 설치 방법	7

1) FactoryView 관리자 프로그램	7

2) FactoryView 작업자 프로그램	9

3) FactoryView 현황판 프로그램	11

(3) 데이터베이스 백업 및 복원 방안	13

1) 백업 및 복원 방안	13

2) MSSQL 데이터베이스 수동 백업	13

3) MSSQL 데이터베이스 복원 방안	16

(4) 장애 시 대책	19

1) 장애처리 절차	19

2) 유형별 장애 발생상황	19

(5) 비상연락망	23

(1) FactoryView API 서버 설치 정보

시스템 운영 및 실행 환경

OS 환경

- Ubuntu Linux 18.04 OS 환경 기준 FactoryView API 서버 설치 매뉴얼입니다.

- Ubuntu Linux Server OS를 권장합니다. (12.04 버전 이상)

- Windows 또는 Ubuntu 외 다른 배포 버전의 Linux인 경우 설치 및 구성 방법이 달라질 수 있습니다.

JAVA8 설치

open-jdk를 다운받습니다.

sudo apt-get install openjdk-8-jdk

Docker, MongoDB, Redis, RabbitMQ 설치

Docker 설치

$ sudo apt update

$ sudo apt install docker.io

$ sudo systemctl enable –now docker

Docker 그룹 추가

$ sudo groupadd docker

$ sudo usermod -aG docker $USER

$ newgrp docker

MongoDB 설치

$ docker pull mongo

$ docker run --name mongo-container -p 27017:27017 -dit --restart unless-stopped mongo -auth

MongoDB 계정 생성 및 관리자 추가

$ docker exec -it mongo-container bash

mongo

use admin

> db.createUser({

user: "admin",

pwd: "admin",

roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]

})

RabbitMQ 설치

$ docker pull rabbitmq

$ docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 --restart=unless-stopped -e RABBITMQ_DEFAULT_USER=3view -e RABBITMQ_DEFAULT_PASS=3view rabbitmq:management

Redis 설치

$ docker pull redis

$ docker run --name redis-container -p 6379:6379 -dit --restart unless-stopped redis

컨테이너 설치 확인(아래와 같이 나오면 성공)

타임존 설정

$ sudo dpkg-reconfigure tzdata

NGINX 설치

$ sudo apt-get install nginx // 설치

// 관련파일 resouces/nginx 폴더에서 복사

$ etc/nginx/sites-avaliable/default

$ etc/nginx/conf.d/service_addr.inc

서버 환경설정 파일 수정

application.properties

환경설정 속성값 서버 IP, 포트 현재 서버에 맞게 적어주기

spring.datasource.url=jdbc:log4jdbc:sqlserver://[IP]:[PORT];databaseName=[DatabaseName]

예시)

spring.datasource.url=jdbc:log4jdbc:sqlserver://192.168.10.4:1433;databaseName=FactoryView_SAMIL

서버 디렉터리 구조 잡기

서버 리소스 디렉터리 생성

$ cd /home/e3view

$ mkdir FactoryView

$ mkdir deploy

파일질라 접속

리소스파일 복사

/home/e3view/FactoryView

1. 디렉터리에 동봉된 resources/FactoryView 안의 디렉터리 복사 붙여넣기

/home/e3view/deploy

2. 디렉터리에 동봉된 resouces/deploy 안의 파일들 복사 붙여넣기

배포 스크립트 권한 부여 및 배포스크립트 실행

배포스크립트 비밀번호 묻지않고 실행하기

$ ssh-keygen -t rsa

전부 Enter

$ cd /home/e3view/.ssh

$ sudo vim id_rsa.pub

id_rsa.pub 내용 전체 복사

$ cd ~/.ssh

$ sudo vim authorized_keys

마지막줄에 붙여넣기

배포스크립트 실행

$ cd /home/e3view

$ ./deploy.sh alpha

(2) 프로그램 설치 방법

FactoryView 프로그램은 http://211.44.136.9 로 접속하면 다운로드 받을 수 있다.

FactoryView 관리자 프로그램

FactoryView 관리자 프로그램의 설치프로그램을 실행한다.

< FactoryView 관리자 프로그램의 설치 프로그램 이미지 >

아래 그림의 창이 나오면 추가 정보를 누르고 실행버튼을 누른다.

FactoryView 설치 마법사의 안내 절차에 따라 진행한다.

FactoryView 관리자 프로그램 설치가 끝나면 프로그램 아이콘으로 프로그램을 실행한다.

< FactoryView 관리자 프로그램의 실행프로그램 이미지 >

FactoryView 작업자 프로그램

FactoryView 작업자 프로그램의 설치프로그램을 실행한다.

< FactoryView 작업자 프로그램의 설치프로그램 이미지 >

아래 그림의 창이 나오면 추가 정보를 누르고 실행버튼을 누른다.

FactoryView 설치 마법사의 안내 절차에 따라 진행한다.

FactoryView 작업자 프로그램 설치가 끝나면 프로그램 아이콘으로 프로그램을 실행한다.

< FactoryView 작업자 프로그램의 실행프로그램 이미지 >

FactoryView 현황판 프로그램

FactoryView 현황판 프로그램의 설치프로그램을 실행한다.

< FactoryView 현황판 프로그램의 설치프로그램 이미지 >

아래 그림의 창이 나오면 추가 정보를 누르고 실행버튼을 누른다.

FactoryView 설치 마법사의 안내 절차에 따라 진행한다.

FactoryView 현황판 프로그램 설치가 끝나면 프로그램 아이콘으로 프로그램을 실행한다.

< FactoryView 현황판 프로그램의 실행프로그램 이미지 >

(3) 데이터베이스 백업 및 복원 방안

백업 방식
백업종류
백업방법	정기 백업
	수동 백업
백업위치
백업주기	매일 1회 / 24시에 정기 백업 수행
보관주기	1주일
보관장소

백업 및 복원 방안

복원 방식
복원 절차	- 문제없이 이전 데이터로만 복원하고자 할 때, 현재 DB를 수동 백업 후 해당 백업본을 제외한 가장 최근의 백업파일을 이용해 복원 수행 - 시스템 또는 데이터베이스 문제로 인해 데이터를 사용할 수 없을 때는, 현재 데이터베이스를 백업하는 과정을 생략하고 복원작업 수행

MSSQL 데이터베이스 수동 백업

SSMS(SQL Server Management Studio)를 이용한 백업 수행

백업할 데이터베이스를 마우스 우클릭 > 태스크 > 백업을 클릭한다.

백업을 진행할 데이터베이스를 확인한 후 백업할 위치를 설정하고 확인 버튼을 누르면 백업이 된다.

백업 위치 설정

백업 위치 변경 및 파일명 수정을 원할 시 제거 버튼을 누른 후 추가 버튼을 누른다.

백업 위치 설정 및 파일명 수정을 위해 (...) 버튼을 누른다.

저장 경로 선택 후 파일명을 입력하고 확인 버튼을 누른다.

수정한 경로 및 파일명을 확인 후 확인 버튼을 누른다.

MSSQL 데이터베이스 복원 방안

SSMS(SQL Server Management Studio)를 이용한 복원 수행

복원할 데이터베이스를 마우스 우클릭 > 태스크 > 복원 > 데이터베이스를 클릭한다.

백업한 데이터를 불러오기 위해 디바이스를 체크한 후 (...) 버튼을 누른다.

추가 버튼을 누른다.

불러올 백업파일을 선택 후 확인 버튼을 누른다.

왼쪽 탐색 메뉴에서 옵션을 누른다.

기존 데이터베이스 덮어쓰기와 대상 데이터베이스에 대한 기존 연결 닫기를 체크한 뒤 확인 버튼을 누른다.

(4) 장애 시 대책

장애처리 절차

유형별 장애 발생상황

하드웨어 문제

서버의 하드웨어적 문제로 인한 시스템 장애 발생

전원, CPU, Memory, 디스크 등의 하드웨어적 장애

운영체제 문제

운영체제 이상으로 인한 서버 시스템 또는 클라이언트에서의 프로그램 실행이 불가능한 장애 발생

네트워크 문제

네트워크 접속 문제로 인한 서비스 이용 불가

데이터베이스 문제

DBMS 인스턴스 문제로 인한 CRUD 작업 불가

소프트웨어 문제

관리자/작업자/현황판 응용 프로그램 오류로 서비스 이용 불가

장애 관리 등급 기준

등급	A (심각, 즉시 대응 필요)
유형	시스템 전체를 사용하지 못하는 문제 - 하드웨어 문제 - 하드웨어 문제 - 네트워크 문제 - 데이터베이스 문제
처리 절차	1. 관련 전문기관에 장애 처리 요청 - 네트워크 문제 2. 유지보수 지원 요청 - 하드웨어, 데이터베이스 문제

등급	B (중요, 빠른 지원 필요)
유형	다수 사용자에게 동일한 문제 발생 - 소프트웨어 문제
처리 절차	1. 유지보수 지원 요청 - 소프트웨어 문제

등급	C (일반, 운영자 처리)
유형	단일 사용자에게 문제 발생 - 사용 미숙에 의한 장애 발생 - 운영체제 문제 - 해당 PC/프로그램 환경설정 문제
처리 절차	1. 운영자의 사용자 교육 시행 2. 운영자지침에 따른 환경설정 확인 3. 유지보수 지원 요청

네트워크 문제 처리방안

문제 유형	상세 정보	처리방안
서버 접속 환경설정 문제	환경설정의 서버 주소 또는 접속 계정 정보 오류로 인한 접속 문제	운영자지침에 따른 환경설정 수정 조치
네트워크 장비 문제	네트워크 관련 하드웨어 장비 결함으로 인한 문제 발생	관련 전문기관에 장애 처리 요청

데이터베이스 문제 처리방안

문제 유형	상세 정보	처리방안
데이터베이스 접속 오류	데이터베이스 파일 오류	백업된 최근 데이터베이스 파일로 복구 데이터베이스 재시작 / 재설치
연결 오류	AppServer에서의 접속 불량 사용자 프로그램에서의 조회 오류 데이터베이스 연결 불량	AppServer 점검 서버 접속 환경설정 문제 학인 데이터베이스 오류 점검 / 네트워크 장애 점검
백업 시 오류	일 단위 백업 불량 일주일 기한 백업파일 관리 문제	데이터베이스 백업 스케줄링 점검 데이터베이스 서버 용량 문제 학인
복구 시 오류	복구 시 오류 발생	백업파일 점검 데이터베이스 점검 데이터베이스 서버 용량 문제 확인

문제 유형	상세 정보	처리방안
업데이트 불가	프로그램 업데이트 불가능	프로그램 환경설정 점검 AppServer 서비스 상태 점검
실행 불가	프로그램 실행 안되는 문제 발생	프로그램 환경설정 점검 AppServer 서비스 상태 점검 데이터베이스 점검
로그인 불가	실행 후 로그인 불가능한 문제 로그인 시도 시 프로그램 응답없음	로그인 계정정보 확인 프로그램 강제종료 후 환경설정의 서버정보 확인
연결 오류	프로그램 실행 중 연결 오류 조회시간 만료 및 응답없음	네트워크 점검 AppServer 서비스 상태 점검
오류 발생	프로그램 런 타임 오류 프로그램 등록/수정/삭제 기능 오류	오류화면 캡쳐해 유지보수 업체에 전달 후 유지보수 지원 요청 오류 발생 기능, 메뉴, 오류 내용을 유지보수 업체에 전달 후 지원 요청
논리 오류 발생	프로세스에 따른 의도된 결과값이 나오지 않는 경우	논리적 오류 발생내용과 발생시점을 유지보수 업체에 전달 후 지원 요청

소프트웨어 문제 처리방안

하드웨어 문제 처리방안

문제 유형	상세 정보	처리방안
전원	하드웨어 장비 장애 또는 천재지변으로 인한 전원 문제 발생	서버 하드웨어에 마련된 예비 배터리를 미리 완충해놓은 후, 전원 장애 발생 시 연결해 1차적으로 처리 전문업체에 지원 요청
운영체제	시스템 오류 발생 재부팅 시 부팅 오류 발생	재부팅 시도, 운영체제 업데이트 내역 확인 부팅 오류 또는 정상 작동이 불가능할 시 운영체제 재설치
서버 시스템 오류	서버 시스템 오류 발생 서버가 의도치 않은 중단 상태에 있음	운영체제 문제 확인 서버 문제 및 에러 로그 확인 후 조치
클라이언트 PC 오류	클라이언트 PC 부팅 오류 클라이언트 시스템 오류 발생	운영체제 문제 확인 클라이언트 PC 환경설정 및 업데이트 내역 확인
네트워크 인식 오류	네트워크 인식 안됨	네트워크 문제 확인 네트워크 환경설정 확인

(5) 비상연락망

성 명	전화번호	부서	담 당 업 무
심윤섭	031-776-0677 (회사 대표번호)	지능화팀	프로젝트 지원
김용겸	031-776-0677 (회사 대표번호)	지능화팀	프로젝트 지원, 업체 유지보수 지원

※ 작성 방법

- 사용자, 관리자(운영자)별로 업무에 참조할 수 있는 매뉴얼을 작성한다

- 목차는 사용자 매뉴얼과 관리자(운영자) 매뉴얼로 구분하여 기술함

- 사용자 매뉴얼은 온라인 매뉴얼로 대체하여 작성할 수 있음

(1) 시스템 개요

(2) 시스템 구성도

(3) 메뉴 구조도

(4) 공통사항은 각 화면에서 공통적으로 적용되는 사용 방법을 기술함

(5) 사용자 화면 설명

1) 화면별 설명은 작성된 모든 화면에 대해 아래 내용들을 기술함

. 화면명, 화면에 대한 설명, 화면구성(실행화면 캡춰), 실행 순서 및 주요 기능(이벤트) 설명, 참고사항 및 제약사항 등

2. 관리자(운영자) 메뉴얼

(1) 상용소프트웨어 관리는 관련된 설치 방법, 환경 설정 방법, 작동 방법, 종료 방법, 패치방법 등을 기술함

(2) 응용소프트웨어 관리는 설치 방법, 디렉토리 구조 및 내용 설명, 작동 순서, 종료 순서, UpGrade 방법 등을 기술함

(3) 사용자 및 프로그램 관리는 사용자 권한설정, 프로그램 등록 및 삭제 방법, 버전 관리방법 등을 기술함

(4) 보안 관리는 보안 적용 내용 및 관리 방안을 기술함

(5) 장애 대책은 장애 유형, 장애 유형별 대처 방안, 백업 및 복구 방안 등을 기술함

(6) 비상 연락망은 장애 유형별 담당자 및 긴급 연락처를 기술함