환경설정 및 운영
본 절에서는 환경설정 파일이 위치하는 디렉터리 구조와 파일, 운영 방법에 대해서 설명한다.
1. 디렉터리 구조
JEUS(WAS)의 디렉터리 구조는 아래와 같다. domains 폴더 하위에 servers 폴더가 있고 application 폴더 내에 OpenFrame GW 바이너리가 위치한다.
$JEUS_HOME/domains
+---- <domain_name>
+---- bin
+---- config
+---- lib
+---- servers
+---- <server_name>
+---- bin
+---- logs
+---- lib
+---- application
|---- logback.xml
|---- *.jar
+---- UninstallerData
+---- scripts
+---- webterminal
+---- ofgwconf
|---- ofgw.properties
+---- cpm
+---- license
+---- initScreen
|---- initScreen.txt
|---- vtam.properties
|--- dhcp.properties
- servers/<server_name>/lib/application
-
ofgw-71-<revision>.jar 및 기타 라이브러리가 위치한다. (logback.xml 설정 파일은 해당 폴더에 위치)
폴더 또는 파일 설명 logback.xml
로그 파일의 파일 포맷 및 로그 레벨을 정의하는 설정 파일이다. 자세한 설명은 logback.xml를 참고한다.
- servers/<server_name>/lib/application/ofgwconf
-
OpenFrame GW 설정 파일이 위치한다.
폴더 또는 파일 설명 ofgw.properties
OpenFrame GW와 웹 터미널 환경을 정의하는 설정 파일이다. 자세한 설명은 ofgw.properties를 참고한다.
cpm
웹 터미널에서 사용하는 CPM 파일이 위치하는 디렉터리이다.
license
OpenFrame GW 라이선스 파일이 위치하는 디렉터리이다.
initScreen
터미널 접속할 때 초기 화면 출력을 나타내기 위한 initScreen.txt 파일이 저장된다. 해당 파일에 대한 자세한 설명은 initScreen.txt를 참고한다.
vtam.properties
멀티 포트와 그에 따른 init screen을 지정할 수 있도록 지원하는 설정 파일이다. 자세한 설명은 vtam.properties를 참고한다.
dhcp.properties
DHCP 환경에서 호스트 이름을 이용해 LU 자동할당 기능을 지원하는 설정 파일이다. 자세한 설명은 dhcp.properties를 참고한다.
WAS에 설정되어 있는 애플리케이션이 디플로이된 폴더의 위치는 다음의 경로에 저장된다.
${JEUS_HOME}/domains/<domain_name>/servers/<server_name>/lib/application/
<application_id>/
각 디렉터리에 대한 자세한 내용은 "JEUS Application & Deployment 안내서"의 "1.1.4. 애플리케이션 관리 디렉터리 구조"를 참고한다. |
2. OpenFrame GW 설정 파일
본 절에서는 OpenFrame GW를 사용하기 위해서 필요한 설정 파일의 항목과 설정 예에 대해서 설명한다.
2.1. ofgw.properties
ofgw.properties 속성 파일의 각 항목에 대한 설명은 다음과 같다.
gw.name =gateway_name datasource.name = datasource_name lu.port = port_no lu.autoalloc = {yes|no} vtamProperties = {yes|no} dhcpProperties = {yes|no} debug.time = {yes|no} translate.threadPool.core = translate_threadpool_core translate.threadPool.max = translate_threadpool_max translate.threadPool.keepAliveTime = translate_threadpool_keepalivetime db.threadPool.core = db_threadpool_core db.threadPool.max = db_threadpool_max db.threadPool.keepAliveTime = db_threadpool_keepalivetime coroutine.threadPool.core = coroutine_threadpool_core coroutine.threadPool.max = coroutine_threadpool_max coroutine.threadPool.keepAliveTime = coroutine_threadpool_keepalivetime rmi = {yes|no} rmi.ip = rmi_deployed_ip_address rmi.port = rmi_port_no rmi.serviceName = rmi_service_name rmi.proc = aim_procedure_name rmi.smqn = aim_smqn_name rmi.addLength = {yes|no} rmi.logMessage = {yes|no} cpmpath = cpmfile_path terminal.timeout = terminal_timeout terminal.aliveCheck = {yes|no} terminal.aliveInterval = terminal_alive_checktime sslEnabled = {yes|no} tmax.retrytime = tmax_retrytime tmax.node.list = node_name_list tmax.node.NODE1.name = node_name tmax.node.NODE1.ip = node_ip_address tmax.node.NODE1.port = node_port_no tmax.node.NODE1.min = node_min tmax.node.NODE1.max = node_max tmax.node.NODE1.rate = node_rate tmax.node.NODE1.timeout = node_timeput tmax.node.NODE1.idletime = node_idletime
항목 | 설명 |
---|---|
gw.name |
DB에 들어갈 게이트웨이 이름을 설정한다. |
datasource.name |
JEUS에 설정 파일(domain.xml)에 지정된 DB 이름을 설정한다. |
lu.port |
3270 터미널이 사용할 포트 번호를 설정한다. |
lu.autoalloc |
LU 자동할당 기능을 사용할지 여부를 설정한다. RMI 서버를 사용하는 경우 yes로 설정해야 한다. (기본값: yes) |
lu.checkStatus |
LU Status 체크 기능을 사용할지 여부를 설정한다. (기본값: no) |
vtamProperties |
VTAM에서 포트별로 접속 가능한 터미널과 Region을 지정하고 각각의 첫 화면을 지정하여 사용할 수 있도록 하는 기능을 사용할지 여부를 설정한다. (기본값: no) |
dhcpProperties |
DHCP 환경에서 dhcp.properties에 기재된 호스트 이름에 매핑되는 IP로 LU 자동할당 기능을 사용할지 여부를 설정한다. (기본값: no) |
debug.time |
디버그하는 경우 성능체크를 위해 사용할 time 로그를 출력할지 설정한다. |
translate.threadPool.core |
최소 Work Thread 개수를 설정한다. |
translate.threadPool.max |
최대 Work Thread 개수를 설정한다. |
translate.threadPool.keepAliveTime |
최소 Work Thread 개수보다 많은 Thread가 생성되어 있을 때 Idle 상태의 사용되지 않는 Work Thread가 종료되기 위한 시간을 설정한다. (단위: s) |
db.threadPool.core |
최소 DB Thread 개수를 설정한다. |
db.threadPool.max |
최대 DB Thread 개수를 설정한다. |
db.threadPool.keepAliveTime |
최소 DB Thread 개수보다 많은 Thread가 생성되어 있을 때 Idle 상태의 사용되지 않는 DB Thread가 종료되기 위한 시간을 설정한다. (단위: s) |
coroutine.threadPool.core |
최소 Coroutine Thread 개수를 설정한다. |
coroutine.threadPool.max |
최대 Coroutine Thread 개수를 설정한다. |
coroutine.threadPool.keepAliveTime |
최소 Coroutine Thread 개수보다 많은 Thread가 생성되어 있을 때 Idle 상태의 사용되지 않는 Coroutine Thread가 종료되기 위한 시간을 설정한다. (단위: s) |
rmi |
RMI 서버의 사용 여부를 설정한다. (기본값: no) |
rmi.ip |
RMI 서버가 위치한 IP Address를 설정한다(OpenFrame GW가 디플로이된 IP와 동일하게 작성하면 된다). |
rmi.port |
RMI 서버가 데이터를 받아들일 포트 번호를 설정한다. |
rmi.serviceName |
RMI 서버가 데이터를 받아들일 서비스 이름을 설정한다. |
rmi.proc |
RMI 서버가 WEBAIM과 통신할 때 데이터를 전송할 AIM의 프러시저를 설정한다. |
rmi.smqn |
RMI 서버가 WEBAIM과 통신할 때 데이터를 전송할 AIM의 SMQN을 설정한다. |
rmi.addLength |
RMI 서버가 전달받을 데이터 앞에 길이 정보를 추가하여 WEBAIM과 통신할지 설정한다. (기본값: no) |
rmi.logMessage |
RMI 서버가 전달받은 데이터와 전송할 데이터를 Logging 할 것인지 설정한다. yes로 설정 시 Logger Encoding을 SJIS로 변경해야 한다. (기본값: no) |
cpmpath |
웹 터미널에서 사용될 CPM 파일의 path를 지정한다. 항목에 값을 설정하지 않으면 default 폴더의 위치를 사용한다. (기본 경로: $OFGW_HOME/ofgwconf/cpm/) |
terminal.timeout |
서버와 통신하지 않는 idle 상태인 웹 터미널의 연결을 해제하기 위한 임계 시간을 설정한다. 0으로 설정하면 타임아웃을 사용하지 않는다. (단위: s, 기본값: 0) |
terminal.aliveCheck |
OpenFrame GW에서 3270 에뮬레이터 및 웹 터미널의 연결 상태 확인을 사용할 때 설정한다. 네트워크 유실 등으로 접속이 끊어진 경우 자동으로 터미널 자원 해제를 진행한다.
|
terminal.aliveInterval |
OpenFrame GW와 연결된 터미널들의 접속 상태를 확인하기 위한 시간을 설정한다. (단위: s, 기본값: 10, 최솟값: 10) |
sslEnabled |
OpenFrame GW에서 3270 에뮬레이터와 통신하는 경우 SSL 설정을 사용할 때 설정한다.
|
tmax.retrytime |
Tmax의 커넥션이 끊어졌을 때 다시 연결을 시도하기까지의 대기 시간을 설정한다. (단위: ms) |
tmax.node.list |
Tmax 노드 이름을 구분자(,)로 설정한다. (예: NODE1,NODE2,NODE3...) |
tmax.node.[NODENAME].name |
Tmax 노드 이름을 설정한다. |
tmax.node.[NODENAME].ip |
Tmax 노드의 IP을 설정한다. |
tmax.node.[NODENAME].port |
Tmax 노드의 포트 번호($TMAX_HOST_PORT)를 설정한다. |
tmax.node.[NODENAME].min |
Tmax 커넥션의 최소 개수를 설정한다. |
tmax.node.[NODENAME].max |
Tmax 커넥션의 최대 개수를 설정한다. |
tmax.node.[NODENAME].rate |
커넥션이 부족할 때 커넥션 증가시키는 개수를 설정한다. |
tmax.node.[NODENAME].timeout |
커넥션을 시도할 때 해당 커넥션의 대기 시간을 설정한다. (단위: ms) |
tmax.node.[NODENAME].idletime |
커넥션의 개수가 min보다 많은 상태에서 사용하지 않아 커넥션을 줄이는데 기준 시간을 설정한다. (단위: s) |
|
다음은 ofgw.properties 속성 파일의 설정 예이다.
gw.name = ofgw datasource.name = ds1 lu.port = 5556 lu.autoalloc = yes lu.checkStatus = yes debug.time = no translate.threadPool.core = 5 translate.threadPool.max = 30 translate.threadPool.keepAliveTime = 60 db.threadPool.core = 5 db.threadPool.max = 30 db.threadPool.keepAliveTime = 60 coroutine.threadPool.core = 5 coroutine.threadPool.max = 30 coroutine.threadPool.keepAliveTime = 60 rmi = yes rmi.ip = 192.144.121.11 rmi.port = 5557 rmi.serviceName = ofgwaad rmi.proc = aadproc rmi.smqn = aadsmqn cpmpath = terminal.timeout = 60 sslEnabled = no tmax.node.list = NODE1 tmax.node.NODE1.name = NODE1 tmax.node.NODE1.ip = 192.168.37.11 tmax.node.NODE1.port = 6511 tmax.node.NODE1.min = 5 tmax.node.NODE1.max = 10 tmax.node.NODE1.rate = 2 tmax.node.NODE1.timeout = 20000 tmax.node.NODE1.idletime = 90 tmax.retrytime = 60000
2.2. vtam.properties
vtam.properties 속성 파일은 ofgw.properties에서 vtamProperties 설정이 yes일 경우 동작한다.
현재는 OSC와의 연동하는 경우에만 지원하고, OSI와 AIM은 해당 기능을 지원하지 않는다. |
vtam.properties 속성 파일의 각 항목에 대한 설명은 다음과 같다.
port.list = port_name [PORT_NAME].port = port_no [PORT_NAME].regionList = region_list [PORT_NAME].initScreen = init_screen_filename
항목 | 설명 |
---|---|
port.list |
VTAM에 설정되어 있는 포트를 지정하기 위한 포트 이름을 설정한다. (예: PORT1,PORT2,PORT3...) |
[PORT_NAME].port |
PORT_NAME의 포트 번호를 설정한다. 포트 번호는 VTAM 리소스에 등록되어 있는 포트들을 설정하여 사용해야 한다. 여러 포트 번호 중 한 개는 반드시 ofgw.properties의 lu.port의 값과 일치해야 한다. |
[PORT_NAME].regionList |
VTAM 포트로 접속한 터미널에서 접속을 허용할 Region 서버 이름을 지정한다. (예: OSC00001, OSC00002...) |
[PORT_NAME].initScreen |
해당 포트로 터미널이 접속할 경우 보여줄 첫 화면 파일을 지정한다($OFGW_HOME/ofgwconf/initScreen 폴더 내에 위치한 파일이어야 한다). |
다음은 vtam.properties 속성 파일의 설정 예이다.
port.list = PORT1,PORT2,PORT3 PORT1.port = 5556 PORT1.regionList = OSCOIVP1 PORT1.initScreen = initScreen.txt PORT2.port= 5558 PORT2.regionList = OSCOIVP2 PORT2.initScreen = initScreen2.txt PORT3.port = 5570 PORT3.regionList = OSCOIVP1,OSCOIVP2 PORT3.initScreen = initScreen3.txt
2.3. dhcp.properties
dhcp.properties 속성 파일은 ofgw.properties에서 dhcpProperties 설정이 yes인 경우에만 동작한다.
dhcp.properties 속성 파일의 각 항목에 대한 설명은 다음과 같다.
hostnames = [HOST_NAME1]:[IP1],[HOST_NAME1]:[IP2],[HOST_NAME2]:[IP3],...,\ [HOST_NAME5]:[IP10],...
항목 | 설명 |
---|---|
hostnames |
DHCP 환경에서 웹 터미널을 통해 입력된 호스트 이름에 매핑되는 IP 값을 저장한다.
|
다음은 dhcp.properties 속성 파일의 설정 예이다.
hostnames=hostname1:192.168.11.23,hostname2:192.168.14.32,hostname2:192.168.14.33,\ hostname1:192.168.11.31,hostname3:192.168.17.87
DHCP LU 할당 기능 사용 방법
DHCP 환경에서는 IP가 유동적으로 변하기 때문에 고정된 IP를 사용하여 LU를 할당하려면 다른 방식을 사용해야 한다. 이에 따라 OpenFrame GW에서는 웹 터미널의 쿼리 파라미터로 입력되는 호스트 이름을 사용하여 고정 IP를 추출하고, 이를 사용해 LU를 할당하는 방법을 제공한다.
다음은 dhcpProperties를 yes로 설정한 뒤 웹 터미널을 사용해 DHCP 환경에서 LU를 할당 받는 방법의 예이다.
host를 키로 하고 LU 할당에 사용하고자 하는 호스트 이름을 Base64로 2번 인코딩(hostname1 → aG9zdG5hbWUx → YUc5emRHNWhiV1V4)하여 값으로 설정한 뒤 웹 터미널에 접속한다.
그 후 기존 방식대로 접속을 시도하면 OpenFrame GW에서는 dhcpProperties가 yes로 설정되어 있는 것을 확인하고, 입력된 호스트 이름(hostname1)을 사용해 dhcp.properties에서 IP를 가져온다. 그리고 접속한 웹 터미널의 IP(127.0.0.1)는 무시한 채 가져온 IP(192.168.11.23, 192.168.11.31)를 사용하여 LU 할당을 시도한다.
호스트 이름을 사용한 LU 할당 방식은 오직 위와 같은 방식으로 웹 터미널로 접속했을 때만 동작하며, RMI나 3270 에뮬레이터로 접속했을 경우에는 기존의 LU 할당 방식을 사용한다. |
2.4. initScreen.txt
initScreen.txt 파일은 편집기를 이용하여 터미널에 초기 접속할 때 출력되는 화면 구성을 저장한다. 파일에 작성된 내용이 터미널 화면에 그대로 출력되고 파일 마지막 출력의 바로 다음란에 입력필드와 커서가 위치한다. 파일에 다음과 같이 설정하면 터미널에 동일한 간격과 공백이 출력된다.
ofgw.properties의 vtamProperties 항목을 yes로 설정하여 VTAM 포트별 접속 가능하도록 설정하는 경우 vtam.properties의 [PORT_NAME].initScreen에 설정된 파일의 화면이 출력된다. vtamProperties 항목을 no로 설정한다면 initScreen.txt의 화면이 출력된다.
@ THIS TERMINAL CONNECTED TO THE OPENFRAME GW ******. *******. ******. **. **. ********. *******. ********. **. **. **....**. **...... **....**. **. **. **. **. **. **. ... **. **. **. **. *******. **. **.**.**. **. **. *******. **. ****. **.**.**. **. **. **...... **. ****. **.**.**. **. **. **. **. .**. ********. ********. **. ********. ***..***. ******.. **. *******. **.. **. ...... .. ....... .. .. @ ENTER COMMAND :
다음은 초기 접속 화면이 출력된 예이다.
logback.xml
logback.xml에 로그 파일의 파일 포맷 및 로그 레벨을 정의한다.
다음은 속성 파일의 설정 예이다.
<?xml version="1.0" encoding="UTF-8"?> <configuration scan="true" scanPeriod="30 seconds"> <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> <encoder> <charset>UTF-8</charset> <pattern>[%d{yyyy-MM-dd}T%d{HH:mm:ss.SSSSS}][OFGW|%-24logger{0}][%-24t{1}][%.-1level] %msg%n</pattern> </encoder> </appender> <property name="USER_HOME" value="/home/user/logs" /> <appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender"> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <fileNamePattern>${USER_HOME}/ofgw-%d{yyyy-MM-dd}.%i.log</fileNamePattern> <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"> <maxFileSize>300MB</maxFileSize> </timeBasedFileNamingAndTriggeringPolicy> <maxHistory>30</maxHistory> </rollingPolicy> <encoder> <pattern>[%d{yyyy-MM-dd}T%d{HH:mm:ss.SSSSS}][OFGW|%-24logger{0}][%-24t{1}][%.-1level] %msg%n</pattern> </encoder> </appender> <logger name="com.tmax.ofgw.region.LUManager" level="DEBUG" /> <logger name="com.tmax.ofgw.Main" level="INFO" /> <logger name="com.tmax.ofgw.region.Region" level="ERROR" /> <logger name="com.tmax.webtnio" level="OFF" /> <root level="DEBUG"> <appender-ref ref="STDOUT" /> <appender-ref ref="ROLLING" /> </root> </configuration>
다음은 속성 파일의 항목에 대한 설명이다.
항목 | 설명 |
---|---|
<configuration> |
scan, scanperiod 항목을 설정하면 동적으로 로그 레벨을 변경할 수 있다. |
<appender> |
LogBack에서 제공하는 형태로 로거 형식을 추가할 수 있다(Event 마다 로그를 기록하는 것이 가능하도록 한다).
|
<charset> |
로그 파일의 인코딩 형식을 설정한다. ofgw.properties의 rmi.addLength가 yes로 설정된 경우 해당 속성을 SJIS로 설정해야 한다. (기본값: UTF-8) |
<property> |
property에 설정한 값은 변수처럼 사용이 가능하다. 이 파일에서 USER_HOME은 로그 파일의 경로(Log File Path)로 사용된다. |
<fileNamepatten> |
로그 파일명의 패턴을 설정한다. 기본값은 날짜 형식과 인덱스("%i")가 추가된다. |
<maxFileSize> |
파일 하나당 최대 용량을 설정한다. |
<maxHistory> |
파일의 로그를 남기는 최대 일수를 정한다. 값을 넘어가면 가장 오래된 순으로 자동으로 삭제된다. |
<pattern> |
출력되는 로그의 형식을 설정한다. |
<logger name> |
<root>에 설정된 로그 레벨과는 별개로 특정 클래스를 지정하여 로그 레벨을 설정한다. |
<root> |
로그 레벨을 설정하고 <appender>를 추가하여 해당 로거 형식에 로그 레벨로 출력된다. <logger name>이 기재되어 있지 않은 경우 기본적으로 <root>에 기재된 로그 레벨로 각 클래스의 로그 레벨이 설정되며, <logger name>이 설정된 클래스의 경우 <root>에 기재된 로그 레벨을 덮어 쓴다. |
해당 항목은 기본으로 제공하는 항목이며, 운영자가 환경에 맞도록 커스터마이징하여 사용해야 한다. 추가 항목에 대해서는 logback 관련 안내서를 참고한다. |
3. OpenFrame GW 운영
본 절에서는 OpenFrame GW를 기동하고 종료하는 과정과 로그 포맷을 출력하는 방법에 대해서 설명한다.
3.1. OpenFrame GW 기동 및 종료
본 절에서는 OpenFrame GW를 기동하거나 종료하는 과정에 대해서 설명한다.
기동
JEUS의 DAS 위에 OpenFrame GW를 올렸을 경우 DAS를 기동시킬 때 <lifecyle-invocation> 속성에 의해 OpenFrame GW도 함께 기동된다. DAS를 시작하는 스크립트는 startDomainAdminServer로 DAS의 도메인 이름, JEUS를 시작할 수 있는 권한을 가진 사용자명과 패스워드가 필요하다.
JEUS_HOME/bin 하위에서 실행할 경우에는 이 모든 값이 필요하지만, DAS의 DOMAIN_HOME 하위에서 실행할 때에는 도메인 이름을 생략할 수 있다.
OpenFrame GW 기동은 위치에 따라 다음의 과정으로 진행한다.
-
startDomainAdminServer로 서버를 기동한다.
$JEUS_HOME/bin/startDomainAdminServer -domain <domain_name> -u <user_name> -p <password>
또는
$JEUS_HOME/domains/<domain_name>/bin/startDomainAdminServer -u <user_name> -p <password>
-
startManagedServer로 서버를 기동한다.
$JEUS_HOME/domains/<domain_name>/servers/<server_name>/bin/startManagedServer -u <user_name> -p <password>
또는
$startManagedServer -domain <domain_name> -server <server_name> -u <user_name> -p <password> -dasurl <das_ip:das_baseport>
-
jps 툴을 이용하여 DomainAdminServerBootstrapper와 ServerBootstrapper가 정상 기동되었는지 확인한다.
$jps 23541 Jps 22797 DomainAdminServerBootstrapper 22981 ServerBootstrapper
종료
OpenFrame GW를 종료하기 위해서는 OpenFrame GW가 설치된 환경의 서버를 종료해야 한다.
-
Managed Server를 종료할 경우 stopServer 명령으로 종료한다.
$JEUS_HOME/bin/stopServer -u <user_name> -p <password> -host <server_ip:server_baseport>
-
DomainAdminServer를 종료할 경우 마찬가지로 stopServer 명령으로 종료한다.
$JEUS_HOME/bin/stopServer -u <user_name> -p <password> -host <server_ip:server_baseport>
JEUS의 기동/종료는 WebAdmin을 사용하거나, jeusadmin 또는 해당 명령어를 사용해서 할 수 있다. 본 매뉴얼에서는 UNIX 환경에서의 기동/종료에 대해서만 기술한다. 다른 방법으로 기동/종료하는 방법에 대한 자세한 사항은 "JEUS Domain 안내서" 또는 "JEUS WebAdmin 안내서"를 참고한다.
기동 및 종료 시 DB 작업 수행
OpenFrame GW는 OFM_BASE_VTAM_GATEWAY, OFM_BASE_VTAM_ACTIVE_LU 테이블에 정보를 업데이트 작업을 수행한다.
기동할 때는 이전의 비정상 종료로 인해 정보가 남아있는지 확인하여 남아있다면 해당 정보를 삭제하고 새롭게 기동되는 OpenFrame GW 정보를 업데이트 작업을 수행한다. 종료하는 경우는 게이트웨이에 연결되어 있던 터미널의 연결이 끊어짐과 동시에 해당 서버에 등록된 OpenFrame GW의 정보를 삭제 및 터미널 정보도 DB에서 삭제된다.
다음은 OpenFrame GW의 정보를 vtamadm 툴로 확인하는 방법이다.
-
게이트웨이 정보 확인
다음은 OpenFrame GW의 게이트웨이 정보를 확인하는 명령어 사용법이다.
$ vtamadm -w VTAM Gateway List ================================================================================= NO. GATEWAY_NAME CLID IP_ADDR:PORT NODENAME --------------------------------------------------------------------------------- 1 ofgw_A 3 192.168.105.208:5668 NODE1 =================================================================================
-
터미널 LU 정보 확인
OpenFrame GW에 연결되어 있는 터미널 LU 정보를 확인하는 명령어 사용법이다.
$ vtamadm -l Active LU information connected to VTAM ========================================================================================================== NO. LU TYPE CLID NODENAME IP_ADDR LOGON_REGION USERID ---------------------------------------------------------------------------------------------------------- 1 OSC00001 OSC REGION NODE1 2 OIVPTRM1 IBM-3278-2-E 5 NODE1 192.168.105.208 OSC00001 ROOT 3 TSO TSO NODE1 ==========================================================================================================
vtamadm 명령어는 OpenFrame에서 제공하는 툴이다. 해당 툴에 대한 자세한 내용은 OpenFrame Base "툴 참조 안내서"를 참고한다. |
Online Region 기동 및 종료
기본적으로 OpenFrame GW는 OpenFrame의 Region 서버의 기동과 종료에 상관없이 기동 상태를 유지한다. OpenFrame GW가 기동 중 Online Region이 기동되면 해당 Region의 정보를 DB에서 가져온다.
종료할 때에도 해당 Online Region에 접속해 있던(LOGON된 LU) 터미널의 연결을 끊고 DB에서도 정보를 삭제한다.
OpenFrame 엔진이 모두 다운된 경우에는 Tmax 커넥션이 없어져서 다음과 같은 로그가 발생된다.
[2022-06-22T14:49:07.00976][OFGW|WebtChannelHandlerImpl ][Main [server1-67] ][I] Close connection for node[NODE1], clid=[246] [2022-06-22T14:49:07.00982][OFGW|WebTerminal ][Main [server1-67] ][D] WebTerminal disconnect status=transaction_status_none [2022-06-22T14:49:07.00984][OFGW|WebSocketEndPoint ][Main [server1-67] ][D] handleClose(...) [2022-06-22T14:49:07.00985][OFGW|WebtChannelHandlerImpl ][Main [server1-67] ][I] System channel[NODE1] (clid=[246])
이때 ofgw.properties 설정 파일에 설정된 tmax.retrytime에 지정된 시간 이후에 다시 커넥션을 시도하여 OpenFrame이 기동 중인지 체크하고 연결을 시도한다.
3.2. 로그 출력 포맷
logback.xml에 기본으로 제공하는 표준 출력은 다음과 같은 포맷으로 출력된다. 각 사이트 환경에 맞추어서 변경해서 사용한다.
[시간] [로그 레벨] [Thread] [로거] [메시지]
항목 | 설명 |
---|---|
[시간] |
"시간:분:초.밀리초" 형식으로 출력된다. |
[로그 레벨] |
지정된 로그 레벨을 출력한다. OpenFrame GW는 'ERROR', 'WARN', 'INFO', 'DEBUG' 4가지 레벨의 로그 출력을 제공한다. 다음은 설정 가능한 로그 레벨이다.
로그 레벨은 ERROR < WARN < INFO < DEBUG 순서로 되어있으며, 상위 레벨의 로그는 하위 레벨의 로그 출력을 포함하고 있다. (예: 로그 레벨이 INFO로 설정되어 있다면 로그 레벨 ERROR와 WARN을 포함하여 로그를 출력) |
[Thread] |
현재 Thread Name이다. logging하는 프로세스(서버 또는 런처(Launcher))와 Thread 번호로 표현된다. 각 항목을 하이픈(-)으로 구분된다. |
[로거] |
'로거 이름 + {length}'이다. length는 최대 자릿수이다. |
[메시지] |
로그 메시지 alias이다. |
다음은 logback.xml 설정 파일에 로그 출력 패턴을 정의하여 출력한 예이다.
<pattern>[%d{yyyy-MM-dd}T%d{HH:mm:ss.SSSSS}][OFGW|%-24logger{0}][%-24t{1}][%.-1level] %msg%n</pattern>
[2022-06-22T14:49:06.00599][OFGW|WebtChannelHandlerImpl ][Main [server1-67] ][D] Node name=NODE1 [2022-06-22T14:49:06.00599][OFGW|WebtChannelHandlerImpl ][Main [server1-67] ][D] Msg for OFGW [2022-06-22T14:49:06.00600][OFGW|WebtChannelHandlerImpl ][Main [server1-67] ][D] Tmax msg type: tpsendto [2022-06-22T14:49:06.00600][OFGW|VtamMessage ][Main [server1-67] ][D] [VtamMessage] vtam header: msgtype(aim(104)) clid(0) gwclid(0) regionclid(0) [2022-06-22T14:49:06.00600][OFGW|VtamMessage ][Main [server1-67] ][D] [VtamMessage] msgflag : 0, ipaddr : ... [2022-06-22T14:49:06.00650][OFGW|TranslateWorker ][Worker-3 [server1-79] ][D] Send to TransWorker channel there is something to work for terminal(id=13) [2022-06-22T14:49:06.00651][OFGW|TransWorkerChImpl ][Worker-3 [server1-79] ][D] WorkerThread > TransWorker channel [2022-06-22T14:49:06.00651][OFGW|TransWorkerChImpl ][Worker-3 [server1-79] ][D] writeQ for Web count=1 [2022-06-22T14:49:06.00654][OFGW|TransWorkerChImpl ][Worker-3 [server1-79] ][I] < Send to WebTerminal(id=13,len=2468) [2022-06-22T14:49:06.00654][OFGW|TransWorkerChImpl ][Worker-3 [server1-79] ][D] < Send data(id=13): ... [2022-06-22T14:49:06.00655][OFGW|TranslateWorker ][Worker-3 [server1-79] ][D] translation(id=13) done, WorkerThread > TransWorkChannel done
4. 멀티 환경 구성
본 절에서는 멀티 환경을 구성하는 방법에 대해서 설명한다.
4.1. OpenFrame GW 멀티 노드
사용자가 부하분산 환경을 구축하기 위해 OpenFrame GW는 다음 그림과 같이 OpenFrame에 멀티 노드로 운영이 가능하다.
멀티 노드를 구성하는 경우 ofgw.properties 파일에 다음과 같이 설정한다. 해당 파일에 대한 자세한 내용은 ofgw.properties를 참고한다. 단, 하나의 OpenFrame GW로 각기 다른 OpenFrame에 설치된 노드 환경으로의 연결은 지원하지 않는다.
tmax.node.list = NODE1,NODE2
tmax.node.NODE1.name = NODE1
tmax.node.NODE1.ip = 192.168.33.1
tmax.node.NODE1.port = 6300
tmax.node.NODE1.min = 2
tmax.node.NODE1.max = 6
tmax.node.NODE1.rate = 3
tmax.node.NODE1.timeout = 10000
tmax.node.NODE1.idletime = 30000
tmax.node.NODE2.name = NODE2
tmax.node.NODE2.ip = 192.168.33.1
tmax.node.NODE2.port = 6400
tmax.node.NODE2.min = 2
tmax.node.NODE2.max = 6
tmax.node.NODE2.rate = 3
tmax.node.NODE2.timeout = 10000
tmax.node.NODE2.idletime = 30000 … 생략
OpenFrame GW와 Online Region 간 통신은 Tmax를 이용하며 커넥션 스케줄링은 Tmax가 수행하므로 OpenFrame GW는 업무 스케줄링을 담당한다. OpenFrame GW는 DB에 저장되어 있는 Online Region별 매핑 정보를 읽어와서 스케줄링한다.
4.2. OpenFrame GW 멀티 게이트웨이
WAS에 여러 개의 OpenFrame GW를 실행하는 경우 다음 그림과 같이 서버마다 OpenFrame GW를 한 개씩 실행할 수 있다.
위와 같은 환경을 구성하기 위해서는 JEUS 서버 설정은 domain.xml(${JEUS_HOME}/domains/<domain_name>/config) 설정 파일에 다음과 같이 기술해야 한다. domain.xml에 각 항목에 대한 자세한 내용은 JEUS 설정 파일을 참고한다. 이후 추가한 JEUS 서버의 각 디렉터리에 OpenFrame GW 바이너리가 lib/application 디렉터리 안에 위치해야 한다.
<servers>
<server>
<name>server1</name>
<lifecycle-invocation>
<class-name>com.tmax.ofgw.Main</class-name>
<invocation>
<invocation-method>
<method-name>init</method-name>
</invocation-method>
<invocation-type>READY</invocation-type>
</invocation>
</lifecycle-invocation>
<lifecycle-invocation>
<class-name>com.tmax.ofgw.Main</class-name>
<invocation>
<invocation-method>
<method-name>shutdown</method-name>
</invocation-method>
<invocation-type>BEFORE_UNDEPLOY</invocation-type>
</invocation>
</lifecycle-invocation>
</server>
<server>
<name>server2</name>
<lifecycle-invocation>
<class-name>com.tmax.ofgw.Main</class-name>
<invocation>
<invocation-method>
<method-name>init</method-name>
</invocation-method>
<invocation-type>READY</invocation-type>
</invocation>
</lifecycle-invocation>
<lifecycle-invocation>
<class-name>com.tmax.ofgw.Main</class-name>
<invocation>
<invocation-method>
<method-name>shutdown</method-name>
</invocation-method>
<invocation-type>BEFORE_UNDEPLOY</invocation-type>
</invocation>
</lifecycle-invocation>
</server>
...생략
</servers>
서버 추가에 대한 자세한 내용은 "JEUS Server 안내서"의 "2.2. 서버 추가"를 참고한다. |