What is and how the Migration/Upgrade Wizard works?

book

Article ID: 181820

calendar_today

Updated On:

Products

Management Platform (Formerly known as Notification Server)

Issue/Introduction

 

Resolution

Question
What is and how the Migration/Upgrade Wizard works?

Answer

The Altiris Notification Server Migration Wizard is .NET 2.0 Windows Forms application that will guide the user through the upgrade process.

When you upgrade from Notification Server 6.x to Symantec Management Platform 7.0, you can migrate most of the Notification Server 6.x data. Symantec Installation Manager manages the installation and uses Altiris Notification Server Migration Wizard to manage the data migration.

Altiris Notification Server Migration Wizard helps you migrate Notification Server 6.x data to Symantec Management Platform 7.0. The Migration Wizard lets you export the 6.x data to a data store file. It then lets you import this data from the data store file into Symantec Management Platform 7.0.
The migration wizard lets you customize the data that you export and import. It uses exporters to export data and a corresponding set of importers to import data. Each product that has data to migrate has its own set of exporters and importers. When you export or import 6.x data, you can select the exporters or importers to use. You can also filter the data that an exporter or importer migrates. When you filter data, you select the specific data that you want to export or import.

Note: You cannot migrate managed computers.

When you migrate 6.x data, Symantec Installation Manager manages the migration process. With an on-box upgrade, it starts the migration wizard to export the data and later starts it to import the data. With an off-box upgrade, Symantec Installation Manager provides instructions for installing the migration wizard on the Notification Server 6.x computer. It also starts the migration wizard on the Symantec Management Platform 7.0 computer when you are ready to import the data.
The EXE for the migration wizard is NSUpgradeWizard.exe, and by default, it is in the C:\Program Files\Altiris\Upgrade directory. To run the migration wizard, you must be a member of the local administrators group.

The main components for this Migration/upgrade wizard are:

File Description
NSUpgradeWizard.exe This executable is the user interface module of the upgrade framework.
StoreBrowser.exe This executable is a utility that can be used to browse a data store.
Altiris.Datastore.dll This assembly contains the implementation of the data store.
Altiris.ImportExportEngine.dll This assembly contains the implementation of the core import/export engine.
NotificationServerUpgrade.config This configuration file contains the list of exporters and importers for the Notification Server.
Altiris.NS.Exporters.6.0.dll This assembly contains the implementations for the Notification Server exporters.
Altiris.NS.Importers.7.0.dll This assembly contains the implementations for the Notification Server importers.

A data store file stores Notification Server 6.x data. When you migrate Notification Server 6.x data to Symantec Management Platform, you first export the data to a data store file. You then import the data from the data store file into Symantec Management Platform 7.0. To export and import the data, you use Altiris Notification Server Migration Wizard.
By default, the data store file is saved in the C:\Program Files\Altiris\Upgrade\Data directory. It has an .adb extension, is easy to copy and back up, and is not dependent on SQL.
You can view the data in a data store file with the Store Browser. If you perform multiple imports, you can view the data to determine which data to import next. The data store file organizes the data by product. The data for each product is stored in tables. The name of each table is ProductName.TableName.

SIM Integration

When SIM is performing an upgrade of a 6.0 NS the following sequence of events will occur:

  • SIM will start the installation process
  • If it needs to do an upgrade, it will launch the upgrade wizard to perform a data export and exit.   
  • After the upgrade wizard has completed the data export, it will re-launch SIM.
  • SIM will then uninstall the NS 6 and install the NS 7.
  • SIM will then launch the upgrade wizard to perform a data import and exit. 
  • The upgrade wizard will then perform a data import and will launch the console at the specified Url.

The upgrade wizard will write an XML file containing the configuration of the products and the exporters or importers.

Migration/Upgrade Wizard Pages

The following section describes the various upgrade wizard pages.

Welcome Page

This is the welcome page for the upgrade wizard.



Basic Options Page

Use this page to select what type of data operation to perform.

This page allows the user to select what type of data operation to perform. Clicking next will cause the upgrade wizard to initialize the export/import engine.

Options

  • Export data to the file store. Specify that the upgrade wizard should export data from the Notification Server to the specified data store. If the data store already exists it will be overwritten.
  • Import data from the file store. Specify that the upgrade wizard should import data from the specified data store to the Notification Server.
  • Data Store. Specify the data store to either export data to or import data from.

Exporter Configuration Page

Use this page to specify the exporter configuration options. This page is displayed only when exporting data to the data store.

This page allows the user to refine what data is to be exported to the data store.



Options

  • Products. This lists the supported products that can export data. Each list entry corresponds to a product configuration file. A product and all of its exporters can be excluded from the export process by unchecking the product's checkbox.
  • Exporters. This lists the available exporters for the selected product that can export data. An exporter can be excluded from the export process by unchecking the exporter's checkbox.

The Filters button for each exporter will display the Filters dialog, which displays the available filters for that exporter. This dialog allows a user to further refine what data the particular exporter will export.

Importer Configuration Page

Use this page to specify the importer configuration options. This page is displayed only when importing data from the data store.

This page allows the user to refine what data is to be imported into the Notification Server.



Options

  • Products. This lists the supported products that can import data. Each list entry corresponds to a product configuration file. A product and all of its importers can be excluded from the import process by unchecking the product's checkbox.
  • Importers. This lists the available importers for the selected product that can import data. An importer can be excluded from the import process by unchecking the importer's checkbox.

The Filters button for each importer will display the Filters dialog, which displays the available filters for that importer. This dialog allows a user to further refine what data the particular importer will import.

Filters Dialog

This dialog displays the available filters for the selected exporter or importer.



Options

  • Filters. This lists the available filters for the selected exporter or importer. A filter can be excluded from the export/import process by unchecking the filter's checkbox.

The Details button for each filter will display the Filter Details dialog, which displays more information about the selected filter.

Filter Details Dialog

This dialog displays information about the selected filter.



Options

  • Name. The name of the filter.
  • Description. The filter's description.
  • Properties. This lists other properties that describe the filter. The properties that are listed here are those properties on the filter that have the FilterPropertyAttribute.

Product Readiness Page

This page displays the product readiness status of the machine that the migration is run on.

This page displays the following information:

  • Solution migration baseline. The wizard will check that the solutions that are to be migrated meet the minimum baseline requirements. The wizard will use the supported products defined in the product's upgrade configuration file and the SupportedProduct attribute on the exporter/importer types to determine if the minimum baseline requirements have been met. It will display information detailing which installed solutions do not meet the minimum requirements.
  • Solution migration coverage. The wizard will check that all the installed solutions have a valid migration path. If a solution is installed but does not have any exporters defined, a message will be displayed. This is to notify the user that data for this solution will not be exported. During the solution migration coverage check, the wizard will ignore any product that is marked as unsupported in the product's upgrade configuration file. This is so that any products that are end-of-life and cannot be migrated do not show up in the migration coverage check.

NoteThe user will still be able to continue with the migration process even if there are product readiness failures.

Product Readiness Information Dialog

This dialog displays information describing why a particular readiness check has failed.



Summary Page

This page displays a summary of the actions that are to be performed.

 

NoteThe default name has three parts: the word Store, the date, and the time. The data store extension must be .adb
For example:
Store_11-3-2009_14-1-50.adb.

Export / Import Progress Page

This page displays the progress of the export or import operation.



Options

  • Current Task. This displays the name and the progress of the current task.
  • Overall Progress. This displays the overall progress of the export/import.
  • Show Details. This option will display more details about the export/import.

Attachments