Liferay Portal 설치 전 필수 준비사항: 안정적인 운영을 위한 완전 가이드

Liferay Portal을 설치하기 전에 안정적인 운영을 위해 반드시 시스템 환경을 점검하고, 필수 소프트웨어와 환경설정을 미리 준비해야 합니다. 아래는 최신 Liferay DXP 7.4 및 Liferay Portal CE 기준의 대표적인 사전 준비 사항입니다.

---

운영체제(OS)

지원 OS

• Linux (Rocky Linux, CentOS, Ubuntu 등)
• Windows Server
• macOS (개발/테스트 용도)

권장 환경

엔터프라이즈 환경에서는 Linux 계열 OS를 많이 사용하며, 실제 운영에서는 가상머신(VM) 또는 클라우드 환경이 일반적입니다. Linux는 안정성과 성능 면에서 우수하며, 대부분의 엔터프라이즈급 애플리케이션에서 선호되는 플랫폼입니다.
클라우드 환경 고려사항:

• AWS EC2, Azure VM, Google Cloud Compute Engine 등에서 최적화된 성능 제공
• 컨테이너 환경(Docker, Kubernetes)에서도 원활한 운영 가능
• 로드 밸런싱과 고가용성 구성을 위한 멀티 인스턴스 배포 지원

---

Java 개발 키트(JDK)

필수 버전

Liferay DXP 7.4 및 최신 Liferay Portal은 Oracle JDK 8 또는 OpenJDK 8을 권장합니다. 일부 최신 패치에서는 JDK 11 또는 JDK 21도 지원하지만, Spring 및 포틀릿 호환성에 따라 JDK 8/11을 우선 추천합니다.

설치 예시 (Linux 기준)

sudo tar -xvf jdk-8u421-linux-x64.tar.gz -C /opt/
export JAVA_HOME=/opt/jdk1.8.0_421
export PATH=$PATH:$JAVA_HOME/bin

# 환경 변수 영구 설정
echo 'export JAVA_HOME=/opt/jdk1.8.0_421' >> ~/.bashrc
echo 'export PATH=$PATH:$JAVA_HOME/bin' >> ~/.bashrc
source ~/.bashrc

JDK 버전별 호환성

JDK 8	✅ 완전 지원	✅ 완전 지원	⭐⭐⭐⭐⭐
JDK 11	✅ 지원	✅ 지원	⭐⭐⭐⭐
JDK 21	⚠️ 제한적 지원	⚠️ 제한적 지원	⭐⭐

참고: JDK 21은 일부 네임스페이스(jakarta/javax) 이슈가 있으니, 공식 호환성 가이드 확인 후 적용하세요.

---

데이터베이스(DB)

지원 DBMS

• MariaDB 10.6 이상
• MySQL 5.7/8.0
• PostgreSQL 12 이상
• Oracle Database (EE에서 공식 지원, CE는 별도 드라이버 필요)
• Microsoft SQL Server (EE에서 공식 지원, CE는 별도 드라이버 필요)

설치 및 연결

DBMS 설치 후, Liferay용 별도 데이터베이스와 계정 생성이 필요합니다. JDBC 드라이버를 Liferay의 lib 폴더에 복사하고, portal-ext.properties 또는 portal-setup-wizard.properties 파일에 DB 접속 정보를 입력해야 합니다.

# MariaDB 연결 설정 예시
jdbc.default.driverClassName=org.mariadb.jdbc.Driver
jdbc.default.url=jdbc:mariadb://:3306/lportal?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
jdbc.default.username=liferay-user
jdbc.default.password=비밀번호

# 커넥션 풀 설정
jdbc.default.maximumPoolSize=100
jdbc.default.minimumPoolSize=10

데이터베이스 성능 최적화

-- MariaDB/MySQL 최적화 설정
SET GLOBAL innodb_buffer_pool_size = 2G;
SET GLOBAL max_connections = 500;
SET GLOBAL query_cache_size = 256M;

-- Liferay 전용 데이터베이스 생성
CREATE DATABASE lportal CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'liferay-user'@'%' IDENTIFIED BY '강력한비밀번호';
GRANT ALL PRIVILEGES ON lportal.* TO 'liferay-user'@'%';
FLUSH PRIVILEGES;

---

애플리케이션 서버

번들형 설치

Liferay는 Tomcat, Wildfly, JBoss, WebLogic 등 다양한 WAS(Web Application Server)와 호환됩니다. 가장 많이 사용하는 방식은 Tomcat 번들형(압축 해제 후 바로 실행)입니다.

환경 변수 설정

# Tomcat 번들 기준 환경 변수 설정
export CATALINA_HOME=/opt/liferay-dxp-tomcat
export CATALINA_OPTS="-Dfile.encoding=UTF-8 -Duser.timezone=Asia/Seoul -Xms4g -Xmx8g"
export JAVA_OPTS="-XX:+UseG1GC -XX:MaxGCPauseMillis=200"

Tomcat 성능 튜닝

---

추가 필수 소프트웨어

Elasticsearch

Liferay 7.x 이상에서는 Elasticsearch 7.x/8.x를 검색엔진으로 사용합니다. 별도 설치를 권장하며, 클러스터 구성을 통해 고가용성을 확보할 수 있습니다.

# elasticsearch.yml 기본 설정
cluster.name: liferay-cluster
node.name: liferay-node-1
network.host: 0.0.0.0
http.port: 9200
discovery.type: single-node

# JVM 힙 메모리 설정 (jvm.options)
-Xms2g
-Xmx2g

메일 서버

사용자 알림, 비밀번호 재설정 등 이메일 발송 기능을 위해 SMTP 서버 정보가 필요합니다.

# portal-ext.properties 메일 설정
mail.session.mail.smtp.host=smtp.gmail.com
mail.session.mail.smtp.port=587
mail.session.mail.smtp.auth=true
mail.session.mail.smtp.starttls.enable=true
mail.session.mail.smtp.user=your-email@gmail.com
mail.session.mail.smtp.password=your-app-password

방화벽 및 네트워크

8080 포트(Tomcat 기본값) 및 DB, Elasticsearch, SMTP 등 연동 포트 오픈이 필요합니다.

Liferay Portal	8080, 8443	HTTP/HTTPS	웹 서비스
MariaDB/MySQL	3306	TCP	데이터베이스
PostgreSQL	5432	TCP	데이터베이스
Elasticsearch	9200, 9300	HTTP/TCP	검색 엔진
SMTP	25, 587, 465	TCP	메일 발송

---

하드웨어 권장 사양

최소 사양

• CPU: 4코어 이상
• RAM: 8GB 이상 (실서비스는 16GB 이상 권장)
• 디스크: SSD, 50GB 이상 (콘텐츠 양에 따라 증설)

운영 환경 권장 사양

• CPU: 8코어 이상 (Intel Xeon 또는 AMD EPYC)
• RAM: 32GB 이상
• 디스크: NVMe SSD, 500GB 이상
• 네트워크: 1Gbps 이상

클러스터 환경 고려사항

# 클러스터 설정 예시
cluster.link.enabled=true
cluster.link.channel.logic.name=control
cluster.link.channel.properties.control=tcp.xml
cluster.link.autodetect.address=www.google.com:80

---

설치 전 체크리스트

필수 확인 사항

• ✅ OS, JDK, DBMS, 애플리케이션 서버, Elasticsearch 등 버전 호환성 확인
• ✅ DB 계정 및 권한 사전 생성
• ✅ 방화벽, 네트워크 포트 오픈
• ✅ JAVA_HOME, CATALINA_HOME 등 환경 변수 설정
• ✅ Liferay 공식 다운로드 사이트에서 설치 파일 확보

성능 및 보안 체크리스트

• ✅ SSL 인증서 준비 (HTTPS 설정)
• ✅ 백업 및 복구 계획 수립
• ✅ 모니터링 도구 설정 (JMX, APM 등)
• ✅ 로그 로테이션 설정
• ✅ 보안 패치 및 업데이트 계획

개발 환경 추가 고려사항

# 개발 환경용 추가 설정
export LIFERAY_LEARN_MODE=true
export LIFERAY_DEVELOPER_MODE=true

# 디버깅을 위한 JVM 옵션
export CATALINA_OPTS="$CATALINA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000"

---

마무리

Liferay Portal의 성공적인 설치와 운영을 위해서는 체계적인 사전 준비가 필수입니다. 운영체제부터 JDK, 데이터베이스, 애플리케이션 서버, 그리고 Elasticsearch까지 모든 구성 요소의 호환성을 확인하고 적절히 설정해야 합니다.
특히 엔터프라이즈 환경에서는 성능, 보안, 가용성을 모두 고려한 설계가 중요하며, 정기적인 모니터링과 유지보수 계획도 함께 수립해야 합니다. 이러한 준비 과정을 통해 안정적이고 확장 가능한 Liferay Portal 환경을 구축할 수 있습니다.