AtoM 최신버젼 v2.2 설치 매뉴얼(Apache, PHP, MySQL 최신버젼 설치내용 포함)

edited August 2016 in AtoM

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


○ 시스템 요구사항(소프트웨어)
Linux Ubuntu OS v12~14, 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)

○ 리눅스 Ubuntu 운영체제 업데이트
sudo apt-get update (패키지 리스트 저장소 갱신)
sudo apt-get upgrade (시스템 업그레이드)

○ Nano 에디터 설치 (리눅스 초보자의 경우  vi 에디터 보다 사용이 편리)
sudo apt-get install nano

○ AtoM v2.2 설치전 웹서버용 기본 필수 응용프로그램 설치
1. Apache 및 PHP 설치
 1) 현재의 apt repository에 apache와 php용 리스트 추가 및 갱신

     $ sudo apt-get install python-software-properties
     $ sudo apt-add-repository ppa:ondrej/apache2
     $ sudo apt-add-repository ppa:ondrej/php5
     $ sudo apt-get update

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

 2) apache2 최신 버젼 설치
     $ sudo apt-get install apache2 libapache2-mod-xsendfile
     $ sudo a2enmod rewrite xsendfile
     $ sudo nano /etc/apache2/sites-available/000-default.conf
     아래의 라인을 마지막 라인에 추가하고 저장. 단, atom의 경로는 본인이 설치한 경로로 지정해야 함

     <VirtualHost *:90>
       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>

  * atom을 다른 디렉토리에 설치했을 경우엔 /var/www/atom 경로가 아닌 설치한 경로를 입력해줘야 합니다

  3) Apache Virtual Host  설정 수정
     $ sudo nano /etc/apache2/000-default.conf
  * 디폴트 상태의 가상 호스트 설정을 아래와 같이 변경하고 저장합니다(저장시 Ctrl+O, 나갈땐 Ctrl+X)
    이 설정을 변경하지 않는 경우 웹브라우져로 사이트 접속시 Apache 디폴트 페이지가 출력됩니다.
    (변경전) DocumentRoot /var/www/html 
    (변경후) DocumentRoot /var/www/atom

 4) php5 최신 버젼 설치
     $ sudo apt-get install php5
     $ sudo apt-get install php5-mysql


2. MySQL 설치
 1) MySQL 설치
     $ sudo apt-get install mysql-server-5.5 

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

 2) 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

 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
    $ sudo apt-get install libapache2-mod-php5

 6) Gearman JOB Server 설치(작업 스케쥴러)
     $ sudo apt-get install gearman-job-server

 7) 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


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

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

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

 3) AtoM용 데이터베이스 생성
    $ sudo mysql -h localhost -u root -p디비관리자패스워드 -e "CREATE DATABASE atom CHARACTER SET utf8 COLLATE utf8_unicode_ci;"

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

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

 5) AtoM 웹 인스톨러 실행
    웹브라우져를 열고 http://서버주소 접근 후 환경 설정
    데이터베이스명(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 November 2015
    *주의 : 위의 방식을 사용하면 아파치 웹서버의 모듈이 mpm-prefork 방식으로 설치된다.  만약 아파치를 mpm-event 방식으로 설치시엔 다음과 같이 명령어를 사용해야 한다. 
     $ sudo apt-get install libapache2-mod-fastcgi php5-fpm apache2-mpm-event

        그 다음 /etc/apache2/conf-available 디렉토리 밑에 php5-fpm.conf를 신규 생성하고 아래와 같이 입력/저장
        <IfModule mod_fastcgi.c>
           AddHandler php5-fcgi .php
           Action php5-fcgi /php5-fcgi
           Alias /php5-fcgi /usr/lib/cgi-bin/php5-fcgi
           FastCgiExternalServer /usr/lib/cgi-bin/php5-fcgi -socket /var/run/php5-fpm.sock -pass-header Authorization
        <Directory /usr/lib/cgi-bin>
           Require all granted
        </Directory>
       </IfModule>

       모듈을 실행시키려면 아래의 명령어 입력
       $ sudo a2enmod actions fastcgi alias
       $ sudo a2dismod mpm_prefork php5
       $ sudo a2enconf php5-fpm
       $ sudo a2enmod mpm_event
       $ sudo service apache2 restart

       다음 /etc/apache2/mods-available/mpm_event.conf를 열고 아래와 같이 MaxConncectionsPerChild 값만 1000정도로 수정한다. 이는 mpm-event 방식 운용시 메모리 문제 발생을 해소할 수 있다.
       # event MPM
       # StartServers: initial number of server processes to start
       # MinSpareThreads: minimum number of worker threads which are kept spare
       # MaxSpareThreads: maximum number of worker threads which are kept spare
       # ThreadsPerChild: constant number of worker threads in each server process
       # MaxRequestWorkers: maximum number of worker threads
       # MaxConnectionsPerChild: maximum number of requests a server process serves
       StartServers                     2
       MinSpareThreads          25
       MaxSpareThreads          75
       ThreadLimit                      64
       ThreadsPerChild          25 
       MaxRequestWorkers         150
       MaxConnectionsPerChild   1000
       # vim: syntax=apache ts=4 sw=4 sts=4 sr noet

       마지막으로 apache 웹서버를 재기동 시킨다.
       $ sudo service apache2 restart
    apache 웹서버의 mpm이 제대로 설치되었는지 확인하려면 아래의 명령어를 사용한다. 설치된 mpm을 확인할 수 있다.   
       $ apachectl -V | grep -i mpm
  • AtoM v2.2.0 설치 중 마지막 단계인 웹인스톨러 설치 단계에서 페이지 500 에러 발생시 해당 웹주소 뒤에 다음의 URL 을 입력하면 설치 화면이 나타납니다. 뒤에 빨간색으로 표시된 URL만 붙여주시면 됩니다.
    http://서버주소/index.php/sfInstallPlugin/checkSystem
Sign In or Register to comment.