Release Notes P/N Rev 01

(1)

These release notes contain information about EMC SourceOne Email Management version 6.8 SP2. Topics include:

◆ Revision history ... 2

◆ New features and changes in 6.8 SP2 ... 3

◆ New features and changes in 6.8 SP1 ... 5

◆ New features and changes in 6.8... 7

◆ Environment and system requirements ... 11

◆ Updating the EMC SourceOne system... 12

◆ Fixed issues... 57

◆ Known issues and limitations ... 59

◆ Documentation ... 77

(2)

Revision history

The following table lists the revision history for these release notes. Table 1 Revision History

Revision

Number Date Description

(3)

New features and changes in 6.8 SP2

If you are upgrading directly to 6.8 SP2 from a release prior to EMC SourceOne Email Management 6.8, you should also review the following sections:

◆ “New features and changes in 6.8 SP1” on page 5. ◆ “New features and changes in 6.8” on page 7

This section describes the following new features and changes with the release of EMC SourceOne Email Management 6.8 SP2.

◆ “Delegate search changes” on page 3

◆ “Changes to EMC SourceOne console LDAP Server Configuration and Data sources dialogs” on page 3

◆ “Offline Access Kerberos authentication support” on page 4 ◆ “Fixed issues” on page 4

Delegate search changes

The behavior of delegate search permissions has changed for Microsoft Exchange/Outlook users. Refer to “Delegate search permission and behavior changes” on page 87 for details.

Changes to EMC SourceOne console LDAP Server Configuration and Data sources

dialogs

In previous versions of EMC SourceOne Email Management, it was possible to select the Directory server contains identities option on the Data Sources dialog when the directory server was not available, causing the LDAP query to fail.

(4)

Offline Access Kerberos authentication support

EMC SourceOne Offline Access by default uses Microsoft Windows NT LAN Manager (NTLM) authentication. In some cases, you may want to change the authentication protocol used by Offline Access to be Kerberos authentication instead of NTLM.

Refer to the EMC SourceOne Offline Access Release Notes, Version 6.8 SP2, for details on configuring this type of authentication.

Fixed issues

(5)

New features and changes in 6.8 SP1

This section describes the following new features and changes with the release of EMC SourceOne Email Management 6.8 SP1:

◆ “Updated shortcut capabilities added to EMC SourceOne Email Management” on page 5

◆ “Auditing and Reporting added for EMC SourceOne Discovery Manager” on page 5

Updated shortcut capabilities added to EMC SourceOne Email Management

EMC SourceOne users can now specify multiple mapped folders in which to attempt to locate the messages to be shortcut and if the message is not found to archive it in another specified mapped folder. This change is shown on the Mapped Folders page used by the Shortcut - Historical and Shortcut - Microsoft Exchange Public Folder activities.

Refer to the EMC SourceOne Email Management Administration Guide for more information.

Auditing and Reporting added for EMC SourceOne Discovery Manager

EMC SourceOne Email Management 6.8 SP1 includes auditing and reporting support for EMC SourceOne Discovery Manager 6.8 SP1: ◆ To support this feature, you must update to:

• EMC SourceOne Email Management 6.8 SP1. Refer to “Updating the EMC SourceOne system” on page 12. • Discovery Manager 6.8 SP1. Refer to “Updating Discovery

Manager” in the EMC SourceOne Discovery Manager Version 6.8

SP1 Release Notes.

◆ You must assign the ALTER permission on the Discovery

Manager 6.8. SP1 database to the EMC SourceOne security group. This additional permission is required for the automatic

partitioning of the new Discovery Manager database tables. Refer to “Configure SQL permissions” in the EMC SourceOne Discovery

(6)

◆ A new Discovery Manager Search Activity report is available for installation and viewing on SQL Server Reporting Services. Refer to:

• EMC SourceOne Email Management Version 6.8 SP1 Installation

Guide, “Installing EMC SourceOne Reporting”

• EMC SourceOne Email Management Version 6.8 SP1

Administration Guide, “Auditing and Reporting”, “Running

Reports”, Customizing Reports”, and “Troubleshooting Reports”

◆ The EMC SourceOne Email Management software kit has been reorganized:

• The SourceOne Reports setup program (ES1_Reports_Setup.bat) is located in: ES1_CDRom\Setup\Reporting\EMC SourceOne • The Discovery Manager Reports setup program

(7)

New features and changes in 6.8

This section describes the following new features and changes in EMC SourceOne Email Management 6.8.

◆ “Auditing and reporting for EMC SourceOne Email Management” on page 7

◆ “Discovery Manager express edition” on page 8 ◆ “Microsoft Office 365 journaling” on page 10

◆ “Microsoft Exchange Public Folder support” on page 10 ◆ “EMC Cloud Tiering Appliance integration” on page 10 ◆ “SMTP address reuse” on page 10

Auditing and reporting for EMC SourceOne Email Management

EMC SourceOne Email Management now supports auditing and reporting.

◆ Reporting is an optional feature. To install EMC SourceOne reports, refer to the EMC SourceOne Email Management Installation

Guide.

◆ To configure auditing of search operations and to run reports, refer to the EMC SourceOne Email Management Administration

Guide.

Auditing features EMC SourceOne Email Management audits the following information:

◆ All search operations that were performed using the

Administrator search type, and if configured, selected search operations for specified users and document details.

(8)

Auditing reports Audit information is stored in the EMC SourceOne Activity database and can be viewed in EMC SourceOne reports. The following audit reports are available:

◆ Search Audit reports - Search Activity, Search Copy, Search Delete, Search Restore, Documents Copied, Documents Deleted, Documents Restored, Documents Viewed

◆ Configuration reports - Mapped Folder Permissions Audit, Mapped Folder Effective Permissions

Discovery Manager express edition

Starting with this release, there are two editions of Discovery Manager:

◆ Express edition – The express edition of Discovery Manager is included with EMC SourceOne Email Management.

Administrators, supervisors, and compliance officers can use the express edition for quick search and export.

◆ Full edition – The full edition of Discovery Manager is an add-on product to the EMC SourceOne Email Management product used to search for, collect, review, and export archived email in response to legal or regulatory notice, or corporate policy complaint.

IMPORTANT

!

(9)

Table 2, “Differences between Discovery Manager editions,” summarizes the differences between the two editions of Discovery Manager. For complete information, refer to the EMC SourceOne

Discovery Manager 6.8 User Guide.

Changes to software kits

The following Discovery Manager components are now in the Email Management software kit:

◆ Database scripts and database installer

◆ New: Discovery Manager Server for express edition (ES1_DiscoveryMgrExpressServerSetup.exe) ◆ Discovery Manager client

◆ Discovery Manager backup scripts

Note: The Discovery Manager Worker Services software is now installed as part of the Email Management Worker Services software.

The following Discovery Manager components are in the Discovery Manager software kit:

◆ Discovery Manager Server for full edition Table 2 Differences between Discovery Manager editions

Discovery Manager, express edition

Discovery Manager, full edition

All components are in the SourceOne Email Management software kit.

Some components are in the SourceOne Email Manage-ment software kit. Other components are in the Discovery Manager software kit.

Included with Email Management license; no additional license required.

Requires an additional license.

Some application-wide user roles are available, plus the new Search & Export role.

All application-wide and matter-specific user roles are available, plus the new Search & Export role. Only the new Personal Matter is available, one

for each user.

Both Personal Matters and standard matters are available.

Some parts of the user interface are available. All parts of the user interface are available, as appropriate for the user role.

Some export formats are available (PST and NSF).

(10)

◆ Utilities (DMIdentity, DMCollect, DMCustodian) Installing and using Discovery Manager express edition

To install Discovery Manager express edition, refer to:

◆ EMC SourceOne Discovery Manager Installation and Administration Guide

◆ EMC SourceOne Discovery Manager Release Notes

To use Discovery Manager express edition, refer to the

EMC SourceOne Discovery Manager User Guide or online help.

Microsoft Office 365 journaling

EMC SourceOne Email Management now supports journaling of Microsoft Office 365 email content using the Journal activity.

Microsoft Exchange Public Folder support

EMC SourceOne Email Management now supports archiving and shortcutting of Microsoft Exchange public folder content using the following activities:

◆ Archive - Microsoft Exchange Public Folder

◆ Shortcut - Microsoft Exchange Public Folder activities.

EMC Cloud Tiering Appliance integration

EMC Cloud Tiering Appliance optimizes network-attached storage (NAS) infrastructure by moving inactive data to lower-cost tiers of storage, reclaiming primary storage capacity. EMC SourceOne Email Management now supports integration with the EMC Cloud Tiering Appliance (CTA) by allowing the administrator to launch CTA consoles from within the EMC SourceOne console.

SMTP address reuse

EMC SourceOne now supports the reuse of SMTP addresses. Refer to “Configuring SMTP Address Reuse” in the EMC SourceOne Email

(11)

Environment and system requirements

These release notes cover the EMC SourceOne Email Management product. For information on environment and system requirements, refer to the following documents:

◆ EMC SourceOne Email Management Installation Guide

◆ EMC SourceOne Products Compatibility Guide

For information on localization issues, refer to the EMC SourceOne

Version 6.8 Localized Product Release Notes.

All documentation for general releases is available on the EMC Powerlink® Web site (registration required) at:

(12)

Updating the EMC SourceOne system

This section provides an overview of the process for updating the following products:

◆ EMC SourceOne Email Management

◆ EMC SourceOne Discovery Manager (full edition) This section includes the following topics:

◆ “Important considerations” on page 12 ◆ “Supported update scenarios” on page 13 ◆ “Update scenario details” on page 14

Important considerations

Note the following:

◆ The Email Management software kit includes the EMC SourceOne core components required for all additional EMC SourceOne products.

(13)

Supported update scenarios

Table 3, “EMC SourceOne product update details,” describes supported update scenarios.

Table 3 EMC SourceOne product update details

Product Details

EMC SourceOne Email Management You can update EMC SourceOne Email Management to the 6.8 SP2 release from the following versions:

• 6.5 SP2 (and any hot fix version) • 6.6 (any service pack and hot fix version) • 6.7 (any service pack and hot fix version) • 6.8 Controlled Release (and any hot fix version) • 6.8 (and any hot fix version)

• 6.8 SP1 (and any hot fix version)

Note: Use the appropriate update procedure based on the version of

EMC SourceOne Email Management from which you are updating. Refer to

“Update scenario details” on page 14.

EMC SourceOne Discovery Manager You can update EMC SourceOne Discovery Manager to the 6.8 SP2 release from the following versions:

• 6.5 SP2 (and any hot fix version) • 6.6 (any service pack and hot fix version) • 6.7 (any service pack and hot fix version) • 6.8 Controlled Release (and any hot fix version) • 6.8 (and any hot fix version)

• 6.8 SP1 (and any hot fix version)

Note: Use the appropriate update procedure based on the version of

EMC SourceOne Email Management from which you are updating. Refer to

(14)

Update scenario details

The specific update procedures differ depending on the version of EMC SourceOne Email Management that you are updating to version 6.8 SP2.

Updating from version 6.5 SP2 or 6.6

If you are updating from EMC SourceOne Email Management version 6.5 SP2 or 6.6, you must meet some additional indexing related prerequisites which were first introduced with version 6.6 SP1. Use the update procedures provided in “Updating from version 6.5 SP2 or 6.6” on page 15 to update to version 6.8 SP2.

Updating from version 6.6 SP1 or higher

If you are updating from version 6.6 SP1 or higher, the indexing prerequisites introduced in that version have already been met. Use the update procedures provided in “Updating from version 6.6 SP1 or higher” on page 36 to update to version 6.8 SP2.

Updating Discovery Manager (express edition)

Information on updating Discovery Manager (express edition), which was introduced as part of the Email Management software kit with version 6.8, is included in the appropriate update instructions for Email Management:

• “Updating from version 6.5 SP2 or 6.6” on page 15 • “Updating from version 6.6 SP1 or higher” on page 36 Updating Discovery

Manager (full edition)

Information on updating Discovery Manager (full edition) is integrated into each update procedure above as a convenience for sites that have both products and prefer to upgrade both products at once. Full release notes for Discovery Manager are provided in the

(15)

Updating from version 6.5 SP2 or 6.6

This section describes how to update from EMC SourceOne

Email Management and Discovery Manager (if used) version 6.5 SP2 or 6.6 to version 6.8 SP2.

IMPORTANT

!

If you are updating from EMC SourceOne Email Management and Discovery Manager (if used) version 6.6 SP1 or higher, a separate procedure is provided. Refer to “Updating from version 6.6 SP1 or higher” on page 36.

This section includes the following topics:

◆ “Reviewing indexing changes for this release” on page 15 ◆ “Preparing for the update” on page 17

◆ “Updating the EMC SourceOne databases” on page 26 ◆ “Updating EMC SourceOne server and client software” on

page 32

◆ “Next steps” on page 35

Reviewing indexing changes for this release

This release includes important changes related to indexing. Overview Previous versions of the product performed some index processing

over the network which may have resulted in performance and latency issues. Beginning with this release, EMC SourceOne now performs all indexing locally on the Native Archive computer. To support this requirement, you must now allocate a local directory with at least 20 GB of space on all Native Archive indexing computers to serve as a temporary space for indexing. This directory:

◆ Must be regarded as a local drive by the operating system. ◆ Can not be the operating system drive (e.g., C:).

◆ Can be on local disk or SAN storage, as long as it is regarded as a local drive by the Native Archive server.

(16)

Previous versions EMC SourceOne already required a temporary space (called the EMC SourceOne Work directory) with a minimal amount of free disk space (1 GB) as part of the Master, Worker and Native Archive installs. For Native Archive servers, this work directory included a subdirectory dedicated to index processing called ExIndexWork.

Meeting the new prerequisite

Before you can upgrade to Email Management version 6.8 SP2, you must run a verification utility on all Native Archive servers currently configured with the indexing role verify the required temporary space is allocated. If a Native Archive server is not validated, the database update required as part of the upgrade will not be allowed. Most installations will include one or both of the following scenarios. Scenario 1: Verify existing work directory meets the prerequisite Run the utility to verify that the existing EMC SourceOne Work directory (which includes the ExIndexWork directory) has at least 20GB of free disk space. In many cases, this may already be true. Scenario 2: Move the index work directory to meet the prerequisite

Run the utility to designate a new Index Work directory that is separate from the EMC SourceOne Work directory on a drive with at least 20GB of free disk space. The utility updates the Archive database with the new location information.

Prerequisite verification utility

For each Native Archive server configured with the indexing role, you must run the Native Archive Local Indexing Prerequisite Verification utility.

Details

The utility will inspect the current drive on which the EMC SourceOne Work (and ExIndexWork subdirectory) is located and determine if it has the minimum amount of free disk space required (20 GB). ◆ If space is sufficient, the utility reports success.

◆ If the space is insufficient, the utility alerts you of the deficiency and allows you to create a new Index Work directory by

specifying a new folder path for a drive with adequate space. This enables you to easily move the Index Work directory to another drive. Details:

– The utility updates the Archive database with the new drive and folder location that you specify.

(17)

– The new folder is not created in the file system until the first index run is performed after the upgrade is completed. Completing all verifications

The utility can provide a list of the remaining unverified Native Archive servers so that you can track remaining verifications. You must successfully run the utility on all Native Archive servers currently configured with the indexing role before you can continue with the upgrade.

Enabling the indexing role post-upgrade

You do not need to run the utility on Native Archive servers which are not configured with the indexing role. If you later decide to enable the indexing role on a Native Archive server, you will need do one of the following:

◆ Manually verify that the existing EMC SourceOne Work\ExIndexWork directory has 20 GB of free space.

◆ Use the utility to move the Index Work directory to another drive with 20 GB of free space.

Refer to the information about configuring Native Archive roles in the EMC SourceOne Email Management Administration Guide for details about ensuring the required temporary space is allocated.

Preparing for the update

Perform the following tasks before updating the EMC SourceOne system to EMC SourceOne 6.8 SP2:

◆ “Determine the Index Work directory location” on page 17 ◆ “Stop Native Archive services” on page 18

◆ “Run the prerequisite verification utility” on page 18 ◆ “Estimate database update time” on page 20

◆ “Communicate update impact to users” on page 24 Determine the Index Work directory location

(18)

Since you are required to run a verification utility to ensure the minimum free disk space is available, you can ensure the utility runs successfully by determining the directory location ahead of time: ◆ In many cases, the existing location of the EMC SourceOne Work

(and ExIndexWork subdirectory) may have sufficient space and the utility will simply validate the configuration.

◆ If the existing location disk space is insufficient, you can use the utility to move the Index Work directory to a different drive. Stop Native Archive services

Before running the utility, use the Services console to stop the following Native Archive services:

◆ EMC SourceOne Administrator ◆ EMC SourceOne Archive ◆ EMC SourceOne Indexer ◆ EMC SourceOne Query

Note: Stopping the EMC SourceOne Administrator service stops the other three services.

Run the prerequisite verification utility

You run the Native Archive Local Indexing Prerequisite Verification utility from the command line for each Native Archive server configured with the indexing role.

You do not need to run the utility on Native Archive servers which are not configured with the indexing role. If you later decide to enable the indexing role on a Native Archive server, you will need to manually ensure the required space is available. Refer to “Enabling the indexing role post-upgrade” on page 17 for details.

IMPORTANT

!

If you want the flexibility to enable the index role in the future, you should ensure now that all Native Archive servers have the

necessary disk space. Permissions

You must be logged in with an account which has adequate

(19)

Command line parameters

The command line parameters for the

ES1_IndexPrereqVerifier.exe utility are described in the table below.

Procedure

1. Locate the ES1_IndexPrereqVerifier.exe utility in the software kit (in the Utility\Index folder) and copy it to the Native Archive indexing server.

2. Open a command prompt and navigate to the utility location. You can use the command and switches as follows:

a. To verify the drive on which the Index Work directory (e.g., E:\EMC SourceOne Work\ExIndexTemp) currently resides has enough free disk space to meet the storage prerequisites, type: ES1_IndexPrereqVerifier

The utility retrieves current work directory location from the EMC SourceOne Archive database and checks that it meets the 20 GB space requirement.

If the space requirement is met, the following message is displayed:

This Native Archive Index Server qualifies for upgrade.

If the validation fails, you can do one of the following: Table 4 ES1_IndexPrereqVerifier command line parameters

Command Example Description

ES1_IndexPrereqVerifier ES1_IndexPrereqVerifier Verifies the current server ES1_IndexPrereqVerifier

-ChangeIdxTempDir path

ES1_IndexPrereqVerifier -ChangeIdxTempDir F:\new_workdir

Changes the current Index Work directory to a new lo-cation. If the directory does not exist, it will be created. ES1_IndexPrereqVerifier

-ListUnverifiedServers

ES1_IndexPrereqVerifier -Lis-tUnverifiedServers

Lists any remaining Native Archive servers which have not yet been verified. ES1_IndexPrereqVerifier -? ES1_IndexPrereqVerifier -? Provides help text for the

(20)

– Free up space by removing unnecessary files from the drive.

– Use the utility to move the Index Work directory to a drive which has adequate free disk space.

b. To change the Index Work directory location from its current location to a new location, type:

ES1_IndexPrereqVerifier -ChangeIdxTempDir drive:\path

For example:

ES1_IndexPrereqVerifier -ChangeIdxTempDir F:\IndexWork

When this command is issued:

– The utility updates the Archive database with the new drive and folder location that you specify.

– The previous Index Work directory location is no longer used by the product.

– The new folder is not created in the file system until the first index run is performed after the upgrade is completed. c. To determine which Native Archive servers have not yet met

the prerequisite, type:

ES1_IndexPrereqVerifier -ListUnverifiedServers 3. Repeat this procedure on the remaining Native Archive indexing

servers. Estimate database update time

The database update scripts for the Activity and Archive databases include an update analysis report which provide detailed database statistics and a time estimate for completing the database update based on your specific environment. Details:

◆ Depending on your database environment, running each update analysis report can take time.

◆ To avoid unnecessary downtime when preforming the analysis, you can run the update analysis reports without completely quiescing EMC SourceOne (e.g., only pausing activities)

(21)

◆ To ensure an accurate estimate, you should plan on performing the actual database update within 24 hours of running the update analysis report.

IMPORTANT

!

Follow the instructions carefully and DO NOT update the databases yet. Updating the databases while EMC SourceOne is still running will cause serious problems.

Pausing activities

The estimation will consume some SQL Server resources which can impact running EMC SourceOne activities. You must pause current activities while performing the estimation:

1. In the EMC SourceOne console, select the Organizational Policies node.

2. In the Organizational Policies area:

a. Expand the organizational policy that contains the activity you want to pause.

b. Select the activity. 3. Select Action > Pause.

In the Organizational Policies area, the status of the activity changes from Active to Paused.

Estimating EMC SourceOne Activity database update time To estimate the time required to update the Activity database used by EMC SourceOne, do the following:

1. Log in to the SQL Server host computer using an account with local administrator permissions on the SQL Server host computer and the SQL sysadmin role.

Note: For details on why sysadmin permissions are required, refer to the “SQL database installation permissions” section in the Pre-installation Activities chapter of the EMC SourceOne Email Management Installation Guide. 2. Navigate to the Database\Activity directory on the EMC

SourceOne software kit.

(22)

4. Run the batch file (ES1_ActivityDB_Update_mssql.bat) on the database server from the command line prompt and respond to the prompts:

D:\scripts> ES1_ActivityDB_Update_mssql.bat

EMC SourceOne 6.82 Activity Database Update Program 5. Enter the name of the SQL Server server computer on which the

EMC SourceOne databases are installed in response to the prompt. If you press Enter, the default, localhost, is used. Specify SQL Server for Activity database (default: localhost):

Note: If you are using a named instance, enter the SQL Server name and instance in the following format: hostname\instance

6. Enter the name you assigned to the activity database when you installed EMC SourceOne. If you press Enter, the default, ES1Activity, is used as the activity database name.

Specify Activity Database Name (default: ES1Activity): 7. Choose Y to display an update analysis report which displays

database statistics and a time estimate for completing the update. Display database statistics and upgrade estimates? (Y/N default:Y):

8. Choose N to view the log file, as the estimation information will display in the console.

View log file (Y/N)? (default: N)

A log file detailing analysis results will be produced in the directory containing the update script. The log file is appended each time the update script is run. Do not delete the log file. 9. The script outputs an analysis report.

10. Review the update analysis information. You are prompted to perform the database update:

Upgrade the database (Y/N)? (default: Y)

IMPORTANT

!

(23)

11. Choose N and exit the console.

Estimating EMC SourceOne Native Archive database update time

To estimate the time required to update the Native Archive database used by EMC SourceOne, do the following:

Note: For details on why sysadmin permissions are required, refer to the “SQL database installation permissions” section in the Pre-installation Activities chapter of the EMC SourceOne Email Management Installation Guide. 2. Navigate to the Database\Archive directory on the EMC

3. Copy the contents of the Archive directory to the database server computer.

4. Run the batch file (ES1_ArchiveDB_Update_mssql.bat) on the database server from the command line prompt and respond to the prompts:

D:\scripts> ES1_ArchiveDB_Update_mssql.bat

EMC SourceOne 6.82 Archive Database Update Program 5. Enter the name of the SQL Server server computer on which the

EMC SourceOne databases are installed in response to the prompt. If you press Enter, the default, localhost, is used. Specify SQL Server for Archive database (default: localhost):

6. Enter the name you assigned to the archive database when you installed EMC SourceOne. If you press Enter, the default, ES1Archive, is used as the activity database name.

Specify Archive Database Name (default: ES1Archive): 7. Choose Y to display an update analysis report which displays

(24)

Display database statistics and upgrade estimates? (Y/N default:Y):

A log file detailing analysis results will be produced in the directory containing the update script. The log file is appended each time the update script is run. Do not delete the log file. 9. The script outputs an analysis report.

Upgrade the database (Y/N)? (default: Y) IMPORTANT

!

DO NOT update the databases yet. Updating the databases while EMC SourceOne is still running will cause serious problems. 11. Choose N and exit the console.

Resuming activities To resume a paused activity: 1. Select the activity. 2. Select Action > Resume. Communicate update impact to users

While the update occurs, client-generated activities such as shortcut retrieval and search requests will not function. You should

communicate a planned outage to reduce the number of client requests while the update occurs.

Prepare systems for update

This section describes how to prepare EMC SourceOne systems for update. If your environment includes EMC SourceOne Discovery Manager, the procedure for preparing these systems is also included. See the following topics:

(25)

Preparing Discovery Manager systems (if used)

Perform the following steps to prepare the EMC SourceOne Discovery Manager systems for the update:

1. Use the Discovery Manager backup process to quiesce the Discovery Manager system:

a. Install and configure backup scripts and customize the scripts for your environment.

b. Suspend Discovery Manager.

c. Wait for all Discovery Manager activities to complete.

Note: Specific instructions for performing these steps are provided in the “Performing a Backup of Discovery Manager” chapter of the EMC SourceOne Discovery Manager Installation and Administration Guide.

2. Wait for all Discovery Manager activities to complete. Depending on the Discovery Manager activities which are currently running, this could take a significant amount time (up to several hours in some cases).

Preparing EMC SourceOne systems

Perform the following steps to prepare the EMC SourceOne systems for the update:

1. Perform a backup of the EMC SourceOne system as described in the EMC SourceOne Email Management Administration Guide. 2. Stop all active jobs using the EMC SourceOne console as follows:

a. Expand the EMC SourceOne > Organizational Policies node. b. Right-click each policy and select Stop.

c. Expand the EMC SourceOne > Operations > Job Management node.

d. Observe that all jobs in the Jobs (Active) view are stopped.

Note: Client requests (such as jobs generated by users performing searches) will also be listed in this view. These requests can remain in an active state. End users will experience a service interruption until the systems are running again.

(26)

5. Stop all EMC SourceOne services on all computers on which EMC SourceOne components are installed. However, if you are running the master computer in an active/passive cluster, do the following:

• Do not manually stop the master services (EMC SourceOne Job Scheduler and EMC SourceOne Address Cache). • From the cluster administration console, take the EMC

SourceOne Job Scheduler and EMC SourceOne Address Cache resources “offline”. This ensures that the master services are no longer running on either node.

6. Close the Services console if it is open.

Updating the EMC SourceOne databases

You must update the databases before updating the rest of the EMC SourceOne system.

Database scripts You use batch files to update the schema and stored procedures in the EMC SourceOne databases as described in the following sections: ◆ “CNAME/SQL Server alias considerations” on page 26 ◆ “Before you begin” on page 27

◆ “Update the Activity database” on page 27 ◆ “Update the Archive database” on page 29

◆ “Update the Discovery Manager database (if used)” on page 31

Note: The Search database does not need to be updated. Therefore, no update batch file is provided.

CNAME/SQL Server alias considerations

Review the following considerations to determine if they apply to your environment:

◆ “Upgrade issues if using SQL Server CNAME configuration in certain scenarios” on page 60

(27)

Before you begin

Ensure that you completed the following procedures before continuing:

◆ “Run the prerequisite verification utility” on page 18 ◆ “Estimate database update time” on page 20

◆ “Communicate update impact to users” on page 24 ◆ “Prepare systems for update” on page 24

Update the Activity database

To update the Activity database used by EMC SourceOne, do the following:

Note: For details on why sysadmin permissions are required, refer to the “SQL database installation permissions” section in the Pre-installation Activities chapter of the EMC SourceOne Email Management Installation Guide. 2. Navigate to the Database\Activity directory on the EMC

3. Copy the contents of the Activity directory to the database server computer.

(28)

Specify Activity Database Name (default: ES1Activity): 7. Choose N when prompted to display an update analysis report

which displays database statistics and a time estimate for completing the update.

Note: You should have already run the analysis report earlier in the update process as described in “Estimate database update time” on page 20.

8. Choose (Y or N) whether you want to view the log file which is created after the update. If you choose N, the log file will not open after the update is complete. The log file

(ES1_ActivityDB_Update_mssql.bat.log) is created in the same directory in which you placed the database update scripts. View log file (Y/N)? (default: N)

9. You are prompted to perform the database update: Upgrade the database (Y/N)? (default: Y) 10. Choose Y. Update progress information is displayed. 11. Review the resulting messages to ensure that the update

completed successfully.

• If the following messages are displayed, the update was successful:

[Date/Time]:SourceOne 6.82 Activity Database update program finished

• The following message is displayed if there was a problem; check the ES1_ActivityDB_Update_mssql.bat.log file for additional information:

(29)

• An error message is displayed if you did not successfully run the Native Archive Local Indexing Prerequisite Verification utility as described in “Run the prerequisite verification utility” on page 18.

You must successfully run the utility and then re-run this database update script.

12. Review the log file (ES1_ActivityDB_Update_mssql.bat.log). The file is generated in the temporary directory where you placed the database update scripts.

Update the Archive database

To update the Native Archive database used by EMC SourceOne, do the following:

Note: For details on why sysadmin permissions are required, refer to the “SQL database installation permissions” section in the Pre-installation Activities chapter of the EMC SourceOne Email Management Installation Guide. 2. Navigate to the Database\Archive directory on the EMC

(30)

Specify Archive Database Name (default: ES1Archive): 7. Choose N when prompted to display an update analysis report

(ES1_ArchiveDB_Update_mssql.bat.log) is created in the same directory in which you placed the database update scripts. View log file (Y/N)? (default: N)

[Date/Time]:SourceOne 6.82 Archive Database update program finished

• The following message is displayed if there was a general problem; check the file for additional information:

Errors encountered during Archive Database update process. Please check log files for errors and re-run the update.

• The following message is displayed if you did not successfully run the Native Archive Local Indexing Prerequisite

(31)

ERROR:Native Archive Index Prereq tool validation check failed. Native Archive Index Prereq tool must be run before database upgrade.

You must successfully run the utility and then re-run this database update script.

12. Review the log file (ES1_ArchiveDB_Update_mssql.bat.log). The file is generated in the temporary directory where you placed the database update scripts.

Update the Discovery Manager database (if used)

To update the EMC SourceOne Discovery Manager database, do the following:

2. Navigate to the Setup\Database directory on the EMC SourceOne Discovery Manager software kit.

3. Copy the contents of the Database directory to the database server computer

4. Run the batch file (ExDisCo_Update_mssql.bat) on the database server from the command line prompt and respond to the prompts:

D:\scripts> ExDisCo_Update_mssql.bat

EMC SourceOne 6.82 Discovery Manager Database Update Program

5. Enter the name of the SQL Server server computer on which the Discovery Manager database is installed in response to the prompt. If you press Enter, the default, localhost, is used. Specify SQL Server for Discovery Manager database (default: localhost):

(32)

(ExDisCo_Update_mssql.bat.log) is created in the same directory in which you placed the database update scripts. View log file (Y/N)? (default: N)

8. The database update begins. Review the resulting messages to ensure that the update completed successfully.

[Date/Time]:SourceOne 6.82 Discovery Manager Database update program finished

• The following message is displayed if there was a problem; check the file for additional information:

Errors encountered during Discovery Manager Database update process. Please check log files for errors and re-run the update.

9. Review the log file (ExDisCo_Update_mssql.bat.log). The file is generated in the temporary directory where you placed the database update scripts.

Updating EMC SourceOne server and client software

For EMC SourceOne MSI-based installations, you must run each installation executable on all applicable computers in your configuration.

Guidelines Follow these guidelines when performing the update: ◆ Ensure the installations are run using the accounts and

permissions used in the original installation. Refer to the EMC

SourceOne Email Management Installation Guide for more

information.

(33)

IMPORTANT

!

Although some MSI software installations generate a dialog stating “You must restart the system” upon completion, you must defer restarting the system until all EMC SourceOne software has been installed on that computer. Once all components have been installed for that specific computer, restart the system.

Procedure Run the installation executables on each of the applicable computers on which the corresponding software is already installed:

1. Ensure that you have updated the database stored procedures (see “Updating the EMC SourceOne databases” on page 26). 2. Update Master Services software (ES1_MasterSetup.exe). To

install on both nodes of an active/passive cluster: a. Update the software on the active node. b. Fail over to the passive node (making it active). c. Update the software on the second node.

3. Update the console application (ES1_ConsoleSetup.exe). 4. Uninstall previous versions of the Discovery Manager Worker

Services software.

IMPORTANT

!

As of version 6.8, the worker functionality related to Discovery Manager is now installed as part of the Email Management Worker Services software. If you have not already, you must uninstall previous versions of the Discovery Manager Worker Services software before you update the Email Management Worker Services software to 6.8 or higher.

(34)

6. Update Web Services software (ES1_WebServicesSetup.exe). 7. Update Native Archive software (ES1_ArchiveSetup.exe).

Note: If a warning related to East Asian Language Pack displays, refer to

“Microsoft Visual C++ 2005 SP1 Redistributable” on page 63.

8. Restart the systems on which you installed the Web Services software.

Note: The Search, Mobile Services, Discovery Manager Server (if used), Extensions for OWA, and Extensions for IBM Lotus Domino (which you will upgrade in the steps that follow) check for communication with the Web Services IIS site during the upgrade.

9. Update Search software (ES1_SearchSetup.exe).

10. Update Mobile Services software (ES1_MobileSetup.exe). 11. Update Discovery Manager Server (if used) software.

• If you are using the full edition of Discovery Manager, run the ES1_DiscoveryMgrServerSetup.exe provided in the

Discovery Manager software kit.

• If you are using the express edition of Discovery Manager, run the ES1_DiscoveryMgrExpressServerSetup.exe provided in the Email Management software kit.

12. Determine if you are required to update the EMC SourceOne extensions software on your mail servers.

• Extensions software for your mail servers is no longer part of the Email Management software kit, and is provided in separate kits which you download from the SourceOne Email Management software downloads area on Powerlink.

• In some cases, it may not be necessary to update the extensions software, as the previously-released version is supported with the current version of EMC SourceOne Email Management software.

(35)

13. Update EMC SourceOne software installed on your mail servers (as applicable):

• Extensions for Outlook Web Access for Microsoft Exchange 2003 (ES1_OWA2003Setup.exe)

• Extensions for IBM Lotus Domino – For Microsoft Windows platforms

(ES1_DominoExtSetup.exe or ES1_DominoExtSetupx64.exe)

– For non-Windows platforms - To update the installation, run the scripts provided in the new kit. When you re-run the scripts, all Domino databases created for EMC

SourceOne will remain intact. Refer to the EMC SourceOne

Email Management Installation Guide for details on running

the scripts for these platforms. 14. Update client software:

• ONM Viewer (ES1_ONMViewerSetup.exe). • Discovery Manager client software (if used)

(ES1_DiscoveryMgrClientSetup.exe)

Note: The Discovery Manager client software is now in the Email Management software kit.

Next steps

(36)

Updating from version 6.6 SP1 or higher

This section describes how to update from EMC SourceOne

Email Management and Discovery Manager (if used) version 6.6 SP1 or higher to version 6.8 SP2.

IMPORTANT

!

If you are updating from EMC SourceOne Email Management and Discovery Manager (if used) version 6.5 SP2 or 6.6, a separate procedure is provided. Refer to “Updating from version 6.5 SP2 or 6.6” on page 15.

This section includes the following topics: ◆ “Preparing for the update” on page 36

◆ “Updating the EMC SourceOne databases” on page 44 ◆ “Updating EMC SourceOne server and client software” on

page 49

◆ “Next steps” on page 52

Preparing for the update

Perform the following tasks before updating the EMC SourceOne system to EMC SourceOne 6.8 SP2:

◆ “Estimate database update time” on page 36 ◆ “Communicate update impact to users” on page 42 ◆ “Prepare systems for update” on page 42

Estimate database update time

The database update scripts for the Activity and Archive databases include an update analysis report which provide detailed database statistics and a time estimate for completing the database update based on your specific environment. Details:

◆ Depending on your database environment, running each update analysis report can take time.

(37)

◆ Running the update analysis report allows you to determine the amount of planned downtime to expect for the databases updates to take place.

◆ To ensure an accurate estimate, you should plan on performing the actual database update within 24 hours of running the update analysis report.

IMPORTANT

!

Follow the instructions carefully and DO NOT update the databases yet. Updating the databases while EMC SourceOne is still running will cause serious problems.

Pausing activities

The estimation will consume some SQL Server resources which can impact running EMC SourceOne activities. You must pause current activities while performing the estimation:

1. In the EMC SourceOne console, select the Organizational Policies node.

2. In the Organizational Policies area:

a. Expand the organizational policy that contains the activity you want to pause.

b. Select the activity. 3. Select Action > Pause.

In the Organizational Policies area, the status of the activity changes from Active to Paused.

Estimating EMC SourceOne Activity database update time To estimate the time required to update the Activity database used by EMC SourceOne, do the following:

Note: For details on why sysadmin permissions are required, refer to the “SQL database installation permissions” section in the Important

(38)

2. Navigate to the Database\Activity directory on the EMC SourceOne software kit.

Specify Activity Database Name (default: ES1Activity): 7. Choose Y to display an update analysis report which displays

(39)

Upgrade the database (Y/N)? (default: Y)

IMPORTANT

!

DO NOT update the databases yet. Updating the databases while EMC SourceOne is still running will cause serious problems. 11. Choose N and exit the console.

Estimating EMC SourceOne Native Archive database update time

(40)

Considerations chapter of the EMC SourceOne Email Management Installation Guide.

2. Navigate to the Database\Archive directory on the EMC SourceOne software kit.

Specify Archive Database Name (default: ES1Archive): 7. Choose Y to display an update analysis report which displays

(41)

A log file detailing analysis results will be produced in the directory containing the update script. The log file is appended each time the update script is run. Do not delete the log file. 9. The script outputs an analysis report similar to the following.

Upgrade the database (Y/N)? (default: Y) IMPORTANT

!

(42)

Resuming activities To resume a paused activity: 1. Select the activity. 2. Select Action > Resume. Communicate update impact to users

While the update occurs, client-generated activities such as shortcut retrieval and search requests will not function. You should

communicate a planned outage to reduce the number of client requests while the update occurs.

Prepare systems for update

This section describes how to prepare EMC SourceOne systems for update. If your environment includes EMC SourceOne Discovery Manager, the procedure for preparing these systems is also included. See the following topics:

◆ “Preparing Discovery Manager systems (if used)” on page 42 ◆ “Preparing EMC SourceOne systems” on page 43

Preparing Discovery Manager systems (if used)

Perform the following steps to prepare the EMC SourceOne Discovery Manager systems for the update:

1. Use the Discovery Manager backup process to quiesce the Discovery Manager system:

a. Install and configure backup scripts and customize the scripts for your environment.

b. Suspend Discovery Manager.

Note: Specific instructions for performing these steps are provided in the “Performing a Backup of Discovery Manager” chapter of the EMC SourceOne Discovery Manager Installation and Administration Guide.

(43)

Preparing EMC SourceOne systems

Perform the following steps to prepare the EMC SourceOne systems for the update:

1. Perform a backup of the EMC SourceOne system as described in the EMC SourceOne Email Management Administration Guide. 2. Stop all active jobs using the EMC SourceOne console as follows:

a. Expand the EMC SourceOne > Organizational Policies node. b. Right-click each policy and select Stop.

c. Expand the EMC SourceOne > Operations > Job Management node.

d. Observe that all jobs in the Jobs (Active) view are stopped.

Note: Client requests (such as jobs generated by users performing searches) will also be listed in this view. These requests can remain in an active state. End users will experience a service interruption until the systems are running again.

3. Close the EMC SourceOne console. 4. Close any other open MMC consoles.

5. Stop all EMC SourceOne services on all computers on which EMC SourceOne components are installed. However, if you are running the master computer in an active/passive cluster, do the following:

• Do not manually stop the master services (EMC SourceOne Job Scheduler and EMC SourceOne Address Cache). • From the cluster administration console, take the EMC

SourceOne Job Scheduler and EMC SourceOne Address Cache resources “offline”. This ensures that the master services are no longer running on either node.

(44)

Updating the EMC SourceOne databases

You must update the databases before updating the rest of the EMC SourceOne system.

Database scripts You use batch files to update the schema and stored procedures in the EMC SourceOne databases as described in the following sections: ◆ “Update the Activity database” on page 44

◆ “Update the Archive database” on page 46

◆ “Update the Discovery Manager database (if used)” on page 48

Note: The Search database does not need to be updated. Therefore, no update batch file is provided.

CNAME/SQL Server alias considerations

Review the following considerations to determine if they apply to your environment:

◆ “Upgrade issues if using SQL Server CNAME configuration in certain scenarios” on page 60

◆ “Upgrade issues if using SQL aliasing in certain scenarios” on page 61

Before you begin Ensure that you completed the procedures in “Preparing for the update” on page 36 before continuing:

Update the Activity database

To update the Activity database used by EMC SourceOne, do the following:

(45)

Specify Activity Database Name (default: ES1Activity): 7. Choose N when prompted to display an update analysis report

(ES1_ActivityDB_Update_mssql.bat.log) is created in the same directory in which you placed the database update scripts. View log file (Y/N)? (default: N)

(46)

10. Choose Y. Update progress information is displayed. 11. Review the resulting messages to ensure that the update

[Date/Time]:SourceOne 6.82 Activity Database update program finished

• The following message is displayed if there was a problem; check the ES1_ActivityDB_Update_mssql.bat.log file for additional information:

Errors encountered during Activity Database update process. Please check log files for errors and re-run the update.

12. Review the log file (ES1_ActivityDB_Update_mssql.bat.log). The file is generated in the temporary directory where you placed the database update scripts.

Update the Archive database

To update the Native Archive database used by EMC SourceOne, do the following:

2. Navigate to the Database\Archive directory on the EMC SourceOne software kit.

(47)

5. Enter the name of the SQL Server server computer on which the EMC SourceOne databases are installed in response to the prompt. If you press Enter, the default, localhost, is used. Specify SQL Server for Archive database (default: localhost):

Specify Archive Database Name (default: ES1Archive): 7. Choose N when prompted to display an update analysis report

(ES1_ArchiveDB_Update_mssql.bat.log) is created in the same directory in which you placed the database update scripts. View log file (Y/N)? (default: N)

(48)

• The following message is displayed if there was a general problem; check the file for additional information:

Errors encountered during Archive Database update process. Please check log files for errors and re-run the update.

12. Review the log file (ES1_ArchiveDB_Update_mssql.bat.log). The file is generated in the temporary directory where you placed the database update scripts.

Update the Discovery Manager database (if used)

To update the EMC SourceOne Discovery Manager database, do the following:

2. Navigate to the Setup\Database\DiscoveryManager directory on the EMC SourceOne Email Management software kit.

Note: The Discovery Manager database scripts and batch files are now in the Email Management software kit.

3. Copy the contents of the DiscoveryManager directory to the database server computer.

4. Run the batch file (ExDisCo_Update_mssql.bat) on the database server from the command line prompt and respond to the prompts:

D:\scripts> ExDisCo_Update_mssql.bat

EMC SourceOne 6.82 Discovery Manager Database Update Program

5. Enter the name of the SQL Server server computer on which the Discovery Manager database is installed in response to the prompt. If you press Enter, the default, localhost, is used. Specify SQL Server for Discovery Manager database (default: localhost):

(49)

6. Enter the name you assigned to the Discovery Manager database when you installed Discovery Manager. If you press Enter, the default, DiscoveryManager, is used as the database name. Specify Discovery Manager Database Name (default: DiscoveryManager):

(ExDisCo_Update_mssql.bat.log) is created in the same directory in which you placed the database update scripts. View log file (Y/N)? (default: N)

8. The database update begins. Review the resulting messages to ensure that the update completed successfully.

[Date/Time]:SourceOne 6.82 Discovery Manager Database update program finished

• The following message is displayed if there was a problem; check the file for additional information:

Errors encountered during Discovery Manager Database update process. Please check log files for errors and re-run the update.

9. Review the log file (ExDisCo_Update_mssql.bat.log). The file is generated in the temporary directory where you placed the database update scripts.

Updating EMC SourceOne server and client software

For EMC SourceOne MSI-based installations, you must run each installation executable on all applicable computers in your configuration.

Guidelines Follow these guidelines when performing the update: ◆ Ensure the installations are run using the accounts and

permissions used in the original installation. Refer to the EMC

SourceOne Email Management Installation Guide for more

(50)

◆ Use the same values (account names, passwords, file shares, and so on) which were provided in the original installation. The installation programs will detect most values entered during the original installation, as many of these values are stored in the EMC SourceOne databases. If prompted, provide the same values provided in the original installation.

IMPORTANT

!

Although some MSI software installations generate a dialog stating “You must restart the system” upon completion, you must defer restarting the system until all EMC SourceOne software has been installed on that computer. Once all components have been installed for that specific computer, restart the system.

Procedure Run the installation executables on each of the applicable computers on which the corresponding software is already installed:

1. Ensure that you have updated the database stored procedures (see “Updating the EMC SourceOne databases” on page 44). 2. Update Master Services software (ES1_MasterSetup.exe). To

install on both nodes of an active/passive cluster: a. Update the software on the active node. b. Fail over to the passive node (making it active). c. Update the software on the second node.

3. Update the console application (ES1_ConsoleSetup.exe). 4. If present, uninstall previous versions of the Discovery Manager

Worker Services software.

IMPORTANT

!

As of version 6.8, the worker functionality related to Discovery Manager is now installed as part of the Email Management Worker Services software. If you have not already, you must uninstall previous versions of the Discovery Manager Worker Services software before you update the Email Management Worker Services software to 6.8 or higher.