웹문서 설치 가이드

LibreOffice 온라인 서비스와의 통합은 여러가지 방법에서 아이스워프 웹문서에 적용되었습니다. 그러나 이는 다른 독립서버 또는 분리된 가상 머신에 설치할 것을 추천합니다.

가상 머신에 미리 설정된 환경에서 웹문서를 실행할 수 있습니다. 자신의 가상 머신에 웹문서를 실행하려면 APT 저장소에 있는 VM을 선택하시면 됩니다. (Debian8에서는 VM 필수)

이 방법은 윈도우에서 웹문서를 설치하는 가장 쉬운 방법입니다. 자신의 가상 머신에 웹문서를 실행하려면 APT 저장소에 있는 VM을 선택하시면 됩니다. (Debian8에서는 VM 필수)

도커를 사용하는 것은 리눅스에서 웹문서를 가장 쉽게 설정하는 방법입니다. 이 옵션을 통해 아이스워프와 동일 서버에서 웹문서를 운영할 수 있습니다. 동시에 APT 저장소 옵션을 사용할 수있습니다(그리고 웹문서는 아이스워프와 동일 서버에 실행할 수 있습니다). 미리 설정된 VM 옵션은 아이스워프와 다른 서버에 운영할 수 있습니다.

서버에 도커가 설치되어 있지 않다면 도커를 설치합니다. 지원되는 운영체제와 설치 방법을 확인하고 도커 사이트를 방문합니다. https://docs.docker.com/installation/ 도커는 윈도우 상에서 도커 사용으로 선택하고 리눅스 플랫폼을 구동하는 것은 지원하지 않습니다. 윈도우 플랫폼을 사용하려면 별도의 독립적인 또는 갓아 머신에서 따로 설치하시기 바랍니다.

이 방법은 Debian8에서 웹문서를 설치하는 가장 쉬운 방법입니다. 웹문서는 아이스워프 동일서버 상에 설치가 가능합니다. 또한 별도의 다른 가상 서버 상에 설치할 수 있습니다. 도커 옵션을 선택하면 아이스워프 서버와 동일 서버에 설치하거나 미리 설정된 VM 파일을 사용하여 쉽게 별도 서버에 설치할 수 있습니다.

VMware ESXi

VM 가져오기

  • zip 파일로 압축된 이미지 파일을 다운로드하고 압축을 풉니다 (VM은 압축된 폴더를 지원하지 않습니다)
    다운로드
  • vSphere 클라이언트 열기 (또는 워크스테이션과 같은 관리도구) 그리고 OVF 탬플릿 채택
  • OVF 탬프릿 파일 열고 다음 클릭
  • 탬플릿을 기본으로 설정하고 다음 클릭
  • 이름 선택(폴더는 기본 설정)하고 다음 클릭
  • 디스크 형식 선택 - 기본 설정 추천(lazy zeroed). Eager zeroed는 느리게 데이터를 가져옴. 다음을 클릭하여 디스크 형식 정보 확인. https://communities.vmware.com/message/2199576
  • 설정 변경하고 채택 이후 NPower 켜기. 완료 클릭
  • 채택 후에 닫기 클릭 후 완료
  • VMware 워크스테이션을 통해 자동 시작으로 가상머신을 관리하거나 vSphere 웹 인터페이스 - 우클릭후 좌측 메뉴에서 하이퍼바이저 클릭. 그리고 "자동시작 VMs 관리" 클릭
  • 자동시작 설정에서 가져온 VM에서 OK 클릭하여 변경 적용
  • Click OK to apply changes
VM에 IP 주소 할당

VM에 IP 주소 할당

VM에 IP 주소를 부여합니다. 기본적으로 DHCP 또는 고정 IP 주소로 설정할 수 있습니다. IPv4 주소 체계만 지원합니다.

  • DHCP:
    DHCP를 사용하려면 변경할 내용은 없습니다. 단지 DHCP 서버 설정을 통해 같은 IP 주소를 할당하면 됩니다(IP 주소는 MAC에 따라 예약됩니다)
  • 고정 IP:
    나중에 고정 IP를 설정합니다.

가상 머신 시작

VM 시작 메뉴 또는 대시보드에서 시작을 선택하여 가상 머신을 구동합니다

  • In terminal run:
    apt-get update && apt-get upgrade

고정 IP 설정 (선택)

원하는 고정 IP 주소를 다음과 같은 절차로 변경합니다 :

  • 다음과 같이 VM에 로그인합니다:
    user: root
    password:암호
  • 파일 열기 /etc/network/interfaces
  • 제거: iface eth0 inet dhcp
  • 추가:
    auto eth0
    iface eth0 inet static
    address *.*.*.* (your static IP address here)
    netmask 255.255.255.0 (your subnet mask here)
    gateway *.*.*.* (your default gateway here)
    자세한 정보는 https://wiki.debian.org/NetworkConfiguration#Configuring_the_interface_manually 를 참조하세요

아이스워프 설정

웹문서 서비스에 연결하기 위해 아이스워프 서버의 인스턴스를 설정하여야 합니다.

  • 가져온 가상 머신에 대한 IP 확인, 이 IP 주소는 아이스워프 로고 아래의 로그인 화면 상에서 보여야만 합니다.
  • 아이스워프 관리도구를 열어 '그룹웨어 / 웹클라이언트 / 문서 탭에서 온라인 문서 서버 연결'에서 VM의 IP 주소를 입력합니다.
  • 온라인 문서 서비스 사용을 선택
  • 연결 테스크 버튼을 눌러 연결이 성공되었는지 확인합니다.
  • 적용 버튼을 눌러 변경 내용을 저장합니다.
  • Review WebDAV URL settings (Groupware / WebDAV), URL must be reachable from imported VM
  • Your IceWarp Server must be able to send out tcp packets to destination port 9980

VM 가져오기

윈도우 서버 운영체제에서 Hyper-V를 사용하려면 다음 링크를 따라 해보세요. http://www.techrepublic.com/blog/data-center/set-up-your-first-windows-server-2012-hyper-v-host/

  • 압축된 zip 파일의 이미지 파일을 다운로드하고 압축을 풉니다 (VM은 압축 폴더에서)
  • Hyper-V 관리자 열기 (관리도구 또는 서버 관리자)
  • '가상 머신 가져오기' 클릭합니다 (좌측 상단의 처리 메뉴에서)
  • 압축된 VM 이미지 파일을 선택하고 VM 파일을 포함하는 루트 폴더를 선택합니다.
  • 가져오기 설정을 선택하고 두 옵션은 확인을, 그러나 가상 머신 복사 옵션을 추천합니다. (새 unique ID 생성). 그리고 가져오기 버튼을 클릭합니다.
VM에 IP 주소 할당

VM에 IP 주소 할당

VM에 IP 주소를 부여합니다. 기본적으로 DHCP 또는 고정 IP 주소로 설정할 수 있습니다. IPv4 주소 체계만 지원합니다.

  • DHCP:
    DHCP를 사용하려면 변경할 내용은 없습니다. 단지 DHCP 서버 설정을 통해 같은 IP 주소를 할당하면 됩니다(IP 주소는 MAC에 따라 예약됩니다)
  • 고정 IP:
    나중에 고정 IP를 설정합니다.

가상 머신 시작

가져오기는 새로운 가상 머신을 모든 게스트 머신의 목록에 추가합니다. 어신에서 우측 클릭을 사용하여 시작하거나 처리 메뉴의 시작 버튼을 눌러 시작할 수 있습니다. 시작 과정은 Hyper-V 관리자의 상태 메뉴에서 보여집니다.

  • In terminal run:
    apt-get update && apt-get upgrade

고정 IP 설정 (선택)

원하는 고정 IP 주소를 다음과 같은 절차로 변경합니다 :

  • 다음과 같이 VM에 로그인합니다:
    user: root
    password:암호
  • 파일 열기 /etc/network/interfaces
  • 제거: iface eth0 inet dhcp
  • 추가:
    auto eth0
    iface eth0 inet static
    address *.*.*.* (your static IP address here)
    netmask 255.255.255.0 (your subnet mask here)
    gateway *.*.*.* (your default gateway here)
    자세한 정보는 https://wiki.debian.org/NetworkConfiguration#Configuring_the_interface_manually 를 참조하세요

아이스워프 설정

웹문서 서비스에 연결하기 위해 아이스워프 서버의 인스턴스를 설정하여야 합니다.

  • 가져온 가상 머신에 대한 IP 확인, 이 IP 주소는 아이스워프 로고 아래의 로그인 화면 상에서 보여야만 합니다.
  • 아이스워프 관리도구를 열어 '그룹웨어 / 웹클라이언트 / 문서 탭에서 온라인 문서 서버 연결'에서 VM의 IP 주소를 입력합니다.
  • 온라인 문서 서비스 사용을 선택
  • 연결 테스크 버튼을 눌러 연결이 성공되었는지 확인합니다.
  • 적용 버튼을 눌러 변경 내용을 저장합니다.
  • Review WebDAV URL settings (Groupware / WebDAV), URL must be reachable from imported VM
  • Your IceWarp Server must be able to send out tcp packets to destination port 9980

도커 파일 얻기

  • 터미널 열기
  • 대상 폴더 준비 및 도커 이미지 다운로드 (mkdir -p /opt/iwdoc && cd /opt/iwdoc wget)
    In terminal run:

    mkdir -p /opt/iwdoc && cd /opt/iwdoc
    wget http://www.icewarp.com/download/tools/webdocuments/IWDOC-DOCKER.tar.gz

DOWNLOAD

이미지 로드

In terminal run:
							
								docker load -i IWDOC-DOCKER.tar.gz
							
						

이미지 실행

In terminal run:
							
								docker run --rm -i -t -p 9980:9980 --name iwdoc icewarp/loolwsd
							
						

아이스워프 설정

웹문서 서비스에 연결하기 위해 아이스워프 서버의 인스턴스를 설정하여야 합니다.

  • 아이스워프 관리도구를 열어 '그룹웨어 / 웹클라이언트 / 문서 탭에서 온라인 문서 서버 연결'에서 VM의 IP 주소를 입력합니다.
  • For common use case with Docker running on the same machine as IceWarp use 127.0.0.1
  • In case Docker runs on different machine than IceWarp use IP of that machine
  • 온라인 문서 서비스 사용을 선택
  • 연결 테스크 버튼을 눌러 연결이 성공되었는지 확인합니다.
  • 적용 버튼을 눌러 변경 내용을 저장합니다.
  • You may need to configure docker container to use your DNS server or use ip in WebDAV URL in IceWarp
  • To get help configuring DNS for docker, please consult its documentation (article "Configure a DNS server for use by Docker")

apt 소스 편집

In terminal run:
							
								nano /etc/apt/sources.list
							
						

nano /etc/apt/sources.list
- 다음과 같이 추가 :
## official IceWarp online doc repository
deb http://pkg.icewarp.com/debian icewarp main
소스 링크에서 https 사용이 가능하지만 먼저 apt-transport-https 패키지를 설치하여야 합니다!
현재 스스파일 패키지는 다음 URL에서 다운로드 받일 수 있습니다
- e.g. deb http://ftp.us.debian.org/debian jessie main (미러링 사이트는 국가 마다 다릅니다).
- 파일을 선택하고 변경 내역을 저장합니다.

저장소 서명 키 가져오기

In terminal run:

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys FA9FEC00614B1C40

머신 상의 apt 데이터베이스 갱신

In terminal run:
							
								apt-get update
							
						

아이스워프 문서 패키지 설치

In terminal run:
							
								apt-get install icewarp-doc
							
						

웹문서 서비스를 부팅시에 서비스로 자동 시작 설정

In terminal run:
							
								systemctl enable loolwsd.service
							
						

아이스워프 설정

웹문서 서비스에 연결하기 위해 아이스워프 서버의 인스턴스를 설정하여야 합니다.

  • 가져온 가상 머신에 대한 IP 확인, 이 IP 주소는 아이스워프 로고 아래의 로그인 화면 상에서 보여야만 합니다.
  • 아이스워프 관리도구를 열어 '그룹웨어 / 웹클라이언트 / 문서 탭에서 온라인 문서 서버 연결'에서 VM의 IP 주소를 입력합니다.
  • 온라인 문서 서비스 사용을 선택
  • 연결 테스크 버튼을 눌러 연결이 성공되었는지 확인합니다.
  • 적용 버튼을 눌러 변경 내용을 저장합니다.
  • Review WebDAV URL settings (Groupware / WebDAV), URL must be reachable from imported VM
  • Your IceWarp Server must be able to send out tcp packets to destination port 9980

한국 및 극동아시아 영업팀

+48 601317349