27
IBM Cognos PowerPlay Client Version 11.0 Installation and Configuration Guide IBM

Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

IBM Cognos PowerPlay ClientVersion 11.0

Installation and Configuration Guide

IBM

Page 2: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

©

Product Information

This document applies to IBM Cognos Analytics version 11.0.0 and may also apply to subsequent releases.

Copyright

Licensed Materials - Property of IBM

© Copyright IBM Corp. 2005, 2017.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

IBM, the IBM logo and ibm.com are trademarks or registered trademarks of International Business Machines Corp.,registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or othercompanies. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” atwww.ibm.com/legal/copytrade.shtml.

The following terms are trademarks or registered trademarks of other companies:v Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of

Adobe Systems Incorporated in the United States, and/or other countries.

v Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the UnitedStates, other countries, or both.

v Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, IntelSpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiariesin the United States and other countries.

v Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

v UNIX is a registered trademark of The Open Group in the United States and other countries.

v Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or itsaffiliates.

Microsoft product screen shot(s) used with permission from Microsoft.

© Copyright IBM Corporation 2005, 2016.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Page 3: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Contents

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Chapter 1. Installing and configuring Cognos PowerPlay Client . . . . . . . . . . . . 1Verify system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Installing Cognos PowerPlay Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Configuring Cognos PowerPlay Client . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Restrict port communication between IBM Cognos PowerPlay Client and the Remote PowerPlay Services . . . 3Testing the installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Uninstalling Cognos PowerPlay Client. . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 2. Configuration options . . . . . . . . . . . . . . . . . . . . . . . . . 7Changing a URI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Changing cryptographic settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Configuring the SSL protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 3. Setting up the samples for Cognos PowerPlay Client . . . . . . . . . . . 11Downloading the supplementary samples . . . . . . . . . . . . . . . . . . . . . . . . . 11Creating a data source connection to the sample PowerCube . . . . . . . . . . . . . . . . . . . 11Importing the sample deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Testing a sample report in IBM Cognos PowerPlay Client . . . . . . . . . . . . . . . . . . . . 13

Appendix. Accessibility features. . . . . . . . . . . . . . . . . . . . . . . . . 15Keyboard shortcuts for the Installation Wizard . . . . . . . . . . . . . . . . . . . . . . . 15

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

© Copyright IBM Corp. 2005, 2016 iii

Page 4: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

iv IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 5: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Introduction

This document is intended for use with IBM® Cognos® PowerPlay® Client. You canuse PowerPlay Client to create, view, explore, format, and distribute reports.

This guide contains instructions about installing and testing PowerPlay Client, andabout setting up samples.

Audience

To use this guide, you should have basic Windows administration skills.

Finding information

To find product documentation on the web, including all translateddocumentation, access IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter). To access the PDF versions of the guides, go to the IBM Cognosproduct documentation web page (www.ibm.com/support/docview.wss?uid=swg27047187).

Accessibility features

IBM Cognos PowerPlay Client does not currently support accessibility features thathelp users who have a physical disability, such as restricted mobility or limitedvision, to use this product.

IBM Cognos HTML documentation has accessibility features. PDF documents aresupplemental and, as such, include no added accessibility features.

Forward-looking statements

This documentation describes the current functionality of the product. Referencesto items that are not currently available may be included. No implication of anyfuture availability should be inferred. Any such references are not a commitment,promise, or legal obligation to deliver any material, code, or functionality. Thedevelopment, release, and timing of features or functionality remain at the solediscretion of IBM.

Samples disclaimer

The Sample Outdoors Company, Great Outdoors Company, GO Sales, anyvariation of the Sample Outdoors or Great Outdoors names, and Planning Sampledepict fictitious business operations with sample data used to develop sampleapplications for IBM and IBM customers. These fictitious records include sampledata for sales transactions, product distribution, finance, and human resources.Any resemblance to actual names, addresses, contact numbers, or transactionvalues is coincidental. Other sample files may contain fictional data manually ormachine generated, factual data compiled from academic or public sources, or dataused with permission of the copyright holder, for use as sample data to developsample applications. Product names referenced may be the trademarks of theirrespective owners. Unauthorized duplication is prohibited.

© Copyright IBM Corp. 2005, 2016 v

Page 6: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

vi IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 7: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Chapter 1. Installing and configuring Cognos PowerPlayClient

Use this information to install and configure IBM Cognos PowerPlay Client.

You can install PowerPlay Client on the same computer as IBM Cognos Analyticsor IBM Cognos PowerPlay Server, or on a different computer. Do not installPowerPlay Client to the same directory as IBM Cognos Analytics and IBM CognosPowerPlay Server.

PowerPlay Client is available as a 64-bit installation. You can install PowerPlayClient on a 64-bit Microsoft Windows computer.

To install and configure PowerPlay Client, perform the following tasks:v Verify system requirements.v Install PowerPlay Client.v Configure PowerPlay Client, if required.v Test the installation.

If you would like to try experimenting with some of the product features usingsample data, you can install and configure the PowerPlay samples. For moreinformation, see Setting Up the Samples for IBM Cognos PowerPlay Client.

For information about uninstalling the product, see the topic UninstallingPowerPlay Client.

Verify system requirementsUse the following table to check the minimum hardware and softwarerequirements to install and run IBM Cognos PowerPlay Client. Additionalresources may be required for distributed or production environments.

Table 1. Minimum hardware and software requirements for installing IBM Cognos PowerPlayClient

Requirement Specification

RAM Minimum: 2 GB

Disk space A minimum of 2.5 GB of free space is required to install thesoftware and 1 GB of free space on the drive that contains thetemporary directory used by Cognos PowerPlay components.

Web browser For all web browsers, the following are enabled:

v cookies

v JavaScript

For Microsoft Internet Explorer only, the following are enabled:

v Active scripting

v Allow META REFRESH

© Copyright IBM Corp. 2005, 2016 1

Page 8: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Installing Cognos PowerPlay ClientUse the installation wizard to install IBM Cognos PowerPlay Client on a MicrosoftWindows computer.

If you are upgrading from a 10.2.x version of PowerPlay Client, you have thefollowing two choices:v Uninstall the existing version of PowerPlay Client before you install the new

version. If you choose this option, back up your data, such as reports, beforeyou run the uninstall program.

v Install PowerPlay Client version 11.0 to a different location so that you cancontinue using the existing version. You may choose this option if you plan tocontinue using the existing production environment while you install and testthe new version.

The PowerPlay Client version 11.0 installation location must be different from thePowerPlay server and Cognos Analytics server installation location.

Procedure1. Go to the installation source directory, and double-click issetup.exe.2. On the Welcome page of the installation wizard, select one of the available

languages, and click Next.The language that you select determines the language of the installationwizard.

3. In the License Agreement page, select I Agree, and click Next.4. In the Installation Location page, specify the location.

If you decide not to use the default installation location, specify a location thatcontains only ASCII characters.

5. In the User Information page, specify the settings and click Next.6. In the Product Language Selection page, select the language for the product

user interface, and then click Next.Only one language can be selected per installation. Use a language thatmatches the system locale settings. Otherwise, use English. Your font settingsshould also match the system locale. Ensure that the supporting font isinstalled on the client computer.

7. In the Component Selection page, accept the default settings, and click Next.8. Follow the directions in the Shortcut Folder and Installation Summary pages.9. Click Finish.

Configuring Cognos PowerPlay ClientConfiguration is required if you want to use remote PowerCubes as your datasource. To publish reports to the IBM Cognos Analytics portal, you must useremote PowerCubes.

If you install PowerPlay Client to use with local PowerCubes only, noconfiguration is required.

Before you configure PowerPlay Client, ensure that Cognos Analytics is installedand configured. This ensures that the certificate authority service on the ContentManager computer can issue a certificate to the PowerPlay Client, and thatPowerPlay Client can communicate with the gateway.

2 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 9: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Ensure that you use the same URI settings in both the Cognos PowerPlay Clientand the Cognos Analytics installations. For example, use a fully qualified domainname for all URI settings. Do not use a computer name in one configuration, and afully qualified domain name in another configuration.

Contact your Cognos Analytics administrator for the required configurationinformation.

Procedure1. Start IBM Cognos Configuration that is installed with PowerPlay Client.2. In the Explorer pane, click Environment.3. Specify the following settings:

Gateway URIDefault: http://ca_server:port/bi/v1/disp

This URI is specified in Cognos Analytics IBM Cognos Configuration,and passed on to Cognos PowerPlay Client. This URI must always bethe same as for Cognos Analytics.

Dispatcher URI for external applicationsDefault: http://ca_server:9300/p2pd/servlet/dispatch

This URI is specified in Cognos Analytics IBM Cognos Configuration,and passed on to Cognos PowerPlay Client. This URI must always bethe same as for Cognos Analytics.

4. From the File menu, click Save.5. Start the IBM Cognos service.

Restrict port communication between IBM Cognos PowerPlayClient and the Remote PowerPlay Services

PowerPlay Client connects to the remote PowerPlay service through the IBMCognos Analytics gateway.

After establishing a connection through the gateway, by default, PowerPlay usesthe first dynamic port available for communication between PowerPlay Client andthe remote PowerPlay services. In some environments, you might need to restrictcommunication to specific ports, such as when a firewall separates the PowerPlayClient computer and the PowerPlay service computer. To restrict port numbers,you must complete configuration in IBM Cognos Administration on the PowerPlayservice computer and on each PowerPlay Client computer.

Setting a port number for the PowerPlay service computerYou use IBM Cognos Administration to set a port number for the PowerPlayservice.

Procedure1. Start IBM Cognos Administration.2. On the Configuration tab, click Dispatchers and Services.3. Click a dispatcher name to show a list of services.4. In the Actions column, click the Set properties icon for the PowerPlay

Service.5. Click the Settings tab.6. In the Value column, click Edit for the Environment category.

Chapter 1. Installing and configuring Cognos PowerPlay Client 3

Page 10: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

7. Click Override the settings acquired from the parent entry.8. Type the following parameter and value:

Parameter= SRV.PPDSRM.ServerPort, Value= IN,n where n is the restrictedport number, such as 8010. For example, the Parameter is set toSRV.PPDSRM.ServerPort, and the value is set to IN,8010

9. Click OK on the Set advanced settings page.10. Click OK on the Set properties page to save the configuration change.

Setting a port number for the PowerPlay Client computersYou can edit a configuration file to set a port number for PowerPlay Clientcomputers.

Procedure1. On each PowerPlay Client computer, from the

powerplay_client_installation_location\configuration directory, openppds_cfg_xml.sample in a text or xml editor.

2. Locate the following section:<Section value="PPDSRemote"><Port value="0"/><NATTimeout value="-1"/></Section>

3. Change the port value to the restricted port number, such as 8000.Note: Use a different port than the one set as an advanced setting of thePowerPlay service.

4. Save the file, changing the name to ppds_cfg.xml.

Testing the installationYou can test the IBM Cognos PowerPlay Client installation and configuration byopening PowerPlay and connecting to a remote package.

Procedure1. From the programs Start menu, click IBM Cognos PowerPlay Client > IBM

Cognos PowerPlay.If the Welcome page for PowerPlay Client appears, the installation issuccessful.

2. To test the connection to IBM Cognos Analytics, on the Welcome page, clickCreate a new report.

3. Click Remote.4. If prompted, provide your authentication information.5. Select a package, and then click OK.

Results

PowerPlay Client opens the data source and the title bar indicates the remoteconnection and data source name.

Uninstalling Cognos PowerPlay ClientUse the uninstall program to remove IBM Cognos PowerPlay. Do not use theMicrosoft Windows Add or Remove Programs tools.

4 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 11: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Uninstalling does not remove any files that changed since the installation, such asconfiguration and user data files. Your installation location remains on yourcomputer, and you retain these files until you delete them manually.

Before you begin

Close all programs before you uninstall IBM Cognos PowerPlay. Otherwise, somefiles may not be removed.

Procedure1. From the programs Start menu, click IBM Cognos PowerPlay Client >

Uninstall IBM Cognos PowerPlay.The Uninstall Wizard appears.

2. Follow the instructions to uninstall the components.The cognos_uninst_log.txt file records the activities that the Uninstall wizardperforms while uninstalling files. This log file is created in the temp directory.

Chapter 1. Installing and configuring Cognos PowerPlay Client 5

Page 12: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

6 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 13: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Chapter 2. Configuration options

After the installation and initial configuration of IBM Cognos PowerPlay Client,you may need to change configuration settings. Changes are only required whenconfiguration settings change in the IBM Cognos Analytics environment. Forexample, you must update the PowerPlay Client configuration if cryptographicsettings change on the Content Manager computer.

Common configuration changes include:v Changing a URIv Configuring cryptographic settingsv Configuring the Secure Sockets Layer (SSL) protocol

Changing a URIYou can change certain elements in a URI depending on your environment.

When you install Cognos PowerPlay, the installation uses default configurationsettings. If you have any reason not to use the default values, such as a port isbeing used by another process, use IBM Cognos Configuration to change the value.

An IBM Cognos URI contains the following elements:

Gateway URI protocol://host_name_or_IP:port/virtual_directory/gateway_application

or

protocol://host_name_or_IP:port/context_root/alias_path

Dispatcher URI for external applicationsprotocol://host_name_or_IP:port/context_root/alias_path

Table 2. List of elements and descriptions

Element Description

protocol

For example, http or https

Specifies the protocol used to request andtransmit information, either Hyper TextTransfer Protocol or Hyper Text TransferProtocol (Secure).

host name or IP

For example, localhost or 192.168.0.1

Specifies the identity of the host on thenetwork. You can use an IP address, acomputer name, or a fully qualified domainname.

You must change the localhost element of aURI.

In a mixed environment of UNIX andWindows servers, ensure that host namescan be resolved to IP addresses by allservers in the environment.

© Copyright IBM Corp. 2005, 2016 7

Page 14: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Table 2. List of elements and descriptions (continued)

Element Description

port

For example, 9300

Specifies the port on which the host systemlistens for requests.

The default port is 9300. The default port fora web server is 80.

context root

For example, p2pd

Used by an application server to determinethe context of the application so that therequest can be routed to the correct webapplication for processing.

alias path

For example, servlet/dispatch

Used by the application server to route arequest to the correct component within aweb application.

The alias path must not be modified or IBMCognos Analytics components cannotfunction properly.

virtual directory

For example, bi

Used by the web server to map a virtualdirectory or alias to a physical location.

This setting must be the same as in IBMCognos Analytics.

gateway application Specifies the name of the IBM CognosAnalytics gateway application that is used.

Procedure1. Start IBM Cognos Configuration.2. In the Explorer pane, click Environment.3. In the Properties window, click the Value box next to the URI property that

you want to change.4. Select the element and type the new information.5. From the File menu, click Save.

Changing cryptographic settingsCryptographic keys are used to encrypt passwords and data.

All IBM Cognos Analytics server and client components, including CognosPowerPlay Client, must use the same cryptographic keys.

During the initial configuration, PowerPlay Client communicates with ContentManager through the gateway to establish trust and obtain cryptographic keysfrom Content Manager. If the cryptographic keys on the Content Managercomputer change, you must update the PowerPlay Client configuration to obtainthe new cryptographic keys from Content Manager.

Complete the following steps on each PowerPlay Client computer.

8 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 15: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Procedure1. Go to the powerplay_client_installation_location\configuration directory.2. Delete the cert directory.3. Start IBM Cognos Configuration.4. In the Explorer window, under Security, click Cryptography.5. In the Properties window, update the value of the properties as required to

reflect changes in the cryptographic properties on the Content Managercomputer.

6. From the File menu, click Save.

Results

IBM Cognos Configuration creates new cert directory in the configurationdirectory.

Configuring the SSL protocolThe Secure Sockets Layer (SSL) protocol is used to secure communication betweenIBM Cognos Analytics components installed on the same computer or on differentcomputers.

If you configured IBM Cognos PowerPlay Client for access to remote cubes and thePowerPlay servers are configured to use the SSL protocol, you must configurePowerPlay Client to use SSL.

Before you begin

All PowerPlay computers in your environment must use the same protocol. Formore information about configuring SSL on server computers, see the IBM CognosAnalytics Installation and Configuration Guide.

Procedure1. Start IBM Cognos Configuration.2. In the Explorer window, click Environment.3. Configure the SSL protocol by changing the HTTP portion of the URI to HTTPS

and specify the HTTPS port number for either of Gateway URI or DispatcherURI for external applications.If the IBM Cognos PowerPlay server uses a different SSL setting than the oneyou configure, the setting on the server is used.

4. In the Explorer pane, click Security > Cryptography > Cognos.5. In the Properties window, specify a password for the IBM Cognos signing key

store:v Under Signing key settings, click the value for Signing key store password

and then click the edit button.v Type the new password in both boxes and then click OK.

6. In the Properties window, specify a password for the IBM Cognos encryptionkey store.v Under Encryption key settings, click the value for Encryption key store

password and then click the edit button.v Type the new password in both boxes and then click OK.

7. From the File menu, click Save.

Chapter 2. Configuration options 9

Page 16: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

10 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 17: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Chapter 3. Setting up the samples for Cognos PowerPlayClient

The PowerPlay samples are included with the IBM Cognos Analyticssupplementary samples.

The supplementary samples are located in the IBM Cognos Analytics Community,with the Supplementary (Legacy) Cognos Analytics 11 Samples(www.ibm.com/communities/analytics/cognos-analytics-blog/supplementary-ibm-cognos-analytics-11-samples).

The PowerPlay samples are in the IBM_Cognos_PowerPlay.zip deployment archive.The samples are based on data from the great_outdoors_sales_en.mdc samplePowerCube.

Downloading the supplementary samplesThe supplementary samples are available in the IBM Cognos Analytics community.You need to download the samples before you can configure them.

About this task

You download the supplementary samples from the supplementary sampleswebsite (www.ibm.com/communities/analytics/cognos-analytics-blog/supplementary-ibm-cognos-analytics-11-samples). The samples are packaged asLegacySamples.zip. This file includes six deployments, including the deploymentsthat are used with IBM Cognos PowerPlay.

Procedure1. Go to the supplementary samples website (www.ibm.com/communities/

analytics/cognos-analytics-blog/supplementary-ibm-cognos-analytics-11-samples).

2. Download the LegacySamples.zip file, and extract its contents to any locationthat you can access.The LegacySamples.zip file contains the Samples folder that has a number ofsub-folders.The content sub-folder includes the PowerPlay deploymentIBM_Cognos_PowerPlay.zip.The datasources\cubes\PowerCubes\EN sub-folder includes the PowerCubegreat_outdoors_sales_en that is used as a data source for the PowerPlayreports.

3. Copy the PowerPlay deployment archive to the Cognos Analytics Deploymentfiles location that is specified in IBM Cognos Configuration. The defaultlocation is cognos_analytics_installation_location/deployment.

Creating a data source connection to the sample PowerCubeThe sample reports are based on a sample PowerCube namedgreat_outdoors_sales_en.mdc. You must create a data source connection to thisPowerCube to be able to use the samples.

© Copyright IBM Corp. 2005, 2016 11

Page 18: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

The great_outdoors_sales_en.mdc PowerCube is located in theSamples\datasources\cubes\PowerCubes\EN folder in the supplementaryLegacySamples.zip that you downloaded.

Procedure1. Connect to the IBM Cognos Analytics portal.2. In the Welcome page, click Manage > Administration console.3. In IBM Cognos Administration, click the Configuration tab.

4. Click the New Data Source button .5. In the Name box, type great_outdoors_sales_en

The name must be all lowercase and include the underscore characters ratherthan spaces.Click Next.

6. In the Type box, select IBM Cognos PowerCube, and click Next.7. In the Windows location box, type the location and file name for the

great_outdoors_sales_en.mdc PowerCube.The location can be C:\LegacySamples\Samples\datasources\cubes\PowerCubes\EN\great_outdoors_sales_en.mdc

8. To confirm that you entered all parameters correctly, click Test theConnection.After you test the connection, click Close on both the View the Results andTest the Connection pages to return to the connection string page.

9. Click Finish.10. On the Finish page click OK. Do not select Create a Package.

Results

After you finish creating the connection, the great_outdoors_sales_en entryappears in the list of data sources in Data Source Connections. Next, you need toimport the sample deployment to your IBM Cognos Analytics environment.

Importing the sample deploymentTo make the sample reports available for use in IBM Cognos PowerPlay Client,you must import the PowerPlay deployment archive that you downloaded fromthe supplementary samples website.

The deployment archive that you can use with PowerPlay is calledIBM_Cognos_PowerPlay.zip.

Procedure1. Copy the sample deployment IBM_Cognos_PowerPlay.zip from your

supplementary samples download location to the IBM Cognos AnalyticsDeployment files location specified in Cognos Configuration. The defaultlocation is cognos_analytics_installation_location/deployment.

2. Connect to the IBM Cognos Analytics portal.3. In the Welcome page, click Manage > Administration console.4. On the Configuration tab, click Content Administration.

5. Click the New Import button .

12 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 19: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

6. Select the deployment, IBM_Cognos_PowerPlay.zip, and click Next.7. In the Select the public folders, directory and library content page, select the

check box next to the folder name Samples_PowerPlay.Keep the default target folder name and location, and then click Next.

8. In the next few pages, keep the default options, and click Next.9. Select Save and run once, and click Finish.

10. Select Now, click Run, and then OK.

Results

The entry IBM_Cognos_PowerPlay appears in Content Administration.

The folder Samples_PowerPlay appears in Team content in the Cognos Analyticsportal. These folders contain the sample PowerPlay packages and reports.

Testing a sample report in IBM Cognos PowerPlay ClientYou can test the samples by opening reports in IBM Cognos PowerPlay Client.

To test a report based on a remote package, a sample package must be set up onthe PowerPlay installation.

Procedure1. Start PowerPlay Client.2. In the Welcome page, click Open an existing report.3. Choose the type of report you want to open.v To open a report located on your computer or a shared network drive, click

Local, and then navigate to the report you want to open.v To open a remote report, click Remote, and then select the package and

report you want to open.

Results

The report opens in PowerPlay.

Chapter 3. Setting up the samples for Cognos PowerPlay Client 13

Page 20: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

14 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 21: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Appendix. Accessibility features

Accessibility features help users who have a physical disability, such as restrictedmobility or limited vision, to use information technology products.

See the IBM Accessibility Center (http://www.ibm.com/able) for more informationabout the commitment that IBM has to accessibility.

See the IBM Cognos Analytics Accessibility Guide for information about accessibilityin Cognos Analytics.

Keyboard shortcuts for the Installation WizardKeyboard shortcuts, or shortcut keys, provide you with an easier and often fastermethod of navigating and using software.

The installation wizard uses standard Microsoft Windows operating systemnavigation keys in addition to application-specific keys.

Note: The following keyboard shortcuts are based on US standard keyboards.

The following table lists the keyboard shortcuts that you can use to perform someof the main tasks in the installation wizard on the Windows operating system.

Table 3. List of keyboard shortcuts on a Windows operating system

To do this Press

Move to the next field on a page Tab

Return to the previous field on a page Shift+Tab

Close the installation wizard Alt+F4

Move to the next configuration step Alt+N

Return to the previous configuration step Alt+B

Move to the next selection in a list Down arrow

Move to the previous selection in a list Up arrow

The following table lists the keyboard shortcuts you can use to perform some ofthe main tasks in the installation wizard on the UNIX or Linux operating system.

Table 4. List of keyboard shortcuts on a UNIX or Linux operating system

To do this Press

Move to the next field on a page Tab

Return to the previous field on a page Shift+Tab

Close the installation wizard Alt+F4

Move to the next selection in a list Down arrow

Move to the previous selection in a list Up arrow

The following table lists the keyboard shortcuts you can use to perform some ofthe main tasks in the License Agreement page of the installation wizard.

© Copyright IBM Corp. 2005, 2016 15

Page 22: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Table 5. List of keyboard shortcuts on the License Agreement page

To do this Press

Accept the license agreement Alt+A

Decline the license agreement Alt+D

Quit the installation wizard Alt+x

The following table lists the keyboard shortcuts you can use to perform some ofthe main tasks in IBM Cognos Configuration on a Windows operating system.

Table 6. List of keyboard shortcuts for IBM Cognos Configuration on a Windows operatingsystem

To do this Press

Save the current configuration Crtl+S

Close IBM Cognos Configuration Alt+F4

Rename the selected item F2

Display the File menu Alt+F

Display the Edit menu Alt+E

Display the View menu Alt+V

Display the Actions menu Alt+A

Display the Help menu Alt+H

The following table lists the keyboard shortcuts you can use to perform some ofthe main tasks in IBM Cognos Configuration on a UNIX or Linux operatingsystem.

Table 7. List of keyboard shortcuts for IBM Cognos Configuration on a UNIX or Linuxoperating system

To do this Press

Save the current configuration Crtl+S

Close IBM Cognos Configuration Alt+F4

Rename the selected item F2

16 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 23: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Notices

This information was developed for products and services offered worldwide.

This material may be available from IBM in other languages. However, you may berequired to own a copy of the product or product version in that language in orderto access it.

IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service. This document maydescribe products, services, or features that are not included in the Program orlicense entitlement that you have purchased.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law: INTERNATIONALBUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFNON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULARPURPOSE. Some states do not allow disclaimer of express or implied warranties incertain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

© Copyright IBM Corp. 2005, 2016 17

Page 24: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Software GroupAttention: Licensing3755 Riverside Dr.Ottawa, ONK1V 1B7Canada

Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

18 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 25: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

If you are viewing this information softcopy, the photographs and colorillustrations may not appear.

Depending upon the configurations deployed, this Software Offering may usesession and persistent cookies that collect each user'sv namev user namev password

for purposes ofv session managementv authenticationv enhanced user usabilityv single sign-on configurationv usage tracking or functional purposes other than session management,

authentication, enhanced user usability and single sign-on configuration

These cookies cannot be disabled.

If the configurations deployed for this Software Offering provide you as customerthe ability to collect personally identifiable information from end users via cookiesand other technologies, you should seek your own legal advice about any lawsapplicable to such data collection, including any requirements for notice andconsent.

For more information about the use of various technologies, including cookies, forthese purposes, see IBM's Privacy Policy at http://www.ibm.com/privacy andIBM's Online Privacy Statement at http://www.ibm.com/privacy/details in thesection entitled "Cookies, Web Beacons and Other Technologies" and the "IBMSoftware Products and Software-as-a-Service Privacy Statement" athttp://www.ibm.com/software/info/product-privacy.

Notices 19

Page 26: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

20 IBM Cognos PowerPlay Client Version 11.0: Installation and Configuration Guide

Page 27: Micr osoft pr oduct scr een shot(s) used with permission ... · This guide contains instr uctions about installing and testing PowerPlay Client, and about setting up samples. Audience

Index

Aaccessibility features 15

Cchanging

default configuration settings 7configuration

changing cryptographic settings 9changing URIs 8default settings for PowerPlay 7

configuringSSL protocol 9

configuring PowerPlay Client 3cryptographic settings

changing 9cubes,

See PowerCubes

Ffirewalls

configuring port numbers 3

Kkeyboard shortcuts 15

Pport numbers

configuring 3

portschanging 8

PowerCubesPowerPlay samples 11

PowerPlay Clientuninstalling 5

Ssample PowerCube

setting up 11secure sockets layer,

See SSL protocolshortcut keys 15SSL protocol

configuring 9system requirements 2

Ttesting

installation 4sample reports 13

Uuninstalling

PowerPlay Client 5URIs

changing 8

© Copyright IBM Corp. 2005, 2016 21