We use cookies to personalise content and ads, to provide social media features and to analyse our traffic. You consent to our cookies if you continue to use our website. (learn more)

WebDocuments Setup Guide
for IceWarp Server 12.1 and later

Integration with IceWarp WebDocuments 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.

Do you have IceWarp Server 12.0.X? Please find the setup guide here.

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).

To install WebDocuments, we recommend our users to install a clean, minimal version of Debian 9.

ESXi VPS

Import VM

  • Download image zip archive and extract it (VM will not run from the extracted folder)
    DOWNLOAD
    Version for ESX 6.5
    Version for ESX 6.5
  • 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
Win 2k8 – Win2012
Win 2k8 – Win2012
Win 2012 – 2012R2+
  • 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 clicking 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/sources.list file

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

Add apt sources of IceWarp and nodejs repository

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

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

Install 'sudo' package

apt-get install sudo

Install 'dirmngr' - managing and downloading OpenPGP and X.509 certificates

apt-get install dirmngr

Install 'apt-transport-https' package to be able to use https source links

apt-get install apt-transport-https

Import signing keys into the apt keyring

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 948AD827

gpg: requesting key 948AD827 from hkp server keyserver.ubuntu.com
gpg: key 4291FC89: 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)

Update apt database on your machine


It is required to have added system locale en_US.UTF-8, to add en_US.UTF-8 execute dpkg-reconfigure locales
and check the checkbox for this locale

apt-get update && apt-get upgrade

...
...
Hit http://pkg.icewarp.com icewarp InRelease
Hit https://deb.nodesource.com stretch InRelease
Hit http://pkg.icewarp.com icewarp/gen1 amd64 Packages
Get:14 https://deb.nodesource.com stretch/main amd64 Packages [964 B]
Get:15 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:16 https://deb.nodesource.com stretch/main Translation-en [162 B]
Get:17 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:18 https://deb.nodesource.com stretch/main Translation-en [162 B]
Get:19 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:20 https://deb.nodesource.com stretch/main Translation-en [162 B]
Get:21 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:22 https://deb.nodesource.com stretch/main Translation-en [162 B]
Get:23 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:24 https://deb.nodesource.com stretch/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.

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
  • Restart the Groupware service

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.

Show me IceWarp

Select your Country
Afghanistan
Albania
Algeria
American Samoa
Andorra
Angola
Anguilla
Antarctica
Antigua and Barbuda
Argentina
Armenia
Aruba
Australia
Austria
Azerbaijan
Bahamas
Bahrain
Bangladesh
Barbados
Belarus
Belgium
Belize
Benin
Bermuda
Bhutan
Bolivia
Bosnia and Herzegovina
Botswana
Bouvet Island
Brazil
British Indian Ocean Territory
Brunei Darussalam
Bulgaria
Burkina Faso
Burundi
Cambodia
Cameroon
Canada
Cape Verde
Cayman Islands
Central African Republic
Chad
Chile
China
Christmas Island
Cocos (Keeling) Islands
Colombia
Comoros
Congo
Democratic Republic of the Congo
Cook Islands
Costa Rica
Cote D`Ivoire (Ivory Coast)
Croatia
Cuba
Cyprus
Czech Republic
Denmark
Djibouti
Dominica
Dominican Republic
Ecuador
Egypt
El Salvador
Equatorial Guinea
Eritrea
Estonia
Ethiopia
Falkland Islands (Malvinas)
Faroe Islands
Fiji
Finland
France
French Guiana
French Polynesia
French Southern Territories
Gabon
Gambia
Georgia
Germany
Ghana
Gibraltar
Greece
Greenland
Grenada
Guadeloupe
Guam
Guatemala
Guinea
Guinea-Bissau
Guyana
Haiti
Heard and McDonald Islands
Holy See (Vatican City State)
Honduras
Hong Kong
Hungary
Iceland
India
Indonesia
Iran
Iraq
Ireland
Israel
Italy
Jamaica
Japan
Jordan
Kazakhstan
Kenya
Kiribati
North Korea
South Korea
Kuwait
Kyrgyzstan
Laos
Latvia
Lebanon
Lesotho
Liberia
Libya
Liechtenstein
Lithuania
Luxembourg
Macau
Macedonia
Madagascar
Malawi
Malaysia
Maldives
Mali
Malta
Marshall Islands
Martinique
Mauritania
Mauritius
Mayotte
Mexico
Micronesia
Moldova
Monaco
Mongolia
Montserrat
Morocco
Mozambique
Myanmar
Namibia
Nauru
Nepal
Netherlands
Netherlands Antilles
New Caledonia
New Zealand
Nicaragua
Niger
Nigeria
Niue
Norfolk Island
Northern Mariana Islands
Norway
Oman
Pakistan
Palau
Palestinian territories
Panama
Papua New Guinea
Paraguay
Peru
Philippines
Pitcairn
Poland
Portugal
Puerto Rico
Qatar
Reunion
Romania
Russian Federation
Rwanda
Saint Helena
Saint Kitts and Nevis
Saint Lucia
Saint Pierre and Miquelon
Saint Vincent & the Grenadines
Samoa
San Marino
Sao Tome and Principe
Saudi Arabia
Senegal
Serbia
Seychelles
Sierra Leone
Singapore
Slovak Republic
Slovenia
Solomon Islands
Somalia
South Africa
South Georgia and the South Sandwich Islands
Spain
Sri Lanka
Sudan
Suriname
Svalbard & Jan Mayen Islands
Swaziland
Sweden
Switzerland
Syrian
Taiwan
Tajikistan
Tanzania
Thailand
Timor-Leste
Togo
Tokelau
Tonga
Trinidad and Tobago
Tunisia
Turkey
Turkmenistan
Turks and Caicos Islands
Tuvalu
Uganda
Ukraine
United Arab Emirates
United Kingdom
United States
US Minor Outlying Islands
Uruguay
Uzbekistan
Vanuatu
Venezuela
Viet Nam
Virgin Islands, British
Virgin Islands (U.S.)
Wallis and Futuna
Western Sahara
Yemen
Zambia
Zimbabwe
Montenegro

Contact Us