IBM Cognos 8 Business Intelligence

MIGRATION TOOLS INSTALLATION AND CONFIGURATION GUIDE

Product Information
This document applies to IBM Cognos 8 Version 8.4 and may also apply to subsequent releases. To check for newer versions of this document, visit the IBM Cognos Resource Center (http://www.ibm.com/software/data/support/cognos_crc.html).

Copyright
Copyright 2008 Cognos ULC (formerly Cognos Incorporated). Cognos ULC is an IBM Company. Portions of Cognos ULC software products are protected by one or more of the following U.S. Patents: 6,609,123 B1; 6,611,838 B1; 6,662,188 B1; 6,728,697 B2; 6,741,982 B2; 6,763,520 B1; 6,768,995 B2; 6,782,378 B2; 6,847,973 B2; 6,907,428 B2; 6,853,375 B2; 6,986,135 B2; 6,995,768 B2; 7,062,479 B2; 7,072,822 B2; 7,111,007 B2; 7,130,822 B1; 7,155,398 B2; 7,171,425 B2; 7,185,016 B1; 7,213,199 B2; 7,243,106 B2; 7,257,612 B2; 7,275,211 B2; 7,281,047 B2; 7,293,008 B2; 7,296,040 B2; 7,318,058 B2; 7,325,003 B2; 7,333,995 B2. Cognos and the Cognos logo are trademarks of Cognos ULC (formerly Cognos Incorporated) in the United States and/or other countries. IBM and the IBM logo are trademarks of International Business Machines Corporation in the United States, or other countries or both. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others. While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in this document. This document shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to the information contained in this document will be documented in subsequent editions. U.S. Government Restricted Rights. The software and accompanying materials are provided with Restricted Rights. Use, duplication, or disclosure by the Government is subject to the restrictions in subparagraph (C)(1)(ii) of the Rights in Technical Data and Computer clause at DFARS 252.227-7013, or subparagraphs (C)(1) and (2) of the Commercial Computer Software - Restricted Rights at 48CFR52.227 as applicable. The Contractor is Cognos Corporation, 15 Wayside Road, Burlington, MA 01803. This document contains proprietary information of Cognos. All rights are reserved. No part of this document may be copied, photocopied, reproduced, stored in a retrieval system, transmitted in any form or by any means, or translated into another language without the prior written consent of Cognos.

Table of Contents
Introduction

Whats New? 7 New Features in Version 8.4 7 Support for IBM Cognos Series 7 Version 4 MR3 to IBM Cognos 8 8.4 7 Support for IBM Cognos Series 7 and IBM Cognos 8 Distributed Installations 7 Changed Features in Version 8.4 7 Different Names for the Migration Components in the Installation Wizard 7 New Features in Version 8.3 8 Support for IBM Cognos Series 7 Version 4 MR2 to IBM Cognos 8 8.3 8 New Sample Reports 8 Changed Features in Version 8.3 8 References to the Impromptu Migration Tool in the Documentation 8 Different Names for the Migration Components in the Installation Wizard 8 A Single Sample PowerCube 8 Chapter 1: Where Do I Start?

Recommendation - Choosing the Best Migration Path 12 What to Expect When You Move Content from IBM Cognos Series 7 to IBM Cognos 8 12 IBM Cognos Series 7 Products and Components Migrated With Tools 13 IBM Cognos Series 7 Products and Components Not Migrated With Tools 16 Chapter 2: The Migration Process

19 23

Chapter 3: Installing and Configuring the IBM Cognos 8 Migration Tools Install the Migration Tools 23 Start the IBM Cognos Series 7 Migration Service 25 Uninstalling the IBM Cognos 8 Migration Tools 25

Chapter 4: Configure IBM Cognos 8 to Support PowerPlay Report Migration

27

Enable Users to Open PowerPlay Reports in Report Studio or Analysis Studio 28 Configure Data Sources that Reference Secure Cubes 29 Chapter 5: Setting Up the Samples

31

Create a Data Source Connection to the Sample PowerCube 31 Create a Data Source Connection to the Sample Impromptu Catalog 32 Import the Samples 32 Remove the Sample Packages from IBM Cognos 8 34 Appendix A: Troubleshooting Log Files 35 Index

35

37

Installation and Configuration Guide 3

Table of Contents

4 Migration Tools

Introduction
This document is intended for use with the migration tools, which convert metadata, Impromptu catalogs and reports, PowerPlay reports, and Upfront content to IBM Cognos 8. For information about upgrading IBM Cognos ReportNet 1.1, IBM Cognos Metrics Manager, IBM Cognos DecisionStream, or older versions of IBM Cognos 8 to IBM Cognos 8, see the IBM Cognos 8 Installation and Configuration Guide. This guide contains instructions for installing and configuring the IBM Cognos 8 migration tools.

Audience
To use this guide, you should be familiar with basic Windows and/or UNIX administration skills the existing server environment and security infrastructure in your organization reporting concepts metadata modeling concepts

Related Documentation
Our documentation includes user guides, getting started guides, new features guides, readmes, and other materials to meet the needs of our varied audience. The following documents contain related information and may be referred to in this document. Note: For online users of this document, a Web page such as The page cannot be found may appear when clicking individual links in the following table. Documents are made available for your particular installation and translation configuration. If a link is unavailable, you can access the document on the IBM Cognos Resource Center (http://www.ibm.com/software/data/support/cognos_crc.html).

Document
Planning a Migration from Series 7 to IBM Cognos 8 BI

Description
Planning a migration from Series 7 to IBM Cognos 8 BI and understanding the migration options Using interoperability as part of the recommended migration strategy

Using IBM Cognos Series 7 and IBM Cognos 8 in the Same Environment

IBM Cognos 8 Migration Tools User Guide Moving metadata and applications from IBM Cognos Series 7 to IBM Cognos 8 IBM Cognos Series 7 Deployment Manager Packaging IBM Cognos Series 7 business intelliUser Guide gence data

Installation and Configuration Guide 5

Introduction

Document

Description

IBM Cognos 8 Installation and Configuration Installing, upgrading, configuring, and testing IBM Guide Cognos 8, changing application servers, and setting up samples IBM Cognos 8 Administration and Security Managing servers, security, reports, and portal Guide services; and setting up the samples, customizing the user interface and troubleshooting

Finding Information
Product documentation is available in online help from the Help menu or button in IBM Cognos products. To find the most current product documentation, including all localized documentation and knowledge base materials, access the IBM Cognos Resource Center (http://www.ibm.com/software/ data/support/cognos_crc.html). You can also read PDF versions of the product readme files and installation guides directly from IBM Cognos product CDs.

Getting Help
For more information about using this product or for technical assistance, visit the IBM Cognos Resource Center (http://www.ibm.com/software/data/support/cognos_crc.html). This site provides information on support, professional services, and education.

Printing Copyright Material

You can print selected pages, a section, or the whole book. You are granted a non-exclusive, nontransferable license to use, copy, and reproduce the copyright materials, in printed or electronic format, solely for the purpose of operating, maintaining, and providing internal training on IBM Cognos software.

6 Migration Tools

Whats New?
This section contains a list of new and changed features for this release. It also contains a cumulative list of similar information for previous releases. It will help you plan your upgrade and application deployment strategies and the training requirements for your users. To review an up-to-date list of environments supported by IBM Cognos products, such as operating systems, patches, browsers, Web servers, directory servers, database servers, and application servers, visit the IBM Cognos Resource Center Web site (http://www.ibm.com/software/data/support/cognos_ crc.html).

New Features in Version 8.4

Listed below are new features since the last release. Links to directly-related topics are included.

Support for IBM Cognos Series 7 Version 4 MR3 to IBM Cognos 8 8.4
This version of the migration tools supports migration from IBM Cognos Series 7 version 4 MR3 to IBM Cognos 8 8.4.

Support for IBM Cognos Series 7 and IBM Cognos 8 Distributed Installations
You can use this version of the migration tools in IBM Cognos Series 7 or IBM Cognos 8 distributed environments. For more information, see "Install the Migration Tools" (p. 23).

Changed Features in Version 8.4

Listed below are changes to features since the last release. Links to directly-related topics are included.

Different Names for the Migration Components in the Installation Wizard

In the Installation Wizard, the names of the migration components that you can install have changed. The new component names are Series 7 Migration Components Migration Application Tier Components Migration Gateway Components Migration Content Manager Components

For information about these components, see "Install the Migration Tools" (p. 23).

Installation and Configuration Guide 7

Whats New?

New Features in Version 8.3

Listed below are new features since the last release. Links to directly-related topics are included.

Support for IBM Cognos Series 7 Version 4 MR2 to IBM Cognos 8 8.3
This version of the migration tools supports migration from IBM Cognos Series 7 version 4, version 4 MR1, and version 4 MR2 to IBM Cognos 8 8.3. If you are working with previous versions of IBM Cognos Series 7 or IBM Cognos 8, we recommend that you choose the best migration path for your environment (p. 12). In IBM Cognos 8 8.3, Report Studio is available in two authoring modes: professional and express. The migration tools can migrate reports to Report Studio in the professional authoring mode only.

New Sample Reports

New sample reports are included in version 8.3 and some sample reports in the previous release were removed. For more information, see the Migration Tools User Guide.

Changed Features in Version 8.3

Listed below are changes to features since the last release. Links to directly-related topics are included.

References to the Impromptu Migration Tool in the Documentation

References to the Impromptu catalog migration tool (impcat2xml) were removed from the documentation. You can use the Series 7 migration tool (migratetoc8) to migrate Impromptu catalogs, which simplifies the migration workflow that you need to follow.

Different Names for the Migration Components in the Installation Wizard

In the Installation Wizard, the names of the migration components that you can install have changed. However, each component works the same as in previous releases. The new component names are Architect to Framework Manager Model Migration IBM Cognos Series 7 Migration Components IBM Cognos 8 Migration Components

A Single Sample PowerCube

Instead of two PowerCubes, a single PowerCube is used as the data source for the source and migrated PowerPlay reports (p. 31).

8 Migration Tools

Chapter 1: Where Do I Start?

You made the decision to adopt IBM Cognos 8 after working with your company representative to understand the benefits of IBM Cognos 8 and where it fits in your long-term business intelligence plans. Even after adopting IBM Cognos 8, you do not have to migrate existing applications. The company will continue to support IBM Cognos Series 7 for several years and flexible licensing options provide time for you to determine when and how migration is beneficial for you. For some customers, the best option is to not migrate their existing applications. These customers can continue to maintain the existing IBM Cognos Series 7 applications and use IBM Cognos 8 for new applications. If you decide to migrate your existing applications, a migration project requires a significant commitment of time and resources. A small migration project will take several weeks. For a large IBM Cognos Series 7 deployment, a migration project can last several months. Thorough planning, including identifying specific goals for the migration project, ensures that the migration meets expectations and adds value to your business intelligence environment. A migration project may be part of your initial IBM Cognos 8 deployment plans, or you may start migration planning after deploying IBM Cognos 8. We recommend that you take the time necessary to learn about IBM Cognos 8 and to evaluate your current IBM Cognos Series 7 applications before you start to plan a migration. For more information, see Planning a Migration from Series 7 to IBM Cognos 8 BI. IBM Cognos Global Professional Services can help you assess and understand the best way to proceed with your migration to IBM Cognos 8, with tools and expertise to assess your needs to assess your existing IBM Cognos Series 7 environment to design the IBM Cognos 8 environment that best meets your future needs

Understand How IBM Cognos 8 is Different From IBM Cognos Series 7

We recommend that you become familiar with IBM Cognos 8 before you develop a migration plan. IBM Cognos 8 is different from IBM Cognos Series 7. You should not use migration as a tool to educate you on IBM Cognos 8. If you do, your migration may simply re-create the same application in IBM Cognos 8, without taking advantage of new features and functionality. IBM Cognos 8 is built on the proven and scalable Web services architecture introduced with IBM Cognos ReportNet. This architecture supports a truly unified product suite, and it is the basis for our future development efforts. Compared with IBM Cognos Series 7, business users work differently with IBM Cognos 8: A single product provides all business intelligence capabilities: reporting, analysis, scorecards, dashboards, business event management, and data integration. Users chose the capabilities they need.

Installation and Configuration Guide 9

Chapter 1: Where Do I Start? Because metadata is defined once, users have a complete and consistent view of corporate data. Users do not have to go to different products or locations to see different data. Individual users can choose the tools and information they need. They do not have to learn generic tools designed for highly technical users. This flexible business intelligence meets the needs of a greater variety of roles in the organization.

In addition to understanding the high-level concepts and benefits of IBM Cognos 8, you should understand the differences in features between IBM Cognos Series 7 and IBM Cognos 8. A direct mapping for some features does not exist between IBM Cognos Series 7 and IBM Cognos 8. For example, in PowerPlay, you can apply 80/20 suppression to data. Analysis Studio does not include this option. However, the top and bottom filtering options in Analysis Studio provide greater control for suppressing data and allow you to achieve similar results to 80/20 suppression in PowerPlay.

Assess the Size and Complexity of Your IBM Cognos Series 7 Application
We recommend that you complete a detailed assessment of your IBM Cognos Series 7 applications before starting a migration. The size and complexity of your IBM Cognos Series 7 applications are important factors to consider when planning the migration. The total size of the applications has a significant impact on the time required to complete the migration. You must understand the complexity of your applications to set appropriate and accurate expectations for the migration. A detailed assessment can take several weeks to complete for large applications. You likely will not want to migrate IBM Cognos Series 7 content that is rarely or never used. You can use the auditing tools included with IBM Cognos Series 7 to identify how often content is used. The audits provide an objective view of the applications. Assessing and reducing the size of the applications is a useful exercise even if you decide to not migrate. Do not rely only on user feedback to determine which content is used. The complexity of your applications determines how much work is required to refine the content in IBM Cognos 8. What proportion of the reports are basic list or crosstab reports? What proportion of the reports use advanced features, such as drill-through to other applications, or complex formatting? For some types of reports, a relatively minor amount of work is required to refine the reports after migration. For more complex reports, you may want to recreate the content from scratch, or make significant changes to migrated content, to take advantage of new features and functionality in IBM Cognos 8. Your experience with IBM Cognos 8 will help you to understand functionality mapping between IBM Cognos Series 7 and IBM Cognos 8 and to decide if IBM Cognos 8 offers a better alternative for achieving the same results.

Identify How IBM Cognos 8 Adds Value to Your IBM Cognos Series 7 Application
We recommend that you work with your users to identify essential IBM Cognos 8 functionality that was not available in IBM Cognos Series 7. After you learn about IBM Cognos 8 and assess your IBM Cognos Series 7 applications, you will realize that you do not want to use migration to simply replicate your IBM Cognos Series 7 applications in IBM Cognos 8. You want to take advantage of the benefits of IBM Cognos 8 while leveraging the investment you have in IBM Cognos Series 7 applications. List the critical features in IBM Cognos Series 7 applications. Are these features available in IBM Cognos 8? Do the migration tools map the feature to IBM Cognos 8, or do you have to

10 Migration Tools

Chapter 1: Where Do I Start? re-create the feature after migration? If direct mapping in IBM Cognos 8 does not exist, can you achieve similar results in a different way in IBM Cognos 8? List the essential IBM Cognos 8 features that were unavailable in IBM Cognos Series 7. Can you add these features as enhancements to a migrated report? Should you create new reports that use the features?

By comparing and listing important features with your users, you can start to identify which IBM Cognos Series 7 content is a good candidate for migration. You should migrate content if most features map from IBM Cognos Series 7 to IBM Cognos 8, if the migration tools preserve all or most of the features, and if you find it easier to enhance the migrated report with IBM Cognos 8 features than to re-create the report.

Decide How to Approach Migration

There are two different approaches that you can take to migration: Lift and shift This approach completely replicates an existing application in the new environment. This is what often happens when you move between different versions of a product, such as from PowerPlay 7.0 to 7.1. Compress and optimize Rather than duplicating the existing application with the new software, you step back and do a full assessment of the business requirements and how they can best be fulfilled with the new software before you migrate. This can mean performing tasks like consolidating Impromptu catalogs into a smaller number of Framework Manager models or combining many reports into one report by using prompts, security, and so on. Regardless of which approach you decide to take, the migration costs are usually about the same. If you use the lift and shift approach, more of the cost and time go into doing the migration and testing the migrated reports. If you use the compress and optimize approach, there is more cost and time spent up front in the interview and design phases. The compress and optimize approach usually results in applications that are better designed for the IBM Cognos 8 architecture, require less maintenance, and better fulfill your requirements. The migration tools provide a lift and shift solution. They replicate what you have in IBM Cognos Series 7 in an IBM Cognos 8 environment. This solution may be the right one for you. But you can also use the migration tools to give you a head start in a compress and optimize solution. For example, you can use the migration tools to migrate the basic metadata or queries to IBM Cognos 8, and then rework your reports so that they are better optimized in IBM Cognos 8. The size of your applications is also a factor in deciding which approach you should take. If you have large or many applications, the compress and optimize approach may seem difficult or overly expensive. In this case, we recommend that you do not migrate all of your applications right away. You can build new applications in IBM Cognos 8 and keep existing applications going in IBM Cognos Series 7. Over time, migrate your applications as business drivers present themselves using the compress and optimize approach.

Installation and Configuration Guide 11

Chapter 1: Where Do I Start?

Recommendation - Choosing the Best Migration Path

Choose the best migration path for your environment to obtain optimal results. When migrating IBM Cognos Series 7 version 3 applications to IBM Cognos 8 version 8.3, different migration paths are possible. Some paths may require more time and effort to implement and may not give you the best results. If you have not yet started a migration project, we recommend that you follow this migration path from Series 7 version 3 to IBM Cognos 8 8.3: 1. Upgrade Series 7 content from version 3 to version 4 using the documented Series 7 upgrade process. 2. Use the 8.3 version of the migration tools to migrate from version 4 to 8.3. Following this approach yields the most predictable results. You can leverage the reliable upgrade between versions of Series 7 and take advantage of the latest version of the migration tools. If you have already started to migrate using an older version of the migration tools such as the 8.2 version, continue with that version of the tools for this particular migration project. You can then upgrade earlier versions of IBM Cognos 8, such as IBM Cognos 8 8.2, to IBM Cognos 8 8.3. However, you may want to consult the guide Planning a Migration from Series 7 to IBM Cognos 8 BI as well as the Cognos Services Implementation Methodology (Cognos SIM) and the BI Migration Roadmap. For your next migration project, you will likely want to move to the latest version of the migration tools. Note: If you have Series 7 version 4, you must use the 8.3 version of the migration tools to migrate to IBM Cognos 8 8.3. Only that version of the tools supports migration of version 4 content to IBM Cognos 8 8.3.

What to Expect When You Move Content from IBM Cognos Series 7 to IBM Cognos 8
Because of differences in product architecture and functionality, it is not possible to simply reuse IBM Cognos Series 7 metadata or applications in IBM Cognos 8. We provide migration tools to help you take advantage of investments you have made in IBM Cognos Series 7. However, to successfully move to IBM Cognos 8, as well as using the migration tools, additional work may be required to prepare for the migration, and to test and refine the migrated content in IBM Cognos 8. For more information, see "The Migration Process" (p. 19). As part of the migration planning process, we recommend that you move a subset of your IBM Cognos Series 7 content and then assess the results and the amount of work required to refine the content in IBM Cognos 8. Sometimes only minor updates, such as formatting changes, are required in IBM Cognos 8. In other cases you may find that an IBM Cognos Series 7 feature that is important to you is not available in IBM Cognos 8. After testing the migration process with a subset of your IBM Cognos Series 7 content, you can decide if reusing the content saves time when developing an IBM Cognos 8 application or if it is more efficient to re-create the application in IBM Cognos 8.

12 Migration Tools

Chapter 1: Where Do I Start? There are some differences between IBM Cognos Series 7 and IBM Cognos 8 that can affect how IBM Cognos Series 7 content appears after migration to IBM Cognos 8. Examples of these differences include default settings, report formatting, and language support. General considerations for various migration scenarios are described in the following sections.

IBM Cognos Series 7 Products and Components Migrated With Tools

You can migrate the following products and components to IBM Cognos 8 using the migration tools.

PowerCubes and Transformer Models

You can continue to use IBM Cognos Series 7 Transformer to build and maintain .mdc-format PowerCubes for use in IBM Cognos 8. You can build PowerCubes that are unsecured or secured using your IBM Cognos Series 7 namespace. Conversely, you can use PowerCubes from IBM Cognos 8.3 and above in Series 7 products, provided they have not been designed with IBM Cognos 8 security (including Series 7 namespaces configured in IBM Cognos 8). You can install Series 7 and IBM Cognos 8.3 Transformer and above on the same computer, allowing for a smoother upgrade of PowerCubes. However, models saved in IBM Cognos 8.3 and above are not backward compatible to Series 7. Transformer 8.3 and above allow an easy upgrade path for any Series 7 model. You can simply open MDL files and save them in the newer version. When deploying these PowerCubes, you may consider the following tasks: Re-associate your Series 7 User Class views in Transformer to use a configured IBM Cognos 8 security provider. Modify your data sources to point to IBM Cognos 8 reports or packages, leveraging the open data access strategy and removing dependencies on IQDs or other flat files. Publish PowerCubes directly from the Transformer UI or command line into your own predefined folder structure in IBM Cognos Connection. Publishing PowerCube packages into folders allows a single cube per package in a more organized format.

For more information about upgrading Series 7 Transformer models and building IBM Cognos 8 PowerCubes, see the IBM Cognos 8 Transformer User Guide.

Impromptu
You can migrate Impromptu catalogs and reports to IBM Cognos 8. You use migrated catalogs as a metadata source for Framework Manager. The metadata migration tools export the IBM Cognos Series 7 metadata to an XML format file. In IBM Cognos 8, you can use the XML file as a metadata source in a Framework Manager model. After completing the catalog migration process, you can migrate Impromptu reports to Report Studio.

Installation and Configuration Guide 13

Chapter 1: Where Do I Start?

PowerPlay
You can migrate PowerPlay Windows reports, PowerPlay Web Explorer reports, or PowerPlay for Windows reports published to PowerPlay Web to IBM Cognos 8 using the migration tools. You can choose whether to migrate PowerPlay applications to IBM Cognos 8 PowerPlay, or to migrate PowerPlay reports directly to IBM Cognos 8 Report Studio and IBM Cognos 8 Analysis Studio.

Migrating to IBM Cognos 8 PowerPlay

You can migrate everything directly to IBM Cognos 8 BI PowerPlay Studio and continue to use the application as before. You use the Migration Assistant to migrate your PowerPlay content from IBM Cognos Series 7, Upfront or PowerPlay Enterprise Server, or IBM Cognos Series 7 content previously published to IBM Cognos Connection. Once in IBM Cognos 8 PowerPlay, the user experience is the same when you move from PowerPlay Web to PowerPlay Studio, or from the IBM Cognos Series 7 to IBM Cognos 8 versions of PowerPlay Client. In IBM Cognos 8, all data sources are accessed through packages. The package contains connection information that identifies the data source, such as the cube or database connection information. The cube connection information includes the cube location on your file system. When you migrate to IBM Cognos 8, your PowerCubes are mapped to packages. A package contains connection information for your PowerCubes. Users can then create new reports using the migrated packages. Users with access to other IBM Cognos 8 studios can also use these migrated packages to create new reports using your original IBM Cognos Series 7 PowerCubes as data sources. This allows you to extend the use of your existing cubes.

Migrating From PowerPlay to other IBM Cognos 8 Studios

Once you have migrated to IBM Cognos 8 PowerPlay, you can also choose to take advantage of the benefits available in other IBM Cognos 8 studios, specifically Report Studio and Analysis Studio. Opening a PowerPlay report in Report Studio or Analysis Studio migrates the PowerPlay report (.ppx) to a Report Studio or Analysis Studio report. Report Studio provides functionality to create statement-style reports that deliver timely and accurate information required for performance management. Analysis Studio provides deep, comparative analysis and the functionality to solve business problems. It provides access to: large amounts of data dimensionally-modeled relational data more data sources, such as cubes from other providers additional calculations, such as average, count and variance

When you migrate your IBM Cognos Series 7 PowerPlay reports to IBM Cognos 8 PowerPlay, all of the functionality and appearance is preserved; however, when you open the report in Report Studio or Analysis Studio, you may notice some differences. The differences will depend on the complexity of the report, and features you used in PowerPlay may not be available in Report Studio or Analysis Studio. You should understand the benefits of each IBM Cognos 8 studio, and how they differ from each other. For example,

14 Migration Tools

Chapter 1: Where Do I Start? if a report is run and viewed on a regular basis with little or no requirement to explore or analyze the data in the report, Report Studio is the most appropriate target if a report has characteristics such as complex formatting, Report Studio is the most appropriate target if a report is used as a starting place for exploration or discovery, PowerPlay Studio is the most appropriate target if a report consumer needs to analyze the information in a report to understand a problem or gain insight into the business by looking at different perspectives of the data, Analysis Studio is the most appropriate target

There are two methods for migrating PowerPlay reports to Report Studio and Analysis Studio: You can use the migration tools to migrate a set of PowerPlay reports from the IBM Cognos Series 7 environment to the IBM Cognos 8 environment. You can already migrate published PowerPlay 7 reports from IBM Cognos Series 7 to IBM Cognos 8 (interoperability between IBM Cognos Series 7 and IBM Cognos 8 BI), or you can migrate PowerPlay Studio reports to Report Studio or Analysis Studio. To use this option, in either IBM Cognos Connection or PowerPlay Studio, select either Open with Analysis Studio or Open with Report Studio from the available actions. The report is migrated to the studio you used to open the report, and you can choose whether or not to save the migrated report. The original PowerPlay report is still available in IBM Cognos Connection whether or not you save the migrated report. The migration tools preserve as much of the report structure, functionality, and formatting as possible from the original report. However, there may be differences between the original and migrated versions of reports. If after you migrate reports to Analysis Studio you find that functionality is missing in some reports, run the migration again to migrate the reports to Report Studio. If Analysis Studio was not the appropriate target studio, opening the report migrated to Analysis Studio in Report Studio does not restore lost functionality. You must repeat the migration process and specify Report Studio as the target studio. For more information about how to migrate reports from PowerPlay to Report Studio or Analysis Studio, see the IBM Cognos 8 Migration Tools User Guide, or the IBM Cognos 8 PowerPlay Migration and Administration Guide.

Upfront
You can migrate Upfront content to IBM Cognos 8. The migration process maps the Upfront content structure and security to an IBM Cognos Connection folder structure. By preserving the existing Upfront organization, it is easier to complete administrative tasks, such as applying security to the migrated content.

Impromptu Web Reports

You can migrate Impromptu Web Reports to IBM Cognos 8. You migrate Impromptu Web Reports using an IBM Cognos Series 7 Deployment Manager package as the migration source. Before you

Installation and Configuration Guide 15

Chapter 1: Where Do I Start? migrate Impromptu Web Reports you must migrate the Impromptu catalog metadata used by the reports. Note: PowerPrompts are not migrated, but you can implement similar functionality using the IBM Cognos 8 Software Development Kit.

Architect
You can migrate Architect models for use as a metadata source for Framework Manager.

Security
You can include IBM Cognos Series 7 security information when you migrate IBM Cognos Webbased content in Upfront. The migration process supports Access Manager namespace schema version 15.2 or later. If you configure IBM Cognos 8 to use the same namespace as IBM Cognos Series 7, you maintain other security settings: Impromptu catalog security such as table filters and access permissions, including when these security settings are inherited in an Impromptu report. The user classes in the catalog must exist in the IBM Cognos Series 7 namespace. Architect model security

Migration does not include database signons. If you decide to change authentication sources, we recommend that you use the IBM Cognos 8 namespace groups and roles when applying application-level security. You then manage the membership of these IBM Cognos namespace groups and roles using the users, groups, and roles from your authentication source. This method ensures that you redefine the memberships for the IBM Cognos namespace groups and roles only if the authentication source changes. For more information, see the IBM Cognos 8 Administration and Security Guide. You can upgrade Series 7 Transformer models containing IBM Cognos Access Manager security and you can continue using that same security if desired. To do this, you must configure IBM Cognos 8 against the same Series 7 Access Manager namespace that the upgrading Transformer model uses. You can only use IBM Cognos 8 PowerCubes built with Series 7 security in IBM Cognos 8 products, because the security has been upgraded to use IBM Cognos 8 unique IDs for each user class. For more information, see the IBM Cognos 8 Transformer User Guide.

IBM Cognos Series 7 Products and Components Not Migrated With Tools
The migration tools do not migrate the following IBM Cognos Series 7 products and components. However, you can duplicate most content or functionality in IBM Cognos 8.

16 Migration Tools

Chapter 1: Where Do I Start?

IBM Cognos Query

The migration tools do not move IBM Cognos Query objects, such as saved queries, to IBM Cognos 8. The migration log file identifies IBM Cognos Query objects found in the migration source. You can duplicate most IBM Cognos Query functionality in IBM Cognos 8. Foundation queries are available in IBM Cognos 8 when you migrate an Architect model. Also, you can manually replicate saved queries using SQL components in Report Studio.

IBM Cognos Visualizer

The migration tools do not move IBM Cognos Visualizer objects to IBM Cognos 8. You can duplicate most IBM Cognos Visualizer functionality using the charting, layout, and formatting options in Analysis Studio or Report Studio.

IBM Cognos NoticeCast

The migration tools do not move IBM Cognos NoticeCast objects to IBM Cognos 8. You can duplicate most alert and notification functionality using Event Studio.

IBM Cognos Web Services

The migration tools do not move IBM Cognos Web Services objects to IBM Cognos 8. You can duplicate most IBM Cognos Web Services functionality using the IBM Cognos 8 Software Development Kit.

PowerPlay for Excel

You can export a PowerPlay query from your spreadsheets and convert it to an IBM Cognos 8 Analysis Studio or Report Studio report. To work with values in spreadsheets, you can duplicate your PowerPlay for Excel functionality using IBM Cognos Analysis for Microsoft Excel.

IBM CognosScript
The migration tools do not move IBM CognosScript objects to IBM Cognos 8. You can duplicate automation functionality using the IBM Cognos 8 Software Development Kit.

IBM Cognos Portal Services

The migration tools do not move IBM Cognos Portal Services objects to IBM Cognos 8. You can duplicate most IBM Cognos Portal Services functionality using IBM Cognos Connection.

Installation and Configuration Guide 17

Chapter 1: Where Do I Start?

18 Migration Tools

Chapter 2: The Migration Process

To ensure that you achieve the expected results when you move metadata and applications from IBM Cognos Series 7 to IBM Cognos 8, complete a thorough initial research and planning before you use the migration tools. After you use the tools to move the IBM Cognos Series 7 content to the IBM Cognos 8 environment, you need to test and refine the applications. You can move content only from IBM Cognos Series 7 version 4 to IBM Cognos 8 8.3. If you are using an earlier version of IBM Cognos Series 7, you must migrate the software and data to IBM Cognos Series 7 version 4 before the migration to IBM Cognos 8. Note: The report specification has changed between IBM Cognos ReportNet 1.1 and IBM Cognos 8. You must use the IBM Cognos ReportNet 1.1 version of the migration tools to move IBM Cognos Series 7 content to IBM Cognos ReportNet 1.1. You cannot use the migration tools described in this document to migrate Architect models, Impromptu catalogs, or Impromptu reports to IBM Cognos ReportNet 1.1. You cannot migrate IBM Cognos Series 7 Web-based content (PowerPlay Web, Impromptu Web Reports, Upfront) as well as PowerPlay Windows content to IBM Cognos ReportNet 1.1. The following table describes what tool you need to migrate different applications to IBM Cognos ReportNet.

Migration source
Architect models

ReportNet migration tool

IBM Cognos ReportNet 1.1 Architect to Framework Manager model migration tool (arch2xml74) IBM Cognos ReportNet 1.1 Impromptu migration tools (migratetocrn, deploytocrn) Not supported. We do not provide migration tools to move PowerPlay content to IBM Cognos ReportNet. Not supported. We do not provide migration tools to move Impromptu Web Reports content to IBM Cognos ReportNet. Not supported. We do not provide migration tools to move Upfront content to IBM Cognos ReportNet.

Impromptu catalogs and reports

PowerPlay

Impromptu Web Reports

Upfront

The following table describes what tool you need to migrate different applications to IBM Cognos 8 Business Intelligence.

Installation and Configuration Guide 19

Chapter 2: The Migration Process

Migration source
Architect models

IBM Cognos 8 migration tool

IBM Cognos 8 Architect to Framework Manager model migration Tool (arch2xml74) IBM Cognos 8 migration tools (migratetoc8, deploytoc8) IBM Cognos 8 migration tools (migratetoc8, deploytoc8) IBM Cognos 8 migration tools (migratetoc8, deploytoc8) IBM Cognos 8 migration tools (migratetoc8, deploytoc8)

Impromptu catalogs and reports PowerPlay Impromptu Web Reports Upfront

You can migrate the following types of content to all supported IBM Cognos 8 platforms except Linux or Hewlett-Packard Itanium: IBM Cognos Series 7 Web-based content, such as PowerPlay, PowerPlay Web Explorer, and Impromptu Web Reports reports, from Windows and UNIX Impromptu reports and catalogs from Windows Architect models from Windows

The IBM Cognos Resource Center offers a variety of support options for migration, including both planning and implementation services. For more information about migration services, visit the IBM Cognos Resource Center Web site (http://www.ibm.com/software/data/support/cognos_crc. html). The migration process consists of the following steps: Familiarize yourself with the overall migration process and considerations. Some steps in the migration process are different from other tasks that you perform in an IBM Cognos environment. However, you will be familiar with many of the tasks you perform before and after you use the migration tools. Some IBM Cognos Series 7 content is not migrated to IBM Cognos 8 by the tools. Review the migration considerations (p. 13) to understand which products, components, and functionality are covered by migration. Recruit people with the appropriate knowledge to assist with the migration process. In addition to product knowledge of both IBM Cognos Series 7 and IBM Cognos 8, you need knowledge about other details of the IBM Cognos environment such as data sources and security. Cognos Consulting Services can help with your migration. For more information, contact your local services manager, visit http://support.cognos.com/consulting, or send an email to gcs@cognos.com. Set expectations about the migration process (p. 12).

20 Migration Tools

Chapter 2: The Migration Process The migration tools help you take advantage of investments in IBM Cognos Series 7 applications. However, the use of these tools is only one part of the migration process. For all migrations, there is additional work to prepare for the migration. Also, you must test and refine the migrated content in IBM Cognos 8 before you make the content available to users. Review the IBM Cognos Series 7 applications and identify the parts to migrate. Work with data modelers, report authors, and report consumers to identify the content for migration to IBM Cognos 8. If auditing is enabled for IBM Cognos Series 7 products, you can use the audit information to determine content use patterns. Do not migrate content unless you identified a need for the content to be available in IBM Cognos 8. Do not migrate content that will be a duplicate of content already available in the IBM Cognos 8 environment. In some cases you can reduce the number of reports by using IBM Cognos 8 functionality such as bursting, prompts, and support for multiple languages. Ensure that IBM Cognos Series 7 applications work as expected. The migration tools do not fix errors in the IBM Cognos Series 7 content. Ensure that metadata and reports do not include errors before migration to IBM Cognos 8. For example, run the IBM Cognos Series 7 user cleanup tool from IBM Cognos Series 7 Upfront Server Administration to identify and delete invalid resources from the Upfront content store. This tool will delete Personal NewsBoxes and content related to users that were deleted from Access Manager. For more information, see the Upfront Server Administrator Guide. run the IBM Cognos Series 7 PowerPlay administration tool ppserver -ppx to identify unused or corrupt PowerPlay .ppx files. You can use errors in the command output to identify content that cannot be found or read by the migration tools. If you dont delete this invalid content, there will be errors when you create a Deployment Manager package. For more information, see the IBM Cognos Series 7 Solution Installation Guide. ensure that the IBM Cognos Series 7 Deployment Manager package is free from errors before using the package as a migration source. Deployment Manager errors will identify problems such as NewsItems with invalid gateway URL references, or content providers that were not available. These errors can cause problems if not corrected before migration. For more information, see the Deployment Manager User Guide. Using the appropriate migration tools, move a representative subset of your metadata and applications to an IBM Cognos 8 test environment. Test the migration process to understand how the content will appear in IBM Cognos 8 and the amount of work required to refine the content. Migrate and test PowerPlay reports in both Analysis Studio and Report Studio to determine which studio is the most appropriate target for your application. Feedback from this testing stage provides the best time and resource requirements for the migration process and will help you develop your project plan. Another option for testing the migration process is to use the samples installed with IBM Cognos Series 7. By default, the IBM Cognos Series 7 samples are installed in C:\Program Files\Cognos\ cer5\samples. There are also samples provided which show you how the migration tools work.

Installation and Configuration Guide 21

Chapter 2: The Migration Process Develop a plan for completing the migration. Based on the review of the IBM Cognos Series 7 applications and the results of the testing, develop a detailed plan for moving metadata and applications to IBM Cognos 8. One option is to move subsets of the IBM Cognos Series 7 content based on specific business requirements. Migrate metadata and applications to the IBM Cognos 8 production environment. Test and refine the content. Work with data modelers, report authors, and report consumers to test and refine the migrated content. Instead of attempting to maintain the same metadata and applications in both IBM Cognos Series 7 and IBM Cognos 8 environments, consider the move to IBM Cognos 8 as a one-time process. After you move the IBM Cognos Series 7 metadata and applications to IBM Cognos 8, encourage modelers, report authors, and end users to adopt IBM Cognos 8. Otherwise, to synchronize IBM Cognos 8 with changes in IBM Cognos Series 7, you must repeat the migration process, including the work required to refine the IBM Cognos Series 7 content in IBM Cognos 8.

22 Migration Tools

Chapter 3: Installing and Configuring the IBM Cognos 8 Migration Tools

You must install one or more tools to move metadata and applications from IBM Cognos Series 7 to IBM Cognos 8. The number of tools you require depends on the type of content you want to migrate. You can move metadata and applications only from IBM Cognos Series 7 version 4 MR3 to IBM Cognos 8 version 8.4. To migrate Architect models, you require a single tool, the Architect to Framework Manager model migration tool. This tool converts an Architect model to an XML format file that you can use as a metadata source in Framework Manager. You do not have to install additional tools with IBM Cognos 8. When you install the Architect to Framework Manager model migration tool, two versions of the tool are installed. To migrate Series 7 version 4 models, you must use the arch2xml74 version of the tool. To migrate Series 7 version 3 and earlier models, you must use the arch2xml version of the tool. Note that IBM Cognos no longer supports this version of the Architect model migration tool. To migrate Impromptu catalogs, you require a single tool, the Series 7 migration tool. The IBM Cognos Series 7 migration tool converts an Impromptu catalog to an XML format file that you can use as a metadata source in Framework Manager. You do not have to install additional tools with IBM Cognos 8. To migrate other types of IBM Cognos Series 7 content, such as PowerPlay reports, to IBM Cognos 8, you require two tools. The Series 7 migration tool creates a migration package that you deploy in IBM Cognos 8 using the IBM Cognos 8 migration tool.

The migration tools require with Java Runtime Environment (JRE) 1.4.2 or higher. For more information, see the software environments information on the IBM Cognos Resource Center Web site (http://www.ibm.com/software/data/support/cognos_crc.html). Use the following checklist to guide through the tasks to install and configure the IBM Cognos 8 migration tools. Install the migration tools (p. 23). Start the IBM Cognos Series 7 migration service (p. 25).

Install the Migration Tools

The IBM Cognos 8 migration tools are available on Windows and UNIX. The migration tools are not included on the IBM Cognos 8 CDs. You can download the tools or you can request a CD. For more information, go to the IBM Cognos Resource Center Web site (http://www.ibm.com/software/ data/support/cognos_crc.html).

Installation and Configuration Guide 23

Chapter 3: Installing and Configuring the IBM Cognos 8 Migration Tools You must install the Series 7 migration components in the same location as IBM Cognos Series 7. For example, if you used the default installation directory when you installed IBM Cognos Series 7 version 4 on Windows, install the migration components in C:\Program Files\Cognos\cer5. Note: PowerPlay Enterprise Server does not have to be installed in order to migrate PowerPlay reports. If you are upgrading PowerPlay reports published to IBM Cognos 8, you do not have to install the Series 7 migration components. You have to install only the IBM Cognos 8 migration components. You must install the IBM Cognos 8 migration components in the IBM Cognos 8 installation location. For example, if you used the default installation directory when you installed IBM Cognos 8 on Windows, install the components in C:\Program Files\cognos\c8. Ensure that your IBM Cognos Series 7 and IBM Cognos 8 installations are working correctly before installing the migration tools. This includes ensuring that the IBM Cognos Series 7 PowerPlay Enterprise Server service and the Upfront services, including the IBM Cognos Upfront Administration Service, IBM Cognos Upfront Data Store, and the IBM Cognos Upfront Dispatcher services, are running. You install the IBM Cognos Series 7 migration components on the IBM Cognos Series 7 computers. To migrate content from a PowerPlay Enterprise Server, you must install the IBM Cognos Series 7 migration components on the PowerPlay Enterprise Server computer. If Upfront is located on the same computer, you can also migrate content from Upfront. Installing migration components on the PowerPlay Enterprise Server computer also supports the migration of PowerPlay content that was published to IBM Cognos Connection. To migrate content from Upfront, you must install the Series 7 migration components on the Upfront computer. When Upfront and PowerPlay Enterprise Server are installed on separate computers, you must install the Series 7 migration components on the both the PowerPlay Enterprise Server computer and the Upfront computer. Also, you must set up and configure a shared network location to support migration processing.

You install the IBM Cognos 8 migration components on the IBM Cognos 8 computers. Install IBM Cognos 8 migration components on the appropriate computer. For example, install the Migration Application Tier components on the computer where the IBM Cognos 8 application tier components are installed.

Steps
1. Go to the location where the installation files were downloaded and extracted or insert the IBM Cognos 8 migration tools CD that is appropriate for your operating system. On UNIX, you must mount the CD using Rock Ridge file extensions. 2. If the Welcome page does not appear, do one of the following: On Windows, in the win32 directory, double-click the issetup.exe file. On UNIX, in the directory that is appropriate for your operating system, type ./issetup 3. Select the language to use for the installation.

24 Migration Tools

Chapter 3: Installing and Configuring the IBM Cognos 8 Migration Tools The language that you select determines the language of the installation wizard. 4. Follow the directions in the installation wizard. 5. On the Component Selection page, select the components that you want to install. 6. In the Multiple Installation Locations page, specify the locations to install the Series 7 and IBM Cognos 8 migration components. If you install only the Series 7 migration components and you prompted for an IBM Cognos 8 installation location, you can accept the default location or enter a new local location. This location is used to write install files. You do not have to enter the path to an IBM Cognos 8 installation on a different computer and you do not require IBM Cognos 8 components on the IBM Cognos Series 7 computer. 7. In the Migration Configuration Information page, for the Migration Service Port Number, type a port number that the IBM Cognos Series 7 migration service will use. The default is 21567. 8. In the Finish page, click Finish. Like other IBM Cognos products, the installation process creates log files (p. 35) that include information such as details about transferred files and installation errors. The installation process for the migration tools does not create or modify any registry entries.

Start the IBM Cognos Series 7 Migration Service

Before you can migrate content from IBM Cognos Series 7 PowerPlay to IBM Cognos 8, you must start the migration service for IBM Cognos Series 7. By default, the migration service for IBM Cognos Series 7 starts automatically when it is first installed. If the migration service is stopped, follow the steps below to start it.

Steps
1. If you are on Windows, start the migration service using the IBM Cognos Migration Series 7 Service entry in the Services list under Administrative Tools. 2. If you are on UNIX, go to the c8_location/migs7 directory and start the service by typing ./configure.sh --start

Uninstalling the IBM Cognos 8 Migration Tools

To uninstall the IBM Cognos 8 migration tools, two separate install mechanisms exist to uninstall the Series 7 migration components and the IBM Cognos 8 migration components. In distributed environments, uninstall migration components from all computers on which the components were installed.

Series 7 Migration Components

Series 7 migration components are uninstalled through the IBM Cognos Series 7 uninstall mechanism.

Installation and Configuration Guide 25

Chapter 3: Installing and Configuring the IBM Cognos 8 Migration Tools On Windows, through Add or Remove Programs in the Control Panel, uninstall IBM Cognos Report Migration from Series 7. On UNIX, uninstall the migration components by running the Series 7 uninstall tool and selecting Series 7 Migration Component.

IBM Cognos 8 Migration Components

IBM Cognos 8 migration components are uninstalled through the IBM Cognos 8 uninstall mechanism.

26 Migration Tools

Chapter 4: Configure IBM Cognos 8 to Support PowerPlay Report Migration

If you have PowerPlay reports published to IBM Cognos Connection, you can migrate those reports to Analysis Studio or Report Studio directly from IBM Cognos Connection. You migrate reports by using the using the Open With Analysis Studio or Open With Report Studio functionality. You can migrate only one report at a time using this functionality. PowerPlay reports published to IBM Cognos Connection are migrated using the migration service. Migration is a service in the IBM Cognos 8 service-oriented architecture. The migration service migrates PowerPlay reports published to IBM Cognos Connection from IBM Cognos Series 7 to Report Studio or Analysis Studio, using the Open With Analysis Studio or Open With Report Studio functionality. You can enable and disable the migration service on the local computer. The migration service must be started before you can use the Open With Analysis Studio or Open With Report Studio functionality to migrate PowerPlay reports. The migration service does not need to be started if you are using the migration tools in command line form. To do this, you must configure IBM Cognos 8 to enable PowerPlay report migration. This involves the following tasks: Install the IBM Cognos 8 migration components (p. 23). You do not have to install the IBM Cognos Series 7 migration components. Set permissions to enable users to open PowerPlay reports in IBM Cognos 8 (p. 28). Ensure that the reports can map to a package. To support PowerPlay report migration, create data source connections to the required cubes using either Framework Manager or IBM Cognos Connection. In Framework Manager, use the cube data source in a Framework Manager project, and then publish a package to IBM Cognos Connection using the cube name for the package name. For example, if reports use a cube named Great_Outdoors, create and publish a package named Great_Outdoors. You must create a separate package for each cube. For more information, see the IBM Cognos 8 Administration and Security Guide, and the Framework Manager User Guide. If a PowerPlay report is built on a package with a secure cube or the package has multiple data source connections, you must configure each data source connection in IBM Cognos Administration to prompt users for the required information when the report is opened in Analysis Studio or Report Studio. Ensure the IBM Cognos 8 migration service is started.

Installation and Configuration Guide 27

Chapter 4: Configure IBM Cognos 8 to Support PowerPlay Report Migration

Enable Users to Open PowerPlay Reports in Report Studio or Analysis Studio

To allow other users to open PowerPlay reports in Report Studio or Analysis Studio, an administrator must provide the user with the appropriate capabilities to do so. The users or groups you want to be able to open reports in Report Studio or Analysis Studio must have both Execute and Traverse permissions for the appropriate capabilities. Capabilities can be added for individual users or for groups. For more information about managing users, groups, and capabilities in IBM Cognos 8, see the Administration and Security Guide. When you open a PowerPlay report in Report Studio or Analysis Studio, you may notice some differences. The differences will depend on the complexity of the report and the features that you used in PowerPlay may not be available in Report Studio or Analysis Studio. You and your users should understand the benefits of each IBM Cognos 8 studio and how they are different. Any error messages resulting from opening PowerPlay reports in Report Studio or Analysis Studio are logged to the IBM Cognos 8 log location configured in IBM Cognos Configuration.

Steps for Report Studio Users

1. In IBM Cognos Administration, on the Security tab, click Capabilities. 2. Click Report Studio. 3. Click the arrow next to Create/Delete, and click Set Properties. 4. In the Set Properties dialog box, click the Permissions tab. 5. Click Add, to add users or groups. You may have to select Override the access permissions acquired from the parent entry to allow you to add new users and change permissions. For more information, click Help or see the Administration and Security Guide. 6. For each user or group you want to be able to open reports in Report Studio, select Execute and Traverse permissions. 7. Click OK to return to the list of capabilities. 8. Click the arrow next to Open PowerPlay Reports with Report Studio, and click Set Properties. 9. In the Set Properties dialog box, click the Permissions tab. 10. Click Add, to add users or groups. 11. For each user or group you want to be able to open reports in Report Studio, select Execute and Traverse permissions. 12. Click OK.

28 Migration Tools

Chapter 4: Configure IBM Cognos 8 to Support PowerPlay Report Migration Users can now choose to open a migrated PowerPlay report in Report Studio.

Steps for Analysis Studio Users

1. In IBM Cognos Administration, on the Security tab, click Capabilities. 2. Click Analysis Studio. 3. Click the arrow next to Open PowerPlay Reports with Analysis Studio, and click Set Properties. 4. In the Set Properties dialog box, click the Permissions tab. 5. Click Add, to add users or groups. You may have to select Override the access permissions acquired from the parent entry to allow you to add new users and change permissions. For more information, click Help or see the Administration and Security Guide. 6. For each user or group you want to be able to open reports in Analysis Studio, select Execute and Traverse permissions. 7. Click OK. Users can now choose to open a migrated PowerPlay report in Analysis Studio.

Configure Data Sources that Reference Secure Cubes

If a PowerPlay report is built on a package that references a data source which in turn references a password secured cube, you must configure each data source in IBM Cognos Administration to prompt users for the required information when the report is opened in Analysis Studio or Report Studio.

Steps
1. In IBM Cognos Configuration, click the Configuration tab. 2. Click the data source that is used to connect to the secure cube. 3. Click More and then click Set properties to open the data source's properties page. 4. Click the Connection tab. 5. Click the Edit the connection string button 6. Check the Cube password check box. When the PowerPlay report is opened in Analysis Studio or Report Studio, users are prompted to select a data source if the report's package references several data sources. If the selected data source references a password secured cube, users are then prompted to enter a password. The report then opens in the chosen studio. Users are prompted again for the same information. Tip: The information you enter is cached in the selected studio and does not have to be entered again in the same browser session. .

Installation and Configuration Guide 29

Chapter 4: Configure IBM Cognos 8 to Support PowerPlay Report Migration

30 Migration Tools

Chapter 5: Setting Up the Samples

You can use the IBM Cognos samples to see how the migration tools migrate IBM Cognos Series 7 content to IBM Cognos 8. In addition, the migrated reports were modified to highlight features that are available only in IBM Cognos 8 or features that are improvements over IBM Cognos Series 7. The samples included with the migration tools are in English only. Migration samples in other languages are available from the IBM Cognos Resource Center Web site (http://www.ibm.com/ software/data/support/cognos_crc.html). Before you can set up the samples, you must install the migration tools. The samples are installed when the Migration Content Manager Components are installed. To set up the samples, do the following: Create a data source connection to the sample PowerCube. Create a data source connection to the sample Impromptu catalog. Import the samples content (packages) into the IBM Cognos 8 content store.

After you complete these tasks, use Analysis Studio and Report Studio to run the sample reports. You can later remove the samples. For information about the samples, see the Migration Tools User Guide.

Create a Data Source Connection to the Sample PowerCube

The migration tools provide the Great Outdoors sample PowerCube. This is the same sample PowerCube that is used in IBM Cognos Series 7. You must create data source connections to this PowerCube to use the PowerPlay samples. To create data source connections, you must have execute permissions for the Directory secured feature and traverse permissions for the Administration secured function.

Steps
1. Open IBM Cognos Connection. 2. In the upper-right corner, click Launch, IBM Cognos Administration. 3. On the Configuration tab, click Data Source Connections. 4. Click the new data source button .

5. In the Name box, type Great Outdoors and then click Next. 6. In the connection page, under Type, click IBM Cognos PowerCube, click the appropriate isolation level, and then click Next. The connection string page for the selected data source appears. Installation and Configuration Guide 31

Chapter 5: Setting Up the Samples 7. In the Read cache size (MB) box, type the cache size of the PowerCube in megabytes. If you leave this field blank or type 0, IBM Cognos Connection uses the default value in the ppds_cfg.xml file in the configuration folder. 8. In the Windows location box, type the location and name of the Great Outdoors.mdc file as follows: c8_location/webcontent/samples/reports/PowerPlay/EN/Great Outdoors.mdc 9. To test whether the parameters are correct, click Test the connection. 10. Click Finish and then click OK.

Create a Data Source Connection to the Sample Impromptu Catalog

The migration tools provide a sample Impromptu catalog named gosales.cat. You must create a data source connection to the catalog to use the Impromptu Web Reports report samples. Before you can create a data source connection to the catalog, you must define an ODBC connection to the Go Sales database. This connection is automatically defined when you install IBM Cognos Series 7.

Steps
1. Open IBM Cognos Connection. 2. In the upper-right corner, click Launch, IBM Cognos Administration. 3. On the Configuration tab, click Data Source Connections. 4. Click the new data source button .

5. In the Name box, type GOS and then click Next. 6. In the connection page, under Type click ODBC, select an isolation level, and then click Next. The connection string page for the selected data source appears. 7. In the ODBC data source box, type GOScer5. 8. To test whether the parameters are correct, click Test the connection. 9. Click Finish.

Import the Samples

To use the sample package and other content, you must import them from the sample deployment archive using the Content Administration tool. Before you import the samples deployment archive, you must create a data source connection to the sample PowerCube as well as to the sample Impromptu catalog.

32 Migration Tools

Chapter 5: Setting Up the Samples To use the Content Administration tool, you must have traverse permissions for the Administration secured function and execute permissions for the Content Administration feature.

Steps
1. Copy the Cognos_Migrated_Samples.zip file from the c8_location/webcontent/samples/content directory to the directory where your deployment archives are saved. The default location is c8_location/deployment. The location is set in the configuration tool. For information about changing the location, see the configuration tool online help. 2. Open IBM Cognos Connection. 3. In the upper-right corner, click Tools, Content Administration. 4. On the toolbar, click the new import button .

5. In the Deployment archive box, click Cognos_Migrated_Samples. 6. Click Next. 7. Type a unique name and, if you want, a description and screen tip for the deployment archive, select the folder where you want to save it, and then click Next. 8. In the Public folders content box, select the packages and folders that you want to import. 9. Select the options that you want, and your conflict resolution choice for each of those options, and then click Next. 10. In the Specify the general options - New Import Wizard page, select whether to include access permissions and references to external namespaces, who should own the entries after they are imported, and the level of detail to save in the deployment record. 11. Click Next. 12. Review the summary information and click Next. 13. Choose whether to run the import once or to schedule the import: To run the import once now or later, click Save and run once, click Finish, specify the time and date for the run, and then click Run. Review the run time and click OK. To schedule the import at a recurring time, click Save and schedule, click Finish, and then select frequency and start and end dates. Click OK. Tip: To temporarily disable the schedule, select the Disable the schedule check box. To save the import without scheduling or running, click Save only and click Finish.

You can now use the sample packages to view and run the migrated reports.

Installation and Configuration Guide 33

Chapter 5: Setting Up the Samples

Remove the Sample Packages from IBM Cognos 8

You can delete the packages on which the samples are based after you finish using the sample reports to learn about migration. This action permanently removes the samples from the content store.

Steps
1. Open IBM Cognos Connection. 2. Click the Public Folders tab. 3. Select the check box for the sample package that you want to delete. 4. Click the delete button on the toolbar, and click OK.

34 Migration Tools

Appendix A: Troubleshooting
Use this troubleshooting reference information and solutions as a resource to help you solve specific problems you may encounter during or after the installation of the migration tools. For more troubleshooting help, see the Migration Tools User Guide. Problems are characterized by their symptoms. Each symptom can be traced to one or more causes by using specific troubleshooting tools and techniques. After being identified, each problem can be fixed by implementing a series of actions. When you are troubleshooting, log files can help you. Another valuable troubleshooting tool is the Knowledge Base, which is available on the IBM Cognos Resource Center Web site (http://www. ibm.com/software/data/support/cognos_crc.html). The Knowledge Base is a database of problems and solutions for all IBM Cognos products. When you cannot resolve a problem, the final resource is your IBM Cognos technical support representative. To analyze a problem, your technical support representative requires information about the situation and the symptoms that you are experiencing. To help isolate the problem, collect the necessary data before you contact your representative.

Log Files
Log files can help you troubleshoot problems by recording the activities that take place when you work with a product. Operations performed by the migration tools are recorded in various log files for tracking purposes. For example, if you experienced problems installing the tools, consult the transfer log file to learn what activities the installation wizard performed while transferring files. Note: We recommend that you regularly monitor the log files and maintain the folders in which they are created. For example, if you are migrating many reports, the size of the folders may grow quickly.

Installation Log Files

The installation wizard creates two log files in the installation_location\instlog directory. The log file names include the product name, version, build number, and time stamp. The transfer log file records the activities that the installation wizard performed while transferring files. The transfer log file is in the installation_location\instlog directory. The file name identifies the product name, version, and build number, and includes a time stamp. The following is an example of the file name format: tl-MIGRATION-8.3.209.345-20061018_1426.txt The transfer summary-error log file records the components you installed, disk space information, the selections you made in the transfer dialogs, and any errors the installation wizard encountered while transferring components. The transfer summary-error log file is in the installation_location/instlog directory. The file name identifies the product name, version, and build number, and includes a time stamp. The following is an example of the file name format:

Installation and Configuration Guide 35

Appendix A: Troubleshooting tl-MIGRATION-8.3.209.345-20061018_1426_summary-error.txt The uninstallation log file records the activities that the Uninstall wizard performed while uninstalling files. The log file is named cognos_uninst_log.htm and is located in the Temp directory. You can use the log file to troubleshoot problems related to uninstalling the migration tools.

IBM Cognos Series 7 Migration Log File

The Series 7 migration process creates a log file named migratetoc8.xml in target\_LOG.

IBM Cognos 8 Migration Log File

The IBM Cognos 8 migration process creates a log file named viewMigrationLog.html in target\_LOG. This log file includes information about the IBM Cognos 8 migration process and the content from the Series 7 migration log file.

Published PowerPlay Reports Migrated to IBM Cognos 8 Log Files

Any errors encountered when migrating PowerPlay reports published to IBM Cognos Connection are logged in c8_location\temp\migrsvp.

36 Migration Tools

Index
Symbols
.ppx files migrating, 14

H
help getting, 6

A
access control list migrating, 16 Access Manager namespace schema versions, 16 Analysis Studio enabling users to migrate content to, 28 selecting for PowerPlay report migration, 14 Architect installing model migration tool, 23 migration overview, 16

I
IBM Cognos 8 installing migration tool, 23 installing migration tool on Windows, 24 upgrading from IBM Cognos ReportNet 1.1, 6 IBM Cognos 8 migration tool installing, 23 IBM Cognos NoticeCast migration overview, 17 IBM Cognos Portal Services migration overview, 17 IBM Cognos Query migration overview, 17 IBM Cognos ReportNet 1.1 upgrading to IBM Cognos 8, 6 IBM Cognos Resource Center, 6, 20 downloading migration tools, 23 IBM CognosScript migration overview, 17 IBM Cognos Series 7 installing migration tools, 23 what is migrated, 13 IBM Cognos Visualizer migration overview, 17 IBM Cognos Web Services migration overview, 17 impcat2xml, 8 importing samples, 32 Impromptu migration overview, 13 Impromptu catalogs exporting, 8 migrating, 8 Impromptu migration tool, 8

C
catalogs installing migration tool, 23 choosing the best migration path, 12 copyright material printing, 6 cubes secured, 29

D
data source connections creating for sample Impromptu catalog, 32 creating for sample PowerCubes, 31 deleting samples, 34 disabling content maintenance job, 33 downloading migration tools, 23

F
finding information, 6

Installation and Configuration Guide 37

Index Impromptu Web Reports migration overview, 15 PowerPrompts, 15 information finding, 6 installing Architect model migration tool, 23 migration tools, 23

N
namespace schema supported versions, 16 new features supported IBM Cognos 8 versions, 7, 8 supported IBM Cognos Series 7 versions, 7, 8 NoticeCast migration overview, 17

J
java runtime environment requirements, 23 JRE requirements, 23

P
planning understanding the migration process, 19 PowerCubes sample, 31 using in IBM Cognos 8, 14 PowerPlay migration overview, 14 using cubes in IBM Cognos 8, 14 PowerPlay for Excel migration overview, 17 PowerPlay reports .ppx files, 14 migration options, 14 selecting IBM Cognos 8 studio for migration, 14 printing copyright material, 6 process migration planning, 19 processes setting up samples, 31

L
log files descripton, 35 installation log file, 35 migration deployment log file, 36 migration export log file, 36 published PowerPlay reports migrated to IBM Cognos 8 log files, 36

M
migrating access control list, 16 migration starting the migration service, 25 understanding the process, 19 migration samples, See samples migration service starting, 25 migration tools Architect models, 23 downloading, 23 IBM Cognos 8, 23 Impromptu catalogs, 23 installing, 23 uninstalling, 25 models installing migration tool, 23 Transformer, 13

R
recommendations choosing the best migration path, 12 related documentation, 5 Report Studio enabling users to migrate content to, 28 selecting for PowerPlay report migration, 14

S
samples creating data source connections to sample PowerCubes, 31 creating data source connection to sample Impromptu catalog, 32 deleting, 34 importing, 32

38 Migration Tools

Index process to set up, 31 secure cubes, 29 security access control list, 16 migration overview, 16 Series 7 migration tool installing, 23 system requirements JRE, 23

T
Transformer models, 13 Transformer PowerCubes, 13 troubleshooting log files, 35

U
uninstalling the migration tools, 25 Upfront migration overview, 15 upgrading IBM Cognos ReportNet 1.1 to IBM Cognos 8, 6 users enabling users to migrate to Analysis Studio, 28 enabling users to migrate to Report Studio, 28

V
versions, 13

W
Windows installing IBM Cognos 8 migration tool, 24

Installation and Configuration Guide 39