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

edited August 2016 in AtoM

AtoM을 리눅스 우분투 운영체제에서 처음 설치하시는 분들은 아래의 내용을 참고해 주십시오..
AtoM 제작사(http://accesstomemory.org)에서 제공하는 인스톨 가이드도 있지만 설치 중 에러가 발생되는 경우가 종종 있어서 현재까지 테스트 해본 중에 가장 성공적이고 문제 없는 방법을 정리하여 알려드리니 참고하시기 바랍니다.
아래의 방법은 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.1.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

*주의 : 위의 방식을 사용하면 아파치 웹서버의 모듈이 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

 3) 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 -y openjdk-7-jre-headless

 2) Elasticsearch 검색엔진 설치(Elasticsearch 관련 레퍼런스는 http://elasticsearch.org 참조)
    $ wget https://download.elasticsearch.org/elasticsearch/elasticsearch/elasticsearch-1.3.0.deb
    $ sudo dpkg -i elasticsearch-1.3.0.deb
    $ sudo rm elasticsearch-1.3.0.deb
    $ sudo /etc/init.d/elasticsearch start 

 3) PHP 확장모듈(php extension) 설치
    $ sudo apt-get install php5-cli php5-fpm php5-curl php5-mysql php5-xsl php-apc

 4) 이미지 포맷 변환용 패키지 설치
    $ sudo apt-get install imagemagick ghostscript ffmpeg poppler-utils libavcodec-extra-53

4. AtoM v2.1.2 설치
 ○ 다운로드 및 설치
 1) AtoM 다운로드 및 설치
    $ wget http://storage.accesstomemory.org/releases/atom-2.1.2.tar.gz
    $ sudo mkdir /var/www/atom
    $ sudo tar xzf atom-2.1.2.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;"

 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) 설치 완료


Tagged:

Comments

  • 웹브라우져로 http://localhost/atom 접속시 페이지를 찾을 수 없다는 메시지가 뜨는 경우 참고하시기 바랍니다.
    이 경우 http://localhost 주소로 접속하면 Apache 초기 인덱스 화면이 나타납니다.

    위의 증상은 Apache 웹서버가 atom 설치 디렉토리를 인식하지 못해서 발생하는 증상입니다.
    이를 위해선 Apache 웹서버가 atom 디렉토리를 인식할 수 있도록 설정만 해주면 됩니다.
    http://localhost 로 접속시 아파치 인덱스 화면이 나타나는 이유는 Apache 웹서버가 기본 웹 디렉토리로 /var/www/html 디렉토리 경로에 들어있는 index.html을 디폴트 인덱스 페이지로 인식하기 때문입니다.
    웹브라우져를 통한 AtoM 설치 화면이 나오려면 먼저 Apache 웹서버의 기본 웹 디렉토리를 변경해줘야 정상적으로 설치화면이 나오게 됩니다.
    설정  방법은 전혀 어렵지 않습니다.
    아래의 방법 그대로 따라하시면 간단하며 이후에 또 작업하실 필요가 없습니다.


    1. 우분투 Desktop 버젼 사용자의 경우 : ssh 터미널로 커맨트창(명령프롬프트창) 띄우기
        우분투 Server 버젼 사용자의 경우 : ssh 터미널 루트 관리자 로그인(su -)

    2. Apache 웹서버 의 사이트 디렉토리 설정 관련 파일 수정을 위해 nano 편집기로 불러오기
        sudo nano /etc/apache2/sites-available/000-default.conf 

    3. 설정 파일에서 DocumentRoot /var/www/html  라인 확인

    4. 이를 다음과 같이 수정하면 됩니다.
        DocumentRoot /var/www

    5. 수정이 되었으면 Ctrl키와 알파벳 O를 동시에 누르면 설정 파일이 저장됩니다.

    6. Apache 웹서버 재시작
        sudo /etc/init.d/apache2 restart

    7. 끝. 
        http://localhost/atom 주소로 접근해서 AtoM 설치화면이 나타나는지 확인
Sign In or Register to comment.