OpenBravo 2.4 CentOS 설치 가이드

이 문서는 CentOS 환경에 OpenBravo ERP 2.4를 소스/바이너리 방식으로 설치하는 단계별 가이드입니다. Tomcat 5.5와 Ant 1.7을 /opt에 설치하고 설치 프로그램 실행으로 OpenBravo를 구성하는 방법, 확인 절차와 문제 해결 팁을 제공합니다.

개요

이 가이드는 다음을 다룹니다:

• Apache Tomcat 5.5 설치 방법
• Apache Ant 1.7 설치 방법
• OpenBravo 2.4 설치(텍스트 기반 설치 프로그램 사용)
• 설치 후 확인과 기본 문제 해결

중요: 본 가이드는 작성 시 OpenBravo 2.4로 테스트되었으며, OpenBravo 2.5는 검증하지 않았습니다. 새 버전 사용은 사용자의 책임입니다.

사전 조건

• CentOS(작성 시 기준)로 루트 권한 또는 sudo 권한 필요
• JDK가 /opt/java 또는 설치 시 지정한 경로에 설치되어 있어야 함
• PostgreSQL 서비스(데이터베이스) 접근 가능
• 네트워크 연결(설치 바이너리 다운로드용)

다음 예시는 /opt를 기준으로 하는 설치 경로를 사용합니다. 필요하면 경로를 환경에 맞게 변경하세요.

Apache Tomcat 5.5 설치

Tomcat은 CentOS 저장소의 번들 버전 대신 직접 tomcat.apache.org에서 내려받아 설치했습니다. 아래 명령들은 /opt에 Tomcat을 풀고 서비스로 띄우는 방법입니다.

cd /opt

wget http://apache.cyberuse.com/tomcat/tomcat-5/v5.5.27/bin/apache-tomcat-5.5.27.tar.gz

tar xzf apache-tomcat-5.5.27.tar.gz

mv apache-tomcat-5.5.27 tomcat

Tomcat 데몬을 시작하고 백그라운드로 보냅니다:

/opt/tomcat/bin/startup.sh &

부팅 시 자동 시작하도록 rc.local에 추가합니다:

echo "/opt/tomcat/bin/startup.sh &" >> /etc/rc.local

주의: CentOS 7 이상에서는 systemd를 사용하므로 rc.local 방식 대신 systemd 유닛 파일을 작성하는 것이 권장됩니다. 본 문서의 예시는 전통적인 /etc/rc.local 기반 시스템에 맞춰져 있습니다.

Apache Ant 1.7 설치

호환성을 위해 Ant 바이너리를 /opt에 설치합니다. 이렇게 설치하면 CentOS 제공 RPM으로 나중에 되돌리기 쉽습니다.

cd /opt

wget http://apache.promopeddler.com/ant/binaries/apache-ant-1.7.1-bin.tar.gz

tar xzf apache-ant-1.7.1-bin.tar.gz

mv apache-ant-1.7.1 ant

rc.local에 ANT_HOME을 추가하고 현재 세션에 환경변수로 설정합니다:

echo "export ANT_HOME=/opt/ant" >> /etc/rc.local

export ANT_HOME=/opt/ant

환경 변수를 쉘 프로파일에 추가하면(예: /etc/profile.d/ 또는 ~/.bashrc) 재로그인 시에도 유지됩니다.

OpenBravo 2.4 다운로드 및 설치

이 가이드는 OpenBravo 2.4 설치 프로그램을 사용한 설치 과정을 보여줍니다. 설치 파일을 내려받아 실행 가능한 상태로 만든 뒤 설치 프로그램을 실행합니다.

cd /tmp

다음은 SourceForge에서 설치 바이너리를 내려받는 예시입니다:

wget http://surfnet.dl.sourceforge.net/sourceforge/openbravo/OpenbravoERP_2.40-linux-installer.bin

실행 권한을 부여합니다:

chmod +x OpenbravoERP_2.40-linux-installer.bin

설치 프로그램을 실행합니다:

./OpenbravoERP_2.40-linux-installer.bin

텍스트 기반 설치 마법사가 시작됩니다. 아래는 설치 중 표시되는 질문과 권장 응답 예시입니다. 설치 과정에서 ENTER 키를 여러 번 눌러 라이선스 조항을 넘어가고 끝에서 yes로 동의합니다.

라이선스 수락 질문 예시:

Do you accept this license? [y/n]: <– y

설치 시작 전 묻는 주요 항목(권장 입력):

• 설치 디렉터리:

Please specify the directory where Openbravo ERP will be installed

입력(기본): [/opt/OpenbravoERP] <– ENTER

• 첨부파일(attachments) 디렉터리:

Please specify a directory for the Openbravo ERP attachments

입력(기본): [/opt/OpenbravoERP/AppsOpenbravo/attachments] <– ENTER

• 설치 모드 선택(완전/분산): 보통 테스트 및 단일 서버 설치는 Complete 선택

Please select the installation mode you wish to perform

옵션 예시:

[1] Complete (데이터베이스와 애플리케이션 서버가 같은 컴퓨터)

[2] Distributed (데이터베이스와 애플리케이션 서버가 다른 컴퓨터)

선택: [1] <– ENTER

• 설치 타입: Standard 추천(데이터베이스 설치 및 애플리케이션 서버 설정)

Please select the installation type you wish to perform

[1] Standard (권장)

[2] Development (컴파일 기반, 개발자용)

선택: [1] <– ENTER

• JDK 디렉터리 (기본 /opt/java): [/opt/java] <– ENTER

• Ant 실행 파일 위치 (기본 /opt/ant/bin/ant): [/opt/ant/bin/ant] <– ENTER

• Tomcat 디렉터리(웹앱이 있는 디렉터리 경로): [/opt/tomcat] <– ENTER

• 데이터베이스 선택: PostgreSQL 권장

Please select a database

[1] PostgreSQL

[2] Oracle

선택: [1] <– ENTER

• PostgreSQL 클라이언트 바이너리 경로(예: psql, pg_restore): [/usr/bin] <– ENTER

• PostgreSQL 호스트 및 포트: Database host [localhost]: <– ENTER

Database port [5432]: <– ENTER

• postgres 관리자 암호 입력: Password : <– (예시 입력)

• Openbravo용 데이터베이스 이름: Database name [openbravo]: <– ENTER

• Openbravo 데이터베이스 사용자 이름: Username [tad]: <– admin

• 새 사용자 암호: Password : <– (선택한 암호 입력)

• 컨텍스트 이름(웹 경로 일부): Context name [openbravo]: <– openbravoerp

• 날짜/시간 형식 및 구분자(기본값 사용 가능)

• 데모 데이터베이스 채우기 여부: [Y/n]: Y <– ENTER

설치 진행과정은 몇 분 정도 소요됩니다. 설치가 완료되면 Setup has finished 메시지가 출력됩니다.

동작 확인

설치가 성공하면 브라우저에서 다음 주소로 접근합니다(예시는 기본 포트 및 컨텍스트):

• http://www.example.com:8080/openbravoerp
• 또는 http://192.168.1.1:8080/openbravoerp

기본 로그인 정보(테스트용): 사용자명 Openbravo, 비밀번호 openbravo

Note: 실제 운영 환경에서는 기본 비밀번호를 즉시 변경하고, 관리자 계정 이름도 변경을 고려하세요.

체크리스트(설치 전/후)

• JDK 설치 및 JAVA_HOME 확인
• ANT_HOME 설정
• Tomcat이 /opt/tomcat에 정상 설치되고 권한 확인
• PostgreSQL 포트/방화벽 접근 허용(기본 5432)
• 설치 스크립트 실행 전 디스크 여유 공간 확인
• 설치 후 Openbravo 웹 로그인 확인

문제 해결 가이드

1. Tomcat이 시작되지 않음

   • /opt/tomcat/logs/catalina.out 파일을 확인해 에러 원인 파악
   • 포트 충돌(예: 8080 사용 중) 확인: netstat -tulpn | grep 8080

2. 데이터베이스 연결 실패

   • PostgreSQL이 원격 접속을 허용하는지 pg_hba.conf 설정 확인
   • psql 클라이언트로 직접 접속 시도: psql -h localhost -U postgres

3. 설치 중 Ant 또는 Java 관련 오류

   • ANT_HOME과 PATH에 ant 실행 파일이 포함되어 있는지 확인
   • 설치 로그 파일(설치 디렉터리 내 logs) 확인

4. 웹 페이지가 404 또는 리소스 로드 실패

   • Tomcat의 webapps 디렉터리에 openbravo가 배포되어 있는지 확인
   • 권한 문제로 파일이 로드되지 않을 수 있으므로 소유자와 권한 확인

보안 및 운영 권장 사항

• 운영 환경에서는 방화벽 규칙으로 Openbravo 포트(기본 8080)를 제한하고, 프록시(예: Nginx) 뒤에 두어 SSL 종료를 구성하세요.
• PostgreSQL 접근은 최소 권한 원칙을 적용하세요. Openbravo 전용 DB 사용자와 강력한 비밀번호 사용을 권장합니다.
• 정기적인 백업 스케줄을 수립하세요(데이터베이스와 attachments 디렉터리 모두 백업).

수용 기준

• 웹 UI에 로그인할 수 있고 기본 화면이 정상적으로 표시된다.
• 데모 데이터(설치 시 선택한 경우)가 데이터베이스에 로드되어 있다.
• 주요 모듈(주문, 고객, 제품 등)에서 간단한 CRUD 작업이 성공한다.
• 설치된 서비스(Tomcat, PostgreSQL)가 재부팅 후에도 자동으로 시작된다.

역할별 체크리스트

관리자

• Tomcat 서비스 상태 확인
• 데이터베이스 백업 정책 구성
• 보안 패치 적용

개발자

• Ant 빌드 환경 확인
• 개발 모드에서 모듈 컴파일 및 배포 절차 점검
• 로그를 통한 오류 재현 및 수정

운영팀

• 모니터링(프로세스, 디스크, 응답시간)을 구성
• 장애 시 롤백/복구 절차 문서화

테스트 케이스(간단)

• 로그인: Openbravo/openbravo로 로그인 성공
• 페이지 로드: 메인 대시보드가 20초 내에 로드
• 데이터 삽입: 새 고객 추가 후 목록에 반영
• 파일 업로드: attachments 디렉터리에 파일 업로드 성공

링크

• Openbravo: http://www.openbravo.com/
• CentOS: http://www.centos.org
• PostgreSQL RPM 저장소: http://yum.pgsqlrpms.org

요약

설치 전 필수 구성 요소(JDK, Ant, Tomcat, PostgreSQL)를 준비하고, 제공한 명령으로 /opt에 배치한 뒤 OpenBravo 설치 프로그램을 실행하면 됩니다. 설치 후에는 로그인과 기본 CRUD 테스트로 정상 동작을 확인하고, 운영 환경 전환 시 보안과 백업 정책을 반드시 적용하세요.

중요: OpenBravo 2.4는 본 문서 작성 시점에 검증된 버전입니다. 최신 버전 사용 시 호환성 검토를 권장합니다.