웹서버, WAS 설치
OPENMARU iAP 화면구성
설정파일 목록
OPENMARU iAP을 통해 설치할 수 있는 설정 파일들의 목록이다.
사용자가 원하는 WAS Type과 Web Type을 갖춘 설정파일을 선택하여 설치 할 수 있다.
템플릿 파일 편집
OPENMARU iAP의 설치에 사용되는 설정 파일의 템플릿을 사용자가 설치 환경에 맞게 설정 내용을 직접 변경할 수 있는 편집 기능을 제공한다.
- 좌측 메뉴에서 템플릿 파일 편집을 선택하면 중앙에 Templates 페이지가 표시된다.
- Templates 페이지 내의 좌측 메뉴에서 변경할 설정파일 템플릿을 선택한다.
- 사용자가 작성한 템플릿 파일을 별도로 저장해야 하므로 우측 상단의 Save As 버튼을 클릭하여 새로운 템플릿의 이름으로 저장한다
- 원본 템플릿 설정 파일명 뒤에 접미사가 추가된 형태의 파일명으로 템플릿이 생성된다.
- 변경 내용을 작성한 후 Save 버튼을 클릭하여 저장한다.
- 설치 또는 설정을 변경할 설정 파일을 목록에서 선택한다.
- 설정 목록에서 설치 파일 suffix 항목을 변경 한다. 입력값은 템플릿에서 사용자가 작성한 템플릿명 뒤의 접미사 부분을 입력한다. (
server.xml~sampleDS인 경우sampleDS입력)
- 변경한 설정 파일을 저장 또는 다른이름으로 저장을 하여 변경한 템플릿 설정파일을 반영한다.
- 반영한 설정 파일로 설 치를 진행할 때, 설치하는 경우는
Component는All을 선택하고, 설치는 되어 있고 변경한 설정 파일 템플릿의 추가 반영을 원하는 경우는Component를Configuration으로 선택한 후 설치 버튼을 클릭한다.
설치 실행 옵션위 이미지는 설치 실행 팝업으로, 다음 세 가지 옵션을 제공합니다:
- Package: 설치할 패키지 유형을 선택합니다 (예: Apache Tomcat, Apache HTTPD, Spring Boot, System 패키지 등).
- Component: 설치 범위를 제어합니다.
All은 전체 설치,Packages는 바이너리만,Configuration은 설정 파일만,Init.d는 서비스 스크립트만,System은 시스템 레벨 설정만 수행합니다. - Command: 실행할 작업을 선택합니다. 각 Command의 상세 동작은 다음과 같습니다:
| Command | 동작 설명 | 사용 시나리오 |
|---|---|---|
| Setup | 전체 설치 및 설정을 수행합니다. 시스템 설정, Java 설치, 바이너리 설치, 모듈 설치, 설정 파일 배포, 서비스 스크립트 설치 등 모든 설치 작업을 수행합니다. | 새로운 서버에 처음 설치하거나 전체 재설치가 필요할 때 |
| Start | 서비스를 시작합니다. init.d 또는 systemd를 통해 서비스를 시작하고 프로세스 상태를 확인합니다. | 서버 재부팅 후 서비스 시작, 유지보수 작업 후 서비스 재개 |
| Stop | 서비스를 정지합니다. Graceful shutdown을 수행하고 프로세스 종료를 확인합니다. | 설정 변경을 위한 서비스 정지, 유지보수 작업 전 안전한 종료 |
| Restart | 서비스를 재시작합니다 (Stop + Start). 서비스를 정지한 후 다시 시작합니다. | 설정 변경 적용, JVM 옵션 변경 후 적용, 메모리 정리 및 재시작 |
| Ping | 대상 서버들에 대한 연결 테스트를 수행합니다. SSH 연결 및 서버 응답을 확인하고 인벤토리 파일을 검증합니다. | 작업 전 서버 연결 상태 확인, SSH 접근 권한 확인 |
| Report | 설치된 환경에 대한 보고서를 생성합니다. 설치된 버전 정보, 설정 정보, 시스템 환경 정보, 클러스터 구성 정보를 포함합니다. | 설치 완료 후 환경 확인, 문서화 작업, 고객 납품 시 설치 증빙 |
| Network Test | 네트워크 성능 테스트를 수행합니다. iperf를 설치하고 네트워크 대역폭 및 성능을 확인합니다. | 클러스터링 환경에서 네트워크 성능 확인, 멀티캐스트/유니캐스트 통신 테스트 |
| Cleanup | 설치된 환경을 완전히 정리(삭제)합니다. 서비스 정지, 설치 디렉토리 삭제, 서비스 스크립트 제거 등을 수행합니다. ⚠️ 되돌 릴 수 없으므로 주의가 필요합니다. | 재설치 전 기존 환경 완전 제거, 테스트 환경 정리 |
- 모든 작업이 완료 되면 사용자가 작성한 설정 파일 템플릿의 반영을 확인한다.
고객정보
제품을 설치하는 고객의 정보를 입력할 수 있는 메뉴 입니다. 여기에 입력된 정보는 설정파일의 Report Setting 값이 없을 경우 기본값으로 활용되며, 해당 내역은 설치 완료 후 생성되는 설치보고서에 자동으로 반영됩니다.
설치/설정파일 생성 및 Setting
만약, 브라우저에서 Installer Console 접속이 되지 않는다면 CLI 를 사용하여 수동으로 설치하는 방법도 제공한다.
iAP Installer 가 설치된 서버에 접속 하여 설치 경로에서 WEB/WAS 템플릿을 복사 및 설치 정보로 수정한다.
ex) APM Server / System 에이전트
cd /opt/khan/provisioning/atom/conf/
cp apache24-tomcat9.sample openmaru-apache-tomcat
vi openmaru-apache-tomcat
그리고, 설치 정보 입력 후 CLI 를 사용하여 설치한다.
OPENMARU iAP by openmaru.io
Connect https://192.168.x.x:8111/
OPENMARU-Installer>
## ApacheHTTPD 설치 CLI
action --package ApacheHTTPD --component packages --command setup --user root --password openmaru --silent true --print true --locale ko --inventory openmaru-apache-tomcat
## ApacheTomcat 설치 CLI
action --package ApacheTomcat --component packages --command setup --user root --password OPENMARU --silent true --print true --locale ko --inventory openmaru-apache-tomcat
설정 파일 다른 이름으로 저장
설치 하고자 하는 조건을 갖춘 설정파일을 선택 후 다른 이름으로 저장한다.
다른 이름으로 저장한 설정파일을 사용자가 원하는 조건에 맞게 설정한다.
공통설정
| 공통 설정 | 내용 |
|---|---|
| Common Settings | |
| 웹 서버 유형 | 설치하는 웹서버의 유형을 나타낸다. |
| WAS 서버 유형 | 설치하는 WAS 서버의 유형을 나타낸다. |
| Group Setting | |
| 그룹명 | 인스턴스 그룹명 |
| 도메인 이름 | 웹서버 VirtualHost 명으로 지정된다. |
WAS 서버 머신 및 인스턴스 설정
| WAS 서버 머신 및 인스턴스 설정 | 내용 |
|---|---|
| WAS Server Settings | |
| IP 주소 | WAS를 설치하고자 하는 IP를 입력한다. |
| SSH 포트 | SSH 포트로 사용할 포트 번호를 입력한다. |
| PEM 파일명 | |
| 인스턴스 이름 | 설치할 인스턴스의 이름을 입력한다. |
| 포트 오프셋 | 설치할 인스턴스들의 포트 오프셋을 지정한다. |
| 그룹명 |
WAS 인스턴스 구성
| WAS 인스턴스 구성 | |
|---|---|
| WAS 환경 설정 | |
| 설치에 사용할 OPENMARU 프로파일명 | |
| WAS 인스턴스 숫자 포맷 | WAS 인스 턴스의 숫자 포맷을 지정한다. |
| WAS 설치 디렉터리 | WAS를 설치할 디렉터리를 나타낸다. |
| WAS 도메인 디렉터리 | |
| WAS 로그 디렉터리 | Log가 저장될 디렉토리를 선택한다. |
| 관리콘솔 사용자 아이디 | 관리콘솔에서 사용 할 사용자의 아이디를 입력한다. |
| 관리콘솔 사용자 패스워드 | 관리콘솔에서 사용 할 사용자의 패스워드를 입력한다. |
| WAS 리눅스 관리자 그룹 | |
| WAS 리눅스 관리자 아이디 | |
| Java 환경설정 | |
| Java Version | 사용할 자바의 버전을 선택한다. |
| Java Heap 최솟값 | 사용할 Java Heap 메모리의 최솟값을 지정한다. |
| Java Heap 최댓값 | 사용할 Java Heap 메모리의 최대값을 지정한다. |
| Java PermGem 메모리 최댓값 | 사용할 Java PermGem 메모리의 최솟값을 지정한다. |
| JVM GC 유형 | JVM Garbage Collection 의 유형을 선택한다. |
| WAS 인스턴스 설정 | |
|---|---|
| OPENMARU APM 사용 여부 | OPENMARU APM agent 사용 여부를 나타낸다. |
| OPENMARU APM 서버 IP | OPENMARU APM 서버 사용 시 , 서버의 IP 를 입력한다. |
| OPENMARU APMM 서버 포트 | OPENMARU APM 서버에서 사용할 포트를 입력한다. |
| OPENMARU APM 에이전트 버전 | OPENMARU APM agent 버전에 대한 정보를 나타낸다. |
| APDEX Time(초) | |
| 트랜잭션 Trace 시간(millisecond) | |
| 설치 후 동작 설정 | |
| 설치 후 서비스 실행 | 설치 후에 실행할 서비스를 지정한다. |
| 설치 완료 후 실행할 스크립트 파일 이름 | 설치 완류 후 실행할 스크립트의 파일 이름을 입력한다. |
WEB 서버 머신 구성
| 설정항목 | 내용 |
|---|---|
| WEB 서버 머신 구성 | |
| Web Server Instance Configuration | |
| IP 주소 | 웹 서버를 설치할 해당 IP를 입력한다. |
| SSH 포트 | SSH 포트로 사용할 포트를 입력한다. |
| 바인드 주소 | |
| Pem 파일 |
WEB 인스턴스 구성
| 설정항목 | 내용 |
|---|---|
| WEB 인스턴스 구성 | |
| WEB 서버 환경 설정 | |
| 설치에 사용할 OPENMARU 웹서버 프로파일명 | |
| 설치 파일 suffix | |
| WEB 서버 설치 디렉터리 | WEB 서버가 설치될 디렉터리를 입력한다. |
| WEB 서버 설치파일 업로드 디렉터리 | WEB 서버 설치파일을 업로드할 디렉터리를 선택한다. |
| 웹서버 인스턴스 디렉터리 | 웹서버 인스턴스가 설치 될 디렉터리를 입력한다. |
| WEB Document Root 디렉터리 | |
| Create index.html | |
| WEB 로그 디렉터리 | WEB 서버 로그가 저장될 디렉터리를 지정한다. |
| WEB 서버 포트 | WEB서버가 사용할 포트를 지정한다. |
| SSL 포트 번호 | SSL 통신 방식에서 사용할 포트를 지정한다. |
| WEB 관리자 그룹 | |
| WEB 관리자 아이디 | |
| WAS 서버와 연결 방법 | |
| 설치 후 동작 설정 | |
| 설치 후 서비스 실행 | |
| 설치 완료 후 실행할 스크립트 파일 이름 |
WAS 설치
설정이 끝난 후 설치 버튼을 클릭하여 설치를 진행한다. 설치 클릭 시 나오는 해당 창에서 필요한 정보를 기입한다. root 가 아닌 sudoer로 설치 진행 시 User에 해당 Sudoer 계정을 입력 후 Sudo 체크박스를 체크 한 뒤 설치를 진행한다. 설치 진행 시 실행 큐에서 로그를 클릭하면 설치 로그를 확인 할 수 있다.
Web Server 설치
WAS 설치와 동일한 방법으로 설치를 진행한다.
설치 확인
실행 큐 내 설치 완료 확인
설치 성공 시 Status에 초록색 체크 표시되고 실패 시 빨간 X가 표시된다. 로그를 클릭 시 설치에 관한 로그를 볼 수 있다.
실행 결과 로그 확인
실행 결과 로그 창에는 OPENMARU Installer 이 작업을 수행하는데 걸린 시간, 수행 결과, 수행한 설정 파일 명 등의 정보를 제공하여 준다. 또 보고서 버튼을 클릭하면 고객 에게 제출할 수 있는 JBoss EAP, JBoss EWS제품 설치 보고서 문서가 자동으로 생성된다.
완료보고서 생성
HTTPD 자동 생성 웹 페이지
설치가 정상 완료 될 시 아래와 같은 웹 페이지가 자동 생성된다.
세션 정보 페이지
생성된 페이지에서 Session Test를 클릭 시 아래와 같은 Session Tracking Test 페이지가 표시된다.
mod_jk의 jkstatus 페 이지
mod_jk status 클릭 시 mod_jk의 정보에 관한 페이지가 표시된다.
