Liferay Portal 초기 설정 완전 가이드: 설치부터 관리자 계정 생성까지

Liferay Portal은 기업용 웹 포털 구축을 위한 강력한 오픈소스 플랫폼입니다. 초기 설정부터 관리자 계정 생성, 기본 화면 구성까지 단계별로 설명드리겠습니다. 본 가이드는 Tomcat 번들 버전을 기준으로 작성되었으며, 2025년 최신 Liferay 7.4 GA132 버전을 반영했습니다.

---

서버 기동 및 초기 설정 마법사 실행

Liferay 설치 후 첫 실행 시 Setup Wizard가 자동으로 시작됩니다. 이 단계에서 포털의 기본 정보와 관리자 계정을 설정합니다.

실행 절차

서버 시작

# Linux
./liferay-dxp-7.4-ga132/tomcat-9.0.56/bin/startup.sh

# Windows
startup.bat

브라우저 접속
http://localhost:8080 주소로 접속하면 Setup Wizard 화면이 표시됩니다.

Setup Wizard 주요 설정 항목

포털 기본 정보:

• Portal Name: 포털 이름 (예: "My Corporate Portal")
• Default Language: 기본 언어 (한국어 선택)
• Time Zone: Asia/Seoul

관리자 정보:

• First Name: Admin
• Last Name: User
• Email: admin@yourcompany.com

데이터베이스 설정:

• 기본값(HSQL) 사용 시 체크 유지 (테스트 환경 권장)
• MySQL/MariaDB 사용 시 JDBC URL, 사용자 계정 입력

프로덕션 환경에서는 반드시 MySQL/Oracle 등 외부 DB 사용을 권장합니다. HSQL은 개발 및 테스트 목적으로만 사용해야 합니다.

---

관리자 계정 생성 및 보안 강화

Setup Wizard 완료 후 기본 관리자 계정(test@liferay.com)으로 로그인합니다.

초기 보안 조치

비밀번호 변경:

1. 우측 상단 사용자 아이콘 → 계정 설정 → 비밀번호
2. 기존: test → 새 비밀번호 입력 (영문+숫자+특수문자 조합)

새 관리자 계정 추가:

1. 제어판 → 사용자 → 사용자 및 조직 → "+" 버튼
2. 필수 정보 입력 (이메일, 이름, 성) → 역할 부여: Administrator

권장 설정

# portal-ext.properties  
passwords.default.policy.change.required=true  
admin.email.from.address=noreply@yourcompany.com
passwords.default.policy.min.length=8
passwords.default.policy.check.syntax=true

---

기본 화면 구성 및 테마 적용

Liferay의 기본 랜딩 페이지를 커스터마이징합니다.

단계별 구성

1. 사이트 생성

• 제어판 → 사이트 → "+" → "Blank Site" 템플릿 선택
• 이름: "Main Site" → 저장

2. 페이지 추가

• 사이트 관리 → 사이트 빌더 → 페이지 → "+"
• 유형: Widget Page → 이름: "홈"

3. 포트릿 배치

• "콘텐츠 & 데이터" 섹션에서 Web Content Display 드래그 & 드롭
• 샘플 콘텐츠 작성 또는 HTML 직접 입력

4. 테마 적용

• 사이트 관리 → 디자인 → 테마
• "Classic" 테마 선택 → 미리보기 후 적용

고급 설정

<!-- liferay-look-and-feel.xml -->  
<theme id="classic" name="Custom Theme">  
    <template-extension>  
        <customized-property>header-logo-height=80px</customized-property>  
        <customized-property>footer-background-color=#f8f9fa</customized-property>
    </template-extension>  
</theme>

---

필수 시스템 설정

메일 서버 구성

# 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.user=your-email@gmail.com  
mail.session.mail.smtp.password=your-password  
mail.session.mail.smtp.starttls.enable=true
mail.session.mail.smtp.ssl.enable=false

파일 저장소 설정

기본값(문서 라이브러리) → AWS S3 연동 권장:

dl.store.impl=com.liferay.portal.store.s3.S3Store
dl.store.s3.access.key=your-access-key
dl.store.s3.secret.key=your-secret-key
dl.store.s3.bucket.name=your-bucket-name
dl.store.s3.region=ap-northeast-2

---

로그 확인 및 문제 해결

서버 실행 중 발생하는 이슈는 로그 파일에서 진단 가능합니다.

주요 로그 경로

tail -f liferay-dxp-7.4-ga132/tomcat-9.0.56/logs/catalina.out  # 서버 로그  
tail -f liferay-dxp-7.4-ga132/logs/liferay.[날짜].log  # Liferay 전용 로그

흔한 오류 및 해결

오류 유형	해결 방법
DB 연결 실패	jdbc.url의 포트/DB명 확인
퍼미션 거부	chmod -R 755 tomcat-9.0.56 실행
한글 깨짐	server.xml에 URIEncoding="UTF-8" 추가
메모리 부족	JVM 힙 메모리 증가 (-Xmx2048m)

---

고급 관리자 기능

가상 호스트 설정

# portal-ext.properties  
company.default.virtual.hostname=portal.yourcompany.com
company.default.web.id=liferay.com

역할(Role) 생성

1. 제어판 → 역할 → "+" → 이름: "Content Manager"
2. 권한: Web Content 관련 모든 권한 부여
3. 사용자 할당: 특정 사용자에게 역할 부여

자동 백업 구성

# 크론탭에 일일 백업 스케줄 등록
0 2 * * * /opt/liferay/backup-script.sh

# backup-script.sh 예시
#!/bin/bash
DATE=$(date +%Y%m%d)
mysqldump -u root -p liferay > /backup/liferay_$DATE.sql
tar -czf /backup/liferay_data_$DATE.tar.gz /opt/liferay/data/

---

성능 최적화 설정

JVM 튜닝

# setenv.sh (Linux) 또는 setenv.bat (Windows)
CATALINA_OPTS="$CATALINA_OPTS -Xms2048m -Xmx4096m"
CATALINA_OPTS="$CATALINA_OPTS -XX:NewRatio=2 -XX:+UseG1GC"
CATALINA_OPTS="$CATALINA_OPTS -Dfile.encoding=UTF-8"

캐시 설정

# portal-ext.properties
ehcache.single.vm.config.location=/ehcache/liferay-single-vm-clustered.xml
cluster.link.enabled=true

---

보안 강화 조치

SSL/TLS 설정

<!-- server.xml -->
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
           maxThreads="150" scheme="https" secure="true"
           keystoreFile="/path/to/keystore.jks"
           keystorePass="your-password"
           clientAuth="false" sslProtocol="TLS" />

방화벽 설정

# 필요한 포트만 개방
sudo ufw allow 8080/tcp  # HTTP
sudo ufw allow 8443/tcp  # HTTPS
sudo ufw allow 22/tcp    # SSH
sudo ufw enable

---

마무리

Liferay Portal 초기 설정의 성공 키포인트는 데이터베이스 연결 정확성, 환경 변수 설정, 보안 강화입니다. 기본 설정 완료 후 반드시 관리자 계정 보안을 재점검하고, 테스트 페이지를 통해 모든 기능이 정상 작동하는지 확인하시기 바랍니다.
추가적인 커스터마이징은 Liferay Marketplace의 테마/템플릿을 활용하거나 개발자 가이드를 참고하세요. 특히 프로덕션 환경에서는 로드 밸런싱, 클러스터링, 모니터링 시스템 구축도 함께 고려해야 합니다.
성공적인 Liferay Portal 구축을 위해서는 체계적인 계획, 적절한 하드웨어 리소스, 그리고 지속적인 모니터링이 필수입니다.