Nokia Intellisync User Manual

Nokia Intellisync

Wireless Email

Linux Installation Guide

Version 9.2

Published September 2008

COPYRIGHT

Copyright © 1997 - 2008 Nokia Corporation. All rights reserved. Nokia, Nokia Connecting People, Intellisync, and
Intellisync logo are trademarks or registered trademarks of Nokia Corporation. Other trademarks mentioned are the
property of their respective owners.

RESTRICTED RIGHTS LEGEND

Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in subparagraph
(c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.

Notwithstanding any other license agreement that may pertain to, or accompany the delivery of, this computer software,
the rights of the United States Government regarding its use, reproduction, and disclosure are as set forth in the
Commercial Computer Software-Restricted Rights clause at FAR52.227-19.

IMPORTANT NOTE TO USERS

THIS SOFTWARE, HARDWARE, AND DOCUMENTATION IS PROVIDED BY NOKIA INC. AS IS AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
NOKIA, OR ITS AFFILIATES, SUBSIDIARIES OR SUPPLIERS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Nokia operates a policy of continuous development. Therefore we reserve the right to make changes and improvements
to any of the products described in this document without prior notice.

050208

2 Nokia Intellisync Wireless Email Linux Installation Guide

Nokia Contact Information
Corporate Headquarters

Web Site http://www.nokia.com
Telephone [phone] or

1-650-625-2000

Fax [phone]
Mail

Address

Regional Contact Information

Nokia Inc.
313 Fairchild Drive
Mountain View, California
94043-2215 USA

Americas Nokia Inc.

313 Fairchild Drive
Mountain View, CA 94043-2215
USA

Europe,
Middle East,
and Africa

Asia-Pacific 438B Alexandra Road

Nokia Customer Support

Web Site: https://support.nokia.com/
Americas Europe
Voice: 1-888-361-5030 or

Fax: [phone] Fax: [phone]
Asia-Pacific
Voice: [phone]
Fax: [phone]

Nokia House, Summit Avenue
Southwood, Farnborough
Hampshire GU14 ONG UK

#07-00 Alexandra Technopark
Singapore 119968

1-613-271-6721

Tel: [phone]
Outside USA and Canada: [phone]
email: [e-mail]

Tel: UK: [phone]
Tel: France: [phone]
email: [e-mail]

Tel: [phone]
email: [e-mail]

Voice: [phone]

050602

Nokia Intellisync Wireless Email Linux Installation Guide 3

4 Nokia Intellisync Wireless Email Linux Installation Guide

Contents

About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Conventions This Guide Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Command-line Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Text Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Accessing Server Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Accessing Server Online Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Accessing Client Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Client Installation Guides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Client Web Site Online Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Recommended Server Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Components Requiring Dedicated Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Product Evaluation and Small Installations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Minimum Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Minimum Client Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Minimum Server Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2 Installing on a Linux Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Before You Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Installing Nokia Intellisync Wireless Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Choosing an Installation Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Running a Graphical Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Running a Silent Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Running the Installation in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Installing the Secure Gateway Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Installing Nokia Intellisync on Multiple Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Configuring a Cluster Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Required Linux Server Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Starting and Stopping Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Uninstalling Intellisync Mobile Suite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Nokia Intellisync Wireless Email Linux Installation Guide 5

3 Additional Server Installation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Setting Up a Remote SQL Anywhere Database Server . . . . . . . . . . . . . . . . . . . . . 29

Setting Up Database Mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Testing the High Availability Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Setting Up a Dedicated Share File System Server. . . . . . . . . . . . . . . . . . . . . . . . . 32

4 Upgrading the Nokia Intellisync Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Backing Up Existing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Upgrading Using a Graphical Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Upgrading Using Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Upgrading Using the Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

5 Post-Installation Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

End User Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Administrator Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Troubleshooting Logon Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

A Configuring a GroupWise Mobile Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Verifying the GroupWise Post Office Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Configuring the GroupWise Mobile Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Verifying Successful Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

B Backing Up Data on a Linux Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Backing Up the Nokia Intellisync Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Backing Up a Server with a Sybase Database . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Restoring Nokia Intellisync Server Data from a Backup . . . . . . . . . . . . . . . . . . . . . 42

Restoring Data to a Server with a Sybase Database. . . . . . . . . . . . . . . . . . . . . . 43

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

6 Nokia Intellisync Wireless Email Linux Installation Guide

About This Guide

This guide is organized into the following chapters:

 Chapter 1, “System Requirements”
 Chapter 2, “Installing on a Linux Server”
 Chapter 3, “Additional Server Installation Options”
 Chapter 4, “Upgrading the Nokia Intellisync Server”
 Chapter 5, “Post-Installation Testing”
 Appendix A, “Configuring a GroupWise Mobile Server”
 Appendix B, “Backing Up Data on a Linux Server”

Additional information provided in this section is as follows:

 Conventions This Guide Uses
 Related Documentation

Conventions This Guide Uses

The following sections describe the conventions this guide uses, including notices, text
conventions, and command-line conventions.

Notices

Warning

Warnings advise the user that bodily injury might occur because of a physical hazard.

Caution

Cautions indicate potential equipment damage, equipment malfunction, loss of
performance, loss of data, or interruption of service.

Nokia Intellisync Wireless Email Linux Installation Guide 7

Note

Notes provide information of special interest or recommendations.

Command-line Conventions

You may encounter one or more of the following elements on a command-line path.

Table 1 Command-line Conventions

Convention Description

command This required element is usually the product name or other short

word that invokes the product or calls the compiler or preprocessor
script for a compiled Nokia product. It might appear alone or
precede one or more options. You must spell a command exactly
as shown and use lowercase letters.

Italics Indicates a variable in a command that you must supply. For

example:

delete interface if_name

Supply an interface name in place of the variable. For example:

delete interface nic1

angle brackets < > Indicates arguments for which you must supply a value:

retry-limit <1–100>

Supply a value. For example:

retry-limit 60

Square brackets [ ] Indicates optional arguments.

delete [slot slot_num]

For example:

delete slot 3

Vertical bars, also called a

pipe

(|)

Separates alternative, mutually exclusive elements.

framing <sonet | sdh>

To complete the command, supply the value. For example:

framing sonet

or

framing sdh

-flag A flag is usually an abbreviation for a function, menu, or option
name, or for a compiler or preprocessor argument. You must enter
a flag exactly as shown, including the preceding hyphen.

8 Nokia Intellisync Wireless Email Linux Installation Guide

Table 1 Command-line Conventions (continued)

Convention Description

.ext A filename extension, such as .ext, might follow a variable that

( . , ; + * - / ) Punctuation and mathematical notations are literal symbols that

' ' Single quotation marks are literal symbols that you must enter as

Text Conventions

Table 2 describes the text conventions in this guide.

Table 2 Text Conventions

Convention Description

Conventions This Guide Uses

represents a filename. Type this extension exactly as shown,
immediately after the name of the file. The extension might be
optional in certain products.

you must enter exactly as shown.

shown.

monospace font

Indicates command syntax, or represents computer or screen
output, for example:

Log error 12453

bold monospace font

Indicates text you enter or type, for example:

# configure nat

Key names Keys that you press simultaneously are linked by a plus sign (+):

Press Ctrl + Alt + Del.

Menu commands Menu commands are separated by a greater than sign (>):

Choose File > Open.

The words enter and type Enter indicates you type something and then press the Return or

Enter key.
Do not press the Return or Enter key when an instruction says

type.

Italics

• Emphasizes a point or denotes new terms at the place where
they are defined in the text.

• Indicates an external book title reference.

• Indicates a variable in a command:

delete interface if_name

Nokia Intellisync Wireless Email Linux Installation Guide 9

Related Documentation

Nokia offers a common framework for the Nokia Intellisync Mobile Suite products. For this
reason, there are electronic manuals and online help systems that cover the entire suite, plus
additional resources for specific products.

For instructions to access documentation, see the following topics:

 Accessing Server Documentation
 Accessing Server Online Help
 Accessing Client Documentation

Accessing Server Documentation

The following server guides are available for Wireless Email. These documents are available on
the Nokia Support Web Site (http://support.nokia.com) in Adobe Portable Document Format
(PDF) or through your system administrator.

 Nokia Intellisync Wireless Email Linux Installation Guide

(LinuxWEInstallGdeEN.pdf)—includes the installation requirements and other information
you need to install Nokia Intellisync Wireless Email software for servers and clients.

 Nokia Intellisync Mobile Suite Release Notes (ReleaseNotesEN.pdf)—includes important

information you should know before you install and use Nokia Intellisync Mobile Suite.
This document includes important late-breaking information that may not be included in
other documentation. This document applies to the entire suite and is shared with other
Nokia Intellisync Mobile Suite products.

 Nokia Intellisync Wireless Email Administrator’s Guide

(WirelessEmailAdminGuideEN.pdf)—covers system administrative functions for
managing the Wireless Email server and client operations.

 Nokia Intellisync Secure Gateway Administrator’s Guide (SecureGatewayGdeEN.pdf)—

written as a companion book to the Nokia Intellisync Wireless Email Administrator’s Guide,
and includes administrative functions for managing the Secure Gateway server.

Accessing Server Online Help

Nokia Intellisync Mobile Suite installs an online help system to assist administrators working in
WebAdmin Console.

Nokia Intellisync Mobile Suite WebAdmin Console Help—includes information for
managing the Nokia Intellisync Mobile Suite server using WebAdmin Console.

10 Nokia Intellisync Wireless Email Linux Installation Guide

Accessing Client Documentation

The following electronic documents are available on the Nokia Support Web site
(http://support.nokia.com) in Adobe Portable Document Format (PDF) or through your system
administrator.

Client Installation Guides

Each guide includes information for installing software on devices using a specific platform,
configuring synchronization settings, and synchronizing for the first time.

Table 3 Client Guides

Name File Name

Nokia Intellisync Mobile Suite Client Guide–Palm OS Platform PalmUsersGuideEN.pdf

Related Documentation

Nokia Intellisync Mobile Suite Client Guide–Windows Mobile
Platform

Nokia Intellisync Mobile Suite Client Guide–S60 3rd Edition
Platform

Nokia Intellisync Mobile Suite Client Guide–S80 Platform Symbian80_UsersGuideEN.pdf
Nokia Intellisync Mobile Suite Client Guide–UIQ 3rd Edition

Platform

Note

The client guides are not installed as part of the client installation. You decide whether to
provide the documentation to your users.

WindowsMobileUsersGuideEN.pdf

Symbian60_UsersGuideEN.pdf

SymbianUIQ3_UsersGuideEN.pdf

Client Web Site Online Help

The Web PIM interface provides online help on every page for end users.

Nokia Intellisync Wireless Email Linux Installation Guide 11

12 Nokia Intellisync Wireless Email Linux Installation Guide

1 System Requirements

Nokia Intellisync Wireless Email offers centralized email and personal information manager
(PIM) synchronization for your users. Wireless Email allows you to synchronize email, contacts,
memos, calendar, and to-do items among all your mobile devices, eliminating duplicate data
entry. This same data is accessible from any Internet-ready mobile phone and Web browser on
any computer connected to the Internet. For supported devices, you can set up the Push feature
so users receive new email as it as it arrives on the server.

Recommended Server Configuration

Many factors—the number of users, the number of concurrent users, and the volume of
information shared, among others—affect how you should set up your system. This section
provides some general guidelines for configuring the server.

Components Requiring Dedicated Computers

Depending on the size of your installation and the number of users, some components may be
installed on the same computer. Other components perform best when each component is
installed on a dedicated computer (or computers).

Do not install Nokia Intellisync Wireless Email on the Novell GroupWise server.

Product Evaluation and Small Installations

For a product evaluation, you may install the Nokia Intellisync server and the database on the
same computer. A single computer that meets the minimum requirements can easily handle both
the server and database for a product evaluation or small installation (under 100 users).

After evaluating the product, many customers choose to purchase a license key and upgrade their
evaluation environment to a production environment. For larger installations where the Nokia
Intellisync server and the database are on the same computer, the system administrator is
potentially limiting scalability. If you anticipate converting your existing evaluation system to a
production system supporting more than 100 active users, consider using separate computers for
the Nokia Intellisync server and the database during evaluation.

Nokia Intellisync Wireless Email Linux Installation Guide 13

1 System Requirements

Minimum Requirements

Table 4 and Table 5show the minimum requirements for Nokia Intellisync Wireless Email. As

minimum requirements, this list may not provide the optimal environment for peak system
performance.

Minimum Client Requirements

The following table lists the minimum client requirements.

Table 4 Wireless Email Client Minimum Requirements

PC Client Pocket PC Client SmartPhone Palm OS Client Symbia n

HARDWARE

Processor
Type

Hard Disk
Space

Memory 64 MB RAM 32 MB RAM 32 MB RAM 8 MB RAM 32 MB RAM

SOFTWARE

Operating
System

Browser Microsoft Internet

3GHz Dual Core
Processor

10GB MB

• Windows XP

• Windows Vista

Explorer 6.0 or later

Supported processor
type: ARM - XScale

• Windows Mobile

5.0 or later

• Windows Mobile

5.0 or later

Palm 5.0 or later

• S80: 7.0

• S60: 9.1, 9.2,

9.3

• UIQ: 3.0

14 Nokia Intellisync Wireless Email Linux Installation Guide

Minimum Server Requirements

The following table lists the minimum server requirements. As minimum requirements, this list
may not provide the optimal environment for peak system performance.

Table 5 Wireless Email Server Minimum Requirements

HARDWARE

Processor Two Intel Xeon 3.0 GHz or later
Hard Disk Space 5 GB free disk space
Memory 2 GB RAM

SOFTWARE

Minimum Requirements

Operating System

RedHat Enterprise Linux 5.2, SLES 10 (openSUSE Linux
Enterprise Server 10.0), Open Enterprise Server 1.0

Note

SELinux is supported using Targeted policy and with the
server not included as one of the targeted daemons. SELinux
is not supported using Strict policy.

Browser Firefox 2.0 or Internet Explorer 7 or later
Supported Database Sybase SQL Anywhere 10

OTHER REQUIREMENTS

Permissions Root
Open port 443 Open port 443 for license server, secure Web access

(HTTPS), synchronization requests, Windows Mobile
provisioning, and for access to external hosts
ans1.nokia.com, ans2.nokia.com, and

mtsgateway.ext.nokia.com.
Open port 80 Open port 80 for Web access and synchronization requests
Open port 3102 Open port 3102 for synchronization requests
Open port 25 Open port 25 for SMS push

The SMTP (sendmail) service must be configured correctly.
Latency between IMS server and other

backend server, database, or file system

36 milliseconds or less

Nokia Intellisync Wireless Email Linux Installation Guide 15