[weblogic] 윈도우 서비스 등록 및 삭제 가이드

업데이트 날짜

2024/04/24

 

테스트 진행한 버전

10.3.6, 12.2.1.4

 

스크립트 샘플

windows service script.zip

0.04MB

 

---

 

<주의사항>

서비스 등록 및 삭제 작업은

반드시 관리자 권한으로 실행된 CMD 에서 진행해야 한다.

(일반 사용자 권한으로 실행하면 권한 부족으로 에러 발생)

 

---

 

<AdminServer 등록>

{WEBLOGIC_HOME}\wlserver\server\bin 디렉토리 하위에 installSvc.cmd 파일이 있다.

해당 파일 원본은 수정하지 않고 별도 디렉토리에 copy 하여 작업한다.

 

---

 

 

installSvc.cmd 파일을 copy 하여 AdminServer.cmd 라는 이름으로 변경하였다.

해당 스크립트 이름은 자유롭게 수정 가능하다.

AdminServer.cmd

0.01MB

 

기존에 사용하던 서버 기동 스크립트의 내용을 대부분 재활용 가능하다.

서버 기동에 필요한 각종 파라미터를 AdminServer.cmd 스크립트에 작성하면 된다.

 

본 가이드에서는

스크립트 상단의 각종 주석 내용이 끝나는 지점에 서버 기동에 필요한 파라미터를 작성하였다.

 

필수로 작성해야 하는 파라미터는 다음과 같다.

JAVA_OPTIONS는 기존에 사용하던 기동 스크립트의 내용을 그대로 재사용 가능하다.

MW_HOME=D:\work\app\weblogic\weblogic12214
weblogic 서버의 홈 디렉토리 경로

-----------------------------------------------

USERDOMAIN_HOME=D:\work\app\weblogic\weblogic12214\domains\test_domain
도메인 디렉토리 경로
일반 기동 스크립트 사용 시에는 DOMAIN_HOME 파라미터를 사용하는데,
윈도우 서비스 등록 시에는 USERDOMAIN_HOME 라는 이름으로 쓰인다

-----------------------------------------------

SERVER_NAME=AdminServer
서버 인스턴스 이름

-----------------------------------------------

HOST=192.168.56.1
PORT=9000

서버 인스턴스 ip주소와 port

-----------------------------------------------

WLS_USER=weblogic
WLS_PW=weblogic1!

도메인 생성 시 설정하였던 username과 password

 

해당 스크립트 맨 하단에

최종적으로 윈도우 서비스에 weblogic 프로세스를 등록하는 명령어가 있다.

해당 명령어 맨 끝부분에 stdout 로그 파일 경로를 작성해주어야 한다.

-log:"로그파일경로\파일명.out"

 

 

---

 

스크립트를 실행하면 윈도우 서비스 등록 절차가 실행된다.

아래와 같이 ***** installed 문구가 출력되면 정상이다.

 

윈도우 서비스 창에도 정상적으로 등록되었는지 확인한다.

AdminServer 윈도우 서비스가 정상적으로 기동되면

 

Admin Console 에 접속하여 정상 기동 여부를 확인한다.

 

---

 

 

<ManagedServer 등록>

AdminServer.cmd 파일을 copy 하여 다른 이름으로 생성한다.

AdminServer 등록 스크립트와 기본적인 틀은 동일하며, 몇가지 파라미터만 추가해주면 된다.

m1.cmd

0.01MB

 

ADMIN_URL 파라미터를 추가로 작성해준다.

 

스크립트 맨 하단의 log 옵션 뒷부분에 depend 옵션을 추가해야 한다.

해당 ManagedServer 프로세스가 어떤 AdminServer 프로세스에 의존하는지를 지정하는 옵션이다.

AdminServer의 윈도우 서비스 이름을 작성한다.

-depend:"AdminServer 윈도우 서비스 이름"

 

 

 

---

 

스크립트를 실행하고

 

윈도우 서비스 창에서 ManagedServer 프로세스를 시작하고

 

Admin Console 에서 ManagedServer 정상 기동 여부를 확인한다.

 

---

 

<윈도우 서비스 삭제>

윈도우 서비스 삭제 스크립트도

각 서버 인스턴스 별로 생성해두면 간편하게 작업 가능하다.

uninstallSvc_AdminServer.cmd

0.00MB

uninstallSvc_m1.cmd

0.00MB

 

{WEBLOGIC_HOME}\wlserver\bin 디렉토리에 위치한

uninstallSvc.cmd 스크립트를 복사하여 사용한다.

 

윈도우 서비스 삭제 작업도 관리자 권한이 필요하므로

스크립트 상단에 관리자 권한 획득 명령어를 작성하였다.

 

 

해당 스크립트에서 수정해주어야 하는 부분은 다음과 같다.

MW_HOME=D:\work\app\weblogic\weblogic12214
weblogic 서버의 홈 디렉토리 경로

-----------------------------------------------

-svcname 옵션
삭제하고자 하는 윈도우 서비스 이름을 작성한다.
파라미터 값을 조합하거나,
파라미터 사용 없이 직접 타이핑 하여 작성하면 된다.

 

삭제하고자 하는 윈도우 서비스 이름은

서비스 창에 표기된 이름을 참고하도록 한다.

 

---

 

<윈도우 서비스 사용 시 주의>

AdminServer 기동 후에 ManagedServer 가 기동되어야 함

따라서, ManagedServer 서비스는 "자동시작(지연됨)" 으로 반드시 설정하도록 한다

ManagedServer 서비스는 AdminServer 서비스에 종속적이기 때문

 

자동시작(지연됨) 으로 설정 시

장비 기동 후 사용자가 로그온을 해야 자동으로 시작된다고 한다.

테스트 시에는 사용자 로그온 후, 대략 3분정도 후에 시작되었음