기술 가이드

Openbravo ERP을 Debian Etch에 설치하는 방법

• 6 min read • 설치 가이드 • 업데이트됨 22 Sep 2025
Debian Etch에 Openbravo ERP 설치 가이드
Debian Etch에 Openbravo ERP 설치 가이드

개요

이 문서는 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 update

GPG 키를 가져옵니다:

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 restart

PostgreSQL 쉘을 열고 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=no

Tomcat 재시작:

/etc/init.d/tomcat5.5 restart

Tomcat이 정상적으로 올라왔는지 확인:

netstat -tap | grep java

Tomcat은 일반적으로 포트 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 메인 화면 예시

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 기동 실패

  1. catalina.out와 시스템 로그 확인
  2. JAVA_HOME/CATALINA_HOME 환경변수 재검토
  3. 메모리 부족이면 CATALINA_OPTS 조정 후 재시작
  4. 문제가 지속되면 최근 변경사항(설정/업데이트) 롤백

문제: 데이터베이스 접속 불가

  1. pg_hba.conf 설정 확인
  2. PostgreSQL 서비스 상태 확인(/etc/init.d/postgresql-8.2 status)
  3. 포트 및 방화벽 확인
  4. postgres 로그 확인(일반적으로 /var/log/postgresql)

요약

  • Debian Etch에서 Openbravo 설치는 PostgreSQL, Sun JDK, Tomcat, Ant 설정이 핵심입니다.
  • 설치 전에 환경변수와 권한, 포트의 일관성을 확인하세요.
  • 문제 발생 시 로그를 우선 확인하고, 환경변수·버전 불일치를 의심하세요.

중요: 이 문서는 실무 가이드입니다. 실제 운영 환경 적용 전에 테스트와 보안 검토를 반드시 수행하세요.

링크

공유하기: X/Twitter Facebook LinkedIn Telegram
저자
편집

유사한 자료

Debian 11에 Podman 설치 및 사용하기
컨테이너

Debian 11에 Podman 설치 및 사용하기

Apt-Pinning 간단 소개 — Debian 패키지 우선순위 설정
시스템 관리

Apt-Pinning 간단 소개 — Debian 패키지 우선순위 설정

OptiScaler로 FSR 4 주입: 설치·설정·문제해결 가이드
그래픽 가이드

OptiScaler로 FSR 4 주입: 설치·설정·문제해결 가이드

Debian Etch에 Dansguardian+Squid(NTLM) 구성
네트워크

Debian Etch에 Dansguardian+Squid(NTLM) 구성

안드로이드 SD카드 설치 오류(Error -18) 완전 해결
안드로이드 오류

안드로이드 SD카드 설치 오류(Error -18) 완전 해결

KNetAttach로 원격 네트워크 폴더 연결하기
네트워킹

KNetAttach로 원격 네트워크 폴더 연결하기