Openbravo ERP을 Debian Etch에 설치하는 방법
개요
이 문서는 Debian Etch 환경에서 Openbravo ERP를 설치하는 실제 절차를 설명합니다. Openbravo는 중소기업(SME)을 위해 설계된 오픈소스 ERP입니다. 웹 기반으로 작동하며 조달·창고·프로젝트·생산·재무 관리를 포함한 확장형 ERP 기능을 제공합니다. 이 가이드는 실무 중심이며 이론적 배경은 다루지 않습니다.
중요: 프로덕션 시스템에 적용하기 전에 반드시 테스트 환경에서 전체 설치와 복원 절차를 확인하세요.
정의(한 줄):
- Openbravo: 오픈소스 ERP 애플리케이션
- Tomcat: Java 기반 서블릿 컨테이너
- PostgreSQL: 오픈소스 관계형 데이터베이스
목차
- 준비
- Debian Backports 추가
- 필요한 패키지 설치 및 설정
- PostgreSQL
- Java JDK
- Apache Tomcat
- Apache Ant
- Openbravo 설치
- 소스(인스톨러) 다운로드
- 텍스트 기반 설치 진행
- 웹 인터페이스 접속
- 점검 및 문제해결
- 체크리스트 및 권장 운영 단계
- 링크
1 준비
설치 전에 다음을 준비하세요:
- 루트 권한 또는 sudo 사용 권한
- 인터넷 연결
- 설치 대상 서버의 FQDN(예: server1.example.com)
- 설치 중 사용할 비밀번호 목록
1.1 Debian Backports
Sun JDK 같은 패키지는 backports 저장소에서 제공됩니다. /etc/apt/sources.list를 편집하세요:
vi /etc/apt/sources.list다음 라인을 추가합니다:
# Debian Backports
deb http://www.backports.org/debian etch-backports main contrib non-free패키지 색인 갱신:
apt-get updateGPG 키를 가져옵니다:
apt-get install debian-backports-keyring중요: backports에서 더 최근 버전 패키지를 사용할 때는 시스템 전체 의존성 충돌이 없는지 확인하세요.
1.2 필요한 패키지
다음 섹션에서는 PostgreSQL, Java JDK, Tomcat, Ant를 설치하고 최소한의 설정을 수행합니다.
1.2.1 PostgreSQL
설치:
apt-get install postgresql-8.2관리자 비밀번호 설정을 위해 pg_hba.conf를 임시로 변경합니다:
sed -i 's/ident sameuser$/trust/' /etc/postgresql/8.2/main/pg_hba.conf
/etc/init.d/postgresql-8.2 restartPostgreSQL 쉘을 열고 postgres 역할 비밀번호를 설정합니다:
psql -U postgres
alter role postgres with password '%new_PostgreSQL_admin_passowrd%';
\q보안 모드로 되돌립니다:
sed -i 's/trust$/md5/' /etc/postgresql/8.2/main/pg_hba.conf
/etc/init.d/postgresql-8.2 reload팁: 실제 비밀번호는 강력한 문자열을 사용하고 안전한 비밀번호 관리 도구에 보관하세요.
1.2.2 Java JDK
Sun JDK 설치(Backports에서 제공):
apt-get install sun-java6-jdk시스템 전역에서 사용할 수 있도록 설정:
update-java-alternatives -s java-6-sun
echo 'JAVA_HOME="/usr/lib/jvm/java-6-sun"' | tee -a /etc/environment설정 반영을 위해 로그아웃 후 재로그인합니다.
참고: JAVA_HOME 경로는 시스템에 따라 다를 수 있습니다. java -version로 확인하세요.
1.2.3 Apache Tomcat
Tomcat 설치:
apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps기본 로그 파일을 초기화하고 init 스크립트를 편집합니다:
rm /var/log/tomcat5.5/catalina.out
vi /etc/init.d/tomcat5.5다음을 변경하세요:
TOMCAT5_SECURITY=yes를
TOMCAT5_SECURITY=noTomcat 재시작:
/etc/init.d/tomcat5.5 restartTomcat이 정상적으로 올라왔는지 확인:
netstat -tap | grep javaTomcat은 일반적으로 포트 8180에서 수신합니다. 예시 출력:
tcp6 0 0 *:8180 *:* LISTEN 3571/java필요한 경우 시스템 전역 환경변수를 추가합니다:
echo 'CATALINA_HOME="/usr/share/tomcat5.5"' | tee -a /etc/environment
echo 'CATALINA_BASE="/var/lib/tomcat5.5"' | tee -a /etc/environment
echo 'CATALINA_OPTS="-server -Xms384M -Xmx512M"' | tee -a /etc/environment설정 반영을 위해 로그아웃 후 재로그인합니다.
메모: 메모리 옵션(Xms/Xmx)은 서버 용량에 맞게 조정하세요.
1.2.4 Apache Ant
Ant는 앞단 패키지에서 의존성으로 설치되었을 가능성이 큽니다. 환경변수만 추가합니다:
echo 'ANT_HOME="/usr/share/ant"' | tee -a /etc/environment설정 반영을 위해 로그아웃 후 재로그인합니다.
검증: ant -version 명령으로 정상 동작 확인.
2 Openbravo
2.1 인스톨러 다운로드
Openbravo 인스톨러 최신 버전은 SourceForge 프로젝트 페이지에서 확인하세요. 예시(작성 시점 버전 2.35mp1):
cd /tmp/
wget http://mesh.dl.sourceforge.net/sourceforge/openbravo/OpenbravoERP-2.35-MP1-linux-installer.bin
chmod +x OpenbravoERP-2.35-MP1-linux-installer.bin파일 이름과 URL은 시점에 따라 바뀔 수 있습니다. 항상 공식 배포처에서 최신 파일을 확인하세요.
2.2 설치 진행
텍스트 기반 설치 프로그램이 안내합니다:
./OpenbravoERP-2.35-MP1-linux-installer.bin라이선스 텍스트는 Enter로 페이지 단위로 진행하고 마지막에 “yes”를 입력해 동의합니다.
설치 질문에 대한 권장 응답(기본값 사용):
- 설치 디렉터리: Enter (기본 /opt/OpenbravoERP)
- 첨부 파일 디렉터리: Enter (기본 /opt/OpenbravoERP/AppsOpenbravo/attach)
- 설치 유형: Enter (Full (standard) 설치)
- 데이터베이스: PostgreSQL 선택
- Java 홈 디렉터리: Enter (기본 /usr/lib/jvm/java-6-sun)
- Apache Ant 홈: Enter (기본 /usr/share/ant)
- Tomcat 설치 디렉터리: Enter (기본 /var/lib/tomcat5.5)
- 웹서버 도메인: 서버의 FQDN 입력(e.g., server1.example.com)
- HTTP 포트: 8180 입력
- 컨텍스트 이름: Enter (기본 openbravo)
- PostgreSQL 바이너리 디렉터리: /usr/bin 입력
- 데이터베이스 서버: Enter (기본 localhost)
- PostgreSQL 포트: Enter (기본 4532)
- 데이터베이스 이름: Enter (기본 openbravo)
- PostgreSQL 관리자 비밀번호: 1.2.1에서 설정한 값 입력(두 번)
- Openbravo 데이터베이스 사용자: Enter (기본 tad)
- 새 사용자 비밀번호: 원하는 비밀번호 입력(두 번)
- 설치 시작: y 입력
설치에는 시간이 걸리며, 설치 중 빌드(ant)가 소스 컴파일을 수행합니다.
중요: 빌드 실패는 보통 Java 버전, Ant 경로, 또는 Tomcat 환경변수 문제에서 발생합니다. 로그를 확인하세요.
2.3 웹 인터페이스 접속
설치가 정상적으로 끝나면 웹 브라우저에서 다음 주소로 접속합니다:
http://%servername%:8180/openbravo
기본 로그인:
- 사용자명: Openbravo
- 비밀번호: openbravo
이미지: Openbravo 메인 화면 예시
ALT 텍스트는 간결하게 화면 내용을 설명합니다. 스크린샷은 설치 후 UI 확인용입니다.
3 점검 및 문제해결
일반적인 문제와 해결책:
- Tomcat이 기동하지 않음
- /var/log/tomcat5.5/catalina.out를 확인하세요.
- JAVA_HOME과 CATALINA_HOME이 올바른지 확인하세요.
- 데이터베이스 접속 실패
- pg_hba.conf가 md5로 설정되어 있고 postgres 비밀번호가 올바른지 확인하세요.
- 포트 및 호스트(로컬/리모트)를 확인하세요.
- 빌드(ant) 실패
- ant -version 확인, ANT_HOME이 설정되었는지 확인하세요.
- JAVA_HOME과 PATH 충돌 여부 확인.
- 웹에서 404 또는 500 에러
- Tomcat 로그와 Openbravo 로그(설치 디렉터리의 logs)를 확인하세요.
디버깅 팁:
- 로그를 실시간으로 확인하려면 tail -f 명령을 사용하세요.
- 설치가 실패하면 installer log 파일과 catalina.out를 함께 살펴보면 원인 파악이 쉬워집니다.
4 운영 전 체크리스트
시스템 준비
- 전체 백업(스냅샷 또는 백업 도구)
- 테스트 환경에서 설치 및 복원 검증
- 방화벽에서 포트 8180 허용 여부 확인
보안
- postgres와 Openbravo 사용자 강력한 비밀번호 설정
- Tomcat 관리자 계정 비활성화 또는 접근 제어
- 필요한 경우 HTTPS 설정(리버스 프록시 또는 Tomcat 자체)
성능 및 리소스
- JVM 메모리 옵션 검토 및 조정(-Xms/-Xmx)
- PostgreSQL 튜닝(워크로드에 따라 shared_buffers 등)
모니터링 및 로그
- 로그 회전 정책 설정
- 애플리케이션 모니터링 도구 구성
5 배포 후 권장 작업
- 보안 패치가 있으면 즉시 적용하세요. 특히 Java와 데이터베이스 관련 보안 이슈는 우선 대응 대상입니다.
- 정기적인 백업과 복원 테스트를 수행하세요.
- 사용자 계정과 권한 관리를 문서화하세요.
대안 및 확장 접근법
- 데이터베이스 원격 분리: 프로덕션에서 DB를 별도 서버로 분리하면 성능과 보안이 향상됩니다.
- 리버스 프록시: Apache HTTPD 또는 Nginx를 Tomcat 앞단에 두고 HTTPS 및 로드밸런싱 구성.
- 컨테이너화: 최신 환경에서는 Docker 컨테이너로 Openbravo를 실행하는 방법도 고려할 수 있습니다.
언제 이 방법이 적합하지 않은가(예시):
- Debian Etch가 아닌 최신 배포판을 사용하는 경우 패키지 버전 차이로 인해 절차가 달라질 수 있습니다.
- 보안 규제가 엄격한 환경에서는 추가 보안 인증 및 네트워크 분리가 필요합니다.
역할 기반 체크리스트
시스템 관리자
- Java, Tomcat, DB 설치 및 서비스 유지 관리
- 방화벽과 모니터링 설정
데이터베이스 관리자
- PostgreSQL 사용자 및 권한 관리
- 정기 백업 및 복구 테스트
애플리케이션 관리자
- Openbravo 업데이트 및 모듈 관리
- 사용자 계정, 권한, 감사 로그 검토
간단 복구(런북)
문제: Tomcat 기동 실패
- catalina.out와 시스템 로그 확인
- JAVA_HOME/CATALINA_HOME 환경변수 재검토
- 메모리 부족이면 CATALINA_OPTS 조정 후 재시작
- 문제가 지속되면 최근 변경사항(설정/업데이트) 롤백
문제: 데이터베이스 접속 불가
- pg_hba.conf 설정 확인
- PostgreSQL 서비스 상태 확인(/etc/init.d/postgresql-8.2 status)
- 포트 및 방화벽 확인
- postgres 로그 확인(일반적으로 /var/log/postgresql)
요약
- Debian Etch에서 Openbravo 설치는 PostgreSQL, Sun JDK, Tomcat, Ant 설정이 핵심입니다.
- 설치 전에 환경변수와 권한, 포트의 일관성을 확인하세요.
- 문제 발생 시 로그를 우선 확인하고, 환경변수·버전 불일치를 의심하세요.
중요: 이 문서는 실무 가이드입니다. 실제 운영 환경 적용 전에 테스트와 보안 검토를 반드시 수행하세요.
링크
- Debian: http://www.debian.org/
- Openbravo: http://www.openbravo.com/
- Openbravo 사용자 매뉴얼: http://wiki.openbravo.com/wiki/User_Manual_2.3
