[WildFly_JBoss] Linux 환경 - WildFly 설치 (Domain Mode)

#. 테스트 환경

WildFly 26.1.*

OpenJDK 17

CentOS 7

 

---

 

#. 설치 파일 다운로드

아래 사이트에서 다운로드 받는다

https://www.wildfly.org/downloads/

 

---

 

#. 설치 파일 압축 해제

설치 파일을 압축 해제하는 것으로 설치 자체는 완료된다.

이어서 JAVA_HOME 경로 지정, management user 생성, master - slave 호스트 연동 작업 등을 진행한다

 

---

 

#. JAVA_HOME 지정

{WILDFLY_HOME}/bin 디렉토리 하위의 각종 .sh 스크립트 내에

JAVA_HOME 경로를 모두 작성하는 방법은 비효율적이다.

 

별도의 shell 스크립트를 추가하여 해당 스크립트에서

"export JAVA_HOME" 을 사용하는 방법을 사용하도록 하자.

 

---

 

#. management user 추가

JAVA_HOME 지정 후

{WILDFLY_HOME}/bin/add-user.sh 스크립트를 실행한다.

 

해당 작업은

master host 장비, slave host 장비 양측에서 모두 실행한다.

 

<Management User 추가 절차>

1. a) Management User 선택

2. username 입력

3. password 입력

4. About to add user 'keuangkuo' for realm 'ManagementRealm'
  => yes 선택

5. Is this new user going to be used for one AS process to connect to another AS process?
  => yes 선택

6. secret value 는 해당 버전에서 쓰이지 않는다. 저장해두지 않아도 됨.

 

 

---

 

#. master - slave 연동

WildFly25 이하 버전

 

WildFly25 이상 버전부터 master host - slave host 연동 방식이 바뀌었다.

cli 스크립트를 실행하여 연동을 진행한다.

아래 두 개 스크립트를 생성한다.

 

(add_slave.sh)

#java home
JAVA_HOME=/usr/jdk/jdk17/jdk-17.0.2
export JAVA_HOME

/app/wildfly/wildfly_2611/bin/jboss-cli.sh --file=reg-slave.cli

 

(reg-slave.cli)

앞서 생성한 Management User 계정 정보를 입력한다

authentication-name=jboss (계정명)

credential-reference={clear-text=jboss1234}) (패스워드)

embed-host-controller --std-out=echo --host-config=host-slave.xml
/host=slave/subsystem=elytron/authentication-configuration=secondary-hc-auth:add(authentication-name=keuangkuo, credential-reference={clear-text=629074Guscjfdl!})
/host=slave/subsystem=elytron/authentication-context=secondary-hc-auth-context:add(match-rules=[{authentication-configuration=secondary-hc-auth}])
/host=slave:write-attribute(name=domain-controller.remote.authentication-context, value=secondary-hc-auth-context)

 

 

{WILDFLY_HOME}/domain/configuration/host-slave.xml 파일을 수정한다

맨 상단의 <host> 태그 내에 name 값을 추가한다

name="slave" 를 추가한다.

 

add_slave.sh 스크립트를 실행한다.

아래와 같은 결과가 출력되면 정상.

 

해당 절차까지 완료되었다면

{WILDFLY_HOME}/domain/configuration/host-slave.xml 파일 맨 상단의 <host> 태그 내용은 원복한다

name="slave" 를 제거한다.

 

---

 

#. 서버 기동 + Management Console 접속

Master Host 및 Slave Host 기동 스크립트 예시는 아래 글 확인

https://hyuunchul.tistory.com/265?category=1099045

 

Management console에 접속하여

master host 및 slave host가 정상적으로 기동되었는지 확인한다.

 

---

 

#. 설치 후 초기 세팅

 

log level 변경

log level 은 profile 단위로 적용된다.

사용 중인 profile을 확인 후 log level을 INFO로 변경한다.