The following guide is designed to upgrade Framework MyNewHome.

Pre-Requisite Checklist

• Complete the Pre-Requisite Checklist Overview.
• Complete the Environment Setup Checklist Overview.
• The Framework ECM Upgrade must be complete.

Step 1 - Shutdown Framework ECM And MyNewHome

Before proceeding with the upgrade, Framework ECM and MyNewHome needs to be shutdown so that no user can access the system during the upgrade period.

Shutting down Framework MyNewHome logs users out of the system in an orderly fashion.

1. Open Framework Configuration Utility (Start > All Programs > Insula Software > Framework Configuration Utility)
2. Logon to the system.
3. Select the Shutdown tab.
   
   
   
    
4. Under the Framework Availability group, enter the Framework ECM shutdown details.
5. Click the Shutdown Framework button.
6. Under the MyNewHome Availability group, enter the MyNewHome shutdown details.
7. Click the Shutdown MyNewHome button.
8. Click the OK button.

Step 2 - Backup Framework MyNewHome Database

The following topic will backup your Framework MyNewHome (MNH) Database. This procedure is based on Microsoft SQL Server 2008. 

Backup Framework MNH Database

1. Open SQL Server Management Studio (Start > All Programs > Microsoft SQL Server 2008 > SQL Server Management Studio).
2. Connect to the required server.
3. In the Object Explorer pane, expand: [server name] > Databases
4. Right-click on the Framework MNH database (e.g., FworkSQLMNH) and select Tasks > Back Up. The Back Up Database (General Page) dialog will be displayed.

5. Specify a Name and Destination for the backup file, if different from the default name and destination details.

   Write down the name and destination details. 
6. Select the Options page.
7. Tick: Overwrite all existing backup sets
8. Tick: Verify backup when finished
9. Click the OK button. The backup will be performed to the selected destination.
10. Click the OK button to close the message prompt.
11. Close SQL Server Management Studio.
12. Browse to the backup location (as detailed in Point 5 above).
13. Copy the backup file to a secure location.

Step 3 - Upgrade Framework MyNewHome Database

The following procedure upgrades the Framework MNH database. If a failure in the Framework MNH Database Upgrade occurs, this could be due to the size of the database which may exceed the backup component limit of 2GBs of data. If the upgrade initially fails during the backup phase, a command line switch can be added to the upgrade executable file which will skip the automated backup process.

Framework MNH 7.0.0 Database Upgrade

1. Open Windows Explorer.
2. Browse to: \[fw folder]\Upgrade\Upgrade7_0_0_[xx]\MyNewHome\
3. Double-click the FworkMyNewHomeUpgrade.exe file. The Select Data Source dialog will be displayed.
4. Select the Machine Data Source tab.

5. From the Data Source Name column, select the Framework MyNewHome SQL database.

   Example

   FworkSQLMNH 
6. Click OK. The Start Upgrade confirmation prompt will be displayed.

7. Click Yes to perform the upgrade.

   • The first step in the upgrade procedure will take a backup of the upgraded tables and store the tables in a Microsoft Access database file (backup.mdb). This will be stored under a time-stamped folder indicating the date and time of the upgrade. For example, Backup 20120912_105719. This folder can be deleted once the upgrade has been completed.

   • If the initial backup of your data fails, see Framework ECM Database Upgrade (for Large Databases)
8. If the upgrade was successful, a successfully completed message prompt will be displayed.
9. Click OK.
10. Click Close.

Unsuccessful Database Upgrade

If the database was unsuccessful, restore the backup database file. Refer to your Microsoft SQL Server documentation for more information.

Step 4 - Update Framework MyNewHome

On all systems running Framework MyNewHome:

Uninstall The Existing Version Of Framework MyNewHome

In Microsoft Windows XP

1. Open Add or Remove Programs (Start > Control Panel > Add or Remove Programs). The Add or Remove Programs dialog will be displayed.
2. From the Currently Installed Programs list, select the previous version of Framework MyNewHome.
3. Click the Remove button. The application will be removed.

In Microsoft Windows Vista/Windows 7

1. Open Uninstall a Program (Start > Control Panel > Uninstall a Program). The Uninstall or Change a Program list will be displayed.
2. Select the previous version of Framework MyNewHome.
3. Click the Uninstall button. The application will be removed.

Install The Latest Version Of Framework MyNewHome

1. Open Windows Explorer.
2. Browse to: \[fw folder]\Setup\Framework MyNewHome\v6.3\Setup\
3. Double-click Framework MyNewHome.msi and follow the on-screen prompts.

Step 5 - Restart Framework ECM And MyNewHome

After finishing the database and system upgrade, Framework ECM and MyNewHome needs to be restarted so that users can access the system.

1. Open Framework Configuration Utility (Start > All Programs > Insula Software > Framework Configuration Utility)
2. Logon to the system.
3. Select the Shutdown tab.
   
   
4. Under the Framework Availability group, click the Restart Now button.
5. Under the MyNewHome Availability group, click the Restart Now button.
6. Click the OK button.

Step 6 - Test Framework MyNewHome

On all systems running Framework MyNewHome:

Start Framework MyNewHome

1. Start Framework MyNewHome (Start > All Programs > Insula Software > Framework MyNewHome).

   Double-click the Framework MyNewHome desktop icon.

2. Log on to the system.

Step 7 - User Acceptance Tests

The following is a list of view only tests that must be performed after upgrading the application.