Import Wizard, Life Cycle Manager, UMT, & Promotion Management, Oh My…

Hey Import Wizard, Good Job!

Anyone who has spent some time around Business Objects before BI 4 should be familiar with Import Wizard. It has a little clunky and hard to control, but once you learned to follow and few rules and respect its limits Import Wizard became a powerful tool in your hands. I heavily used Import Wizard to migrate/promote content between development, integration/testing, and production environments. I also used Import Wizard to pull content out of lower versions of Business Objects and into my beloved BO instances. I used Import Wizard as a tool to synchronize BO object CUIDs across environments and I even used Import Wizard to make an exact copy of an entire environment into the itself (giving each copied object a new CUID). I truly grew comfortable with this great tool and I even loved its ability to create archives into BIAR files.

R.I.P Import Wizard

With the release of BI 4, Business Objects has shifted a lot of fundamental pieces around. One of these shifts is the retirement of Import Wizard. However, I believe that many parts of Import Wizard continue to live on in the Upgrade Management Tool (UMT). The UMT, unlike Import Wizard, is restricted to the migration of Business Objects content from a lower version of BO into the CMS of a higher version of BO. UMT cannot be used to migrate content between to BO environments of the same version (although, I believe I heard that someone once tricked it into allowing this). Clearly the intention of UMT is to help you upgrade your BO objects, but many parts of UMT do feel like Import Wizard with a facelift.

In the early versions of BI 4.0 the functionality of migrating BO content between two BO environments of the same version is handled by a new-ish tool called Life Cycle Manager (LCM). To be honest, LCM exists in XI 3.1, but I always found it to be more trouble than working with Import Wizard so I mostly ignored it. LCM was optional in BO XI 3.1. However, in BI 4.0, LCM became the only tool available to promote content from one environment to another environment of the same patch level.

Promotion Management

The details escape me, but at some point in BO BI 4.1, LCM was renamed “Promotion Management” providing yet one more contender for the “PM” acronym. I find this name more fitting, because I already used the verb “promote” to describe the main function of “Promotion Management”. Early on LCM and Promotion Management had a limit of about 100 objects. In other words, Promotion Management could only handle jobs with 200 or less documents, folders, security objects, etc. in total. However, I am now told that the limit has been increased with the release of BI 4.1 to 2000 objects. This is wonderful news.

Self-service through Promotion Management

One of the best features about LCM and Promotion Management is that non-administrative users can be granted the right to define promotion jobs. These same users may also be granted the right to run/execute those Promotion Management jobs. Contrast this with Import Wizard and you will see that Promotion Management enables many opportunities to allow “developers” to easily promote their work across the different environments and the Business Objects administrator can decide what level of access is needed.

Enjoyed this post? Share it!


17 thoughts on “Import Wizard, Life Cycle Manager, UMT, & Promotion Management, Oh My…

  1. Hi Julian-
    can using the import wizard on different sp’s cause an issue? We used the import wizard using bo3.1 sp3(source) to bo 3.1 sp7(destination).

    I am noticing some issues with the universes.

    Any ideas?

  2. Hi Chris, this could cause you issues, but I am not certain of that. It is always best to use Import Wizard of the highest patch level. Could you just do the migration Import Wizard job again using the 3.1 SP7 Import Wizard? I highly recommend this.

  3. You mention the UMT can only go from a lower version to a higher one. This si from Version 3.x to version 4.x only. It would not let us go from 4.0 SP6 to 4.1 SP1. There is a command line switch you can use to ignore Versions but it’s not supported.
    SAP told us they have planned improvements to Promotion Manager, but it is really a bad tool. They really need to redesign the tool from the ground up and include large customers for input.

  4. You mention the UMT can only go from a lower version to a higher one. This is from Version 3.x to version 4.x only. It would not let us go from 4.0 SP6 to 4.1 SP1. There is a command line switch you can use to ignore Versions but it’s not supported.
    SAP told us they have planned improvements to Promotion Manager, but it is really a bad tool. They really need to redesign the tool from the ground up and include large customers for input.

  5. Hi Jon, you make a good point. UMT is only meant for 3.x to 4.x. I knew this, but did not communicate it very well with my vague statement. I’ve been using Promotion Management in BI 4.1 and I find it much improved of its state in 3.1. It isn’t perfect, but good enough most of the time for moving small batches of content between environments.

  6. The environment :

    In Boxi3 we “learned” that users who develop reports in PROD, but in a special folder “experts_developers only”, are mostly the same users testing new universe releases in test.
    Of course they regularly want their “production reports” to be moved to test, be it to see if they are still valid with the new version of the universe, or to “tweak” them with the new universe and have them “ready” when the universe gets the go for prod.

    In boxi3, they “promote” their reports using Rich Client (though they asked ICT when they had a lot of reports to pull at once, and we use Import Wizard)

    ( only universe developers and admins have access on dev)

    We foresee that the same will happen in BI4 : develop reports in both prod and test/acceptance , then want to sync these environments on a FOLDER level.

    The big question : Will the following scheme work ? (And how ? )

    We want to create two FOLDERS in both test and prod environment, :
    ProdToTest and TestToProd.
    The idea: in test users will “put” their doc into TestToProd, a promotion object will “run” and in prod the user will retrieve his doc from TestToProd
    And vice versa for moving a doc from prod to test: on prod, put it in folder prodToTest, wait for promo object to run, retrieve object from ProdToTest in the test environment.

    As for today, I seem to be able to “promote a folder”:
    Create folder A in dev, create promo object to test, run it : bingo, the folder appears in test.

    But I changed the COMMENT on the folder, re-ran the promo object but the comment in test is not changed.
    Same thing when i change the folders NAME :NOTHING happens in test when I run the promo object.

    I add a webi document to the same folder, re-run the promo object and again: the CONTENT of the folder is NOT updated/promoted.

    What did I miss here ?
    Do I always need the exact DOCUMENTS to be included in the promotion object ?
    Is there another way to do this, or better: to AUTOMATE such back-and-forth ?
    It sure would help our developers.

  7. Hi,

    We exported the BO XI2.1 in a BIAR file format and then we installed/created a new 3.1 environment. We copied that BIAR file from that old box and when we tried importing in the BO 3.1 environment, at the destination we are getting error :- “Getting error “Error logging on to server.  Check logon information.. IWZ 00001 Invalid class string”
    Our migration is completely on hold as of now due to this issue. Need help on this at the earliest.

  8. Hi, Julian.

    I’m trying to migrate some Crystal Reports from our 3.1 system to 4.1 using Promotion Management. However, when I do I’m recieving this message: SDK Version 1400 does not support Crystal Enterprise version 1264 (FWM 02032). From my readings I understood this was possible. Any idea what’s up?


  9. Hi Trudy, I believe that you can only upgrade documents using the Upgrade Management Tool (UMT). Promotion Management is just for moving documents between different environments of the same version.

  10. We have been testing again.
    For promoting (alligning) SECURITY between BI4 environments, Promotion Manager is … worthless.
    It can promote GROUPS, but when the group has multiple parents, these parents have to be in the target already, AND ample checking was needed, because some memberships were promoted, others weren’t. As if Promotion Management only recognises ONE PARENT per object promoted.
    That works for the “trees” of folders, of course: every universe has ONE parent folder, every webi doc has one parent folder.
    It does NOT work for the FAMILIES though (groups ordered in acyclic directed graphs, AKA families, with most “children” having more than one “parent”.

    WORKAROUND – for now – is :

    a) create a (universe) folder in DEV
    b) create access groups for it in DEV
    There is a HIERARCHY in these groups, plus a group that “accesses the universe objects to refresh data” (View On Demand) needs SOME access in BI LaunchPad and in Web Intelligence applications ( groups APP_WEBI , APP_LaunchPad) and thus the group is member of both APP-groups.
    c) assign (custom) Access Levels for the folder to the groups (plural)

    Because PROMOTION MANAGER will not (reliably) port this structure to Acceptance or Prod, we DO use the UMT for these promotions (yes, “-internal_use_only_noversioncheck” is “not supported” but it is the ONLY TOOL to do the job, unless Promotion Manager be used to “promote” each and every folder separately, then the groups, and the membership structure is manually applied in ACC and PROD … a real waste of time.

    We are curious whether SAP will either “support the extra switch” in the near future, OR re-brand a copy of the UMT that has the switch hard-coded.

    That way LCM / Promotion Manager can be used to “promote the trees”, while UMT / whatevernewname can “promote the families”

    But there was still no sign from SAP to do that.

    Yes, there are THIRD PARTY TOOLS who can do that.
    Has SAP BusinessObjects evolved into a platform for third party tools ? ( Like: Windows, Linux, Android, iOS … )

  11. Hi Hans, thank you for yet another great addition to the Business Objects knowledge on this site! If you ever feel like publishing an article on the site, just send me an email:

  12. Hi, Julian.

    Thank you for your response. I have one additional question. As you can probably tell from my first question we’re upgrading from 3.1, SP6 to 4.1, SP6, Patch 7. In all my readings it was noted upgrading from our 3.1 level to 4.1 was supported. I also read that 4.1 supported the running of legacy versions of Crystal Reports (our shop is entirely Crystal Reports). However, it appears we have to upgrade all of our reports to Crystal Reports 2013. Is that correct? If so, I found no where that SAP was clear about this.

    Thanks again, Julian.

  13. Hello Trudy,
    as the UMT will indeed copy your documents from BO3 to BI4, this is something you can test.
    The UMT leaves your original (in BO 3) untouched.

    When you move one document to your new BI4 “dev” environment, try to run the SAP Report Conversion Tool on it.

    If it doesn’t work for one report, then open a ticket with SAP support. When documentation is not clear, support may help you find out.

    It does work for webi, but as we are webi-only, there’s no experience here with crystal reports. ( One reason NOT to go the crystal way was history, another reason was that we were SO happy to get rid of (most) fat client installations when webi became a viable replacement for deski. With an 1000+ user base, fat clients are a burden)

  14. Thank you, Hans. I’m looking into the impact this will have on us.

    Have a wonderful day!

  15. Does anyone know of a way to restrict rights in UMT so that developers can move reports from on version of BO to another (XIR2 to 4.0) without being able to also copy the XIR2 Universe over into 4.0?

  16. Hello All,

    In my desperate search in trying to find out why I am unable to use Import Wizard to import recurring jobs from BI 3.1SP1 TO BI 3.1SP6… to be clear, I can import, however, there are some reports with more than 1 recurring schedules and thus sometimes, it would only import 1 out of 2 for example or 3 out of 4 recurring jobs on other reports. It boggles my mind as to why it would do that… Here is what I’ve entered step by step (I’ve highlighted ones that are not defaulted):

    1) Clear All Check marks
    2) Activate:
    a) Import users and users groups
    b) Import folders and objects
    c) Import repository objects
    d) Import remote connections and replication jobs
    3) Choose Use the object’s name and path to determine whether it already exists in the destination system and then choose “Update the destination object” and click NEXT.
    4) Click on ‘Select groups that contain selected users’ and then check to see what users have created the recurring jobs in the SOURCE environment and then choose it for the import wizard. It is important that you select this option first before choosing the individual user so that the groups will follow that user automatically.

    In my example, the SOURCE environment is showing jsmith as the job scheduler for SD001 report, so I will select ‘jsmith’ as the user (see below) and click on NEXT.
    5) Choose the folder and specific report(s) that you want to import. In my example, I wanted to backup SD001 and all instances of selected object. *Remember to select IMPORT ALL INSTANCES OF EACH SELECTED OBJECT

    6) Make sure to select ‘Import repository objects that the selected reports use directly, as well as any other repository objects they depend on’

    7) Select the ‘Import recipients used by selected publications’ is selected as below and click on NEXT

    8) With the (Source Server name)highlighted in the Remove Connections and Replication Jobs window, click on NEXT

    Any insight as to why this is so??? Makes no sense to me.

Leave a comment

Your email address will not be published. Required fields are marked *