EASRestoreService. Manual

Transcription

1 Manual

2 Introduction EAS is a powerful Archiving Solution for Microsoft Exchange, Lotus Notes, Sharepoint and Windows based File systems. As one of the Top 5 Enterprise Archiving Solutions worldwide is EAS very popular and it is quite conceivable that in a company merge Situation also 2 existing EAS Environments must be merged. This Document describe the Tool EASRestoreService as Part of the Tools4EAS Solution. Audience This Document is a technical driven Whitepaper and addressed to technical Personal that are familiar with EAS, Exchange and LDAP. What is EASRestoreService The EASRestoreService is written to help you to restore archived Content to PST Files automatically and well documented. The Tool contains 2 Files, the Service - EASUnarchiverService.exe and the Configuration Tool - EASRestoreService-Configurator.exe. The Configuration Tool is not mandatory. All Settings can be done without but it makes it much easier. Pre-Requirements The Only Prerequirements you need is to have: -.Net Framework 4.5 installed - Windows 7, 8, 8.1, Server R2 Version Operating System - A Valid License Key - Outlook 2010 (32bit) Installed without MAIL connectivity (!) only PST File. - An Account with Permission to access the EAS SQL Database - An Account with Permissions to access the EAS Document Stores Page 2 of 9

3 Preparation Database The tool is using the EAS Database to Store temporary Data. For this, additional Tables must be created on EAS Database. This can be done by this Command in SQL Administration Studio: CREATE TABLE [dbo].[exportconfig]([ewspath] [nvarchar](max) NULL,[EWSLOGIN] [nvarchar](50) NULL,[EWSPASSWD] [nvarchar](50) NULL,[EWSVERSION] [int] NULL) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY] CREATE TABLE [dbo].[exportfoldersexclude]([folderid] [int] NOT NULL) ON [PRIMARY] CREATE TABLE [dbo].[exportmsgs]([msgid] [bigint] NOT NULL,[USERID] [int] NOT NULL,[STATUS] [int] NOT NULL,[SERVER] [nvarchar](20) NULL,[PROCESS] [nchar](38) NULL,[ACCESSDATE] [nchar](25) NULL) ON [PRIMARY] CREATE TABLE [dbo].[exportuser]([userid] [bigint] NOT NULL,[EXPORTTYPE] [int] NOT NULL,[MAILADDRESS] [nvarchar](50) NULL,[FILEPATH] [nvarchar](max) NULL,[FILENAME] [nvarchar](50) NULL,[SERVER] [nvarchar](25) NULL,[PROCESS] [nchar](40) NULL,[ACCESSDATE] [nchar](25) NULL,[STATUS] [int] NOT NULL) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY] Service installation The Installation of the Service can be done by a command line (must be run with elevated privileges!): SC CREATE EASUnarchiverService binpath= c:\program Files\schroedl IT\ EASUnarchiver\EASUnarchiverService.exe [SC] CreateService SUCCESS This will create an Entry in the Service manager. You now can see this Service in Services.msc You must change the Credentials of the Service to a Domain Account with Permissions to the EAS Document Stores. This account automatically get the login as Service Permissions granted. Before you can start the Service, you must run the Config Tool to finish the Configuration. This also can be done manually, but this is advanced configuration and not documented in this Document. Page 3 of 9

4 Running the Tool The Configuration Tool can be executed by simply right click and select Run as Administrator. Elevated Privileges are required to write to the HKLM Realm in the Registry so running without elevated Privileges will cause in issues. First of all, the Connection to the EAS SQL Database is required. Therefore, you need to put in the Server name (including a Instance name if used) in the Server Field. If your Server require SQL Integrated Authentication instead of Windows Integrated Authentication you must activate the use SQL login Checkbox and insert Account / Password Data in the related Fields. The Database Table Prefix is if your EAS installation uses a dedicated Schema to connect. In older environments it was common to use easdbadmin instead of dbo. You can check if you need a Prefix by checking your EAS.INI in Database Section check if there is an entry for Table Prefix or DB Prefix. Page 4 of 9

5 Alternately you can check in SQL Management Studio if there is something else then dbo. In Front of your Table names: If you typed in the Server name and if required the DB login Data correctly, a list of existing Databases should appear in the Select EAS Database Field: Select your EAS Database here (Caution: the EAS DB must not be named EAS in your environment! It was also common to name them Archive or MailArchive or any other name!) After you select the right Database you can try to connect by pressing the connect button. If you use the right settings and the selected Database contains some EAS Specific Tables, the Red Dot not connected will change to green and show connection ok Page 5 of 9

6 In the PST Path and Name Area you can select your default Path for the PST Files and the Format, how the PST Files should be names. Warning! The PATH FOR PST Always must end with a backslash (\)! Filter Criteria The Filter Criteria Tab show you a list of all valid Folder names that are available for each user. You can exclude this Folders by selecting them and click the > Button. You also can remove them from the Exclusion list by selecting them on the right-hand-side List and click the < Button. The << button will remove all Folders from the exclusion List The Search Fields below the Lists will give you the ability to search for specific entry s and select them then. Caution! After you start the Migration process you should not remove folders in this way! This can cause issues! Page 6 of 9

7 Selected Users This Tab gives you the ability to select the Users you want to restore. You can select users and add or remove them analogic to the Filter Criteria Tab just be using the <, > and << buttons. You also have the same ability to search for specific users. The Number in the square bracket will show the EAS User ID near the Username. Page 7 of 9

8 User specified Filter Criteria Here you can specify the global settings in detail user by user. By default, all settings on this page are reflecting the Settings of the previous pages. You see the PST Filename and Folder reflecting the Settings of the First Page. If some Folder names are excluded in the general Filter Criteria (in this example Drafts ), you also will find this Folder in this section where you can remove it from the list. This gives you the ability to exclude some folders in general but abolish this selection for specific users. You also can add a minimum Date what Messages must be pass to be restored. After you finished all your Settings, you can leave this application and Save the settings by click the Exit button. Caution: Database related Criteria like Filters or User specific Settings will be stored after click on the Exit Button. So please be patient after clicking applying some of this settings can take more time then expected! Page 8 of 9

9 Now you can start the Service. The Progress of the Service is documented in different log files stored on the same Folder where the Executable is. Page 9 of 9