AtoM v2.3.0 설치 매뉴얼(Apache, PHP, MySQL 설치 포함)

edited August 2016 in AtoM

AtoM을 리눅스 우분투 운영체제에서 처음 설치하시는 분들은 아래의 내용을 참고해 주십시오.
아래의 방법은 AtoM 설치 방법 외에 AtoM 구동에 필요한 서버용 기본 소프트웨어와 각종 필수 소프트웨어들의 설치 방법도 함께 알려드리니 OS 설치 이후의 전체적인 설치 방법을 이해하시는데 도움이 될 것입니다.


○ 시스템 요구사항(소프트웨어)
Linux Ubuntu OS v14.04, Apache v2.4 이상, Elasticsearch v1.3.0 이상, MySQL v5.5, PHP v5.3 이상, cURL(php5-curl), JSON(php5-json), APC(php-apc),PDO and PDO-MySQL(php5-mysql), XSL(php5-xsl)


○ AtoM v2.3.0 설치전 웹서버용 기본 필수 응용프로그램 설치
1. Apache 및 PHP 설치
  
1) apache2 설치
    현재의 apt repository에 apache와 php용 리스트 추가 및 갱신
     $ sudo apt-get install python-software-properties
     $ sudo apt-add-repository ppa:ondrej/apache2
     $ sudo apt-get update

     *주의 : 만약 우분투 OS 버젼이 14.x 하위 버젼인 경우엔 sudo apt-add-repository ppa:ondrej/apache2를 다음과 같이 설정 
      sudo apt-add-repository ppa:ptn107/apache

     Apache 설치
     $ sudo apt-get install apache2 libapache2-mod-xsendfile libapache2-mod-php5
     $ sudo a2enmod rewrite xsendfile

    Apache Virtual Host(가상호스트) 설정 수정
     $ sudo nano /etc/apache2/sites-available/000-default.conf
     상단의 <VirtualHost *:80> ~ </VirtualHost> 라인은 모두 삭제하거나 앞에 #를 붙여 주석 처리하여 비활성화 시킴.     
     아래의 코드를 복사해서 붙여 넣은 후 파일 저장(Ctrl키 + 영문 O 클릭). 나갈 땐 Ctrl키 + 영문 X 클릭.
     단, atom의 경로는 본인이 설치한 경로로 지정.

     <VirtualHost *:80>
       DocumentRoot /var/www/atom
       RewriteEngine On
       RewriteRule ^/uploads/r/([^/]*)/conf/(.*)$ /var/www/atom/uploads/r/$1/conf/$2 [L]
       RewriteRule ^/uploads/(.*)$ /var/www/atom/uploads/$1 [L]
       <LocationMatch ^/uploads>
         XSendFile On
         XSendFilePath /var/www/atom/uploads
         SetEnv ATOM_XSENDFILE 1
       </LocationMatch>
     </VirtualHost>

 2) php5 설치
     $ sudo apt-get install php5
     $ sudo apt-get install php5-mysql

 3) PHP 확장모듈(php extension) 설치
    $ sudo apt-get install php5-cli php5-fpm php5-curl php5-mysql php5-xsl php5-json php5-ldap php-apc
    만약 사용 중인 운영체제가 우분투 14.04인 경우엔 다음의 패키지도 설치
    $ sudo apt-get install php5-readline


2. MySQL 및 기타 패키지 설치
 1) MySQL 설치
     $ sudo apt-get install mysql-server-5.5 

 2) JAVA 구동 환경 설치(Java 관련 레퍼런스는 http://oracle.com/technetwork/java/javase/overview/index.html 참조할 것)
    $ sudo apt-get install openjdk-7-jre-headless

 3) Elasticsearch 검색엔진 설치(Elasticsearch 관련 레퍼런스는 http://elasticsearch.org 참조)
    $ wget -qO - http://packages.elasticsearch.org/GPG-KEY-elasticsearch | sudo apt-key add -
    $ sudo nano /etc/apt/sources.list
     아래의 주소를 sources.list 마지막 라인에 추가한 후 저장.
    deb http://packages.elasticsearch.org/elasticsearch/1.7/debian stable main
    $ sudo apt-get update
    $ sudo apt-get install elasticsearch
    $ sudo update-rc.d elasticsearch defaults 95 10
    $ sudo /etc/init.d/elasticsearch start

 4) Gearman JOB Server 설치(작업 스케쥴러)
     $ sudo apt-get install gearman-job-server
     $ sudo nano /etc/init/atom-worker.conf
     아래의 코드 복사해서 붙여 넣은 후 파일 저장(Ctrl키 + 영문 O 클릭), 나갈 땐 Ctrl키 + 영문 X 클릭.

     description "AtoM worker (gearmand) upstart service"

     start on (started mysql)
     stop on runlevel [016]

     respawn
     respawn limit 5 10

     env LOCATION=/var/www/atom
     env LOGFILE=/var/www/atom/log/atom-worker.log

     setuid www-data
     setgid www-data

     script

       php \
         -d memory_limit=-1 \
         -d error_reporting="E_ALL" \
           ${LOCATION}/symfony jobs:worker >> ${LOGFILE} 2>&1

     end script

    아래의 명령어 중 시작과 구동 상태 체크 명령어로 실행 테스트
     atom-worker 시작 명령어
     $ sudo start atom-worker  

     atom-worker 종료 명령어
     $ sudo stop atom-worker

     atom-worker 재시작 명령어
     $ sudo restart atom-worker 

     atom-worker 구동 상태 체크 명령어
     $ sudo status atom-worker  

 5) Apache FOP 설치(PDF 검색도구)
     $ sudo -s
     $ wget https://archive.apache.org/dist/xmlgraphics/fop/binaries/fop-1.0-bin.tar.gz
     $ tar -zxvf fop-1.0-bin.tar.gz
     $ rm fop-1.0-bin.tar.gz
     $ mv fop-1.0 /usr/share
     $ ln -s /usr/share/fop-1.0/fop /usr/bin/fop
     $ echo 'FOP_HOME="/usr/share/fop-1.0"' >> /etc/environment
     $ exit

 6) 이미지 포맷 변환용 패키지 설치
    $ sudo apt-get install imagemagick ghostscript poppler-utils


3. AtoM v2.3.0 설치
 ○ 다운로드 및 설치
 1) AtoM 다운로드 및 설치
    $ wget http://storage.accesstomemory.org/releases/atom-2.3.0.tar.gz
    $ sudo mkdir /var/www/atom
    $ sudo tar xzf atom-2.3.0.tar.gz -C /var/www/atom --strip 1

 2) AtoM 디렉토리 퍼미션(사용권한) 설정
    $ sudo chown -R www-data:www-data /var/www/atom

 3) AtoM용 데이터베이스 생성
    $ sudo mysql -h localhost -u root -p디비관리자패스워드 -e "CREATE DATABASE atom CHARACTER SET utf8 COLLATE utf8_unicode_ci;"
    * 디비관리자패스워드는 MySQL 설치시 입력했던 데이터베이스 관리자 패스워드 입력  

 4) Apache, MySQL 재시작
   $ sudo /etc/init.d/apache2 restart    ( 또는  sudo service apache2 restart )
   $ sudo service mysql restart

   * 주의사항 :  AtoM 웹 인스톨러의 실행 전에 웹서버 및 DBMS의 서비스를 재시작하지 않으면 웹 인스톨러 실행시 빈 페이지만 나올 수 있음.

 5) AtoM 웹 인스톨러 실행
    웹브라우져를 열고 http://서버주소 접근 후 환경 설정(서버주소는 로컬에서만 테스트하는 경우 http://localhost로 들어갈 수 있음)
    데이터베이스명(Database name) : atom
    데이터베이스관리자(Database username) : root
    데이터베이스 암호 : 디비관리자패스워드 입력
    데이터베이스 호스트 : localhost 또는 아이피, 도메인 입력
    데이터베이스 포트 : 3306
    검색용 호스트(Search host) : localhost 또는 아이피, 도메인 입력
    검색 포트 : 9200
    검색 인덱스 : atom

  6) AtoM 웹사이트 기본 설정
    Site title : 사이트 명칭 입력(한글 또는 영문 등 원하는 대로 입력)
    Site description : 사이트 설명 입력(상동)
    Username : 사이트 관리자 아이디 입력(영문)
    E-mail address : 사이트 관리자 이메일 입력(메일형식에 맞게)
    Password : 사이트 관리자 패스워드 입력(영문 및 숫자 혼용)

 7) 설치 완료


Comments

  • edited July 2016
    AtoM v2.3.0 설치 중 마지막 단계인 웹인스톨러 설치 단계에서 페이지 500 에러 발생시 해당 웹주소 뒤에 다음의 URL 을 입력하면 설치 화면이 나타납니다. 뒤에 빨간색으로 표시된 URL만 붙여주시면 됩니다.

    http://서버주소/index.php/sfInstallPlugin/checkSystem
  • edited March 2017




  • 3월 현재 최신버전은 2.3.1 입니다
    위 매뉴얼의 2.3.0 부분을 모두 2.3.1로 해 주시면 됩니다.

    3. AtoM v2.3.1 설치
     ○ 다운로드 및 설치
     1) AtoM 다운로드 및 설치
        $ wget http://storage.accesstomemory.org/releases/atom-2.3.1.tar.gz
        $ sudo mkdir /var/www/atom
        $ sudo tar xzf atom-2.3.1.tar.gz -C /var/www/atom --strip 1
  • 아마존 AWS 서버를 신청해서 사용하는 분들 중 서버 OS를 16.04 버젼을 사용하고 계신 분들이 상당수 있는 것 같아서 우분투 서버 v16.04 버젼에서의 APM 설치와 AtoM v2.3.1 설치 매뉴얼을 별도로 만들어서 올리도록 하겠습니다. 참고로 AtoM 관련 설치 매뉴얼은 우분투 OS 버젼이 14.04 버젼을 기준으로 만든 관계로 기존 매뉴얼을 가지고 우분투 서버 16.04에서 설치시 많은 에러가 발생할 수 있습니다. 이 점 유의하시기 바랍니다.

Sign In or Register to comment.