Archivematica 설치 매뉴얼

edited February 2014 in Archivematica
○ 시스템 요구사항(소프트웨어)
리눅스 Ubuntu OS v12.04, Apache, MySQL, PHP



○ Archivematica v1.0 설치전 기본 필수 응용프로그램 설치
1) MySQL 설치(이미 설치된 경우는 또 설치할 필요 없음)
$ sudo apt-get install mysql-server-5.5 

2) JAVA 구동 환경 설치(JDK7)
$ sudo apt-get install -y openjdk-7-jre-headless

3) Elasticsearch 검색엔진 설치
$ sudo dpkg -i elasticsearch-0.90.7.deb
$ sudo rm elasticsearch-0.90.7.deb
$ sudo /etc/init.d/elasticsearch start

4) Apache 설치(이미 설치된 경우는 또 설치할 필요 없음)
$ sudo apt-get install apache2

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



○ Archivematica v1.0 설치
1) 리눅스 Ubuntu OS 패키지 저장소(Repository) 리스트 업데이트 패키지 저장소 리스트 읽기
$ sudo vi /etc/apt/sources.list
패키지 저장소 리스트에 archivematica 패키지 저장소 URL 추가
(sources.list 하단에 아래의 코드 입력 후 저장)

2) GPG Key 추가(GPG 관련 레퍼런스는 gnupg.org 참조)

3) 패키지 저장소 리스트 업데이트
$ sudo aptitude update 또는 $ sudo apt-get update

4) MCP Server 설치 및 셋팅
$ sudo aptitude install archivematica-mcp-server

설치 중 dbconfig 환경 설정 화면이 나타나면 사용중인 Mysql DBMS의 구성 정보를 입력하고 archivematica 사용자 아이디(archivematica), 사용할 데이터베이스명(mcp)을 입력하고 넘어감
이 과정을 통해서 /etc/dbconfig-common 디렉토리에 archivematica 의 데이터베이스 환경 설정 파일이 생성됨
만약 완료 후 Mysql 데이터베이스 목록에 MCP 데이터베이스 및 테이블이 생성되어 있지 않으면 설치가 된 것이 아니므로 이 경우 아래의 명령어로 데이터베이스 환경설정을 다시 해야 함
$ sudo dpkg-reconfigure archivematica-mcp-server

5) Dashboard 설치 및 셋팅
$ sudo aptitude install archivematica-dashboard
Archivematica 사이트에 외부 사용자의 외부 아이피 접속시 액세스 허용을 위해 dashboard 환경설정 파일을 수정해야 함
$ sudo vi /usr/share/archivematica/dashboard/settings/common.py

ALLOWED_HOSTS = (‘localhost’)에서 localhost를 *로 변경해주면 외부의 어떤 아이피로도 archivematica 사이트 접속이 가능함
변경후 : ALLOWED_HOST - (‘*’) 

6) Apache 가상호스트 설정 파일에 archivematica 관련 구문 추가
# Serve static files from Dashboard
Alias /media "/usr/share/archivematica/dashboard/media/"

Order allow,deny
Allow from all

# Django with mod_wsgi
WSGIScriptAlias / /usr/share/archivematica/dashboard/apache/django.wsgi
WSGIDaemonProcess dashboard user=archivematica group=archivematica
WSGIProcessGroup dashboard

Order allow,deny
Allow from all

7) Apache 서비스 재시작
$ sudo /etc/init.d/apache2 restart 

8) archivematica 사용자의 mysql 서버 원격 접근을 위한 데이터베이스 환경 설정 
$ mysql -u root –p디비관리자패스워드 —execute="update mysql.user set host='%' where user='사용자아이디';“

9) archivematica 사용자의 mysql 서버 원격 접근을 위한 데이터베이스 환경 설정 
$ mysql -u root –p디비관리자패스워드 —execute="GRANT SELECT, UPDATE, INSERT ON MCP.* TO '사용자아이디'@'%'" 
이후 부터는 외부에서 해당 사용자아이디로 archivematica의 MCP Server 데이터베이스에 접속하여 Select, Update, Insert SQL 명령문으로 데이터베이스 Table 관리가 가능해짐

10) Archivematica MCP 서버의 클라이언트용 프로그램 설치 및 셋팅 
FFmpeg(멀티미디어 데이터 처리용 프로그램) 설치(FFmpeg 관련 레퍼런스는 http://en.wikipedia.org/wiki/FFmpeg 참조)
$ sudo aptitude install libavcodec-extra-53 libav-tools ffmpeg

archivematica-mcp-client 설치
$ sudo aptitude install archivematica-mcp-client

archivematica DB 환경 설정 변경 필요시 설정 파일 수정
$ sudo vi /etc/archivematica/archivematicaCommon/dbsettings
클라이언트 프로그램을 동일 서버가 아닌 다른 서버에 설치하는 경우에는 ‘localhost’를 ‘해당 서버 아이피’로 변경해야 함

transcoder DB 환경 설정 변경 필요시 설정 파일 수정
$ sudo vi /etc/archivematica/transcoder/dbsettings

(Transcoder는 동영상 파일 인코딩 처리용 프로그램으로 관련 레퍼런스는 http://en.wikipedia.org/wiki/Transcoding를 참조)
마찬가지로 transcoder 및 dashboard를 동일 서버가 아닌 다른 서버에 설치하는 경우‘localhost’를 ‘해당 서버 아이피’로 변경
$ sudo vi /usr/share/archivematica/dashboard/settings/common.py

MCPClient의 클라이언트 환경 설정 변경 필요시 설정 파일 수정
$ sudo nano /etc/archivematica/MCPClient/clientConfig.conf

마찬가지로 다른 서버에 클라이언트 설치시 ‘localhost’를 ‘해당 서버 아이피‘로 변경
클라이언트의 Time Zone 설정도 변경 가능

11) 클라이언트 프로그램 서비스 실행(시작 및 종료) 테스트
$ sudo start archivematica-mcp-client
$ sudo stop archivematica-mcp-client

12) Python 객체지향프로그래밍언어 설치(Python 관련 레퍼런스는 
$ sudo aptitude install python-setuptools

13) Gearman 어플리케이션 프레임워크 설치(Gearman 관련 레퍼런스는 http://gearman.org/ 또는 http://en.wikipedia.org/wiki/Gearman참조)
$ sudo easy_install gearman

14) Archivematica MCP Server 데이터베이스에 Archivematica 사용 조직 및 기관명 설정
$ sudo mysql -u root --execute "UPDATE Agents SET agentIdentifierValue='조직/기관명 식별자', agentName='조직/기관명' WHERE PK = 2;" MCP

15) Archivematica MCP Server 데이터베이스 유지보수를 위한 자동 백업 설정
자동백업 관련 설정 파일 읽기
$ sudo vi /etc/default/automysqlbackup

백업할 데이터베이스 설정 정보 변경
USERNAME=사용자명
PASSWORD=패스워드
DBNAMES="MCP"

백업될 디렉토리 설정
BACKUPDIR="/var/lib/automysqlbackup"

만약 automysqlbackup이 설치되어 있지 않은 경우 설치후 설정
$ sudo aptitude install automysqlbackup 

16) 서비스 정지 및 재시작 테스트
서비스 정지 명령
$ sudo stop archivematica-mcp-server
$ sudo stop archivematica-mcp-client
$ sudo /etc/init.d/apache2 stop
$ sudo /etc/init.d/gearman-job-server stop
$ sudo stop mysql
$ sudo /etc/init.d/elasticsearch stop

서비스 시작 명령
$ sudo /etc/init.d/elasticsearch start
$ sudo start mysql
$ sudo /etc/init.d/gearman-job-server start
$ sudo /etc/init.d/apache2 start
$ sudo start archivematica-mcp-server
$ sudo start archivematica-mcp-client

17) Archivematica 웹 인스톨러 실행
웹브라우져를 열고 http://서버주소 접근 후 각종 환경 설정

18) 설치 완료



○ Archivematica와 AtoM의 보안채널통신을 위한 환경 설정 

1) Archivematica 서버 SSH 터널링 관련 환경 설정
archivematica 사용자의 SSH Key(개인키 및 공개키) 생성
$ sudo –u archivematica ssh-keygen –t dsa

개인키 및 공개키의 저장 위치는 archivematica의 홈 디렉토리인
/var/lib/archivematica/.ssh/ 이며 .ssh 디렉토리 밑에 id_dsa라는 개인키가 생성되고 id_dsa.pub라는 공개키가 생성됨

2) AtoM 서버 SSH 터널링 관련 환경 설정
Rsync를 통한 ssh 접속용 소프트웨어인 rssh 설치
$ sudo apt-get install rssh

archivematica 사용자 추가 및 사용자 디렉토리 생성 설정
$ sudo useradd -d /home/archivematica -m –s /usr/bin/rssh archivematica

archivematica 사용자의 암호 해제
$ sudo passswd –l archivematica

Rsync 서비스 허용을 위해 rssh.conf 에서 allowsync 주석(#) 해제
$ sudo vi /etc/rssh.conf 

Archivematica 서버의 공개키 복사를 위한 디렉토리 생성
$ sudo mkdir /home/archivematica/.ssh

디렉토리 접근권한 설정
$ chmod 700 /home/archivematica/.ssh/

authorized_keys 파일을 신규 생성한 후 Archivematica 서버의 id_dsa.pub(공개키) 내용을 복사해서 authorized_keys에 그대로 붙임
$ sudo vi /home/archivematica/.ssh/authorized_keys

디렉토리 사용자 권한 설정
$ chown -R archivematica:archivematica /home/archivematica

3) Archivematica 사이트 관리자 페이지에서 Administration >
Upload DIP 페이지로 들어간 후 rsync를 통한 SSH 터널링 연결 정보 설정
--email="사용자아이디@도메인주소" \
--password="암호" \
--uuid="%SIPUUID%" \
--rsync-target="archivematica@도메인주소:/tmp" \
--debug

4) AtoM 사이트 관리자 페이지에서 Admin > Plugins 페이지로 들어간 후 qtSwordPlugin(SWORD plugin) 옵션 체크(활성화)하고, Admin > Settings 페이지로 들어간 후 Job scheduling 설정에서
Enable job scheduler를 No에서 Yes로 변경후 저장

5) 설정 완료



○ 참고사항
1) Archivematica는 프로그램 버전이 업데이트 되었을 때 AtoM과는 달리 업그레이드를 지원하지 않으므로 신규 버전 업데이트를 위해서는 재설치(Reinstall)가 필요함.

2) Archivematica와 AtoM 설치시 가급적 각각의 서버에 설치하는 것을 권장함. 이 두 가지 소프트웨어를 한 서버에 설치하는 경우 서비스 구동은 가능하나 Archivematica에서 AtoM으로 DIP를 업로드할 때 SSH 터널을 통한 보안 채널 연결이 불가능하여 DIP 업로드 에러가 발생될 수 있음. DIP 업로드시에는 서버간에 SSH(Secure Shell) 터미
널을 통해 Rsync 명령어로 파일 전송이 이뤄져야 하는데 SSH 접속시 서버간 개인키(Private Key) 및 공개키(Public Key)를 비교해서 정보가 일치하는 경우에만 서버간 터널링 접속이 가능하므로 당연히 한 서버에서는 이러한 설정이 불가능하게 되어 에러가 발생될 수 밖에 없음. 

Comments

Sign In or Register to comment.