페이지 이력

버전 비교

키

이 줄이 추가되었습니다.
이 줄이 삭제되었습니다.
서식이 변경되었습니다.

Sv translation

language	ko_KR

MagicINFO Server 서비스를 등록/변경/삭제하는 방법을 가이드합니다.

서비스 등록/삭제

MagicINFO Server 서비스 실행시 기본적으로 적용하게 될 옵션을 추가로 지정하거나 변경할 수 있고, 윈도우 서비스에 삭제, 등록하여 적용시킬 수 있습니다.

예를 들어 jvm의 memory가 부족할 경우 heap memory나 perm memory 사이즈를 변경할 수 있습니다.

설정 변경 방법

아래 경로로 이동하여 "service.bat" 파일을 찾습니다.

파일 경로 : 매직인포설치경로\tomcat\bin\service.bat

2. 해당 파일을 Text Editor로 연 후 하단으로 이동하여 :installed 아래의 명령을 확인합니다. 서비스가 등록되어 실행될때 수행될 옵션을 지정할 수 있습니다.

정보

관련 옵션은 데몬 실행 설정을 참고하세요.

옵션 리스트 : https://commons.apache.org/proper/commons-daemon/procrun.html

3. 데몬 설정과 관련된 옵션을 추가/수정/삭제 한 후 등록된 서비스를 중지 후 삭제, 재시작한다재시작합니다.

서비스 중지 - 서비스 삭제 - 서비스 설치 - 서비스 재시작 순서로 실행한다실행합니다.

구분	명령어
서비스 삭제	service uninstall
서비스 설치	service install

Tomcat server.xml 설정

Tomcat이 구동될때 웹서비스가 실행되면서 필요한 각종 설정을 수정 할 수 있습니다.

해당 파일을 텍스트 에디터로 연 후 수정이 필요한 값을 수정하여 저장하고, MagicInfoPremium 서비스를 재시작하면 적용되어 실행됩니다.

파일 경로 : 매직인포설치경로\tomcat\conf\server.xml

기존 옵션 설명

옵션	설명
port	해당 connector가 동작하는 port number를 지정합니다. 해당 port가 이미 사용중인 경우 port number를 변경하여 다른 port로 사용할 수 있습니다.
maxHttpHeaderSize	HTTP Header 에 정보가 많이 실릴 경우 기본 값이 4KB 이기 때문에 서비스 특성에 맞게 조정이 필요합니다.
maxThreads	가장 중요한 옵션입니다. Tomcat 내의 Thread수를 결정 하는 옵션입니다. Thread수는 실제 Active User 수를 뜻합니다. 즉 순간 처리 가능한 Transaction 수를 의미합니다. 일반적으로 100 내외가 가장 적절하고, 트렌젝션의 무게에 따라 50~500 개 정도로 설정하는 게 일반적입니다. 이 값은 성능 테스트를 통해서 튜닝을 하면서 조정해 나가는 것이 좋습니다.
acceptCount	이 옵션은 request Queue의 길이를 정의합니다. HTTP request가 들어왔을때 idle thread가 없으면 queue에서 idle thread가 생길때 까지 요청을 대기하는 queue의 길이입니다. 보통 queue에 메세지가 쌓였다는 것은 해당 톰캣 인스턴스에 처리할 수 있는 쓰레드가 없다는 이야기이고, 모든 쓰레드를 사용해도 요청을 처리를 못한다는 것은 이미 장애 상태일 가능성이 높습니다. 그래서 큐의 길이를 길게 주는 것 보다는, 짧게 줘서, 요청을 처리할 수 없는 상황이면 빨리 에러 코드를 클라이언트에게 보내서 에러처리를 하도록 하는 것이 좋습니다. Queue의 길이가 길면, 대기 하는 시간이 길어지기 때문에 장애 상황에서도 계속 응답을 대기를 하다가 다른 장애로 전파 되는 경우가 있습니다.
maxPostSize	Tomcat을 사용시 post 로 너무 많은 데이터를 전송하게 되면 request 데이터가 초기화(null) 되는 현상이 발생합니다. post 방식으로 form 데이터를 전송할 시 form 데이터의 크기가 default 값인 2M를 초과할 시에는 별도로 설정을 해주어야 합니다.
secure SSLEnabled sslProtocol sslEnabledProtocols	SSL 설정 관련 옵션입니다. 자세한 사항은 SSL 설명을 참고하세요. ▶SSL/TLS 설정 가이드

더 다양한 옵션을 확인하고 싶으면 Tomcat 공식 사이트에서 참고할 수 있습니다.

정보
사이트 주소 : https://tomcat.apache.org/tomcat-8.0-doc/config/http.html

경고
설치된 tomcat version에 맞게 설정함을 주의하세요.

Tomcat Cache 삭제

Tomcat에 의해 웹어플리케이션이 배포되면 기본적으로 cache가 남게 되는데 웹어플리케이션 파일(매직인포설치경로\server)에 변경 사항이 생겼을경우 제대로 구동에 반영되지 않을 수 있습니다.

이때는 cache가 저장되는 폴더들의 하위 폴더와 파일들을 삭제하고 MagicInfo MagicINFO Server 서비스를 재시작하면 됩니다.

경고
cache를 삭제했을때 tomcat이 제대로 구동이 안될수 있으니 삭제 전 반드시 해당 폴더들을 백업 후 삭제해야 합니다.

폴더 경로 : tomcat\temp, tomcat\webapps, tomcat\work

Tomcat log 확인 방법

Tomcat 구동에 관련한 로그를 확인하려면 tomcat\logs 폴더 내 파일을 참고하면 됩니다. log 내용을 바탕으로 Tomcat 구동시의 문제를 파악하고 튜닝을 할 수 있습니다.

로그 파일 종류

파일명	설명
catalina.YYYY-MM-DD.log	서버의기동,정지, 서비스의개시, 정지정보(tomcat 자체에관한)
host-manager.log	Tomcat Host Manager Web app 로그 (가상호스트매니저)
manager.log	Tomcat Manager Web App 로그 (웹콘솔)
localhost.log	host( VirtualHost 같은) 한정한 로그
commons-daemon.log	데몬 (백그라운드 서비스) 실행에 대한 로그
magicinfo*.log	magicinfo 내 각 제품별 로그

Tomcat 모니터링 및 튜닝

MagicINFO server의 동작이 느려지는 문제 등을 겪을 땐 Tomcat이 사용하고 있는 thread 등의 실행 상황을 파악하고, 서버 실행 상황에 맞게 튜닝할 수 있습니다.

1. 톰캣 관리자를 이용한 모니터링

- - 톰캣 관리자를 이용해 톰캣을 모니터링 할 수 있다있습니다.
  - 서버의 상태와 요청 상태 정보를 제공하므로, 관리자가 문제를 해결할때 이 정보를 유용하게 활용할 수 있다있습니다.
  - 상용 툴 : JConsole
    정보
    참고 사이트
    JConsole https://docs.oracle.com/javase/7/docs/technotes/guides/management/jconsole.html

b. 튜닝

- - 스레드 덤프를 이용해 덤프를 분석하여 성능 저하의 원인을 파악하고 문제를 해결할 수 있다있습니다.
  - 상용 툴 : jstack, samurai, tda
    정보
    참고 사이트
    Jstack https://docs.oracle.com/javase/9/tools/jstack.htm#JSWOR748
    Samurai https://github.com/yusuke/samurai
    TDA https://github.com/irockel/tda

...

Content

공간 도구