Chapter 2 Getting Started

The information in this chapter describes how to use Evolution Setup Assistant to get started with Ximian Evolution. This chapter contains information on how to configure your email account, and how to import data from other applications. This chapter also describes how to configure your Sun ONE account, and how to configure an LDAP server.

• Using the Evolution Setup Assistant

• Configuring Your Sun ONE Account

• Configuring an LDAP Server

Using the Evolution Setup Assistant

When you start Ximian Evolution for the first time, the Evolution Setup Assistant is displayed. The Evolution Setup Assistant guides you through the initial configuration process for Evolution. In the initial configuration process, you do the following:

• Enter identity information.

• Create an email account.

• Select your time zone.

• Import data from other applications.

The Evolution Setup Assistant displays pages where you enter the configuration information. The first page displays a welcome message. To begin the initial configuration process for Evolution, click on the Forward button on the Welcome page.

The Evolution Setup Assistant window contains the following buttons:

Forward

When you have entered the required information in the page and you are ready to continue to the next page in the configuration process, click on the Forward button.

Back

If you want to return to the previous page, click on the Back button.

Cancel

Click on the Cancel button to stop the Evolution configuration process and close the Evolution Setup Assistant.

The following sections describe the information that you need to enter in the Evolution Setup Assistant. If you are unsure what information to enter, contact your system administrator.

Entering Your Identity Information

Enter your identity information in the Identity page in the Evolution Setup Assistant. Table 2–1 lists the identity settings that you can configure.

When you complete your identity information, click on the Forward button.

Table 2–1 Identity Settings

Element	Description
Full name	Type your full name in the text box.
Email address	Type your email address in the text box.
Reply-To	Optional. In the text box, type the email address to which to send replies to your messages. When someone replies to your messages, the reply goes to this address. If you do not type an address in this text box, the address in the Email address text box is used as your reply-to address.
Organization	Optional. Type the name of the organization for which you work.

Configuring a Mail Server From Which to Receive Email

Enter your receiving mail server information in the first Receiving Mail page in the Evolution Setup Assistant.

Evolution can receive email in several ways. Select the type of server from which you want to receive email from the Server Type drop-down list. Select one of the following options:

• IMAP: Internet Message Access Protocol (IMAP) servers receive and store your messages. When you log in to an IMAP server, you can view header information for your messages. You can open the messages that you want to read, and you can also create and use folders on the IMAP server.

  Select this option if you want to access your email from multiple systems.

• POP: Post Office Protocol (POP) servers store your messages until you log in to the server. When you log in to the POP server, all your messages are downloaded to your local area and are deleted from the POP server. You work with your messages in your local area. Typically, a POP server has a permanent connection to the Internet, and the clients of the server connect occasionally to the Internet.

  Select this option to download your messages to your local directories.

• Local delivery: The mbox format stores your messages in one large file in your local file system. This file is called a mail spool.

  Select this option if you want to store email from the mail spool in your home directory.

• MH-format mail directories: Mail servers that use mh format store messages in individual files. Select this option if you want to use an application that uses the mh format.

• Maildir-format mail directories: Mail servers that use maildir format also store messages in individual files. The maildir format is similar to the mh format. Select this option if you want to use an application that uses the maildir format, for example, qmail.

• Standard Unix mbox spool or directory: This option uses mbox format. Select this option if you want to store email from the mail spool in a directory other than your home directory.

• None: Select this option if you do not want to use this email account to receive email messages.

• Microsoft Exchange: Select this option if you want to access your account on a Microsoft Exchange 2000 server. This option is only available if you purchase Ximian Connector for Microsoft Exchange.

When you select an option from the Server Type drop-down list, more options are displayed in the Receiving Mail page. Depending on the option that you selected, different options are displayed. Table 2–2 lists the receiving mail server settings that you can configure. the elements in the Receiving Mail window

When you complete the receiving mail server information, click on the Forward button.

Table 2–2 Receiving Mail Server Settings

Element	Description
Host	Enter the host name of the mail server in this field.   IMAP, POP options only.
Username	Enter your username for your account on the mail server in this field.  IMAP, POP options only.
Authentication type	Select a type of authentication to use for the account.  IMAP, POP options only.
Check for supported types	Click on this button to check what types of authentication the server supports. The types of authentication that the server supports are added to the Authentication type drop-down list. IMAP, POP options only.
Remember this password	Select this option if you want to connect directly to the mail server, rather than enter your password each time you connect.  IMAP, POP options only.
Path	Enter the path to the location where you want to store your email.   Local delivery, MH-format mail directories, Maildir-format mail directories, Standard Unix mbox spool or directory options only.

Configuring Receiving Email Options

Enter your receiving email options in the second Receiving Mail page in the Evolution Setup Assistant. Table 2–3 lists the options for receiving email that you can configure.

When you complete the receiving email options, click on the Forward button.

Table 2–3 Receiving Email Options

Element	Description
Automatically check for new mail every	Select this option if you want Evolution to check for new messages automatically. Use the spin box to specify how often to check for new messages, in minutes.
Check for new messages in all folders	Select this option if you want Evolution to check for new messages in all your IMAP folders. IMAP option only.
Show only subscribed folders	Select this option to view only the IMAP folders to which you have subscribed, not all of your IMAP folders. IMAP option only.
Override server-supplied folder namespace	An IMAP namespace is a directory where your messages are stored. Select this option if you want to store your messages in a namespace other than the default namespace that the IMAP server provides. IMAP option only.
Namespace	If you select the Override server-supplied folder namespace option, enter the namespace in which you want to store your messages in this field. IMAP option only.
Apply filters to new messages in INBOX on this server	Select this option to apply your message filters to messages that are delivered to your Inbox on the IMAP server, as well as to messages that you download to your local area.  IMAP option only.
Leave messages on server	Select this option to store copies of your messages on the POP server.  POP option only.
Apply filters to new messages in INBOX	Select this option to apply your message filters to your Inbox.  Maildir-format mail directories, Standard Unix mbox spool or directory options only.
Store status headers in Elm/Pine/Mutt format	Select this option if you want to use the X-Status message header format. Select this option if you use email applications that use the X-Status message header format. For example, Elm, mutt, and Pine use the X-Status message header format. Standard Unix mbox spool or directory option only.
Use the '.folders' folder summary file (exmh)	Select this option if you want Evolution to use the folder summary file that is generated by the exmh application. MH-format mail directories option only.

Configuring How to Send Email

Enter your sending email configuration information in the Sending Mail page in the Evolution Setup Assistant. Evolution can send email in several ways. Select the type of server that you want to use to send email from the Server Type drop-down list. Select one of the following options:

• SMTP: Uses Simple Mail Transfer Protocol (SMTP) to forward messages to a server. The server sends the messages.

• Sendmail: Uses the sendmail program to send email from your system.

• Microsoft Exchange: Uses a Microsoft Exchange server which uses several protocols to send email. This option is only available if you purchase Ximian Connector for Microsoft Exchange.

When you select an option from the Server Type drop-down list, more dialog elements are displayed in the Sending Mail page. Depending on the option that you selected, different elements are displayed in the page. Table 2–4 lists the sending email settings that you can configure.

When you complete the configuration information for sending email, click on the Forward button.

Table 2–4 Sending Email Settings

Element	Description
Host	Enter the DNS name or the IP address of the mail server in this field.  SMTP, Microsoft Exchange options only.
Server requires authentication	Select this option if the server requires you to authenticate when you log in to send email.  SMTP option only.
Authentication Type	Select a type of authentication to use for the account.  SMTP option only.
Check for supported types	Click on this button to check what types of authentication the server supports. The types of authentication that the server supports are added to the Authentication Type drop-down list. SMTP option only.
Username	Enter your username for your account on the mail server in this field.  SMTP option only.
Remember this password	Select this option if you want to connect directly to the mail server, rather than enter your password each time you connect.  SMTP option only.

Configuring Account Management Settings

Enter your account management information in the Account Management page in the Evolution Setup Assistant. Table 2–5 lists the account management settings that you can configure.

When you complete the account management information, click on the Forward button.

Table 2–5 Account Management Settings

Element	Description
Name	Type a name for this email account in the text box.
Make this my default account	Select this option to make the new account your default email account.

Selecting a Time Zone

Select your time zone in the Timezone page in the Evolution Setup Assistant. The Timezone page shows a map of the world. The red dots on the map represent major cities and other locations.

Use your mouse to select a time zone, as follows:

Mouse

Point to a red dot on the map to display the name of the location. The name is displayed under the map.

Left mouse button

Click on an area on the map to zoom in to that area and to select that time zone.

Right mouse button

Click the right mouse button on the map to zoom out.

Alternatively, select a time zone from the Selection drop-down list.

When you select a time zone, click on the Forward button.

Importing Data From Other Applications

Evolution searches for email or contact data in the following formats:

mbox format

Evolution, Netscape Version 4.7x, Mozilla, Eudora, Pine, and Elm use this email format.

.mbx format

Microsoft Outlook Express 4 uses this email format.

Vcard format

GnomeCard, other GNOME applications, KDE, and other contact management applications use this format for contact information. Typically, files in this format have .vcf or .gcrd file extensions.

If Evolution finds email or contact data from the listed applications on your system, the Evolution Setup Assistant displays an Importing Files page. The Importing Files page displays a list of the applications for which Evolution has found email or contact data.

If Evolution finds email data for an application, a mail check box is displayed under the application.

If Evolution finds contact data for an application, an address book check box is displayed under the application.

To import data, select the check boxes for the data that you want to import, then click on the Import button.

When you complete the import, click on the Forward button.

When you complete entering configuration information, click on the Apply button.

---

Note –

If you do not want to import data when you do the initial configuration of Evolution, you can use the Evolution Import Assistant. The Evolution Import Assistant guides you through the process to import data. To open the Evolution Import Assistant, choose File -> Import from the Evolution window.

---

Importing Email from mutt

The mutt email client is text-based. Linux and UNIX distributions often include mutt. You can import your email easily from mutt to Evolution because mutt uses the standard mbox, maildir, and mh formats.

By default, mutt stores your email as follows:

Format	Directory
mbox	~/mbox
maildir	~/Maildir

To import email from mutt to Evolution, perform the following steps:

1. Choose File -> Import from the Evolution window. An Evolution Import Assistant is displayed.

2. Click on the Forward button to begin the configuration process. An Importer Type page is displayed.

3. Select the Import a single file option, then click on the Forward button.

4. Enter the name of the file that you want to import in the Filename field. Alternatively, to browse for the file, click on the Browse button. When you select a file, click OK, then click on the Forward button.

5. Click on the Import button. A Select folder dialog is displayed.

6. Select the Evolution folder to which you want to import the mutt email. Alternatively, click on the New button to create a new folder.

   When you select a folder, click OK. Your mutt email is imported to the folder that you specified.

Importing Email from KMail

KMail is the email client for KDE. You can import your email easily from KMail to Evolution because KMail uses the standard mbox format. By default, KMail stores your email in the Mail directory of your home directory.

To import email from KMail to Evolution, perform the following steps:

1. Choose File -> Import from the Evolution window. An Evolution Import Assistant is displayed.

2. Click on the Forward button to begin the configuration process. An Importer Type page is displayed.

3. Select the Import a single file option, then click on the Forward button.

4. Enter the name of the file that you want to import in the Filename field. Alternatively, to browse for the file, click on the Browse button. When you select a file, click OK, then click on the Forward button.

5. Click on the Import button. A Select folder dialog is displayed.

6. Select the Evolution folder to which you want to import the KMail mail. Alternatively, click on the New button to create a new folder.

   When you select a folder, click OK. Your KMail email is imported to the folder that you specified.

Configuring Your Sun ONE Account

The Sun ONE Connector for Evolution allows you to use Evolution as a client for the Sun ONE calendar server.

To configure a Sun ONE account, perform the following steps:

1. Choose Tools -> Settings. An Evolution Settings dialog is displayed.

2. Click on Sun One accounts in the left pane. A table for Sun ONE accounts is displayed in the right pane.

3. Click Add. An Add new account dialog is displayed.

4. Enter the Sun ONE account information in the Add new account dialog. The following table describes the elements on the Add new account dialog:

   Element	Description
   Account Name	Type a short account name.
   Protocol	Select one of the following protocols from the drop-down list: http: Select this protocol for normal operation. https: Select this protocol for additional security. If you are not sure which protocol to specify, contact your Sun ONE system administrator.
   Server	Type the name of your Sun ONE server. For example, sunone.internal.company.com.
   Port	Type the port number for your Sun ONE server.
   User	Type the user name that you use to log in to the Sun ONE server. Remember that user names are case sensitive. Do not enter your password in this dialog. The Sun ONE server asks for the password when you access the account.
   Poll Interval (min)	Use this spin box to specify how frequently to check the server for updates.

5. Click OK to save your changes and close the Add new account dialog. Evolution checks your Sun ONE account information, then displays an Information dialog that tells you that you must restart Evolution for these settings to take effect.

6. Restart Evolution.

Configuring an LDAP Server

The Lightweight Directory Access Protocol (LDAP) enables users to access contact information over a network. Users can share the same contact information. A typical application of LDAP is a single address book for all employees in a company, that all employees can access.

To configure an LDAP server, perform the following steps:

1. Choose Tools -> Settings. An Evolution Settings dialog is displayed.

2. Click on Directory Servers in the left pane. A table for LDAP servers is displayed in the right pane.

3. Click Add. An LDAP Configuration Assistant is displayed. The LDAP Configuration Assistant guides you through the configuration process for an LDAP server. Click on the Forward button to begin the configuration process. A Server Information page is displayed.

4. Enter general server information in the Server Information page. The following table describes the elements on the Server Information page:

   Dialog Element	Description
   Server name	Enter a DNS name or an IP address for the LDAP server where the contact information is located.
   Log in method	Select a method to use to log in. Select one of the following options:  Anonymously: Select this option if you do not want to authenticate your identity when you log in. Using email address: Select this option if you want to use your email address to log in to the LDAP server. Your email address must be added to the LDAP server before you can use the email address to log in to the server. Using distinguished name (DN): Select this option if you want to use your distinguished name to log in to the LDAP server. A distinguished name uniquely identifies a user in an LDAP directory. Your distinguished name must be added to the LDAP server before you can use the distinguished name to log in to the server.
   Email Address, or Distinguished name	Enter the email address or the distinguished name with which you want to log in to the LDAP server.

   When you complete the general server information, click on the Forward button. A Connecting to Server page is displayed.

5. Enter server connection information in the Connecting to Server page. The following table describes the elements on the Connecting to Server page:

   Dialog Element	Description
   Port number	Enter the port number for Evolution to use to connect to the LDAP server in the field. A typical value for this field is 389.
   Use SSL/TLS	Select when to use the Secure Sockets Layer (SSL) protocol or the Transport Layer Security (TLS) to connect to the LDAP server. Select one of the following options: Always: Select this option to always use SSL or TLS to connect to the LDAP server. Whenever Possible: Select this option to use SSL or TSL to connect to the LDAP server only if you are not in a secure environment. Never: Select this option to never use SSL or TLS to connect to the LDAP server.

   When you complete the server connection information, click on the Forward button. A Searching the Directory page is displayed.

6. Enter search details for the directory on the server in the Searching the Directory page. The following table describes the elements on the Searching the Directory page:

   Dialog Element	Description
   Search base	The information in an LDAP server is organized as a tree structure. A search base is a particular location in the tree structure that is the starting point for an LDAP directory search. A base entry is the name of a search base. Type the base entry to use for your LDAP directory searches in the text box.
   Show Supported Bases	Click on this button to display a list of search bases that are supported by Evolution.
   Search scope	Select the scope for your directory searches. Select one of the following options:  One: Select this option to search the search base and one level below the search base. Sub: Select this option to search the search base and all levels below the search base.
   Timeout (minutes)	Use the slider to specify the amount of time to wait before Evolution stops the search.
   Download limit	Specify the maximum number of contacts that you want to download from the LDAP server.

   When you complete the search information, click on the Forward button. A Display Name page is displayed.

7. Type a name for the server in the Display name text box. This name is displayed in your Evolution interface.

   When you complete the display name, click on the Forward button. A Finished page is displayed.

8. Click on the Apply button to create the LDAP server and close the LDAP Configuration Assistant.