Transcript
Installing GFI MailArchiver
Introduction This chapter highlights important points you should take into consideration before installing GFI MailArchiver on your network, so that you can make the best decisions on where to install and how to configure GFI MailArchiver on your network.
On which machine should I install GFI MailArchiver? GFI MailArchiver should be installed on a machine that forms part of the Active Directory domain whilst taking into consideration the following points: •
Email flow experienced by your servers
•
Machine hardware and software specifications
• Need to archive email from multiple sources concurrently For example, if you only need to archive email from one mail server source, for instance Exchange Server, and the server is handling the email flow on your network and still has spare processing capacity, then you can choose to install GFI MailArchiver on the Exchange Server machine directly. On the other hand, if you want to archive email from multiple mail servers, including non-Exchange Servers using the IMAP protocol, we suggest that you install GFI MailArchiver on a separate machine. NOTE: GFI MailArchiver does not require a dedicated machine when it is not installed on the mail server. For example, you can, install GFI MailArchiver on machines running other applications such as GFI MailEssentials or GFI MailSecurity. The machine on which you choose to install GFI MailArchiver needs to have Internet Information Services (IIS) and the World Wide Web Service installed and running, with ASP.NET registered, since GFI MailArchiver needs to create a virtual directory to host the GFI MailArchiver web interface.
GFI MailArchiver for Exchange
Installing GFI MailArchiver • 5
System requirements To install GFI MailArchiver you need: •
Windows 2000 (Service Pack 3 or higher) or Windows 2003 The machine needs to be a Domain Controller or connected to one, since GFI MailArchiver requires access to Active Directory.
•
Microsoft .NET Framework 2.0
•
Internet Information Services (IIS) – World Wide Web service NOTE: Ensure that ASP.NET is registered with IIS. To register it follow these steps: 1. Open Command Prompt 2. Go to \Microsoft.NET\Framework\\ 3. Run the command ‘aspnet_regiis.exe –i’ and press ENTER
•
Microsoft Internet Explorer 5.5 or later
NOTE: Upon installation, GFI MailArchiver creates a default archive store in a Firebird Database (open source). Therefore, Microsoft SQL Server is only a requirement if you would like to store data on Microsoft SQL Server instead of Firebird. GFI MailArchiver supports both Microsoft SQL Server 2000 (Service Pack 3 or higher) and Microsoft SQL Server 2005. Refer to the following Knowledge Base article for information regarding the Microsoft SQL Server collation mode required: http://kbase.gfi.com/showarticle.asp?id=KBID002277
Hardware requirements The hardware requirements for GFI MailArchiver are: •
Pentium 4 (or equivalent) - 2Ghz
•
512MB RAM
•
2 GB of available physical disk space (NTFS)
Preparing the servers for use with GFI MailArchiver GFI MailArchiver requires a mail server from where to collect emails, such as Microsoft Exchange Server, and optionally a Microsoft SQL Server to store the archived emails. The following sections will show you how to prepare these servers for use with GFI MailArchiver. The section ‘Preparing Microsoft Exchange Server for use with GFI MailArchiver’ shows you how to enable journaling on the email store since this is required. This section also contains an optional part that shows you how to enable envelope journaling so that GFI MailArchiver can store the full email internet headers. The section ‘Preparing Microsoft SQL Server for use with GFI MailArchiver’ shows you how to configure and prepare Microsoft SQL Server for use with GFI MailArchiver by creating a new empty database.
6 • Installing GFI MailArchiver
GFI MailArchiver for Exchange
Preparing Microsoft Exchange Server for use with GFI MailArchiver To archive email from Microsoft Exchange Server, you will need to set up and configure a journaling mailbox. The Exchange Server journaling feature will use the journaling mailbox to store a copy of each email that passes through the server. GFI MailArchiver will then periodically check the journaling mailbox and archive any emails found. To set up journaling on the Exchange Server, follow these steps: 1. Create a new mailbox where you want Microsoft Exchange to journal emails. Do this by adding a new user in the Active Directory Users and Computers console. Give the mailbox a relevant name such as ‘journal’. 2. Open the Exchange System Manager and navigate to the Mailbox Store node by expanding Servers ` ` Storage Group. Right click on the Mailbox Store node and then click Properties. 3. In the Properties dialog go to the General tab and select the Archive all messages sent or received by mailboxes on this store check box.
Screenshot 1 - Enabling journaling on an Exchange mailbox store
GFI MailArchiver for Exchange
Installing GFI MailArchiver • 7
4. Click on the Browse button located to the right of the Archive all messages sent or received by mailboxes on this store check box. 5. In the Select Recipient dialog box, enter the journaling mailbox name you created in step one, for example ‘journal’, and click OK. NOTE: If you want to archive emails to a public folder, enter a public folder name in the Select Recipient dialog. However, note that Microsoft does not recommend using public folders as the journal recipient. More information is available in the following Microsoft Knowledge Base article, http://support.microsoft.com/?kbid=843105, (refer to question 6 in the question and answer section).
Screenshot 2 - Selecting the journaling mailbox name
6. Close the Mailbox Store Properties dialog and the Exchange System Manager management console. The Exchange Server journaling mailbox created is now ready for use with GFI MailArchiver.
Enabling Envelope Journaling (recommended) NOTE: If you want to archive email header information, you need to read this section to enable Exchange Envelope Journaling. If you do not want to archive email header information skip this section. GFI MailArchiver will still work correctly. Envelope Journaling is available in Exchange 2000 post Service Pack 3 and Exchange 2003 Service Pack 1. Exchange Envelope Journaling captures all the available RFC2821 recipients and all the RFC2822 recipients, including CC and BCC recipients. It also captures members of a distribution group expansion and it captures reports that include delivery receipts, NDRs, read receipts, and out-of-office notifications. For more information about Envelope Journaling, please visit this Microsoft web page: How Exchange Server Envelope Journaling Works. You can enable Envelope Journaling by using either one of these methods: 1. Use the Exchange Server Email Journaling Advanced Configuration (exejcfg.exe) tool. 2. Use the ADSI editor management console.
8 • Installing GFI MailArchiver
GFI MailArchiver for Exchange
Method 1: Using the exejcfg.exe tool To enable Envelope Journaling using the exejcfg.exe tool, follow these steps: 1. Open the command prompt. 2. Navigate to the folder in which you copied the exejcfg.exe tool. 3. To enable Envelope Journaling, type exejcfg –e and press Enter. NOTE 1: exejcfg –d disables Envelope Journaling for that organization. NOTE 2: You can download the exejcfg.exe tool from the following Microsoft web page: http://www.microsoft.com/downloads/details.aspx?FamilyID=e7f73f107933-40f3-b07e-ebf38df3400d&displaylang=en NOTE 3: You can use the exejcfg.exe tool downloaded from the above link in both Exchange 2000 and Exchange 2003 Server environments.
Method 2: Using the ADSI editor To enable Envelope Journaling using the ADSI editor, follow these steps: 1. Open the adsiedit.msc console. NOTE: You can find the adsiedit.msc tool in the Windows 2003 Server support tools and in the Windows 2000 Server resource kit.
Screenshot 3 - ADSI Edit
2. Navigate to the CN= node by expanding ADSI Edit ` Configuration ` `
GFI MailArchiver for Exchange
Installing GFI MailArchiver • 9
` . Right-click on the CN node and then click Properties. 3. In the properties dialog, select the heuristics attribute from the Attributes list and click the Edit button.
Screenshot 4 - Heuristics attribute
4. In the Integer Attribute Editor dialog, type 512 in the Value edit box and click OK.
Screenshot 5 - Editing the heuristics attribute value
5. The Value column for the heuristics attribute will be updated to reflect the new value of 512 in the Attributes list.
10 • Installing GFI MailArchiver
GFI MailArchiver for Exchange
Screenshot 6 - Heuristics value set to 512
6. Click OK to save the new setting and close the ADSIEdit console. Note: A value of 512 enables Envelope Journaling, and a value of 0 disables Envelope Journaling.
Preparing Microsoft SQL Server for use with GFI MailArchiver This section is optional, since GFI MailArchiver now supports archive stores based on the Firebird database. If you want to create archive stores based on Microsoft SQL Server, you need to follow the steps in this section to create a new empty database through the Enterprise Manager. NOTE 1: You must configure Microsoft SQL Server to use Mixed Authentication mode to be able to use it with GFI MailArchiver. To do so, load the Enterprise Manager, right-click on the SQL Server node and click Properties. In the properties dialog, access the Security tab and click SQL Server and Windows under Authentication. NOTE 2: Refer to the following Knowledge Base article for further information regarding the Microsoft SQL Server collation mode required: http://kbase.gfi.com/showarticle.asp?id=KBID002277
Creating the database 1. Open the SQL Server Enterprise Manager; navigate to and expand the SQL Server node on which you want to create the database.
GFI MailArchiver for Exchange
Installing GFI MailArchiver • 11
2. Right-click on the Databases node, and then click New Database.
Screenshot 7 - Creating a new database
3. In the Database Properties dialog box, type a name for the new database in the Name box, for example, 'MailArchiver', and then click OK. NOTE 1: For optimal performance, pre-allocate space for both the data and transaction files, for example, 500 MB for the data file and 50MB for the transaction file to avoid grow operations while archiving to the database, at least initially. To pre-allocate disk space, specify a value in the Initial size (MB) column. To further reduce slowdowns caused when Microsoft SQL Server performs a grow operation; you should set the file growth for both data and transaction files to a fixed value in megabytes, not more than 100 MB, instead of a percentage value. Additionally, ensure that the Maximum file size option is left to Unrestricted file growth for both data and transaction files. You can configure these settings from the Data Files and Transaction Log tabs of the Database Properties dialog box. NOTE 2: After the first month of archiving, note the database data file size. With this value, estimate the archive database size after six months, for example. If you estimate that your archive database will be larger than 20 GB, you should consider configuring the archive stores management feature of GFI MailArchiver. More information on this feature is available in the ‘Configuring archive stores management’ section of the ‘Configuring GFI MailArchiver’ chapter.
Installing GFI MailArchiver Before you install GFI MailArchiver, check the points below: 1. Make sure that you are logged on as Administrator or you are using an account with administrative privileges. 2. Save any pending work and close all open applications on the machine. 3. Check that the machine you are installing GFI MailArchiver on meets the system and hardware requirements specified earlier in this chapter.
12 • Installing GFI MailArchiver
GFI MailArchiver for Exchange
To install GFI MailArchiver follow these steps: 1. Run the GFI MailArchiver setup program by double-clicking on the MailArchiver4.exe file. The installation wizard will perform some unpacking operations and then display the Welcome page. Click Next to continue. 2. Read the license agreement displayed in the License agreement page and click I accept the terms in the license agreement if you accept the terms of the license agreement. Click Next to continue the installation.
Screenshot 8 - Entering the administrator email address and product license key
3. Type the administrator email address in the Administrator Email box. If you bought a license for GFI MailArchiver, type it in the License Key box. If you do not have a license yet and want to evaluate GFI MailArchiver, leave the default evaluation license key in the License Key box. Click Next to continue the installation. NOTE: When you use the evaluation license key, you will be able to use GFI MailArchiver for 10 days. If later you decide to buy GFI MailArchiver, you will not need to install GFI MailArchiver again – entering the purchased license key will be sufficient.. 4. To install GFI MailArchiver to the default location, click Next to continue. If you want to specify an alternative location where to install GFI MailArchiver, click Change and select a new installation path. Then click Next to continue with the installation. 5. Select the website where you want to install the GFI MailArchiver web interface from the Website list. In the Virtual Directory Alias box (set to ‘MailArchiver’ by default), type the name for the GFI MailArchiver web interface virtual folder. To continue with the installation click Next.
GFI MailArchiver for Exchange
Installing GFI MailArchiver • 13
Screenshot 9 - Selecting a Website and Virtual Directory
6. Click Install to start the installation of GFI MailArchiver with the settings you configured in the previous pages.
Screenshot 10 - GFI MailArchiver installation progress
7. The installation wizard displays the finish page when the installation completes. Click Finish to close the installation wizard.
Entering your license key after installation NOTE: Entering the license key should not be confused with the process of registering your company details on our website. This is important; since it allows us to give you support, and notify you of important product news. Register at http://customers.gfi.com
14 • Installing GFI MailArchiver
GFI MailArchiver for Exchange
If you purchased GFI MailArchiver, you need to enter your license key in the GFI MailArchiver configuration. To do this, follow these steps: 1. Click Start ` All Programs ` GFI MailArchiver ` GFI MailArchiver to load the GFI MailArchiver configuration in Internet Explorer. 2. When prompted for a user name and password, type in the username and password of an account that has administrative privileges, to access the GFI MailArchiver configuration. 3. Click on the GFI MailArchiver ` Configuration ` Licensing node, in the left navigation pane. 4. Type or paste the GFI MailArchiver license key you bought in the License key box, then click Verify License Key.
Screenshot 11 - Entering the GFI MailArchiver license key
5. If you entered the license key correctly, GFI MailArchiver displays the following information: The License Status, the number of Licensed Users, the count of Mail Enabled Users, and for how long GFI MailArchiver has been running next to the Statistics label. If the license key specified is invalid, GFI MailArchiver will display Invalid license key in red next to the License Key box. If you entered a valid license key, click Save Settings. NOTE 1: The license key you bought is licensed for a number of users as shown next to the Licensed Users label. The number of Mail Enabled Users must always be smaller than or equal to the number of Licensed Users the license supports. If not, GFI MailArchiver will continue to work for 15 more days until you buy a new license key, and then expire if a new license key is not specified. NOTE 2: GFI MailArchiver counts the number of mail enabled users differently, depending on the exclusion settings configured in the Archiving and User Exclude Options node. The following points describe how GFI MailArchiver counts mail enabled users in the three possible scenarios of: archiving emails for all users, archiving emails for all users except for the users specified and archiving emails only for the users specified. For the examples, we will consider an Active GFI MailArchiver for Exchange
Installing GFI MailArchiver • 15
Directory (AD) made up of 40 objects, 12 of which are mail-enabled users. •
Archiving emails for all users – GFI MailArchiver counts all the mail enabled user accounts. It does not count other objects such as groups or machines. GFI MailArchiver will thus display 12 near the Mail Enabled Users label.
•
Archiving emails for all users except for the users specified – GFI MailArchiver counts all mail enabled user accounts and subtracts the count of AD user accounts (not email addresses) specified in the list. Therefore, if you specified three AD user accounts and one email address for exclusion from archiving, GFI MailArchiver will display 9, near the Mail Enabled Users label.
•
Archiving emails only for the users specified – GFI MailArchiver counts the AD user accounts (not email addresses) specified for inclusion in archiving. Therefore, if you specified three AD users for inclusion in archiving, GFI MailArchiver will display 3, near the Mail Enabled Users label. Please note that if you specify even one email address for inclusion in archiving, GFI MailArchiver will count all AD mail enabled user accounts and thus will display 12 near the Mail Enabled Users label.
Updating a GFI MailArchiver 4 installation with a more recent build If you want to update your current installation of GFI MailArchiver 4 with a more recent build, follow these steps: 1. Run the GFI MailArchiver setup program by double-clicking on the MailArchiver4.exe file. The installation wizard will perform some unpacking operations and then display the Welcome page. Click Next to continue. 2. Follow the installation wizard on-screen instructions. 3. The installation wizard displays the finish page when the installation completes. Click Finish to close the installation wizard.
GFI MailArchiver 4 database schema updates If the build you are updating GFI MailArchiver 4 to, includes updates to the database schema, the installation wizard will inform you about this with the following screenshot. The installation will disable email collection and archiving from the mail servers configured, since GFI MailArchiver cannot use the databases until you perform the update procedure outlined below.
16 • Installing GFI MailArchiver
GFI MailArchiver for Exchange
Screenshot 12 - Database schema updates
When the installation completes you need to perform the following steps to update the database schema of the archive stores configured and re-enable email collection and archiving from the mail servers configured. 1. Access the GFI MailArchiver configuration as outlined in the ‘Introduction to the Configuration’ section of the ‘Configuring GFI MailArchiver’ chapter. 2. Click on the GFI MailArchiver ` Configuration ` Archive Stores node, in the left navigation pane. 3. Click the button, to the right of the archive store, to launch the Archive Store Wizard. 4. Go through the pages of the Archive Store Wizard by clicking Next until you reach the database verification page. Then click Yes to update the database schema.
GFI MailArchiver for Exchange
Installing GFI MailArchiver • 17
Screenshot 13 - Upgrade database schema
5. When the upgrade completes, the wizard displays Database verification successful. Click Next until you reach the wizard finish page. 6. Click Finish to close the wizard. 7. Repeat steps 3 to 6 for each archive store configured in the Archive Stores page. 8. Click Save Settings. 9. Click on the GFI MailArchiver ` Configuration ` Archive Stores Management node, in the left navigation pane. If you configured archive stores in this page, follow steps 10 to 15. If not, go to step 16. 10. Click the button, to the right of the archive store, to launch the Archive Store Wizard. 11. Go through the pages of the Archive Store Wizard by clicking Next until you reach the database verification page. Then click Yes to update the database schema. 12. When the upgrade completes, the wizard displays Database verification successful. Click Next until you reach the wizard finish page. 13. Click Finish to close the wizard. 14. Repeat steps 10 to 13 for each archive store configured in the Archive Stores Management page. 15. Click Save Settings. 16. You now need to re-enable email collection and archiving from the mail servers configured. To do so, click on the GFI MailArchiver ` Configuration ` Mail Servers to Archive node, in the left navigation pane. 17. Click the button, to the right of the mail server, to launch the Mail Server Wizard. 18. On the first page of the Mail Server Wizard, select the Archive emails from this server check box.
18 • Installing GFI MailArchiver
GFI MailArchiver for Exchange
19. Click Finish to close the wizard. 20. Repeat steps 17 to 19 for each mail server configured in the Mail Servers to Archive page. 21. Click Save Settings.
Upgrading a GFI MailArchiver 3 installation to GFI MailArchiver 4 NOTE: Before upgrading to GFI MailArchiver 4, make sure that you are running the latest build of GFI MailArchiver 3 (20060609). If not, first install the latest build of GFI MailArchiver 3, then upgrade to GFI MailArchiver 4. If you currently have a machine with GFI MailArchiver 3 installed, and you want to upgrade that installation to GFI MailArchiver 4, follow these steps: NOTE 1: Microsoft Access databases are no longer supported and will not be upgraded. NOTE 2: You can browse and search upgraded GFI MailArchiver 3 databases from GFI MailArchiver 4, but you will not be able to archive further data into them. NOTE 3: Databases configured in the database management feature of GFI MailArchiver 3 are not upgraded and will not be listed in the GFI MailArchiver 4 Archive Stores Management page. 1. Run the GFI MailArchiver setup program by double-clicking on the MailArchiver4.exe file. The installation wizard will perform some unpacking operations and then display the Welcome page. Click Next to continue. 2. Follow the installation wizard on-screen instructions. 3. The installation wizard will inform you that it will upgrade your current GFI MailArchiver installation and that you need to perform some post-installation steps to complete the upgrade process. The post-installation upgrade steps are outlined below and in the following Knowledge Base article: http://kbase.gfi.com/showarticle.asp?id=KBID002870 To continue with the upgrade process, click Next.
GFI MailArchiver for Exchange
Installing GFI MailArchiver • 19
Screenshot 14 - Upgrading the GFI MailArchiver 2 installation to GFI MailArchiver 3
4. The installation wizard displays the finish page when the installation completes. Click Finish to close the installation wizard.
Completing the GFI MailArchiver 3 to 4 upgrade process Once the installation completes you need to follow these steps to upgrade the GFI MailArchiver 3 databases and re-enable email collection and archiving from the mail servers configured. 1. Access the GFI MailArchiver configuration as outlined in the ‘Introduction to the Configuration’ section of the ‘Configuring GFI MailArchiver’ chapter. 2. Click on the GFI MailArchiver ` Configuration ` Archive Stores node, in the left navigation pane. In the Archive Stores page, you will see a default database created by the GFI MailArchiver 4 installation, and all the Microsoft SQL Server based GFI MailArchiver 3 databases found in the previous installation. 3. Click the button, for one of the GFI MailArchiver 3 databases listed. This will launch the Archive Store Wizard. 4. Go through the pages of the Archive Store Wizard by clicking Next until you reach the database verification page. Then click Yes to update the database schema. 5. When the upgrade completes, the wizard displays Database verification successful. Click Next until you reach the wizard finish page. 6. Click Finish to close the wizard. 7. Repeat steps 3 to 6 for each of the GFI MailArchiver 3 databases listed in the Archive Stores page. 8. Click Save Settings. 9. Click on the GFI MailArchiver ` Configuration ` Mail Servers to Archive node, in the left navigation pane. In the Mail Servers to Archive page, you will see the mail servers you configured and archived emails from in GFI MailArchiver 3. To give you time to 20 • Installing GFI MailArchiver
GFI MailArchiver for Exchange
configure where you want to archive emails before GFI MailArchiver 4 starts archiving emails to the default database, all the mail servers listed have archiving disabled. Thus, you now need to re-enable email collection and archiving from the mail servers configured. 10. Click the button, to the right of a mail server, to launch the Mail Server Wizard. 11. On the first page of the Mail Server Wizard, select the Archive emails from this server check box. 12. Click Finish to close the wizard. 13. Repeat steps 10 to 12 for each mail server configured in the Mail Servers to Archive page. 14. Click Save Settings. You have completed the upgrade process from GFI MailArchiver 3 to GFI MailArchiver 4. You can now browse through the emails previously archived by GFI MailArchiver 3 and any newly archived emails, by clicking on the GFI MailArchiver ` Conversations ` Browse node.
GFI MailArchiver for Exchange
Installing GFI MailArchiver • 21
