CX Supplements to Cognos Tools Installation Guide...include the Jenzabar coordinator, Jenzabar...

Installing CX Supplements 1 Index

CX Supplements to Cognos Tools

Installation Guide

Copyright © 2000 Jenzabar, Inc. All rights reserved.

You may print any part or the whole of this documentation to support installations of Jenzabarsoftware. Where the documentation is available in an electronic format such as PDF or onlinehelp, you may store copies with your Jenzabar software. You may also modify the documentationto reflect your institution's usage and standards. Permission to print, store, or modify copies in noway affects ownership of the documentation; however, Jenzabar, Inc. assumes no responsibilityfor any changes you make.

Filename: incognosDistribution date: 10/05/2000

Contact us at www.jenzabar.com

Jenzabar CX and QuickMate are trademarks of Jenzabar, Inc.INFORMIX, PERFORM, and ACE are registered trademarks of the IBM CorporationImpromptu, PowerPlay, Scenario, and Cognos are registered trademarks of the Cognos CorporationUNIX is a registered trademark in the USA and other countries, licensed exclusively through X/Open Company LimitedWindows is a registered trademark of the Microsoft CorporationAll other brand and product names are trademarks of their respective companies

i

JENZABAR, INC.CX SUPPLEMENTS TO COGNOS TOOLS INSTALLATION GUIDE

TABLE OF CONTENTS

INTRODUCTION........................................................................................................................................... 1

Overview..................................................................................................................................................... 1Purpose of This Guide............................................................................................................................ 1Intended Audience.................................................................................................................................. 1Getting Started........................................................................................................................................ 1

IMPROMPTU ................................................................................................................................................ 3

Overview..................................................................................................................................................... 3Introduction............................................................................................................................................. 3Impromptu Terms You Need To Know................................................................................................... 3Considerations........................................................................................................................................ 4

POWERPLAY ............................................................................................................................................... 5

Overview..................................................................................................................................................... 5Introduction............................................................................................................................................. 5PowerPlay Terms You Need To Know................................................................................................... 5Considerations........................................................................................................................................ 6

TRANSFORMER .......................................................................................................................................... 7

Overview..................................................................................................................................................... 7Introduction............................................................................................................................................. 7Transformer Terms You Need to Know.................................................................................................. 7Considerations........................................................................................................................................ 7

COGNOS QUERY ........................................................................................................................................ 9

Overview..................................................................................................................................................... 9Introduction............................................................................................................................................. 9Cognos Query Terms You Need to Know.............................................................................................. 9Considerations........................................................................................................................................ 9

IMPROMPTU WEB REPORTS SERVER .................................................................................................. 11

Overview................................................................................................................................................... 11Introduction to Impromptu Web Reports Server................................................................................... 11Impromptu Web Reports Server Terms You Need to Know ................................................................ 11Considerations...................................................................................................................................... 12

POWERPLAY ENTERPRISE SERVER..................................................................................................... 13

Overview................................................................................................................................................... 13Introduction to PowerPlay Enterprise Server ....................................................................................... 13Access Manager Terms You Need to Know ........................................................................................ 13Considerations...................................................................................................................................... 15

COGNOS CLIENT-SERVER PRODUCTS INSTALLATION ..................................................................... 17

Overview................................................................................................................................................... 17Introduction........................................................................................................................................... 17Client-Server Requirements ................................................................................................................. 17Types of PC Installation........................................................................................................................ 17Database Connectivity.......................................................................................................................... 17Future Updates..................................................................................................................................... 17

ii

Installing Cognos Client-Server Products ................................................................................................ 18Introduction........................................................................................................................................... 18Step 1: Installation of DCOM Component ............................................................................................ 18Step 2: Informix CLI 3.30 Setup ........................................................................................................... 20Step 3: Post Installation........................................................................................................................ 20Step 4: Testing the CLI Connection ..................................................................................................... 21Step 5: Setting Up Microsoft Data Access Components 2.1a.............................................................. 22Step 6: Setting Up Adobe Acrobat Reader 4.0 .................................................................................... 22Step 7: Installation of Impromptu Administrator 6.0 ............................................................................. 22Step 8: Installation of Impromptu User 6.0 ........................................................................................... 23Step 9: Installation of PowerPlay and Transformer 6.6........................................................................ 23Step 10: Installation of Cognos Query.................................................................................................. 24Step 11: Installation of Example Catalog and Report .......................................................................... 24Step 12: Create a New Database Reference....................................................................................... 25Step 13: Add a Table and Create a Join .............................................................................................. 25Step 14: Add Fields and Filtering ......................................................................................................... 26Step 15: Save the Report ..................................................................................................................... 26Step 16: Create a Model and a Cube................................................................................................... 27Step 17: Create the Upper Level of Cube ............................................................................................ 27Step 18: Drill-Down............................................................................................................................... 29

COGNOS WEB PRODUCTS INSTALLATION.......................................................................................... 31

Overview................................................................................................................................................... 31Introduction........................................................................................................................................... 31Hardware/Software Requirements ....................................................................................................... 31

Installing Cognos Web Products .............................................................................................................. 32Introduction........................................................................................................................................... 32Step 1a: Informix CLI 3.30 Setup ......................................................................................................... 32Step 1b: Post Installation...................................................................................................................... 33Step 1c: Testing the CLI Connection.................................................................................................... 33Step 2: Setting Up Microsoft Data Access Components 2.1a.............................................................. 34Step 3: Setting Up Adobe Acrobat Reader 4.0 .................................................................................... 34Step 4: Cognos Web Product Installations........................................................................................... 34Step 5a: Netscape Directory Server 3.1 Setup .................................................................................... 35Step 5b: Internet Explorer Instructions ................................................................................................. 35Step 5c: Netscape Navigator Instructions ............................................................................................ 36Step 5d: Post Browser Instructions ...................................................................................................... 36Step 6: Impromptu Web Report 6.0 Server Setup ............................................................................... 36Step 7a: Installation of Cognos Distribution Shuttle ............................................................................. 37Step 7b: IWR Post Installation Test...................................................................................................... 37Step 7c: Access Manager Configuration.............................................................................................. 39Step 7d: Connecting Access Manager ................................................................................................. 39Step 7e: Basic Administration – Getting Started .................................................................................. 40Step 7f: Shuttling a Report Set ............................................................................................................. 41Step 7g: Posting a Report Set .............................................................................................................. 41Step 7h: Posted Report Set Option Changes ...................................................................................... 42Step 7i: All Reports and Events View................................................................................................... 42Step 7j: Report Project View................................................................................................................. 42Step 7k: Running a Report through the Web ....................................................................................... 45Step 8a: PowerPlay Enterprise Server 6.6 Setup ................................................................................ 45Step 8b: PowerPlay Enterprise Server Post Installation ...................................................................... 46Step 8c: Publishing a Cube to the Web................................................................................................ 46Step 8d: Creating a Link to IWR........................................................................................................... 46Step 9: Transformation 6.6 Server Setup............................................................................................. 47

iii

Installing Products through Windows Explorer......................................................................................... 48Alternate Options.................................................................................................................................. 48Cognos Client-Server Products – Disk 1.............................................................................................. 48Cognos Web Servers – Disk 2 ............................................................................................................. 48Extra Software ...................................................................................................................................... 48Installation Guides – Disk 1.................................................................................................................. 49Installation Guides – Disk 2.................................................................................................................. 49

ERROR MESSAGES AND FAQS.............................................................................................................. 51

Overview................................................................................................................................................... 51Introduction........................................................................................................................................... 51Error Messages .................................................................................................................................... 51Frequently Asked Questions ................................................................................................................ 52

INDEX ......................................................................................................................................................... 55

Installing CX Supplements 1 Introduction

INTRODUCTION

Overview

Purpose of This Guide

Use this guide to assist in the installation of the Cognos tools:• Impromptu• PowerPlay• Transformer• Cognos Query (CQ)• Impromptu Web Reports Server• PowerPlay Enterprise Server

The information in this guide can help you install these files on a PC or a network server. Use thisguide in setting up a client-server PC or a Web reporting solution with capabilities of addinganalytical analysis through PowerCubes.

Intended Audience

This guide is for use by the system users in your institution’s computer center. System usersinclude the Jenzabar coordinator, Jenzabar system administrator, Impromptu and PowerPlayadministrators, and programmer/analysts.

Getting Started

There are two ways to install the Cognos tools:• Through Microsoft Internet Explorer 4.01 or higher or• By navigating through Windows Explorer

Installing CX Supplements 3 Impromptu

IMPROMPTU

Overview

Introduction

This section contains the following information:• Overview• Terms• Considerations

Impromptu is a client-server reporting tool for administrators and end-users. Impromptu is used toextract data from the database and format it into usable reports for all departments. Impromptureports end with an .imr file extension.

Impromptu Terms You Need To Know

You need to know the following Impromptu terms:

AliasAn alternative label or name for a table. Create an alias to relate values in a single table bycreating a self-join between the table and its alias.

CatalogA file (with the extension .cat) that contains all the information necessary for Impromptu toaccess and retrieve information from a relational database. A catalog does not store data,but it does provide Impromptu with a business view of the data. A catalog also containsinformation about which database to access, where the database is stored, and how thetables in the catalog are joined.

Crosstab reportsA type of report showing summary information from a list report in a compact table of rowsand columns. A crosstab report shows the value for the combination of each row andcolumn, enabling you to gain a different perspective on the data and see more without theneed to scroll.

Drill throughAn action that enables Impromptu to open another detailed Impromptu report on a simplemouse click. You can set up a drill through for any cell in Impromptu.

FilterA set of criteria used to retrieve a specific subset of records for your report. You can use afilter in reports to filter out unnecessary data and highlight the most important information inyour report.

HotFileA separate local data table that can be added to your catalog or used in a report as if it werea regular database table. Once you create a HotFile, any report or catalog can use it. Youcan use a HotFile to link to any database. For example, you can use HotFiles to comparethis month’s data with last month’s data.

JoinA term defining the relational links between tables in the physical database. Joins relate thedata in one table to the data in another table in the same database, enabling you to retrievedata from more than one table at a time.

Impromptu 4 Installing CX Supplements

KeysImpromptu keys consist of one or more columns in the tables and are often used to jointables. Impromptu keys do not have to correspond to database keys.

Outer joinA type of join that retrieves rows from one table even if the rows in another table do notmatch. You can use the following kinds of outer joins:

• A left outer join includes all rows from Table A, matched or not, plus the matchingvalues from Table B.

• A right outer join includes all rows from Table B, matched or not, plus the matchingvalues from Table A.

• A full outer join includes all rows from both tables, merged where matches were found.

PromptA dialog box that requests the user to enter information when a report is opened. A reportcan contain several prompts, which it uses to filter so you get only the data you want.Prompts can require the user to type in information, or select items from a picklist. A picklistcan include data items from the catalog, data items from another report, or data from a file indelimited ASCII format.

SnapshotA permanent local copy of the report and the data retrieved by a report. The data on yourpersonal computer can be shown and manipulated at a later date without having to connectit to the original database.

Sub-reportA sub-report is a sub-query that usually is associated with a main query. You can includeseveral sub-reports in one report. With sub-reports, you can deliver information in one reportthat would otherwise be available only with two or more reports.

Considerations

The following considerations apply to Impromptu:• Impromptu is the first step to retrieving information from the database. An Impromptu report

can be exported into Transformer, which allows for generation of models and cubes.• Impromptu can store information in a snapshot, which does not require an active

connection to the database.• Impromptu catalogs and reports should be stored on a backed up network file server.• For more information about Impromptu and its capabilities, use the Discovering impromptu

link on the Cognos client-server CD.

Installing CX Supplements 5 PowerPlay

POWERPLAY

Overview

Introduction


PowerPlay is a data analysis tool designed for upper-level managers and administrators.PowerPlay’s high-powered graphics give institutional data instant visibility. Powerful features likeranking, exception highlighting, drill-down, slice-and-dice, trending, and comparisons enable theuser to analyze data from multiple perspectives. PowerPlay operates on static copies of the datato maximize response time.

PowerPlay Terms You Need To Know

You need to know the following PowerPlay terms:

CubeA file containing data in an organized manner to be used by the PowerPlay Explorer orReporter. Data is organized into dimensions to provide faster retrieval and drill-down. Cubeshave an .MDC extension and are created in Transformer from the model files. (Cube also isknown as PowerCube.)

ExplorerA program in the PowerPlay package. The Explorer program uses cubes created withPowerPlay Transformer to explore the data in multiple dimensions. The program organizesthe data in rows, columns, and layers. As you drill-down in the Explorer, you are presentedwith each new layer of data available.

ModelThe file created in PowerPlay Transformer defining how a cube will be created to bestdisplay and analyze the data in Explorer. The computer center or Information Systems (IS)department likely will maintain this file. The dimensions that the users see in PowerPlayExplorer or Reporter are specified within the model. This file defines the drill-down levelsand the fields to be used as measurements from the data file. The information for a model isstored in a file with an extension .PYH (binary) or .MDL (ASCII).

PowerPlayThe entire Cognos PowerPlay product including Transformer, Explorer, and Reporter.

ReporterA program in the PowerPlay package that enables you to build powerful reports in a varietyof formats using the cubes created in Transformer. In Reporter, you can show categoriesfrom more than one dimension and more than one level of categories in rows, columns, orlayers. In Reporter, as you drill-down, you are presented with the next layer of data availableand the previous layer.

TransformerOne of the programs of the PowerPlay package. This program defines the model in terms ofdimensions and measures. This program creates the model (.PYH and .MDL files) andgenerates the cube (.MDC file).

PowerPlay 6 Installing CX Supplements

Considerations

The following considerations apply to PowerPlay:• PowerPlay is an excellent tool for forecasting trends at an institution if the cubes are kept

refreshed• To allow for less administration of cubes, Cognos Scheduler is an excellent utility that

updates cubes

Installing CX Supplements 7 Transformer

TRANSFORMER

Overview

Introduction


Transformer is one of the programs of the PowerPlay package. This program defines the modelin terms of dimensions and measures. This program creates the model (.PYI and .MDL files) andgenerates the cube (.MDC file).

Transformer Terms You Need to Know

You need to know the following Transformer terms:

Model Definition Language (MDL) FileA file that represents a model and is stored in plain text format using Transformer’s ModelDefinition Language. MDL files can be opened in Transformer or in any text editor.

Multidimensional Cube File (.MDC)The Cognos file that the PowerCube designer creates in PowerPlay Transformer, and thatcontains multidimensional data. It also can be a pointer file that connects to a database cubeor a third-party On Line Analytical Processing (OLAP) source.

Transformer ModelA multidimensional model of a business or enterprise created in PowerPlay Transformer thatdescribes the structures and specifications for one or more cubes. The information for amodel is stored in a model file, with the extension .PY? (binary) or .MDL (ASII). The questionmark (?) in the extension is replaced by the character used in your release of Transformer.

Considerations

The following considerations apply to Transformer:• Planning is essential and the key to successful PowerPlay cubes. Several minutes of

planning the model structure can save hours when model creation begins.• Jenzabar, Inc. recommends you save all of your model files as the MDL type for the

following reasons:− It is recognized as an industry standard− Cognos always will support the MDL standard between releases

• Remember to implement security into the actual model or else by default any cube that isposted to the Web will allow users to have full access to the cube. You will need a networkconnection to your directory server so you can import the user classes.

• Transformer models should be stored on a backed up network file server.

Installing CX Supplements 9 Cognos Query

COGNOS QUERY

Overview

Introduction


Cognos Query (CQ) is one of the programs of the PowerPlay package. Cognos Query providesWeb-based access to information that describes the activities of your institution. CQ allowssupport for the different information requirements that exist in your institution. It is integrated withPowerPlay and Impromptu.

Cognos Query Terms You Need to Know

You need to know the following Cognos Query terms:

Cognos QueryA Web ad hoc query tool that allows for creation, navigation, and exploration of data acrossthe Web.

Considerations

Read the Cognos Query Portable Document Format (PDF) documentation to get moreinformation about this tool.

Installing CX Supplements 11 Impromptu Web Reports Server

IMPROMPTU WEB REPORTS SERVER

Overview

Introduction to Impromptu Web Reports Server


Impromptu Web Reports (IWR) Server is an Internet or Intranet server program that operates ona server computer to produce and deliver Impromptu reports to Web browser users.

Impromptu Web Reports Server Terms You Need to Know

You need to know the following Impromptu Web Reports Server terms:

All Reports and Events ViewA view in Report Administrator that allows a user to organize reports, define reportproperties, set schedules, assign access permissions, create events, and so on. This viewcontains:

• An All Reports folder, which organizes all the reports into folders and stores them in areport project

• An Events folder, which stores any events that administrators define

Cognos Distribution Shuttle (CDS) BuilderA utility that packages Impromptu catalogs, reports, and supporting files.

Data StoreA database containing data about report projects, report entries, queue data, scheduleddata, and so on. There is only one data store in a group of servers.

ImpserverA utility for testing posted reports.

Payload Locator File (.PLP)An index file created by the Cognos Distribution Shuttle Builder and stored in the postingfolder along with the reports. This file contains information about which files are in theposting folder and where they are located.

Personal ReportA report that a report consumer can run through the Web. If data has changed, this type ofreport generates a different set of results for every report consumer who runs it.

Public ReportA report that only a report administrator can run. This type of report generates a single resultfor all report consumers.

PublishAn action performed by a report administrator to extract a report set from a posting folderand place it on an Impromptu Web Reports server, where it becomes part of a report project.

Posting FolderA folder that stores packaged report sets from Impromptu for use with Impromptu WebReports.

Impromptu Web Reports Server 12 Installing CX Supplements

Report Project ViewA view in Report Administrator that lets you see the property information for all report sets ina report project. You can use this view to map user classes to user profiles for all reportsets. This view shows:

• A report project• The report sets within the report project

Report SetA catalog, a group of reports that use the catalog, and any supporting files, such as graphicsfiles (.BMP), HotFiles (.IMS), or PowerPoint applications. After a report set is published, italso includes report output files.

Report StoreA folder containing one or more report sets. There may be more than one report store.

Web Server (Windows version only)A server application that runs a Web site. Cognos supports either Microsoft InternetInformation Server 3.x or 4.x, or Netscape 3.x. A Web server must be installed on acomputer running Windows NT.

Considerations

The following considerations apply to Impromptu Web Reports Server:• Impromptu Web Reports Server cannot be installed on a Backup Domain Controller (BDC).

If you wish to install it on one, you will have to promote it to Primary Domain Controller(PDC) and then demote it back to a BDC after installation.

• Impromptu Web Reports does not work well on Windows 2000. There are some unresolvedissues with the Informix CLI driver and Windows 2000.

• Jenzabar, Inc. recommends that you read the PDF documentation provided by Cognos inaddition to this document.

• The most common mistake is not mapping the user classes to the report folder after postingit to the Web.

Installing CX Supplements 13 PowerPlay Enterprise Server

POWERPLAY ENTERPRISE SERVER

Overview

Introduction to PowerPlay Enterprise Server


PowerPlay Enterprise Server is an Internet or Intranet server that enables Web users to viewPowerPlay multidimensional cubes.

Access Manager Terms You Need to Know

You need to know the following Access Manager terms:

Access Manager ServerAn LDAP-compliant server containing information about users, user classes, and theirassociated access privileges.

Access ManagerA tool used by administrators to set up users and user classes, and to grant access toprotected data sources.

Base Distinguished Name (DN)The higher levels and directory names of the path (including the root) that you specify toaccess the hierarchical information in a namespace. For example, the root level C (Country)in the directory CA (Canada) together with the organizational level (O = Cognos) forms theDN for the following distinguished name: CN = Cognos Documentation, O = Cognos, C =CA.

Basic SignonA sign on (user ID and password) that you create and maintain in Access Manager and thatCognos applications use to identify individual users. Compare to operating system (OS) signon.

Cognos Security Administration File (.CSA)Access Manager uses a .CSA file to store connection information. It maintains authenticationfile, directory server, and .LAE file connection information, the directory server currentlyconfigured to be active, and the expansion state of the nodes on the directory tree. TheAccess Manager Configuration wizard can use a .CSA file to set automatically runtimeconfiguration information.

Directory ServerA specialized database that stores user attributes, object classes, and other schema-typeinformation in a hierarchical format. Access Manager uses this to store and manage userand user class data.

LDAP (Lightweight Directory Access Protocol)A product-independent protocol used to locate organizations, individuals, files, and otherresources on the Internet or a corporate Intranet. This protocol is designed to extractinformation from a hierarchical directory. This gives users a single tool to find a particularpiece of information, such as a username, e-mail address, security certificate, or othercontact information.

PowerPlay Enterprise Server 14 Installing CX Supplements

NamespaceA source of authentication data used by Access Manager that exists as a directory on adirectory server, or as an entry in a local authentication export (.LAE) file, depending on thedefault security server configured in the system registry.

The security data stored in each namespace, such as sign on information for users, userclasses, application servers, and data sources distinguishes each entry from all othernamespaces in the repository.

Netscape Directory ServerAn LDAP-compliant data store used by Access Manager to store authentication data.

NewsIndexThe list of entries in Upfront that a user can see and interact with. It includes NewsBoxes,NewsItems, NewsBox shortcuts, and NewsItem shortcuts.

NewsItemAn entry in the NewsIndex that represents a report, query, or Uniform Resource Locator(URL) in Upfront.

PowerPlay Enterprise ServerAn Internet or Intranet server that enables Web users to view PowerPlay multidimensionalcubes.

Public User ClassThe user class to which all users in a namespace automatically belong. This user class iscarried forward into other Cognos products. You do not have to name the public user class“public”. You can associate users with other user classes, but they always remain membersof the public user class. You can assign properties and access to the public user class, asyou would for any other user class. By default, a namespace does not have a public userclass associated with it.

Root User ClassThe user class with access to all data sources authenticated using a specific namespace.The root administrator is a member of the root user class. The root user class is created bydefault and can be renamed but not removed from the namespace.

Upfront ServerA server application that operates on an NT server to produce and deliver reports andqueries from other Cognos products to users of Web browsers.

Upfront Server AdministrationAn Upfront component that enables the administrator to view and configure all Upfrontservers in the system.

Installing CX Supplements 15 PowerPlay Enterprise Server

User ClassA category of users who are assigned the same data access privileges, usually becausethey perform similar functions in an organization. User classes can contain other userclasses, and users can belong to several user classes. User classes are related to eachother in a tree structure where each class inherits the capabilities (and restrictions) of itsparent and can further restrict, but not relax, any restrictions.

Your security administrator defines user classes in Access Manager Administration.

In Transformer, objects in a hierarchy representing a group of users who typically performsimilar functions in an organization. You can restrict access to cubes or portions of cubes formembers of particular user classes by creating custom user class views.

Considerations

No considerations apply to PowerPlay Enterprise Server:

Installing CX Supplements 17 Cognos Client-Server Products

COGNOS CLIENT-SERVER PRODUCTS INSTALLATION

Overview

Introduction

This section contains the following information:• Overview information• Information about Installing Cognos client-server products

Client-Server Requirements

You must meet the following client-server requirements to install the files.• Pentium 233 or greater• Windows 9X, Windows NT version 4.0, or Windows 2000• 32 megabytes (MB) of random-access memory (more recommended for complex

applications)• Super VGA display monitor with these specifications:

− 800 x 600 resolution or higher− 256 colors or higher

• A 4x or higher CD-ROM drive• A hard disk with at least 250 MB free disk space• 10/100 network connection to the Jenzabar, Inc. UNIX system

Types of PC Installation

There are three types of PC installation:• Typical• Custom• Compact

Database Connectivity

Impromptu is a client-server application that runs in a Windows 32-bit environment. You can useany ODBC compliant database with this product. Jenzabar, Inc. recommends using the InformixODBC driver with Impromptu and Transformer.

Future Updates

Future updates to the CX supplements for the Cognos tools will need to be done manually inorder to retain any local changes made at your institution. Jenzabar, Inc. will distribute a list of thechanges made since the previous release.

• For Impromptu, the system administrator will make the updates to the distributed catalog onthe network server. Once these changes have been made, the users will be prompted toupdate their personal copy of the catalog.

• For PowerPlay and Transformer, the system administrator makes the updates to the modeland then creates new cubes that encompass the new changes.

Cognos Client-Server Products 18 Installing CX Supplements

Installing Cognos Client-Server Products

Introduction

This section provides information about installing Cognos client-server products. The basic orderof installation follows:

1. Install the appropriate DCOM component. If using Windows 95, install the MicrosoftWindows 95 DCOM component; if using Windows 98, install the Microsoft Windows 98DCOM component.

2. Set up Informix CLI 3.30 for Windows 9x or Windows NT.

3. Perform post installation configuration of the CLI.

4. Test the CLI Connection.

5. Set up Microsoft Data Access Components (MDAC) 2.1 or higher. MDAC 2.1 is the onlyversion that is on the CD. Newer versions are available via Microsoft’s Web site. See thefollowing URL for more information: http://www.microsoft.com/data/.

6. Install Adobe Acrobat Reader 4.0.

7. Install the Impromptu Administrator 6.0 component.

8. Install the Impromptu User 6.0 component.

9. Install the PowerPlay and Transformer 6.6 component.

10. Install the Cognos Query component.

11. Install the example catalog and report.

12. Create a new database reference in Impromptu Administrator.

13. Work with a catalog by adding a table and creating a join.

14. Add fields and filtering to a report.

15. Save the report as an Impromptu Query Definition file so you can reference and work with itin Transformer.

16. Create a model and a cube from the IQD file.

17. Create the upper level of cube, also known as dimension.

18. Drill-down using the drill-down feature.

Step 1: Installation of DCOM Component

If you are a Windows 95 client, follow these steps to install the Microsoft Windows 95 DCOMcomponent:

1. Insert the Cognos Client-Server CD into the CD-ROM drive.

2. If the browser window is not open, double-click on My Computer, right-click on the CD, andselect AutoPlay\AutoRun.

3. Click once on the Extras link.

4. Click once on Microsoft Windows 95 DCOM Component.

5. Select the option to “Run this program from its current location”, then click OK.

6. Click Yes to install, and run “DCOM95 1.3 for Windows 95”.


7. Click Yes to the DCOM95 for Windows 95 box.


8. After reading the license agreement, click Yes to accept the terms and conditions.

9. Click Yes to restart your computer.

If you are a Windows 98 client, follow these steps to install the Microsoft Windows 98 DCOMcomponent:



3. Click once on Microsoft Windows 98 DCOM Component.

4. Read the directions on the Web page, and then click once on the Microsoft link.

Step 2: Informix CLI 3.30 Setup

The CLI is the ODBC connection between the PC and the Jenzabar, Inc. Informix database.Informix 3.11 and higher is required to connect the PC to the Informix database.


2. Click on the Extras link on the left-hand side.

3. Click once on either the Informix 3.30 CLI ODBC Driver for Windows NT 4.0 (only if usingWindows NT 4.0) or Informix 3.30 CLI ODBC Driver for Windows 9x (only if usingWindows 95 and 98) link. The File Download window appears.

4. Select the option to ”Run this program from its current location”, then click OK. A SecurityWarning window appears asking whether you want to install and run “Setup.exe from<CDROMDRIVELETTER>:\Extras\Informix CLI\Windows NT 4.0”.

5. Click Yes. The Welcome screen appears.

6. Click Next. The Serial# and Key window appears.

7. Insert the serial number and key, then click Next.

8. Type in the name and company information, then click Next.

9. Click Next to select the default directory of C:\informix.

Note: You can select a different directory.

10. Click Next at the Setup type screen (typical installation should be selected).

11. Click Next at Select Program Folder.

12. Click Next to start copying files.

13. After it is done copying the files, select Yes, I want to restart my computer now.

14. Click Finish to end the installation. The computer will reboot.

Step 3: Post Installation

You must perform certain tasks after installing Informix CLI 3.30. The following steps are only foran example. You must contact your database administrator to get the correct information.

Note: This information is defined on each UNIX system under the /etc/services file. Yourinformation might not be the same as the following example.

1. Edit the file, C:\winnt\system32\drivers\etc\services (if using Windows NT 4.0) orC:\windows\services (if using Windows 9x).


2. If it is not associated with an application, the Open With window will appear. SelectNotepad.

3. At the end of the file, add the services port for your Informix server.

Example: Service name (istarcars1) Service Port #/Protocol (1001/tcp)Service name (istarcars2) Service Port #/Protocol (1002/tcp)

4. Close and save the file.

5. Click Start\Programs\Informix Client SDK\Informix Setnet 32.

6. In the Environment tab, scroll down in the window and make sure the INFORMIXDIR is setto: C:\informix. If you put the location in a different directory, insert that directory path. If not,click once on the Informix DIR option and type in the default directory in the variable namewindow, which appears below the Informix DIR box, then click Set.

7. Click once on the Server Information tab.

8. Insert the default Informix server name. Default means this local workstation will point to thisspecific UNIX system/data source you are entering.

Example: For department users and administrators who use CARS1, you wouldinsert istarcars1. For training machines and trainer machines that usecars2, you would insert istarcars2.

9. Depending on which Informix server it is, insert the appropriate hostname.• If you used istarcars1, the hostname must be: CARS1• If you used istarcars2, the hostname must be: CARS2

10. The protocol name always is onsoctcp.

11. The service name is directly tied into the Informix server name so, if you used istarcars1,you would insert istarcars1 as the service name. If you used istarcars2, the service namemust be istarcars2.

12. Click Make Default Server.

13. Click Apply to display the Setnet 32 box, which asks the question, “Define new Informixserver?”

14. Click OK to answer the question.

15. Click OK to close the Setnet 32 box.

Step 4: Testing the CLI Connection

After installation, test the CLI connection to ensure connectivity to the database.

1. Click Start\Programs\Informix Client SDK\ILogin demo.

2. Click File\Run.

3. Since you just defined the default Informix server, all you should have to do is insert theappropriate username and password to the <Jenzabar CXUNIX Server>.

4. In the Stores Database field, insert the name of the database.

Note: This is dependent on what you defined in Setnet 32, so insert the appropriatedatabase name (e.g., CARS or cars).

5. Click OK. If you see a Customer Records Found box, you have success. If not, check theSetnet 32 settings again.

6. Click OK to close the box and close the application.


Step 5: Setting Up Microsoft Data Access Components 2.1a

This step updates the data access software on the local server. If you want the latest version ofMDAC 2.5, visit Microsoft on the Web.

1. After the reboot, if the Internet Explorer window is closed, reopen and close the CD-ROMdrive or double-click on My Computer, right-click on the CD-ROM drive, and selectAutoPlay\AutoRun. Internet Explorer will start up with the index page.


3. Click once on the Microsoft Data Access Components 2.1 link.

4. At the File Download window, select the option to “Run this program from its currentlocation”. After the selection, click OK.

5. Click Yes to install and run “Microsoft Data Access Components 2.1 Redistributable Setup”.

6. Follow the installation wizard, and reboot the system after installation.

Step 6: Setting Up Adobe Acrobat Reader 4.0

This step allows for viewing of PDF documentation.



3. Click once on the Adobe Acrobat Reader 4.0 link.


5. Click Yes to install and run “ar40eng.exe from <CDROMDRIVELETTER>:\Adobe”.

6. Follow the installation wizard.

Step 7: Installation of Impromptu Administrator 6.0

Follow these steps to install the Impromptu Administrator 6.0 component:


2. Click once on the Client-Server Products link on the left-hand side.

3. Click once on the Impromptu Admin 6.0 link in the main window.


5. Click Yes to install and run “xwsetup.exe from <CDROMDRIVE>:\Impromptu6.0\Admin\Cognos\Impromptu”.

6. Click Next at the Welcome screen.


8. Insert the appropriate user information, then click Next.

9. Click Next at the Destination Folder box, then click Yes to verify the location.


11. Click Next to select the Typical installation type.


12. Click Next at the Shortcut Folder.

13. Click Finish to begin the copying of files to the hard drive.

14. Click Finish to restart the computer.

15. Close the Cognos BI folder after the reboot.

Step 8: Installation of Impromptu User 6.0

Follow these steps to install the Impromptu User 6.0 component:



3. Click once on the Impromptu User 6.0 link in the main window.


5. Click Yes to install and run “xwsetup.exe from <CDROMDRIVE>:\Impromptu6.0\User\Cognos\Impromptu”.




9. Click Next at the Destination Folder box.





14. Click Finish to restart the computer.

15. Close the Cognos BI folder after installation.

Step 9: Installation of PowerPlay and Transformer 6.6

Follow these steps to install the PowerPlay and Transformer 6.6 component:



3. Click once on the PowerPlay and Transformer 6.6 link.


5. Click Yes to install and run “xwsetup.exe from <CDROMDRIVE>:\PowerPlay6.6\Cognos\PPU”.








12. If a box appears about a samples destination folder, click Next.

13. If a box appears about a tour destination folder, click Next.



16. Click Finish to reboot.


Step 10: Installation of Cognos Query

Cognos Query is a Web product that was added to the Client-Server CD due to size restrictionson the Web CD. This installation needs to occur on the Cognos Web Server, not on the Client-Server PC.

Follow these steps to install the Cognos Query component:


2. Click once on the Client-Server link on the left-hand side.

3. Click once on the Cognos Query link.


5. Click Yes to install and run “xwsetup.exe from <CDROMDRIVE>:\CognosQuery\Cognos\CQ\”.







12. Click Next at Cognos Data Store Installation.

13. Click Next at the Netscape Directory Server.


15. Click Finish to begin copying files.

16. Click Finish to reboot the computer.


Step 11: Installation of Example Catalog and Report

Follow these steps to install the example catalog and report:



3. Click once on the Example Catalog and Report link.



5. Click Yes to install and run “Example.exe from <CDROMDRIVE>:\Extras\Example”.

6. Click OK to begin the copying of files.

Step 12: Create a New Database Reference

Follow these steps to create a new database reference in Impromptu Administrator:

1. Click Start\Programs\Cognos BI\Cognos Impromptu Administrator.

2. Click the Close button on the Welcome screen.

3. Click Catalog.

4. Select Databases.

5. Click once on Informix.

6. Click New Database. A database definition box appears.

Note: In the next steps, replace the information in the <> symbols with valid Informixinformation from your college.

7. The logical database name = CARS (This one must be CARS to use Example catalog).

8. The database name = <CARSDATABASENAME> (An example would be CARS).

9. Hostname = <UNIXSERVERNAME> (An example would be CARS1).

10. Database server name = <INFORMIXSERVICENAME> (An example would be istarcars1).

11. Service is the same as the database server name, so click the last option and type it in.

12. Click the Test button, then insert your CX username and password.

13. Click OK to run the test. If you are successful, a message should appear stating“Successfully attached to database <CARSDATABASENAME>”.

14. Click OK to close the message.

15. Click OK to close the database definition box.

16. Click OK to close the database definition manager box.

Step 13: Add a Table and Create a Join

Follow these steps to work with a catalog by adding a table and creating a join:

1. Click Catalog\Open.

2. Click once on the Examples catalog, then click Open.

3. Insert your CX username and password.

4. Click OK. If you connect successfully to the Informix database, you will see dialog at thebottom stating “Example catalog”.

5. Click Catalog\Tables. A new box appears with its left-hand side listing all of the databaseson the UNIX server.

6. Double-click on your <CARSDATABASE>. (In the preceding example, it would be CARS.) Alist of all tables in the database appears.

7. Scroll until you find the adm_rec.

8. Click once on the table adm_rec, then click Add.


9. Click OK to proceed to the Joins section.

10. Click on id_rec once on the Join paths side.

11. Click once on adm_rec on the available tables side. Notice that the Add button is no longergrayed out.

12. Click once on Add. The two tables will drop-down to the two boxes below.

13. Click once on the field ID, which appears on the id_rec side.

14. Click once on the field ID, which appears on the adm_rec side.

15. After both fields are highlighted, click the Add Link button.

16. Click once on the Outer Join box under the id_rec. This allows for information to be insertedinto the report even if the field is blank.

17. Click OK to save and close the Joins box.

Step 14: Add Fields and Filtering

Follow these steps to add fields and filtering to a report:

1. Click File\Open.

2. Click once on the Example report, then click Open.

3. Click Report\Query. The Query box appears.

4. Click the plus sign beside the adm_rec.

5. Double-click on the trnsfr field, then click OK. This re-queries the database and brings backinformation about transfer students.

6. Click Report\Query.

7. Click once on the filter tab. On the left-hand side of the box, you will see yellow componentsthat are available.

8. Double-click on And. A new list of components becomes available.

9. Double-click on Report Columns. A list of all columns in the report appears.

10. Double-click on Age.

11. Double-click on the >= symbol.

12. Double-click on the number option, which should be colored blue.

13. Enter 16.

14. Click OK. The system saves your filter and re-queries the report.

Step 15: Save the Report

Follow these steps to save the report as an Impromptu Query Definition file so you can referenceand work with it in Transformer:

1. Click File\Save As.

2. Click the down arrow in the Save As type box, then scroll down and select the option *.IQD.

Note: The option is close to the bottom.

3. Click Save.

4. Click File\Exit, then click No to save your changes.


Step 16: Create a Model and a Cube

Follow these steps to create a model and a cube from the IQD file:

1. Click Start\Programs\Cognos BI\Transformer.

2. Click File\New.

3. In the model name, type in Example.

4. Click Next.

5. In the data source name, insert CARS.

6. Click Next.

7. Click Browse and go to the following location: C:\ProgramFiles\Cognos\cer1\samples\Impromptu\Reports.

8. Double-click on the Example Report.iqd file.

9. Deselect the option to “Run AutoDesign”.

Note: It is very important that you deselect this option.

10. Click Finish. The system prompts you for a database login.

11. Type in your CX database username and password, then click Log On. Five separatewindows appear.

Step 17: Create the Upper Level of Cube

Follow these steps to create the upper level of cube, also known as dimension:

1. Click the plus sign beside the Data Source CARS. All of the fields from the Example ReportImpromptu Report should appear.

2. Click and hold on the field Ctry, and drag it up to the gray bar just beneath the words“Dimension Map”. The field should change into a plus sign.

3. Release the mouse button. A new line named Ctry appears.

4. Drag and drop the following fields under Ctry in the following order to create a drill-downpath on the Ctry dimension line, with the upper level being Country, then State, City, andZip:

• St• City• Zip

5. Drag and drop the Add Date just to the right of the Ctry line on the dimension line. It shouldexpand and list the following three fields beneath it: year, quarter, month.

6. To the right of Add Date, drag and drop Ethnic Code.

7. To the right of Ethnic Code, drag and drop Age.

8. To the right of Age, drag and drop Trnsfr. This creates the dimension line.

9. To create a unit of measurement, click and drag on the ID field under Data Sources to theMeasures window.

10. Release the field when the plus sign appears.

11. Click Run\Create PowerCubes. A status window appears briefly to query against thedatabase for data for the new cube. When it is done, a new PowerCube called Exampleappears in the PowerCubes window.


12. Click once on the new PowerCube called Example.


13. Click once on the PowerPlay icon in the toolbar menu. The icon resembles a red, blue, andgreen pie with a plus sign in it. This invokes PowerPlay and displays the newly created cube.

Step 18: Drill-Down

Follow these steps to drill-down:

1. Click once on the Ctry dimension. USA appears.

2. Click once on USA. A list of all states in the USA appears.

3. Drill-down several more times to get more detailed information.

4. Click File\Exit after you are done drill-downing on various dimensions. A question appearsasking whether you want to save the changes.

5. Click No.

Installing CX Supplements 31 Cognos Web Products

COGNOS WEB PRODUCTS INSTALLATION

Overview

Introduction

This section contains the following information:• Hardware/software requirements• Installing Cognos Web products

Hardware/Software Requirements

Here are the hardware/software requirements for the Windows NT Cognos Web server:• Pentium II 300, 256 MB RAM, 4 GB hard drive, 16x or higher CD-ROM, 10/100 NIC• Windows NT 4.0 server (must be PDC or part of Windows NT domain)• SP5 or higher• IIS 4.0• Microsoft Data Access Components 2.1 SP1a• Informix CLI 3.30 or CX ODBC 1.5.3• Netscape Navigator 3.0 or Internet Explorer 4.01 SP2 setup and working (access to Internet

not required, but preferred. Higher versions of the preceding browsers are acceptable)• Adobe Acrobat 3.01 or higher installed (to view the documentation on the CD)• Optional – Administrator access to the internal network domain or local workstation with

active and working network resources• Impromptu Web Reports – 135 MB Full and Typical• PowerPlay Enterprise Server 6.6 – 250 MB Full / 165 MB Typical / 150 MB Compact• Transformation Server 6.6 – 82 MB Custom• Cognos Distribution Shuttle – 15 MB• Static IP address

Cognos Web Products 32 Installing CX Supplements

Installing Cognos Web Products

Introduction

This section provides information about installing Cognos Web products on the NT serverthrough the Internet Explorer Web browser. The basic order of installation follows:

1. Set up Informix CLI 3.30 for Windows 9.x or Windows NT and post installation configurationof the CLI.

2. Set up Microsoft Data Access Components (MDAC) 2.1 or higher. MDAC 2.1 is the onlyversion that is on the CD. Newer versions are available via Microsoft’s Web site. See thefollowing URL for more information: http://www.microsoft.com/data/.

3. Set up Adobe Acrobat Reader 4.0.

4. Set up the system for Cognos Web Product Installations.

5. Set up Netscape Directory Server 3.1 and Post Configuration.

6. Set up Impromptu Web Reports Server 6.0.

7. Set up Cognos Distribution Shuttle.

8. Set up PowerPlay Enterprise Server 6.6.

9. Set up Transformation Server 6.6.

Step 1a: Informix CLI 3.30 Setup

The CLI is the ODBC connection between the Web server and the Jenzabar, Inc. Informixdatabase. Informix 3.11 and higher is required to connect the Cognos Web server to the Informixdatabase.

1. Insert the Cognos Installation CD – 2000 Edition (DISC2) into the CD-ROM drive.

2. Internet Explorer will start up with the index page.

Note: Installation through the Web browser is supported only by Internet Explorer4.01 SP1 and higher.


4. Click once on the Informix 3.30 CLI ODBC Driver for Windows NT 4.0 link. The FileDownload window appears.

5. Select the option to ”Run this program from its current location”, then click OK. A SecurityWarning window appears asking whether you want to install and run “Setup.exe from<CDROMDRIVELETTER>:\Extras\Informix CLI\Windows NT 4.0”.

6. Click Yes. The Welcome screen appears.

7. Click Next. The Serial# and Key window appears.

8. Insert the serial number and key, then click Next.

9. Type in the name and company information, then click Next.

10. Click Next to select the default directory of C:\informix.

Note: You can select a different directory.

11. Click Next at the Setup type screen. (Typical installation should be selected.)

12. Click Next at Select Program Folder.


13. Click Next to start copying files.

14. After it is done copying the files, click Finish to reboot the computer.

Step 1b: Post Installation

You must perform certain tasks after installing Informix CLI 3.30. The following steps are only foran example. You must contact your database administrator to get the correct information.

Note: This information is defined on each UNIX system under the /etc/services file. Yourinformation might not be the same as the following example.

1. Edit the file, C:\winnt\system32\drivers\etc\services.

2. If it is not associated with an application, the Open With window will appear. SelectNotepad.

3. At the end of the file, add the services port for your Informix server.

Example: Service name (istarcars1) Service Port #/Protocol (1001/tcp)Service name (istarcars2) Service Port #/Protocol (1002/tcp)

4. Close and save the file.

5. Click Start\Programs\Informix Client SDK\Informix Setnet 32.

6. In the Environment tab, scroll down in the window and make sure the INFORMIXDIR is setto: C:\informix. If you put the location in a different directory, insert that directory path. If not,click once on the Informix DIR option and type in the default directory in the variable namewindow, which appears below the Informix DIR box, then click Set.

7. Click once on the Server Information tab.

8. Insert the default Informix server name. Default means this local workstation will point to thisspecific UNIX system/data source you are entering.

Example: For department users and administrators who use CARS1, you wouldinsert istarcars1. For training machines and trainer machines that usecars2, you would insert istarcars2.

9. Depending on which Informix server it is, insert the appropriate hostname.• If you used istarcars1, the hostname must be: CARS1• If you used istarcars2, the hostname must be: CARS2

10. The protocol name always is onsoctcp.

11. The service name is directly tied into the Informix server name so, if you used istarcars1,you would insert istarcars1 as the service name. If you used istarcars2, the service namemust be istarcars2.

12. Click Make Default Server.

13. Click Apply to display the Setnet 32 box, which asks the question, “Define new Informixserver?”

14. Click OK to answer the question.

15. Click OK to close the Setnet 32 box.

Step 1c: Testing the CLI Connection

After installation, test the CLI connection to ensure connectivity to the database.

1. Click Start\Programs\Informix Client SDK\ILogin demo.

2. Click File\Run.


3. Since you just defined the default Informix server, all you should have to do is insert theappropriate username and password to the <CARS UNIX Server>.

4. In the Stores Database field, insert the name of the database.

Note: This is dependent on what you defined in Setnet 32, so insert the appropriatedatabase name (e.g., CARS or cars).

5. Click OK. If you see a Customer Records Found box, you have success. If not, check theSetnet 32 settings again.

6. Click OK to close the box and close the application.

Step 2: Setting Up Microsoft Data Access Components 2.1a

This step updates the data access software on the local server. If you want the latest version ofMDAC 2.5, visit Microsoft on the Web.

1. If the Internet Explorer window is closed, reopen and close the CD-ROM drive or double-click on My Computer, right-click on the CD-ROM drive, and select AutoPlay\AutoRun.Internet Explorer will start up with the index page.


3. Click once on the Microsoft Data Access Components 2.1 link.


5. Click Yes to install and run “Microsoft Data Access Components 2.1 Redistributable Setup”.

6. Follow the installation wizard and reboot the system after installation.

Step 3: Setting Up Adobe Acrobat Reader 4.0

This step allows for viewing of PDF documentation.



3. Click once on the Adobe Acrobat Reader 4.0 link.


5. Click Yes to install and run “ar40eng.exe from <CDROMDRIVELETTER>:\Adobe”.

6. Follow the installation wizard.

Step 4: Cognos Web Product Installations

This step allows you to set up the system for Cognos Web product installations.

1. After the installation of Adobe is complete, go back to the Web browser and click once onthe Installation Guides link on the left-hand side.

2. Click once on Installation and Instruction Guide for IWR on NT 4.0 server. Theinstallation guide will open in the browser window.

3. Click once on the plus sign beside “Chapter 2: Install Everything on One Computer”.


4. Click once on Default Settings in the Installation page. When the page appears on theright-hand side, click once on page 82 (the hand will turn into a pointer), which describes theprocess of creating the Windows NT system level temp variable.

5. Follow the instructions on page 82 for setting up the temp variable. When completed, clickonce on Install Netscape Directory Server on the left-hand side.

Note: The option is below the Default settings in the installation page.

Step 5a: Netscape Directory Server 3.1 Setup

This step allows Netscape Directory Server to store all of the Cognos authentication and securityinformation in a namespace LDAP server.

1. Leave the documentation up in the current browser window, click once on File, then New,and finally Window to open another Internet Explorer window, then click the Back buttononce.


3. Click once on the Netscape Directory Server 3.1 link.

4. At the File Download window, select the option to “Run this program from its currentlocation”, then click OK.

5. Click Yes to install and run “setup.exe from<CDROMDRIVELETTER>:\Extras\Netscape\Directory Server 3.1”.


7. Make sure that “Netscape Directory Server” is the only item checked, then click Next.

8. After reading the Software License Agreement, click Accept.

9. Click Next to install the software in the C:/Netscape/SuiteSpot directory.

Note: You can use other locations.

10. At the Administration Server Authentication screen, leave the username admin. You can usethe default password of admin1234 or a different password, but remember what it is. ClickNext after you type and confirm the password.

11. At the Administration Server Port Selection box, either leave the port at the randomlygenerated number or insert a specific number that you want to use (this is for colleges thatwant only certain holes in their network/firewall/internet gateway). Click Next after you typein your number or after you write down the port number.

CAUTION: It is extremely important to record this port number.

12. Click Next at the Server Configuration Summary screen.

13. Uncheck the options to view the README file and connect to the Server Administrationpage. Click Finish.

Step 5b: Internet Explorer Instructions

14. Double-click on Internet Explorer. After the browser opens, click File, then Open, and type inthe following: http://<SERVERNAME>:<PORTNUMBER FROM STEP11>.

15. Click OK, then go to step 18.


Step 5c: Netscape Navigator Instructions

16. Double-click on Netscape Navigator. After the browser opens, click File, then Open Page,and type in the following: http://<SERVERNAME>:<PORTNUMBER FROM STEP11>.

17. Click OK, then go to step 18.

Step 5d: Post Browser Instructions

18. At the authentication box, insert the username admin with the password that you typed instep 10, then click OK.

19. Click once on Create New Netscape Directory Server 3.1.

20. Refer to page 20, number 4 through 7 in the installation guide for the settings and to end theinstallation of Netscape Directory Server.

21. If an Internet window appears asking about “Reister slapd”, click “I Have AlreadyRegistered”. The installation of Netscape Directory Server is now complete.

Notes:

• Page 21 of the Adobe documentation refers to the installation process adding a periodto the directory name. This revision of Netscape Directory Server does not do that, soyou don’t have to do those additional steps.

• If you have problems connecting to the local host, make sure you check the browsersettings so it bypasses the local host.

Step 6: Impromptu Web Report 6.0 Server Setup

IWR takes Impromptu reports and publishes them to the Web.

1. If the browser window is not open, double-click on My Computer, right-click on the CD-ROMdrive, and select AutoPlay\AutoRun.

2. Click once on the Web Report Servers link on the left-hand side.

3. Click once on the Impromptu Web Server link in the main window.


5. Click Yes to install and run “xwsetup.exe from <CDROMDRIVE>:\Cognos\IWR”.




9. Click Next at the Presetup information box.




13. Click Next at the Data Store Installation box.


14. At the Service Account screen, select the account that will have administrator access to thelocal Cognos Web server, then click Next.

Note: By default, Administrator is highlighted with the local server name in theDomain box. It is very important to note that this account will be used to startand stop Cognos Web services.

15. Type in the password for that account, then click OK.

16. Click Finish to begin copying files to the hard drive.

Note: If a box appears informing you that the ENVIRONMENT has changed, clickOK.

17. Click Finish to reboot the computer and finish installation.

18. After the reboot, a Cognos BI folder appears on the screen. Close the folder.

Step 7a: Installation of Cognos Distribution Shuttle

CDS is used to package and compress a set of Impromptu reports and catalogs along with anysupported files, such as .bmp and .ims files, into a shuttled folder.

1. If the browser window is not open, double-click on My Computer, right-click on the CD-ROMdrive, and select AutoPlay\AutoRun.

2. Click once on the Extras link on the left-hand side.

3. Click once on the CDS link.


5. Click Yes to install and run “Xwsetup.exe from <CDROMDRIVE>:\Cognos\CDS Builder”.





10. At the second Destination Folder box, click Next.

11. Click Next to select the Shortcut Folder as Cognos BI.

12. Click Finish to complete the installation.

13. Click OK to finish the installation. A Cognos BI folder appears on the screen.

14. Close the folder.

Step 7b: IWR Post Installation Test

Follow these steps to test the installation.

1. Test the IWR installation by opening either Internet Explorer or Netscape Navigator andentering the following URL: http://<SERVERNAME>/Cognos/IWR. A logon window appears.

2. In the logon window, enter Administrator for the user ID and leave the password blank.

3. Click Log On.

4. If the server is working, you will be viewing a window with four options:• Start• Quick Tour• Preferences


• Help


5. Click Start to access IWR and all of the report folders available to the Administrator account.

Note: You should not see any folders.

6. Close the browser window.

Step 7c: Access Manager Configuration

Access Manager is the centralized place for setup and administration of all Cognos Web users,user classes, data sources, and other various items.

1. Click Start\Programs\Cognos BI\Access Manager Configuration.

2. Click Next at the first wizard window.

3. Click Next to select Automated (CSA).

4. Click Add, then click once on Specify a file location.

5. Click Browse to select the Cognos.csa file, then click Open.

6. Click OK, then click Next.

7. Check the option “Directory Server configuration”, then click Next.

8. At the directory settings window, make sure the following settings are in place. If the settingsare working, a green checkmark will be at the bottom stating“<SERVERNAME>:<PORTNUMBER> is responding and supports LDAP v3”.

• Host: <SERVERNAME>• Port: 389 (default)• Base Distinguished Name (DN): o = Cognos, c = CA• LAC File: C:\Program Files\Cognos\cer1\bin\default.lac

9. Click Next.

10. Click Next to use the directory server default namespace.

11. Select Directory Server, then click Next.

12. Click Finish.

Step 7d: Connecting Access Manager

Follow these steps to connect Access Manager to the Netscape Directory Server:

1. Click Start\Programs\Cognos BI\Access Manager Administration.

2. Click File\Open.

3. Double-click on the Cognos file.

4. Click the plus sign beside the Directory Servers folder.

5. Click the plus sign beside the <SERVERNAME>:<PORTNUMBER>.

6. Click the plus sign beside the default namespace, an authentication box should appear, thenclick Log On.

Note: You will see a key in the taskbar in the lower right-hand corner. This keyrepresents an authenticated login to the LDAP directory server andnamespace. If it asks for a username and password, login as Administrator,but do not use a password.


Step 7e: Basic Administration – Getting Started

For more information about using Access Manager, refer to the following PDF:Start\Programs\Cognos BI\Reference\Access Manager\Access Manager Administrator Guide,Chapter 3.

It is essential to plan your reporting structure and report folder access in the beginning so thatwhen you start posting reports to the Web, your users and user classes will have access to thecollective report folders.

Jenzabar, Inc. recommends that you set up a new user class for each department with somedepartments having multiple classes depending on the security you want to put in place.

Follow these steps as an Admissions example of getting started with basic administration. To adda new user class, do the following:

1. Right-click on Root User Class.

2. Select Add User Class.

3. In the <New User Class> Properties box, type in a new user class name (this example usesAdmissions).

4. Click the Permissions tab and remove all options to Create and Delete. It is essential torestrict access to individuals in this new user class. Depending on your security, you alsocan restrict access to their own Web passwords and properties.

5. Click OK when finished. The new user class, Admissions, appears.

6. Create another User Class based off an office at your institution. It is important to have morethan one because of future instructions.

To add a new user, do the following:

1. Right-click on Users.

2. Select Add User.

3. In the <New User> properties box, type in the username (this example uses John Doe).

4. It is the decision of the administrator to insert additional information in this tab. The only fieldthat is required is the Name.

Note: This application is connecting to an LDAP server so you can use it for otherpurposes if you populate it.

5. After filling in the desired information, click the User Signons tab.

6. Click once to select Basic signon.

7. Type in the user’s CX login with a generic password. For this example, enter the following:• User ID: jdoe• Password: welcome• Verify password: welcome.

8. The next tab is the Access tab. It will be referenced later once the report set has beendistributed to the Web.

9. Click the Memberships tab.

10. Click the plus sign next to Root User Class.

11. Since John Doe works in the Admissions office, he will need access to the admissionsreports. Click once in the box next to Admissions User Class.


12. Click OK to save changes and create the new user. You should see the user John Doeunder the Users folder.

13. Click on the plus sign next to Users folder, then click once on John Doe. In the right pane,you should see a shortcut to the Admissions User Class. The User Class determines whichreports the Web user will see when they login to the Web server.

14. Close Access Manager Administration.

Step 7f: Shuttling a Report Set

Follow these steps as an Admissions example of shuttling a report set:

1. Double-click on My Computer.

2. Double-click on the C: drive.

Note: If you have a different data drive on the local computer, use that drive instead.

3. Click File\New\Folder.

4. Name the folder shuttled.

5. Close the window.

6. Click Start\Programs\Cognos BI\CDS Builder.

7. In the source directory, browse to where your Admissions Impromptu reports and catalogsare stored. (The April, 1999 CD default was C:\CARS\Cognos\Admit).

8. Once you find your reports and catalogs, click OK. All of your reports and catalogs display inthe File List window.

9. Type the following in the Posting location: C:\shuttled\admissions (depending on whereyou set up the directory).

10. Leave the setting on NT servers, and click Post. After the files are distributed to the directorythat you specified, an information window will appear listing the added reports.

11. Click OK.

12. Close the application.

Step 7g: Posting a Report Set

Follow these steps as an Admissions example of posting a report set:

1. Click Start\Programs\Cognos BI\Report Administration. The Connect box appears.

2. Enter the following:• User ID: Administrator• Password: <blank> (Unless you changed the password in Access Manager.)• Server: localhost, or type in the <SERVERNAME>

3. Click Connect.

4. Click Tools, then Publish Report Set.

5. Select the option “New Report Set” and enter the name Admissions.

6. In the report set location, enter the following path: C:\Posted Reports (CX will use this asthe standard location). The server automatically will create the Admissions folder under thePosted Reports directory.


7. In the Payload locator file, enter the following: C:\shuttled\admissions\admit.plp.

Note: If you are uncertain about future .plp filenames, click Start\Find and do asearch under the C:/shuttled directory for *.plp.

8. Click OK to publish the report set. The publishing window appears.

9. Click OK.

10. After a few minutes, click View\Refresh All to see the new report set. The new report setnamed “Published_Admissions” appears.

Step 7h: Posted Report Set Option Changes

This is a basic introduction to setting up one reporting folder. For additional information about thistopic, refer to the following location: Start\Program\Cognos BI\Reference\IWR\ReportAdministrator’s Guide, Chapters 2 – 4.

Step 7i: All Reports and Events View

This view is where you define settings and parameters for the report sets that you publish. Followthese steps to define settings and parameters for the report sets that you publish using theAdmissions example:

1. Click once on the Published_Admissions report folder.

2. Under the General tab, click the “Show to the report consumer” option.

3. Remove the word and underscore “Published_” from the report folder name. The reportfolder name should be “Admissions”.

4. Do either of the following to save your changes:• Click once on the floppy disk• Click Action\Save

5. Click once on the Access tab to display three different user classes, then click the Modifybutton in the bottom right corner.

6. Since this example uses the Admissions folder, click once on the additional department(s)that should not have access to these reports, then click the red X. (If you need moreinformation about the different arrows and their meanings, click the Help button.)

7. Click OK.

8. Do either of the following to save your changes:* Click once on the floppy disk* Click Action\Save

9. Click on the plus sign beside Admissions to see all of your reports.

10. Click on one of the reports. Six tabs appear.

11. Click once on Output, and change the report type to Personal.

12. Click the floppy disk after you have changed the type.

Step 7j: Report Project View

This view is where you define the User Classes mapping and the database login for runningreports. Follow these steps to define the User Classes mapping and the database login forrunning reports using the Admissions example:

1. Click once on the down arrow where it lists All Reports and Events and select ReportProject.


2. Click once on Report Project 1.

3. Click once on the User Class Mapping tab. By default, the Root User Class already ismapped to the Admissions report set. It is necessary to map the Admissions User Class tothe newly published Admissions report set.

4. Click the Modify button. A box appears, and the Admissions user class should be listed.

5. Click once on the Admissions User Class box, then click OK. The main screen shouldappear and there should be a listing for the Admissions User Class to be mapped to theAdmissions report set. If you do not see this mapping, the report set will not work throughthe Web.

6. Click the floppy disk to save your new changes.

7. Click once on the Admissions report set on the left-hand side. In the bottom right-hand sideof the window, there will be a listing for a database logon type.

8. Change the type to User. A warning message that all burst reports will fail appears.

9. Click Yes. A box appears requesting a valid CX database login.

Note: Jenzabar, Inc. recommends you use a general CX database account that hasaccess to all of the different modules on the CX because this will be the loginyou will use for all Web users.

10. Insert the appropriate information, then click OK.

11. Click the floppy disk to save your new changes.

Go back to Access Manager and make reference to the new data source you just created inReport Administrator.

1. Click Start\Programs\Access Manager Administration.

2. Click File\Open, and select the Cognos.csa file.

3. Logon to the namespace.

4. Click the plus sign next to default. A plus sign beside Data Sources appears.

5. Click the plus sign next to the Users folder, then double-click on John Doe.

6. Click once on the Access tab to see the CX database reference.

7. Select the box next to CARS.

8. Click the Set button.

9. Select the sign on that you set up just a few steps ago in Report Administrator, then clickOK.

10. Click Apply, then OK to save your changes. You have just given John Doe’s Web accountthe capability to run reports from the Web browser.

11. Click on the plus sign next to the Data Sources folder.

12. Right-click on the CARS data source, and select Properties.

13. Click the second tab, Connection.

14. In the database type, click the down arrow, and select Informix (the default type is ODBC).

Note: If you get an error message stating that “Changing the database type will erasethe current connection string”, click Yes.

15. Click the Edit button.


16. Notice the similarity of the database definition box to the Informix SetNet box.


17. Insert the appropriate information in the box.

Note: This should be the same information that you inserted in the post installation ofthe Informix CLI 3.30 setup.

18. Click OK to save your settings.

19. Click OK to answer the Database Properties box.

Step 7k: Running a Report through the Web

Follow these steps to run a report through the Web using the Admissions example:

1. Open a Web browser and login to http://<SERVERNAME>Cognos/IWR as jdoe.

2. Click Start at the Welcome screen. The Admissions report set appears.

3. Click once on the Admissions report set.

4. Click once on the report that you switched from public to personal. The report should beyellow. A new window will appear stating the report is queued for running.

5. Click the link to the Inbox.

6. If you don’t see the report immediately, click Refresh on the browser window.

Note: There is no notification that the report is finished.

7. Click once on the report after it appears. The report will open in the browser window.

Step 8a: PowerPlay Enterprise Server 6.6 Setup

Follow these steps to set up PowerPlay Enterprise server 6.6:

1. Double-click on My Computer, right-click on the CD-ROM drive, and selectAutoPlay\AutoRun.

2. Click the Web Report Servers link.

3. Click the PowerPlay Web Server link.


5. Click Yes to install and run “xwsetup.exe from <CDROMDRIVE>:\Cognos\PPES”.







12. Click Next to accept the Ticket Server values.


14. Click Finish to begin copying files. (This typically takes 5 – 10 minutes.) A message aboutsetting up the Web aliases appears.

15. Click OK. A message about the setup being complete appears.

16. Click Finish to reboot the computer.


Step 8b: PowerPlay Enterprise Server Post Installation

Follow these post installation steps for PowerPlay Enterprise Server 6.6:

1. Double-click on the Server Administration – PowerPlay Enterprise Server icon in the CognosBI explorer window.

2. Click OK to connect to the <SERVERNAME>.

3. Click Yes to secure the server.

4. Login as Administrator.

5. When the Set Security window appears, click OK.

Step 8c: Publishing a Cube to the Web

Follow these steps to publish a cube to the Web using the Admissions example:

1. Click Insert, then Cube. Several boxes appear in the Cube Properties box.

2. To insert a cube, type in the location of the cube or click once on the ellipsis at the end of thecube source line and browse to find it. A sample cube is located at C:/ProgramFiles/Cognos/cer1/samples/ppwb/outdoors.mdc.

Note: You must type in the path of the cube if it is stored on a network drive. You areunable to browse the network.

3. After you have typed in the source location of the cube, you can change the name anddescription information, then click OK to save your changes. This returns you to the mainwindow.

4. Click once on the cube to highlight it, click Tools, then click Publish to Upfront. A messageabout a successful completion appears.

5. Click OK.

6. Open either Internet Explorer or Netscape Navigator, then open the following location:http://<SERVERNAME>/Cognos.

7. Login as jdoe. This takes you to the Web portal Upfront where you will see the newly postedcube.

8. Click once on the cube to view it.

Step 8d: Creating a Link to IWR

Follow these steps to create a link to IWR through the Cognos Upfront Web portal:

1. Open either Internet Explorer or Netscape Navigator, then open the following location:http://<SERVERNAME>/Cognos.

2. Login as Administrator.

3. Click New.

4. Click the “Create a NewsItem for a URL or file” link.

5. Enter the following:• Name: Impromptu Web Reports Server• URL: http://<SERVERNAME>/Cognos/IWR• Description: Link to Impromptu Web Reports Server

6. Click Next.


7. Select the “//NewsIndex” NewsBox so all Web users will see this new link, then click Finish.This takes you back to Upfront.

8. Click once on the newly created link to go to IWR.

Step 9: Transformation 6.6 Server Setup

Follow these steps to create models and the ability to generate PowerPlay cubes:

1. Double-click on My Computer, right-click on the CD-ROM drive, then selectAutoPlay\AutoRun.

2. Click Web Report Servers.

3. Click Transformation Web Server.

4. Select the option to “Run this program from its current location”.

5. Click OK.

6. Click Yes to install, and run “xwsetup.exe from <CDROMDRIVE>:\Cognos\PPTSW”.






12. Select Custom as the installation type, then click Next.

13. Click Deselect All, click once on Transformer, then click Next.

14. Click Next at the Samples Destination Folder.


16. Click Finish to begin copying files.

17. Click OK to finish setup.


Installing Products through Windows Explorer

Alternate Options

If you wish to install the products through Windows Explorer instead of Internet Explorer, the pathfor each individual executable application follows. Instead of following the first step in theapplication setups, just double-click on the executable and follow the rest of the steps.

Cognos Client-Server Products – Disk 1

The following paths apply to Cognos Client-Server products:

Impromptu Administrator:<CDROMDRIVE>:\Impromptu 6.0\Admin\Cognos\Impromptu\xwsetup.exe

Impromptu User:<CDROMDRIVE>:\Impromptu 6.0\User\Cognos\Impromptu\xwsetup.exe

PowerPlay and Transformer:<CDROMDRIVE>:\PowerPlay 6.6\Cognos\PPU\xwsetup.exe

Cognos Query:<CDROMDRIVE>:\Cognos Query\Cognos\CQ\xwsetup.exe

Cognos Web Servers – Disk 2

The following paths apply to Cognos Web servers:

Impromptu Web Report Server:<CDROMDRIVE>:\Cognos\iwr\xwsetup.exe

PowerPlay Enterprise Server:<CDROMDRIVE>:\Cognos\ppes\xwsetup.exe

Transformation Web Server:<CDROMDRIVE>:\Cognos\pptsw\xwsetup.exe

Extra Software

The following paths apply to extra software:

Informix 3.30 CLI ODBC for Windows 9x:<CDROMDRIVE>:\Extras\Informix CLI\Windows 9x\Setup.exe

Informix 3.30 CLI ODBC for Windows NT 4.0:<CDROMDRIVE>:\Extras\Informix CLI\Windows NT 4.0\Setup.exe

Microsoft Windows 95 DCOM Component:<CDROMDRIVE>:\Extras\Microsoft\dcom95.exe

Microsoft Windows 98 DCOM Component:Not applicable. You must go to Microsoft’s Web site to download this software.

Microsoft Data Access Components 2.1:<CDROMDRIVE>:\Extras\Microsoft\mdac_type.exe

Netscape Directory Server 3.1:<CDROMDRIVE>:\Extras\Netscape\Directory Server 3.1\setup.exe


Cognos Distribution Shuttle Builder:<CDROMDRIVE>:\Cognos\CDS Builder\xwsetup.exe

Adobe Acrobat Reader 4.0:<CDROMDRIVE>:\Adobe\ar40eng.exe

Installation Guides – Disk 1

The following paths apply to installation guides from disk 1. Note that the last document on thisdisk is a .pdf version of this document:

Administrator’s Guide to Impromptu<CDROMDRIVE>:\Installation Guides\Administrator’s Guide to Impromptu\imadmngd.pdf

Administrator’s Guide to PowerPlay<CDROMDRIVE>:\Installation Guides\Administrator’s Guide toPowerPlay\PP_Admin_Gd.pdf

Cognos Query Admin and User Guide<CDROMDRIVE>:\Installation Guides\Cognos Query Admin and User Guide\CQ_AG.pdf(Administrator)<CDROMDRIVE>:\Installation Guides\Cognos Query Admin and User Guide\CQ_UG.pdf(User)

Discovering Impromptu<CDROMDRIVE>:\Installation Guides\Discovering Impromptu\disc_imp.pdf

Discovering PowerPlay<CDROMDRIVE>:\Installation Guides\Discovering PowerPlay\PP_Disc.pdf

Installation Guide for Cognos Query<CDROMDRIVE>:\Installation Guides\Installation Guide for Cognos Query\CQinstl.pdf

Installation Guide for Impromptu Administrator 6.0<CDROMDRIVE>:\Installation Guides\Installation Guide for Impromptu Administrators6.0\imp_inst.pdf

Installation Guide for PowerPlay 6.6<CDROMDRIVE>:\Installation Guides\Installation Guide for PowerPlay 6.6\ppu_inst.pdf

Installing Jenzabar CX Supplements to the Cognos Tools<CDROMDRIVE>:\Installation Guides\CARS\incognos.pdf

Installation Guides – Disk 2

The following paths apply to installation guides from disk 2:

Developer’s Guide to Upfront:<CDROMDRIVE>:\Installation Guides\Developer Guide to Upfront\dev_upfront.pdf

Installation and Instruction Guide for Access Manager:<CDROMDRIVE>:\Installation Guides\Installation Guide for AccessManager\AccessAdm.pdf

Installation and Instruction Guide for Impromptu Administrator 6.0:<CDROMDRIVE>:\Installation Guides\Installation Guide for Impromptu Administrator6.0\imp_inst.pdf

Installation and Instruction Guide for IWR on NT 4.0 Server<CDROMDRIVE>:\Installation Guides\Installation Guide for IWR on Windows NT 4.0Server\iwr_instl.pdf


Installation and Instruction Guide for Netscape Directory Server 4.11<CDROMDRIVE>:\Installation Guides\Installation Guide for Netscape Directory Server4.11\installforcognos.pdf

Installation and Instruction Guide for PowerPlay User 6.6<CDROMDRIVE>:\Installation Guides\Installation Guide for PowerPlay 6.6\ppu_inst.pdf

Installation and Instruction Guide for PPES on NT 4.0 Server<CDROMDRIVE>:\Installation Guides\Installation Guide for PPES 6.6 on Windows NT 4.0Server\pp_entsrvr.pdf

Installing CX Supplements 51 Error Messages and FAQs

ERROR MESSAGES AND FAQS

Overview

Introduction

This section contains the following information:• Error messages• Frequently asked questions (FAQs) and their answers

Error Messages

The following lists alphabetically the error messages that can appear when you are using theCognos tools.

Logon error while connecting the database. DMS-E-YV_SGINOLIB. Unable to locate thegateway ‘ifdbaL.DLL’.

A report that goes against an Informix database will run in Impserver but will not run on theWeb. Attempting to run this report on the Web causes this error to appear. Resolve the errorby ensuring that under Control Panel\System\Environment, the Informix variables aredefined as system variables (e.g., INFORMIXDIR and INFORMIXSERVER). If they are not,make them system variables and reboot the machine.

The server is not available to handle your request. Please re-submit your request.

Unable to logon. A network failure occurred while communicating with server‘nameofserver’. Error encountered while sending parameters to Web server.

Note: Internet Explorer can display the first error, and Report Administrator candisplay the second error.

These errors occur when the Impromptu Web Service Manager (CER1) service is notstarted. In order to resolve this, start the service through the Settings\Control Panel\Serviceswindow.

Unable to create folder in "//<server name>/iwr_dbThe installation of IWR 6.0.334.23 RBF 3 fails at 7% with the following error: Unable tocreate folder in "//<server name>/iwr_db. Verify that the server has an IP address and is nota Backup Domain Controller. If it does not have an IP address, assign an IP in the TCP/IPproperties. If it is a Backup Domain Controller, promote it to a Primary Domain Controllerand install the product, then demote it back to Backup Domain Controller.

Error Messages and FAQs 52 Installing CX Supplements

Unable to update the reference count for the file C:\windows\system\std-2.0.1-vc5.0-mt-noalloc.dll

Something on the system is preventing the dll referenced in the error message (std-2.0.1-vc5-mt-noalloc.dll) from being overwritten. Possible causes are as follows: (a) the file isbeing used by another application at the time of the install (b) virus scan software running inthe background is protecting the file (c) some other reason that cannot be determined – inthis case, rename the existing dll file to *.old.

The registry has reached the operating system-imposed limit. Use the Microsoft Reg Cleanutility to clean up the registry.

If default printer is a HP series printer, you need to set up another printer as the default orupdate the drivers for your HP printer from HP’s Web site. An easy way around this problemis to add a (Generic/text only) printer in Windows 95 and make it set as the default.

When viewing a report containing a bitmap in Adobe Acrobat, the colors of the bitmap areincorrect.

In order for bitmaps to be rendered properly into a PDF file, they must be a 256 color (orless) bitmap. A 24-bit True Color bitmap will not display the colors properly. Open the .bmpfile in a graphic editor and resave a 256-color .bmp.

Frequently Asked Questions

The following lists alphabetically some frequently asked questions when installing CXsupplements to the Cognos tools.

Can cubes on PowerPlay Enterprise Server 6.5 be accessed as remote cubes in PowerPlayClient 6.6?

No. PowerPlay Client 6.6 cannot access remote cubes on Enterprise Server 6.5. If youattempt to set up the connection from PowerPlay Client 6.6 to Enterprise Server 6.5, you willreceive the following error message: The PowerPlay server ‘servername’ is unavailable.Please try again later, contact your System Administrator, or choose a differentserver. Version 6.5 cubes can be viewed only as local cubes in PowerPlay Client 6.6through Enterprise Server 6.6.

Can you keep the flyout screens from appearing when viewing a cube on the Web?Yes, this can be disabled through Enterprise Server Administrator. In the Settings tab, underDisplay (Web), if you enable the Generic HTML setting, this will prevent the flyouts fromappearing. This setting can be enabled, either specifically for the cube, under CubeProperties, or for the whole server, under Server Properties\Cube Settings.

How do I drill through from PowerPlay Web to CQ?Follow these steps to drill through from PPES 6.5 and 6.6 to CQ: 1. Create a model in Architect. 2. Send this model to CQ. 3. Run a query from CQ. This will generate an IQD under /Program

Files/Cognos/cer1/IQD files. 4. Use that IQD as a data source in Transformer. 5. In the Cube Properties of Transformer, specify the drill through to the CQ IQD. 6. Build the cube and post on Enterprise Server Administrator. 7. Under the Server Properties/Cube Settings tab, enable drill through for CQ and then

establish the gateway. 8. Under each individual cube, go to the cube settings to do the same.The drill through should now function from PPES to CQ.

Installing CX Supplements 53 Error Messages and FAQs

How do you add a title to a Web-enabled cube?In PowerPlay Enterprise Server 6.6, you can add a title for a Web-enabled cube via thePowerPlay Enterprise Server administrator. Double-click the cube to bring up the propertieswindow, select the Settings tab, and under the options folder, there is a place to enter a titlethat will be added to the cube when it is displayed in the Web browser.

How do you enable auditing for PowerPlay Enterprise Server?Follow these steps to enable auditing: 1. In the Enterprise Server Administration tool, select either a Server, to enable server

auditing, or a Cube or Report, to enable cube or report auditing. 2. Select Properties from the Edit menu, then choose the Settings tab. 3. Select Summary or Detail from the drop-down menu in the Auditing Level option. 4. Click OK.

Note: The auditing information will be recorded in the file ppserver\ppes_audit.log.

How is NT Challenge Response used with Impromptu Web Reports?In order for IWR to work with NT Challenge Response, the following items must beimplemented:

• In the Web server, enable NT Challenge Response.• The file <drive>:\Program Files\Common Files\Cognos Shared\Dss\Dss98a\cgi-

bin\login.cgi has to be on an NTFS partition.• In IWR, Reports Administrator creates user(s) that have permissions in the login.cgi

file. Check the Trusted OS option and uncheck the Basic Sign on option. The user IDformat to be entered in the Trusted OS section should be <Domain Name>\<userid>.Map the user to a class that will be accessing the reports.

Note: Between the domain name and username is a “\” and not a “/” as shown onpage 64 of the IWR Report Administrator’s Guide.

If the user who signed on to the network meets the criteria of items 2 and 3, once thepreceding three items are implemented, the IWR logon page will be bypassed.

Why are all users able to access remote cubes with a browser, even though security onthe server has been set in Microsoft Internet Information Server (IIS) by turning offanonymous access and setting basic authentication?

Basic security in IIS is done through a Network logon (Username, Password). Any user whois allowed access to this server or directory will be able to log on. Using Microsoft Explorer,users will be able to change names and move or rename files, including PowerPlay Cubes(MDC files). Access is allowed via the Access Control List (ACL) in Microsoft Security.

For Cubes to be made secure individually and accessible only by authorized users with apassword, you have to set up authentication on the cube itself, in Transformer, when thecube is built.

Installing CX Supplements 55 Index

INDEX

A

Access Manager, 13terms, 13

Access Manager Server, 13Alias, 3All Reports and Events View, 11, 39All Reports folder, 11Alternate options, 44

B

Base Distinguished Name (DN), 13Basic Signon, 13

C

Catalog, 3client-server requirements, 17Cognos client-server products

installing, 18Cognos Distribution Shuttle (CDS) Builder, 11Cognos Query

considerations, 9purpose of, 9terms, 9

Cognos Security Administration File (.CSA), 13Cognos Web products

installing, 30considerations

Cognos Query, 9Impromptu, 4Impromptu Web Reports Server, 12PowerPlay, 6PowerPlay Enterprise Server, 15Transformer, 7

Crosstab reports, 3Cube, 5

D

Data Store, 11Database Connectivity, 17Directory Server, 13Drill through, 3

E

error messages, 47Events folder, 11Explorer, 5

F

FAQs, 48Filter, 3frequently asked questions, 48

H

HotFile, 3

I

Impromptuconsiderations, 4purpose of, 3terms, 3

Impromptu Web Reports Server, 11considerations, 12purpose of, 11terms, 11

Impserver, 11installing

Cognos client-server products, 18Cognos Web products, 30from network, 1

J

Join, 3

K

Keys, 3

L

LDAP (Lightweight Directory Access Protocol),13

M

Model, 5Model Definition Language (MDL) File, 7Multidimensional Cube File (.MDC), 7

N

Namespace, 14Netscape Directory Server, 14NewsIndex, 14NewsItem, 14

O

Optionsalternate, 44

Outer join, 4

Index 56 Installing CX Supplements

P

Payload Locator File (.PLP), 11Personal Report, 11Posting Folder, 11PowerCube, 5PowerPlay, 5

considerations, 6purpose of, 5terms, 5

PowerPlay Enterprise Server, 14considerations, 15purpose of, 13

Prompt, 4Public Report, 11Public User Class, 14Publish, 11

R

Report Project View, 11, 39Report Set, 12Report Store, 12Reporter, 5requirements

client-server, 17Web products, 29

Root User Class, 14

S

Snapshot, 4

Sub-report, 4

T

termsAccess Manager, 13Cognos Query, 9Impromptu, 3Impromptu Web Reports Server, 11PowerPlay, 5Transformer, 7

Transformer, 5considerations, 7purpose of, 7terms, 7

Transformer Model, 7

U

Upfront Server, 14Upfront Server Administration, 14User Class, 14

V

viewsAll Reports and Events, 11, 39Report Project, 12, 39

W

Web Server (Windows version only), 12

Date post:	14-Mar-2020
Category:	Documents
Upload:	others
View:	7 times
Download:	0 times

CX Supplements to Cognos Tools Installation Guide...include the Jenzabar coordinator, Jenzabar...

Documents