서버 설치 · 6 min read · Oct 14, 2025

로키 리눅스에 GlassFish 자바 애플리케이션 서버 설치하기

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

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

이 튜토리얼에서는 로키 리눅스에 Nginx 리버스 프록시와 함께 GlassFish 자바 애플리케이션 서버를 설치합니다. Java OpenJDK를 설치하고, 이진 패키지를 통해 GlassFish를 설치하며, Nginx를 리버스 프록시로 설치하고 구성합니다.

전제 조건

시작하기 전에 다음 요구 사항이 충족되었는지 확인해야 합니다:

  • 로키 리눅스 서버 - 로키 리눅스 8 또는 9를 사용할 수 있습니다.
  • sudo 루트/관리자 권한이 있는 비루트 사용자.
  • 로컬 개발 서버를 위한 로컬 도메인 이름.

이제 설치로 넘어가겠습니다.

Java OpenJDK 설치하기

GlassFish는 Java 애플리케이션 서버입니다. 이를 설치하려면 서버에 Java OpenJDK를 설치해야 합니다.

이 글을 작성할 당시, GlassFish 6.2.5의 최신 버전은 최소 Java OpenJDK 11이 필요했습니다. 이제 로키 리눅스 시스템에 Java OpenJDK 11을 설치하여 설치를 시작합니다.

기본 Java OpenJDK는 로키 리눅스 앱스트림 리포지토리에 있습니다. 다음 dnf 명령어를 통해 설치합니다.

sudo dnf install java-11-openjdk

프롬프트가 표시되면 y를 입력하여 확인하고 ENTER를 눌러 진행하면 Java OpenJDK 설치가 시작됩니다.

install java

다음으로, 설치를 확인하기 위해 다음 java 명령어를 실행합니다. 로키 리눅스에 설치된 Java OpenJDK 11의 출력이 표시되어야 합니다.

java -version

Java OpenJDK가 설치되면 다음 단계는 GlassFish를 다운로드하고 이진 패키지에서 수동으로 설치하는 것입니다.

GlassFish 애플리케이션 다운로드

GlassFish는 Eclipse에서 개발한 Java EE 호환 구현입니다. 소스 코드를 빌드하여 수동으로 설치하거나 Eclipse에서 제공하는 이진 배포 패키지를 통해 설치할 수 있습니다.

이 단계에서는 Eclipse 웹사이트에서 다운로드할 수 있는 이진 배포 패키지를 통해 GlassFish를 설치합니다.

GlassFish 설치를 시작하기 전에 unzip 패키지를 설치하기 위해 다음 dnf 명령어를 실행합니다. 이는 GlassFish 배포 패키지를 추출하는 데 사용됩니다.

sudo dnf install unzip

다음으로, GlassFish를 위한 새로운 전용 사용자를 생성하기 위해 다음 명령어를 실행합니다. 이 예제에서는 비루트 사용자 ‘glassfish’를 통해 GlassFish 애플리케이션 서버를 실행합니다.

sudo useradd -m -d /opt/glassfish6 -U -s /bin/false glassfish

‘glassfish’ 사용자가 생성된 후, ‘/tmp’ 디렉토리로 이동하여 아래 wget 명령어를 통해 GlassFish 이진 배포 패키지를 다운로드합니다.

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

그리고 새로운 파일 ‘glassfish-6.2.5.zip’을 얻어야 합니다.

create user download glassfish

다음 unzip 명령어를 실행하여 GlassFish 패키지 ‘glassfish-6.2.5.zip’을 ‘/opt’ 디렉토리에 추출합니다.

unzip /tmp/glassfish-6.2.5.zip -d /opt

이제 GlassFish 패키지가 ‘/opt/glassfish6’ 디렉토리에 추출되었습니다.

마지막으로, GlassFish 설치 디렉토리 ‘/opt/glassfish6’의 소유권을 사용자 및 그룹 ‘glassfish’로 변경하기 위해 다음 명령어를 실행합니다.

sudo chown -R glassfish:glassfish /opt/glassfish6

이제 GlassFish 패키지를 다운로드했으므로, 이진 파일 ‘/opt/glassfish6/bin/asadmin’을 통해 GlassFish 애플리케이션을 수동으로 시작할 수 있습니다. 하지만 더 쉽게 하기 위해 GlassFish를 systemd 서비스로 설정하고 실행할 것입니다.

GlassFish를 Systemd 서비스로 실행하기

이 가이드에서는 systemd 서비스를 통해 GlassFish 자바 애플리케이션 서버를 실행합니다. 이를 통해 systemctl 명령어를 통해 GlassFish 애플리케이션 서버를 쉽게 관리할 수 있습니다.

시작하기 위해, 다음 nano 편집기를 사용하여 새로운 systemd 서비스 파일 ‘/lib/systemd/system/glassfish.service’를 생성합니다.

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

파일에 다음 구성을 추가합니다.

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

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

다음으로, 다음 systemctl 명령어를 실행하여 systemd 관리자를 다시 로드하고 새로운 서비스 파일 ‘glassfish.service’를 적용합니다.

sudo systemctl daemon-reload

이제 systemd 관리자를 다시 로드했으므로, 다음 systemctl 명령어를 통해 ‘glassfish’ 서비스를 시작하고 활성화할 수 있습니다.

sudo systemctl start glassfish  
sudo systemctl enable glassfish

setup glassfish service

‘glassfish’ 서비스가 시작되면, 다음 systemctl 명령어를 실행하여 ‘glassfish’ 서비스의 상태를 확인하고 서비스가 실행 중인지 확인합니다.

sudo systemctl status glassfish

‘glassfish’ 서비스가 실행 중이라는 출력이 표시되어야 합니다.

check glassfish service

이제 ‘glassfish’ 자바 애플리케이션이 실행 중이므로, 다음 단계는 GlassFish 관리 구성을 시작하는 것입니다.

GlassFish 관리 구성하기

기본 GlassFish 설치는 관리자 비밀번호 없이 제공됩니다. 이제 GlassFish의 관리 사용자 및 비밀번호를 구성하고 명령줄 ‘/opt/glassfish6/bin/asadmin’을 통해 GlassFish 설치를 보호합니다.

다음 명령어를 실행하여 GlassFish 설치를 위한 관리자 사용자 및 비밀번호 구성을 시작합니다.

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

이제 GlassFish의 관리와 관련된 몇 가지 프롬프트가 표시됩니다.

  • GlassFish의 사용자 입력 - 기본 사용자는 ‘admin’입니다.
  • 기본 GlassFish 설치는 비밀번호 없이 제공되므로 ENTER를 누릅니다.
  • 이제 GlassFish 설치를 위한 새 비밀번호를 입력하고 반복합니다.

이제 ‘Command change-admin-password executed successfully’와 같은 출력 메시지를 받아야 합니다.

GlassFish 관리 사용자 구성이 완료된 후, 다음으로 GlassFish 설치를 보호하는 작업을 시작합니다.

다음 명령어를 실행하여 GlassFish를 보호합니다.

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

GlassFish 관리자 사용자 및 비밀번호를 입력하라는 프롬프트가 표시되면, 이전에 구성한 세부 정보를 입력합니다. 모든 작업이 완료되면 ‘Command enable-secure-admin executed successfully’와 같은 출력이 표시됩니다.

securing glassfish

다음으로, 다음 명령어를 실행하여 ‘glassfish’ 서비스를 재시작하고 새로운 변경 사항을 적용합니다.

sudo systemctl restart glassfish

이 시점에서 GlassFish는 이제 새로운 관리자 사용자 및 비밀번호로 실행되고 있으며, 또한 보호되고 있습니다. 기본 GlassFish 자바 애플리케이션 서버는 포트 ‘8080’에서 실행되고 있으며, GlassFish 관리자는 포트 ‘4848’에서 실행되고 있습니다.

GlassFish 설치에 접근하기 전에, 다음 firewall-cmd 명령어를 실행하여 포트 8080 및 4848을 엽니다.

sudo firewall-cmd --add-port=8080/tcp --zone=public  
sudo firewall-cmd --add-port=4848/tcp --zone=public

마지막으로, 웹 브라우저를 열고 IP 주소 뒤에 포트 8080을 방문합니다 (예: http://192.168.5.100:8080). 이제 GlassFish 자바 애플리케이션 서버의 기본 index.html 페이지를 볼 수 있어야 합니다.

glassfish index

GlassFish 관리자의 경우, 서버 IP 주소와 포트 4848을 방문합니다 (예: http://192.168.5.100:4848/). 그리고 GlassFish 관리 로그인 페이지를 볼 수 있어야 합니다.

glassfish login page

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

이 시점에서 GlassFish 자바 애플리케이션이 실행 중이며 관리가 활성화되고 보호되고 있습니다. 이제 Nginx를 설치하고 GlassFish의 리버스 프록시로 설정합니다.

Nginx 리버스 프록시를 사용하여 GlassFish를 표준 포트 HTTP 또는 HTTPS(활성화된 경우)에서 실행할 수 있습니다.

다음 dnf 명령어를 실행하여 Nginx 웹 서버를 설치합니다. 구성에 대한 프롬프트가 표시되면 Y를 입력하고 ENTER를 눌러 진행합니다.

sudo dnf install nginx

install nginx

다음으로, 다음 nano 편집기를 사용하여 새로운 Nginx 서버 블록 구성 ‘/etc/nginx/conf.d/glassfish.conf’를 생성합니다. 이 구성은 Nginx가 GlassFish의 리버스 프록시로 실행되도록 합니다.

sudo nano /etc/nginx/conf.d/glassfish.conf

파일에 다음 구성을 추가하고 로컬 도메인 이름 ‘glassfish.howtoforge.local’을 자신의 도메인으로 변경합니다.

upstream glassfish6 {  
  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://glassfish6/;  
  }  
}

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

다음으로, 다음 명령어를 실행하여 Nginx 구성을 확인합니다. 올바른 구성이면 ‘Syntax is OK - test is successful’와 같은 출력 메시지가 표시됩니다.

sudo nginx -t

이제 GlassFish를 위한 Nginx 서버 블록을 생성했으므로, 다음 명령어를 실행하여 Nginx 서비스를 시작하고 활성화합니다.

sudo systemctl start nginx  
sudo systemctl enable nginx

Nginx 서비스가 이제 실행 중이어야 하며, 활성화되어 시스템 부팅 시 자동으로 실행됩니다.

setup nginx reverse proxy

마지막으로, 다음 명령어를 사용하여 Nginx 서비스를 확인하여 서비스가 실행 중인지 확인합니다.

sudo systemctl status nginx

다음과 같은 출력이 표시됩니다 - Nginx 서비스가 실행 중입니다.

check nginx

Firewalld 설정하기

로키 리눅스의 기본 firewalld가 실행 중입니다. GlassFish에 접근할 수 있도록 하려면 HTTP 포트와 GlassFish 관리 포트 4848을 열어야 합니다.

다음 firewall-cmd 명령어를 실행하여 HTTP 및 HTTPS 서비스와 GlassFish 관리 포트 4848을 추가합니다.

sudo firewall-cmd --add-service=http --permanent  
sudo firewall-cmd --add-service=https --permanent  
sudo firewall-cmd --add-port=4848/tcp --permanent

이제 firewalld 규칙을 다시 로드하고 다음 명령어를 통해 활성화된 규칙 목록을 확인합니다.

sudo firewall-cmd --reload  
sudo firewall-cmd --list-all

다음과 같은 출력을 받아야 합니다 - HTTP 및 HTTPS 서비스가 firewalld에 추가되었으며 GlassFish 관리 포트 4848/tcp도 추가되었습니다.

setup firerwalld

GlassFish 접근하기

로컬 컴퓨터에서 다음 nano 편집기를 사용하여 파일 ‘/etc/hosts’를 편집합니다.

sudo nano /etc/hosts

파일에 다음 구성을 추가하고 GlassFish 설치를 위한 서버 IP 주소와 로컬 도메인 이름을 변경합니다.

192.168.5.100  glassfish.howtoforge.local

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

다음으로, 웹 브라우저를 열고 GlassFish 설치의 도메인 이름을 방문합니다 (예: http://glassfish.howtoforge.local/). 이제 GlassFish의 기본 index.html 페이지를 볼 수 있어야 합니다.

glassfish index

이제 새 탭을 열고 관리 포트 4848 뒤에 도메인 이름을 방문합니다 (예: https://glassfish.howtoforge.local:4848/). 이제 GlassFish의 관리 로그인 페이지를 볼 수 있어야 합니다.

구성한 관리자 사용자 및 비밀번호를 입력하고 로그인을 클릭합니다.

glassfish login

관리자 사용자 및 비밀번호가 올바르면 다음과 같은 GlassFish 관리 대시보드를 볼 수 있습니다.

glassfish admin dashboard

결론

이 가이드에서는 로키 리눅스 서버에 GlassFish 자바 애플리케이션 서버를 설치했습니다. 또한 Java OpenJDK 11을 설치하고 Linux 시스템에 새로운 서비스 파일을 추가했습니다. 마지막으로, GlassFish 자바 애플리케이션 서버를 위한 리버스 프록시로 Nginx 웹 서버를 설치하고 구성하는 방법도 배웠습니다.

다음 단계로, 이제 다른 애플리케이션을 배포하거나 GlassFish의 고가용성을 구성할 수 있습니다.

Share: X/Twitter LinkedIn
#서버 설치

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.