CKAN 패키지 설치 가이드 ( ubuntu 16.04 )

안녕하세요 씨앤텍 시스템즈 김준형입니다.

이번 포스트는 CKAN 설치 과정에 대해서 정리해 보았습니다. 

 

우분투는 16.04 버전을 기준으로 설치했습니다.

설치 매뉴얼은 https://docs.ckan.org/en/2.8/maintaining/installing/install-from-package.html를 참고했습니다.

 

먼저 CKAN 설치 과정은 3가지로 나눌 수 있습니다.

---

1. CKAN 패키지 설치

2. PostgreSQL 설치 및 구성

3. Solr 설치 및 구성

---

1.  CKAN 패키지 설치입니다.

  1-1. sudo -s 명령어로 root에 진입합니다.

  1-2. sudo apt-get update 명령어로 apt-get을 업데이트합니다.

  1-3. sudo apt-get install -y nginx apache2 libapache2-mod-wsgi libpq5 redis-server git-core 명령어로

         관련 모듈을 설치합니다.

 

              # 1-3 #  1-3 명령어 실행 시 그림과 같은 오류가 발생할 수 있습니다.

1-3 명령어 오류

              해결법 : systemctl stop apache2.service 명령어로 아파치를 멈추고 다시 명령어를 실행시켜 주세요.

      설치완료후 : systemctl start apache2.service 명령어로 아파치 다시 실행해 주세요.

 

1-4.wget http://packaging.ckan.org/python-ckan_2.8-xenial_amd64.deb명령어로 패키지를 다운로드합니다.

         # 1-4 #  페이지를 한글 번역하면 명령어가 wpack으로 바뀌는데 우분투는 wget 명령어로 다운로드하시면 됩니다.

 

1-5.  sudo dpkg -i python-ckan_2.8-xenial_amd64.deb 명령어로 설치를 실행합니다.

 

2. PostgreSQL 설치 및 구성

2-1. sudo apt-get install -y postgresql 명령어를 통해 postgre DB를 설치합니다.

2-2. sudo -u postgres psql -l 명령어로 설치가 됐는지 확인할 수 있습니다.

2-3. sudo -u postgres createuser -S -D -R -P ckan_default 명령어로 ckan_default라는 사용자를 만들고

        비밀번호를 설정합니다.

2-4. sudo -u postgres createdb -O ckan_default ckan_default -E utf-8 명령어로 ckan_default라는

        데이터베이스를 생성합니다.

 

2-5. vi /etc/ckan/default/production.ini 명령어로 설정창에 들어가서 sqlalchemy.url설정을 합니다.

       (파란색 부분에 설정한 비밀번호를 넣습니다.)  

sqlalchemy.url 설정

2-6. /etc/postgresql/9.5/main 경로에 있는 postgresql.conf 파일과 pg_hba.conf 파일을 편집합니다.

        (postgresql 버전에 따라 경로의 숫자가 차이가 있습니다.)

        (두 설정 다 상용화할 때는 설정을 달리 해야 보안에 안전합니다.)

 # 2-6 #  postgresql.conf, pg_hba.conf 파일이 비어 있다면 sudo로 접속해서 편집해 주세요.

 

postgresql.conf 설정

pg_hba.conf 설정

3. Solr 설치 및 구성

3-1. sudo apt-get install -y solr-jetty 명령어로 solr를 설치합니다.

---

#3-1# 설치에 오류 날 시

1. jetty8이 실행되고 있는지 확인 systemctl status jetty8.service

2. jetty8의 포트가 8983으로 잘 바꿨고 겹치지 않는지 확인

3. java가 설치되어 있는지 확인

---

 

3-2. vi /etc/default/jetty8 명령어를 이용해 밑에 그림처럼 설정합니다.

        (이 설정을 먼저 해야 3-1의 solr-jetty가 정상적으로 설치가 완료될 때가 있습니다.)

jetty8의 환경설정

 

3-3. vi /etc/ckan/default/production.ini 명령어를 통해 solr_url 부분을 편집합니다.

        ( ip부분엔 우분투 서버의 ip를 지정합니다.)

 

solr_url 설정

3-4. sudo service jetty8 restart 명령어로 jetty를 재시작합니다.

3-5. http://localhost:8983/solr/ 를 들어가면 solr의 메인화면을 볼 수 있습니다.

 

solr 메인화면

3-6. 

1. sudo mv /etc/solr/conf/schema.xml /etc/solr/conf/schema.xml.bak 

2. sudo ln -s /usr/lib/ckan/default/src/ckan/ckan/config/solr/schema.xml /etc/solr/conf/schema.xml 

    명령어를 통해 심볼릭 링크로 바꿉니다.

 

3-7. sudo service jetty8 restart 명령어를 통해 jetty를 재시작합니다.

 

4. 마무리

   4-1. vi /etc/ckan/default/production.ini 명령어를 통해 그림과 같이 ckan.site_url을 설정합니다.

          (우분투 서버의 ip를 입력해 주세요)

ckan.site_url 설정

4-2. sudo ckan db init 명령어로 Ckan설정 파일을 적용시킵니다.

 

---

# VDM only works with SQLAlchemy versions 0.4 through 0.8, not: 1.0.14  오류 시#

pip install -r /usr/lib/ckan/default/src/ckan/requirements.txt 명령어를 실행시키면 해결 가능합니다.

---

4-3. sudo service apache2 restart 명령어로 아파치를 재실행합니다.

4-4. sudo service nginx restart 명령어로 nginx를 재실행합니다.

4-5. http://localhost로 접속합니다. 

 

감사합니다.