You are on page 1of 104

<HEAD>

<meta name="last-review" content="21-02-2003">

<meta name="title" content="Cognos PowerPlay Enterprise Server Guide">

<meta name="product" content="PowerPlay Enterprise Server">

Cognos

<meta name="version" content="7.1">

<meta name="prodversion" content="PowerPlay Enterprise Server-7.1">

<meta name="area" content="support">

PowerPlay

(R)

<meta name="classification" content="documentation">

</HEAD>

Enterprise Server Help

Enterprise Server Guide

Product Information
This document applies to PowerPlay ( R ) Version 7.1 and may also apply to subsequent releases. To check for newer versions of this document, visit the Cognos support Web site (http://support.cognos.com).

Copyright
Copyright (C) 2003 Cognos Incorporated While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in this document. This document shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to either the product or the document will be documented in subsequent editions. U.S. Government Restricted Rights. The software and accompanying materials are provided with Restricted Rights. Use, duplication, or disclosure by the Government is subject to the restrictions in subparagraph (C)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (C) (1) and (2) of the Commercial Computer Software - Restricted Rights at 48CFR52.227-19, as applicable. The Contractor is Cognos Corporation, 67 South Bedford Street, Burlington, MA 01803-5164. This software/documentation contains proprietary information of Cognos Incorporated. All rights are reserved. Reverse engineering of this software is prohibited. No part of this software/documentation may be copied, photocopied, reproduced, stored in a retrieval system, transmitted in any form or by any means, or translated into another language without the prior written consent of Cognos Incorporated. Cognos, the Cognos logo, Axiant, COGNOSuite, Cognos Upfront, Cognos DecisionStream, Impromptu, NoticeCast, PowerCube, PowerHouse, PowerPlay, Scenario and 4Thought are trademarks or registered trademarks of Cognos Incorporated in the United States and/or other countries. All other names are trademarks or registered trademarks of their respective companies. Information about Cognos Products and Accessibility can be found at www.Cognos.com

Table of Contents
Welcome 7 Chapter 1: Enterprise Reporting 9 How Enterprise-wide Deployment Works 9 PowerPlay Client Applications 10 Server Architecture 11 Data Sources 13 Retain Cubes from Previous Versions 14 Chapter 2: Configure Servers 15 A Central Starting Point for Server Administration 15 PowerPlay Server Configuration 15 Services and Daemons 15 Start and Stop Windows Services 16 Start and Stop UNIX Daemons 16 PowerPlay Enterprise Server Cleanup 17 Check the Windows Environment Variables 18 Override Display Settings with Style Sheets 18 Enable Data Export on the Web 19 Modify the Locale Settings Available to Users 19 Enable Accessibility Support 19 PDF Server Configuration 20 Font Support Within PDF Generation 20 Compress Pages and Resources 20 Security 21 Change the Enterprise Server Port Number 21 Restrict the Outgoing Web Port 21 Change the Port for Windows Connections 22 Configure Security on a Microsoft Web Server 22 Audit Server Activity 23 Performance Monitor 28 Configure the Ticket Server 29 Secure a Server 29 Disable Saving of Cognos Sub-Cubes 30 Specify an Authentication Namespace For a Cube 30 Chapter 3: Control Processes 31 Distributed Processing 31 Set the PowerPlay Service for User Logon 31 Server Groups 32 Ppservertemp 32 Mount At 33 Load Balancing using Mirror References 33

Enterprise Server Guide 3

Monitor Processes 36 Monitor Web Connections 37 Monitor Windows Connections 37 Define the Maximum Number of Processes 38 Limit the Processing Time 38 Configure How Windows Processes are Scheduled 39 Stop Processing Requests 39 Set the Process Cache Size 40 Performance Issues for Large Cubes 41 Chapter 4: Deploy Cubes and Reports 43 PowerPlay Enterprise .Server Administration 43 Connect to a Server 45 Discover Servers 45 Folders and Collections 45 Add a Folder 46 Add a Collection 46 Cubes and Reports 47 Add a Cube or Report 47 Add a Mirror Reference 47 Move or Copy a Cube or Report 48 Remove a Cube or Report 49 Add Custom Buttons 49 Add Dimension Line Information to an Exported CSV File 49 Make the Dimension Line Static 50 Add a Title 50 Restrict Embedded HTML Tags in Report Titles 50 Search for a Cube or Report 51 Web Reports 51 Test a Connection 51 Publish to Upfront 52 Show a Table of Contents 53 Disable a Table of Contents 54 Enable Preference Settings 54 Customize the PowerPlay Web Explorer Displays 55 Improve Web Performance 55 Set Export PDF Preferences 55 Embed Fonts in a Report 56 Chapter 5: Provide Drill-through Access 59 General Drill Through Considerations 59 Set Up Drill-through Targets in Transformer 60 Drill Through from Cube to Cube 61 Enable Drill Through to Cubes 61 Drill Through to Cognos Query 62 Design Queries as Drill-through Targets 62 Save a Drill-through Target in Cognos Query 63 Enable Drill Through to Cognos Query 63 Drill Through to Impromptu Web Reports 63 Enable Drill Through to Impromptu Web Reports 64 Drill Through to Impromptu 64 Drill Through to Third Party OLAP Sources 65 Appendix A: Context Help 67 Server Properties (General tab) 67 4 PowerPlay (R) .

Cube.Server Properties (Settings tab) 67 Options 67 PowerPlay Web Explorer 69 PowerPlay Web Viewer 69 PDF Server 69 Cube Properties (General tab) 70 Report Properties (General tab) 70 Folder Properties (General tab) 71 Folder. and Report Properties (Settings tab) 71 Options 71 Process Control 73 Publishing 74 Authentication 75 Display 75 Drill Through 81 Connect to Server 82 Set Server Password 82 Set Security 83 Search 83 Select Mirror References 83 Title 83 Shortcut 84 Rename 84 Appendix B: Batch Administration 85 The ppadmtool Program 85 Name 85 Synopsis 85 Description 87 Conventions 87 Options 87 Appendix C: Managing Temporary Files 91 Temporary File Modes 91 Temporary File Access Configuration 91 Fetch Temporary Files 92 Setting the Base HREF 92 Configuring Mirrored Servers and Cubes After a Default Installation 92 Temporary Files and Mirroring Under Windows 2000 93 Glossary 95 Index 99 Enterprise Server Guide 5 .

6 PowerPlay (R) .

All online books are available on the Cognos documentation CD. Please see the Upfront Server Administrator Guide and the Access Manager Administrator Guide. The information in each online help system is available in online book format (PDF). This document is also available in Acrobat format from the PowerPlay Enterprise Server administration tool (Help menu).com). copy. In Windows products. and other pieces to meet the needs of our varied audience. or from within the Cognos Web portal (Upfront). tutorial guides. online books are available from the Windows Start menu (Cognos) and from the product Help menu (Books for Printing). Other Documentation Our documentation includes user guides.cognos. reference books. visit the Cognos support Web site (http://support. in printed or electronic format. non-transferable license to use. Use online books when you want a printed version of a document or when you want to search the whole document. In a Web browser. This document contains • an overview of deploying PowerPlay reporting for the enterprise • information on configuring and securing your PowerPlay servers and their processes • cube and server deployment tasks using the PowerPlay Enterprise Server administration tool • details on setting up drill through from cubes • syntax for using the ppadmtool command-line utility The Enterprise Server Guide does not include information about administering Upfront and Access Manager. Cognos grants you a non-exclusive. is available from the Windows Start menu. or the Help menu and Help button in Windows products. the information from a given help system may be divided into more than one online book.Welcome What Is in This Document The PowerPlay Enterprise Server Guide shows you how to administer PowerPlay servers and deploy cubes and reports to PowerPlay users in the Windows environment or on the Web. solely for the purpose of providing internal training on. operating. You can print selected pages. Questions or Comments? For additional technical information about using PowerPlay Enterprise Server. a section. However. the Documentation Roadmap. An annotated list of other documentation. All information is available in online help. and maintaining the Cognos software. You can also read the product readme files and the installation guides directly from the Cognos product CDs. Online help is available from the Help button in a Web browser. or the whole book. online books may be available from the Welcome section of the help system. and reproduce the copyright materials. Enterprise Server Guide 7 . Only the installation guides are available as printed documents.

Welcome 8 PowerPlay (R) .

you can deploy cubes that are user class protected. or a server name (from Windows client applications). depending on the anticipated load. When new data is published. explore and analyze the data. you can publish cubes and reports to Upfront. users can access the data they want when they want it. • Users open deployed cubes and reports by connecting to the PowerPlay server with either a URL. Enterprise-wide deployment consists of the following: • All PowerPlay systems start with a multidimensional data source (p. including the Cognos PowerCube. Enterprise Server Guide 9 . Windows. UNIX servers. and installed databases • centralized administration from any platform on the network • LDAP-based security to control access to data. granting user privileges to specified drill-down levels in the multidimensional cube data.Chapter 1: Enterprise Reporting PowerPlay Enterprise Server is the Cognos solution for enterprise OLAP (on-line analytical processing) reporting. you then publish cubes and reports to one or more application servers. and then share or publish new reports back to the server. Published cubes are automatically registered with PowerPlay Enterprise Server and saved in a common format that is accessible by any PowerPlay client application. such as from Upfront. Excel. It offers • a centralized OLAP application server for Web. If security is a concern. Users can access reports and cubes at will. Users can also drill through to details in other applications or in other cubes located in the same environment (Web or Windows). and whether a cube is available from the Web or Windows. or portions of the data. PowerPlay for Excel. 13) called a cube. • You can specify cube and report attributes such as drill-through URLs. You can add mirror references to cubes and reports on another computer where the processing takes place. or PowerPlay Web). • Using PowerPlay Enterprise .Server Administration. depending on the user • automatic load balancing using distributed processing of user requests • a browser-based portal to organize access to all your business intelligence information How Enterprise-wide Deployment Works Enterprise-wide deployment means making the technology available to everyone in your organization. it immediately becomes available to all users. the maximum number of processes to use. or from both. and mobile users • a scalable architecture to meet the growing needs of the enterprise • flexible deployment options to support your existing Windows NT and Windows 2000 servers. the Cognos portal. Because PowerPlay Enterprise Server handles simultaneous requests from any client type (Web or Windows) to any cube or report. administering all your cubes and reports from one computer. Report authors can publish directly from any PowerPlay client application (PowerPlay for Windows. You can use cubes from several OLAP providers. • Alternatively.

you can provide analysis and reporting capabilities to Windows or Web-based client applications from a centralized production environment. Client (Local Cubes) PowerPlay Web (using a Web browser) Server (Remote Cubes) PowerPlay Enterprise Server PowerPlay for Windows PowerPlay for Excel 10 PowerPlay (R) . On the Web PowerPlay Web Explorer is a zero-footprint client. PowerPlay Web Viewer offers report consumers the ability to run published reports and view them in PDF format. PowerPlay Web Explorer and PowerPlay Web Viewer are related Web applications.Chapter 1: Enterprise Reporting PowerPlay Client Applications The Enterprise Server client applications belong to the PowerPlay family of products. The client applications connect to local cubes directly or to remote cubes on a server. PowerPlay for Excel offers full OLAP analysis and reporting to users who prefer to work with Microsoft Excel spreadsheets. In Windows PowerPlay for Windows offers advanced OLAP functionality for in-depth analysis and report authoring and viewing. collectively referred to as PowerPlay Web. offering all essential OLAP analysis in HTML format. Web Clients PowerPlay Web Explorer Web Server Windows PowerPlay for Windows PowerPlay for Excel PowerPlay Web Viewer PowerPlay Enterprise Server Client applications run from the Web or in Windows. When you deploy cubes to PowerPlay Enterprise Server. PowerPlay users can use the following applications.

limited only by available memory. you can also configure the system to allow each dispatcher to share the reports that are published to Upfront. Enterprise Server Guide 11 .Chapter 1: Enterprise Reporting Server Architecture PowerPlay Enterprise Server consists of three components that you can install separately: • The gateway component is. When a request is received. If you install multiple dispatchers. but a Web server that runs on Windows. or forwards the request to another dispatcher on another computer. • The dispatcher is a Windows service or a UNIX daemon that receives PowerPlay requests (either directly from a Windows client or from the gateway for a Web client) and manages the request queue. you can configure Cognos Web products to use alternate gateways that replace the default CGI programs. if you use a router to distribute Web requests to different gateways and different dispatchers. see the installation guide and the Advanced Planning and Configuration Guide. Most components have a Windows and UNIX equivalent. For example. You can install components on separate computers. The gateway must be located on all Web servers that receive PowerPlay requests. The maximum number of processes can be set in the administration tool. Several instances of either processor may be started. Alternate Gateways To improve Web server performance. a CGI (Common Gateway Interface) program that handles Web requests. and you can combine these in any way. The query processor handles cube requests from PowerPlay Web Explorer. This allows users to locate their published reports regardless of the dispatcher they are routed to. The report processor handles report requests from PowerPlay Web Viewer and printing requests from PowerPlay Web Explorer. PowerPlay for Windows. Alternate gateways (p. you can ensure that your users will always be able to locate their reports. For example. The dispatcher passes the requests to a query or report processor on the same computer. and for NSAPI to support Netscape Web Server on both Windows and UNIX. but requires careful consideration in order to get optimum performance. and PowerPlay for Excel. an instance of the gateway is created to handle the request. This flexibility is almost limitless. • The processors process requests and generate results for the client applications. PowerPlay Enterprise . you may have a data mart that consists of several UNIX computers on which you plan to store cubes. PowerPlay Enterprise Server Windows client LAN Web client Gateway Dispatcher Processors Extranet/Intranet The PowerPlay Enterprise Server architecture adapts to your existing and expanding IT infrastructure in a mixed computing environment. or combine components on one or more computers. by default. The alternate gateways are native server extensions for ISAPI to support Microsoft Internet Information Server on Windows. For information about installing and configuring the various components of PowerPlay Enterprise Server. 11) may also be used.Server Administration.

dll cqnsapi. you must also update the NoticeCast Gateway URL property. If you change the Upfront gateway.dll ppdsnsapi.dll imrapnsapi.sl (for HP-UX) ppdsnsapi.so (for AIX and Solaris) Impromptu Web Reports imrapisapi. you must also update the NoticeCast Gateway URL property. Notification server groups reference the Upfront gateway.sl (for HP-UX) imrapnsapi.sl (for HP-UX) cqnsapi.sl (for HP-UX) upfnsapi.dll fmnsapi.so (for AIX and Solaris) Upfront File Manager fmisapi. If you change the Upfront gateway.dll imrapnsapi.so (for AIX and Solaris) PowerPlay Enterprise Server ppdsisapi.dll ppdsnsapi.sl (for HP-UX) fmnsapi.Chapter 1: Enterprise Reporting Cognos Web products include the following alternate gateways: Server Group Cognos Query Alternate Gateways cqisapi.dll upfnsapi.so (for AIX and Solaris) Upfront upfisapi. Notification 12 PowerPlay (R) .dll cqnsapi.dll upfnsapi.dll fmnsapi.so (for AIX and Solaris) NoticeCast NoticeCast server groups reference the Upfront gateway.

Performance Performance is generally faster when the data sources are located on the computer that processes them. You can add cubes to a PowerPlay server using PowerPlay Enterprise . For information about the most recent database versions supported. 85). Reports Reports are prepared for report consumers using any PowerPlay client application. You may add reports using PowerPlay Enterprise . For information about creating and optimizing cubes. which should always be the case if the . users must be connected to a cube on PowerPlay Enterprise Server (a remote cube).ppx file that is associated with the cube. see the OLAP Server Connection Guide. previously known as Microsoft SQL Server Analysis Services (PowerPlay Enterprise Server on Windows only) • SAP BW (PowerPlay Enterprise Server on Windows only) Third-party OLAP sources require an associated pointer file (. Publishing a report creates a . you must ensure that the associated cube is also on a PowerPlay server.mdc) PowerCube from Transformer Reports (. Enterprise Server Guide 13 . Location The data source files for cubes and reports may be located on the same computer as the server. you can partition large cubes to speed up access to more frequently requested categories.Server Administration or the ppadmtool command-line utility (p. To publish a report. This also ensures that cubes are read into memory for processing as quickly as possible. Consider placing cubes on a computer where PowerPlay Enterprise Server is installed to reduce network traffic. see Discovering Transformer.ppx file was created while the user was connected to a remote cube. the query or report processor component. Cubes (.com). For example. You can also optimize cube performance in Transformer. or elsewhere on the LAN. see the Cognos Support Web site (http://support. Cubes can also be OLAP data sources from any of the following third-party servers: • Hyperion Essbase • IBM DB2 OLAP Server • Microsoft Analysis Services.mdc) and PowerPlay portable reports (.ppx) PowerPlay portable report from PowerPlay client application .ppx) as data sources for client applications. However.Server Administration or the ppadmtool command-line utility.mdc) that is easily created using the PowerPlay Connect utility. and stored in a directory. PowerPlay users can register a report on the server (publishing) themselves. For information about OLAP data sources.cognos.mdc cube pointer file from PowerPlay Connect OLAP server Cubes Cubes can be created using Transformer. that is.Chapter 1: Enterprise Reporting Data Sources PowerPlay Enterprise Server uses multidimensional cubes (.

For instructions about upgrading from a previous version of PowerPlay Enterprise Server. if you use a UNC path. To allow PowerPlay Enterprise Server to access remote cubes. see the Windows documentation for the Services application of the Control Panel to configure Startup properties. you must give account logon privileges for the remote systems to PowerPlay Enterprise Server. For information about configuring account logon privileges. you can retain the settings for the cubes you currently administer. see the installation guide. for example. Retain Cubes from Previous Versions If you upgrade from a previous version of PowerPlay Enterprise Server. by default. 14 PowerPlay (R) .Chapter 1: Enterprise Reporting Windows Privileges Under Microsoft Windows NT or Windows 2000. services can log on only to system directories.

exe UNIX daemon ppserver TicketServerd UpfAdmin dbserv Cognos Upfront Administration UpfrontAdministration. PowerPlay Server Configuration Many of the PowerPlay server settings are available from PowerPlay Enterprise . and then click Cognos Server Administration. The Cognos Server Administration utility provides a single point of entry into the administration tools and indicates the order that should be followed to set up and run a Cognos server-based application.exe Service (cern) Cognos Upfront Data Store (cern) upfdbsrv. The advanced settings discussed in this chapter can also be configured using the Cognos Configuration Manager. To launch Cognos Server Administration.Server Administration. Impromptu Web Reports.exe TicketServer. some advanced settings must be configured at the operating system level. contain common administration tools as well as server-specific administration tools. However. Services and Daemons The following Windows services and UNIX daemons are associated with a PowerPlay Enterprise Server installation: Windows service name Cognos PowerPlay Enterprise Server (cern) Cognos Ticket Server Windows process ppserver. see the Cognos Configuration Manager User’s Guide. select Cognos Series 7 Version 2. For information about configuring the components of PowerPlay Enterprise Server using the Configuration Manager. It contains information about • Server Administration • Windows NT/2000 services and UNIX daemons • configurations at the operating system level • the PDF server • security A Central Starting Point for Server Administration The Cognos server products.Chapter 2: Configure Servers This chapter describes the operations you use to configure your PowerPlay servers. Cognos NoticeCast. namely Cognos Query.exe Enterprise Server Guide 15 . select Programs. Cognos Server Administration acts as a console for relevant administration utilities. and PowerPlay Enterprise Server. The Cognos Configuration Manager is the interface tool that you use to configure all components of a Cognos Series 7 installation. from the Start menu. including the PowerPlay Enterprise server.

click Settings. use the Windows Services program. Start and Stop UNIX Daemons To start or stop a UNIX daemon. Note: You can also use Configuration Manager to start and stop services. For more information. Select a service and click the Start or Stop button. Use the stop_ppsrv. Double-click Administrative Tools. By default. Steps for Windows NT 1. This dispatcher is automatically restarted as needed. 16 PowerPlay (R) . the service named Cognos PowerPlay Enterprise Server (cern) is configured to log on as the system when it is started. For example. From the Start menu. For example. each of which runs as a daemon. each of which runs as a service called Cognos PowerPlay Enterprise Server (cer n). you can stop PowerPlay servers running on individual computers by stopping the dispatchers.exe ncdispatcher. Select a service and click the Start Service or Stop Service button. Double-click Services.Chapter 2: Configure Servers Windows service name Cognos Upfront Dispatcher (cern) Cognos Upfront Event Server (cern) Windows process UpfDispatcherService. use one of the included scripts.exe UNIX daemon UpfDispatcherService ncdispatcher Start and Stop Windows Services To start or stop a Windows service. Control Panel. For example. you can stop PowerPlay servers running on individual computers by stopping the dispatchers. these scripts are located in the cern bin directory. Double-click Services. Daemon ppserver Scripts start_ppsrv. You would typically have the service log on using an account that already has the necessary privileges. Steps for Windows 2000 1. 3. see the Configuration Manager User Guide.sh script. click Settings. However. From the Start menu. cogcomsvc7_0 The scripts for starting and stopping ppserver also starts and stops cogcomsvc7_0.Server Administration.sh stop_ppsrv. 4. a system account may not have access privileges to certain locations on the network. such as a Domain user. 2.sh By default. it may not be able to read remote cubes using a UNC path specified in PowerPlay Enterprise . 2. and then click Control Panel. 3.

ncdispatcher start-ncdispatcher stop-ncdispatcher By default. Steps 1. UpfDispatcherService start-dispatcher stop-dispatcher By default. 2. these scripts are located in the directory where you installed Sun ONE Directory Server. Run the script from a UNIX shell. Instead of using these scripts. Locate the script you want to run. these scripts are located in the bin directory ns-admin start-admin stop-admin By default. 91) for temporary file access. upfserver start-dbserv stop-dbserv stop-upfadmin By default. these scripts are located in the slapd-alias directory.Chapter 2: Configure Servers Daemon UpfAdmin Scripts start-upfadmin stop-upfadmin By default. these scripts are located in the bin directory. a service is required to delete old files on the machine. Enterprise Server Guide 17 . you can use the Web browser interface of Sun ONE Administration Server (ns-admin) to start and stop the directory server. For more information. PowerPlay Enterprise Server Cleanup On a gateway machine using CGI Temp mode (p. these scripts are located in the bin directory ncserver start-ncserver stop-nc-server By default. ns-slapd start-slapd stop-slapd By default. these scripts are located in the bin directory. see the Configuration Manager User Guide. these scripts are located in the bin directory. Tip: You can also run UNIX scripts using the command line interface in Configuration Manager. There is a UNIX and Windows utility that periodically removes these files.

Ensure that the owner of the web server has read access to ppweb. Advanced Properties). Double-click System. Check the System Variables list. For information about cascading style sheets. Steps 1.css. click Settings. 6. 3. not user environment variables. Steps for Windows NT 1. 2. Add. visit the World Wide Web Consortium (W3C) Web site at www. comment out. 5. 4. From the Windows Start menu. Control Panel. This file contains a set of default styles and a description of what those styles affect. or remove the comment symbols from any of the properties. 3. Control Panel.css. the cube display settings have no effect. Refresh the browser to see the resulting changes. you can reverse the font and background colors of table headings for emphasis. You can use the style sheet to customize the look of your pages. Check the Windows Environment Variables The Cognos PowerPlay Enterprise Server (cern) service can use only system environment variables. 5. If you remove the comment symbols from any styles that have corresponding cube display settings in PowerPlay Enterprise . 4. The style sheet definitions override display settings for cubes. the PowerPlay Enterprise Server cleanup service can be invoked (Configuration Manager. Override Display Settings with Style Sheets PowerPlay Enterprise Server uses a cascading style sheet (CSS) to describe how Web pages are presented in users' Web browsers. which the PowerPlay server refers to when constructing each HTML page. From the Windows Start menu. 2. it will periodically manage the cleanup of these temporary files. Save and close the file. Click the Environment Variables button. The styles are defined in the file ppweb. Open the file ppweb. 2.Chapter 2: Configure Servers The CGI process creates and reads the temporary files.Server Administration. To check environment variables. generally those you can set using PowerPlay Enterprise Server Administration. 3. use the Windows System Properties.org.css before editing it. Some styles. It is located in the webcontent/ppwb directory. 4. click Settings. For example.w3. If a PPES cleanup service is installed on the machine. 18 PowerPlay (R) .css in a text editor. Click the Advanced tab. Ensure that you back up ppweb. Double-click System. Steps for Windows 2000 1. Click the Environment tab. Check the System Variables list. contain comment symbols (/* to *) so that you can selectively activate styles. Descriptions in commented text precede each block. To enable automatic removal of these files.

However. On user systems (for Internet Explorer) or Web browsers (for Netscape).css file. For more information. users can choose to show measures with the comma (. if a cube contains multidimensional data for sales in France in euros. Enterprise Server Guide 19 . For example. and promotes initiatives that make workplaces and technologies accessible. and other more recent versions of popular Web browsers. From the File menu. On the Web server.Chapter 2: Configure Servers Notes • CSS is supported by Internet Explorer 3. For information about mapping MIME types. To enable accessibility. By default. Netscape Navigator 4. From the View menu. To enable data export. Web browsers support CSS in different ways. may impact performance.Server Administration. Steps 1. see the documentation provided with your Web server. click Advanced. 55). You should not delete ppweb. reports published to a PowerPlay Enterprise Server are not accessible to disabled users. associate the . have users associate the . You can modify many display settings using PowerPlay Enterprise . You should test your style sheets with different Web browsers to be sure you have the correct effect. Cognos introduces its report-reading solution for accessibility. as a result. The current configuration of your computer appears in the Configuration Manager window. Enable Accessibility Support Cognos is committed to assisting people with disabilities. you configure a MIME (multipurpose Internet mail extension) mapping for the Web server and the Web browsers. 2. 3. Start Configuration Manager.csv extension with an application used to view the exported data and with the following MIME type: text/x-csv Modify the Locale Settings Available to Users PowerPlay Web users can change their locale settings in the Table of Contents page (Preferences tab). see the Configuration Manager User Guide.css to disable styles. which can be read by applications such as Microsoft Excel. Note: PDF documents that support software accessibility guidelines contain additional markup information that increases the size of the PDF file produced and. comment out the styles you don't want.csv extension with the following MIME type: text/x-csv 2. • • Enable Data Export on the Web You can allow PowerPlay Web Explorer users to export report data from a cube for use in another application. because some browsers do not function properly when a style sheet is referenced but not found. Steps 1.csv. For more information about modifying locale settings. For more information about exporting data as .csv (comma separated text values) file format. you must specify the appropriate setting in Configuration Manager.) decimal separator. Instead. or load a copy of the original ppweb. The exported data is saved using the . These settings change the numeric and currency formats that appear in PowerPlay Web pages. see the PowerPlay Web online help. click Open the current configuration. see "Customize the PowerPlay Web Explorer Displays" (p. With Series 7 Version 2.

Resources are the fonts.Server Administration. 6.Server Administration. click Properties. it is not compressed. PDF reports use less space in memory caches and disk caches. Use the Default Font property in Configuration Manager to change the default font. and they use less disk space. For non Latin-1 languages. click a server. It is also beneficial to be able to search specified directories for fonts. including page and resource compression. The higher the compression factor. Under the Cognos PowerPlay Enterprise Server/Dispatcher component. such as C:/WINNT/FONTS. the default font is one of the larger world fonts from the Andale font family. In order to create PDF files that include accessibility markup tags. When you compress resources. compression is not done. including multi-byte languages. You can control compression of pages and resources by setting a compression factor and a minimum page size. From the Actions menu.D:/Program Files/Cognos/cern/bin/fonts. This property is specified as a list of directory names separated by semi-colons. You can determine what settings are required by monitoring the status of running reports using the Monitor tab in PowerPlay Enterprise . click the Accessibility category. If you set the Compression Factor to 0. beneath PDF Server. When you compress pages. The PDF server is automatically tuned for optimal performance. The higher the minimum size. Dutch. images. German. 2. Note: If you change the setting for Accessible PDF. Compress Pages and Resources Pages are the actual pages of the report. it takes less time to download PDF reports.Chapter 2: Configure Servers 4. Some settings are specific to PowerPlay Enterprise Server. This font is used when the font specified in the report definition cannot be found on the server. If a page consumes fewer bytes. PDF Server Configuration The PDF server is the component used by PowerPlay Enterprise Server that renders reports in PDF format. and patterns used to assemble a PDF report. 20 PowerPlay (R) . type a value between 0 and 9. Spanish. You can also set the minimum size in bytes that a page must be before it is compressed. You can adjust these settings using PowerPlay Enterprise . It works in the background whenever a user runs a report. However. the greater the compression. existing saved report output in PDF format is not affected. you must re-run your reports and re-save the output. Click the Accessibility category. but the longer it takes to compress a page or resource. and Swedish. then from the Actions menu. You can use the performance monitor for your operating system to determine the impact of compression. such as the Western European languages English. 3. 5. Font Support Within PDF Generation You can specify the default font used for PDF generation. and change the Value property to True. either from Upfront or the Table of Contents.Server Administration. Click the Accessible PDF property. 7. the fewer PDF pages are compressed. you may want to increase this value because compression slows down report generation. click Validate Selection. you can adjust the settings using Cognos Configuration Manager. If you have a high-speed network. In PowerPlay Enterprise . You can use the System Font Files Paths property to specify a search list of font directories. From the Edit menu. Swiss 721 is the default font for Latin-1 based languages. color palettes. French. and click the Settings tab. In the Page Compression Factor box. Steps 1. The Swiss 721 font and Andale font family are supplied with your Cognos product. click Apply Selection.

this is acceptable. 21) • if you want detailed reports on the data accessed. Notes • If you change the port number to anything other than 8010. To make server administration easier. you may have restrictions on outgoing ports. With Access Manager configured. PowerPlay Enterprise Server Firewall Web Browser Gateway Dispatcher Processors Enterprise Server Guide 21 . For example. type the minimum page size in kilobytes. Dispatcher and port information is defined in the cern. The following section describes some of the precautions you can take. For information about configuring Access Manager and user classes. In the case of a multi-machine deployment. a PowerPlay server listens to the gateway on port 8010 and sends back outgoing Web pages on an arbitrary port number. Use the Configuration Manager to confirm or change the Enterprise Server Port Number.Server Administration.csx file. Change the Enterprise Server Port Number The PowerPlay Enterprise Server dispatchers are set to communicate on port number 8010 by default for both Windows and Web connections. we recommend that you configure all PowerPlay servers to use the same port number.csx is located in the installation_location\bin directory for a dispatcher machine or the installation_location\cgi-bin directory for a gateway machine. 30) Cognos Business Intelligence products and data are secured with Access Manager. the file is located in installation_location/bin or the installation_location/cgi-bin directory. Security In order to secure your data. Under most circumstances.Chapter 2: Configure Servers 4. On a UNIX computer. Click OK. • • Restrict the Outgoing Web Port By default. you can disable the saving of sub-cubes (p. • if you need to put a PowerPlay server behind a firewall. or for security reasons. 5. In the Page Compression Threshold box. if your Web server is outside a firewall. For example. you can restrict outgoing communication to a specific Web port (p. you can enable auditing (p. You can then configure PowerPlay Enterprise Server to better secure your sensitive data. the file cern. You may want to change the port number if there is a conflict with another product. your network administrator should first take the necessary precautions to protect all servers from unauthorized intruders. refer to the server as srv2:8015 when you use PowerPlay Enterprise . there are cases when you must provide the new port number as part of the server name whenever you refer to the PowerPlay server. an access control application based on user classes. see the Access Manager online help. However. 23) • if you want to prevent downloading of cubes. On a Windows NT computer. this file may be copied to many machines. you can secure your data by allowing controlled access from any Windows or Web application.

you may want to restrict outbound communication to a specific port. all communication to and from the gateway is on the same port. replacing port_number with the port number you want to use: [PowerPlay Server . you configure the network security using Microsoft Management Console. do one of the following: • • If ppdscgi. you must set the CGI (common gateway interface) to communicate only on the dispatcher port.txt to ppdscgi. Steps 1. 3.PPDSRemote] Port=port_number You can use any port number between 1025 and 65535 (inclusive). you may need to connect through a firewall. Configure Security on a Microsoft Web Server You can use Microsoft Internet Information Server (IIS) to control Web access to cubes on PowerPlay Enterprise Server by requiring network security information from users when they log on. see the Configuration Manager User Guide.ini in a text editor. If ppdscgi. Save and close the file. Set the following: RESTRICT=1 3. and then configure the Windows client applications to listen on this port. For example. Steps 1. On the computers running the Windows client applications. It is located in the cgi-bin directory. rename ppdscgi.Chapter 2: Configure Servers To work within this restriction. open it in a text editor. see the documentation provided with the Microsoft Internet Information Server Web server. This way. This may degrade performance as all requests are sent through the same port.conf and then open it in a text editor. 2. On the gateway computer. Notes • Sending Web pages back on the dispatcher port requires passing the data from the query or report processor back through each dispatcher to the Web server.conf exists. Restricting the port number for Windows connections may affect performance if many client applications are accessing the server. Save and close the file. • Change the Port for Windows Connections If you are connecting to a PowerPlay server using a Windows client application (PowerPlay for Windows or PowerPlay for Excel). For more information. Add or edit the following lines. It is located in the bin directory. You can also use Configuration Manager to restrict the outgoing web port. 2. In Microsoft IIS. You can configure your firewall to allow TCP traffic through a specified port. For information about Microsoft Management Console. open the file cer n.conf doesn’t exist. 22 PowerPlay (R) .

Detail audit logs contain details on the requests received from PowerPlay Web clients and PowerPlay client applications. For example. It also allows you to assess your security program when you examine data access activities. network security requires that users provide user IDs and passwords. Detail auditing allows you to determine which areas of a cube are used more or less frequently. You can audit at the summary or detail level. For example.Chapter 2: Configure Servers This table describes how the security properties affect access to cubes on a PowerPlay server. In PowerPlay Enterprise .Server Administration. Enterprise Server Guide 23 . you register the following for a domain named europe and a user with the identifier smiths: europe\smiths Notes • Users with Internet Explorer Web browsers may not be prompted for network security information if they are already logged on to the network when they execute a request. For PowerPlay Enterprise Server. cubes and reports. The Basic Authentication (Passwords Sent in Clear Text) check box and the Windows NT Challenge/Response check box affect user privileges. and may help you to develop a strategy for creating more efficient cubes for PowerPlay Web users. Prompts for network security information when users access cubes using non Microsoft Web browsers. Check box Allow Anonymous Basic Authentication (Passwords Sent in Clear Text) Windows NT Challenge/Response Description Limits users to cubes in directories accessible by the Web server. Define Network Security Information You can define the network security information that users enter. the network security must include the domain. the user can’t open the PowerPlay Web page that is generated from the cube. Summary audit logs contain general messages about the processes from requests from all PowerPlay clients. Audit Server Activity PowerPlay Enterprise Server can audit server activity from both PowerPlay for Windows and PowerPlay Web client requests so that you can analyze or troubleshoot problems. Prompts for network security information when users access cubes using the Microsoft Internet Explorer. you can enable auditing for servers. Typically. if a cube is stored in a directory that a user doesn't have network privileges for. so that you can proactively enhance overall security when implementing a Cognos solution.

shutdown messages.Server Administration.Server Administration. The previous file is renamed ppes_auditxxx. the server records information about any error events that occur. Summary Nothing Server startup and logged.Server Administration. Viewing Audit Log Messages An audit log file is created when you select a Summary or Detail auditing level (p. Measures and dimensions accessed. Requests made to cubes and reports. In the Auditing Level box (Options). 2. In Windows. and then click the Settings tab. Steps 1. Enterprise . Nothing Server startup and logged. A cube or report.Server Administration. Each time you stop and start the PowerPlay Enterprise Server. shutdown messages. Cubes and Reports Servers None None Summary Detail Details on requests made to the server from PowerPlay Web and by PowerPlay Enterprise . Click OK. Detail Nothing Server startup and logged. 24 PowerPlay (R) . a new log file is created and a log file generation number is appended to the name of the old log file. where xxx is an incremental number representing the generation of the audit log. 23).Chapter 2: Configure Servers For auditing information to be logged. select one of the following: • • A server. A new log file is opened each time the server is started. In PowerPlay Enterprise . From the Edit menu. Associations between user requests and logged activities. to enable cube or report auditing. The following table lists what is logged for each combination of settings. When you enable auditing in PowerPlay Enterprise . 3.log. The most recent log files will have the highest number appended to their name. you can view these messages using the Event Viewer. select Summary or Detail. Details on requests made to the server from PowerPlay Web Measures and dimensions accessed and by PowerPlay from PowerPlay Web. Details on requests made to the server from PowerPlay Web and by PowerPlay Enterprise .log. 4. to enable server auditing. In addition to the audit log. click Properties.Server Administration. it must be enabled at both the server and cube or report levels. you can open the file ppes_audit. Requests made to cubes and reports from all PowerPlay clients. located in the ppserver directory. activity information is continuously recorded in the file ppes_audit. In UNIX. shutdown messages.log.

a session consists of a single user accessing a particular cube. MessageFormat Specifies the format of the message field. connection. For example. TimeStamp TimeZone DifferenceFrom GMT SessionId The date and time of the audit message. Enterprise Server Guide 25 . A request identifies all events that occurred between an action initiated by a user and the response to that action. The following table describes each field. The identification string for a session. PPDS indicates PowerPlay data server PPES indicates PowerPlay Enterprise Server PPRQ indicates PowerPlay report processor or query processor. Field Name Type Description Specifies the type of message.Chapter 2: Configure Servers The log file contains a number of tab-delimited fields. ComponentId The identification string for the component that issued the audit message. Drilling through to another cube and then returning to the original cube results in a different session. SRV indicates the server name PPUH indicates a PowerPlay usage header PPUD indicates a PowerPlay usage detail OID refers to an object ID. Specifies the time difference in hours between the listed time zone and Greenwich Mean Time (GMT). such as a filename. The time zone of the time stamp. In PowerPlay Web. U indicates a usage statistic. The time zone is the time zone of the server. W indicates a warning. Displaying the second page of data would be another request. E indicates an error. or label USR indicates the user ID UC indicates the user class(es) that the user belongs to. G indicates the log file generation number. V indicates the product version number. RequestId The identification string for a request. initiating a query and displaying the first page of data would be a request. I indicates an information entry.

Open the file ppes_audit. If the MessageFormat was PPUD. you must first enable Detail level auditing (p. if the usage header was "Product. You may want to remove them from time to time. delimited by semi-colons and (optionally) enclosed in quotes. the dimensions. A new log file is opened each time the server is started. For example. Components may contain subcomponents. Quantity" and the usage details were "7. and may help you to develop a strategy for creating more efficient cubes for PowerPlay Web users. 68) of the server. or other event information encoded in the MessageFormat field. Text to Columns command. the Message field would list. View Usage Statistics Usage statistics allow you to determine which areas of a cube are used more or less frequently. the Message field would log the usage statistics for the categories in an array of integers that map.log in a spreadsheet application such as Microsoft Excel. to the dimensions. The log files are not removed from your computer.log in a spreadsheet application such as Microsoft Excel. Then you can convert the Message column to multiple columns by using the Data. import it as a tab-delimited file and treat consecutive delimiters as one.log.log (located in the ppserver folder) in a text editor. Tips • To neatly arrange the columns of ppes_audit#. Customer. To view PowerPlay Enterprise Server usage statistics.Chapter 2: Configure Servers Field Name Message Description Any additional message text. Steps 1. and measures used. Usage statistics also allow you to assess your security program so that you can proactively enhance overall security when implementing a Cognos solution. Usage statistics are then recorded in the audit log (ppes_audit. if the MessageFormat was USR. it would mean that the Product dimension was referenced 7 times. 2". the Message field would log the user ID. the Customer level 1 time. where xxx is an incremental number representing the generation of the audit log. Steps • Open the file ppes_audit#. A message may contain multiple components. in order.log in a text editor. Text to Columns command. 26 PowerPlay (R) . For example. in order. 1. The previous file is renamed ppes_auditxxx. delimited by commas and (optionally) enclosed in quotes. and the Quantity measure 2 times. This field is also used for usage statistics. levels.log). It is located in the ppserver directory. levels. import it as a tab-delimited file and treat consecutive delimiters as one. If the MessageFormat field was PPUH. and measures used. Tip: To neatly arrange the columns of ppes_audit#. Then you can convert the Message column to multiple columns by using the Data.

Message Format Message PPUH Time. This count excludes the root category "All Time". such as By Brand and By Line. Header Time Detail Meaning 5 A total of 5 references were made by queries to categories in the Time dimension.0.Forecast 5.1.7.0.1. These values are counts of the number of references to categories within the Dimension or Level.Measures.C ustomer.5.0 Type U U PPUD The example above can be interpreted as follows. Product 7 Customer 0 Measures 2 Year 5 Quarter Month Brand 0 0 0 Enterprise Server Guide 27 .Product. or of queries involving the indicated measure. No references to months were made.State.5. but includes level 0 categories such as "By Fiscal Year". There were no references to the Customer dimension. Note the values in the Message category.1.1. or it could include multiple references to the same category.Country. There were a total of 2 queries against all measures. indicating that all queries were against "All Customers" (the root category).Product.Line.0. Search for a row that has the value U under the Type category and the value PPUH under the Message Format category. and measures used in the Message category.City.Brand.0. five of these references were to categories that exist in levels and two were not.Quarter. 3.2.1. These could be to five different categories.0. View the next row with the value U under the Type category and the value PPUD under the Message Format category. Tip: Multiple lists are delimited by semi-colons. levels. Month. Note the dimensions. Categories from the Year level were referenced 5 times.0. 4.Chapter 2: Configure Servers 2.Quota.Customer. This might have been references to the heads of alternate drill paths.Year. 5.Sales. Based on the level counts that follow. No references to categories from the Quarter level were made. Seven references to categories of the Product dimension were counted. Example of PPUH and PPUD Messages The following table shows the three columns of the audit log that contain information about usage statistics. No references to brands were made.

No references to countries were made. Number of Web requests that were completed in the last sampling period. Total number of Web requests that have failed since the service started. For more information. Number of Web requests that are currently queued awaiting processing. The Forecast measure was never queried. Average time to process a Web request. Customer 1 Sales Quota Forecast 4 1 0 Audit Log Processor You can download a utility from the Cognos Support Web Site to help you process PPES audit log files. This counter is hidden from the user. The Sales measure was queried 4 times.html Performance Monitor You can use the PowerPlay Server and PowerPlay Web Cube objects in Performance Monitor to troubleshoot problems and monitor performance. Used to calculate the average. The Quota measure was queried once.com/supported/support/pua/series7/using. The PowerPlay Server object contains counters that display information about the PowerPlay server service. There was one reference to a category at the Customer level. No references to cities were made.Chapter 2: Configure Servers Header Line Product Country State City Detail Meaning 0 7 0 0 0 No references to lines were made. The PowerPlay Web Cube object contains counters that display information about Web requests performed by PowerPlay Web for a specific cube.cognos. go to http://support. Both objects contain the same set of counters and they are listed below: Counter Current requests received Current queued requests Current requests completed Average request time Request count base Total failed requests Description Number of Web requests that were received in the last sampling period. No references to states were made. 28 PowerPlay (R) . There were seven references to categories at the Product level.

reboot your machine. type a password. 3. Configure the Ticket Server The ticket server is an application that issues tickets. run ppserver -i from the installation_location\bin directory. select a server.ini from the installation_location\bin directory. Using the Windows Run command. From the Tools menu. For information about configuring Access Manager and user classes. see the Access Manager online help. Total number of Web requests that have been completed since the service started. 2. You must install them manually. click Security then Set Security. In PowerPlay Enterprise . The method of security that PowerPlay Enterprise Server uses depends on the following: • If Access Manager is installed and configured on the dispatcher computer and on the client (the computer running PowerPlay Enterprise . 5.Server Administration or the ppadmtool command-line interface.Server Administration. Enterprise Server Guide 29 .Chapter 2: Configure Servers Counter Total requests received Total requests completed Description Total number of Web requests that have been received since the service started. The PowerPlay Server and PowerPlay Web Cube performance objects are now available. It maintains single signons for users of Web-based products so that they can access multiple applications without having to re-enter authentication data.Server Administration). Stop the Cognos PowerPlay Enterprise Server (cern) service from Services under Control Panel. Secure a Server You can restrict access to individual PowerPlay servers to prevent unauthorized administration from PowerPlay Enterprise . or on user classes and access control lists managed by Access Manager. run lodctr ppwebperf. These performance objects are not installed by default. Using the Windows Run command. the user class method is used. 4. • If Access Manager is not installed or configured on either the server or client. Do one of the following to secure the server with either a password or a user class: • • In the New Password box. Steps 1. Steps 1. 4. 3. See Access Manager Administrator Guide and Configuration Manager User Guide for more information. If the PowerPlay Server and PowerPlay Web Cube performance objects are unavailable in Performance Monitor. and then type it again in the Confirm New Password box. the server password method is used. Server security may be based on a simple server password managed by the PowerPlay server. Click OK. In the Set Security box. 2. select the user classes whose members are allowed to connect to the server. Start the Cognos PowerPlay Enterprise Server (cern) service from Services under Control Panel.

which resides in either a directory server or a portable . Users who don’t have PowerPlay Personal Server installed cannot save sub-cubes. In PowerPlay Enterprise .Server Administration.Server Administration. if a PowerPlay Enterprise Server is secured against default you can secure a cube against a different namespace. PowerPlay Enterprise Server and Upfront should both be configured to use the same namespace. By default. Also. Access Manager security must be set. You may want to use a namespace different than the one the server is secured against. You can then specify the second namespace in the cube properties in PowerPlay Enterprise . users can save cube data as a local sub-cube. Steps 1. use the Access Manager Configuration utility.Chapter 2: Configure Servers Notes • The namespace that is used for authentication is the namespace set on the computer running the dispatcher. In the Namespace box (Authentication). • • • Disable Saving of Cognos Sub-Cubes In PowerPlay for Windows and PowerPlay for Excel. for example Hyperion Essbase. select Disabled. 2. click Properties. 30 PowerPlay (R) . From the Edit menu. Steps 1. type the name of the namespace to use. To publish cubes and reports from PowerPlay Enterprise . they can re-synchronize the sub-cube back to the cube on the server. This may be desirable for mobile users who want to take cubes with them on a notebook computer. In the Save as PowerCube box (Options). you must first remove security (Tools menu). Click OK. Specify an Authentication Namespace For a Cube When a secured cube is created.Server Administration to Upfront. If security is not necessary. and then click the Settings tab. From the Edit menu. for example. is made secure at runtime by Access Manager using the authentication information stored in the specified namespace. However. 3. To configure a namespace. and then click the Settings tab. The cube data. In PowerPlay Enterprise . Notes • • • You cannot save Cognos sub-cubes from third-party OLAP servers. To use another namespace. 4. 4. select a cube. Click OK. you can select the Don’t Show This Dialog Again check box. Later. You can do this for each cube. the saving of sub-cubes is disabled. a reference to a namespace is stored as part of the cube. select a cube.Server Administration. If a server is not secured when you connect. 3. or portions thereof. 2. Notes • This setting affects users accessing cubes from the Web only. you may be prompted to secure it. For example. click Properties.lae file. you may want to prevent the saving of sub-cubes for security reasons.

Only if this maximum is reached are requests put into a queue. In the list. Report specifications. PowerPlay Enterprise Server starts a new process. a connection with a single query processor is established for the duration of the session. a query processor is chosen each time the user performs an action. containing a multidimensional representation of information. Steps 1. When a request arrives. In PowerPlay Web Explorer. Ask your system administrator to create a special user account for the PowerPlay service that has the password defined to never expire. is processed by the query processor component of PowerPlay Enterprise Server. 6. In the Windows Control Panel. • For a Web request. the PowerPlay dispatcher kills that specific process and initiates a new one. 3. security and reliability are important issues. 4. • For a Windows request. To maximize performance in this type of environment. the Cognos PowerPlay Enterprise Server service is installed as a system account logon.Chapter 3: Control Processes This chapter provides details about distributed server processes and what you can do to monitor and control the processes for optimum performance. click This Account. Enterprise Server Guide 31 . In the Confirm Password text box. For multiple PowerPlay machines to share data locations on a network. Set the PowerPlay Service for User Logon By default. In the Password text box. containing the report layout. Distributed Processing Cube data. In PowerPlay Web Viewer. the dispatcher forwards it to the first available processor associated with the requested cube or report. type the password for this account. you must first assign a user logon account to the service. and the duration of the connection lasts only until the resulting HTML is generated. there are several settings you can adjust in PowerPlay Enterprise Server . click the special user account defined by your system administrator. provided the maximum number of processes (p. Several processor instances may be started for a cube or report. interfering with the error recovery process.Administration. We recommend that diagnostic applications not be used on servers. PowerPlay Enterprise Server automatically balances the processing load by managing a set of processors for each cube and distributing requests for the cube data and report specifications among available processes. and the duration of the connection lasts only until the resulting PDF is generated. If all the processors associated with the cube data or report specification are busy. a report processor is chosen each time a report is run. and you can set the maximum number of processes for each cube or report. are processed by the report processor component. 5. Each instance of a processor is called a process. any of the available processors is chosen. Third-party diagnostic applications can cause problems for the dispatcher. click Services. type the password again. 2. In the Log On As panel. Click the Cognos PowerPlay Enterprise Server service and click Startup. 38) has not been reached. If a problem results in a failed request by a process. In a distributed installation.

5. a multiple server group consists of more than one server group running concurrently on one or more server computers. such as an Upfront NewsIndex and directory server. Server Groups A server group is a gateway and associated dispatchers. You can reference a server group by its name. including • drill-through targets • gateway to dispatcher communication Multiple Server Groups Multiple server groups are an advanced installation option that offers solutions for a variety of reporting environments. You can implement multiple server groups to manage and deliver different content for different user groups. 3. Before you install and configure multiple server groups you should be familiar with planning considerations for advanced installations. these changes can include defining a name for the group. 2. 4. For more information about using the Cognos Configuration Manager. click Properties. Server groups can provide failover protection.Server Administration. change the ppservertemp directory location in the Properties dialog box. For server groups. and the procedures related to server group configuration in a distributed environment. Under options in the Temporary Files location box. For Cognos products.Chapter 3: Control Processes 7. For more information see the Planning Advanced Installations Guide. or share it across a multiple machine installation. You can choose a server group or a specific server and port combination for drill-through servers in the Server Properties box. There are three general types of implementations for multiple server groups: • multiple server computers using a shared Upfront NewsIndex • multiple server groups on a single server computer using a shared Upfront NewsIndex • multiple server groups on a single server computer using separate Upfront NewsIndexes Ppservertemp You can set the ppservertemp location as a shared location across several servers. From the Edit menu. You can make changes to the central configuration using the Cognos Configuration Manager. the ppservertemp location is on the machine where PowerPlay Enterprise Server is installed. Click OK. rather than being rebuilt. click a server. type the shared location for the temporary files. and to reduce system maintenance requirements. Click Apply. You can name and use server groups for multiple purposes. and then click the Settings tab. In PowerPlay Enterprise . Subsequent requests received for one of these reports are serviced from the ppservertemp directory. Click OK. Multiple server groups may share some components. see the Cognos Configuration Manager User Guide. and changing the port number for a server. To locate the directory behind a firewall. The ppservertemp directory stores these reports for 30 days. Steps 1. 32 PowerPlay (R) . PowerPlay Enterprise Server caches the ppx files that are created when users save or publish PowerPlay reports. adding or removing servers in the failover list. By default.

click a folder.mdc or . In a multiple-server environment. In PowerPlay Enterprise . Each server must share the same location for the imported_reports folder. You specify a Mount At location at either the imported_reports folder level. In the Mount At box. or at a cube folder level within imported_reports. Click Apply. 3. PowerPlay Enterprise Server creates a folder that has the cube name in the imported_reports folder. From the Edit menu. and folder references) forward incoming requests to be processed remotely.Server Administration. Go to the location you want to share for imported_reports. Steps 1. A cube or report can have both a source (an . 5. 4. Click OK. report references. Mirror references (cube references. Mount At lets you map the imported_reports to a shared disk drive to provide this seamless access.Chapter 3: Control Processes Mount At When reports are published from PowerPlay for Windows or PowerPlay Web Explorer. click the Ellipses button to open the Select Location dialog box. Load Balancing using Mirror References You can play a significant role in distributing the processing load of your PowerPlay system by adding mirror references. 6. Enterprise Server Guide 33 . 2. users can publish and access reports from many machines.ppx file accessible on the network) and a mirror reference (a pointer to another cube or report that you had added on another connected PowerPlay server). click Properties. rather than on the computer where you add the cube or report.

the dispatcher starts queuing requests until processes become available. Cube or report Set up with a source only Where requests are processed On the PowerPlay server that contains the cube or report Set up with a source and a On either the PowerPlay server that mirror reference contains the cube or report. particularly with cubes and reports that are hit frequently. 34 PowerPlay (R) . you can set the Maximum Processes value for that dispatcher to 0. You can even set the Maximum Processes value for individual cubes. which is free to immediately process more requests. By default. When the number of hits on the cube or report exceeds the Maximum Processes threshold. Maximum Processes When a cube or report starts receiving more requests than available processes can handle. all of the processing will take place at an available mirror location and no processing will take place on the dispatcher. By setting minimum and maximum processes. PowerPlay Enterprise Server opens additional processes. Then. each cube is configured with a source and must have sharing enabled. that is.Chapter 3: Control Processes A cube or report can also have either a source or a mirror reference. they are forwarded to the mirror reference. instead of queuing up requests. or the PowerPlay server that the mirror reference points to Set up with a mirror reference only On the PowerPlay server that the mirror reference points to You control the processing resources allocated to a cube or report by adjusting the Process Control settings. Example 1: Dedicated Processors In the configuration depicted below. On the computers that process the cubes. to only pass requests. Minimum Processes Minimum processes are the number of processes that remain running after they open. you can control the number of processes that occur on each dispatcher. a queued request is deleted after 15 seconds. particularly Minimum Processes and Maximum Processes. each of four cubes has a dedicated computer on which to process requests. These cubes are configured with no source and a single mirror reference. If you have a dispatcher that you want to act only as a router. The number of processes does not have to reach its maximum value before additional processes can be sent to a different dispatcher. up to the number you have defined as the maximum for the cube or report. Keeping processes open improves performance. If the maximum is reached.

The mirrored cube is in turn configured with another mirror reference. This configuration is also useful in a 7 x 24 system that offers redundancy to minimize any single point of failure. which always starts with the local computer. There are many custom configurations for mirror references that you can take advantage of to control processing. For more information. 93). Enterprise Server Guide 35 . a report has three computers that can handle overflow.mdc file may reside on another computer. Example 3: Daisychaining In the configuration depicted below. you can prevent queues on any of the computers. However. see "Temporary Files and Mirroring Under Windows 2000" (p. The cube is configured with a source and a mirror reference. Mirroring in a Windows 2000 Environment To support mirroring in a Windows 2000 environment. a cube can be processed on any of the three computers. This effectively triples the number of available processes for the report without requiring you to increase the Maximum Processes limit to a level that the first computer may not be able to handle. you will need to change the permissions on the temporary directory that PowerPlay Enterprise Server uses to assemble the contents for a PowerPlay Web report. remember that the processing of the cube or report takes place on a computer with a query or report processor. The report is configured with a source on the same computer and three mirror references. requests are returned faster when the cube or report resides on the same computer that processes them. regardless of where the actual source resides.Chapter 3: Control Processes Example 2: A 7 x 24 System In the configuration depicted below. relieving the first computer from having to queue reports. To manage your processing requirements effectively. By setting the Maximum Processes property for each cube to suit your processing needs. If the report processor is very busy. any of the supporting computers can pick up the request. This configuration also establishes an order of preference for processing the cube. Consider experimenting with typical cubes and reports and monitoring the processes before moving to a full production environment.ppx or . depending on how busy each processor is. The .

report. connections from a PowerPlay Windows application can start another instance of the query processor depending on the value of the Scheduling Threshold (p. Do not use Windows Task Manger to end PowerPlay processes. use the Windows Task Manager to monitor processes. Any required network access rights and other forms of security access. and processes reports with the report processor. 74) setting.exe. 23) which can help you track processor usage over time. see the Microsoft Windows documentation. have been assigned. The query processor is named Ppdsweb.Server Administration Use PowerPlay Enterprise . PowerPlay client applications can only explore a cube or run a report when all of the following conditions are met: • The cube or report has been added to a PowerPlay server. and its parent objects are enabled ( icon). 36 PowerPlay (R) . Disable the associated cube using PowerPlay Enterprise .exe. and the report process is named pprp. use the monitoring tool for your version of UNIX or use one of the following commands to monitor processes: • ps -ef | grep process (on IBM AIX and HP-UX) • ps -ax | grep process (on Sun Solaris) The query process is named ppdsweb. The PowerPlay server from which the cube is available is started and enabled. PowerPlay Enterprise .Server Administration to check the properties and monitor the status of each cube and report. PowerPlay Enterprise Server records server activity (p. such as Access Manager user classes. For example 2/5 means that there are currently two processes open out of five available processes. Web ( icon) or Windows ( icon) access privileges have been correctly assigned. A new instance of a processor is started when all of the following conditions exist: • all available processors are busy handling requests • an additional request is received • the maximum number of processes set has not been reached In addition. as specified in the Cube or Report Properties dialog box. Use the Monitor tab to monitor the number of open processes for a cube or report (or all the cubes and reports in a folder). to let users know that the data is available. UNIX In UNIX. • • • • • The cube. You can also send users a direct URL to cubes and reports. and the report processor is named Pprp. or is a mirror reference on a PowerPlay server.Server Administration or the ppadmtool command-line interface. Your preferred Web publishing method has been enabled and configured. Other events you can monitor depend on whether the connection is for Web or Windows (or both). You can also use the Performance Monitor to obtain more status and performance information. For information about the Performance Monitor.Chapter 3: Control Processes Monitor Processes PowerPlay Enterprise Server processes cubes with the query processor. Windows In Windows. and the maximum number of processes available.

You may want to determine the average time it takes to handle each request.log file. the server engine generates pages in HTML format. resulting in minimal network transactions. During a session with PowerPlay Web Explorer. the server engine generates cube results for the PowerPlay for Windows or PowerPlay for Excel clients. If you want to determine the average processing time for your site. The requests sent to your servers probably differ substantially in complexity. When the maximum number of open processes reaches its limit.Server Administration. generated pages are treated as individual requests. the report format. and the limit on the number of rows and columns returned are just some of the factors that affect processing time. Only the most recently generated information appears in the browser. 23) and compute the average from the records in the ppes_audit. Column Delay (s) Connections Description The number of seconds that requests for the cube must wait for processing The number of Windows connections For a Windows request. drills down on a category. The s/Hit column gives you an average reading for the last minute. you can monitor the following from PowerPlay Enterprise . Enterprise Server Guide 37 . you can monitor the following from PowerPlay Enterprise . sockets communication is established and maintained with a single query process. The processing of each request is randomly routed to an available query processor. It generates a new page whenever data is requested by the user from the Web browser.Chapter 3: Control Processes Monitor Web Connections For a connection from the Web to a query or report processor.Server Administration. requests will start to queue up. when a user opens a cube. Monitor Windows Connections For a connection from a Windows client application to a query processor. for example. During a session with a Windows client. The cube dimension structure. Column Queue s/Hit Hits/min Description The number of requests in the queue that are waiting to be processed The average time to process requests received in the last minute The number of PowerPlay Web requests (hits) received in the last minute For a Web connection. or changes the measure.This is an indication that requests are taking longer to complete and you may have to consider adding available processes. you can enable auditing (p. possibly with mirror references. ranking.

because each process uses memory for its cache. reports. type the number of processes. In PowerPlay Enterprise . Also. adding processes provides better throughput. select a cube or report. If it is running at or near 100% capacity. When the maximum is reached. click Properties. and then click the Settings tab. You may want to add more processes for a cube that is experiencing less than optimal throughput by increasing the Maximum Processes setting. and forwards requests to a mirror reference if the number in the queue exceeds this threshold. • adding another cube (pointing to the same . For example. Therefore. From the Edit menu. click Properties. you determine that more processing power is required. or you may need to upgrade your computing resources. cubes. In PowerPlay Enterprise . if the delay becomes too long. 38 PowerPlay (R) . 5. Adjusting this timeout may be useful for cases of "runaway" queries that would otherwise consume up to 15 minutes (the default) of processor time. 2.Server Administration.Server Administration. 2. 4. you should only add more processes under either of the following conditions: • the server has available resources • the server has no available resources. you can use mirror references to process remotely. type the number of requests to queue (beyond the maximum) in the Local Process Threshold box. Tips • If. however. 3. the size of the server.Server Administration. Click OK. Limit the Processing Time You can set an absolute time limit that the query or report processor spends on any request. 3. The maximum number of processes to define for a cube or report is a function of your peak time requirements. it starts more processes for new requests. In the Maximum Processes box (Process Control). but the average request time is sufficiently fast that an increase in processing time would still meet your users’ expectations Steps 1. type the number of seconds.Chapter 3: Control Processes As soon as a Windows connection is established with the client application. Steps 1. That means that all requests from the same IP address are handled by a single process that you can monitor in PowerPlay Enterprise .mdc file) so that Web and Windows requests are each allocated a dedicated process. • adding mirror references Define the Maximum Number of Processes When a cube or report is busy processing requests. If you have defined mirror references and want to give processing preferences to the local source in order to queue requests rather than forward them to the mirror reference. after adjusting the number of processes. you conserve memory if the maximum number of processes you define doesn't exceed the number of processes required to meet your peak requirements. adding processes just makes all the requests take longer. requests are never queued. select a cube or report. and other applications running on the server. thereby sharing the load. you can respond by • increasing the number of processes for the cube. the server does one of the following: • queues new requests until a processor becomes available • queues new requests up to the limit specified by the Local Process Threshold setting. From the Edit menu. and the number of users. If Local Process Threshold is set to 0. If a server has available resources. PowerPlay Enterprise Server assigns a query processor. up to the number defined as the maximum. In the Request Timeout box (Process Control). and then click the Settings tab.

regardless of the load on that processor. 2. select a cube. click Properties. Steps 1. In PowerPlay Enterprise . For any cube. similar to the way Web requests are handled. Click OK. In PowerPlay Enterprise . You can monitor the processes in the Monitor tab of PowerPlay Enterprise . the server stops processing requests. there may be a delay before that request gets processed by a query processor (if it is busy).Server Administration. You can also use this feature to stop any runaway processes. 3. the following dialog box appears. 2.Server Administration. and then click the Settings tab. when you have to replace a cube or report. you can choose how to distribute requests based on how busy each processor is. This is useful. but requests that are being processed continue until they are finished. If you select Stop Immediately. Configure How Windows Processes are Scheduled As a new request is received from a PowerPlay Windows application. Click OK. Setting it too low may result in a high number of query or report failures. select an item. In the Scheduling Threshold(s) box (Process Control). Steps 1. or perform maintenance on several items at once. click Stop. a value of 5 means each request is submitted to the first processor that has less than a 50% ratio of delay time to processing time. for example. When you stop the processing. 4. From the Edit menu. 4. or individual cubes or reports to temporarily prevent the processor from accepting requests. Select one of the stop options. • A value of 0 means no delay. From the Actions menu. For example. • A value of 10 means each request is submitted to the next processor in sequence. The setting represents a ratio of delay time to active processing time.Chapter 3: Control Processes 4. the server stops accepting new requests. type a number from 0 to 10. so each request is submitted to the first available processor. Tips • This setting applies to all requests submitted by all users. If you select Stop After all Requests Are Complete. Click OK.Server Administration. Stop Processing Requests You can disable a PowerPlay server. folder. Enterprise Server Guide 39 . by setting a threshold to control the load balancing for these requests. including any in the queue. • A value from 1 to 9 means each request is submitted to the next processor whose ratio of delay time to processing time is lower than the number specified. 3.

for example. Setting the optimal cache size can significantly improve performance. 12 processes require 192 MB (16 MB x 12) of available memory. the cache size should be 20% of your average cube size. In addition. However. the following Bourne shell command allocates 32 MB: PPDS_READ_MEMORY=32768 export PPDS_READ_MEMORY 40 PowerPlay (R) . you can stop processes by typing KILL and then the object name. This is why the Maximum Processes setting (p. Save and close the file.ini in a text editor. For example. Open the file cern. there is a threshold at which the overhead of managing very large cache sizes outweighs any benefits gained from increasing the cache size. the following line allocates 16 MB to each process: ReadCacheSize=16384 4. Locate or add the section [PowerPlay DataServer]. For example. Using the cache. You can increase the cache size to increase the probability that results are found in caches. It is located in the Bin directory. 3. 15). the results used least recently are discarded.Chapter 3: Control Processes Notes • • Selecting a server and stopping it is not the same as shutting it down (p. you can stop processes against the Great Outdoors cube by typing KILL "Great Outdoors" Set the Process Cache Size Whether a server request is for a cube (query processor) or report (report processor). a large cache size can significantly impact memory resources of the server. Tip: You can also use Configuration Manager to set the process cache size. Each instance of a query processor is allocated a memory cache that stores results previously retrieved from its associated cube. the memory cache is 8 MB on Windows and 16 MB on UNIX. As a rule. with a cache size of 16 MB. the process may generate results more quickly. but rather like stopping the processes of an implied folder at the root level. Step for UNIX • Set the environment variable PPDS_READ_MEMORY to the size you want used for each cache. because reusing results in a cache is faster than querying a cube again. because all caches on a PowerPlay server are the same size. 2. When a cache is full. the associated cube data must eventually be handled by a query processor. Edit or add the following line substituting KB with the cache size you want to allocate to each process. and at most 32 MB. Some reasons for considering increasing the process cache size include • the average query (s/Hit) time is too long • your typical cube size is large (greater than 10 MB) • monitoring your server shows that there is plenty of memory to spare • 80% of hits are on 20% of your cubes Steps for Windows 1. which means better response time for PowerPlay users. If you are using the ppadmtool in Windows or on UNIX. ReadCacheSize=KB For example. By default. 38) for cubes is so vital for optimal server performance.

Click OK. select a cube. for items not included in the initial lists. The Enhanced User Interface can be viewed using higher level browsers and does not rely on cascading drop-down menus or menu-level filtering. Steps to Use the Generic HTML User Interface 1. or server. or restart the PowerPlay server altogether (p. or for the entire server. because it may take the system more processing resources to manage the cache than it would to retrieve the data from disk again. and then click the Cube Settings tab. Enterprise Server Guide 41 . DHTML can slow the performance of PowerPlay Web. 4. Expand Display (Web). you must restart each cube that is running. and then click the Cube Settings tab. which supports drag and drop and right-mouse clicking. select Generic. • Choose to have large cubes appear in the Generic HTML User Interface (p. However. In PowerPlay Enterprise . Expand Display (Web). 3. drop-down lists may become more complex and users may experience slower response times. flat dimensions. From the Edit menu. 4. • Limit the number of entries in drop-down lists. • Consider using the Enhanced User Interface (p. which provides cascading drop-down menus and multi-level filtering. The option name depends on the version of the user’s Web browser. For a new cache size setting to take effect. limiting the entries in the lists can improve user response time. and then click the Cube Settings tab. This option can be useful for cubes with wide. folder. click Properties. 4.Server Administration. In PowerPlay Enterprise .Chapter 3: Control Processes Notes • You shouldn’t set the cache size to more than 64 MB. 96). From the Edit menu.Server Administration. Click OK. folder. You can either stop and then enable the cubes (p. such as dial up lines. 2. click Properties. To improve this performance. Steps to Use the Enhanced User Interface 1. In the Type box. In the Type box. click Properties. If you find that drop-down lists. 5. 39). select Enhanced. Generic HTML is also the default for Web browsers that do not support DHTML. Expand Display (Web). or server. 3. especially for low network bandwidth environments. 3. This can improve user response times. folder. are slow to populate. you have the following options that you can apply for cubes. 2. such as from the dimension line and from categories. In the Item Limit box. Steps to Limit Drop-Down List Size 1. type a number for the number of entries to display in a PowerPlay Web menu. 5. • Performance Issues for Large Cubes The PowerPlay Web user interface uses dynamic HTML (DHTML). select a cube. 96). 5. However. Any level that exceeds the number of categories specified in the Item Limit box is truncated and a More Below or Page Down option appears at the end of the list. 2.Server Administration. select a cube. In PowerPlay Enterprise . for very large cubes. Click OK. 15). From the Edit menu. for folders containing cubes. and expand Menu Size. or server.

Chapter 3: Control Processes 42 PowerPlay (R) .

Server Administration is a Java application that administrators use to configure PowerPlay servers and the cubes. The right pane shows a grid view of the objects in the selected server or folder. Category Items Status Access Explore view Monitor view All objects of the selected Only active objects of the server or folder selected server or folder ✔ ✔ ✔ ✔ Enterprise Server Guide 43 . You can expand and collapse objects in the hierarchy.Server Administration user interface and describes the various tasks you perform to deploy your data. select Programs. from the Start menu. you can use context sensitive menus.Server Administration PowerPlay Enterprise . The left pane shows a hierarchical tree view of the connected servers and folders.sh located in the bin directory. the right pane shows the following. To launch Cognos Server Administration. This chapter introduces the PowerPlay Enterprise . PowerPlay Enterprise . you are prompted to connect to an initial server (p. and then click Cognos Server Administration OLAP Cubes and Reports. Depending on the view chosen. and folders registered on the servers.Server Administrator is run through Cognos Server Administration. click the column headings. Any computer that you administer must be running a dispatcher. When you select an item in the either pane. To start PowerPlay Enterprise . select Cognos Series 7 Version 2.Chapter 4: Deploy Cubes and Reports Use PowerPlay Enterprise . • In UNIX. The application window is divided into two panes. Tips • • To sort the objects in the right pane.Server Administration: • In Windows. Use the tabs to choose between Explore view and Monitor view in the right pane.Server Administration to make your multidimensional data available to analysts and report consumers. or the name of another networked computer for remote administration. In Explorer mode. 45). After you start the program. the PowerPlay Enterprise . reports. click the right mouse button and a menu of available commands appears. run the script ppsrvadm. You can enter the name of your computer for local administration.

that is. The item is disabled. 44 PowerPlay (R) . A collection. An object is invalid if PowerPlay Enterprise Server cannot read its configuration file. A cube. Category Item Icon Description A PowerPlay server. a folder with a physical directory as a data source. Windows (sockets) access privileges. A folder. An invalid object. and access privileges set.Chapter 4: Deploy Cubes and Reports Category Processes Explore view The maximum and minimum number of processes set NA The description and the date/time the properties were last modified Monitor view The number of processes running as a ratio of the maximum number set Statistics for Web and Windows connections NA Statistics Properties PowerPlay Enterprise .Server Administration uses a series of icons to represent items on the server. current processes for cubes and reports may continue to run until completed. Access Web (HTTP) access privileges. Processes for cubes and reports are active. A report. A report with mirror references. User can access the data from PowerPlay for Windows and PowerPlay for Excel. Users can access the data using a Web browser. The contents of a collection are dynamically updated with the contents of the directory. their status. A collection with mirror references. Depending on the option selected. Status The item is enabled. A cube with mirror references. A folder with mirror references.

The server name appears in the left pane. Discover Servers When you run PowerPlay Enterprise . You can then connect to one of these servers to administer cubes and reports. Steps 1. Folders and Collections Folders and collections (folders that are dynamically updated with the contents of a directory) are containers for other objects. Click a server and click Connect. From the Server menu. if you want to change the settings for all the cubes within a folder. If you are connecting to a Windows NT server from PowerPlay Enterprise . If the server is not using the default port.Chapter 4: Deploy Cubes and Reports Connect to a Server When you start PowerPlay Enterprise . Enter the name or IP address of the computer where a dispatcher is running and click OK. For example.Server Administration on Unix. the IP address for the Windows server must be static and listed in the hosts file on Unix to use the server name. 2. and reports appear in the right pane. you are prompted to connect to an initial PowerPlay server. You can later connect to other PowerPlay servers on your network to administer more cubes and reports. 29). use the Cube Settings tab of the Folder Properties dialog box. click Discover Servers. Use folders and collections to organize and administer groups of cubes and reports. From the Server menu. 2. you can view a list of other PowerPlay Enterprise servers that are running on your network. Folders and collections allow you to change the settings of all the descendant objects from a single dialog box. Enterprise Server Guide 45 . and its associated folders. connect to the server using the IP address. you may be prompted to secure it (p. Otherwise. Steps 1.Server Administration. you must enter server:default port If the server you want to connect to is not secured.Server Administration. cubes. click Connect to Server.

click Folder. From the Insert menu. a collection is still a folder that contains child objects that acquire the folder settings by default. A bold setting means that it no longer acquires settings from its parent. you can add cubes and reports by copying the source . select a PowerPlay server or a folder. thereby overriding the parent setting. Aside from that. Settings that you override appear in bold for easy identification. Use folders to organize and administer related objects in a hierarchy. Steps 1. 4. At the folder level. the folder becomes a collection (p. Note • • If you specify a folder data source. With a collection. you can also force descendant objects to acquire new settings by clicking the Reset Descendants button. Specify other settings if required and click OK. 3. 2. In PowerPlay Enterprise . Add a Folder A folder is a container that can hold any combination of cubes. use CTRL and drag. unless you reset those settings by clicking the Reset or Reset All buttons. reports.Server Administration. This offers a quick way to update an undetermined collection of items on a production system.Chapter 4: Deploy Cubes and Reports New objects that you add acquire all the settings of the parent. This property enables the contents of a collection to be dynamically updated with the contents of the directory.ppx files to the directory referenced by the collection. You can modify individual settings for any of the objects in a folder. Use Drag and Drop to move folders and collections to another location on the same server. Add a Collection A collection is a folder with a physical directory as a data source. To copy folders or collections. 46) and takes on special characteristics. 46 PowerPlay (R) . In the Name box. or other folders.mdc and . type a name for the folder.

Steps 1. PowerPlay Enterprise Server must have access to the data sources that reside on the remote computer. 6. click the ellipsis button. In PowerPlay Enterprise . click Cube or Report. Notes • • Cubes and reports are automatically enabled when you add them.mdc or . the cubes and reports are iconic representations of the data sources or mirror references of the data sources. by default. The server that a cube or report is available from is the dispatcher on which the cube or report is registered. From an administrative perspective. If you want to browse using a UNC path. From the Insert menu. Note: If you specify a . In the Cube Source or Report Source box. you can use the standard file notation for your operating system. you don’t copy the actual cube data source (an . click Folder. Cubes and Reports A substantial proportion of the tasks that you perform as a PowerPlay server administrator probably entail distributing cubes and reports to your users. type a name for the cube or report. the associated cube must also exist (p. you identify the server to be published to and specify a cube or report source. In the Name box. for example. Specify other settings if required and click OK. and then click OK to refresh the Contents list. For example. • • Add a Mirror Reference A mirror reference is a mapped cube or report that forwards incoming requests to be processed remotely instead of on the computer where the object is added.ppx file and click OK. Use mirror references to distribute the processing load among processors and servers.Server Administration. select a directory. The directory should contain data source files (. Add a Cube or Report To add a cube or report.Chapter 4: Deploy Cubes and Reports Steps 1. see the Windows documentation about using the Services application of the Control Panel to configure Startup properties.mdc on UNIX. 2. when you add a cube. In UNIX. In the Folder Source box. Also. or other directories that contain data source files. Specify other settings if required and click OK. any reference to cubes or reports in the following sections also applies to the folders of cubes and reports. 5. and not representative of a directory. services can log on only to system directories. 4. you must type the computer name and share directory in the Look In box. To allow PowerPlay Enterprise Server to access remote data sources.mdc file) to a directory. or /cubes/imports. 3. Therefore.mdc. for example //srv01/cubes/imports. In Windows. In PowerPlay Enterprise . When you specify the data source. 13) on a PowerPlay server. 5. or other folders. Enterprise Server Guide 47 . 2. For information about configuring these privileges. 4. In the Name box.ppx). Select an . You can also use a UNC path. From the Insert menu. such as C:\Cubes\Imports. 3. reports.Server Administration. folders are virtual groupings of cubes. You must grant this using standard UNIX permissions. select a PowerPlay server or a server. you must give PowerPlay Enterprise Server account logon privileges for the remote systems. type a name for the folder.ppx file.mdc or . select a PowerPlay server. to use a UNC path.mdc on Windows.

Steps to Copy 1. when you rename a cube or report. In PowerPlay Enterprise . click the ellipsis button. select the mirror reference.Server Administration. In PowerPlay Enterprise . The move procedure leaves behind a shortcut pointing to the actual moved object.Server Administration. click the Add button.Server Administration by the curved arrow symbol in the icon. Steps 1. In the same way. Click OK in all the dialog boxes. mirroring may require special security permissions to work. See the Settings tab (Options). Steps to Rename 1. 4. 2. For further details on adding security permissions. a mirror reference alone. click Rename. From the Edit menu. click a cube or report. you can specify a data source alone. select a cube or report. From the Edit menu. If you encounter problems. add the internet guest account (named IUSR_MACHINE_NAME) to the permissions on the installation_location/webcontent/ppwb directory. Open the folder to which you want to move the cube or report. The shortcut for a renamed cube or report points to the original object in the same folder. 5.Server Administration.Chapter 4: Deploy Cubes and Reports When you add a cube or report to PowerPlay Enterprise Server. This prevents bookmarked URLs from becoming broken links. 4. or by dragging it. You can recognize a shortcut in PowerPlay Enterprise . click a cube or report. You can also specify several mirror references for a cube or report (p. Steps to Move 1. click Cut. 2. 6. 2.Server Administration. The properties of the shortcut contain the target path of the actual object. 2. click Properties. click a cube or report. In the Select Mirror References dialog box. 3. In the Cube Mirror References or Report Mirror References box. From the Edit menu. Notes • • The cube or report that you want to mirror to must have sharing enabled. 48 PowerPlay (R) . In Windows2000. 33). 3. click Paste. Hold down the CTRL button and drag the cube or report to the folder where you want a copy. In PowerPlay Enterprise . Use the Find Target button to go to the folder or the cube defined in the target. a shortcut is created. or both. In PowerPlay Enterprise . Move or Copy a Cube or Report You can move a cube or report from one folder to another on the same server by cutting and pasting the icon. From the Edit menu. see your Windows2000 Operating System manual. In the Add Mirror Reference dialog box.

Chapter 4: Deploy Cubes and Reports 3. 5. 4. Enterprise Server Guide 49 . 3.Server Administration window when you no longer want it to be available to users. 6. Steps 1. In the corresponding Custom box (Display. Toolbar). select a cube or report. From the Edit menu. For example. type the new name and click OK. click the Dimension Line in CSV Export box. From the Edit menu. This is important when you need to understand information on which the cube was filtered after data was exported from the cube. In one of the custom functions. click Properties. then click OK.Server Administration. 7. and select a server. select a cube. 3. Add Dimension Line Information to an Exported CSV File For each cube within PowerPlay Enterprise Server. Click Apply. 2. and then click the Cube Settings tab. In PowerPlay Enterprise . The data source isn't deleted. 2. In the Rename dialog box. Click Yes to confirm the removal. create a JavaScript for the custom command. Remove a Cube or Report You can remove a cube or report from the PowerPlay Enterprise . you can specify if the dimension line information is included on a user-based CSV export from the Web. Add Custom Buttons You can add up to eight custom buttons to the PowerPlay Web Explorer toolbar to enable users to accomplish common tasks. Steps 1. The next time a cube is exported in CSV format.Server Administration. click Properties. Open PowerPlay Enterprise .js in a text editor. Notes • PowerPlay Web inserts custom buttons to the right of the Help button. From the Edit menu. In PowerPlay Enterprise . 2. In the Options folder. click Delete. you can add buttons to let users link to a departmental table of contents or email the cube URL to a colleague. Click OK. It is located in the webcontent/ppwb directory. You can attach any JavaScript code to a custom button. You cannot delete or rename this report. and then click the Settings tab. Open the file ppwbcustom.Server Administration. the dimension line information that appears on the Web also appears in the CSV file. Steps 1. Notes • The Print Settings report must exist for Export PDF. Save and close the file. select Enabled to enable the button. and select Enabled. 4. 3.

06 or later) • The Enhanced User Interface (Internet Explorer 5. This ensures. Steps 1.5 or later) Steps 1. Add a Title You can add a title to the top of a PowerPlay Web Explorer page to give users more information about the cube they are exploring. <B>. and click OK again. see "Start and Stop Windows Services" (p. 2. Save and close the file. It is located in the ppserver directory. you can edit a setting in the configuration file for the server. Restrict Embedded HTML Tags in Report Titles You can restrict embedded HTML content in the titles of reports that may be published to the Web. style and class attributes permitted) The following items are then exported as text only: • any unrecognized tags (or tags with invalid attributes) • any tag containing a style attribute with unexpected values • all text (both inside and outside of tags) • all attribute values • all results from VAR tags 50 PowerPlay (R) . Netscape Navigator 4. 16) or "Start and Stop UNIX Daemons" (p. Restart the Cognos PowerPlay Enterprise Server service. This setting will affect the display only in Web browsers that support • The Dynamic User Interface (Internet Explorer 5. 3.0" to read HoldDimensionBar="IN. <BR> (with no attributes) • <P> (with align. <U>. and then click the Settings tab. class and title attributes permitted) • <SPAN>. 6. For more information. dir. If you want the dimension line to remain static.Chapter 4: Deploy Cubes and Reports Make the Dimension Line Static When users view large cubes in their Web browsers. they can lose sight of the dimension line.0 or earlier. click Properties. If you want to add variables to the title. for example.1" 4.Y. click the ellipsis button after clicking to activate the property. select any from the Variable box.Y. that unwanted scripts are not run when a consumer views a published report on the Web in interactive HTML exploration. and click the Insert button. 2. In the Title box (Options). type a descriptive title. they may have to scroll down to see all of the data in the cube. <DIV> (with dir.cfx in a text editor. In PowerPlay Enterprise . PowerPlay Enterprise Server interprets the symbols as variable markers and ignores the text. 3. you ensure that only the following HTML tags are valid: • <I>. 4. 5. If you want to use the symbols less than (<) or greater than (>) in a title. From the Edit menu. By restricting embedded HTML tags in titles. Stop the Cognos PowerPlay Enterprise Server service. 5. Click OK. 16). select a cube. Locate and edit HoldDimensionBar="IN. style. Open the file PPSRoot. Otherwise. In the Title box. ensure that there is a space before and after each symbol. When they scroll.Server Administration.

by default. You use the Display settings for cubes and reports to customize the output to the Web. In the Search Where box. These industry standard formats allow for a level of customization to be applied as the reports are generated. click on the column headings. Test a Connection You can connect to a cube or report to ensure that it is accessible from the Web and properly configured. In the Search For box.Chapter 4: Deploy Cubes and Reports The default setting for this is on (Enabled). Any items matching the criteria appear in the lower display area of the dialog box. 3. type a string to search for. enter the required information and click Log On. Tips • • To go to any of the items found. click Open with Browser. Steps 1.Server Administration. select a cube or report. select a server or folder from which to begin a search. 4. In PowerPlay Enterprise . We recommend that you keep this setting enabled to improve security of your PowerPlay web application. In the Options folder. Steps 1. In PowerPlay Enterprise . then click OK. you must provide authentication information. In addition to Upfront. click Properties.Server Administration or the ppadmtool command-line interface. Steps 1. From the Tools menu. Enterprise Server Guide 51 . 3. Web Reports PowerPlay Enterprise Server provides several ways to make your data available to authorized users on the Web. Click Search Now.Server Administration. cubes and reports that you add are. The most powerful of these features is the ability to allow report authors to publish their findings from a PowerPlay client application directly to Upfront. or folders that you administer. select a cube. 2. Click Apply. click the HTML Encode User Specified Title box. 4. 2. PowerPlay Enterprise server starts the Web browser and connects to the cube or report. you can bulk publish or update reports and cubes using PowerPlay Enterprise . As an administrator. 23). From the Tools menu. 2. included in a PowerPlay Web table of contents.Server Administration. Web reports are rendered in HTML or PDF format. If authentication properties are defined for this cube. From the Edit menu.Server Administration includes a search utility to help you locate cubes. select from the list of servers and folders you are connected to. For protected cubes. before the Web page appears in the browser. If you can't connect. reports. such as a user ID or password. To sort the items found. 3. 5. double-click the item. and select Enabled. you may be able to determine the cause of the error from logged auditing information (p. Search for a Cube or Report PowerPlay Enterprise . click Search. and then click the Settings tab. In PowerPlay Enterprise .

Server Administration in the sales cubes folder: A user opens the outdoors cube. the Imported Reports folder is created on the computer and is displayed in PowerPlay Enterprise . and saves a report to Upfront. reports appear under a folder named for the cube. In order to publish cubes and reports from PowerPlay Enterprise . The first time a user saves a report. The PowerPlay Portable Report (. the outdoors cube was added to PowerPlay Enterprise .Server Administration to Upfront. Users can connect to Upfront from their Web browsers using the following URL: http://server name/cognos/ Maintaining Properties When Saving Reports to Upfront Reports that are saved to Upfront are stored in an imported_reports folder on the PowerPlay Enterprise Server dispatcher computer. Both the news box to be published to and the Upfront server group are both folder object properties and must be set before attempting to publish. Publish to Upfront You can publish cubes and reports as Upfront NewsItems to provide Web users with single click access to the data in PowerPlay Web Explorer and PowerPlay Web Viewer. If you publish a folder. In the imported_reports folder. The PowerPlay Enterprise Server Administration must be secured against the same namespace as the NewsIndex before attempting to publish.Chapter 4: Deploy Cubes and Reports Notes • The Open with Browser command is not available for cubes set for Windows access only. For example. While the report is available from Upfront.ppx) files published from PowerPlay client applications are stored in the directory specified by the Imported Reports Location setting for a server. all the cubes and reports in the folder are published to an Upfront NewsBox. If these are not set then the Publish to Upfront tool is unavailable. it is actually saved to the PowerPlay server. Access Manager security (p. 29) must be set.Server Administration. 52 PowerPlay (R) .

Steps 1. cubes. click Publish to Upfront. The cube or report is published to the NewsBox specified in the Upfront NewsBox for Cubes or Upfront NewsBox for Reports box (Publishing). and the report with a generated name (in this case. This setting is made at the folder level. They can be deleted by an Upfront administrator. This means that any modification of the cube or folder’s properties should also be applied to the equivalent cube or folder in the imported_reports folder. only the cubes and reports contained in that folder appear in Upfront. if one is defined. Enterprise Server Guide 53 . Notes • • Upfront NewsItems are links to the data. The report (in this case. From the Tools menu. 2. In PowerPlay Enterprise . • Show a Table of Contents A table of contents gives Web users a single point of access to the folder hierarchy depicted in PowerPlay Enterprise . From the example above. so there is no need to republish if the data source is updated. A table of contents lists the folders.Server Administration. The outdoors folder will have the folder settings from its parent folder.Server Administration. named 44_433): Some cube properties are common to reports. These common properties are transferred to the folder named for the cube as report settings. Cubes and reports published from PowerPlay Enterprise .Server Administration. After the creation of the folders. a folder named for the cube. A folder hierarchy that you have created in PowerPlay Enterprise . The folder’s report settings are then applied to the reports in that folder. the imported_reports folder is created and contains a sales cubes folder. you will have to maintain the settings manually. or folder. The folder will not appear in Upfront. If you publish a folder to Upfront. but the objects remain in PowerPlay Enterprise . and reports registered to a PowerPlay server. report. and shows the email address of the server administrator. select a cube.Server Administration become linked items in Upfront. named 44_433) will have the following properties from the outdoors cube: • Sharing • Auditing Level • Publishing • Screen Resolution • Drill Through enabling The migration of these properties is done only once.Chapter 4: Deploy Cubes and Reports On the PowerPlay server. the sales cubes folder in the imported_reports folder will have the same properties as the original sales cube folder.Server Administration is not maintained when you publish the folder to Upfront.

In PowerPlay Enterprise . Enable Preference Settings By enabling the user selection of preferences on a PowerPlay server. the Table of Contents page (p. disable the Table of Contents setting (Options) You can copy the links in a table of contents to another document. Steps 1. select a PowerPlay server. A table of contents is automatically generated each time it is accessed. Notes • If you are using security. click Properties. For example. In PowerPlay Enterprise .Server Administration.Chapter 4: Deploy Cubes and Reports You can use a table of contents to open cubes and reports at the root level of the server. From the Edit menu. 4. and then click the Settings tab. To prevent the table of contents from being accessed. 3. you allow users to choose • the locale (regional setting) used • the language of the application interface When you enable the preference settings. Click OK. 3. The level that you select becomes the highest level of the table of contents. users can view a table of contents in their web browsers that shows the cubes and reports at the root level of the server. or at any folder level. Tips • • • To prevent individual cubes and reports from being listed. and then click the Settings tab. In the Table of Contents box (Options). You can also use it as an extension to Upfront by adding a table of contents URL to an Upfront NewsBox. 2.exe?xt=sls">Sales</a> Disable a Table of Contents By default. From the Edit menu. it is always up-to-date. You can disable this feature so that users can no longer access the table of contents. Users can connect to the server-level table of contents from their Web browsers using the following URL: http://server name/cognos/cgi-bin/ppdscgi. From the Tools menu.Server Administration.exe Steps 1. This is because the Table of Contents does not prompt users for a user ID and password whereas Upfront does. so that it is always up-to-date. select Enabled. select a PowerPlay server. select a PowerPlay server or a folder.Server Administration. as long as the object exists on the server. select Disabled. In the Selection of Preferences box (Options). Steps 1. In PowerPlay Enterprise . Click OK. 54 PowerPlay (R) . <a href="http://srv1/cognos/cgi-bin/ppdscgi. You may want to allow users to access cubes and reports only from Upfront. disable the Publish to a Table of Contents setting (Publishing). click Properties. click Show Table of Contents. you may not want to let users access cubes and reports from the Table of Contents. 53) shows a Preferences tab. 2. If you include the location of the gateway in the copied link. 2. 4.

Steps 1. By combining the many display settings. a 16-bit color image may not appear as you intended. 2. Select OLAP Data Access in the server hierarchy. and then click the Settings tab. Enterprise Server Guide 55 .Chapter 4: Deploy Cubes and Reports Customize the PowerPlay Web Explorer Displays PowerPlay Web Explorer has a default look that you can customize to create a custom or corporate identity. In PowerPlay Enterprise .. The colors used in the background are limited by your computer configuration.Server Administration. Select Apply from the Actions menu to apply the changed configuration. Open the data source entry .. Click OK. select a cube. 7. In the Display folder. you can create various effects. The settings for all exported PDFs are determined by the settings applied to the Print Settings default report. This setting tells Enterprise Server to suppress only zero values. 2. 5.Server Administration. Set the DisableMaxZeroSuppress property to 1. Start the Configuration Manager from the Cognos Series 7 Tools menu. Enterprise Server suppresses all zero values. Improve Web Performance You can improve the way PowerPlay Web Explorer displays cube data by changing the Zero Suppression setting in PowerPlay Enterprise Server. if you set the page orientation of the Print Settings report to landscape. In the Configuration Manager. if the computer is configured for 256 colors. select Connect from the File menu (CTRL+N). 2. Users see the background image through the crosstab. The Zero Suppression setting tells Enterprise Server whether or not to display calculated zero values. 4. In PowerPlay Enterprise . and not calculated zeros. You can customize the displays for individual cubes or for all cubes in a folder. Performance can be enhanced by disabling the suppression of computed zeros. click Properties. including calculated zeros. each report that is exported to PDF will use a landscape orientation. Select Validate Selection from the Actions menu. Steps 1. 3. For example. The result is faster display performance. and then click the Settings tab. From the Edit menu. Steps 1. For details on the available settings. For example. select the Print Settings report. you can use a JPEG image as the background for the Crosstab Frame and define the Crosstab setting as transparent. Notes • • Cascading style sheets can override these settings (p. Set Export PDF Preferences Users can print PowerPlay Web Explorer reports by exporting the report to a PDF and then printing the PDF. click the Help button. click Properties. 4. From the Edit menu. 18). Notes • The default setting is DisableMaxZeroSuppress = 0. 3. select and modify any combination of settings to customize the display as needed. 6. For example.

Chapter 4: Deploy Cubes and Reports 3. click Properties. PowerPlay Web Viewer can substitute another font. if report consumers are likely to have the fonts on their computers. In the Publishing folder. By disabling the frame borders. In the Options folder. expand Report and select an option for the following: 7. Embed Fonts in a Report If a font is used in a report but is not on the user’s computer. 5. it is used in the report whether or not it exists on the report consumer’s computer. 2. 3. click the Help button. In the Lightweight PDF Generation box (Display. such as a chart. select an option for the following: • Local Process Threshold For example. a table. Page By Page Report Serving Explore in Interactive HTML Format Explore in Windows Format Auditing Level Queued Request Timeout(s) Connection Timeout (min) Minimum Processes Maximum Processes Idle Process Timeout (min) Report Timeout (min) • • • • • • • • • • 4. An alternative is to embed fonts. 56 PowerPlay (R) . 4. and some text. From the Edit menu. but they increase the size of a report by approximately 75 to 250 kilobytes. and then click the Settings tab. For details on the available settings. if you have a large number of users who are using Export PDF. you can give the report a more professional appearance.Server Administration. However. Therefore. Steps 1. You cannot delete or rename this report. select an option for the following: • • • • Sharing Paper Size Paper Orientation Display Frame(s) Border A report may consist of several elements. In PowerPlay Enterprise . substituting fonts may reduce the quality. Report). In the Display folder. you should turn embedding off. When a font is embedded. select Enabled to turn font embedding off. Click OK. Embedded fonts assure consistent appearance. you may want to increase the value for Maximum Processes to set an appropriate maximum number of processes that can be started at the same time. In the Process Control folder. Click OK. Notes • • The Print Settings report must exist for Export PDF. select a report. select an option for the following: • • • • Publish to Table of Contents Publish to Upfront Lightweight PDF Generation Pattern Simulation 6.

Enterprise Server Guide 57 . and therefore cannot be embedded unless you add them to the Licensed Fonts list. You must have permission from the font vendor to embed licensed fonts.Chapter 4: Deploy Cubes and Reports Notes • Some fonts are licensed.

Chapter 4: Deploy Cubes and Reports 58 PowerPlay (R) .

Chapter 5: Provide Drill-through Access This chapter describes how to set up drill-through access from a PowerPlay application to other reports and queries in • PowerPlay • Cognos Query • Impromptu Web Reports • Impromptu General Drill Through Considerations You can set up and enable drill-through access to cubes or reports from PowerPlay applications. and reports provide information related to the report. For example. reports from Impromptu Web Reports. queries. Enterprise Server Guide 59 . For example.ppr) from a server-only application such as PowerPlay Web. Impromptu Cognos Query Web Reports NA NA From \ To PowerPlay for Windows and PowerPlay for Excel PowerPlay Web Explorer PowerPlay Web Viewer PowerPlay Report (see note) Cube Report Impromptu Report Query Query Report Report NA NA When setting up drill-through access. a report might show revenue for all countries. ensure that the target cubes.mdc). The current measure and dimension line of a report are applied to drill-through cubes and queries. The drill-through cube shows data for all product lines. but a drill-through cube shows revenue only for Mexico. the dimension Product Line in one report is not recognized as the same dimension as Prod Line in another report. For example.ppx) or a cube (. For example. you cannot drill through to a PowerPlay Report (. queries from Cognos Query. You must be consistent when naming measures and dimensions. or reports from Impromptu as depicted in the following table. If the drill-through cube doesn't have a Product Line dimension. Notes • You can only drill through from a local source to another local source or from a remote source (registered on PowerPlay Enterprise Server) to another remote source. the filter can't be applied. you should drill through to a PowerPlay Portable Report (. a report is filtered for one product line. Instead. Measures and dimensions that aren't included in a drill-through cube or query can't be applied.

you specify a path to the . at the server level. see the PowerPlay Connect Help. and searches for a cube with the exact name. the cube that you want to drill from must contain an embedded list of drill-through targets. type a description for each drill-through target. you define the drill-through targets in the PowerCube property sheet. 7.Chapter 5: Provide Drill-through Access Set Up Drill-through Targets in Transformer Before users can drill through to other sources of information.mdc PowerPlay Enterprise Server identifies the target as a cube by its . the server interprets the file name as the name of a cube added to the root folder. For example. If found. it drills through to the cube. Open the PowerCube property sheet for the cube you want to drill from. This description is used in the menu of available drill-through targets in the PowerPlay client application. you define the drill-through targets in the Measures property sheet of the specific measure. Notes • When setting up a cube as a drill-through target in Transformer. 5. exports_feb. 3. for cubes deployed to PowerPlay Enterprise Server. 2. Note: For Cognos Query. Instead. Start Transformer and open the model that defines the PowerCube from which you want to drill through. 60 PowerPlay (R) . Steps 1. paths are irrelevant. This is done in Transformer for PowerCubes. From the Run menu.ppr files (PowerPlay Reports) • .mdc file. Click OK.ppx files (PowerPlay Portable Reports) • . that is. This is valid for local cubes. it is added to the Custom Reports list. Highlight the newly added file.iqd files are stored in a hierarchical folder structure within the iqdfiles folder on the computer where the Cognos Query server is installed. In the Drill Through tab. 6.imr files (Impromptu or Impromptu Web Reports) If you want drill-through access to be available for all measures in a cube. For more information.mdc extension. PowerPlay drill-through targets are • . however. click Update PowerCubes.iqd files (for Cognos Query) • . the following drill-through path is entered in Transformer: c:\cubes\exports_feb. Note: To add definitions of drill-through targets to a third party OLAP source. If you want drill-through access to be available for selected measures. 4. the . When you choose a file.mdc files (other cubes) • . Do one of the following: • • Open the Measures property sheet for the measure you want to provide drill-through access on. select the Allow Drill Through for this Measure or the Allow Drill Through for this PowerCube check box. then in the Report Description box. you can use PowerPlay Connect. This writes the drill-through targets to the cube without actually reprocessing the cube. for example. Click the Add button and locate the target file.

When users drill through a report. For PowerPlay cubes.iqd files other than those used for the drill through. Edit the Column Names section of the . 60). you must ensure that the PowerCube column names exactly match the Cognos Query column names. When passing filter information during the drill-through operation.imr files as drill-through targets.iqd file to map PowerPlay column names onto Cognos Query column names. You then set up drill through from the summary cube to the various detailed cubes. or from another type of source data file (ASCII or Impromptu .mdc or . you specify the computer where the cubes you want to drill through to are located. Notes • You cannot drill through to PowerPlay report files (. specify the drill-through targets (. • In PowerPlay Enterprise .iqd file as a data source for your Transformer model. For example.mdc. for example).Server Administration. • You want to drill across from one set of cubes to another. To set up drill through in any PowerPlay client from one cube to another.Server Administration. Note: For remote cubes. Enterprise Server Guide 61 . This is not recommended in most cases. the target cube is identified by the name of the cube rather than the full path entered in Transformer. This is recommended only if the above option is not possible. Users select a cube from this menu. ensure that the category codes match across the models that you use to create PowerCubes. Enable Drill Through to Cubes After you set up drill through in Transformer. the associated . including case. you must perform the following tasks: • In Transformer. If you use an . as it can cause problems in existing models. category names match automatically. This is only an issue if the source and target cubes are based on different models.Server Administration. Drill Through from Cube to Cube You can set up drill-through access from one cube to another within the same environment (Windows or Web). If the names do not match. you use . if the target cube entered in Transformer is c:\cubes\outdoors.Chapter 5: Provide Drill-through Access • When setting up cube to cube drill-through targets. You can solve this potential problem in the following ways: • • Change the query column names to match the column names in your Transformer model.ppr files) for your measures or PowerCubes. When setting up drill through to Cognos Query. PowerPlay relies on matching category codes to filter the target cube based on the dimension line settings in the source cube. This is the recommended approach whenever possible. You must then update all affected cubes (p. • • Tips • When setting up drill through to Impromptu or Impromptu Web Reports. if the cube is created from .ppr) from the Web. then the filter that is applied in PowerPlay Web will not be recognized by Cognos Query. and drill-through cubes with detailed data sources. enable drill through as required for each cube. that is. cubes accessible from PowerPlay Enterprise Server.imr file (if one exists) is automatically listed as an available drill-through target. If the source and target cubes are both built from the same Transformer model.iqd file. This is useful in the following cases: • You create a summary cube based on a consolidated data source. you can enable drill through in PowerPlay Enterprise . a menu of drill-through targets appears. Change the Transformer query column names to match the column names in Cognos Query. the cube must be named outdoors in PowerPlay Enterprise .

only the current dimension line settings are passed as filter parameters to the drill-through target. it passes the current dimension line settings as filter parameters. For example. These columns are the objective of drilling through. You must then update all affected cubes (p. Unlike PowerPlay client. In the PowerPlay cubes box (Drill Through). In the PowerPlay Windows Target box. PowerPlay Enterprise Server resolves the location of the ppdscgi. click Properties. Notes • When a drill through is executed. 3. 62 PowerPlay (R) . 2.iqd file. such as Addresses and Phone Numbers. In PowerPlay Enterprise . due to incorrect column labeling. select a cube.Server Administration click Open with Browser on the Tools menu. In the PowerPlay Web Target box. There is no reason to include links in . 4. and then click the Settings tab. 60).iqd file must be replicated on the target Cognos Query server. The path must be the same relative to the folder in which Cognos Query is installed on the target server. or the server name:port number for the computer on which the cube resides. • Queries used as drill-through targets must be saved in a folder that all the drill-through users have access to. the drill through may return unexpected results.iqd files that you intend to use only for cube creation (not as drill-through queries). enter the URL of the PowerPlay Web gateway program. • Drill-through queries should include links to other entities for further exploration. When performing a drill through. report or folder. where the active cell is also passed with the dimension line setting. type http://server name/cognos/cgi-bin/ppdscgi. • Queries used as drill-through targets should contain the attributes used to define levels in the cube.exe . enable drill through and specify the required URL to start Cognos Query. Tips • To test the drill through as it would work on the Web.Server Administration. enter either the name of the server group that contains the cube you want to provide drill-through access to.Server Administration. 5. If the . • • Design Queries as Drill-through Targets The design criteria for a drill-through query are different from a cube creation query in the following ways: • Drill-through queries typically include many non-additive text properties that you would not include in a Transformer source query. Drill Through to Cognos Query To set up drill through from PowerPlay Web to a Cognos Query report. after the cube is added in PowerPlay Enterprise . select Enable. • In PowerPlay Enterprise .Chapter 5: Provide Drill-through Access Steps 1. From the Edit menu. For a drill-through request to execute properly.iqd files) for your measures or PowerCubes.iqd file cannot apply these filters. save the query you want to drill through to as an . you must perform the following tasks: • In Cognos Query. • In Transformer. Cognos Query can only filter on attributes included in the query. a copy of the . PowerPlay Web does not identify an active cell. specify the drill-through targets (. such as PowerPlay Server Group 1. Then drill through by clicking the Drill Through button and selecting the target cube.exe file from the Server Group definition in the configuration file. Tip: You can also specify a PowerPlay Server group name in this field.

iqd file will be created.Server Administration. click the Save As button.Server Administration.iqd file to drill through to Cognos Query. On the Cognos Query toolbar. you must perform the following tasks: • In Transformer. you can enable drill through in PowerPlay Enterprise . Click the Run Query button. In the Cognos Query Server box.iqd file. 5. click Open with Browser on the Tools menu. select the URL for the Cognos Query gateway. Steps 1. specify the drill-through targets (. 3. To test that the drill through works.imr files) for your measures or PowerCubes.iqd files from Impromptu. report. and then click the Settings tab. you must use Transformer to specify the drill-through targets (. You must then update all affected cubes (p. In the Cognos Query box. 7. open or create a Cognos Query report to which you want to drill through. Do not use . Select the Enable Drill-Through Access check box. and click Finish. click Properties. Follow the steps in the NewsItem wizard. enable drill through for each cube.iqd drill-through targets and update your cubes. 60).iqd file. Enable Drill Through to Cognos Query After you set up your . PowerPlay Enterprise Server resolves the location of the Cognos Query gateway from the Server Group definition in the configuration file. Drill Through to Impromptu Web Reports To set up drill through from PowerPlay Web to Impromptu Web Reports. 2. Drill through to Cognos Query is now enabled. • In PowerPlay Enterprise . 2. click Properties. Enterprise Server Guide 63 .Chapter 5: Provide Drill-through Access Save a Drill-through Target in Cognos Query PowerPlay Web requires an .exe Tip: You can also specify a Cognos Query Server group name in this field. 6. The . click a cube. Then drill through by clicking Drill Through and selecting the target report. In PowerPlay Enterprise . To create the . On the Advanced tab.iqd file is created on the computer where the Cognos Query server is installed. Note: After you create the . 4. 4.iqd files for drill through from PowerPlay Web to Cognos Query. such as http://servername/cognos/cgi-bin/cqcgi. click the Design button. From the Edit menu. On the Cognos Query toolbar. or folder. 60). In your Web browser. Notes • Ensure that you use Cognos Query to create your . such as Cognos Query Server Group 1. 5.iqd files) for your measures or PowerCubes and update the cubes that you want to drill from (p. Steps 1. 3. The Cognos Query report reappears in your Web browser and the .Server Administration. click Enable. you must enable drill through for the report in Cognos Query and re-publish the report to Upfront.

cgi . more than one cube can drill through to this folder. • In Transformer. 64 PowerPlay (R) . In the Impromptu Web Reports Drill Through Folder box. 5. you can enable drill through in PowerPlay Enterprise . such as IWR Server Group 1. you can set up only one folder to contain drill-through targets for your PowerPlay Web cubes. specify the drill-through targets (. After you enable drill through to Impromptu Web Reports. see the Cognos Web Portal User Guide. click Enable. 3. 6. the drill through may return unexpected results (p. Notes • When a drill through is executed.imr drill-through targets.imr) associated with the . enter the name of the Upfront folder where the drill-through report is located. If you design a cube based on an Impromptu query definition file (. From the Edit menu. and a directory server to store the authentication information. or folder. click Open with Browser on the Tools menu.Chapter 5: Provide Drill-through Access Notes • Impromptu Web Reports requires users to log in to view a report. report. type http://server name/cognos/cgi-bin/imrap. then users will not be prompted when drilling from the cube to an Impromptu Web Reports report. To test that the drill through links work.cgi file. and then click the Settings tab. the . If your cube is using the same authentication source.imr files) for your measures or PowerCubes. For example.iqd file is automatically added as a drill through target in Transformer.Server Administration. click Properties. This folder name must match a top-level report folder in Upfront. Tip: You can also specify an IWR Server group name in this field. 60).iqd). Impromptu Web Reports uses Access Manager to administer users and user class security. click a cube. it passes the current dimension line settings as filter parameters. 4. 2. Drill Through to Impromptu To set up drill through from PowerPlay for Windows to Impromptu. In the Impromptu Web Reports box (Drill Through). and update your cubes. due to incorrect column labeling. However.imr file. Steps 1.imr file will also show up as a drill-through target.iqd file cannot apply these filters. • • Enable Drill Through to Impromptu Web Reports After you set up your . PowerPlay Enterprise Server resolves the location of the Impromptu Web Reports gateway file from the Server Group definition in the configuration file. If the . In PowerPlay Enterprise . save the query you want to drill through to as an . For more information about setting up drill-through reports. Web users will be prompted once per session for a user ID and password. you must perform the following tasks: • In Impromptu. Then drill through by clicking Drill Through and selecting the target report. If you have installed a ticket server. select the URL of the Imrap. you can use the same authentication source if you want users to access Impromptu Web Reports without being prompted for a user ID and password. Users need execute privileges for the drill-through target report to drill through to it from the PowerPlay cube or report.Server Administration. You must then update all affected cubes (p. 62). In the Impromptu Web Reports server box. If your cubes use security. the Impromptu report file (. configure authentication. Note: In Impromptu Web Reports.

Chapter 5: Provide Drill-through Access Drill Through to Third Party OLAP Sources You can set up drill through from PowerPlay to a range of drill targets when connected to a third party OLAP source such as Hyperion Essbase. Enterprise Server Guide 65 . You can add definitions of drill-through targets in the connection information when you use PowerPlay Connect to connect to a third party OLAP source. For more information. see the PowerPlay Connect Help.

Chapter 5: Provide Drill-through Access 66 PowerPlay (R) .

for example. cubes. For example. The description appears for users in the Table of Contents beside "You are connected to:". You can't change this name. Server Properties (Settings tab) Options Resource (/ppwb) Location Specifies the location where temporary files are stored. such as http://webgate/cognos/cgi-bin/ppdscgi. If it contains only a dispatcher. that is. it can only be used as a mirror reference.Appendix A: Context Help This section contains details about the interface items in PowerPlay Enterprise .Server Administration. Port Shows the port number that the PowerPlay server uses to communicate.exe. and reports on the server. Server Properties (General tab) Server Name Shows the name of the currently selected PowerPlay server. It is used as context-sensitive Help by the various dialog boxes. It also appears in the status line of the PowerPlay Enterprise .csx) file upon connection to a computer. A Server Group contains the URL to the PowerPlay Web gateway program. it can’t have local data sources. Server Mirror References Specifies a mirror reference for all the folders. The first server name and port number combination is the primary dispatcher.Server Administration window when a server is selected. the gateway program sends the request to the next server in the list. If this dispatcher fails or becomes otherwise unavailable. and is provided in print format as a reference. Description Specifies a description for the PowerPlay server. Gateway Specifies the Server Group name for this server. A directory named Temp must exist in this location. to set up a 7 x 24 system by reducing the risk of a single point of failure. you can indicate the types of reports available from this server. Use. Enterprise Server Guide 67 . The Server Group definition also contains a list of server name and port number combinations that the gateway program can send requests to. A PowerPlay server is a computer that contains either a dispatcher and query processor or a dispatcher only. The Server Group is retrieved from the server configuration (cern.

Server Administration or in the Cognos Configuration Manager. the Preferences tab is not available in the Table of Contents. Auditing Level Specifies the level of auditing for the server. Temporary Files Location Specifies the directory where the dispatcher and processors create temporary files on an as needed basis. In some customer deployments. Files that are older than the time limits set by the Temporary File Deletion Interval settings (PowerPlay Web Explorer and PowerPlay Web Viewer) are deleted. that is used to store reports published by PowerPlay client applications. If you set this to Disabled. PowerPlay Enterprise Server records information that may help you analyze and troubleshoot problems. This topic is covered in more depth in "Managing Temporary Files" (p.log. For security purposes. temporary files are placed on the PowerPlay dispatcher computer. Auditing information is recorded in the file ppes_audit. Selection of Preferences Allows users to change the language and locale from the Table of Contents page (Preferences tab) in their Web browser. Fetch Files Sets the location of the temporary files created by the dispatcher and processors. The email address is displayed as a mailto: link on the Table of Contents page. For information about sharing this location among multiple dispatchers. Temporary Directory Clean-Up Interval (min) Sets the time interval that the server checks the creation date and time of the files in the temporary directory location. If not set. If you enable auditing. Records detail on requests made to the server from PowerPlay Web and by the Enterprise Server Administration tool An Auditing Level setting is also available for cubes and reports. users can’t publish reports. In this case. relative to the ppsroot directory. The following auditing options are available: Option None Summary Detail Description Records no information. Administrator Email Address Specifies the email address of the person responsible for responding to user inquiries about PowerPlay Web. this directory is not Web aliased. see the installation guide. If set to 1. it is important for security reasons to ensure that these temporary files are located not on the gateway. You can enable or disable Fetch Files in PowerPlay Enterprise . no temp files persist with the gateway. 91) 68 PowerPlay (R) .Appendix A: Context Help Imported Reports Folder Specifies the directory. Records server startup and shutdown messages. The default (setting of 0) places temporary files on your Web server. Security Dialog Box Prompts you to secure the server when connecting. but behind a firewall where a dispatcher can access them.

Appendix A: Context Help

Maximum Restrict Client Connections
Specifies the maximum number of dispatcher threads that can be dedicated to a remote client.

Restrict Connection Idle Timeout (min)
Sets the number of minutes before a dedicated dispatcher thread exits due to a lack of requests from the remote client.

Table of Contents
Specifies whether users can access the Table of Contents from their Web browsers.

Prompts for User Class
Specifies whether users belonging to more than one user class are prompted to choose a user class when they open a cube. If you set this to Disabled (the default), users are not prompted for a user class. If you set this to Enabled, users are prompted only if the cube they are opening has been built with two or more user classes to which they belong.

PowerPlay Web Explorer
Temporary File Deletion Interval (s)
Sets the maximum amount of time temporary files will persist before they can be deleted. The server checks for the existence of temporary files with every occurrence of the Temporary Directory Clean-up Interval setting (Options).

Alerts
Allows users to create an Agent or Notification for a report from their Web browser. If you set this to Disabled, the Alerts button is not available in PowerPlay Web Explorer.

PowerPlay Web Viewer
Temporary File Deletion Interval (days)
Sets the maximum amount of time temporary files will persist before they can be deleted. The server checks for the existence of temporary files with every occurrence of the Temporary Directory Clean-up Interval setting (Options).

PDF Server
Page Compression Threshold (KB)
Sets the minimum size that a report page needs to be before it is compressed.

Page Compression Factor (0=none)
Sets the amount of compression applied to the contents of each page when generating a PDF. The higher the compression factor, the greater the compression, but the longer it takes to compress the page. If you set the value to 0, compression is not done. Range: 0 - 9

Resource Compression Factor (0=none)
Sets the amount of compression applied to fonts, images, color palettes, and patterns used when generating a PDF. The higher the compression factor, the greater the compression, but the longer it takes to compress the resources. If you set the value to 0, compression is not done. Range: 0 - 9

Enterprise Server Guide 69

Appendix A: Context Help

Cube Properties (General tab)
The General tab of the Cube Properties dialog box contains interface items that are not acquired by descendant cubes.

Name
Specifies a name to uniquely identify the cube.

Description
Specifies a description for the cube. Use to help users in PowerPlay client applications and Upfront identify the contents.

Cube Source
Specifies the location of the source .mdc file. The file can be local or remote, however for remote files, you must use a UNC. For example, //srv01/cubes/imports.mdc. For information about UNCs, see the notes under "Add a Cube or Report" (p. 47).

Cube Mirror References
Specifies cubes that can be used as mirror references. Use to allow the processing of the cube to be handled by other resources. The mirror reference must have its Sharing setting (Options) enabled.

Parent
Shows the parent folder.

Report Properties (General tab)
The General tab of the Report Properties dialog box contains interface items that are not acquired by descendant reports.

Name
Specifies a name to uniquely identify the report. The Print Settings report must exist for Export PDF. You cannot rename this report.

Description
Specifies a description for the report. Use to help users in Upfront identify the contents.

Report Source
Specifies the location of the source .ppx file. The file can be local or remote, however for remote files, you must use a UNC (Universal Naming Convention). For example, //srv01/reports/imports.ppx. For information about UNCs, see the notes under "Add a Cube or Report" (p. 47).

Report Mirror References
Specifies reports that can be used as mirror references. Use to allow the processing of the report to be handled by other resources. The mirror reference must have its Sharing setting (Options) enabled.

Parent
Shows the parent folder.

70 PowerPlay (R)

Appendix A: Context Help

Folder Properties (General tab)
The General tab of the Folder Properties dialog box contains interface items that are not acquired by descendant folders.

Name
Specifies a name to uniquely identify the folder. Once set, the name can’t be changed because it would result in a shortcut.

Description
Specifies a description for the folder.

Folder Source
Specifies a directory containing .mdc or .ppx files.

Folder Mirror References
Specifies folders (or servers) that can be used as mirror references. Use to allow the processing of all cubes and reports in the selected folder to be handled by other resources. The mirror reference must have its Sharing setting (Options) enabled.

Mount At
Specifies the shared location of the Imported_Reports folder. Use to handle processing of PowerPlay reports in a distributed, multiple-server environment. See "Mount At" (p. 33) for more information.

Parent
Shows the parent folder.

Folder, Cube, and Report Properties (Settings tab)
The Settings tab contains interface items that can be acquired by descendant cubes, reports, and folders. The settings described in the section below pertain to the selected cube or report. When a folder is selected, the settings pertain to all cubes and reports in the folder.

Reset All
Resets all the settings to those of its parent.

Reset
Restores the selected setting to that of its parent.

Reset Descendants
Applies the current settings to descendant objects of the same type and removes any overrides.

Options
Access Privileges
Specifies whether the cube is made available to Web users (via a browser), Windows users (via PowerPlay for Windows or PowerPlay for Excel), or both.

Title
Specifies a title that appears at the top of the page. You can also add variables to the title.

Enterprise Server Guide 71

or folder available for mirror referencing. Display frame(s) border Specifies whether the Display Frame Borders checkbox is available. report. Explore in Windows Format Allows users in Upfront to explore the report in PowerPlay for Windows. Explore in Interactive HTML Format Specifies whether users can explore PDF reports in interactive HTML format. When this server setting is enabled. Page Orientation Specifies the default orientation for printing PDF reports. Page by Page Report Serving Enables single page serving of multi-page documents rather than serving the entire document. such as Essbase. they can re-synchronize to the remote server cube. Get Data Allows users to explore a report without showing data in a crosstab display. For large reports. Paper Size Specifies the default paper size for printing PDF reports. Only PowerCubes created with PowerPlay Transformer can be saved as subcubes. users can further improve access time by adjusting two settings in Adobe Acrobat Reader: Allow Background Download of Entire File and Use Page Cache. If this option is enabled. Users must have PowerPlay for Windows installed. a local PowerCube (. This allows them to disconnect from the PowerPlay Enterprise Server and access the subcube on their notebook computer. Later.Appendix A: Context Help HTML Encode User Specified File Restricts embedded HTML content in the titles of reports that may be published to the Web. for example.e. enabling this may improve access time. 72 PowerPlay (R) . Sharing Makes the cube. i. This is also referred to as byte serving. When this is enabled. allowing users to add a border to their reports. Save as PowerCube Specifies that PowerPlay for Windows and PowerPlay for Excel users can save the cube as a subcube.mdc file) on their local drives. This option has no effect on third-party cubes. users who have PowerPlay Personal Server installed can connect to the remote cube and save portions of it as a subcube. the user will be able to select Get Data Later from the Change Measures box and Get Data from within the display. This option also affects whether users can open reports in interactive HTML if the report is published to Upfront. and no effect on time-based partitioned cubes.

Appendix A: Context Help

Auditing Level
Specifies the level of auditing for the cube or report. If you enable auditing, PowerPlay Enterprise Server records information that may help you analyze and troubleshoot problems. The following auditing options are available: Option None Summary Detail Description Records no information. Records requests made to cubes or reports. Records statistics on the measures, dimensions, and levels of a cube that are accessed by PowerPlay Web. This allows you to determine which areas of a cube are used more or less frequently, and may help you to develop a strategy for creating more efficient cubes.

An Auditing Level setting is also available for the server. Auditing information is recorded in the file ppes_audit.log.

Queued Request Timeout
Sets the length of time, in seconds, that cube or report requests will remain queued. If these requests are not processed within the set time, users will receive a message asking them to try again.

Dimension Line in CSV Export
Specifies whether the dimension line information is included when a user exports a Comma Separated Value file (.csv) from the Web.

Secure Temp Files
Specifies that temporary files are encrypted.

Process Control
Connection Timeout (min)
Sets the number of minutes a user's connection to cubes remains active between Client/server requests. This timeout is particularly important for connections to Access Manager-protected cubes. When the connection times out, the user must re-enter the authentication information to continue browsing the cube. Connection Timeout does not apply to connections to the server via PowerPlay for Windows because of the Common Logon Server. This setting may be shorter than that configured in the Ticket Server.

Minimum Processes
Sets the minimum number of processes that remain running once they open.

Maximum Processes
Sets the maximum number of processes that can be open at the same time.

Report Timeout
Sets the maximum length of time that the report processor keeps a document open.

Request Timeout (s)
Sets the maximum length of time that the server spends processing requests. If the requests are not processed within the set time, users receive a message asking them to try again. Enterprise Server Guide 73

Appendix A: Context Help

Idle Process Timeout (min)
Sets the number of minutes a process remains active between requests. When a process times out, the memory it used becomes available to the server. The Minimum Processes setting prevents all of the processes from shutting down.

Scheduling Threshold
Sets the queuing algorithm that decides to which server process the dispatcher will pass an incoming Client request. For each cube, you configure a maximum number of processes in PowerPlay Enterprise Server. Each of these processes can handle one request at a time. If more requests are received from PowerPlay Windows applications than there are processes, queuing occurs. PowerPlay Enterprise Server maintains one queue for each server process. The dispatcher then routes incoming requests to a server process based on the Scheduling Threshold parameter. There are three algorithms to control the routing of incoming requests: • A value of 10 means each request is submitted to the next server process in a round-robin fashion, regardless of the length of the current queue. If most incoming requests are similar in duration, choose this algorithm to minimize time and CPU cycles. • A value of 0 means each request is submitted to the process with the shortest queue. If incoming requests vary in duration, choose this algorithm for better performance. • A value from 1 to 9 means each request is submitted to the process with the best queuing percentage. This algorithm polls each server process to determine the processing time taken for the current request and the amount of time queued requests have been waiting. The queuing percentage is calculated as wait time/process time for the current request, expressed as a percentage. The incoming request is then directed to the first process whose queuing percentage is less than 10 times the threshold value. For example, a scheduling threshold value of 5 means that the request is passed to the first process whose queuing percentage is less than 50%. Under heavy load conditions, this algorithm is the most effective. It reduces wait time, but at the cost of lower overall throughput. To use this algorithm effectively, decrease its value to reduce the number of processes polled before one is selected.

Local Process Threshold
Sets the threshold at which requests are queued to be processed locally rather than forwarded to a mirror reference. When both a source and a mirror reference exist for a cube or report, the server chooses local (source) processing. If no local processes are available, requests can be queued up to the threshold set (provided the Maximum Processes limit has been reached). The default setting of 0 means requests are never queued. They are immediately forwarded to the mirror reference.

Publishing
Publish to a Table of Contents
Lists the cube or report for Web users in the Table of Contents. By default, all data is published. You may want to prevent some cubes or reports from being listed in the Table of Contents. For example, some cubes can be made available only for drill-through access from another cube, or, some reports may be added for testing purposes. Note: You can also disable the entire Table of Contents (p. 54).

Publish to Upfront
Lists the cube or report for Web users in Upfront.

74 PowerPlay (R)

Appendix A: Context Help

Upfront Server Group
Specifies the name of the Upfront server group (Upfront Server Group by default). The name is retrieved from the server configuration file when you connect to a server in the PowerPlay Enterprise - Server Administration tool. The Upfront Server group specifies a URL to the Upfront gateway program such as http://portal/cognos/cgi-bin/upfcgi.exe. It also specifies a list of server name and port number combinations available to handle publishing requests. The gateway program communicates with the first server in the list, the primary processor. If this server should become unavailable, the gateway program communicates with the next server in the list, providing continuous service.

Upfront Server
Specifies the name of the Upfront Server. By default, the Upfront server is localhost. In multiple-server environments, it is better to use the Server Group Name than the Server Name for failover protection. Specifying the Server Group name ensures that Upfront requests can be passed to more than one machine if needed and thus reduce a single point of failure.

Upfront Publish Template
Specifies a template file to use for prompting users when publishing to Upfront. Use when you create custom Upfront templates with file names that differ from the ones installed. If blank, Upfront uses the default template, NI_publish.utml. The Upfront Theme that is used is a user-specified preference. Therefore, ensure that the template file specified exists in all available theme folders.

Upfront NewsBox for Cubes Upfront NewsBox for Reports
Specifies the NewsBox on your Upfront server to which the cube or report gets published. This property applies only to publishing from PowerPlay Enterprise - Server Administration. In PowerPlay Web Explorer, a user is always prompted to choose a NewsBox when publishing to Upfront. The server name can be used here to ensure backward compatibility with earlier versions of PowerPlay Enterprise Server.

Authentication
Namespace
Specifies the directory server namespace used to authenticate Web users who access the cube. This setting overrides any namespace stored in the cube. This setting does not affect Windows users.

Display
The display settings allow you to change the way PowerPlay Web is shown on users’ Web browsers. Although the default foreground settings have been designed to be visually appealing with the default background settings, you can modify them to create a custom or corporate identity. The cascading style sheet ppweb.css can override these setting (p. 18).

Screen Resolution
Optimizes the appearance of buttons and displays. Use to select the most common resolution for user workstations. If the resolution does not match the Web browser, the buttons and displays appear at a different scale from the text. If you aren't sure which resolution to use, 800 x 600 is recommended.

Enterprise Server Guide 75

When enabled. a filled rectangle appears in the report PDF. Buttons are also available for going directly to the first or last page of columns or rows. The Enhanced user interface supports XSLT templates. Use to prevent Web browser problems associated with displaying a large number of list items. it also uses more resources. Report Lightweight PDF Generation Allows all system fonts on the server to be embedded in the report PDF. If you enable this setting. after opening the report.0. • Dynamic Restricts the generation of HTML pages to code supported by Netscape 4.x. Use to improve the performance and readability of large reports. you can improve performance. users can page forward to the next 20 columns or 50 rows.x. patterns are reproduced as bitmaps in the report PDF. Users can redefine the limits after they open paginated reports. If you can't redesign cubes so that dimensions contain fewer categories. Report pages include navigation buttons that allow users to move forward and backward. Internet Explorer 4. you can limit the number of categories included in each level. and Internet Explorer 5. Item Limit Limits the number of categories shown per level. The page limits that you set are defaults only. Any category longer than the maximum limit is truncated. Netscape 6. users do not get DHTML rendering regardless of the browser used. which can provide more customization and interactivity for users.2. Pattern Simulation Specifies whether the server simulates patterns used in the report or substitutes a filled rectangle for the pattern. The box width is determined by the longest category name. If you have large cubes. • Enhanced Allows the generation of HTML pages to code supported by Internet Explorer 5. While using pattern simulation assures accurate reproduction of patterns used in the original report.5 and later. up to the maximum set. 76 PowerPlay (R) .Appendix A: Context Help Type Specifies the one of these available user interfaces: • Generic Restricts the generation of HTML pages to code supported by older Web browsers. If you enable Generic HTML. For example. You can also decrease the limit if categories are easily distinguishable with fewer characters. When disabled. Menu Size Character Limit Limits the number of characters shown for category names. DHTML can reduce performance of the server. You may need to increase this limit if more characters are necessary to distinguish categories. Page Size Row Limit Column Limit Limits the number of rows and columns that appear on a page.

Background Image File Specifies a .jpg image to be used as the background of the area where the dimension lists appear. Background Image File Specifies a . Transparency Allows the background to show. Dimensions Area Report Banner Shows the PowerPlay Web Explorer banner containing the name of the currently connected cube. Crosstab Image Enables or disables the image specified in the Background Image File setting. Background Color Specifies the background color of the area where the dimension lists appear.gif or . Enterprise Server Guide 77 . see the Transformer online help.Appendix A: Context Help For example. Text Color Specifies the color of non-hyperlinked text (such as data values) in crosstab displays. Crosstab Frame Link Color Specifies the color of hyperlinked text (such as category labels) in crosstab displays. For information about designing cubes. Image Enables or disables the image specified in the Background Image File setting.jpg image to be used as the background of the area on the page where the crosstab and dimension line are shown.gif or .gif or . you limit dimension box categories to 50. Transparency Allows the background to show. Image Enables or disables the image specified in the Background Image File setting.jpg image to be used as the background of the crosstab cell. The option name depends on the version of the user’s Web browser. A More Below or Page Down option is shown at the end of the list so users can view the next categories. Background Color Specifies the background color of the area on the page where the crosstab and dimension line are shown. Background Image File Specifies a . Any level that exceeds 50 categories is truncated to show only the first 50 categories.

Chart and Legends Line Color Specifies the color of borders around slices or bars.jpg image to be used as the background for chart displays. Transparency Allows the background of crosstab cells to show. 78 PowerPlay (R) . Transparency Allows the background to show. Only clustered bar. Chart Frame Link Color Specifies the color of linked text (such as category labels) in chart displays. Image Enables or disables the image specified in the Background Image File setting. and the chart axes used for clustered bar.gif or . Grid Color Specifies the color of horizontal lines that indicate units of measure along the axis. Transparency Allows the background to show. Background Image File Specifies a .jpg image to be used as the background of the area on the page where chart displays are shown. Text Color Specifies the color of non-linked text (such as data values) in chart displays. and multiline displays use grids. Toolbar Image Enables or disables the image specified in the Background Image File setting. simple bar. Image Enables or disables the image specified in the Background Image File setting. Background Color Specifies the background color of chart displays.gif or .Appendix A: Context Help Background Color Specifies the background color of the crosstab cells. and multiline chart displays. simple bar. Background Color Specifies the background color of the area on the page where chart displays are shown. Background Image File Specifies a .

Buttons Enables each the following default buttons in the PowerPlay Web Explorer toolbar. 96) ) Calculation Enterprise Server Guide 79 . Transparency Allows the background to show. Button Setting Crosstab Indented Crosstab Pie Simple Bar Clustered Bar Stacked Bar Multiline 3D Bar Split View Display Options Fit Charts (available only in the Dynamic interface (p. and up to eight custom buttons. Background color Specifies the background color of the area at the bottom of the page where the toolbar is shown.Appendix A: Context Help Background Image File Specifies a . 96) ) Rows per Page (available only in the Dynamic interface (p.gif or . 96) ) Columns per Page (available only in the Dynamic interface (p.jpg image to be used underneath the toolbar.

Appendix A: Context Help Button Setting Hide/Show Swap Zero Suppression 80/20 Suppression Automatic Exception Highlighting Custom Exception Highlighting Alert Explain Find Drill Through Help Reset Get Data Later Prepare Bookmark PDF Export Options Export PDF Export CSV Save 80 PowerPlay (R) .

Use to enable or disable drill-through access in the client application. Use to enable or disable drill-through access in the client application. PowerPlay Enterprise Server resolves the machine name. append the number to the server name. such as https://webgate/cognos/cgi-bin/cqcgi Impromptu Web Reports Allows users to drill through to details in an Impromptu report. specify the HTTPS protocol with the server name. you can take advantage of increased fault tolerance that the server group definition contains. PowerPlay Windows Target Specifies the server that contains the cube you want to provide drill-through access to. If a server group definition is used in this property. such as http://webgate.yourorg. Both PowerCubes created with PowerPlay Transformer and third party OLAP sources modified with PowerPlay Connect can allow drill-through.com/cognos/cgi-bin/ppdscgi To specify a port number other than the default port 80. and URL from the server configuration file (cern. Cognos Query Allows users to drill through to details in Cognos Query. such as http://webgate/cognos/cgi-bin/ppdscgi. you may also need to include the domain name.com/cognos/cgi-bin/cqcgi To specify a port number other than the default port 80.csx). port number. PowerPlay Enterprise Server resolves the URL from the server configuration file. Enterprise Server Guide 81 . PowerPlay Web Target Specifies the URL to the PowerPlay Web gateway program. such as http://webgate.exe Depending on how your network is configured. This reference may be to a PowerPlay Server group or it may be quoted as a specific server name and port number combination. such as http://webgate:88/cognos/cgi-bin/ppdscgi.Appendix A: Context Help Button Setting Save As Return to Source Drill Through PowerPlay Cubes Allows users to drill through to details in another cube. append the number to the server name.exe If your Web server is using Secure Sockets Layer (SSL). you may also need to include the domain name.exe Depending on how your network is configured. Use to enable or disable drill-through access in the client application.yourorg. such as https://webgate/cognos/cgi-bin/ppdscgi Use the PowerPlay Server group in this field if you specified a server group in the PowerPlay Server Group field. specify the HTTPS protocol with the server name. such as http://webgate:88/cognos/cgi-bin/cqcgi. such as http://webgate/cognos/cgi-bin/cqcgi. Cognos Query Server Specifies the URL to the Cognos Query gateway program.exe If your Web server is using Secure Sockets Layer (SSL).

Confirm New Password Type the new password again. type Great Outdoors in this box.cgi If your Web server is using Secure Sockets Layer (SSL).cgi Depending on how your network is configured. you must provide the port number as part of the server name. For example. if any.yourorg. such as https://webgate/cognos/cgi-bin/imrap.. http://webgate. which warns you that no password is set.Appendix A: Context Help Impromptu Web Reports Drill Through Newsbox Specifies the Upfront Newsbox of the published report set that contains the target drill-through report. if one exists.cgi To specify a port number other than the default port 80. if the drill-through report go. The computer must be running PowerPlay Enterprise Server. Don't Show This Dialog Again Prevents the dialog box from subsequently opening. the password is case-sensitive. Set Server Password Server Name Specifies the server name or IP address of the PowerPlay server. for the PowerPlay server.imr file name must also be written in the cube if it was built using the cube/measure drill through properties in PowerPlay Transformer and was therefore included at build time. For example. you may also need to include the domain name. Password Type a password. that is. Srv01:8060 connects to server Srv01 on port 8060. The . If the PowerPlay server is on a UNIX system. 82 PowerPlay (R) . If you want to connect to a server that is not using the default port number (8010). such as http://webgate/cognos/cgi-bin/imrap. such as http://webgate:88/cognos/cgi-bin/imrap.cgi Connect to Server Server Name Specifies the name or IP address of the PowerPlay server to log on to. have a dispatcher installed. the password is case-sensitive.imr is located in the Great Outdoors folder. The Windows service Cognos PowerPlay Enterprise Server or UNIX daemon ppserver must be started. New Password Type the password you want to set. or leave this box blank if you do not want a password for the server. append the number to the server name. For example. Impromptu Web Reports Server Specifies the URL to the Impromptu Web Reports gateway program on Windows and UNIX. If the PowerPlay server is on a UNIX system. Old Password Type the previously-defined password. specify the HTTPS protocol with the server name.com/cognos/cgi-bin/imrap.

Before you can add a mirror reference on another server. Title Title Type a title for the cube. place the cursor where you would like the variable. and click Insert. We recommend first unsecuring the PowerPlay Enterprise Server. and then resecuring the server. you must connect to it. Delete Deletes the selected mirror reference. Include Subfolders Specifies whether subfolders are also searched. You must first be connected to the server. of the item you want to find. select the variable from the list. use the Access Manager Configuration Wizard. changing the namespace. Enterprise Server Guide 83 .Server Administration. or a portion of the name. To change the namespace. Search Search For Specifies the name. Double-click any returned item to locate it in PowerPlay Enterprise .Server Administration. Insert Inserts the selected variable at the cursor location in the title. In the Title box.Appendix A: Context Help Set Security Namespace Shows the directory server namespace used to authenticate the administrators who access the server. User Classes Specifies the user classes that you want to give administrative access for the selected server. The namespace cannot be changed using PowerPlay Enterprise . Select Mirror References Selected Lists the current mirror references. Variable Adds the selected variable to the cube title. Add Adds a mirror reference. Search Now Starts the search. Search Where Specifies the server where you want to search.

Target Shows the location to where the item was moved. Rename Name Specifies a new name for the object. You cannot rename the Print Settings report. Find Target Changes the main windows to the target location. Changing the name of an object creates a shortcut to the original. Created Shows the date and time that the object was moved or renamed.Appendix A: Context Help Shortcut Name Shows the name of the object that was moved or renamed. 84 PowerPlay (R) .

/ppadmtool.sh CONNECT servername USER username • . ADD type name [PATH path] [DS mirror] ADD DS type name DS mirror CONNECT server[:port][/password] CONNECT server[:port] USER username PASSWORD password CD folder COPY name name DISABLE name ENABLE name EXIT HELP KILL name Enterprise Server Guide 85 . You can then issue the following commands against PowerPlay servers..] or you can start a session by typing ppadmtool on the command line. for example PPADMTOOL CONNECT server[:port][/password] [option .sh • . Run this script using one of the following formats: • . This script sets the appropriate environmental variables and starts the command line administration tool.Server Administration Synopsis You can issue single commands that connect and perform the desired action./ppadmtool. After installation. The ppadmtool program saves you time./ppadmtool.. the location of this script in UNIX is in the bin folder./ppadmtool.sh CONNECT servername USER username PASSWORD password • . and reports until you type exit. You can • enter your instruction from the command line rather than launching PowerPlay Enterprise Server Administrator • redirect stdin to use batch commands • redirect stdout to a log file In UNIX.PowerPlay Enterprise .Appendix B: Batch Administration This section describes the command-line options you can use to perform batch administration on PowerPlay servers. The ppadmtool Program With the ppadmtool program.sh CONNECT servername:port/password (non Access Manager mode) Name ppadmtool . the command-line administration tool can be accessed by using the ppadmtool. cubes. you can execute PowerPlay Enterprise Server commands directly from the Windows command prompt or UNIX command shell. Parameters appended to the script are passed to the administration tool for processing.sh script.

86 PowerPlay (R) . server Specifies the name or IP address of a PowerPlay server. When the object is a folder.) object hierarchy format. including the file extension. mirror Mirror reference for the object. name Specifies the name of an object (cube. as described in the Options section below. which represents the folder path within the PowerPlay Enterprise Server hierarchy. path Specifies a physical path to the data source file. report. objectname Specifies the logical name of the cube as defined in PowerPlay Enterprise . option Specifies a command option. it can be used to form a folder hierarchy (see the Conventions section below). A server is also considered the root folder. property Specifies an object property in (. For a list of properties.Appendix B: Batch Administration LIST [folder] MOVE name name NOTIFY {(CUBE_OBJECT objectname | CUBE_FILE filename)} EVENT = UPDATE [ON_ERROR IGNORE | FAIL] PUBLISH name REMOVE type [PATH] name REMOVE DS type name DS mirror RESET name property RESET BELOW folder property SET name property=value SHOW name filename Specifies the fully qualified path of the mdc file. password Specifies either a simple server password or the password for the specified Access Manager user name. folder Specifies an object name of type FOLDER.Server Administration. or folder). The syntax for a mirror reference is server[:port]/name. Uses the format of your operating system (UNIX or Windows). port Specifies Port number of the PowerPlay server. use the SHOW command.

) represents the current folder. ppadmtool > connect hp_srv > disable . The following example connects to the server "srv28a" as the user name "JuliaX" using the password "neptune": CONNECT srv28a USER JuliaX PASSWORD neptune Enterprise Server Guide 87 . CONNECT Connects to a PowerPlay server. The server may be secured using a simple password or Access Manager. Description The ppadmtool program executes PowerPlay server commands from the UNIX command shell or Windows Command Prompt./adm/daily_update.Appendix B: Batch Administration type Specifies the type of object. PATH indicates a data source file and DS indicates mirror reference. value Specifies the value for a property. two dots (. For example. which is running a PowerPlay server on port 8065: ADD FOLDER Finance DS remote3:8065/FinanceHQ If a type is not specified. Conventions When entering file paths or the variable "name" (when the object is a folder).. ADD DS Adds a mirror reference to an existing object. the object is assumed to be a cube. a dot (. which is the server. REPORT. username Specifies a user name belonging to an Access Manager user class.ppx The following example adds the folder "Finance" which has a mirror reference to the object "FinanceHQ" on server remote3. ppadmtool < .) represent the parent folder. The following example adds the report "Finance" to the connected server: ADD REPORT Finance PATH /applications/finance. the object is assumed to be a cube. For example SHOW "great outdoors" COPY .log Options ADD Adds a new object to the connected server./gnt "/CF systems/great outdoors" You can also redirect input from a file and output to a file.. The type can be CUBE./ > exit When entering file names or paths containing spaces. enclose the entire file name or path in quotation marks ("). The following example adds two mirror reference (to the servers "remote2" and "remote3") to the cube "Marketing": ADD DS CUBE Marketing DS remote2/mkt ADD DS CUBE Marketing DS remote3/mkt If a type is not specified. the following script disables all objects on server hp_srv.. and a slash (/) represents the root folder.txt > check. or FOLDER.

all child objects are also made available. EXIT Closes the ppadmtool utility. It also replaces the original object "gnt" with a shortcut of the same name. KILL Stops the process for the object. The following example. The following example lists all objects in the folder "/docs/recent reports": LIST "/docs/recent reports" If no folder is specified. HELP Shows a list of the ppadmtool commands. The following example makes the object "Sales 98" available: ENABLE "Sales 98" If the object is a folder or server. MOVE Moves an object and its associated overridden properties to a new object./hub products/marketing" global networking/hub products/marketing> COPY Creates a copy of an object and its associated overridden properties in a new object. The following example changes the current folder from "/global networking/finances" to "/global networking/hub product/marketing". For clarity. The following example copies the report "gnt" from the parent folder to the folder "/CF systems" and names the new object "great outdoors": COPY . while leaving behind a shortcut to the new object to prevent broken links. The following example creates a new object "bls" in the "/new/" folder..Appendix B: Batch Administration CD Changes the current folder. all the objects in the current folder are listed.. the prompt is included in the example: global networking /finances> CD ". stops the current processes for the Great Outdoors cube: KILL "Great Outdoors" LIST Lists all the objects in the specified folder. The following example makes the object "Finance" unavailable: DISABLE Finance The following example makes the object "Great Outdoors" unavailable: DISABLE "Great Outdoors" If the object is a folder or server. linked to "bls": MOVE gnt "/new/bls" 88 PowerPlay (R) . The command-line prompt indicates the current folder and the path from the root folder (the server). all child objects are also made unavailable./gnt "/CF systems/great outdoors" DISABLE Changes the status of an object so that it is unavailable to users. ENABLE Changes the status of an object so that it is available to users.

IGNORE . all child objects are also removed. REMOVE CUBE new_sales The following example removes the reference to the data source file for the object "general networks". If a type is not specified. REMOVE Removes an object or the reference to its data source file without deleting the actual file. The following example resets the value "Published" on the contents of the root folder to the default value specified for the folder. If a type is not specified. The following example removes the cube "new_sales" from the connected server. • the user has specified the connection to the PowerPlay Enterprise Server containing the refreshed cube Note: The optional parameter ONERROR specifies the result of the command if the update notification failed for one of the listed objects. the default for the object type: RESET BELOW / Published Enterprise Server Guide 89 . REMOVE DS CUBE "great outdoors" DS "hp_srv/great outdoors" If the object is a folder. The following example resets the value "LA" on the object "Great Outdoors" to the default value for the folder. If the operation removes all references. the default value for the object type: RESET "Great Outdoors" LA RESET BELOW Resets the properties on the contents of a folder and its subfolders. FAIL . the object is assumed to be a cube.the command is considered a failure if update notification failed for one of the listed objects. the object is assumed to be a cube. all child objects are also published. if there is no default folder. RESET Resets the selected properties on an object to the properties inherited from higher level folders. The following example invokes a cube update notification process on the refreshed cube Great Outdoors. the properties are set to the default properties for that object. The following example adds the object "Marketing" as an Upfront NewsItem: PUBLISH Marketing If the object is a folder or server.the command is considered successful if update notification is successful for at least one object.Appendix B: Batch Administration NOTIFY Invokes a cube update notification process. you must ensure that: • the refreshed cube has been copied successfully to the location as defined in PowerPlay Enterprise . REMOVE DS Removes a mirror reference from an object. the object is removed in its entirety.Server Administration. If there are no higher level folders.mdc: NOTIFY CUBE_FILE "Great Outdoors" EVENT=UPDATE PUBLISH Publishes an object to Upfront. Before calling the NOTIFY command. or. or. all child objects are also removed. The following example removes the mirror reference to "great outdoors" on the server hp_srv from the "great outdoors" cube. but not the properties of the folder itself. if there is no folder default. REMOVE PATH "general networks" If the object is a folder.

you can create a new property called "Owner" for the Great Outdoors cube.MaxProcess=5 To set a properties to apply to all of the objects on the server insert a "/" instead of an object name. use the SHOW option.Appendix B: Batch Administration SET Assigns property values to an object. The following example displays all properties for the "Sales 98" object: SHOW "Sales 98" The following example displays . This is similar to the HELP option in interactive mode. you do not need to add "force" after the object name to modify the property.MinProcess Notes To get a list of ppadmtool commands.PWQ.Control. type ppadmtool -h. and assign the value "asmith": SET "Great Outdoors" force .FLD.MaxProcess=5 You can create new properties by adding "force" after the object name. The following example sets the property "PWQ. 90 PowerPlay (R) . Properties are case-sensitive.Control.Control. This will create the new property and set the value for that property.MinProcess property for the testfolder2 object: SHOW /testfolder2 . For example.MaxProcess" to "5" on the root folder (or server): SET / . The following example sets the maximum number of processes for the Great Outdoors cube to 5: SET "Great Outdoors" .Control. To display the properties for an object.Control. You must enter the property name exactly as it is used.FLD.PWQ. SHOW Displays all the properties for the specified object.Owner=asmith After you have created a property.

The CGI and dispatcher processes may be on the same or different machines. CGI Shared The CGI program has read/write privileges for the directory. Dispatcher Temp mode offers high security at some cost in performance. Enterprise Server Guide 91 .conf file must contain an entry for PPWB_DIR. Value Description Dispatcher Only the dispatchers have read/write privileges for the directory. CGI Temp This mode requires that the CGI process have write privileges to a temporary directory. CGI Temp mode offers good performance. but should not be used in deployments requiring the highest levels of Web server security. This is the only mode that requires the system administrator to give the Web server write privileges to the temporary directory. The CGI program reads and the dispatcher program writes to the directory. Values relating to the PPWB_DIR location are shown below. Temporary File Modes The CGI and PowerPlay Enterprise Server dispatcher processes can use the temporary directory in one of three possible modes to provide maximum flexibility for directory privileges. It will only read files created by the dispatcher. If the entry is missing. but still use a shared PPWB_DIR.Appendix C: Managing Temporary Files You can manage temporary file access for the CGI and PowerPlay Enterprise Server dispatcher processes in order to customize PowerPlay security in a Web deployment. Shared Temp The CGI and dispatcher processes share the PPWB_DIR directory. The dispatcher programs called by a CGI process control the temporary directory. The CGI and dispatcher programs share the directory. Tip: You can turn on fetch temporary files for a given dispatcher with Configuration Manager. This is the default mode. Use Configuration Manager to set this property. Temporary File Access Configuration Temporary file access modes can be set within the Configuration Manager using the Temporary File Access property. the CGI process will default back to the Shared Temp mode. The CGI process fetches the results from files that the dispatcher creates and manages. The CGI process does not attempt to write temporary files when honoring requests in this mode. The ppdscgi. Dispatcher Temp This mode does not require the CGI process to have write privileges to the temporary directory.

In the General section. under Gateway. 92 PowerPlay (R) . Any mirrored server or cube in this configuration must also share the same PPWB_DIR directory. Setting the Base HREF The Web page sent to a user by PowerPlay Web Explorer consists of frames that contain URLs that are relative to the URL of the Web page. This means that the gateway and the dispatcher share the same PPWB_DIR directory. PowerPlay creates a Web page for the data and a customized toolbar. Steps 1. Steps 1. This may require additional steps in a Windows 2000 installation. 3. your Web server may not be able to access a shared drive directly. In PowerPlay Enterprise . Configuring Mirrored Servers and Cubes After a Default Installation In a default installation of PowerPlay Enterprise Server. Start the Configuration Manager 2. The Web page is stored in the temporary file location until requested by the user’s Web browser. The temporary location is the ppwb\temp directory which is normally on your Web server. Click Apply. you should set the Temporary File Access property to CGI Temp instead of the default Shared Temp. all communications related to a particular request are always passed to the same Web server. when a gateway and dispatcher are installed on the same machine. the Temporary File Access property is set to Shared Temp by default. click Properties. and the Base HREF value must be set to the name of the external server. PowerPlay uses the ppwb\temp directory on the PowerPlay dispatcher to store its temporary files. When you enable this option. modify the Remote HREF Prefix for (/ppwb) location. The Base HREF is now modified. Because the data for a PowerPlay Web Explorer report is passed to the Web browser in two parts. these URLs may be incorrect.Server Administration.Appendix C: Managing Temporary Files Fetch Temporary Files The fetch temporary files option can be used as an alternative to the sticky bit setting on your router. In certain Web-based deployments. you must enable fetch temporary files so that the temporary data is stored at the shared level of the PowerPlay server. this option ensures that the URLs for the data and customized toolbar can always be resolved. In the Fetch Files box (Options). 2. 4. click a server. Fetch Files is now enabled. 5. Click OK. Locate the Cognos PowerPlay Enterprise Server entry. PPWB_DIR for both servers must point to the same disk location. and then click the Settings tab. When PowerPlay processes requests for multiple Web servers. From the Edit menu. You can maintain better response times and a balanced load by using this option. Use the fetch temporary files option to specify which temporary file location PowerPlay Web Explorer uses when building a report. When a user requests data. where requests are handled through a router. If you use the sticky bit setting. If your server configuration includes a router. You can also use the fetch temporary files option if you have several Web servers. In this situation. regardless of which Web browser requested the report. 3. type 1.

The Select Users. and click Properties on the shortcut menu. click IUSR_<machine name>. IUSR_<machine name> is the Internet guest account for this machine. go to your installation root directory and locate the installation_location/webcontent/ppwb directory. 2. You must also add write privileges for this directory. 3. Click OK. This is the directory in which PowerPlay Web temporarily stores the output for a user request. In the Name box. click Write. 7. Steps 1. 6. If you plan to use mirroring in a Windows 2000 environment. Enterprise Server Guide 93 . Select the machine name. In the Allow column of the Permissions list. 9. and click Add. you must configure the security of the ppwb directory. Click Add. you must stop and start the Web server. In Windows Explorer. Computers or Groups dialog box appears. 5. Click OK. Right-click the directory. Click the Security tab. To reflect these changes. 8.Appendix C: Managing Temporary Files Temporary Files and Mirroring Under Windows 2000 Mirroring can be used in Windows 2000 environments for load balancing and improved resilience. 4.

Appendix C: Managing Temporary Files 94 PowerPlay (R) .

format measures. See also notification. cube.Glossary Agent A user-defined process that runs according to a schedule and evaluates specific data based on a set of conditions. the agent notifies specified recipients by email. create subset definitions. Dispatcher A machine that takes incoming user requests and directs them to an appropriate PowerPlay server for processing. object classes. Directory Server A specialized database that stores user attributes. The contents of a collection are dynamically updated with the contents of the directory. Alias A URL that has been mapped to a directory through the administration tool of a Web server. a company uses an incentive program to provide bonuses to sales representatives who exceed a weekly performance target. Also referred to as a virtual directory. or macro. levels. Collection In PowerPlay Enterprise Server. Autoregression forecasting is most reliable when the driving factors of your business affect your measures in a linear fashion. Autoregression A method of forecasting based on the auto-correlation approach to time series forecasting. Enterprise Server Guide 95 . Impromptu report. Dispatchers can be configured in a multi-machine environment for the purposes of load balancing and failover protection. Dimension Viewer An organized view of all dimensions. and categories in the selected cube. An agent can run weekly to evaluate sales data and notify the sales manager if any sales representatives exceed the performance target. Cube A multidimensional representation of data. For example. Drill Through An action that uses the current context of a report. a folder with a physical directory as a data source. Alert See notification. You can also use the dimension viewer in Windows to add categories as layers. and other schema-type information in a hierarchical format. and define sets of categories. Use the dimension viewer to add categories as rows or columns and to filter information. Used by Access Manager to store and manage user and user class data. A cube contains information organized into dimensions to provide faster retrieval and drill down in reports. to access information in another PowerPlay report. If the conditions are met.

96 PowerPlay (R) . you can use forecast to predict future values beyond that currently appearing in your window.lae). although not necessarily all of them. Mirror Reference In PowerPlay Enterprise Server.iqd) A file created by Impromptu that contains the definition for a database query. Impromptu Query Definition File (. For example. The file may contain the data. Growth forecasting is most reliable when the driving factors of your business affect your measures exponentially. MDC File A Cognos file that represents a cube. Generic User Interface PowerPlay Web Explorer interface based on generic HTML. The authentication data in a namespace consists of signon information for users. such as meeting a set of conditions defined in an agent. a mapped cube or report that forwards incoming requests to be processed on a computer other than the one where the object is added. Event An action or occurrence that a program can respond to. or be a pointer file to a third party OLAP source. measures. such as clicking a button. a log file contains information about model processing in Transformer. Growth A method of forecasting based on the exponential regression technique of time series forecasting. or server activity in PowerPlay Enterprise Server. In PowerPlay. An event can be simple. LOG File A record of the activities that take place during a computer process. Forecast A calculation of future value by using existing values on the current display. and details.Glossary Cubes with drill-through access are set up in Transformer and must match on some combination of dimensions. Enhanced User Interface PowerPlay Web Explorer interface based on enhanced Internet Explorer support. user classes. and data sources. application servers. or complex. Dynamic User Interface PowerPlay Web Explorer interface based on Dynamic HTML. Namespace A source of authentication data used by Access Manager that exists in a directory server or a Local Authentication Export file (.

or URL. Portable Document Format File (. One of two applications that make up PowerPlay Web. an entry that can contains NewsItems.ppx files in PowerPlay for Windows and PowerPlay for Excel. or dimensions depending on their access privileges. Network Address Translation An application that can translate private addresses to public addresses that can be routed on the Internet. PowerPlay for Windows. Notification An email message generated by an agent and sent to one or more recipients to provide information about a business event. You can create . PPX File See PowerPlay Portable Report File. PDF File See Portable Document Format File (.pdf) A file format that maintains the formatting of the original document. PowerCube See cube. NewsBox In Upfront. and PowerPlay for Excel.pdf file without the need for the authoring application or fonts. query.Glossary NAT See Network Address Translation. measures. For third party cubes. PowerPlay Web Viewer A Web-based application that is used for on-demand report viewing. PowerPlay Portable Report File (. PowerPlay Web Viewer renders PowerPlay Portable Reports in PDF format.ppx) A file format that can be read by any PowerPlay client. Protected Cube A cube where members of different user classes have access to specific categories. Query Processor The component of PowerPlay Enterprise Server that processes cube requests and generates results for PowerPlay Web Explorer.pdf). a pointer file stores the connection information. See also agent. NewsItem In Upfront. an entry that represents a report.mdc file that contains information about the actual data source. Enterprise Server Guide 97 . You can view and print a . One of two applications that make up PowerPlay Web. Pointer File An . PowerPlay Web Explorer A Web-based application that is used to explore multidimensional data.

Report Processor The component of PowerPlay Enterprise Server that processes report requests and generates results for PowerPlay Web Viewer. In PowerPlay for Excel. Cognos server groups are used to allow gateways to find their dispatchers. Split view A combination display of both a crosstab and a chart (pie. provide load balancing. and so on) that remain synchronized during filtering. A report consists of data selected from one or more cubes. line. bar. a report includes one or more PowerPlay worksheets and may include additional Excel sheets.When you save a report and later re-open it. Server A program that responds to commands from a client on the Internet or other network. Trend A method of forecasting based on the linear regression technique of time series forecasting. 98 PowerPlay (R) . you can open the report with the latest data from the cube. Trend forecasting is most reliable when the driving factors of your business affect your measures in a linear fashion. in some cases. and. drill down. and slice and dice operations. provide for failover. Server group A server group is an application server gateway along with its list of dispatchers.Glossary Report A document created in any PowerPlay client.

46 colors. 60 components server. 46. 23 character limit setting. 95 C cache memory. 68. 10 publishing. 13 PowerPlay. 55 column limit setting. 71 accessibility reporting solution overview.imr files. 11 Compress pages and resources. 36 privileges. 85 Java. 50 administration batch. 46. 47 Web and Windows. 47 custom buttons. 49 folders. 35.lae files. 46 defined. 81 collections adding. 79 background image file setting. 62 setting. 9. 63 . 11 Windows NT and UNIX. 78. 16 adding collections. 9. 38 titles. 40 cascading style sheets. 18 network. 85 bold settings.ppr files. 60. 14. 47 processes. 16 Cognos Query drill through. 30 access privileges setting.ppx files. 76 column names. 11 auditing audit log descriptions. 65 . 85 command line. 21 gateway. 92 batch administration. 20 compressing PDF reports. 81 Cognos Query server setting. 11 CGI Temp. 63. 18 Access Manager. 60 B background color setting. 30 daemons. 55 category codes. 19 Enterprise Server Guide 99 . 49 Reset. 18. 62. 64. 85 autoregression definition. 76 client applications connections. 43 remote. 79 byte serving. 22 MIME mapping. 20 configuring Access Manager.Index Symbols . 23 auditing level setting. 78. 45 buttons custom. 60 . 43 administrator email address setting. 77. 10 World Read. 45 settings. 30 Cognos PowerPlay Enterprise Server service. 60. 23.csv files. 77. 47 system. 46 mirror references. 52 saving sub-cubes. 29. 72 Numerics 7x24 system. 68 architecture server. 35. 36 remote data sources. 30 . 37 data sources. 16. 19 account logon privileges. 19 . 79 Base HREF setting. 13. 30 automation. 60 CGI dispatcher port. 91 challenge/response. 60 . 46 cubes and reports. 35 A access database. 24 server activity. 73 authentication.iqd files. 9. 19 accessibility support enabling. 13.mdc files. 15 Microsoft Web Server security.

2 country codes. 56 enhanced user interface definition. 15 Configuring temporary file access. 9 OLAP servers. 64 to Impromptu Web Reports. 13 Excel. 23 data sources. 13 adding. 23 100 PowerPlay ( R ) . 13 databases. 60 general considerations. 43 ticket server. 60 targets. 59 local/remote. 13 mapping. 33 multidimensional. 10. 15 data export enabling. 96 E embedded fonts. 96 Enterprise Server change the port number. 13 performance. 9 previous version. 34 Upfront. 13 location. 40 PowerCubes. 61 to details. 43 monitoring. 13 DB2 OLAP Server. 39 deleting cubes and reports. 59. 55 overriding settings. 62 to cubes. 49 deploying enterprise-wide. 13 mirror references. 21 PowerPlay servers. 51 to servers. 64 servers. 73 connections monitoring Web. 10 description setting. 49 drilling to. 13. 9 defined. 10 local/remote. and reports. 13 reports. 72 explore in Windows format setting. 70 cubes . 19 data sources cubes. 71 detail auditing. 18 PPDS_READ_MEMORY. 21 queues. 11 port.Index configuring (cont'd) PDF server. 20 port number. 45 disk cache size setting. 18 deleting. 70. 9 delay. 47 auditing. 19 explore in interactive HTML format setting. 21 Enterprise Server Administration tool. 31 Windows request. 37 PowerPlay client applications. 60 paths in Transformer. 48 overview. 2 drill through configuring in Transformer. 13 supported. 13 database. 47 partitioning. 18. 67. 9 to Impromptu. 91 connection timeout setting. 13 DB2. 63 to third party olap sources. 52 removing. 14 publishing. 65 dynamic user interface definition. 9 to PowerPlay Enterprise Server. 72 D daemons configuring UNIX. 61 local. 15 security for drill through. 40 Essbase. 31 copyright. 50 dimension line information adding to CSV file. 9. 37. 60 to Cognos Query. 37 testing. 51 secured. 39 document version. 54 discover servers. 47 moving. 15 Dispatcher Temp. 18 distributed processing. 49 searching. 29 Windows NT services. 45 Web request. 13 Define. 53 environment variables checking NT. 30 Transformer. 43 publishing. 36 overview. 91 displays customizing. 31.mdc files. 49 dimension viewer definition. 55 cube mirror references setting. 19 CSS. 60 location. 37 monitoring Windows. 46 disabling a Table of Contents. 70 dispatcher central. 70 cube source setting. 23 dimension line. cubes. 95 directories referenced by collections.

81 Impromptu Web Reports drill through folder setting. 34 defining. 53 Font support within PDF generation. 54 load balancing. 33 local cubes. 30 Monitor view. 77. 35 mobile users. 54 licensed fonts permission to embed. 37. 13 SSAS. 91 mapping cubes. 49 L languages enable user settings. 67 generic user interface definition. 22 folder mirror references setting. 72 grid color setting. 47 defined.Index Explore view. 96 J JavaScript custom buttons. 92 firewalls. 13 I IBM DB2. 40 Microsoft Excel. 64 Impromptu Web Reports. 19 minimum processes defined. 78 linked items. 20 fonts embedding. 52 table of contents. 71 folders adding. 22 image setting. 45 logon privileges. 46 publishing. 47 deployment. 33 moving cubes and reports. 37 Hyperion Essbase. 76 link color setting. 13 IBM DB2 OLAP Server. 11 setting. 55 item limit setting. 46 defined. 74 locale settings. 44 idle process setting. 57 lightweight PDF generation setting. 32 H hits. 9 overview. 74 IIS. 82 Informix. 33 mirrored servers configuring. 96 M Managing temporary file. 10 Internet Information Server. 92 mirroring Windows 2000 issues. 46 dynamically updated. 10 local process threshold setting. 96 get data setting. 22 SQL Server Analysis Services. 76 F fetch files setting. 78 imported reports folder publishing. 73 mirror references adding. 63 setting. 23. 47 G gateway CGI. 38 setting. 14. 47 maximum processes defined. 19. 36 Mount at. 13 Enterprise Server Guide 101 . 54 logging. 31. 13 icons. 56 licensed. 34 setting. 43 Export PDF settings. 68 Impromptu. 82 Impromptu Web Reports server setting. 57 forecast definition. 73 Maximum Restrict Client Connections setting. 21. 78 growth definition. 77. 48 multiple server groups. 21 defined. 53 links copying. 68 Fetch Temporary Files. 43 monitoring processes. 52 setting. 71 folder source setting. 69 memory cache size processes. 13 MIME types.

20 performance. 43 starting. 13 port changing. 36 overview. 97 O OLAP. 10 PowerPlay Portable Reports . 31. 43 ppwbcustom. 34 balancing load.sh. 29 pasting cubes and reports. 36 pprp. 72 parent setting. 31 cache size. 37 PowerPlay Connect. 56 publishing. 13 P page by page report serving setting.ppx files. 52 ppadmtool. 52 PowerPlay Web Viewer defined.css. 9 defined. 14 PowerPlay server group setting. 14. 31 distributed. 70. 97 Netscape Administration Server. 16 Web or Windows. 39 102 PowerPlay ( R ) . 16 PowerPlay for Excel. 10 font substitution. 36 new. 10 PowerPlay for Windows. 28 pointer files. 81 PowerPlay Enterprise . 15 network address translation definition. 75 nat definition. 16. 71 namespace. 20. 60 UNC. 23 network. 19 Print Settings report. 28 PowerPlay Web Explorer customizing displays. 14 processes adding. 17 PowerPlay server setting. 31 remote. 10. 22 PowerPlay client applications. 72 paper size setting. 36 maximum. 43 monitoring. 49 ppweb. 71 passwords defining server. 23. 22 ppdsweb. 30 setting. 21 restricting outgoing. 23 ppsrvadm. 22 Performance Monitor. 13. 50 ppsrv. 38 available.exe. 30 overriding. 9. 36 ppes_audit. 22 dispatcher. 36 Ppservertemp. 55 privileges challenge/response. 48 paths drill through in Transformer. 18 preferences enable user settings.exe. 13 PowerPlay Server cleanup. 55 printing reports settings. 76 PDF compressed pages and resources.Index N name setting. 69 page orientation setting. 21 setting. 31 PowerPlay Web defined. 10 publishing. 33 scheduling. 81 PowerPlay Server (Web Edition). 10 PowerPlay Web cube performance object. 13. 36 ppdsweb. 43 PowerPlay Enterprise Server starting/stopping. 55 defined. 67 Windows. 85 ppdscgi. 36 Windows NT. 32 PPSRoot. 28 PowerPlay service set user logon. 72 page compression factor setting. 37 defined. 37 pprp. 21 changing for Windows connections. 69 page compression threshold setting.log. 20 PDF server configuration. 38 minimum. 40 dedicated. 20 Pdf Generation font support within.js. 13 PowerPlay cubes setting. 70.log. 81 PowerPlay server performance object. 39 instances.conf. 15 Directory Server. 9 defined. 47 pattern simulation setting. 34. 47 UNIX.cfx.Server Administration. 54 numeric and currency format. 34 monitoring.

15 connecting. 19 remote cubes. 48 overview. 11 row limit setting. 75 scripts. 47 auditing. 74 screen resolution setting. 31. 68 Server administration. 71 reset all setting. 38 report source setting. 37 queued request timeout setting. 51 See also accessible reports. 67 security Microsoft Web Server. 45 publish to a table of contents setting. 38 query processor component. 30 scheduling threshold setting. 69 restricting embedded HTML content in titles. 13. 38 Q queries as drill-through targets. 76 runaway queries. 69 properties bold. 31 dedicated. 71 resetting descendants. 38 reset setting. 74 publish to Upfront setting. 29 user classes. 35 dedicated. 52 removing. 38 S SAP BW.Index processors busy. 62 runaway. 70 report processor component. 71 reset descendants setting. 13 security. 23 overview. 10 removing cubes and reports. 23 data sources. 67 resource compression factor setting. 67 servers configuring PowerPlay. 31 defined. 34 defined. 73 queues. 72 saving sub-cubes. 67 server name setting. 9. 11 limiting processing time. 9 reports. 16. 38 usage. 37. 52 reports (cont'd) searching. 15 Server administration. 38 routing. 36 product version. 85 searching cubes and reports. 11 limiting processing time. 73 requests queued. 51 secure sockets layer (SSL). 37. 45 resource (/ppwb) location setting. 73 reports accessibility. 68 selection of preferences setting. 69 resources available. 30 to Upfront. 49 embedded fonts. 22 network. 11 limiting time. 13 save as PowerCube setting. 14 routers using with dispatchers. 49 Enterprise Server Guide 103 . 19 adding. 77 report mirror references setting. 31. 15 Server groups. 38 Restrict Connection Idle Timeout setting. 2 Prompts for User Class setting. 74 publishing folders. 21 server. 50 retaining cubes from a previous version. 49 report banner setting. 37 defined. 32 server mirror references setting. 13 deleting. 19 request timeout setting. 45 R regional settings. 52 new data. 52 moving. 47 publishing. 9 security dialog box setting. 70 report timeout setting. 56 imported.

91 CGI Temp. 45 IIS. 50 setting. 75 Upfront NewsBox for reports setting. 47 Upfront administration. 91 Temporary file access configuring. 77. 18 sub-cubes disabling. 37 sorting objects. 15 logging to system directories. 52 Upfront gateway setting. 71 Transformer. 26 user interface. 75 Upfront server setting. 16 status monitoring. 75 Upfront server group setting. 75 Upfront publish template setting. 43 PowerPlay Enterprise Server. 92 settings bold. 77. 14. 78 W Web reports testing. 23 Sybase. 91 temporary file deletion interval setting. 68 Temporary file managing. 68 testing connections. 35 security for mirroring. 2 T Table of Contents disabling. 91 sharing enabled for mirror references. 53 temporary directory clean-up interval setting. 51 text color setting. 75 upgrading. 47 starting/stopping. 48 setting. 48 sockets. 65 ticket server. 19 showing. 91 Shared Temp. 35 104 PowerPlay ( R ) . 22 monitoring activity. 15 data store. 53 publishing. 39 style sheets. 16 services Cognos PowerPlay Enterprise. 78. drilling through. 39 discovering. 51. 43 split view definition. 43 stopping PowerPlay Enterprise Server. 16. 72 shortcuts. 69 table of contents preventing. 98 U UNC paths.Index servers (cont'd) defining passwords. 75 Upfront NewsBox for cubes setting. 91 Dispatcher Temp. 54 setting. 16 configuring Windows NT. 13 starting Enterprise Server Administration tool. 15 deployment. 15 linked items. 64 configuring. 69 Temporary file modes. 36 starting/stopping. 16 requests. 55 Shared Temp. 9 dispatcher. 29 disable. 29 title report. 91 temporary files location setting. 14. 60 transparency setting. 98 SQL Server Analysis Services. 16 Setting the base HREF. 51 Windows 2000 mirroring considerations. 30 summary auditing. 79 trend definition. 45 Export PDF. 13 third party OLAP sources. 54 regional settings. 15. 14 usage statistics viewing. 43 V version product.