INNORIX On-premise 배포 및 관리

Check System Requirements

INNORIX On-premise 설치 전에 서버 환경이 요구 사항을 충족하는지 확인합니다.

본 장에서는 INNORIX 설치 및 운영에 필요한 운영 체제, Docker, 네트워크 및 스토리지 요구 사항을 안내합니다.

하드웨어 요구 사항

INNORIX On-premise 운영을 위해 아래 하드웨어 환경을 권장합니다.

최소 사양

권장 사양

ℹ️ 실제 필요한 시스템 자원은 파일 전송량, 동시 사용자 수, 파일 처리 규모 및 운영 환경에 따라 달라질 수 있습니다.

운영 체제 요구 사항

INNORIX On-premise는 아래 Linux 운영 체제 환경을 지원합니다.

네트워크 요구 사항

INNORIX 서버는 클라이언트 및 연결 대상 시스템과 안정적인 통신이 가능해야 합니다.

설치 전 다음 항목을 확인합니다.

서버 IP 주소

• INNORIX 서비스가 실행될 서버 IP 주소 확인
• Docker Swarm 설정 시 해당 IP 주소를 적용합니다.

네트워크 연결

• 내부 네트워크 또는 외부 네트워크 환경에 따라 접근 경로를 구성합니다.
• 파일 전송 대상 시스템과 통신 가능한 환경이어야 합니다.

방화벽 설정

• INNORIX 서비스 운영에 필요한 포트(80, 443, 8077)를 방화벽 정책에 반영해야 합니다.

소프트웨어 요구 사항

INNORIX On-premise 설치를 위해 다음 소프트웨어 환경이 필요합니다.

Docker 요구 사항

INNORIX는 Docker Container 기반으로 운영되며 아래 Docker 환경이 필요합니다.

Docker 설치 전 기존 Docker 관련 패키지 또는 Container Runtime 환경으로 인한 충돌이 발생하지 않도록 사전 확인이 필요합니다.

스토리지 요구 사항

INNORIX 운영을 위해 시스템 영역과 파일 저장 영역을 구분하여 구성하는 것을 권장합니다.

시스템 영역

사용 목적:

• Docker 설치 파일
• INNORIX Container
• 서비스 설정 파일
• 로그 데이터

Install Docker

INNORIX는 Docker Container 기반으로 동작합니다.

본 장에서는 INNORIX 배포를 위한 Docker 실행 환경을 구성합니다.

Docker 설치 전 Node.js 환경을 구성하고, Docker 관련 패키지를 설치한 후 Docker 서비스를 활성화합니다.

NodeSource Repository 구성

Node.js 설치를 위해 NodeSource Repository를 설정합니다.

운영 체제 환경에 따라 아래 명령을 실행합니다.

RHEL 기반 Linux

NodeSource Repository 설정 전 curl 패키지를 설치합니다.

sudo dnf install -y curl

NodeSource Repository를 추가합니다.

curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -

Debian 기반 Linux

curl 패키지를 설치합니다.

sudo apt install -y curl

NodeSource Repository를 추가합니다.

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

Node.js 설치

NodeSource Repository 설정이 완료되면 Node.js를 설치합니다.

INNORIX 설치 환경에서는 Node.js 22.x 버전을 사용합니다.

RHEL 기반 Linux

sudo dnf install -y nodejs

Debian 기반 Linux

sudo apt install -y nodejs

기존 Docker 관련 라이브러리 제거

Docker 설치 전 기존 Docker 또는 Container Runtime 관련 패키지가 설치되어 있는 경우 충돌 방지를 위해 제거합니다.

RHEL 기반 Linux

sudo dnf remove -y podman buildah docker docker-common docker-selinux docker-engine

Debian 기반 Linux

sudo apt remove -y docker docker-engine docker.io containerd runc

Docker Repository 구성

Docker 공식 Repository를 추가하여 최신 Docker Engine 패키지를 설치할 수 있도록 구성합니다.

RHEL 기반 Linux

Docker Repository 추가를 위해 dnf 플러그인을 설치합니다.

sudo dnf -y install dnf-plugins-core

Docker 공식 Repository를 추가합니다.

sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

Debian 기반 Linux

Docker Repository 인증을 위한 Key 저장 경로를 생성합니다.

sudo mkdir -p /etc/apt/keyrings

Docker GPG Key를 추가합니다.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Docker Repository를 추가합니다.

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

시스템 패키지 업데이트

Docker 설치 전 시스템 패키지를 최신 상태로 업데이트합니다.

RHEL 기반 Linux

sudo dnf update

Debian 기반 Linux

sudo apt update

Docker Engine 및 구성 요소 설치

Docker 실행에 필요한 핵심 구성 요소를 설치합니다.

설치 구성 요소:

• Docker Engine
• Docker CLI
• containerd
• Docker Buildx Plugin
• Docker Compose Plugin

RHEL 기반 Linux

sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Debian 기반 Linux

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Docker 서비스 시작 및 활성화

Docker 서비스를 시작하고 시스템 재부팅 후에도 자동으로 실행되도록 설정합니다.

sudo systemctl enable --now docker

Docker 설치 확인

Docker 설치가 정상적으로 완료되었는지 확인합니다.

Docker 버전을 확인합니다.

docker --version

Docker Compose 버전을 확인합니다.

docker compose version

정상적으로 버전 정보가 출력되면 Docker 환경 구성이 완료된 것입니다.

Get the INNORIX Container

Docker 환경 구성이 완료되면 INNORIX On-premise 패키지를 다운로드하고 배포를 위한 설치 환경을 준비합니다.

본 장에서는 INNORIX 설치 패키지 다운로드, 압축 해제 및 설치 디렉터리 구성을 진행합니다.

On-premise 패키지 다운로드

INNORIX On-premise 설치 패키지를 다운로드합니다.

다운로드 패키지에는 INNORIX 서비스 실행에 필요한 Docker 구성 파일과 설치 스크립트가 포함되어 있습니다.

패키지 다운로드 URL

wget https://innorix.com/package/INNORIX-ONPREM-PACKAGE.tar.gz

다운로드가 완료되면 파일이 정상적으로 저장되었는지 확인합니다.

ls -lh INNORIX-ONPREM-PACKAGE.tar.gz

설치 패키지 압축 해제

다운로드한 On-premise 패키지의 압축을 해제합니다.

패키지 압축을 해제합니다.

tar -xzf INNORIX-ONPREM-PACKAGE.tar.gz

압축 해제 후 생성된 INNORIX 설치 디렉터리로 이동합니다.

cd INNORIX-ONPREM-PACKAGE/

설치 디렉터리 확인

압축 해제가 완료되면 INNORIX 배포에 필요한 파일이 생성됩니다.

설치 디렉터리 구조를 확인합니다.

ls -la

주요 구성 파일:

Deploy INNORIX

Docker 환경 구성과 INNORIX 설치 패키지 준비가 완료되면 INNORIX 서비스를 배포합니다.

본 장에서는 Docker Swarm 설정, 설치 스크립트 실행, INNORIX 서비스 시작 및 Hyperlink Agent 실행 과정을 안내합니다.

Docker Swarm 환경 구성

INNORIX Container가 실행될 서버 환경을 설정합니다.

설치 디렉터리로 이동합니다.

cd INNORIX-ONPREM-PACKAGE/

Docker Compose 설정 파일을 열어 서버 IP 주소를 환경에 맞게 변경합니다.

sudo nano docker-compose.yml

설정 항목:

설정 변경이 완료되면 파일을 저장합니다.

서버 설치 실행

INNORIX 설치 스크립트를 실행하여 Container 및 서비스 환경을 구성합니다.

설치 디렉터리에서 아래 명령을 실행합니다.

sudo bash ./install.sh

설치 스크립트는 다음 작업을 수행합니다.

• INNORIX Container 설치
• Docker 환경 구성 적용
• 서비스 실행 환경 준비
• 필요한 설정 적용

설치가 완료되면 다음 단계에서 INNORIX 서비스를 시작합니다.

INNORIX 서비스 시작

설치가 완료된 후 INNORIX 전체 시스템을 시작합니다.

아래 명령을 실행합니다.

sudo bash ./start.sh

서비스 시작이 완료되면 INNORIX Container가 실행되고 Web Console 접속이 가능한 상태가 됩니다.

Hyperlink Agent 실행

INNORIX Hyperlink Agent를 실행합니다.

Hyperlink Agent는 INNORIX 서비스 운영을 위한 Agent 프로그램입니다.

Agent 시작

/opt/INNORIX/INNORIX_Exacoola start

Agent 중지

/opt/INNORIX/INNORIX_Exacoola stop

Agent 실행 후 정상적으로 동작하는지 확인합니다.

배포 상태 확인

INNORIX 서비스 배포가 완료되면 실행 상태를 확인합니다.

확인 항목:

정상적으로 배포가 완료되면 다음 단계인 서버 초기 설정을 진행합니다.

Configure Your Environment

INNORIX 배포가 완료되면 설치된 서버 환경에 맞게 접속 환경과 서비스 운영 설정을 구성합니다.

본 장에서는 INNORIX 서버 접속 환경, 도메인, 포트, 환경 변수 및 서비스 설정 방법을 안내합니다.

서버 접속 환경 구성

INNORIX 설치가 완료되면 Docker Swarm 설정 시 지정한 서버 IP 주소 또는 localhost를 통해 Web Console에 접속할 수 있습니다.

설치 완료 후 아래 주소 형식으로 접속합니다.

http://IP_ADDRESS

또는

http://localhost

접속 주소는 docker-compose.yml 파일에 설정한 서버 IP 주소를 기준으로 합니다.

서버 접속 확인 항목

서버 접속이 정상적으로 이루어지면 INNORIX 초기 화면으로 이동하며, 이후 관리자 계정으로 시스템 설정을 진행할 수 있습니다.

도메인 설정

운영 환경에서는 안정적인 서비스 접근과 HTTPS 적용을 위해 IP 주소 대신 도메인 사용을 권장합니다.

도메인 설정 시 DNS 환경에서 INNORIX 서버 IP 주소와 도메인을 연결합니다.

예:

도메인 설정 완료 후 사용자는 아래와 같이 접속할 수 있습니다.

https://domain

도메인을 사용하는 경우 이후 보안 설정 단계에서 SSL 인증서를 적용할 수 있습니다.

포트 설정

INNORIX 서비스 운영을 위해 네트워크 환경에 맞는 포트 설정이 필요합니다.

포트 설정은 Docker Swarm 환경 및 서버 방화벽 정책에 따라 관리합니다.

확인 항목:

포트 설정 시 다음 환경을 확인합니다.

• 서버 방화벽 정책
• 네트워크 보안 장비 정책
• 사내 접근 제어 정책
• 외부 시스템 연동 환경

환경 변수 설정

INNORIX 서비스는 Docker 환경 변수 설정을 통해 운영 환경 정보를 관리합니다.

환경 변수는 Docker Compose 설정 파일을 통해 구성합니다.

주요 설정 항목:

설정 파일(docker-compose.yml) 변경 후, docker stack deploy로 재배포하여 적용합니다.

서비스 설정

INNORIX는 Docker Swarm 기반으로 서비스 구성 요소를 관리합니다.

서비스 설정 파일:

docker-compose.yml

Docker Compose 설정에는 다음 항목이 포함됩니다.

설정 변경 후 INNORIX 서비스를 재시작하여 변경 내용을 적용합니다.

서비스 설정 완료 후 다음 항목을 확인합니다.

• Container 정상 실행 여부
• Web Console 접속 가능 여부
• 서비스 상태 정상 여부

Configure Network & Storage

INNORIX는 대용량 파일 전송 환경에서 안정적인 서비스 운영을 위해 네트워크 연결과 스토리지 구성이 중요합니다.

본 장에서는 INNORIX 서비스 운영에 필요한 네트워크 환경, 방화벽 설정, 파일 저장 영역 및 영구 스토리지 구성을 안내합니다.

네트워크 구성

INNORIX는 서버 간 파일 전송 및 사용자 접근을 위해 안정적인 네트워크 환경이 필요합니다.

설치 환경에 따라 내부 네트워크 또는 외부 네트워크 환경을 구성합니다.

네트워크 구성 항목

네트워크 확인 사항

설치 전 다음 항목을 확인합니다.

• INNORIX 서버와 연결 대상 시스템 간 통신 가능 여부
• 서버 IP 주소 정상 설정 여부
• 네트워크 지연 및 패킷 손실 여부
• 외부 Repository 및 Docker 환경 접근 가능 여부

안정적인 파일 전송 성능을 위해 파일 전송 환경에 적합한 네트워크 대역폭을 확보해야 합니다.

방화벽 설정

INNORIX 서비스 운영을 위해 서버 및 네트워크 방화벽 정책을 설정해야 합니다.

방화벽 설정 시 다음 환경을 확인합니다.

• Linux OS 방화벽 설정
• 사내 네트워크 방화벽 정책
• 보안 장비 접근 정책
• 클라우드 환경 보안 그룹 설정

방화벽 설정 항목

필요한 Port가 차단된 경우 Web Console 접속 또는 파일 전송 기능이 정상적으로 동작하지 않을 수 있습니다.

파일 스토리지 구성

INNORIX는 메모리 기반 파일 전송 방식을 사용하므로 전송 중인 파일을 임시 저장하기 위한 별도의 작업 공간이 필요하지 않습니다.

스토리지는 시스템 운영에 필요한 설정 정보, 로그 및 서비스 데이터를 저장하는 용도로 사용됩니다.

파일 스토리지 구성 권장 사항

스토리지 구성 시 고려 사항

• 시스템 운영 데이터와 로그를 위한 저장 공간을 확보합니다.
• 운영 데이터는 안정적인 영구 스토리지(Persistent Storage)에 저장하는 것을 권장합니다.
• 시스템 구성 정보와 로그 데이터는 정기적으로 백업합니다.
• 운영 환경의 디스크 사용량을 주기적으로 모니터링하여 안정적인 서비스를 유지합니다.

영구 스토리지 구성

Docker Container 환경에서는 Container 삭제 또는 재생성 시 데이터가 유지될 수 있도록 영구 스토리지(Persistent Storage)를 구성해야 합니다.

Docker Volume 또는 Bind Mount를 연결하여 서비스 데이터를 유지합니다.

영구 스토리지 구성 대상

Configure Security

INNORIX는 기업 환경에서 안전한 파일 전송 서비스를 제공하기 위해 보안 설정이 필요합니다.

본 장에서는 운영 환경에서 필요한 HTTPS, SSL 인증서, 접근 제어 및 보안 정책 설정 방법을 안내합니다.

HTTPS 구성

INNORIX Web Console 및 서비스 접근 환경은 HTTPS 사용을 권장합니다.

HTTPS를 적용하면 사용자와 INNORIX 서버 간 통신이 암호화되어 안전한 서비스 운영이 가능합니다.

HTTPS 구성 항목

HTTPS 적용 절차

1. 운영 환경에 맞는 도메인을 준비합니다.
2. SSL 인증서를 발급받습니다.
3. 인증서 파일을 서버 환경에 적용합니다.
4. INNORIX 서비스를 재시작합니다.
5. HTTPS 접속 여부를 확인합니다.

SSL 인증서 설정

SSL 인증서는 INNORIX 서버의 신뢰성을 검증하고 사용자와 서버 간 통신을 보호하기 위해 사용됩니다.

SSL 인증서 구성 항목

SSL 인증서 적용 시 확인 사항

• 인증서 유효 기간 확인
• 서비스 도메인과 인증서 도메인 일치 여부 확인
• 인증서 파일 권한 설정 확인
• 인증서 갱신 정책 수립

SSL 인증서가 만료되면 HTTPS 접속 오류가 발생할 수 있으므로 정기적인 관리가 필요합니다.

접근 제어 설정

INNORIX는 관리자 및 사용자 접근을 관리하여 시스템 보안을 유지합니다.

접근 제어 설정 시 사용자 권한과 접근 범위를 관리합니다.

접근 제어 항목

권장 보안 설정

• 관리자 계정은 별도 관리
• 초기 비밀번호 변경 권장
• 불필요한 사용자 계정 제거
• 최소 권한 원칙 적용

보안 정책 설정

기업 보안 정책에 맞게 INNORIX 운영 환경의 보안 설정을 구성합니다.

보안 정책 항목

운영 환경 권장 사항

서버 보안

• 최신 보안 패치 적용
• 불필요한 서비스 비활성화
• 관리자 접근 권한 제한

네트워크 보안

• 방화벽 정책 적용
• 허용된 네트워크에서만 접근
• 외부 접근 시 HTTPS 사용

데이터 보안

• 중요 설정 파일 접근 권한 제한
• 운영 데이터 백업 정책 적용
• 로그 모니터링 수행

Complete Initial Setup

INNORIX 배포가 완료되면 Web Console에 접속하여 초기 시스템 설정을 진행합니다.

본 장에서는 설치 완료 후 서버 상태 확인, 관리자 로그인, Workspace 생성 및 초기 운영 환경 구성을 안내합니다.

Web Console 접속

INNORIX 설치가 완료되면 Web Console을 통해 시스템 초기 설정을 진행합니다.

접속 주소는 Docker Swarm 설정 시 지정한 서버 IP 주소 또는 localhost를 사용합니다.

접속 URL:

http://IP_ADDRESS

또는

http://localhost

정상적으로 접속되면 INNORIX 초기 화면이 표시됩니다.

접속이 되지 않는 경우 다음 항목을 확인합니다.

서버 상태 확인

Web Console 접속 후 시스템이 정상적으로 준비되었는지 확인합니다.

서버 상태 확인을 통해 INNORIX 서비스 실행 여부와 초기 구성 상태를 확인할 수 있습니다.

확인 항목

모든 상태가 정상인 경우 관리자 로그인 단계로 진행합니다.

관리자 계정 로그인

서버 상태 확인이 완료되면 관리자 계정으로 로그인합니다.

초기 관리자 계정 정보:

관리자 로그인 후 권장 작업

보안을 위해 최초 로그인 후 다음 작업을 권장합니다.

• 초기 관리자 비밀번호 변경
• 관리자 계정 정보 관리
• 사용자 권한 정책 설정
• 운영 관리자 추가 등록

Workspace 생성

INNORIX 기능 사용을 위해 Workspace를 생성합니다.

Workspace는 INNORIX 운영 환경에서 파일 전송 작업과 시스템 구성을 관리하는 기본 작업 공간입니다.

Workspace 생성 절차

1. 관리자 계정으로 로그인합니다.
2. Workspace 생성 메뉴로 이동합니다.
3. Workspace 정보를 입력합니다.
4. Workspace 생성을 완료합니다.

Workspace 구성 항목

인증 키 생성

라이선스 활성화를 위해 Workspace에서 인증 키를 생성합니다.

생성된 인증 키는 라이선스 발급 과정에서 사용됩니다.

인증 키 생성 절차

1. Workspace 생성 완료
2. 인증 키 생성
3. 생성된 Authentication Key 복사
4. 라이선스 발급 페이지에서 사용

인증 키 관리 주의 사항

• 인증 키는 외부에 노출되지 않도록 관리합니다.
• 라이선스 발급 완료 후 안전하게 보관합니다.
• 필요 시 재발급 절차를 진행합니다.

초기 시스템 설정

초기 설정 완료 후 운영 환경에 맞게 기본 시스템 구성을 진행합니다.

주요 설정 항목:

초기 설정 완료 확인

Verify Your Installation

INNORIX 설치 및 초기 설정이 완료되면 시스템이 정상적으로 동작하는지 확인합니다.

본 장에서는 서비스 상태, 시스템 상태, 네트워크 연결 및 파일 전송 테스트를 통해 설치 완료 여부를 검증합니다.

서비스 상태 확인

INNORIX 서비스가 정상적으로 실행되고 있는지 확인합니다.

Docker 기반으로 실행되는 각 서비스 서비스의 상태를 확인합니다.

확인 항목

확인 내용

정상 상태:

• Container가 정상 실행 중
• 서비스 오류 없음
• Hyperlink Agent 정상 동작
• Web Console 접근 가능

서비스 상태에 문제가 있는 경우 Docker Container 로그 및 시스템 로그를 확인합니다.

시스템 상태 확인

INNORIX 운영 환경이 정상적으로 구성되었는지 확인합니다.

시스템 확인 항목

확인 사항

설치 완료 후 다음 상태를 확인합니다.

• 시스템 자원 부족 여부
• Storage 여유 공간 확보 여부
• 서비스 실행에 필요한 환경 정상 여부
• 운영 중 발생 가능한 장애 요소 확인

특히 대용량 파일 전송 환경에서는 Storage 사용량과 Disk 여유 공간을 지속적으로 관리해야 합니다.

네트워크 연결 확인

INNORIX는 서버 간 파일 전송 및 사용자 접근을 위해 안정적인 네트워크 연결이 필요합니다.

설치 후 네트워크 연결 상태를 확인합니다.

네트워크 확인 항목

확인 방법

다음 항목을 확인합니다.

• 설정한 IP 주소 또는 도메인으로 접속 가능 여부
• 방화벽 정책 정상 적용 여부
• 서비스 Port 접근 가능 여부
• 연결 대상 시스템과 통신 가능 여부

파일 전송 테스트

설치 완료 후 실제 파일 전송 테스트를 수행하여 INNORIX 기능이 정상 동작하는지 확인합니다.

테스트 절차

1. 관리자 계정으로 Web Console 접속
2. 테스트용 파일 준비
3. 파일 전송 작업 생성
4. 전송 대상 시스템 연결
5. 파일 전송 실행
6. 전송 결과 확인

파일 전송 확인 항목

정상 동작 기준

정상적으로 설치된 경우:

• 파일 전송 작업 생성 가능
• 전송 대상 연결 정상
• 파일 전송 완료 상태 확인 가능
• 전송 결과 및 로그 확인 가능

Back Up & Restore

INNORIX 운영 환경에서는 시스템 장애, 서버 변경 및 운영 데이터 손실에 대비하기 위해 정기적인 백업 정책이 필요합니다.

본 장에서는 INNORIX 운영에 필요한 시스템 구성 정보와 데이터를 백업하고, 장애 발생 시 복원하는 절차를 안내합니다.

백업 대상 확인

백업 작업을 수행하기 전에 INNORIX 운영 환경에서 관리해야 하는 백업 대상을 확인합니다.

백업 대상은 시스템 구성 정보와 운영 데이터로 구분됩니다.

백업 대상

백업 전 확인 사항

백업 전에 다음 항목을 확인합니다.

• 백업 저장 공간 확보 여부
• 백업 대상 파일 접근 권한 확인
• 현재 INNORIX 서비스 상태 확인
• 백업 파일 저장 위치 확인

시스템 구성 백업

시스템 구성 백업은 INNORIX 서비스를 동일한 환경으로 복구하기 위해 필요한 설정 정보를 저장하는 과정입니다.

시스템 구성 백업 대상

시스템 구성 백업 절차

1. INNORIX 설치 디렉터리 확인
2. Docker Compose 및 환경 설정 파일 백업
3. 백업 파일 저장 위치 이동
4. 백업 파일 정상 생성 여부 확인

권장 사항

• 주요 설정 변경 전 백업 수행
• 운영 서버와 분리된 위치에 백업 저장
• 백업 파일 접근 권한 제한
• 변경 이력 관리

데이터 백업

데이터 백업은 INNORIX 운영 중 생성되는 주요 데이터를 보호하기 위한 작업입니다.

데이터 백업 대상

데이터 백업 시 고려 사항

• 데이터 용량에 따른 백업 시간 고려
• 운영 환경 영향 최소화
• 정기적인 백업 정책 적용
• 백업 완료 후 데이터 정상 여부 확인

복원 절차

장애 발생 또는 시스템 재구성이 필요한 경우 백업 데이터를 이용하여 INNORIX 환경을 복원합니다.

복원 전 준비 사항

복원 작업 전에 다음 항목을 확인합니다.

복원 절차

1. INNORIX 서비스 상태 확인
2. 필요한 경우 서비스 중지
3. 시스템 구성 파일 복원
4. 데이터 복원
5. 서비스 재시작
6. 정상 동작 여부 확인

복원 확인

복원 완료 후 시스템 및 서비스가 정상적으로 동작하는지 확인합니다.

복원 확인 항목

복원 완료 기준

복원이 정상적으로 완료되면 다음 항목을 확인합니다.

• Web Console 접속 가능
• 관리자 로그인 정상
• 기존 설정 유지
• Workspace 및 사용자 정보 확인 가능
• 파일 전송 기능 정상 동작

백업 및 복원 완료 확인

Upgrade INNORIX

INNORIX는 Docker Container 기반으로 운영되며, 새로운 버전의 Container Image를 적용하는 방식으로 업그레이드를 수행합니다.

업그레이드 작업 전 기존 운영 환경을 보호하기 위해 사전 백업을 수행하고, 서비스 영향도를 확인한 후 안전하게 진행해야 합니다.

본 장에서는 INNORIX 버전 업그레이드를 위한 준비, Container Image 업데이트, 서비스 적용 및 업그레이드 검증 절차를 안내합니다.

업그레이드 준비

업그레이드를 진행하기 전에 현재 운영 환경과 시스템 상태를 확인합니다.

사전 확인 항목

업그레이드 전 준비 사항

업그레이드 전에 다음 작업을 수행합니다.

• 현재 INNORIX 설정 백업
• 운영 데이터 백업
• Docker 환경 상태 확인
• 관리자 작업 일정 확인
• 서비스 중단 필요 여부 검토

안정적인 업그레이드를 위해 운영 환경에서는 유지보수 시간에 작업하는 것을 권장합니다.

컨테이너 이미지 업데이트

INNORIX 업그레이드는 최신 Container Image를 로드하여 적용하는 방식으로 진행합니다.

Container Image 업데이트 절차

1. Docker 환경 상태 확인
2. 최신 INNORIX Container Image 로드
3. 기존 Image와 신규 Image 확인
4. 업데이트 대상 Image 적용

확인 항목

주의 사항

• 업그레이드 전 기존 Image 삭제를 권장하지 않습니다.
• 문제 발생 시 롤백을 위해 이전 Image를 유지합니다.

서비스 업그레이드

최신 Container Image를 반영한 후 기존 서비스를 새로운 버전으로 교체합니다.

업그레이드 과정에서 기존 환경 설정, 네트워크 및 영구 스토리지는 그대로 유지되며, Container만 새로운 버전으로 교체됩니다.

업그레이드를 수행하기 전에 반드시 시스템 구성 및 운영 데이터를 백업하는 것을 권장합니다.

서비스 업그레이드 절차

Step 1. 현재 서비스 상태 확인

현재 배포된 서비스와 실행 상태를 확인합니다.

docker stack services exacoola

각 서비스의 REPLICAS 값(예: node-app 3/3)이 정상인지 확인합니다.

개별 Container(태스크) 단위로 확인하려면 다음 명령을 사용합니다.

docker stack ps exacoola

Step 2. 최신 Container Image 반영

INNORIX 서비스는 오프라인 이미지(.tar) 방식으로 배포됩니다.

전달받은 최신 이미지 파일을 로드합니다.

docker load -i ./exacoola-images.tar

로드가 완료되면 새로운 Image가 정상적으로 저장되었는지 확인합니다.

docker images

Step 3. 서비스 업그레이드 (재배포)

로드한 최신 Container Image를 사용하여 서비스를 재배포합니다.

sudo docker stack deploy -c docker-compose.yml exacoola

Docker Swarm은 변경된 Image를 감지하여 node-app 서비스를 1개씩 순차적으로(롤링 업데이트) 교체합니다.

기존 Volume 및 운영 데이터는 그대로 유지된 상태로 Container만 교체됩니다.

Step 4. 서비스 실행 확인

Container가 정상적으로 재배포되었는지 확인합니다.

docker stack services exacoola

node-app의 REPLICAS가 3/3으로 표시되면 정상입니다.

태스크별 상태와 재배포 시점을 확인하려면 다음 명령을 사용합니다.

docker stack ps exacoola

Step 5. 서비스 로그 확인

업그레이드 과정에서 오류가 발생하지 않았는지 로그를 확인합니다.

docker service logs exacoola_node-app

실시간 로그 및 최근 로그만 확인하려면 다음 명령을 사용합니다.

docker service logs -f --tail=100 exacoola_node-app

다른 서비스의 로그도 동일한 방식으로 확인할 수 있습니다.

docker service logs exacoola_mysql

docker service logs exacoola_redis

Docker Swarm 기반 업그레이드

INNORIX는 Docker Swarm(단일 노드) 를 이용하여 모든 서비스를 관리합니다.

업그레이드 시 docker stack deploy는 기존 설정을 유지한 상태에서 변경된 Image만 반영하여 Container를 재생성합니다.

유지되는 구성 항목

업그레이드 후 확인 사항

업그레이드가 완료되면 다음 항목을 확인합니다.

• 모든 서비스의 REPLICAS가 정상(node-app 3/3)인지 확인
• Web Console 정상 접속 여부 확인
• 관리자 로그인 가능 여부 확인
• Workspace 정상 조회 여부 확인
• License 정상 적용 여부 확인
• Hyperlink Agent 정상 동작 여부 확인
• 파일 전송 작업 생성 및 실행 여부 확인

권장 사항

운영 환경에서는 다음 사항을 권장합니다.

• 업그레이드 전 시스템 구성 및 운영 데이터 백업
• 기존 Container Image 보관
• 운영 시간 외 유지보수 시간에 업그레이드 수행
• 업그레이드 완료 후 서비스 로그 확인
• 실제 파일 전송 테스트를 통해 정상 동작 여부 검증

업그레이드 확인

업그레이드 완료 후 서비스가 정상적으로 동작하는지 확인합니다.

서비스 확인 항목

기능 테스트

업그레이드 후 다음 기능을 확인합니다.

• 관리자 로그인 정상 여부
• Workspace 정보 유지 여부
• 사용자 정보 유지 여부
• 파일 전송 작업 생성 가능 여부
• 파일 전송 완료 상태 확인

롤백 절차

업그레이드 후 문제가 발생하는 경우 이전 버전의 Container Image를 사용하여 서비스를 이전 상태로 복원할 수 있습니다.

롤백을 수행하기 전에 현재 서비스 상태와 로그를 확인하고, 이전 버전의 Image가 서버에 존재하는지 확인합니다.

롤백 절차

Step 1. 현재 서비스 상태 확인

현재 배포된 서비스와 실행 상태를 확인합니다.

docker stack services exacoola

개별 Container(태스크) 단위로 확인하려면 다음 명령을 사용합니다.

docker stack ps exacoola

Step 2. 현재 로그 확인

업그레이드 과정에서 발생한 오류를 확인합니다.

docker service logs exacoola_node-app

실시간 로그를 확인하려면 다음 명령을 사용합니다.

docker service logs -f --tail=100 exacoola_node-app

Step 3. 이전 버전 Image 확인

로컬에 보관되어 있는 이전 버전의 Image와 Tag를 확인합니다.

docker images

목록에서 롤백 대상 버전(예: exacoola-node:v3.1.0)이 존재하는지 확인합니다.

예)

exacoola-node    v3.2.0    (현재 버전)
exacoola-node    v3.1.0    (롤백 대상)

이전 버전 Image가 목록에 없는 경우, 보관된 이미지 tar 파일을 먼저 로드합니다.

docker load -i ./exacoola-images-v3.1.0.tar

Step 4. 이전 버전 적용

docker-compose.yml에서 이전 버전으로 되돌릴 서비스의 Image Tag를 변경합니다.

node-app과 node-init은 동일한 Image를 사용하므로 두 서비스 모두 변경합니다.

예)

image: exacoola-node:v3.1.0

설정을 저장한 후, 변경된 Image로 서비스를 재배포합니다.

sudo docker stack deploy -c docker-compose.yml exacoola

Docker Swarm은 변경된 Image Tag를 감지하여 서비스를 이전 버전으로 재배포합니다.

기존 Volume 및 운영 데이터는 그대로 유지됩니다.

Step 5. 서비스 실행 확인

Container가 이전 버전으로 정상 재배포되었는지 확인합니다.

docker stack services exacoola

IMAGE 컬럼이 롤백 대상 버전(exacoola-node:v3.1.0)으로 표시되고, node-app의 REPLICAS가 3/3으로 표시되면 정상입니다.

태스크별 상태와 재배포 시점을 확인하려면 다음 명령을 사용합니다.

docker stack ps exacoola

ℹ️ node-init 서비스는 초기화 전용 서비스로, Shutdown 또는 Complete 상태로 표시되는 것이 정상입니다.

Step 6. 서비스 로그 확인

롤백 후 오류 없이 서비스가 시작되었는지 확인합니다.

docker service logs exacoola_node-app

특정 서비스만 확인하려면 다음 명령을 사용합니다.

docker service logs exacoola_mysql

docker service logs exacoola_redis

롤백 완료 확인

Troubleshooting

INNORIX 설치 및 운영 과정에서 발생할 수 있는 문제를 신속하게 확인하고 해결하기 위해 주요 장애 유형별 점검 방법을 제공합니다.

본 장에서는 Docker 설치, Container 배포, 서비스 실행, 네트워크 연결, 라이선스 활성화 및 로그 분석 방법을 안내합니다.

Docker 설치 문제

Docker 설치 과정에서 패키지 충돌, Repository 설정 오류 또는 Docker 서비스 실행 문제로 인해 설치가 정상적으로 완료되지 않을 수 있습니다.

주요 증상 및 원인

Docker 상태 확인

Docker 서비스 상태를 확인합니다.

systemctl status docker

Docker 버전을 확인합니다.

docker --version

Docker Compose 버전을 확인합니다.

docker compose version

조치 사항

문제가 지속되는 경우 다음 항목을 확인합니다.

• 지원 운영 체제 버전 확인
• Docker Engine 요구 버전 확인
• 기존 Container Runtime 충돌 여부 확인
• 서버 인터넷 연결 상태 확인

컨테이너 배포 문제

INNORIX Container 배포 과정에서 Docker Compose 설정 오류 또는 Image 다운로드 문제로 인해 Container가 정상적으로 생성되지 않을 수 있습니다.

주요 증상 및 원인

Container 상태 확인

배포된 서비스의 상태를 확인합니다.

docker stack services exacoola

각 서비스의 REPLICAS 값이 정상적으로 표시되는지 확인합니다.

개별 Container(태스크) 단위의 상태를 확인합니다.

docker stack ps exacoola

각 태스크의 CURRENT STATE가 Running 상태인지 확인합니다.

확인 사항

Container 배포 문제가 발생하면 다음 항목을 확인합니다.

• Docker 서비스 실행 여부
• docker-compose.yml 설정 값
• Server IP 설정 여부
• Storage Mount 상태
• Container Image 정상 다운로드 여부

서비스 실행 문제

Container가 정상적으로 실행되었지만 INNORIX 서비스 접근 또는 기능 동작에 문제가 발생할 수 있습니다.

주요 증상 및 원인

서비스 확인 항목

Hyperlink Agent 확인

Agent 상태 확인이 필요한 경우 아래 명령을 통해 실행 상태를 확인합니다.

시작:

/opt/INNORIX/INNORIX_Exacoola start

중지:

/opt/INNORIX/INNORIX_Exacoola stop

네트워크 연결 문제

INNORIX는 Web Console 접근 및 시스템 간 파일 전송을 위해 정상적인 네트워크 연결이 필요합니다.

주요 증상 및 원인

네트워크 점검 항목

조치 사항

네트워크 문제가 발생하면 다음 순서로 확인합니다.

1. 서버 네트워크 연결 확인
2. IP 및 DNS 설정 확인
3. Firewall 정책 확인
4. 서비스 Port 접근 확인
5. 대상 시스템 연결 상태 확인

라이선스 활성화 문제

INNORIX의 모든 기능을 사용하기 위해서는 정상적인 라이선스 활성화가 필요합니다.

주요 증상 및 원인

라이선스 확인 항목

조치 절차

1. Workspace 생성 상태 확인
2. Authentication Key 확인
3. License Key 재입력
4. 서버 활성화 상태 확인

로그 확인 및 장애 분석

문제 발생 시 로그를 통해 정확한 원인을 분석합니다.

로그 분석은 서비스 오류, Container 문제 및 네트워크 장애 원인 파악에 활용됩니다.

로그 확인 대상

Docker 로그 확인

서비스 로그를 확인합니다.

docker service logs exacoola_[service_name]

장애 분석 절차

1. 장애 발생 시간 확인
2. 서비스 상태 확인
3. Container 상태 확인
4. 관련 로그 확인
5. 원인 분석 및 조치 수행
6. 서비스 정상 여부 확인

문제 해결 완료 확인