Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this page, you will learn how to transfer profiles from one environment to another.

This process includes exporting .profile files in MC package form, pre-TFS commit manipulations and importing the package in destination environment either via Message Center Editor or via  IWS. You can use IWS as an alternative to import packaged profiles.

Info
titleNote
This functionality requires Monitoring Tool v1.0.0.126 or higher and IWS v1.0.1.662 or higher.



Background Color
color#E0F0FF

Table of Contents
maxLevel2
printablefalse


Export Profiles

To export profiles:

  1. Launch the EJM Monitoring Tool.
    Image RemovedEJM Monitoring ToolImage Added
  2. Go to Select the Activities tab.
    EJM Monitoring Tool - Activities tabImage Modified
  3. Select profiles for migration (multiple selection is allowed).
    EJM Monitoring Tool - Selected ProfilesImage Modified
  4. Right-click the group to call the context menu and of selected profiles and then select Export Profile(s).
    Export Profiles right-click optionImage Modified
    Profile data will be then downloaded and Export Dialog will be displayedThe system downloads the profile data and displays the Export Dialog box.
    Export Dialog boxImage Modified
  5. In this step, you can uncheck clear the check boxes for unnecessary profiles to exclude them from the export.
    File preview is available in the right pane.
    Export Dialog box - Clear Check Boxes for Unneeded ProfilesImage Modified
  6. Click Next
    You will see the final dialog box, where you can enter the name for your MC package, provide an informative description, and select an export store folder for the package.
    Export Dialog box - Package Description and Store FolderImage Modified
    The export will have similar contents as follows:
    Documents Library for Export ExampleImage Modified
    • tpe folder – contains all data.
    • export.conf - Migration Wizard metadata – this file is used by IWS for importing (can be missing). Note: This file must be deleted before you copy the folder to TFS. 
    • eagle_iws_service_data_empty package – "fake" stream package used for importing by MCE data files without streams.
    • _*main.pkg package – main package, contains links to all data files and packages. This is the file you use to import exported data later. 


Commit to TFS

Assuming you are storing in source control (in this case, TFS), follow these steps:

  1. Before committing to TFS, rename one of the .pkg files to avoid conflict of names.
     
  2. Rename eagle_iws_service_data_empty.pkg to my_test_stream_package.pkg (for example).
  3. Open the *main.pkg file find the line with the old file name:
    <include>  <package>eagle_iws_service_data_empty</package></include>
  4. Enter the new name:
    <include>  <package>my_test_stream_package</package></include> 
  5. Delete the export.conf file. 
  6. As a result, your export folder should look like this:
    Documents Libarary for Export to my_test_stream_packageImage Added Image Removed
  7. Commit these 3 three items to TFS.

Import Profiles with Message Center Editor

To import profiles with Message Center Editor:

  1. Open Message Center Editor, go to Message Center Streams tab and click Import Stream to launch the import stream wizard.
    Eagle Message Center Editor - Import Stream optionImage Added
    You see the Import Stream wizard. Image RemovedNavigate
  2. Under Select package to import on server, navigate to the folder and select the main package file.
     Image RemovedImport Stream wizard - Select package file boxImage Added
    Image Removed
    Import Stream wizard - Import stream package pageImage Added
  3. Preview the content of the package you are about to import. You can choose to exclude some files on this stage - to do that, uncheck clear the check box next to their names.
     Image Added
  4. If you are prompted with information about eagle_iws_service_data_empty already existing, just click Yes to overwrite it. This stream is always used to import sources without streams links.
    You will also see csv-0.rsf file marked as missing in the list. It refers to eagle_iws_service_data_empty fake stream, so just ignore this message.
  5. Click Next.
    Image Added Image Removed
  6. Click Next and choose choose the Create stream(s) option. Click Next.
    Image Added Image Removed
  7. Click Finish.
    The process of import will start starts shortly.
    Image RemovedImport Stream wizard - Finish pageImage Added 
  8. To check your newly added profie(s) go to the Monitoring Tool - Activities tab.