Linux 환경에서 설치 및 확인

설치

Linux 환경의 콘솔 모드에서 설치 파일을 실행하여 HyperFrame을 설치할 수 있습니다.

  1. 설치 파일 다운로드

    TmaxSoft 홈페이지의 [다운로드] 페이지에서 HyperFrame의 설치 파일을 다운로드한 후 설치할 Linux 환경으로 복사합니다.

  2. 설치 파일 실행 권한 부여

    설치 파일에 실행 권한을 부여합니다.

    [hyperframe@localhost /]$ chmod u+x HyperFrame21001.bin

  3. 설치 파일 실행

    설치 파일을 실행합니다.

    [hyperframe@localhost /]$ ./HyperFrame21001.bin
Preparing to install
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

===============================================================================
HyperFrame21                                     (created with InstallAnywhere)
-------------------------------------------------------------------------------

Preparing CONSOLE Mode Installation...

  4. 라이선스 동의

    HyperFrame 라이선스 내용을 확인하고, 동의 여부를 선택합니다. 이때 <Enter> 키를 누르면 라이선스 내용을 끝까지 확인할 수 있습니다.

    ===============================================================================
License Agreement
-----------------

Installation and Use of HyperFrame21 Requires Acceptance of the Following
License Agreement:

HyperFrame Release 21.1
TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement

Product : HyperFrame

This is a legal agreement between you (either an individual or an company) and
TmaxSoft, Incorporated.  By opening the sealed software package and/or by
using the software, you agree to be bound by the terms of this agreement.

TmaxSoft License
1.  Grant of License:  This TmaxSoft License Agreement ("License") permits you
to use one copy of the TmaxSoft product HyperFrame, on any single computer,
provided the software is in use on only one computer at any one time.  If this
package is a license pack, you may make and use additional copies of the
software up to the number of licensed copies authorized.  If you have multiple
licenses for the software, then at any time you may have as many copies of the
software in use as you have licenses.
  The software is "in use" on a computer when it is loaded into the temporary
memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk,
CD-ROM, or other storage devices) of that computer, except that a copy
installed on a network server for the sole purpose of distribution to other
computers is not "in use".  If the anticipated number of users of the software
will exceed the number of applicable licenses, then you must have a reasonable

PRESS <ENTER> TO CONTINUE:

    라이선스에 동의할 경우 'Y’를 입력한 후 <Enter> 키를 눌러 다음 단계로 진행합니다. 만약 동의하지 않을 경우 'N’을 입력한 후 <Enter> 키를 눌러 설치를 중단할 수 있습니다.

    mechanism or process in place to ensure that the number of persons using the
software concurrently does not exceed the number of licenses.

2.  Copyright:  The software (including any images, "applets," photographs,
animations, video, audio, music and text incorporated into the software) is
owned by TmaxSoft or its suppliers and international treaty provisions.
Therefore, you must treat the software like any other copyrighted materials
(e.g., a book or musical recording) except that you may either (a) make one
copy of the software solely for backup or archival purposes, or (b) transfer
the software to a single hard disk provided you keep the original solely for
backup or archival purposes.  You may not copy the printed materials
accompanying the software, nor print copies of any user documentation provided
in "online" or electronic form.

3.  Other restrictions: This license is your proof of license to exercise the
rights granted herein and must be retained by you. You may not rent, lease, or
transfer your rights under this license on a permanent basis provided you
transfer this license, the software, and all accompanying printed materials,
retain no copies, and the recipient agrees to the terms of this license. You
may not reverse engine, decompile, or disassemble the software, except to the
extent that the foregoing restriction is expressly prohibited by applicable
law.

PRESS <ENTER> TO CONTINUE:

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):  Y

  5. 설치 디렉터리 설정

    HyperFrame을 설치할 디렉터리를 설정합니다. 이때 기본 경로를 사용하려면 <Enter> 키를 누르고, 다른 경로를 설정하려면 원하는 경로를 입력한 후 <Enter> 키를 누릅니다.

    ===============================================================================
Choose Install Folder
---------------------

Enter the installation folder.

  Default Install Folder: /home/hfmtest/hyperframe21

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
      :

  6. HyperFrame IP 설정

    HyperFrame을 실행할 서버의 IP 주소를 입력합니다. 입력하지 않으면 기본적으로 127.0.0.1이 설정됩니다.

    ===============================================================================
Input Env :: HyperFrame Master IP
---------------------------------

Enter the HyperFrame Master IP

HyperFrame Master IP (Default: 127.0.0.1): 192.168.15.67

    IP를 127.0.0.1로 설정하면 다른 IP에서 HyperFrame WebAdmin에 접근할 수 없습니다.

  7. HyperFrame 포트 설정

    HyperFrame을 실행할 서버의 포트 번호를 입력합니다.

    ===============================================================================
input Env :: HyperFrame Master ServerPort
-----------------------------------------

Enter the HyperFrame Master ServerPort

serverPort (Default: 8005):




===============================================================================
input Env :: HyperFrame Master ConnectorPort
--------------------------------------------

Enter the HyperFrame Master ConnectorPort

connectorPort (Default: 8080):




===============================================================================
input Env :: HyperFrame Master RedirectPort
-------------------------------------------

Enter the HyperFrame Master RedirectPort

redirectPort (Default: 8443):

    HyperFrame 21 Fix#1은 Tomcat을 기반으로 하며 Server, Connector, Redirect 포트 번호를 각각 지정해야 합니다. 이때 Connector 포트 번호는 WebAdmin 접근 시 사용됩니다.

  8. 데이터베이스 벤더 설정

    HyperFrame을 실행하기 위한 외부 데이터베이스 벤더를 설정합니다. (PostgreSQL, DB2, Oracle 지원)

    ===============================================================================
input Env :: Database Vendor
----------------------------

Enter the Database Vendor (oracle, db2, postgresql)

  ->1- postgresql
    2- db2
    3- oracle

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

  9. 데이터베이스 IP 설정

    데이터베이스가 설치된 서버의 IP 주소를 입력합니다.

    ===============================================================================
input Env :: Database IP
------------------------

Enter the Database IP

Database IP (Default: 172.0.0.1):

  10. 데이터베이스 포트 설정

    데이터베이스가 실행되는 포트 번호를 입력합니다.

    ===============================================================================
input Env :: Database Port
--------------------------

Enter the Database Port

Database Port (Default: 5432):

  11. 데이터베이스 스키마 설정

    데이터베이스의 스키마(또는 SID)를 입력합니다. PostgreSQL과 DB2의 경우 스키마를 입력하고, Oracle의 경우 SID를 입력합니다.

    ===============================================================================
input Env :: Database Schema Name
---------------------------------

Enter the Database Schema Name

Database Schema Name (Default: postgresql):

  12. 데이터베이스 사용자 이름 설정

    데이터베이스의 사용자 이름을 입력합니다. 미리 생성된 사용자가 아닐 경우 HyperFrame 실행 시 오류가 발생합니다.

    ===============================================================================
input Env :: Database Username
------------------------------

Enter the Database UserName

Database Username (Default: username):

  13. 데이터베이스 사용자 비밀번호 설정

    데이터베이스의 사용자 비밀번호를 입력합니다.

    ===============================================================================
input Env :: Database Userpassword
----------------------------------

Enter the Database Userpassword

Database Userpassword (Default: password):

  14. 데이터베이스 환경 설정

    데이터베이스 설정은 환경 변수로 저장되며, .bashrc 파일에 기록됩니다. 서버 재접속 후 환경 변수 설정이 적용됩니다.

    <Enter> 키를 눌러 설치를 진행합니다.

    ===============================================================================
Database Env Setting Up..
-------------------------

When you reconnect to the server, database environment variable settings are
applied.

PRESS <ENTER> TO CONTINUE:

  15. 설치 정보 요약

    설치에 관련된 정보를 요약하여 보여줍니다. 내용을 확인한 후 <Enter> 키를 눌러 설치를 진행합니다.

    ===============================================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    HyperFrame21

Install Folder:
    /home/hfmtest/hyperframe21

Disk Space Information (for Installation Target):
    Required:    1,432.78 MegaBytes
    Available: 122,506.63 MegaBytes

PRESS <ENTER> TO CONTINUE:

  16. 설치 완료

    설치가 진행되는 동안 진행 바가 표시되며, 설치가 완료되면 완료 메시지가 출력됩니다. <Enter> 키를 눌러 설치를 종료합니다.

    ===============================================================================
Installing...
-------------

 [==================|==================|==================|==================]
 [------------------|---------------

===============================================================================
Installation Complete
---------------------

HyperFrame21 has been successfully installed to:

     /home/hfmtest/hyperframe21

PRESS <ENTER> TO EXIT THE INSTALLER:

설치 확인

디렉터리 구조

HyperFrame이 정상적으로 설치되면 다음과 같은 디렉터리 구조가 생성됩니다.

$(HYPERFRAME_HOME)
|-- bin
|-- conf
|-- dbloader
|-- elasticsearch
|-- lib
|-- logs
|-- monitoring
|-- opentelemetry-collector
|-- temp
|-- webapps
|-- work
{HYPERFRAME_HOME}

HyperFrame을 설치하는 최상위 디렉터리로 실제 디렉터리 이름과 위치는 설치할 때 결정됩니다.

bin

HyperFrame의 시작 및 종료 스크립트인 startup.sh, shutdown.sh와 같은 실행 파일들이 위치합니다.

dbloader

HyperFrame 실행 시 설정한 DB 환경 변수에 맞춰 자동으로 SQL 스크립트를 실행하기 위한 파일들이 위치합니다.

elasticsearch

Elasticsearch 7.10.0 버전이 위치합니다.
하위 디렉터리 구조에 대한 자세한 설명은 Elasticsearch의 디렉터리 구조를 참고합니다.

lib

라이브러리가 위치합니다.

logs

로그 파일이 위치합니다.

monitoring

모니터링 백엔드가 위치합니다.
하위 디렉터리 구조에 대한 자세한 설명은 모니터링 백엔드의 디렉터리 구조를 참고합니다.

opentelemetry-collector

데이터 수집 모듈(OpenTelemetry Collector)이 위치합니다.
하위 디렉터리 구조에 대한 자세한 설명은 opentelemetry-collector의 디렉터리 구조를 참고합니다.

temp

임시 저장용 디렉터리입니다.

webapps

웹 애플리케이션이 위치합니다.

work

JSP 파일을 서블릿 형태로 변환한 Java 파일과 클래스 파일이 위치합니다.

실행

HyperFrame 설치 경로의 bin 디렉터리로 이동한 후 startup.sh를 실행하면 HyperFrame이 기동됩니다.

./startup.sh

종료

HyperFrame 설치 경로의 bin 디렉터리로 이동한 후 shutdown.sh를 실행하면 HyperFrame이 종료됩니다.

./shutdown.sh