Ubuntu에서 OpenKM으로 문서 관리 Server 구성하기 (Part 2) Linux/Open tools 2012. 6. 4. 17:14

Part1에 이어서 이번 Post에서는 OpenKM의 기능을 확장시켜주는 Third-party Tool과 Backup 등에 대해서 알아보도록 하겠습니다.

6. Third-party Tool 설정

대부분의 Open-source Solution이 그렇듯이 OpenKM도 여러 Open-source Tool과 함께 사용하면 기능이 더 확장되고 유용해집니다. 이번 항목에서는 Third-party Tool을 설치하고 OpenKM에서 사용할 수 있도록 설정하는 방법을 설명합니다.

6.1. PDF Preview

OpenKM의 Web Interface에서 PDF 문서를 미리보기할 수 있습니다. (미리보기를 위해서는 Browser에 Flash Plugin이 설치되어 있어야 합니다.)

먼저 PDF를 SWF로 변환하기 위해서 SWFTools를 설치해야 합니다. Ubuntu의 Repository에서 기본적으로 제공하지 않기 때문에 PPA에서 Build한 DEB Package로 설치해 봅시다.

Pacakge를 Download하기 위해서 Terminal에서 다음과 같이 입력합니다.

  • 32bit:
    1
    $ wget "https://launchpad.net/~ella-animation/+archive/dev/+files/swftools_0.9.1-0maverick2_i386.deb"
  • 64bit:
    1
    $ wget "https://launchpad.net/~ella-animation/+archive/dev/+files/swftools_0.9.1-0maverick2_amd64.deb"

Download한 Package를 설치하기 위해 다음과 같이 입력합니다.

1
2
$ apt-get install libjpeg62
$ sudo dpkg -i swftools*.deb
OpenKM - Configuration

OpenKM - Configuration

그 다음, OpenKM에 okmAdmin으로 접속한 후 Administration Tab에서 Configuration을 Click합니다.

여러가지 설정변수 중 system.swftools.pdf2swf를 찾아서 값을 편집하기 위해 연필 Icon을 Click합니다.

OpenKM - system.swftools.pdf2swf

OpenKM - system.swftools.pdf2swf

Value에 다음과 같은 값을 입력하고 Send를 눌러 저장합니다.

1
/usr/bin/pdf2swf -T 9 -f ${fileIn} -o ${fileOut}

마지막으로 OpenKM을 다시 시작하기 위해서 Terminal에서 다음과 같이 입력합니다.

1
$ sudo service jbossokm restart
OpenKM - PDF Preview

OpenKM - PDF Preview

다시 시작된 OpenKM에 접속해서 PDF문서를 Click한 다음, 아래의 Preview Tab을 Click하면 위의 그림과 같이 PDF문서의 내용을 확인할 수 있습니다.

6.2. Image Preview

OpenKM에 Image(gif, png, jpg, etc.)를 Upload할 경우, Image 또한 Preview를 통해서 미리보기가 가능합니다.

Image Preview를 위해서는 Image Format 변환을 위해 ImageMagick을 설치해야 합니다. 설치를 위해서 Terminal에서 다음과 같이 입력합니다.

1
$ sudo apt-get install imagemagick
OpenKM - Configuration

OpenKM - Configuration

OpenKM에서 okmAdmin으로 접속한 다음, Administration의 Configuration에서 system.imagemagick.convert 환경변수를 변경하기 위해 연필 Icon을 Click합니다.

OpenKM - system.imagemagick.convert

OpenKM - system.imagemagick.convert

Value에 다음과 같은 값을 입력하고 Send를 누릅니다.

1
/usr/bin/convert

변경된 설정을 OpenKM에 적용하기 위해 다음과 같이 입력하여 OpenKM을 다시 시작합니다.

1
$ sudo service jbossokm restart
OpenKM - Image Preview

OpenKM - Image Preview

다시 시작된 OpenKM에 접속하여 Image File을 Upload한 다음, Preview를 누르면 위의 그림과 같이 Image가 표시되는 것을 확인할 수 있습니다.

6.3. Tesseract OCR

OCR은 Image에서 Text를 추출하는 Program입니다. OpenKM에서는 Open-source OCR Program을 이용하여 검색 시에 Image(tif, png, jpg, gif) 내에 포함되어 있는 Text까지 검색하여 결과를 표시합니다.

OpenKM은 Open-source OCR 중 Tesseract와 Cuneiform을 지원하지만 여기서는 인식률이 좀 더 나은 Tesseract를 사용하는 방법에 대해서 설명합니다.

Tesseract는 Ubuntu repository에 포함되어 있습니다. 하지만 최신의 Tesseract를 사용하려면 PPA를 이용해야 합니다. 다음과 같이 입력하여 Tesseract를 설치합니다.

1
2
$ sudo add-apt-repository ppa:gezakovacs/tesseract
$ sudo apt-get update && sudo apt-get install tesseract-ocr tesseract-ocr-eng

Tesseract는 기본적으로 영문 Text를 추출할 수 있습니다. 만약, Image 내의 한글을 추출하기 원한다면 다음과 같이 입력하여 한국어 Language Data를 설치합니다.

1
2
3
$ cd /usr/share/tesseract-ocr/tessdata
$ sudo wget "http://tesseract-ocr.googlecode.com/files/kor.traineddata.gz"
$ sudo gunzip kor.traineddata.gz
OpenKM - Configuration

OpenKM - Configuration

OpenKM에서 okmAdmin으로 접속한 다음, Administration의 Configuration에서 system.ocr을 찾아서 옆의 연필 Icon을 Click합니다.

OpenKM - system.ocr

OpenKM - system.ocr

Value에 다음 중 하나를 선택하여 입력하고 Send를 누릅니다. 여기서 유의할 점은 한국어로 설정한 경우 영문이 포함된 Image에서는 제대로 영문을 추출할 수 없다는 것입니다. 영어로 설정한 경우에는 당연히 한글을 추출할 수 없겠죠. :(

  • 영어:
    1
    /usr/bin/tesseract ${fileIn} ${fileOut}
  • 한국어:
    1
    /usr/bin/tesseract ${fileIn} ${fileOut} -l kor

설정을 저장한 후, 다음과 같이 입력하여 OpenKM을 종료합니다.

1
$ sudo service jbossokm stop

OpenKM에서 검색을 위한 Data를 만들 때, OCR을 사용하도록 설정하기 위해 다음과 같이 입력하여 설정파일을 편집기로 엽니다.

1
$ sudo vi /opt/jboss*/repository.xml

내용 중에서 textFilterClasses를 검색한 다음, value를 다음과 같이 변경하고 저장합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<param name="textFilterClasses" value="
org.apache.jackrabbit.extractor.PlainTextExtractor,
org.apache.jackrabbit.extractor.MsWordTextExtractor,
org.apache.jackrabbit.extractor.MsExcelTextExtractor,
org.apache.jackrabbit.extractor.MsPowerPointTextExtractor,
org.apache.jackrabbit.extractor.OpenOfficeTextExtractor,
org.apache.jackrabbit.extractor.RTFTextExtractor,
org.apache.jackrabbit.extractor.HTMLTextExtractor,
org.apache.jackrabbit.extractor.XMLTextExtractor,
org.apache.jackrabbit.extractor.PngTextExtractor,
org.apache.jackrabbit.extractor.MsOutlookTextExtractor,
com.openkm.extractor.PdfTextExtractor,
com.openkm.extractor.AudioTextExtractor,
com.openkm.extractor.ExifTextExtractor,
com.openkm.extractor.Tesseract3TextExtractor,
com.openkm.extractor.SourceCodeTextExtractor,
com.openkm.extractor.MsOffice2007TextExtractor"/>

그리고 다음과 같이 입력하여 또 다른 설정 파일을 편집기로 엽니다.

1
$ sudo vi /opt/jboss*/repository/workspaces/default/workspace.xml

여기서도 마찬가지로 textFilterClasses를 검색하여 value를 다음과 같이 변경하고 저장합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<param name="textFilterClasses" value="
org.apache.jackrabbit.extractor.PlainTextExtractor,
org.apache.jackrabbit.extractor.MsWordTextExtractor,
org.apache.jackrabbit.extractor.MsExcelTextExtractor,
org.apache.jackrabbit.extractor.MsPowerPointTextExtractor,
org.apache.jackrabbit.extractor.OpenOfficeTextExtractor,
org.apache.jackrabbit.extractor.RTFTextExtractor,
org.apache.jackrabbit.extractor.HTMLTextExtractor,
org.apache.jackrabbit.extractor.XMLTextExtractor,
org.apache.jackrabbit.extractor.PngTextExtractor,
org.apache.jackrabbit.extractor.MsOutlookTextExtractor,
com.openkm.extractor.PdfTextExtractor,
com.openkm.extractor.AudioTextExtractor,
com.openkm.extractor.ExifTextExtractor,
com.openkm.extractor.Tesseract3TextExtractor,
com.openkm.extractor.SourceCodeTextExtractor,
com.openkm.extractor.MsOffice2007TextExtractor"/>

마지막으로 설정을 적용하기 위해서 OpenKM을 시작합니다.

1
$ sudo service jbossokm start
OpenKM - OCR Test

OpenKM - OCR Test

Test하는 방법은 간단합니다. 위의 그림에서와 같이 Text가 들어가 있는 Image를 OpenKM에 Upalod합니다. Image를 Upload할 때, Tesseract가 내부적으로 실행되면서 추출한 내용을 검색 Data에 저장합니다.

OpenKM - Search Result

OpenKM - Search Result

Search Tab에서 Content에 Image 안의 단어 중 하나를 넣어서 검색했을 때, 아래의 검색결과에 해당 Image가 표시된다면 제대로 설정이 된 것입니다.

6.4. OpenOffice.org Integration

Ubuntu Precise Pangolin 12.04에서는 LibreOffice 3.5.3.2를 이용하여 미리보기를 표시할 수 없습니다. OpenKM에 포함되어있는 JODConverter와 LibreOffice간에 통신에 제대로 이루어지지 않는 것 같네요. 아직까지는 해결할 수 있는 방법이 없는 것 같습니다. (soffice.bin이 headless로 실행되다가 갑자기 종료됨)

server.log는 다음과 같습니다.

1
2
3
4
5
6
7
8
2012-05-22 16:37:00,938 INFO  [org.artofsolving.jodconverter.office.OfficeProcess] starting process with acceptString 'socket,host=127.0.0.1,port=2002,tcpNoDelay=1' and profileDir '/tmp/.jodconverter_socket_host-127.0.0.1_port-2002'
2012-05-22 16:37:01,078 INFO  [org.artofsolving.jodconverter.office.OfficeProcess] started process
2012-05-22 16:37:31,261 WARN  [com.openkm.servlet.RepositoryStartupServlet] failed to start and connect
org.artofsolving.jodconverter.office.OfficeException: failed to start and connect
        at org.artofsolving.jodconverter.office.ManagedOfficeProcess.startAndWait(ManagedOfficeProcess.java:61)
        at org.artofsolving.jodconverter.office.PooledOfficeManager.start(PooledOfficeManager.java:102)
        at org.artofsolving.jodconverter.office.ProcessPoolOfficeManager.start(ProcessPoolOfficeManager.java:59)
        at com.openkm.util.DocConverter.start(DocConverter.java:164)

OpenKM에서는 Office Format(docx, doc, xlsx, xls, pptx, ppt, odt, etc.)의 File을 미리보기 할 수 있습니다. (미리보기를 위해서는 먼저 6.1의 SWFTools를 설치해야 합니다.)

미리보기를 위해서 OpenKM은 OpenOffice.org를 사용합니다. 때문에 MS Office 관련 Format을 미리보기 할 경우, OpenOffice.org에서 해당 문서를 연 모습과 같이 표시되기 때문에 Layout이나 Font가 기존의 문서와 조금 다를 수 있습니다.

기본적으로 Ubuntu에서는 OpenOffice.org의 Fork인 Libre Office가 설치되어 있는데 다음과 같이 입력하여 OpenOffice.org를 설치합니다.

1
$ sudo apt-get install openoffice.org

OpenOffice.org Package를 설치한다고 해도, 실제적으로 새로 OpenOffice.org가 설치되는 것은 아닙니다. Libre Office가 OpenOffice.org의 역할을 대신할 수 있도록 필요한 몇 가지 Package만 설치하게 됩니다.

OpenKM - Configuration

OpenKM - Configuration

OpenKM에서 okmAdmin으로 접속한 다음, Administration의 Configuration에서 system.openoffice.path를 찾아 옆의 연필 Icon을 Click합니다.

OpenKM - system.openoffice.path

OpenKM - system.openoffice.path

Value에 다음과 같이 입력하고 Send를 눌러 저장합니다.

1
/usr/lib/libreoffice

저장한 설정을 OpenKM에 적용하기 위해서 다음과 같이 입력합니다.

1
$ sudo service jbossokm restart
OpenKM - PPT Preview

OpenKM - PPT Preview

설정이 적용된 OpenKM에서 Office Format의 문서를 Upload한 다음, Preview를 Click하면 위의 그림과 같이 해당 문서의 내용을 확인할 수 있습니다.

6.5. Anitivirus

Antivirus Program을 OpenKM에서 사용하도록 설정하면, Upload하는 문서가 Virus에 감염되어 있을 경우, 해당 문서를 Repository에 등록하지 않고 사용자에게 해당 문서가 문제가 있다는 것을 알려줍니다.

OpenKM은 Antivirus Program으로 Open-source인 ClamAV를 지원합니다. 설치를 위해서 다음과 같이 Terminal에서 입력합니다.

1
2
$ sudo apt-get install clamav      
$ sudo freshclam
OpenKM - Configuration

OpenKM - Configuration

OpenKM에서 okmAdmin으로 접속한 후, Administration의 Configuration에서 system.antivir을 찾아 옆의 연필 Icon을 Click합니다.

OpenKM - system.antivir

OpenKM - system.antivir

Value에 다음과 같이 입력하고 Send를 눌러 저장합니다.

1
/usr/bin/clamscan

설정을 적용하기 위해서 다음과 같이 입력하여 OpenKM을 다시 시작합니다.

1
$ sudo service jbossokm restart
OpenKM - Virus Detected

OpenKM - Virus Detected

위의 그림은 실제 사용하다가 문서 내의 Virus를 감지한 모습입니다. ZIP으로 문서를 묶어서 Upload한 경우에도 Virus를 검색하여 문제가 있는 File을 걸러내어주니 제법 유용합니다.

7. WebDAV 설정

WebDAV는 HTTP를 통해서 Server 내의 문서를 편집하거나 관리하는 방법을 표준으로 정한 Protocol입니다.

OpenKM에서는 WebDAV를 지원하여 WebDAV Client를 통해서 마치 File System에 있는 것처럼 Repoisitory의 문서를 편하게 열람하고 관리할 수 있습니다.

이번 항목에서는 OpenKM에서 WebDAV를 사용할 수 있도록 설정하는 방법과 Linux, Windows에서 WebDAV Client를 사용하여 접속하는 방법을 설명합니다.

7.1. OpenKM 설정

먼저 OpenKM에서 WebDAV를 지원하도록 설정하는 방법에 대해서 알아봅시다.

OpenKM - Configuration

OpenKM - Configuration

OpenKM Web Interface에서 okmAdmin으로 접속한 다음, Administration의 Configuration에서 system.webdav.server, system.webdav.fix 설정변수를 편집(연필 Icon Click)합니다.

OpenKM - system.webdav.server

OpenKM - system.webdav.server

system.webdav.server 환경변수의 Value를 Check한 다음, Send를 누르면 OpenKM이 WebDAV Protocol을 지원하게 됩니다.

OpenKM - system.webdav.fix

OpenKM - system.webdav.fix

system.webdav.fix 환경변수를 설정하면, Taxonomy의 Root인 okm:root의 ‘:’을 Windows에서는 Folder명으로 사용할 수 없기 때문에 대신 okm_root로 변경해 줍니다.

Windows에서 접속하여 사용할 것이라면 Value에 Check하고 Send를 눌러 저장합니다.

7.2. Linux에서 WebDAV를 통하여 OpenKM에 접근하는 방법

Linux에서 davfs2를 설치하면 WebDAV를 통하여 OpenKM의 Repository에 접근해서 File System처럼 문서를 열람하고 관리할 수 있습니다.

Ubuntu의 경우, 설치를 위해서 Terminal에서 다음과 같이 입력합니다.

1
2
$ sudo apt-get install davfs2
$ sudo dpkg-reconfigure davfs2
davfs2 Configuration

davfs2 Configuration

설치 시, davfs2를 이용하여 Root 계정이 아닌 일반 계정에서도 Mount하여 사용할 수 있도록 설정할 지 여부를 묻는 창이 위의 그림과 같이 나온다면 예를 선택하고 Enter를 누릅니다.

설치가 완료된 다음, davfs2를 사용할 User를 설정하고 Mount Point를 설정하기 위해 아래와 같이 입력합니다. (User가 foo인 경우)

1
2
$ sudo usermod -a -G davfs2 foo
$ sudo mkdir /home/foo/.media/okmdav -p

그리고 Mount Point에 대한 정보를 저장하기 위해서 /etc/fstab을 아래와 같이 편집하여 저장합니다. (OpenKM의 접속 URL이 http://www.example.com/OpenKM일 경우)

1
2
3
4
$ sudo vi /etc/fstab

# OpenKM WebDAV
http://www.example.com/OpenKM/webdav /home/foo/.media/okmdav davfs rw,user,noauto 0 0

이제 Mount가 제대로 이루어지는지 Test해 봅시다. 아래와 같이 입력합니다.

1
2
3
4
5
6
7
8
9
10
$ mount ~/.media/okmdav
Please enter the username to authenticate with server
http://www.example.com/OpenKM/webdav or hit enter for none.
  Username:
Please enter the password to authenticate user ioriy2k with server
http://www.example.com/OpenKM/webdav or hit enter for none.
  Password:  

$ ls ~/.media/okmdav
lost+found  okm_mail  okm_personal  okm_root  okm_templates

Username과 Password에는 OpenKM에 접속할 ID와 Password를 입력하면 됩니다.

Mount된 Directory에는 위와 같이 여러 Folder가 존재하는데 Taxonomy에 등록된 문서는 모두 okm_root 안에 위치합니다.

제대로 Mount가 되었다면, Mount 시의 번거로움을 줄이기 위해 OpenKM에 접속할 ID와 Password 정보를 저장해 봅시다. 다음과 같이 입력합니다. (OpenKM의 URL이 http://www.example.com/OpenKM, ID가 foo, Password가 bar인 경우의 예)

1
2
3
4
$ vi ~/.davfs2/secrets

# OpenKM
http://www.example.com/OpenKM/webdav    foo    "bar"

Mount Point에 편리하게 접근하고 싶다면, 다음과 같이 입력하여 Symbolic Link를 만들면 됩니다.

1
$ ln -sf ~/.media/okmdav/okm_root ~/문서/OpenKM
7.2.1. Login 시에 Mount하는 방법

OpenKM을 WebDAV를 통하여 Mount할 경우 Network 연결을 이용한 Mount의 특성 상 System 시작 시에 자동으로 Mount하지 않습니다.

하지만 편리하게 사용하기 위해서 Desktop 환경에 Login 시에 자동으로 Mount할 수 있도록 설정할 수 있습니다. 먼저 다음과 같이 입력하여 Mount를 위한 Script를 만듭니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
$ mkdir ~/.local/bin -p
$ vi ~/.local/bin/mount.okm

#!/bin/bash
 
grep okmdav /proc/mounts > /dev/null
 
if [ $? == 0 ]; then
    umount ~/.media/okmdav/
fi

mount ~/.media/okmdav/

$ chmod 755 ~/.local/bin/mount.okm

작성한 Script를 시작 Program에 등록하기 위해 아래와 같이 입력합니다.

1
$ gnome-session-properties
Startup Applications

Startup Applications

시작 프로그램 기본 설정에서 추가 Button을 누르면 위의 그림과 같이 입력 창이 표시됩니다. 다음과 같이 입력하고 확인을 눌러 저장한 후, Logout, Login하면 OpenKM이 자동으로 Mount됩니다. (User가 foo인 경우)

  • 이름: OpenKM WebDAV
  • 명령: /home/foo/.local/bin/mount.okm

7.3. Windows에서 WebDAV를 통하여 OpenKM에 접근하는 방법

Windows에서도 WebDAV를 통하여 OpenKM에 접근할 수 있습니다. Linux에서와 마찬가지로 File System 처럼 Mount하기 때문에 탐색기에서 문서를 편리하게 관리할 수 있습니다.

WIndows에서 기본적으로 제공하는 WebDAV Protocol 연결은 문제가 있기 때문에 상용 WebDAV Client인 WebDrive를 사용하여 연결해 봅시다. WebDrive는 여기서 Trial을 받아 설치할 수 있습니다.

Start Menu - WebDrive

Start Menu - WebDrive

WebDrive를 설치했다면 WebDrive -> WebDrive를 Click하여 실행합니다.

WebDrive - Program Settings

WebDrive - Program Settings

먼저 설정을 변경하기 위해 File -> Program Settings를 Click합니다.

WebDrive - General Settings

WebDrive - General Settings

MS Office 문서를 편집할 때의 Performance를 높이기 위해서 General Settings의 Disable DFS (improves performance of MS Office)를 Check하고 OK를 누릅니다.

WebDrive - New Site

WebDrive - New Site

이제 OpenKM Site를 등록하기 위해서 New Site Button을 Click합니다.

WebDrive - Site Wizard

WebDrive - Site Wizard

Site Wizard에서 Connect by Server Type (SFTP, WebDAV, FTP, etc.)를 선택하고 다음을 누릅니다.

Site Wizard - Server Type

Site Wizard - Server Type

Server type을 WebDAV로 선택하고 다음을 누릅니다. 만약 OpenKM Server가 HTTPS를 지원한다면 Connect Securely를 Check합니다.

Site Wizard - Server URL

Site Wizard - Server URL

Enter the URL for the Server에 OpenKM의 WebDAV 접속 URL을 입력하고 다음을 누릅니다. 예를 들어 OpenKM의 접속 URL이 “http://www.example.com/OpenKM”이라면 WebDAV 접속 URL은 “http://www.example.com/OpenKM/webdav/okm_root”가 됩니다.

Site Wizard - Account Information

Site Wizard - Account Information

Username과 Password에 OpenKM에 접속하기 위한 ID와 Password를 입력합니다. 그리고 제대로 연결이 되는지 확인하기 위해서 Test Connection을 누릅니다.

Site Wizard - Test Connection

Site Wizard - Test Connection

Test Connection으로 확인하여 제대로 연결되었다면 위와 같은 Message를 표시할 것입니다. Close를 눌러 Test를 종료합니다.

Site Wizard - Site Name

Site Wizard - Site Name

그 다음 WebDAV 접속에 대한 이름을 입력하고 Drive를 설정한 후, 다음을 누릅니다.

Site Wizard - Finish

Site Wizard - Finish

마지막으로 Windows Login이나 시작 시에 자동으로 Mount되도록 설정하려면 Connect at login/startup을 Check합니다. 그리고 마침을 누릅니다.

WebDrive - Properties

WebDrive - Properties

Site 등록이 완료되었으면, OpenKM을 위한 설정을 위해서 Properties를 Click합니다.

WebDrive - Properties (File)

WebDrive - Properties (File)

Site Properties의 File에서 다음과 같은 항목의 설정을 변경하고 OK를 누릅니다.

  • Encode filenames in UTF-8, Cache temporary MS Office files를 Check
  • Enable Quota Processing의 Check를 해제
WebDrive - Connect

WebDrive - Connect

설정이 모두 완료되었으니 이제 Mount해 봅시다. Connect Button을 Click합니다.

Explorer - Connected

Explorer - Connected

제대로 Mount 되었다면 위의 그림과 같이 탐색기로 OpenKM의 Repository를 접근할 수 있게 됩니다.

8. Backup & Migration

이번 항목에서는 마지막으로 OpenKM을 Backup하는 방법과 새로운 Version이 나왔을 때 Migration하는 방법을 간단하게 설명합니다.

8.1. Backup/Restore

OpenKM은 Solution으로 되어 있기 때문에 필요한 것만 골라서 Backup하기가 용이하지 않습니다.

okmAdmin으로 접속할 경우, Administration에서 Export/Import를 지원하지만 문서에 대한 Metadata 정보를 제대로 가져오지 못하기 때문에 문서만 Backup하는 경우 외에는 거의 의미가 없습니다.

가장 간단하고 편리하게 전체를 Backup하는 방법은 압축하여 보관하는 방법입니다. 예를 들어 Backup 명령을 실행해 본다면 다음과 같습니다. (/backup/openkm에 Backup하는 경우)

1
2
$ cd /opt
$ sudo tar cvzf /backup/openkm/openkm-`date +%Y-%m-%d`.tar.gz jboss*

Backup한 OpenKM 압축을 Restore하기 위해서는 다음과 같이 명령을 입력하면 될 것입니다.

1
$ sudo tar xvzf /backup/openkm/openkm-2012-05-01.tar.gz -C /opt

물론 Restore 후, Startup Script와 Apache 연결은 Part1을 참고하여 다시 설정해야 합니다.

8.2. Migration

Backup과 마찬가지로 Migration도 쉬운 편은 아닙니다. 현재 사용하고 있는 OpenKM의 Version에서 다음 Version으로 차례대로 Migration을 해 나가야 합니다.

예를 들어 사용하고 있는 OpenKM의 Version이 5.1.8이라면, 5.1.10까지 Migration하기 위해서 5.1.9로 먼저 Migration한 다음, 5.1.10으로 Migration해야 합니다.

Migration을 위한 일반적인 방법은 아래와 같습니다.

Migration은 각 Version마다 각각 조금씩 추가된 과정이 더 있을 수 있습니다. 자세한 Migration 방법은 OpenKM의 Wiki를 참고하기 바랍니다.

  1. Backup을 만듭니다. (Backup/Restore 항목 참조)
  2. Service를 정지합니다.
    1
    $ sudo service jbossokm stop
  3. Migration할 새 Version의 OpenKM을 Download합니다.
  4. Download한 OpenKM 압축에서 server/default/deploy/OpenKM.war를 압축해제합니다.
    1
    $ unzip OpenKM*.zip jboss*/server/default/deploy/OpenKM.war
  5. 압축 해제한 OpenKM.war를 설치된 OpenKM에 덮어씁니다.
    1
    $ sudo mv jboss*/server/default/deploy/OpenKM.war /opt/jboss*/server/default/deploy/
  6. Update를 위해 설치된 OpenKM의 OpenKM.cfg를 다음과 같이 수정합니다.
    1
    2
    3
    $ sudo vi /opt/jboss*/OpenKm.cfg

    hibernate.hbm2ddl=update
  7. Service를 시작합니다.
    1
    $ sudo service jbossokm start
  8. 마지막으로 OpenKM.cfg를 한 번 더 수정합니다.
    1
    2
    3
    $ sudo vi /opt/jboss*/OpenKm.cfg

    hibernate.hbm2ddl=none

9. 마치면서…

이상으로 OpenKM에 대해서 알아봤습니다. Open-source Solution이 가지는 특성 상 지원이 조금 미흡하고, Update나 Backup이 좀 불편하긴 하지만, 유용하게 사용할 수 있는 Solution이라고 생각됩니다.

많은 문서들을 관리하기 버거워하는 분이 있다면 이번에 소개한 OpenKM은 좋은 해답이 되어 줄 것입니다. :)

'Linux > Open tools' 카테고리의 다른 글

Ubuntu Natty Narwhal 11.04에서 Subversion Server 구성하기 On 2011/07/05, in Linux, Just For Fun, Server, Tools, by ioriy2k  (0) 2012.06.07
Ubuntu에서 OpenKM으로 문서 관리 Server 구성하기 (Part 1)  (0) 2012.06.07
Eclipse 3.5 Galileo에서 Subclipse로 SVN 연동하기 (2) Subclipse 기능 알아보기  (0) 2012.06.04
Ubuntu에서 Valgrind로 Memory Leak 검사하기 (활용편)  (0) 2012.06.04
Eclipse 3.5 Galileo에서 Subclipse로 SVN 연동하기 (1) 설치, Checkout  (0) 2012.06.04
,

티스토리툴바