2012 08 07 ste migration manager

8/13/2019 2012 08 07 STE Migration Manager

http://slidepdf.com/reader/full/2012-08-07-ste-migration-manager 1/83

Sam Sriramadhesikan

7th August 2012

Migration Manager



2

Agenda

Introduction Architecture

Migration tasks

What’s new in Maximo 7.5 Migration Manager Migration Coections

!sa"iit# im$ro%ements

&ogging and 'rou"eshooting

(esources



)

What is Migration Manager*

+ision and sco$e, Con-iguration migration "etween Maximo

en%ironments at same reease e%e

/re$roduction to $roduction

Su$$ort standard roout en%ironments

+3'S'3/(4!C'I4

/ur$ose,

Seed a new $roduct en%ironment with a the con-igurations created -or

a $articuar cient $roduction roout

/eriodica# $romote con-igurations im$emented a-ter initia roout

6irst reeased with Maximo 7.1.0



5

Con-iguration A$$ications

Maximo roout in%o%es more con-iguration than e%er"e-ore

6ewer customi9ations :coding;

More user acce$tance testing

Maximo 5.2 Maximo 6.2.1 Maximo 7.x

< Securit#

< Work-ow

< Screen esigner < ata"ase Con-iguration

< (e$orts

< A$$ication esigner

< omains

< Sets

< Cron 'asks

< Communication 'em$ates

< scaations

< nhanced Securit#

< nhanced Work-ow< ata"ase Con-iguration

< nhanced (e$orts

< nter$rise Ser%ices

< Channes

< &ogging

< S#stem /ro$erties

< Condition x$ressions

< A$$ication esigner

< omains

< Sets

< Cron 'asks

< Communication 'em$ates

< scaations

< nhanced Securit#

< nhanced Work-ow

< nhanced Integration

< ata"ase Con-iguration

< nhanced (e$orts

Configuration applications in Maximo



=

In 7.x reease> migration -ocus is on,

S#stem Con-iguration

Integration

Su$$orted 8ase Ser%ices con-igurations

Securit#

(e$orting

Queries *

Start Center Templates

System Properties

Logging

Domains

Database Configuration

Application Designer

Communication Templates Actions

Roles

Escalations

Workflo Designer

Cron Task Setup

E!mail Listeners

"b#ect Structures

Automation Scripts *

Security $roups

%sers

Launc& in Conte't

Publis& C&annels

(n)ocation C&annels

Enterprise Ser)ices

En Points

Web Ser)ice (nteractions *

Web Ser)ices Library *

E'ternal Systems

Sets

"rgani+ations

Calenars

People

Person $roups

Conitional E'pression ,anager

-P( ,anager

Report Aministration

? Added in Maximo 7.5



Architecture Migration Manager e%erages '$ae -rameworks

M84 -ramework

Integration -ramework

Migration Manager -ramework

A$$ication

Content@'a"es

A$$ication

Content@'a"es

/ackages

M&documents

Ba%a "usinesso"ects

6ied and a$$ication %aidations

x$ort Im$ort

A $ $ i c a t i o n S e r

% e r


http://slidepdf.com/reader/full/2012-08-07-ste-migration-manager 8/83D

Migrating $roduct con-igurations

/roduct con-igurations are treated as content 'wo t#$es o- content,

Content in data"ase

Content outside data"ase

Content in data"ase

'#$ica# ta"es and records in the Maximo schema

Maximo enca$suation o- a ta"e, Maximo 8usiness 4"ect :M84;

Content outside data"ase '#$ica# -ies on -ie s#stem

Must "e "uit into an nter$rise Archi%e :A(; and de$o#ed into

a$$ication ser%er


http://slidepdf.com/reader/full/2012-08-07-ste-migration-manager 9/83E

4rgani9ing ata"ase Content 4"ect Structures andMigration Frou$s

Workflow

Process

Comm Templates

Roles

Actions

WFPROCESSWFNODE

WFTASK WFASSIGNENTWFSTARTWFSTOPWFINP!TWFACTIONWFINTERACTION

WFWAIT"ISTWFCONDITIONWFNOTIFICATIONWFS!#PROCESS

COTEP"ATECOTP"TSENDTOCOTEP"TDOCS

A$RO"E

ACTION ACTIONGRO!P

Maximo ta"es@M84s 4"ect Structure Migration grou$

S%stem

Application

Data Dictionar%

e$endent Frou$s



10

4rgani9ing Content outside the data"ase

6ies that must "e $art o- Maximo A( e$o#ed into the a$$ication ser%er

< .cass> .ar> .$ro$erties> .xm

Caed Gcom$ied sources’ Muti$e Gcom$ied source’ -ies can "e consoidated into

HI/ -ie -or migration



11

Content migrated in $ackages

Tar&et pro'(ct instanceSo(rce pro'(ct instance

/ackage

/ackage is a container -or $roduct con-iguration content

/ackage has a i-ec#ce $ackage is,

e-ined

Created

istri"uted

e$o#ed

Define Create Distri)(te Deplo%



12

'#$es o- $ackages

Sna$shot JAs isK con-iguration in-ormation coected -or a $ackage on demand

/ackage de-ined a-ter the -act

Change

Con-iguration in-ormation coected o%er a $eriod o- time

< Inserts> u$dates and deetes occurring since $ackage was acti%ated

Con-iguration records created> modi-ied> or deeted "# designated

users

/ackage de-ined "e-ore changes occur



1)

Change

)@=@2010

)@7@2010

)@10@2010)@1@2010

'a"e A

'a"e 8

'a"e C

)@@2010 )@5@2010 )@=@2010 )@7@2010 )@10@2010 )@11@2010 )@12@2010 )@1)@2010 )@1@2010

'a"e

'a"e

'a"e 6

'a"e A

'a"e 8

'a"e C

'a"e

'a"e

'a"e 6

'a"e A> insert

'a"e A> !$date

'a"e 8> eete

'a"e A> Insert

'a"e 8> eete

'a"e A> !$date

'a"e 8> eete

'a"e C> Insert

'a"e 8> eete

'a"e A> Insert

'a"e A

'a"e 8

'a"e C

)@@2010

Sna$shot

)@12@2010

Sna$shot

Point in time

")er a perioof time



1

Package Definition

Package Creation

Package Distribution

Package Deployment



15

e-ining a $ackage

!serdri%en task to identi-# the contents o- a $ackage in

source en%ironment

S$eci-# the t#$e o- $ackage

< Sna$shot or change

S$eci-# migration grou$s

S$eci-# com$ied sources



1=

Migration Frou$ name and

order

Mem"er o"ect structures

and o"ect structure order

within grou$

e$endent grou$s -or the

gi%en migration grou$



17

/ackage de-inition with

header

Migration grou$s in the

de-inition



1E

Package Definition

Package Creation


Package Deployment



20

Creating a $ackage

/ackage de-inition on# de-ines the content

Actua con-iguration data coection done during $ackagecreation

!serdri%en task to coect con-iguration in-ormation andcom$ied sources "ased on de-inition

&ongrunning task de$ending

u$on amount o- in-ormation to

"e coected

/ackage is created in the -orm o-

records in a staging ta"e

8usiness /rocess

A$$ications

S#stem

Com$ied Sources

M#$ackage

Sna$shot

M& M& M&

M& M& M&

M& M& M&

HI/ HI/



21

Creating a $ackage Mani-est

Mani-est is used to determine i- $ackage can "e de$o#ed

in target +iewa"e -rom Migration Manager a$$ication

Mani-est contains,

/ackage in-ormation Source en%ironment %ersion in-ormation

< (8MS

< Maximo and Industr# Soution %ersions

Migration o"ects in $ackage and record count -or each 4$tiona (eadme in-ormation entered in source

en%ironment "# $ackage creator that assists in $anning

de$o#ment into target



2)

Package Definition

Package Creation


Package Deployment



25

e-ine and manage

muti$e targets

Seect 6I& or A'A8AS

distri"ution

/ro%ide target detais



2=

Package Definition

Package Creation


Package Deployment



27

e$o#ing a $ackage

!serdri%en task to $rocess the contents o- a $ackage in a

target en%ironment

/rocess metadata associated with $ackage

/rocess com$ied sources

A$$# structura changes to Maximo ta"es "ased on data dictionar#

metadata

/rocess other con-iguration data

/ackage de$o#ed through Migration Manager a$$ication



2D

e$o#ment /aths e$o#ment ste$s can %ar# de$ending u$on the contents o- $ackage

e$o#ment ste$s determine i- ser%ice outage wi occur

e$o#ment shoud "e schedued to occur during maintenance windows

Package A

Non-structuralcontent only

[Example,workflowprocessdefinitions]

Package B

Structuralcontent only

[Example,object, attribute,indexesdefinitions]

Package C

Structural andnon-structuralcontent

[Example,object, attributedefinitions +workflowprocessdefinitions]

Package D

Compiledsources only

[Example,custom Javapackage andJava class files]

Package E

CompiledSources andNon-structuralcontent

[Example,custom Javapackage andJava class files +workflow processdefinitions]

Package F

Compiledsources andstructuralcontent

[Example,custom Javapackage and Javaclass files +object, attribute,indexesdefinitions ]

< No manual

intervention

< No restart

< No outage

< Manual intervention

required

< No restart

< Service Outage

< Manual intervention required

< estart ma! "e required

< Service outage



2E

e$o#ing a $ackage /rereLuisites

8acku$ the data"ase "e-ore initiating the de$o#ment o- a$ackage

Migration Manager a$$ication wi warn

I- administrator chooses to continue> a og statement wi record the

-act

4n# one $ackage can "e de$o#ed at a time

'o $reser%e integrit# o- structura changes



)0

S$eci-# i- the $ackage is to

"e $re%iewed on#

Seect the s$eci-ic

$ackage

Cick e$o# to "egin

de$o#ment o- $ackage

contents



)1

A-ter de$o#ment

com$etes> #ou are

"rought to the /ackages

ta"

Check the status o- the

$ackage de$o#ment



)2

AMI M4 ew -or Maximo 7.1

(educes ser%er downtime whie controing access to Maximo

(estricted access to Maximo

o cron tasks

o end user sessions :exce$t designated administrator ogins;

o e%ent isteners

(eLuired -or,

Structura data"ase con-iguration with con-igd"

e$o#ment o- $ackages containing structura changes

e$o#ment o- $ackages containing $resentation M&

8ene-it, nsure no changes are made whie $ackage is

"eing created or de$o#ed



))

/rotecting against de$o#ment -aiures

/roacti%e a$$roach ata"ase "acku$s

< Most cients aread# im$ement $eriodic@dai# "acku$s o- $roduction

< A"iit# to restore to $re%ious state

Integrit# Checker < Integrit# Checker too shi$s with Maximo

< (un Integrit# Checker $rior to and a-ter de$o#ment

< Address a errors and warnings issued "# Integrit# Checker

ERROR -- Column WFTOOLBAR.TOOLBARLOCATION is mapped to domain

TOOLBARLOCATIONS, but is not defined te same F!i "a! #$ %&'($'%) EST

(##*

WFTOOLBAR.TOOLBARLOCATION is +ER%#. TOOLBARLOCATIONS is

ALN%#. F!i "a! #$ %&'($'%) EST (##



)

Maximo 7.1.1.= /re%iew -eature na"es administrators or im$ementers to $er-orm a dr# run o- content in

migration $ackages e$s identi-# $otentia data %aidation errors ahead o- -u de$o#ment

(esuts o- data %aidation are ca$tured in a $re%iew og -ie


Define Create Distri)(te Deplo%

I- content incudes structura changes to theunder#ing data"ase> con-igd" is executed in$re%iew mode

Pre+iew



)5

i&ration Collection

Maximo 7.5 Migration Coections and Com$arison


Define ,Generate

Create Distri)(te Deplo%

Pre+iew

Create

Collect

-ali'ate

Go to app,Ret(rnwit. +al(e

A'' to collection'irectl% in app

Collect )ase' one+ents

i&ration Comparison

Compare

Add com$arison resuts to

migration coection



)=

Migration Manager strateg# -or Maximo 7.5

/ro%ide more user-riend#> -exi"e tooset

Acceerate migrations com$eting $roduction roouts -aster

(educe de$o#ment time

Muti$e o$tions to identi-# and coect s#stem con-igurations

G/ick and choose’ a$$roach Com$arison a$$roach

Muti$e o$tions to migrate s#stem con-igurations

Sna$shots

Change

Migration Coections

Im$ro%e usa"iit# o- the Migration Manager a$$ication

6ewer cicks to com$ete ke# tasks



)7

Soution,

Migration Coections

ecou$e coection o- con-igurations -rom migration :J/ick and chooseK; !se '$ae ca$a"iities to coect con-igurations "# a$$ication

+aidate the con-igurations -or com$eteness> aow de%eo$ers and im$ementers tomake adustments

Automate the creation o- $ackage de-inition

Foa, Acceerate $ackage design

Moti%ation,

'oo cost# to maintain externa s$readsheets that record con-igurationacti%ities. Net> it is a $rereLuisite to "etter manage migration tasks.

Cient -eed"ack,

Provide a mechanism where my team can pick and choose the

configurations to be migrated. Snapshot packages force my team to be

deeply aware of tables, columns and SQL criteria. Change packagesforce my team to be extremely careful with the changes they make in

development.



)D

Migration Coections Oe# 6eatures

Muti$e mechanisms to identi-# and coect s#stemcon-igurations

+aidation o- coected con-igurations -or com$eteness

'rim or ex$and coection "ased on resuts o- %aidation

e-ine> ena"e or disa"e rues that dri%e %aidations

x$ort or im$ort coection entries with -ew cicks

na"es a im$ementation where s#stem con-igurations must "e $acedin %ersion contro s#stems

Fenerate $ackage de-initions

/ackage de-inition rues determine num"er o- $ackage de-initionsreLuired



0

Migration Coections a$$ication

o out o- the "ox migration coections

Migration coection created "# im$ementers @ de%eo$ers inde%eo$ment en%ironments

Migration coection can "e $u"ic :shared; or $ri%ate

Migration coections are oriented towards Migration Manager

su$$orted a$$ications !nike traditiona migration grou$s and o"ect structures

Migration coection can "e $o$uated using an# com"ination o- the-oowing -our $aths,

Fo to PA$$ication3 and return with +aue :singe record;

na"e Migration Coection too"ar "utton in target a$$ication and coectmuti$e records into chosen coection

na"e e%ent"ased su"scri$tion to one or more a$$ications andautomatica# coect con-iugrations into a chosen coection

Im$ort s#stem con-igurations in the -orm o- Maximo M& direct# into an

em$t# coection



1

Migration Coections a$$ication

Seect Action menu items grou$ed as,

Con-iguring data coection -rom a$$ications

< Add Migration Coections to A$$ications

< Con-igure %ent 'racking

x$orting @ Im$orting con-igurations

< Im$ort Con-igurations

< eete x$orted Con-iguration 6ies

/ackage de-inition o$tions

< Create /ackage e-inition

< +iew /ackage Creation rrors

+aidation o$tions

< e-ine (eated ata and &ooku$ (ues

< e-ine /ackage e-inition xce$tions

< +aidate Migration Coection



2

Migration Coections a$$ication A$$ication orientation

Coection o- con-igurations is oriented "# a$$ication

Candidate a$$ications are identi-ied d#namica# "ased on

the a%aia"iit# o- s#stemde-ined Migration Manager o"ect

structure

I- ex$oiters $ace additiona s#stemde-ined MigrationManager o"ect structures> the# wi "e $icked u$

automatica# there"# ena"ing more a$$ications to

$artici$ate in Migration Coections

A coection entr# ma# initia# "e associated with s#stem

de-ined o"ect structure "ut can "e switched to a user

de-ined o"ect structure in the Migration Coection ta"

Im$act on %aidation "ased on content o- userde-ined o"ect structure



)

Con-igurations are $aced

in the coection

Migration coection has a

name and owner

Most common# used

method to gathercon-igurations is to go to

a$$ication and "ring "ack

the desired con-iguration



Con-igurations can "e

automatica# tracked and

added to coection

Seect a$$ication> o"ect

structure and e%ents totrack

Create Mode wi "e

marked automatic



5

Migration Coections a$$ication +aidation scan

+aidation scan determines the com$eteness o- data -or the $ur$ose o- migration

+aidation scan "egins with the set o- entries in the migration coection

A migration coection ma# "e em$t# under certain conditions

+aidation scan em$o#s rue sets to determine reated data

ata ictionar# metadata

(eated ata rues

&ooku$ rues

(eated ata rues identi-# secondar# data in an a$$ication

xam$e> reationshi$s -or a "usiness o"ect

'here is no inde$endent a$$ication managing this data

&ooku$ rues identi-# data that has no dedicated management user inter-ace at a

xam$e> MA+A(s> Start Center 'em$ates



=


+aidation scan initiated "# user

ot mandator#> "ut strong# recommended

(uns as a "ackground task on a$$ication ser%er

+aidation scan $rogress $osted to cient $o$u$ diaog iaog can "e cosed and reo$ened as needed

&ong running $rocess de$endent u$on,

um"er o- coection entries Quantit# and Luait# o- data dictionar# metadata

um"er o- ena"ed reated rues

um"er o- ena"ed ooku$ rues



7


'hree t#$es o- %aidation scan resuts are $ossi"e

4r$han coection entries :s#stem con-iguration no onger exists;

u$icate coection entries :s#stem con-iguration recreated;

(eated data not $resent in the coection

!sers can deete or$han and du$icate entries

!sers can re%iew> trim reated data records and add to the

coection



D


+aidation can "e run as man# times as needed

ach %aidation run wi automatica# deete the current set o- reateddata

A %aidation "ackground task cannot "e terminated

Wi either com$ete or error out

rrors ma# occur $rimari# i- data dictionar# metadata is "ad# de-ined

rror wi "e re$orted in the $o$u$ diaog

Additiona detais can "e gathered "# ena"ing 8!F ogging

I- a migration coection is deeted> a reated data -ound are aso deeted

I- a %aidation "ackground task -ais> use Cron 'ask Setu$ a$$ication tore%iew errors and deete "ackground task

xecute Cron 'ask Admin Bo" Queue action to "ring u$ "ackground tasks

&ook -or o"s where Bo" ameRGMC4&&C'I4’



E

4r$hans and du$icates in

the coection are identi-ied

(eated data not in the

coection are identi-ied

!se "uttons in the (eated

Con-igurations ta" to add to coection

or trim down %aidation resuts

+aidation (esuts ta"

dis$a#s a the resuts o-

the %aidation scan



50

Migration Coections a$$ication (ues

+aidation scan executes in three $hases,

ata ictionar# metadata

(eated ata (ues

&ooku$ (ues

Se%era (eated ata (ues out o- the "ox

8asis, Inde$endent Migration Manager o"ect structure exists> howe%erthere is no inde$endent management a$$ication

na"ed out o- the "ox

Additiona reated data rues can "e de-ined

Indi%idua rues can "e ena"ed or disa"ed as needed

isa"ed rue wi $re%ent reated data -rom "eing $icked u$



51

(eated ata (ues user inter-ace



52

&ooku$ (ues

Se%era &ooku$ (ues out o- the "ox

8asis, Inde$endent Migration Manager o"ect structure exists> howe%er there is

no user inter-ace -or this data

A ooku$ rues disa"ed out o- the "ox

!se on# when needed

4ut o- the "ox ooku$ rues are set u$ as SQ& criteria

SQ& can "e executed and resuts re%iewed in rues user inter-ace

(esuts are "rought u$ in $o$u$ diaog

I- additiona ooku$ rues need to "e de-ined> $o$u$ diaog must "ecreated using A$$ication esigner

/o$u$ diaog re-erence must "e $aced in Migration Coections $resentation

M&



5)

&ooku$ (ues user inter-ace

/rimar# "usiness

o"ect to ooku$

:shoud match $rimar#o"ect o- Migration

Manager o"ect

structure

SQ& where cause can

"e changed ast sa%ed

cause is a$$ied when

rue is executed

Cicking this "utton

"rings u$ a $o$u$

diaog showing resuts

that wi "e identi-ied

as reated data



5

x$ort and im$ort -rom Migration Coections

Cients seek Luick ex$ort and im$ort o- s#stem

con-igurations -rom de%eo$ment en%ironments

S#stem con-igurations are maintained in %ersion contro s#stems

Migration Coections a$$ication ena"es ex$ort and im$ort

o- di--erent s#stem con-igurations -rom singe ta"

M& re$resentation on#

ot intended as generic a$$ication ex$ortim$ort

Integration 6ramework ena"es generic a$$ication"ased ex$ortim$ort

Intended to o--er de%eo$er-riend# mechanism -or '$ae

s#stem con-iguration extraction



55

x$ort

Singe con-iguration ex$ort ste$s,

1. /ace s#stem con-iguration in chosen coection

2. Cick the x$ort Con-iguration "utton

). Sa%e As diaog is $resented aong with -ie name

< Sa%e As diaog "eha%ior de$ends u$on we" "rowser con-iguration

Muti$e -ie ex$ort ste$s,

1. Seect muti$e records in the coection

2. Cick the x$ort Con-igurations "utton

). +eri-# con-irmation message that ex$ort was com$eted

. Cick the ownoad x$orted Con-igurations to o"tain muti$e -ies one"#one

I- the s#stem con-iguration has "een deeted "ut coection entr# exists> ex$ortwi re$ort error 8MAA7E0=



5=

Singe cick icon to extract

M& re$resentation

Sa%e As diaog to sa%e

M& re$resentation as -ie

to workstation



57

Im$ort

S#stem con-igurations can "e im$orted into an em$t#

migration coection

Migration Coection a$$ication wi im$ort and commit s#stem

con-igurations

Im$orted s#stem con-igurations wi "ecome mem"ers o- the coection

I- im$ort -ais error 8MAA7E71 wi "e re$orted

< 'here ma# "e nested errors -rom the Integration 6ramework

4ut o- the "ox> the im$ort imit is 100 records $er M&

4$tion not to $ace im$orted con-igurations into coection



5D

Fenerating $ackage de-initions

Migration Coections a$$ication generates $ackage

de-inition

ri%en "#,

Current contents o- the migration coection

4"ect structures registered with indi%idua entries in the migrationcoection

/ackage de-inition exce$tion rues

< Wi determine i- muti$e $ackages are reLuired to migrate the coection

I- $ackage de-inition -ais> the errors can "e %iewed in a$o$u$ diaog

/ackage de-inition errors ma# occur i- data dictionar# metadata "ad#de-ined



5E

Fenerating $ackage de-initions

/ackage de-initions dri%en "# coections are categori9ed as

C4&&C'I4

o SQ& where cause can "e associated

ownstream $ackage migration acti%ities dri%en $ure# "# contents o-

migration coection

SA/S4' and CAF $ackage de-inition -unctionait#

continues to "e a%aia"e

/ackage creation> distri"ution and de$o#ment -or a threet#$es o- $ackages exact# the same



=0

/ackage de-inition

corres$onds to the current

entries in the coection

/ackage de-inition t#$e is

C4&&C'I4

a%igate to the MigrationManager a$$ication to

continue migration tasks



=1

Summar#

Mi gr a t i o

n

Migration Coections

Migration coection is a "ridge "etween s#stem con-iguration and

migration

1 e% e

o $m en t @ C o

n- i g ur a t i on

Select ke# con-igurations

'oo identifies reated con-igurations

'oo generates $ackage de-initions

'oo seuences $ackage de-initions

'oo imports con-igurations su$$ortingsource contro mode

'oo exports con-igurations su$$ortingsource contro mode

(e$ace %aues

Com$are

rror correction

Acceerate $ackage design Acceerate migration

!sa"iit#

im$ro%ements



=2

!sa"iit# Im$ro%ements

ri%en "# cient> im$ementer> "usiness $artner -eed"ack

(educe the num"er o- ste$s reLuired to $er-orm migrations

Automate tasks where e%er $ossi"e

Migration Area escri$tion

/ackage de-inition S#stem $ro$ert# Gmxe.dm.autoa$$ro%e$kgde-’ can "eturned on to set $ackage de-inition status to A//(automatica#. Set to G0’ out o- the "ox.

/ackage de-inition Sna$shot $ackages no onger reLuire se$arate acti%ationste$

/ackagedistri"ution

istri"ution record automatica# created once a target ischosen to distri"ute $ackage to

/ackagede$o#ment

eSig diaog no onger $resented signature o$tion is$resent "ut not ena"ed



=)

+aue re$acement

With Maximo 7.1.x> Migration Manager did not ha%e the ca$a"iit# to

re$ace %aues in -ight

Coud not accommodate migration scenarios where de%eo$ment con-igurations

shoud not "e migrated asis to $roduction

< 4rgani9ation @ Site

< !ser I re-erences

< ate @ 'ime %aues

With Maximo 7.5> Migration Manager ena"es the creation o- re$acement

rues

(ues are "uit on to$ o- existing Integration 6ramework ma$$ing ca$a"iities

o out o- the "ox %aue re$acement rues

Migration Manager a$$ication $ro%ides management user inter-ace



=

+aue re$acement ke# -eatures

In source en%ironment> im$ementers can -ag certain attri"utes that reLuire %aue

re$acement uring de$o#ment> Migration Manager $rom$ts user to de-ine re$acement rues -or such attri"utes

In target en%ironment> im$ementers can,

e-ine %aue re$acement -or an# Migration Manager o"ect structure

e-ine %aue re$acement -or an# "usiness o"ect and attri"ute com"ination in the o"ect structure

e-ine conditiona %aue re$acement

+aue re$acement rues are s#stemwide

Wi "e a$$ied to an# in"ound $ackage that contains s#stem con-iguration created with an o"ect

structure that has a re$acement rue

Wi "e a$$ied to a t#$es o- $ackages :SA/S4'> CAF> C4&&C'I4;

(e$acement rues can "e ena"ed or disa"ed

(e$acement rues can "e a$$ied against s$eci-ic data"ase actions :insert> u$date or

deete;



=5

e-ine re$acement rue>

$ro%ide name

na"e @ disa"e as

needed

etermine on what

data"ase e%ent> rue

shoud "e a$$ied

S$eci-# which -ied’s %aue

shoud "e re$aced

S$eci-# where the

re$acement %aue wi

come -rom



=7

I- $ackage has status

/&4N((4(> check i-

e$o#ment ata rrors ta" is %isi"e

rror detais incude

a--ected o"ect structure

and $rimar# ke#s o- record

rror detais aso incude

exce$tion @ error messageCick dit rror ata to

edit -aied M&



=D

4rigina M& and M& -or

editing shown side"#side Cick 4O to sa%e edited

M&



=E

ata"ase Com$arison

Migrations can "e acceerated i- the di--erences "etween

source and target data"ase are known

In '$ae 7.5> Migration Manager $ro%ides a Com$are -eaturethat com$ares s#stem con-igurations

/ackage de-inition with at east one migration grou$ is a $rereLuisiteto executing com$arison

An# $ackage de-inition t#$e can "e used to execute com$arison

Com$are executes as a "ackground task

!se G(e-resh Bo" Status’ "utton to re-resh resuts and status

Com$arison resuts are $resented in the Migration Managera$$ication

Ad hoc re$ort $ro%ided out o- the "ox



70

ata"ase Com$arison sco$e

Com$arison executed -rom singe source data"ase against singe

target data"ase B8C connecti%it# to target is $rereLuisite

Com$arison can resut in -our $ossi"e outcomes ,

4utcome escri$tion

Match S#stem con-iguration exists in "oth source and targetand is a match

i--erence S#stem con-iguration exists in "oth source and target"ut there is a di--erence

&oca 4n# S#stem con-iguration is $resent on# in the $roduct

en%ironment where the com$arison was executed

(emote 4n# S#stem con-iguration is $resent on# in the $roducten%ironment that was com$ared to

o su$$ort to con-igure on# seected outcomes :a -our outcomes wi

"e determined;



71

ata"ase Com$arison Im$ementation modes

Com$arison can dri%e de%eo$ment en%ironment migrations

to $roduction

Identi-# di--erences> $ace identi-ied s#stem con-igurations into

Migration coections

Migration Manager a$$ication $ro%ides action to $ace di--erences into

migration coection

< 4n# s#stem con-igurations with Gi--erence’ and G&oca 4n#’ outcomes can

"e $aced into coection

Com$arison can "e used $ostde$o#ment to %eri-# match

"etween source and target en%ironments

A%oid timeconsuming manua %eri-ication

Com$arison resuts can "e discarded and rerun



72

A-ter de-ining ata"ase target>

cick Start Com$arison Bo" to

seect target and "egin com$are"etween two en%ironments

Com$arison (esuts

shown in ta"e window

/rimar# ke#s isted

Com$arison (esut shown



7)

6iter on (esut to -ind

di--erences

etais indicate a recordexists in "oth source and

target> "ut -ieds ha%e

di--erent %aues

6ied %aue in oca s#stem6ied %aue in remote

s#stem



7

etais indicate a record

exists in oca $roduct

en%ironment on#

6ied %aues in oca

s#stem shown on e-t



75

/roduct Com$ati"iit# Checks

Source and target $roduct en%ironments ha%e di--erent $roducts and %ersions

instaed

In Maximo 7.1.x> Migration Manager su$$orted the -oowing,

6or a $roduct $resent in source and target,

< 'oerate hot -ix di--erences

< 'oerate -ix $ack %ersion di--erence

6or target en%ironments with extra $roducts than source> aow $ackage de$o#ment with

warning

/roduct and %ersion di--erences im$#,

ata"ase e%e entit# di--erences

Metadata di--erences

Code di--erences

Aowing migrations "etween en%ironments with dis$arate $roduct stacks can

corru$t the $roduct en%ironments



7=

/roduct Com$ati"iit# Checks '$ae 7.1.x

'$ae 7117

'S(M 721

CCM8

71x

'$ae 7117

'S(M 721

CCM8

71x

Matching $roduct stacks

'$ae 7117

'S(M 721

CCM8

7105

'$ae 711D

'S(M 721

CCM8

710)

6ix /ack di--erences 'oeration

Source 'argetSource 'arget

'$ae 7117

'S(M 721

'$ae 7117

'S(M 721

CCM8

71x

xtra $roducts in target 'oeration

Source 'arget

'$ae 7117

'S(M 721

'$ae 7117

'S(M 721

CCM8

71x

xtra $roducts in source isaowed

Source

'arget

CCM8

71x

'AMI' 721



77

/roduct Com$ati"iit# Checks Maximo 7.5

'$ae 7117

'S(M 721

CCM8

71x

'$ae 7117

'S(M 721

CCM8

71x

Matching $roduct stacks

'$ae 7117

'S(M 721

CCM8

7105

'$ae 711D

'S(M 721

CCM8

710)

6ix /ack di--erences 'oeration

Source 'argetSource 'arget

'$ae 7117

'S(M 721

'$ae 7117

'S(M 721

CCM8

71x

xtra $roducts in target 'oeration

Source 'arget

'$ae 7117

'S(M 721

'$ae 7117

'S(M 721

CCM8

71x

xtra $roducts in source 'oeration

Source

'arget

CCM8

71x

'AMI' 721

Maximo 7.5 ena"es im$ementers to excude $roducts in the source $roduct

stack -rom "eing com$ared with target $roduct stack



7D

/roduct Com$ati"iit# Checks Maximo 7.5

Some /SI :$roduct $ackaging; incude generic s#stem con-iguration

content

xam$e> S(M Ser%ice Cataog Content 7.2.0.1

4ther "est $ractices or um$ start content $ackages

Migration "ecomes im$ossi"e since Migration Manager treats content

$ackages the same as reguar $roduct $ackages

Im$ementers can excude -rom com$ati"iit# checks those $roducts

!se excusion with caution

Ad hoc use in tru# di--erent $roduct en%ironments can ead to de$o#menterrors and s#stem con-iguration corru$tion

(ecommendation is to maintain same $roduct stacks in sources and

targets



7E

Icon indicates matches

and di--erences in $roductin-ormation

x$anation o- the

di--erence is $ro%ided

Check "ox can "e checked

to excude s$eci-ic $roduct

in-ormation -rom "eing

matched



D0

Content changes

MMA48BC'C6F o"ect structure can now "e migrated across

di--erent (8MS

xam$e> 4race to 82

(e%iew imitations in '$ae In-ormation Center

MQ!(N o"ect structure added to A//&ICA'I4 migration grou$

Migrates Lueries

MI'(AC'I4 o"ect structure to migrate we" ser%ices interactions

MSC(I/'> M&A!C/4I' o"ect structures to migrate scri$ts

MWS(FIS'(N o"ect structure to migrate we" ser%ices i"rar# entries

umerous "ug -ixes



D1

&ogging and trou"eshooting

Gdm’ ogger continues to remain the $rimar# ogger -or a

Migration Manager -unctions incuding Migration Coections Gintegration’ and GsL’ oggers are aso im$ortant to de"ug de$o#ment

errors

6or a de$o#ments $rior to goi%e> setting 8!F e%e -or Gdm’ ogger

is recommended

Integrit# Checker shoud "e executed in "oth source andtarget en%ironments as $rereLuisite to migration

rrors and warnings shoud "e reso%ed $rior to migration

6or smaer $ackages> consider utii9ing /re%iew -unction totest data %aidit#

/anning -or migration using $u"ished (ed"ook materiastrong# recommended



D2

&ogging and trou"eshooting

6or in%aid data errors at de$o#ment> use de"ug ogs to

check i- the SQ& statement is executed against the data"ase"e-ore the error is re$orted -or the associated ta"e and see i-

record is -ound

Migration Coection %aidation ma# take additiona time -or

certain scenarios de$ending on the num"er o- reated

records -ound -or a candidate con-iguration in the coection

S#stem $ro$erties mxe.dm.co%aide%es> mxe.dm.co%aidtgtexcude

and mxe.dm.co%aidsrcexcude shoud "e used in concert to tune the

%aidation

Consider disa"ing reated and ooku$ rues when arge num"ers o-

reated records are -ound "reak into muti$e coections

Additiona#> turning on de"ug ogs wi $roduce signi-icant in-ormation

on the extent o- %aidation



(esources

Maximo 7.5 In-ormation Center -or Migration Manager and

Migration Coections a$$ication he$

htt$,@@$ic.dhe.i"m.com@in-ocenter@ti%ihe$@%Er1@[email protected]"m.m"s.doc@

g$migmgr@cctrmigmgro%er.htm

Migration Manager (ed"ook -or Maximo 7.1.x htt$,@@www.red"ooks.i"m.com@a"stracts@sg27E0=.htm*4$en

I8M Su$$ort 'ech otes

Maximo WiOi

htt$,@@www.i"m.com@de%eo$erworks@wikis@dis$a#@maximo@ome

Content wi "e added o%er time

http://pic.dhe.ibm.com/infocenter/tivihelp/v49r1/topic/com.ibm.mbs.doc/gp_migmgr/c_ctr_mig_mgr_over.html


http://www.redbooks.ibm.com/abstracts/sg247906.html?Open

http://www.ibm.com/developerworks/wikis/display/maximo/Home

http://www.ibm.com/developerworks/wikis/display/maximo/Home

http://www.redbooks.ibm.com/abstracts/sg247906.html?Open



2012 08 07 ste migration manager

Documents