OMPMConfiguration and Use

10/22/2013Mphasis an HP CompanyAmritanshu

2

INDEX

1. What is OMPM 32. Usage and Steps to follow

Step 1 – Gather your dataStep 2 – Analyze your dataStep 3 – Do the work

3

3. OMPM ConfigurationSoftware RequirementsInstallation of Prerequisite SoftwareFolder Structure

5

4. Post install ConfigurationCreating DatabaseRunning OffScan.exeImporting Scanned FilesReading Reports

11

5. Bulk Conversion 166. Backup and Restore Database

Backup DatabaseRestore Database

17

3

What is OMPM• OMPM is a collection of tools that enables you to prepare an environment for

migration to Microsoft Office 2010. OMPM can be a very important part of an Office 2010 migration plan.

1. Scan Office 97 through Office 2003 files for conversion issues2. Scan for macro compatibility issues3. Create reports to help you analyze the scan data4. Store the scan data, and convert older Office files to the Office 2010 file formats

• OMPM checks for, and reports on, file properties and contents to help you analyze the environment and determine any issues that you might experience when you convert from Microsoft Office versions 97 through 2003 file formats to Office 2010 file formats.

Usage and Steps Important to note that OMPM major function is to report issues in the office files. And

it has only a very basic tool for bulk conversion of the office files (ofc.exe). Basically we are trying to find out low risk files and converting them.

1. Docs that haven’t been modified in n days (e.g., n =30)2. Docs that have only “green” conversion issues identified by OMPM3. Docs without any conversion issues identified by OMPM4. Docs that do not have macro issues identified by OMPM

OMPM Categorizes issues at 4 levelsRed, Yellow, Green, No Issues. “Green” or less are mostly benign and will most likely have no impact. Examples of such green issues are Excel files that use labels in formulas (which are automatically converted in Excel 2010) or have charts in them. “Yellow” or “Red” issues are potentially more severe, and conversion of such documents may result in data or functionality loss.

Example: English Language Formulas (ELFs) are turned on. ELFs have been removed in Excel 2010, but all ELFs will be changed to cell references so they can continue to work in Excel 2010.

4

Steps to follow:

Step 1 – Gather your data:

Identify network storage that contains Office documents Download the OMPM toolset Scan for Office documents on network storage using OffScan.exe, edit offscan.ini

accordingly Create an OMPM database Import the scan results in the OMPM database using ImportScans.bat

Step 2 – Analyze your data:

To determine which files are conversion candidates:

Use the OMPM reporting tool to create a “low risk” filter.

Example: WHERE MaxIssueLevelID > 2 AND DATEADD(d,-30,GETDATE()) > ModifiedDate AND FileID not in (SELECT FileID from Uv_FilterMacroIssue)

Execute a “low risk” SQL query in SQL Server Management Studio to retrieve file size data

Step 3 – Do the work:

To convert the conversion candidates:

Export the filtered list using the OMPM reporting tool Configure OFC.ini to use the filtered list and execute OFC.exe.

5

OMPM ConfigurationSoftware requirements:

1. AccessRuntime.exe (Microsoft Access runtime)2. SQLEXPRESS 2005 or SQLEXPRESS 2008R2 or SQL Express 2008 3. MigrationPlanningManager2010Update14. SQLXML5. Microsoft SQL Server 2005 backward compatibility (Optional)

For 64 bit

1. AccessRuntime.exe2. SQLEXPRESS 2005 or SQLEXPRESS 2008R2 or SQL Express 20083. MigrationPlanningManager2010Update14. sqlxml_x64.msi5. SQLServer2005_BC_x64.msi

Installation of Prerequisite Software

For test build requirement above applications were installed with default options.

1. AccessRuntime.exe

There is a requirement of installation of a database management system which can contain reports generated by the OMPM tool in the form of information. Microsoft Access runtime is installed to cater this requirement

Download Microsoft Access Runtime 2010 from below location

http://www.microsoft.com/en-us/download/details.aspx?id=10910

6

2. SQL Express

To access retrieve and query the data and make OMPM tool usable in client server model there is a requirement of SQL Express the database created by OMPM tool

Install any one of these

SQL Express 2005

SQL Express 2008

SQL Express 2008 R2

If SQL Express 2008 or SQL Express 2008 R2 is installed make sure Microsoft SQL Server 2005 backward compatibility is also installed with it. That is not required for SQL Express 2005

Download SQL Express 2005 from below location

http://www.microsoft.com/en-us/download/details.aspx?id=21844

Download SQL Express 2008 from below location

http://www.microsoft.com/en-us/download/details.aspx?id=1695

Download SQL Express 2008 R2 Sp2 from below location

http://www.microsoft.com/en-us/download/details.aspx?id=30438

Microsoft SQL Server 2005 Backward compatibility 8.05.1054 can be downloaded from below link

http://www.microsoft.com/en-us/download/details.aspx?id=24793

3. SQLXML

Since our scanned output will be XML files inside a cab file. There is a requirement for something which defines the use of XML in conjunction with SQL. SQLXML.msi is required to be installed for it.

Download Microsoft SQLXML 4.0 SP1 10.0.1600.60 from below location

http://www.microsoft.com/en-us/download/details.aspx?id=30403

7

OMPM INSTALLATION

Our main application MigrationPlanningManager2010Update1 is installed. OMPM is a collection of tools that enables you to prepare an environment for migration to Microsoft Office 2010. Basic input for this application is older version of Office files and output is assessment reports. This tool does the following:

Scan Office 97 through Office 2003 files for conversion issues Scan for macro compatibility issues Create reports to help you analyze the scan data Store the scan data, and convert older Office files into the Office 2010 file formats

8

Installation of MigrationPlanningManagerUpdate1 creates below folders.

Download OMPM installer MigrationPlanningManager2010Update1.exe from below location

http://www.microsoft.com/en-gb/download/details.aspx?id=11454

9

Folder Structure

Database Folder

Report Folder

SCAN Folder

10

SCANDATA Folder

TOOLS Folder

11

Post Install Configurations1. Creating Database

After installation of all above applications we need to create a database using below command

C:\OMPM\Database> CreateDB.bat .\SQLEXPRESS OMPMDBTORONTOHYDRO

Where Database name is OMPMDBTORONTOHYDRO and SQLEXPRESS is name of SQL Server installed.

2. Running OffScan.exe

Create a folder where all the older version office files are needed to be kept and scanned from. Copy all the Office files there. Update this location in Offscan.ini file (C:\OMPM\Scan\Offscan.ini)

Remove semicolon form “Folder” and change its value to the folder where Office files are copied.

In the environment created below value was given as below.

Folder= C:\Temp\TORONTOHYDRO\OMPMFILES

Scanning is done by running Offscan.exe either using command line or double clicking.

Scanned xml files will get created in C:\OMPM\SCANDATA inside a cab file along with a log file

12

3. Importing Scanned Files

Command used to import scanned report to the created database (OMPMDBTORONTOHYDRO)

C:\OMPM\SCAN> Importscans.bat .\SQLEXPRESS OMPMDBTORONTOHYDRO “C:\OMPM\SCANDATA”

Om successful completion of above command Cab file will get copied to OMPMImported folder

4. Reading Reports

Double click on OMPM.accdr

13

Click on OPEN

Click on CONNECT

On clicking on CONNECT an error might prompt as shown below

14

If error is prompting then change date and time format as shown below. This will resolve the issue

15

Click on Scanned Files tab.Final report will look like as shown in below screenshot

16

Individual Office files can be clicked to get detailed reports as shown below

BULK CONVERSION

Install Office Compatibility pack from location

http://www.microsoft.com/en-us/download/details.aspx?id=3

Changes in OFC.ini

1. LogDestinationPath=C:\OMPM\OFCLogs2. FileListFolder=C:\Temp\DataExport

Or [FoldersToConvert]fldr=C:\Temp\TORONTOHYDRO\OMPMFILES

Run command Ofc.exe “Path to Ofc.ini”

17

Steps to Backup a database from one machine and restore that Database to another machine

In case if reports are needed on a different machine or the whole report database needs to be moved to another machine. Simple copy pasting database file won’t work. Below steps are needed to follow.

1. Backup Database2. Copy backup file to another machine or network accessible to another machine3. Restore Database

BACKUP DATABASE

1. To create backup SQL Server Management Studio has to be installed.Install SQL Server management Studio 2008 R2 and then click on Shortcut as given below StartAll ProgramsMicrosoft SQL Server 2008SQL Server Management Studio

2. Give your server name and click on Connect to open the console

18

3. Right Click on Database you want to back up

4. Click on BACK UP

19

5. Choose Database Backup Type, Name, Description and Destination as below.

6. Click on OK

20

Below are the SQL commands which can be used instead.

1. For backup with 0 expiration days

BACKUP DATABASE [OMPMDBTORONTOHYDRO] TO DISK = N'c:\Program Files (x86)\Microsoft SQL Server\MSSQL10_50.SQLEXPRESS\MSSQL\Backup\OMPMDBTORONTOHYDRO.bak' WITH NOFORMAT, NOINIT, NAME = N'OMPMDBTORONTOHYDRO-Full Database Backup', SKIP, NOREWIND, NOUNLOAD, STATS = 10GO

2. For backup which expires after 50000 days

BACKUP DATABASE [OMPMDBTORONTOHYDRO] TO DISK = N'c:\Program Files (x86)\Microsoft SQL Server\MSSQL10_50.SQLEXPRESS\MSSQL\Backup\OMPMDBTORONTOHYDRO.bak' WITH DESCRIPTION = N'OMPM Database Full backup to be moved to another computer and run there.', RETAINDAYS = 50000, NOFORMAT, NOINIT, NAME = N'OMPMDBTORONTOHYDRO-Full Database Backup', SKIP, NOREWIND, NOUNLOAD, STATS = 10GO

Output will come with the name as DatabseName.bak at the location specified in destination filesThis file is Backup of the desired database. Copy this file to the location which is accessible from another computer.

RESTORE DATABASE

Requirement on another computer:

SQL Server Management Studio 2008 R2

SQL Express 2005

Access runtime

OMPM.accdr (OMPM reporting tool)

To read reports on OMPM.accdr above thngs should be installed and SQL Server should be configured.

21

1. Connect to SQL Server

2. Right Click on Database and then click on RESTORE DATABASE

3. Click on FROM DEVICE and browse for Backup Database.bak file.

22

4.

5. Click on OK

23

6. In “TO DATABASE” Field give name of your database, and check checkbox under “SELECT THE BACKUP SETS TO RESTORE”

7. Click on OK

24

8. Launch OMPM.accdr, connect to restored database through SQL Server and see the reports.