We use cookies to ensure that we give you the best experience on our website. By continuing your visit on the website, you consent to the use of the cookies.

WebDocuments Setup Guide

Integration with LibreOffice Online service allows to deploy IceWarp WebDocuments in several
ways, but we recommend running it on a separate server or at least in a separate virtual machine.

With this method, you will run WebDocuments on virtual machine preconfigured by us. If you prefer to run WebDocuments on your own Virtual Machine, check also option APT repository (VM with Debian8 is required).

This method is the easiest way for you to setup WebDocuments on Windows. With this method, you will run WebDocuments on a virtual machine preconfigured by Icewarp. If you prefer to run WebDocuments on your own Virtual Machine, check also option APT repository (VM with Debian8 is required).

This method seems to be the easiest way for you to setup WebDocuments on 64bit Debian8. You can either have WebDocuments on the same server as IceWarp or you can use a different virtual server for WebDocuments only. You can also choose the Docker option (and have WebDocuments on the same server as IceWarp) or choose Preconfigured VM option (then WebDocuments will be not on the same server as IceWarp). This option requires your system to use systemd as its init system which is the default for Debian 8.

ESXi VPS

Import VM

  • Download image zip archive and extract it (VM will not run from the extracted folder)
    DOWNLOAD
  • Open vSphere client (or other manager like Workstation) and deploy OVF Template
  • Open OVF Template file and click next
  • Review template details, click next
  • Fill in a name for the VM (the default value is just fine), click next
  • Select datastore and disc type - we recommend default setting (lazy zeroed). Eager zeroed will result in slower import.
    Click next learn more about disk types at: https://communities.vmware.com/message/2199576
  • Revise settings and check „Power on after deployment“, click finish
  • Click close after deployment finish
  • Manage virtual machine automatic start through VMware Workstation or vSphere WebClient - right-click hypervisor in the list in left pane and pick "Manage AutoStart VMs..."
  • Tick the box on the left from imported VM in the Configure AutoStart dialog.

There is no need to change anything in the image if DHCP is used. Just configure your DHCP server to assign the same IP address each time (IP reservation according to MAC)

Start the Virtual Machine

Power on (if not already done during import) the Virtual Machine by selecting Start from VM Power menu or its dashboard.

Configure IceWarp server

  • Obtain IP address assigned to installed machine. It should be visible on terminal (or SSH login screen) under the IceWarp logo. Open IceWarp Administration Console and insert IP address of iwds host into "WebDocuments server connection" input located at GroupWare -> WebClient -> WebDocuments tab
  • Enable "WebDocuments Service"
  • Check that the configuration is correct by clicking "Test Connection" button (image iwdoc-iwserver-setup.jpg). "Test Connection" check will also configure iwds service for interoperation with IceWarp Server.
  • Save configuration changes by clicking on Apply button

Review TeamChat URL settings located at System -> Smartdiscover tab. URL must be reachable from iwds host. Also, IceWarp Server must be able to send out tcp packets to destination ports 8081, 80 or 443 on iwds host.

Import VM

To enable Hyper-V role on your Windows Server OS follow
https://technet.microsoft.com/en-us/library/hh846766.aspx#BKMK_SERVER
The process is quite similar on all relevant Windows Server versions.

  • Download image zip archive and extract it (VM will run in the extracted folder!)
  • Open Hyper-V Manager (located in Administrative Tools or Server Manager)
  • Click "Import Virtual Machine..." option located on top of Actions pane (on the left)
  • Browse to the location where you extracted VM image and select the root folder containing VM files.
  • Choose import settings, both options are ok, but rather go for "Copy the virtual machine (create new unique ID)" option.
    Press "Import"

The most current version of IceWarp Server is available for Windows and the most popular Linux systems.

Start the Virtual Machine

Importing will add new virtual machine to list of all guest machines. You can start it either by right licking the machine or by left-clicking "Start" item in Actions pane. Start progress is displayed in Status column in Hyper-V Manager.

Double-clicking the machine in the list will bring up VNC console, booted VM will display IceWarp logo together with machine ip.

Configure IceWarp Server

  • Obtain IP address assigned to installed machine. It should be visible on terminal (or SSH login screen) under the IceWarp logo. Open IceWarp Administration Console and insert IP address of iwds host into "WebDocuments server connection" input located at GroupWare -> WebClient -> WebDocuments tab
  • Enable "WebDocuments Service"
  • Check that the configuration is correct by clicking "Test Connection" button (image iwdoc-iwserver-setup.jpg). "Test Connection" check will also configure iwds service for interoperation with IceWarp Server.
  • Save configuration changes by clicking on Apply button

Review TeamChat URL settings located at System -> Smartdiscover tab. URL must be reachable from iwds host. Also, IceWarp Server must be able to send out tcp packets to destination ports 8081, 80 or 443 on iwds host.

Open terminal emulator note. Commands need to be run under 'root' account. Add apt sources of icewarp and nodejs repository:

Check if your Debian is able to install 'contrib' and 'non-free'packages.

- you should find this line in /etc/apt/source.list file

deb http://ftp.uk.debian.org/debian/ [debian-version] main

- where [debian-version] is the version of currently installed release. e.g. in case of Debian Jessie, the source should look like:

deb http://ftp.uk.debian.org/debian/ jessie main contrib non-free    

Add apt sources of IceWarp and nodejs repository

echo "deb http://pkg.icewarp.com/debian icewarp gen1" > /etc/apt/sources.list.d/icewarp.list
echo "deb https://deb.nodesource.com/node_6.x jessie main" > /etc/apt/sources.list.d/nodejs.list

Import signing keys into the apt keyring

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

gpg: requesting key 614B1C40 from hkp server keyserver.ubuntu.com
gpg: key E7FF3B9B: public key "IceWarp Technology >sysadmin@icewarp.com<" imported
gpg: Total number processed: 1
gpg:               imported: 1  (RSA: 1)


apt-key adv --keyserver keyserver.ubuntu.com --recv 68576280

gpg: requesting key 68576280 from hkp server keyserver.ubuntu.com
gpg: key 68576280: public key "NodeSource >gpg@nodesource.com<" imported
gpg: Total number processed: 1
gpg:               imported: 1  (RSA: 1)

- It is also possible to use https in the source links, but in that case apt-transport-https package HAS TO be installed first.

Update apt database on your machine

apt-get update

...
...
Hit http://pkg.icewarp.com icewarp InRelease
Hit https://deb.nodesource.com jessie InRelease
Hit http://pkg.icewarp.com icewarp/gen1 amd64 Packages
Get:14 https://deb.nodesource.com jessie/main amd64 Packages [964 B]
Get:15 https://deb.nodesource.com jessie/main Translation-en_US [162 B]
Get:16 https://deb.nodesource.com jessie/main Translation-en [162 B]
Get:17 https://deb.nodesource.com jessie/main Translation-en_US [162 B]
Get:18 https://deb.nodesource.com jessie/main Translation-en [162 B]
Get:19 https://deb.nodesource.com jessie/main Translation-en_US [162 B]
Get:20 https://deb.nodesource.com jessie/main Translation-en [162 B]
Get:21 https://deb.nodesource.com jessie/main Translation-en_US [162 B]
Get:22 https://deb.nodesource.com jessie/main Translation-en [162 B]
Get:23 https://deb.nodesource.com jessie/main Translation-en_US [162 B]
Get:24 https://deb.nodesource.com jessie/main Translation-en [162 B]
Fetched xxx kB in xs (xx.x kB/s)
Reading package lists... Done

Install icewarp-webdocuments package

apt-get install icewarp-webdocuments

This package will install all necessary dependencies, so after approximately twenty minutes you will have configured and running backend for your web documents. The last line of script output is actual IP address of iwds host which is needed in next step, you can however obtain IP address in any common way.

Running IceWarp Server and WebDocuments server on same machine

This step is needed only in case WebDocuments and IceWarp runs on the same server.
In this case you need to reconfigure port binding of nginx daemon (used by WebDocuments) so that it doesn't interfere with ports used by IceWarp Server. Change default ports [80, 443] located in file /etc/nginx/conf.d/onlyoffice-documentserver.conf to another unused ports and restart nginx.
Don't forget to properly configure location of Webdocuments Server (including port) in IceWarp Server settings in the next step

Configure IceWarp server

  • Obtain IP address assigned to installed machine. It should be visible on terminal (or SSH login screen) under the IceWarp logo. Open IceWarp Administration Console and insert IP address of iwds host into "WebDocuments server connection" input located at GroupWare -> WebClient -> WebDocuments tab
  • Enable "WebDocuments Service"
  • Check that the configuration is correct by clicking "Test Connection" button (image iwdoc-iwserver-setup.jpg). "Test Connection" check will also configure iwds service for interoperation with IceWarp Server.
  • Save configuration changes by clicking on Apply button

Review TeamChat URL settings located at System -> Smartdiscover tab. URL must be reachable from iwds host. Also, IceWarp Server must be able to send out tcp packets to destination ports 8081, 80 or 443 on iwds host.

Contact Us