BIKA LIMS 및 ReportLab Ubuntu에 설치하기
주요 요구사항 및 준비
- Ubuntu 서버에 루트 또는 sudo 권한이 있어야 합니다.
- Plone/ZOPE 인스턴스 경로와 설치에 사용한 사용자명(USERNAME)을 알아야 합니다.
- 명령어에 등장하는 변수(예: $BIKA_WGET_ADDRESS, $DOWNLOAD_DIR 등)는 실제 값으로 치환해서 사용하세요.
- nano 편집기 사용법: 이동은 방향키, 라인 자르기 ctrl-k, 붙여넣기 ctrl-u, 저장 후 종료 ctrl-x 다음 y.
1. BIKA LIMS와 ReportLab 다운로드 및 압축 해제
다음 명령어로 BIKA 및 ReportLab 소스(또는 tarball)를 다운로드하고 압축을 풉니다. 각 변수는 환경에 맞게 설정하세요.
sudo wget $BIKA_WGET_ADDRESS -P $DOWNLOAD_DIRsudo tar -xzf $DOWNLOAD_DIR/$BIKA_TARBALL -C $MY_PRODUCTS_DIRsudo wget $REPORTLAB_WGET_ADDRESS -P $DOWNLOAD_DIRsudo tar -xzvf $DOWNLOAD_DIR/$REPORTLAB_TARBALL -C $MY_PRODUCTS_DIR2. Ubuntu용 ReportLab 패키지 설치
Ubuntu 배포판에 맞는 ReportLab 패키지를 설치합니다. 예시는 패키지명으로 python-reportlab을 사용합니다.
sudo apt-get install python-reportlab중요: 배포판과 Python 버전에 따라 패키지명이 다를 수 있습니다. 배포판 버전(Hardy Heron 등)에 맞는 패키지를 설치하세요.
3. Bika 전용 글꼴 설치 준비 및 압축 해제
BIKA에서 제공하는 글꼴을 다운로드하고 적절한 디렉터리에 넣습니다.
sudo mkdir $MY_PRODUCTS_DIR/$BIKAFONTS_DIRsudo wget $BIKAFONTS_WGET_ADDRESS -P $DOWNLOAD_DIRsudo cp $DOWNLOAD_DIR/$BIKAFONTS_ZIPFILE $MY_PRODUCTS_DIR/$BIKAFONTS_DIR/$BIKAFONTS_ZIPFILEsudo apt-get install unzipcd $MY_PRODUCTS_DIR/$BIKAFONTS_DIRsudo unzip -j $MY_PRODUCTS_DIR/$BIKAFONTS_DIR/$BIKAFONTS_ZIPFILE설치 후 글꼴 파일들이 $MY_PRODUCTS_DIR/$BIKAFONTS_DIR 안에 있어야 합니다.
4. ReportLab에 글꼴 복사하기
ReportLab이 설치된 위치를 찾고, 그 안의 fonts 디렉터리에 Bika 글꼴을 복사합니다.
REPORTLAB_INSTALL_LOCATION=`sudo find / -name reportlab -print | grep python2.4`환경에 따라 python2.4 대신 python2.7, python3.x 등으로 검색이 필요할 수 있습니다.
INSTALLED_FONTS_DIR=$REPORTLAB_INSTALL_LOCATION/fontssudo mkdir $INSTALLED_FONTS_DIRsudo cp $MY_PRODUCTS_DIR/$BIKAFONTS_DIR/* $INSTALLED_FONTS_DIR설치된 글꼴 경로를 출력해 확인합니다.
$INSTALLED_FONTS_DIR예: usr/lib/python2.4/site-packages/reportlab/fonts
중요: 출력된 경로를 메모해 두세요. 이후 설정 파일에 이 경로를 넣어야 합니다.
5. ReportLab 설정 파일(rl_config.py)에서 글꼴 경로 등록
ReportLab 설정 파일을 편집하여 Bika 글꼴 경로를 추가합니다.
sudo nano $REPORTLAB_INSTALL_LOCATION/rl_config.py파일 안에서 Linux Adobe 글꼴 경로를 설명하는 첫 라인을 찾으세요. 예시:
'/usr/lib/Acrobat9/Resource/Font', #Linux, Acrobat 5?이 줄을 복사(또는 잘라내기)하여 동일한 형식으로 Bika 글꼴 경로를 추가합니다. 예:
' usr/lib/python2.4/site-packages/reportlab/fonts ', #Linux, BIKA fonts저장하려면 ctrl-x, y를 누르세요.
6. Bika 제품 파일을 Plone 인스턴스로 복사
sudo cp $MY_PRODUCTS_DIR/$BIKA_VERSION/PloneProducts/* $INSTANCE_HOME/Products -rsudo cp $INSTANCE_HOME/Products/bika/scripts/start-id-server $INSTANCE_HOME여러 개의 Plone 인스턴스가 있고 포트 충돌이 발생하면 start-id-server 스크립트에서 포트 번호(예: 8081)를 변경해야 합니다. 단일 인스턴스라면 기본값으로 충분한 경우가 많습니다.
7. zope.conf 편집 — ID 서버 URL 설정
zope.conf 파일 위치를 찾고 편집합니다.
ZOPECONF_FILE=`sudo find / -name zope.conf -print`sudo nano $ZOPECONF_FILE환경 블록을 찾아 다음과 같이 IDServerURL 항목을 추가 또는 수정하세요.
IDServerURL http://localhost:8081
저장 후 종료(ctrl-x, y).
8. id-server 및 Zope 시작
id-server를 실행하고 Zope를 시작합니다. USERNAME을 실제 사용자명으로 바꿔 실행하세요.
su USERNAME $INSTANCE_HOME/start-id-server$INSTANCE_HOME/bin/zopectl start9. 웹에서 Zope 관리 인터페이스 접속 및 Bika 사이트 생성
브라우저에서 Zope 관리 인터페이스로 접속합니다. LIMSERVERlocalip는 ifconfig로 확인한 서버 IP입니다.
http://LIMSERVERlocalip:8080- 사용자명으로 ‘admin’을 입력합니다. 비밀번호는 설치 시 사용한 값일 가능성이 큽니다. 로그인되지 않으면 서버에서 비밀번호 파일을 찾아 확인하세요.
sudo find / -name *password*파일을 열어 비밀번호를 확인합니다.
BIKA 사이트를 생성하려면 ZMI(Zope Management Interface)에서 Manage를 클릭한 뒤 Add를 선택합니다. Plone site를 선택하고 id 필드에 사이트 이름(예: bika-site-name)을 입력합니다. 아래 옵션에서 bika를 선택한 뒤 Add를 클릭합니다.
사이트 생성이 완료되면 다음 URL로 접속하세요.
http://LIMSERVERlocalip:8080/bika-site-name축하합니다 — BIKA가 실행됩니다.
문제 해결 팁 및 체크리스트
중요: 각 단계 후 다음 항목을 확인하세요.
- 다운로드와 압축 해제: 파일이 $MY_PRODUCTS_DIR에 존재하는지 확인합니다. ls로 확인하세요.
- ReportLab 설치: python-reportlab이 올바른 Python 버전용인지 확인합니다.
- 글꼴 복사: ReportLab fonts 디렉터리에 파일이 존재하는지 ls로 확인합니다.
- rl_config.py: 추가한 글꼴 경로 문자열에 오타나 불필요 공백이 없는지 확인하세요.
- 포트 충돌: start-id-server와 Zope 포트가 중복되지 않는지 확인합니다.
- Zope 로그인: admin 비밀번호가 맞지 않으면 비밀번호 파일을 찾아 확인하세요.
간단 검사 명령 예:
ls -la $MY_PRODUCTS_DIR/$BIKAFONTS_DIR
ls -la $INSTALLED_FONTS_DIR
grep -n "fonts" $REPORTLAB_INSTALL_LOCATION/rl_config.py
sudo netstat -tulnp | grep LISTEN역할별 체크리스트 (시스템 관리자, 개발자)
시스템 관리자
- sudo 권한 확인
- 필요한 패키지(apt-get) 설치
- 방화벽 및 포트(8080,8081) 허용
- 사용자 권한 설정
개발자 / Plone 관리자
- Bika 패키지 PloneProducts에 복사
- ZMI에서 Plone 사이트 추가 및 구성
- 로그 확인(zope/instance var/log)
간단 SOP(작업 순서 요약)
- 필요한 패키지 설치(apt-get, unzip, python-reportlab).
- BIKA 및 ReportLab 소스 다운로드 및 압축 해제.
- Bika 글꼴을 다운로드하고 ReportLab의 fonts 디렉터리로 복사.
- rl_config.py에 글꼴 경로를 추가.
- Bika 제품을 Plone Products에 복사.
- start-id-server 복사 및 zope.conf에 IDServerURL 설정.
- id-server 및 zope 시작.
- ZMI로 접속하여 Plone/Bika 사이트 생성.
자주 발생하는 오류와 해결 방법
- 글꼴이 안 보임: rl_config.py에 등록한 경로가 정확한지, 파일 권한이 적절한지 확인하세요.
- 포트 충돌: 다른 서비스가 8081을 사용하면 start-id-server의 포트를 바꾸거나 해당 서비스 포트를 변경하세요.
- 로그인 실패: admin 비밀번호를 못 찾으면 서버에서 password 관련 파일을 찾아 내용을 확인하세요.
1줄 용어집
- rl_config.py: ReportLab 설정 파일입니다.
- ZMI: Zope Management Interface, Zope를 웹으로 관리하는 UI입니다.
- ID Server: Plone/ZOPE에서 ID 관리용 별도 프로세스입니다.
마무리 요약
- Bika 설치는 파일 복사, 글꼴 등록, Zope 설정의 세 가지 주요 단계로 구성됩니다.
- 각 단계에서 파일 경로와 권한, 포트 충돌 여부를 반드시 확인하세요.
- 문제가 발생하면 로그와 파일 존재 유무, rl_config.py 설정을 먼저 점검하세요.
요약 끝. 즐거운 사용 되세요!
