Tip or Technique

Installation Methods for Contributor Web Client

Product(s): IBM Cognos Planning 8.1 and prior Area of Interest: Infrastructure

Installation Methods for Contributor Web Client

Copyright Copyright 2008 Cognos ULC (formerly Cognos Incorporated). Cognos ULC is an IBM Company. While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in this document. This document shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to the information contained in this document will be documented in subsequent editions. This document contains proprietary information of Cognos. All rights are reserved. No part of this document may be copied, photocopied, reproduced, stored in a retrieval system, transmitted in any form or by any means, or translated into another language without the prior written consent of Cognos. Cognos and the Cognos logo are trademarks of Cognos ULC (formerly Cognos Incorporated) in the United States and/or other countries. IBM and the IBM logo are trademarks of International Business Machines Corporation in the United States, or other countries, or both. All other names are trademarks or registered trademarks of their respective companies. Information about Cognos products can be found at www.cognos.com This document is maintained by the Best Practices, Product and Technology team. You can send comments, suggestions, and additions to cscogpp@ca.ibm.com .

Cognos Proprietary Information

Installation Methods for Contributor Web Client

Contents
1 1.1 1.2 1.3 2 2.1 2.2 2.3 2.4 2.5 INTRODUCTION ............................................................................................ 4 PURPOSE ............................................................................................................4 APPLICABILITY .....................................................................................................4 EXCLUSIONS AND EXCEPTIONS ..................................................................................4 INSTALLATION METHODS CONTRIBUTOR WEB CLIENT ........................... 4 OVERVIEW: .........................................................................................................4 1- AUTOMATIC DOWNLOAD ......................................................................................4 2- INSTALL EACH WORKSTATION INDIVIDUALLY ..............................................................4 3- AUTOMATED UNATTENDED INSTALLATION..................................................................4 4- USING A 3RD PARTY SOFTWARE ..............................................................................7

Cognos Proprietary Information

Installation Methods for Contributor Web Client

1 Introduction
1.1 Purpose This document discusses the different alternative methods for installing the Contributor Web Client onto a users workstation. . Applicability IBM Cognos Planning Contributor 8.1 and prior Exclusions and Exceptions No exclusions identified

1.2

1.3

2 Installation Methods Contributor Web Client

2.1 Overview: There are multiple ways to install the Web client. 1. Automatic Download of the web client via ActiveX. 2. Install each workstation individually using the IBM Cognos Contributor Software CD 3. Automated unattended installation 4. Using a 3rd party software to install the Web client (ie MS SMS) 2.2 1- Automatic Download After Contributor has been installed and configured on the Web server, the 1st time a user goes to the Web site, it will automatically download the required software using ActiveX. This requires that the user has Admin rights on their PC to install software. (And have signed activeX controls enabled for either prompt or enable within IE) 2.3 2- Install each workstation individually Install the software from the Contributor CD. The order for installation is Full Client 1st then any additional extensions. The Client software can be found in the \Contributor Web Client Software folder on the CD. 2.4 3- Automated unattended installation The automated process includes running multiple batch files that will install the Contributor Web Client and extensions onto a workstation. The automated installation requires; a) Modifying the response.ats file that is included on the CD for each component and saved to a separate location o This allows complete control for where the software will be installed and appropriate company information. o If you do not require modifying the information, you can use the Silent.ats file. This will install the software into the default folders b) Running command line argument that will install the software.

Cognos Proprietary Information

Installation Methods for Contributor Web Client

Example: Go to the \Contributor Web Client Software\Full Client\Cognos\ep_fullclient on the CD and edit the response.ats file as shown below, rename and save to a different location: Fullclient_Install.ats
[Dialog3] Title=User Information USERREGNAME=Cognos Customer COMPANYREGNAME=Cognos Inc. [workstation] allow=0 [Dialog6] Title=Installation Location APPDIR=C:\Program Files\Cognos\cer4 PUBSDIR=C:\Program Files\Cognos\cer4\documentation TOURDIR=Not Available SAMPLESDIR=Not Available [Dialog7] Title=Shortcut Folder APPFOLDER=Cognos Planning - Full Client ALLUSERS_FLAG=1 [Component List] EP_FULLCLIENT_VERC=1 [Install Conditions] RebootSystem=0 Possible required changes: Correct user and company name details Local paths to be used for installation

Command line Example: C:\>"C:\ Contributor\Contributor Web Client Software\Full Client\Cognos\ep_fullclient\issetup.exe" /s "C:\ATS_FILES\ Fullclient_Install.ats" Excel Export Extension ATS
Excel_Export.ats [Dialog3] Title=User Information USERREGNAME=Cognos Ltd. COMPANYREGNAME=Cognos Ltd. [workstation] allow=0 [Dialog6] Title=Installation Location APPDIR=C:\ C:\Program Files\ Files\Cognos\ Cognos\cer4 PUBSDIR=C:\ C:\Program Files\ Files\Cognos\ Cognos\cer4\ cer4\documentation TOURDIR=Not Available SAMPLESDIR=Not Available [Dialog7] Title=Shortcut Folder APPFOLDER=Cognos Planning - Full Client ALLUSERS_FLAG=1

Cognos Proprietary Information

Installation Methods for Contributor Web Client

[Component List] EP_EXTXLP_VERC=0 [Install Conditions] RebootSystem=0
Possible required changes: Correct user and company name details Local paths to be used for installation

Excel_Print.ats
[Dialog3] Title=User Information USERREGNAME=Cognos Ltd. COMPANYREGNAME=Cognos Ltd. [workstation] allow=0 [Dialog6] Title=Installation Location APPDIR=C:\ C:\Program Files\ Files\Cognos\ Cognos\cer4 PUBSDIR=C:\ C:\Program Files\ Files\Cognos\ Cognos\cer4\ cer4\documentation TOURDIR=Not Available SAMPLESDIR=Not Available [Dialog7] Title=Shortcut Folder APPFOLDER=Cognos Planning - Full Client ALLUSERS_FLAG=1 [Component List] EP_EXTXLP_VERC=0 [Install Conditions] RebootSystem=0

Possible required changes: Correct user and company name details Local paths to be used for installation Sample Bat file to install Full Client, Excel Export and Excel Print Contributor_Web_Install.bat REM This script will perform an unattended installation of Contributor Web Components using the options specified in the defined .ats file. "D:\Software\Contributor\Contributor Web Client Software\Full Client\Cognos\ep_fullclient\issetup.exe" /s "C:\Location of .ATS file\Fullclient_Install.ats" REM The next two steps will install the two optional Excel Extensions REM Export to Excel "D:\Software\Contributor\Contributor Web Client Software\Extension Excel Export\Cognos\ep_extxlexp\issetup.exe" /s "C:\Location of .ATS file\Excel_Export.ats"

Cognos Proprietary Information

Installation Methods for Contributor Web Client

REM Print to Excel "D:\Software\Contributor\Contributor Web Client Software\Extension Excel Print\Cognos\ep_extxlp\issetup.exe" /s "C:\Location of .ATS file\Excel_Print.ats" Possible required changes: Location of the Full Client issetup.exe which can be found on the Cognos Contributor CD, \Contributor Web Client Software\Full Client\Cognos\ep_fullclient\. Location of the Export to Excel issetup.exe which can be found on the Cognos Contributor CD, Contributor Web Client Software\Extension Excel Export. Location of the Print to Excel issetup.exe which can be found on the IBM Cognos Contributor CD, Contributor Web Client Software\Extension Excel Print. 2.5 4- Using a 3rd party software We do not write any package for use with a given software distribution application. However, some clients may find it easier to use just an install exe then to build an distribution using the CD files that we provide. To get the install exes, you must already have the Contributor Server software installed on a machine. On the contributor server; Go to \Program Files\Cognos\cer4\webcontent\contributor\CONTROLS folder. Extract the Exe files out of the following cabs, ClientFull73.CAB , ExtExcelExport.CAB and ExtExcelPrint.CAB. Install 1. 2. 3. the Software in the following order ClientFull73.EXE ExtExcelPrint.EXE ExtExcelExport.EXE

This will install Full Client and the Excel extensions (Print and export).

Cognos Proprietary Information