V10 Installation Guide

8/7/2019 V10 Installation Guide

1/23

Printed on 30 March, 2011

IceWarp Unified Communications

Installation Guide

Version 10.3


2/23


3/23

Contents

Installation Guide 1

Pre-requisites ................................................................................................................................................................. 1

Launch Installer Wizard .................................................................................................................................................. 2

Select Language .............................................................................................................................................................. 5

Welcome Screen ............................................................................................................................................................ 6

License Agreement ......................................................................................................................................................... 7

Your Details .................................................................................................................................................................... 8

Upgrade Installation ....................................................................................................................................................... 9

License Registration ..................................................................................................................................................... 10

Online Activation ............................................................................................................................................. 11

Enter License Offline ........................................................................................................................................ 12

Database Selection ....................................................................................................................................................... 14

Supported Databases ....................................................................................................................................... 15

Collation and Charset ....................................................................................................................................... 15

Component Selection ................................................................................................................................................... 16

Installation Directory .................................................................................................................................................... 17

Installation Progress and Completion .......................................................................................................................... 18


4/23


5/23

1

In This Chapter

Pre-requisites ......................................................................................... 1

Launch Installer Wizard .......................................................................... 2

Select Language ..................................................................................... 5

Welcome Screen .................................................................................... 6

License Agreement ................................................................................. 7

Your Details ............................................................................................ 8

Upgrade Installation ............................................................................... 9

License Registration ............................................................................... 10

Database Selection ................................................................................. 14Component Selection ............................................................................. 16

Installation Directory ............................................................................. 17

Installation Progress and Completion .................................................... 18

Pre-requisites

Installation on Windows 2008 or Windows Vista, Windows 7 When installing IceWarp Server on Windows Server 2008 operating system (and also on Windows Vista), to install

IceWarp Server properly, you must be the administrator of the system and not only a member of the administrative

group.

The same for launching the Administration GUI you must be the Administrator or have to run the config.exeexecutable "As an Administrator".

Setup Package and Database

To install IceWarp Server you will need to have the following to hand:

Full setup package from the IceWarp website http://www.icewarp.com or one of partner's sites, or on-line installerwhich downloads the modules you wish to install from internet- the advantage is that you save time by downloading

only 500k setup and skipping modules which you have not licensed and don't wish to have installed.

An idea of the number of accounts you will have on your server. IceWarp Server comes supplied with SQLite as itsdatabase engine. If you expect to have more than 500 accounts on your system, you should seriously consider moving

to a more robust database engine, such as MS SQL Server or MySQL. All IceWarp Server's databases

(Accounts/AntiSpam/GroupWare etc.) will be stored on this server.

If you choose to use an external database engine, it should be installed and ready and you should have user/passwordcredentials.

C H A P T E R 1

Installation Guide


6/23

2 Installation Guide

If You Already Have PHP Installed

IceWarp Server installs its own copy of PHP.

There is a known issue from IceWarp Server Version 9 onwards where, if you already have PHP installed, the two versions

clash and WebClient will not run.

The work-around for this problem is simply to move the files: php5ts.dll and/or php4ts.dll from the windows\system32

directory to the system32\inetsrv directory.

Free Disk Space

At least 300MB of free hard disk space in order to install the software. You will need much more for e-mail data,temporary files, databases, but these can be afterwards set to external locations if desired.

Windows Firewall Bypass

There is no need to set a bypass manually IceWarp Server adds itself to the Windows firewall bypass list automatically.

Upon each setup the firewall is bypassed for ALL required modules.

This applies for Windows XP, Windows Vista, Windows 7 and Windows Server 2008.

Launch Installer Wizard

The installation package comes as an all-in-one executable installer wizard, signed with application certificate.

Launch the executable by double-clicking the downloaded file, verify the certificate (click the IceWarp Limitedlink), if

prompted, click Yes or Trustto continue.

If you are unsure about validity of the certificate you were presented with, click Cancelto stop the installation.


7/23

Launch Installer Wizard 3

Otherwise, click the Run button.


8/23



9/23

Select Language 5

Select Language

You will be asked which language you want to use for the installation.

IceWarp Server is available in numerous languages and more are always being added.

Choose the language you want from the drop-down box and press OK.


10/23


Welcome Screen

The Welcome screen is displayed.

Click Nextto continue.


11/23

License Agreement 7

License Agreement

The License Agreement is displayed.

Check the box to confirm your agreement with the license conditions.

Click Yes to continue.


12/23


Your Details

Enter your valid registration details, they are kept completely private and used solely to better service you as a customer.

Note the Reference ID string displayed at the bottom- this is a unique identifier of your computer, useful when:

requesting a trial license registering manually by Activate License - Enter license offline getting a new license for offline activation when migrating to another server hardware

You can select Reference ID using the mouse and copy it to the clipboard.

Click Nextto continue.


13/23

Upgrade Installation 9

Upgrade Installation

If you are performing an installation over an existing version of IceWarp Server you wil l be presented with this screeninforming you that Upgrade Setup will be performed.

Press Nextto continue and proceed to Database Selection (new) or Component Selection (upgrade).

If the Nextbutton is disabled, your existing license is not eligible for this upgrade, or you need to acquire an evaluationlicense extension. See License Registration.

NOTE that depending on the status of your current license, the upgrade from version 9 to version 10 may require this step

although the upgrade would be free of charge. Your current version 9 license will be converted to version 10 license, and a

new Order ID and license.xml file will be issued that you will use in Activate License dialog.


14/23


License Registration

1. Click Update License to get an updated license from the on-line purchase system. It will open the browser on thesecure web page, attempt to load your current license and offer the available upgrade options.

2. In case of a new installation, instead ofUpdate License button there will be a Get Trialbutton which will take youto http://shop.icewarp.com/purchase system Retrieve Free Trial License section. Complete the form and youwill receive a trial license shown on-screen with the option to download the license.xml file, and a confirmation

containing your Order ID will be emailed to you.

Free trial can be used only once. If you will need to extend it, or add more user seats, please contact [email protected].


15/23

License Registration 11

Online Activation

Enter the Order ID you received with the updated license. Note any errors displayed. If you are unable to activate the licenseon-line due to firewall restricting access to port 80, or the server is not able to access the Internet, use the off -line activation

as follows.


16/23


Enter License Offline

Switch to the Enter License Offline tab, click the Enter License File button, and navigate to the license.xml file you

have previously obtained from http://shop.icewarp.com/, or received as attachment to the confirmation e-mail

upon completion of your order.

NOTE for the off-line activation it is crucial to have a license issued for the exact computer hardware where it is to be

installed. If you are getting Reference ID Mismatch error, go back to http://shop.icewarp.com/, and use the License

Activation option with your Order ID and the Reference ID displayed on the previous screen.


17/23


18/23


Database Selection

In this screen, you will select what type of database IceWarp Server will use.

Basic installation will use SQLite database with no further configuration required. If you do not require an externaldatabase simply select the Basic option and click Nextand continue with Component Selection (on page 16).

Advanced installation will ask you for the information required to access your external database system. Select theAdvancedoption and click Next.


19/23

Database Selection 15

The Database dialog will open where you should enter the credentials to access your database. The following screenshot

shows an example for MS SQL installation.

NOTE that if you are using either of the Windows XP x64 Edition or Windows Server 2003 R2 x64 operating systems then you

may experience difficulties "seeing" any ODBC connection you set up. If you are experiencing problems then you should use

the ODBC Data Source Administrator application located at \SysWOW64\odbcad32.exe and this

should allow you to manage your ODBC connections.

You can press the Test Connection button to have the process check the credentials are valid, but this test will be also

performed when you click OK. If there are any problems the dialog will stay open and the installation will not continue.

Press OKto continue with the installation.

Supported Databases

IceWarp Server always supports only official/stable releases of database engines:

ships with SQLite3 3.6.1 native support supports MySQL 5.1 via native driver supports Firebird 2.1 via native driver supports MS Access 2008, MS SQL 2000/2005/2008, Oracle 11, Postgre SQL 8 and lower using ODBC or unixODBC

(check version support with ODBC driver vendor).

Collation and Charset

All MySQL databases must be in UTF-8 character set and UTF-8 collation - "utf8_general_ci". Otherwise it could cause several

issues (problems with logging in to WebClient, some messages not displayed or displayed incorrectly, etc.) This relates to

MySQL server only: default SQLite is using it by default, MS SQL can't use UTF-8.


20/23


Component Selection

You can now select which components you wish to install.

By default all components are selected (shown by the green tick).

Make your choices and click Nextto continue.


21/23

Installation Directory 17

Installation Directory

Select the installation directory for IceWarp Server. Needed subdirectories will be created during installation.

Ensure that the disk that you want to select has enough space to store all data.

Press the Browse button to open a standard directory browse dialog.

Press the Installbutton when you are happy with your selection.


22/23


Installation Progress and Completion

An installation progress dialog will be displayed as follows:

Installation may take a few minutes depending. The installer will attempt to stop and afterwards restart services being

upgraded.

In case of error messages informing that a file cannot be overwritten because it is in use or cannot be accessed, close the

application manually, or use Ctrl+Alt+Delto invoke the Task Manager and shut down the running service. Then click

Repeatto continue the installation.


23/23

Installation Progress and Completion 19

When the installation is complete the following screen is shown.

At this point you can choose to Open Start Menu Folder, to directly access the WebAdmin and WebClient interfaces, go to

Download Clients page on your system, open the Administration Interface, run the DNS Tool utility to help you verify your

MX/A DNS records for your domain name, or read accompanying Help documentation.

If it is a fresh installation, you can choose to Run Installation Wizard which will guide you through setting up your first email

domain.

Select the actions you require and click Finish.

Congratulations, you have successfully installed or upgraded the IceWarp Server.

Date post:	08-Apr-2018
Category:	Documents
Upload:	noturng
View:	231 times
Download:	0 times

V10 Installation Guide

Documents