Debian 12에서 Nginx 리버스 프록시와 함께 GlassFish 애플리케이션 서버 설치하는 방법

GlassFish는 Eclipse에서 개발한 Java EE 플랫폼의 무료 오픈 소스 구현입니다. 이는 세계 최초의 Java EE 플랫폼 구현으로, 경량 애플리케이션 서버를 제공하며 여러 Java 기반 애플리케이션을 배포할 수 있게 해줍니다. GlassFish는 Enterprise JavaBeans, JPA, JavaServer Faces, JMS 등 다양한 Java 애플리케이션 기술을 지원합니다.

GlassFish는 개발자들이 Java 기반 애플리케이션을 개발하고 배포하는 데 가장 좋은 선택 중 하나입니다. 이는 개발자들이 편리한 방식으로 엔터프라이즈 애플리케이션을 개발할 수 있게 해주며, 확장 가능한 아키텍처를 제공합니다. GlassFish 프로젝트는 원래 Sun Microsystem에 의해 시작되었습니다. 두 가지 무료 라이센스인 공통 개발 및 배포 라이센스와 GNU 일반 공용 라이센스가 함께 제공됩니다.

이 가이드에서는 단계별 프로세스를 통해 Debian 12에 GlassFish 애플리케이션 서버를 설치합니다. 또한 GlassFish 설치를 위한 Nginx를 리버스 프록시로 구성합니다.

필수 조건

프로세스를 시작하기 위해 다음 사항을 확인하세요:

최소 4GB의 RAM 또는 메모리가 있는 Debian 12 서버.
sudo 권한이 있는 비루트 사용자.

Java OpenJDK 설치하기

GlassFish는 Java 애플리케이션을 배포하기 위한 애플리케이션 서버입니다. GlassFish를 설치하기 위해서는 먼저 Debian 시스템에 Java를 설치해야 합니다. 현재 Debian 저장소에서는 GlassFish의 최신 버전과 호환되는 Java OpenJDK 17을 제공합니다.

먼저, 다음 명령어를 사용하여 Debian 저장소를 업데이트하고 새로 고칩니다.

sudo apt update

update repo

저장소가 업데이트되면 아래 명령어를 실행하여 default-jdk 패키지를 설치합니다. default-jdk 패키지를 설치하면 Java OpenJDK 17이 설치됩니다.

sudo apt install default-jdk

설치 진행을 위해 y를 입력합니다.

install java

설치가 완료되면 아래 명령어를 사용하여 Java 버전을 확인합니다. Java OpenJDK 17이 설치되었는지 확인할 수 있습니다.

java -version

check java

시스템 설정하기

Java OpenJDK를 설치한 후, 다음 단계는 wget 및 unzip과 같은 추가 패키지를 설치하고, 새로운 glassfish 시스템 사용자를 생성하며, JAVA_HOME 환경 변수를 설정하는 것입니다.

시작하려면, 아래 apt 명령어를 실행하여 unzip 및 wget 패키지를 설치합니다.

sudo apt install unzip wget -y

install wget unzip

이제 아래 명령어를 실행하여 새로운 시스템 사용자 glassfish를 생성합니다. 이 사용자는 /opt/glassfish 디렉토리에 위치한 GlassFish 설치를 실행하는 데 사용됩니다.

sudo useradd -M -d /opt/glassfish -U -s /bin/false glassfish

다음으로, 아래 nano 편집기 명령어를 사용하여 새로운 bash 스크립트 /etc/profile.d/java.sh를 생성합니다.

sudo nano /etc/profile.d/java.sh

다음 구성을 추가하여 JAVA_HOME 환경 변수를 설정하고 Java 바이너리 경로를 시스템 PATH에 추가합니다.

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64  
export PATH=$PATH:$JAVA_HOME/bin

작업이 완료되면 파일을 저장하고 닫습니다.

이제 아래 소스 명령어를 사용하여 /etc/profile.d/java.sh 내의 새로운 환경 변수를 로드합니다.

source /etc/profile.d/java.sh

마지막으로, 아래 명령어를 실행하여 시스템 PATH와 JAVA_HOME 환경 변수를 확인합니다.

echo $JAVA_HOME  
echo $PATH

모든 것이 잘 진행되었다면, JAVA_HOME 경로가 /usr/lib/jvm/java-17-openjdk-amd64 디렉토리로 설정되고, Java bin 디렉토리가 시스템 PATH에 추가된 것을 확인할 수 있습니다.

GlassFish 바이너리 패키지 다운로드

Java OpenJDK가 설치되고 Debian 시스템이 준비되었으므로 이제 GlassFish를 다운로드하고 설치할 수 있습니다. 더 진행하기 전에 GlassFish 다운로드 페이지를 확인하여 최신 버전을 확인하세요. 현재 GlassFish의 최신 버전은 v7.0.10입니다.

/tmp 디렉토리로 이동하여 아래 wget 명령어를 통해 GlassFish 바이너리 패키지를 다운로드합니다. 다운로드 프로세스가 완료되면 glassfish-7.0.10.zip 파일이 생성됩니다.

cd /tmp  
wget https://download.eclipse.org/ee4j/glassfish/glassfish-7.0.10.zip

glassfish-7.0.10.zip 파일을 아래 unzip 명령어를 통해 /opt 디렉토리에 추출합니다. GlassFish 패키지는 /opt/glassfish7 디렉토리에 추출됩니다.

unzip glassfish-7.0.10.zip -d /opt

마지막으로, 추출된 디렉토리의 이름을 /opt/glassfish7에서 /opt/glassfish로 변경합니다. 그런 다음 /opt/glassfish 디렉토리의 소유권을 사용자 glassfish로 변경합니다.

mv /opt/glassfish7 /opt/glassfish  
sudo chown -R glassfish:glassfish /opt/glassfish

GlassFish를 Systemd 서비스로 실행하기

GlassFish 바이너리 패키지를 다운로드한 후, GlassFish를 실행하는 데 사용할 새로운 systemd 서비스 파일을 생성합니다. 이를 통해 systemctl 유틸리티를 통해 GlassFish를 관리하고 백그라운드에서 systemd 서비스로 실행할 수 있습니다.

GlassFish를 systemd 서비스로 실행하려면 아래 nano 편집기 명령어를 실행하여 새로운 파일 /etc/systemd/system/glassfish.service를 생성합니다.

sudo nano /etc/systemd/system/glassfish.service

파일에 다음 구성을 삽입합니다.

[Unit]  
Description = GlassFish Server v7  
After = syslog.target network.target  
  
[Service]  
User=glassfish  
ExecStart=/opt/glassfish/bin/asadmin start-domain  
ExecReload=/opt/glassfish/bin/asadmin restart-domain  
ExecStop=/opt/glassfish/bin/asadmin stop-domain  
Type = forking  
  
[Install]  
WantedBy = multi-user.target

작업이 완료되면 파일을 저장하고 닫습니다.

이제 아래 systemctl 명령어를 실행하여 systemd 관리자를 다시 로드하고 변경 사항을 적용합니다.

sudo systemctl daemon-reload

systemd 관리자가 다시 로드되면, 아래 명령어를 사용하여 glassfish 서비스를 시작하고 활성화합니다.

sudo systemctl start glassfish  
sudo systemctl enable glassfish

run glassfish systemd

마지막으로, 아래 명령어를 사용하여 glassfish 서비스 상태를 확인합니다.

sudo systemctl status glassfish

모든 것이 잘 진행되었다면, glassfish 상태가 active (running)으로 표시되고 enabled 상태가 되어야 합니다.

check glassfish service

사용자 설정 및 GlassFish 관리 보안

이 시점에서 GlassFish는 실행 중입니다. 이제 기본 비밀번호를 변경하고 보안 관리자를 활성화하여 GlassFish 설치를 구성합니다. 이는 /opt/glassfish/bin 디렉토리에 있는 asadmin 명령을 통해 수행할 수 있습니다.

아래 asadmin 명령어를 실행하여 GlassFish 설치의 관리자 비밀번호를 변경합니다.

sudo -u glassfish /opt/glassfish/bin/asadmin --port 4848 change-admin-password

이 과정에서 다음과 같은 질문이 표시됩니다:

GlassFish의 기본 관리자 사용자 입력.
비밀번호를 요청할 때 ENTER를 누릅니다. GlassFish의 기본 관리자 사용자는 비밀번호 없이 제공됩니다.
이제 GlassFish의 새로운 관리자 비밀번호를 입력하고 반복합니다.

프로세스가 완료되면 다음과 같은 메시지가 표시됩니다:

다음으로, 아래 asadmin 명령어를 실행하여 GlassFish 설치에서 보안 관리자를 활성화합니다.

본질적으로, 보안 관리자는 도메인 관리 서버(DAS), 원격 인스턴스 및 관리 클라이언트(예: asadmin 유틸리티, 관리 콘솔 및 REST 클라이언트) 간의 SSL을 통한 안전한 통신을 가능하게 합니다.

sudo -u glassfish /opt/glassfish/bin/asadmin --port 4848 enable-secure-admin

GlassFish 관리자 사용자와 비밀번호를 입력한 후 Enter를 누릅니다. 완료되면 다음 출력이 표시됩니다.

보안 관리자가 활성화된 후, 아래 명령어를 실행하여 glassfish 서비스를 재시작하고 변경 사항을 적용합니다.

sudo systemctl restart glassfish

이제 웹 브라우저를 열고 서버 IP 주소 뒤에 포트 8080을 입력하여 방문합니다. 예: http://192.168.5.15:8080/. GlassFish 설치가 성공적이라면, GlassFish가 실행되고 있다는 것을 확인하는 페이지를 볼 수 있습니다.

glassfish index

마지막으로, 새 탭을 열고 포트 4848로 같은 서버 IP 주소를 방문합니다(예: https://192.168.5.15:4848/)하여 GlassFish 관리 페이지에 접근합니다. 웹 브라우저에서 SSL/TLS 인증서를 수락하고, 성공적으로 진행되면 아래와 같은 GlassFish 관리 로그인 페이지를 볼 수 있습니다.

glassfish login page

Nginx를 리버스 프록시로 설치하기

이 가이드에서는 Nginx를 리버스 프록시로 사용하여 GlassFish를 실행합니다. 이제 Debian 머신에 Nginx를 설치하고 GlassFish를 위한 새로운 서버 블록 구성을 생성합니다. 이 경우, 로컬 도메인 이름 glassfish.howtoforge.local을 사용할 것입니다.

먼저, 아래 apt 명령어를 사용하여 Debian 시스템에 Nginx를 설치합니다. 설치 진행을 위해 y를 입력합니다.

sudo apt install nginx

install nginx

Nginx가 설치된 후, 아래 nano 편집기 명령어를 사용하여 새로운 서버 블록 구성 /etc/nginx/sites-available/glassfish를 생성합니다.

sudo nano /etc/nginx/sites-available/glassfish

다음 구성을 삽입하고 server_name 매개변수를 로컬 도메인 이름으로 변경합니다.

upstream glassfish {  
    server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;  
}  
  
server {  
    listen          80;  
    server_name     glassfish.howtoforge.local;  
  
    location / {  
        proxy_set_header X-Forwarded-Host $host;  
        proxy_set_header X-Forwarded-Server $host;  
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
        proxy_pass http://glassfish/;  
    }  
}

작업이 완료되면 파일을 저장하고 종료합니다.

다음으로, 아래 명령어를 실행하여 서버 블록 구성 glassfish를 활성화하고 Nginx 구문을 검증하여 올바른 구문인지 확인합니다.

sudo ln -s /etc/nginx/sites-available/glassfish /etc/nginx/sites-enabled/  
sudo nginx -t

정확한 Nginx 구문이 있다면, ‘test is successful - syntax is ok‘라는 출력을 확인할 수 있습니다.

setup nginx reverse proxy

이제 Nginx 서비스를 재시작하고 변경 사항을 적용할 수 있습니다. 그런 다음 Nginx 서비스가 실행 중인지 확인합니다.

sudo systemctl restart nginx  
sudo systemctl status nginx

다음 출력에서 Nginx 서비스가 실행 중임을 확인할 수 있습니다.

check nginx

GlassFish 설치 접근하기

마지막 섹션에서는 클라이언트 머신에서 GlassFish 설치에 접근합니다. 클라이언트 머신으로는 어떤 운영 체제도 사용할 수 있습니다.

로컬 머신의 /etc/hosts 파일을 편집하고 다음 구성을 삽입합니다. 서버 IP 주소와 로컬 도메인 이름을 변경해야 합니다. Windows 클라이언트를 사용하는 경우, C:\Windows\System32\drivers\etc\hosts 파일을 관리자 권한으로 수정해야 합니다.

192.168.5.15    glassfish.howtoforge.local

이제 웹 브라우저로 돌아가 GlassFish 설치의 도메인 이름을 방문합니다. 예: http://glassfish.howtoforge.local/. Nginx 리버스 프록시 구성이 성공적이라면, 다음과 같은 기본 GlassFish 페이지 인덱스 페이지를 확인할 수 있습니다.

glassfish nginx reverse proxy

다음으로, 포트 4848에서 GlassFish 관리 페이지를 방문합니다(예: https://glassfish.howtoforge.local:4848/). 로그인 페이지에서 관리자 사용자와 비밀번호를 입력한 후 로그인을 클릭합니다.

GlassFish login

설치가 성공적이라면, 다음과 같은 GlassFish 관리 대시보드를 확인할 수 있습니다:

GlassFish dashboard

이제 서버 메뉴를 클릭하여 GlassFish 설치의 상태를 확인합니다. 이 예제에서는 GlassFish 7.0이 설치되어 있으며 상태가 실행 중으로 표시됩니다.

GlassFish status

여기서 이제 GlassFish 애플리케이션 서버를 관리할 수 있습니다.

결론

결론적으로, 이제 단계별 지침을 따라 Debian 12 서버에 GlassFish 애플리케이션 서버를 성공적으로 설치했습니다. Java OpenJDK 17과 Nginx를 리버스 프록시로 사용하여 GlassFish를 설치하고, 기본 관리자 비밀번호를 변경하고 보안 관리자를 활성화하여 GlassFish를 보안했습니다. 이제 GlassFish를 사용하여 애플리케이션을 배포할 수 있습니다.