Migrating Data using Heat Development Project

this is the recommended method for migrating data see the four ways to migrate data docid\ xtgsi12juvvrmrhtaj dy for a list of the ways to migrate data for information about using the ivanti service manager development project with packages that have been downloaded from the app store, see appendix d working with packages from the app store docid 5osbl7tf9d0yi6sgw6yoi about using the ivanti service manager development project to migrate data docid 4cdzr9ht uzme6dgkqbchcautions about the ivanti service manager development project docid 4cdzr9ht uzme6dgkqbchabout the ivanti service manager development project docid 4cdzr9ht uzme6dgkqbchusing the ivanti service manager development project to create a data package docid 4cdzr9ht uzme6dgkqbchusing the ivanti service manager development project to migrate a data package docid 4cdzr9ht uzme6dgkqbchabout metadata read only mode docid 4cdzr9ht uzme6dgkqbchexample migrating request offering changes by enabling the ivanti service manager development project docid\ otbpw2k5ppaxejsiiv wh about using the ivanti service manager development project to migrate data use the ivanti service manager development project in the ivanti service manager configuration console (not within the operations console) to create packages to migrate data from one instance of a tenant (such as staging) to another instance of a tenant (such as uat) in this way, you can pick and choose which data to migrate instead of migrating the entire system the ivanti service manager development project allows ivanti service manager to maintain a history of changes in metadata, validation data, configuration settings, and a few specific master data business objects it also allows you to package a unit of integral changes into a package for migration to another tenant instance cautions about the ivanti service manager development project the ivanti service manager development project gives you the ability to update the production instance of your tenant with configuration changes made in the staging instance of the tenant if these changes conflict in some way with your ivanti service manager system, they cannot be undone we recommend that you enable and use the ivanti service manager development project to migrate data, and that you do not switch between enabling and disabling the ivanti service manager development project see the four ways to migrate data docid\ xtgsi12juvvrmrhtaj dy for a list and description of the four different ways that you can migrate data we recommend that you plan and prepare for moving a package as described in this section we strongly encourage you to make a complete backup of the target tenant instance and to create a procedure for restoring the backup if need be if there is a problem with the uat instance of your tenant, you can restore it from the production instance of your tenant using the operations console, by refreshing the uat instance of your tenant if there is a problem with the production instance of your tenant, you need to restore the production instance of the tenant from the backup as quickly as possible using microsoft sql tools, as any transactions that are created in the production instance of the tenant after a backup and before a restore will be lost before you enable and use the ivanti service manager development project, check with support by visiting ivanti support team https //www ivanti com/support about the ivanti service manager development project limitations docid 4cdzr9ht uzme6dgkqbchterminology docid 4cdzr9ht uzme6dgkqbchabout using your named account to log in docid 4cdzr9ht uzme6dgkqbch limitations the ivanti service manager development project has not yet provided a way to validate package dependency you need to ensure that if you make a change that depends on another change, you migrate both changes before handing out a package for migration, determine whether the package is complete and self contained the package should contain all dependent changes not having all the required changes in the package may cause the system to fail when you migrate the package and you may have to restore the target system from the back up system you cannot use the ivanti service manager development project and simple mode or advanced mode at the same time (see the four ways to migrate data docid\ xtgsi12juvvrmrhtaj dy for a list and description of the four different ways that you can migrate data ) to use simple mode or advanced mode, you must disable the ivanti service manager development project you cannot use the ivanti service manager development project to migrate certain types of data for a list of the data that cannot be migrated, see items excluded from migration docid\ tc5gktag s5yzd m7hmyh terminology the ivanti service manager development project uses the following terms transaction an individual change to the database transaction set a group of transactions project a group of transaction sets package contains the transaction sets from multiple projects aspect information about a feature, a component, a patch, or even a configuration an aspect presence indicates the presence of the feature about using your named account to log in the first time that you log into ivanti service manager as an administrator, the system displays a message stating that you are logging in as an administrator this is not suitable for making configuration changes if you make configuration changes while logged in as an administrator, you may not be able to package the changes properly we recommend that you no longer use a generic administrator account when you are in the configuration console with the ivanti service manager development project, the ivanti service manager system tracks all the changes made and attributes them to the user who made the changes if all users log in using the generic administrator account, there is no way to know who made the changes the system displays a message stating that the configuration console is in production metadata read only mode if you see this message, click ok and then log out as an administrator and log back in using your named account see about metadata read only mode docid 4cdzr9ht uzme6dgkqbch using the ivanti service manager development project to create a data package see appendix c using the ism development project to migrate data docid\ oazckiixxshugjnkpasik for complete information about how to use the ivanti service manager configuration console to create packages, which can be used when migrating data you perform those tasks in the ivanti service manager configuration console and not in the operations console this is the same information that is found in the ivanti service manager online help and is only copied here for your convenience using the ivanti service manager development project to migrate a data package enabling the ivanti service manager development project docid 4cdzr9ht uzme6dgkqbchmigrating the package docid 4cdzr9ht uzme6dgkqbchchecking the data migration docid 4cdzr9ht uzme6dgkqbchdisabling the ivanti service manager development project docid 4cdzr9ht uzme6dgkqbch enabling the ivanti service manager development project to enable the ivanti service manager development project, follow these steps log in to the operations console and click the tenants tab navigate to the instance of the tenant for which you will perform the migration and click manage migration if the tenant is not part of a landscape, the system prompts you to add the tenant to a landscape to prepare it for migration click proceed the migration dashboard opens showing all of the tenants and tenant instances and available migration paths in the landscape to enable the ivanti service manager development project, click enable click ok at the confirmation prompt the migration dashboard looks like this for customers who have been using heat service management since release 2014 2 or earlier, you might not see the apply package link, even though you have enabled the ivanti service manager development project if you do not see the apply package link, refresh the staging instance of the tenant by following the process in creating the first staging or uat instance of the tenant from the production instance of the tenant docid\ nk99nfacluuwabumozwcu migrating the package to migrate a package from the staging instance to the production instance of a tenant, the package must be closed however, the package does not need to be closed if you are migrating from the staging instance to the uat instance of a tenant the system displays an informational message if you migrate the same package to the same tenant instance more than once to migrate a data package, do the following log in to the operations console and click the tenants tab navigate to the instance of the tenant for which you will perform the migration and click manage migration to migrate the data package, click apply package in the corresponding arrow the system displays the applying package to page enter selections as follows a select the name of the source package from the drop down menu b we highly recommend that you do not check skip target tenant backup c select apply without validation to apply the package without first validating it click execute to migrate the package or click preview to create an xml file with changes that you can review before you migrate the data click ok at the confirmation prompt when the migration is complete, the system displays a message that the package has been applied successfully when you refresh the staging or uat instances of the tenant, all transaction sets are cleared checking the data migration to check that the data migrated successfully, log in to the uat instance of the tenant and search for the changes log in to the ivanti service manager system for the uat instance of the tenant the system displays a message stating that the uat instance of the tenant is locked search for the changes disabling the ivanti service manager development project log in to the operations console and click the tenants tab navigate to the instance of the tenant for which you will perform the migration and click manage migration if the tenant is not part of a landscape, the system prompts you to add the tenant to a landscape to prepare it for migration click proceed the migration dashboard opens showing all of the tenants and tenant instances and available migration paths in the landscape to disable the ivanti service manager development project, click disable about metadata read only mode when you use the operations console to migrate data, the production and uat instances of the tenant are always in metadata read only mode, which is equivalent to being locked when the system is locked, you cannot make changes to most types of metadata in the configuration console (you can only make changes to the following four items saved searches, reports, quick actions, and dashboards ) while migrating data, the system temporarily unlocks the metadata on the target system you cannot import high impact packages if your system is in metadata read only mode to put a system into metadata read only mode, do the following log in to the operations console click tenant the system displays the tenants workspace find the tenant to edit and click edit properties check metadata locked click save