...

Understanding the New Contributor Web Grid Proven Practice

by user

on
Category:

local news

1

views

Report

Comments

Transcript

Understanding the New Contributor Web Grid Proven Practice
Proven Practice
Understanding the New
Contributor Web Grid
Product(s): IBM Cognos Planning Contributor 8.4
Area of Interest: Infrastructure
Understanding the New Contributor Web Grid
2
Copyright and Trademarks
Licensed Materials - Property of IBM.
© Copyright IBM Corp. 2009
IBM, the IBM logo, and Cognos are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies. A
current list of IBM trademarks is available on the Web at
http://www.ibm.com/legal/copytrade.shtml
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. IBM does not accept responsibility for any kind of loss resulting from the use of
information contained in this document. The information contained in this document
is subject to change without notice.
This document is maintained by the Best Practices, Product and Technology team.
You can send comments, suggestions, and additions to [email protected]
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft
Corporation in the United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks of Sun Microsystems,
Inc. in the United States, other countries, or both.
IBM Propriatary
Understanding the New Contributor Web Grid
3
Contents
1
INTRODUCTION ............................................................................................ 4
2
INSTALL ROUTINES ...................................................................................... 4
2.1
2.2
2.3
2.4
A DIRECT DOWNLOAD FROM THE CONTRIBUTOR WEB SITE ................................................. 4
INSTALLED VIA THE PLANNING CLIENT MEDIA ................................................................. 9
INSTALL ON IBM COGNOS 8 PLANNING SERVERS ............................................................ 9
PUSHED TO END USER MACHINES USING THE .MSI FILES .................................................... 9
3
WINDOWS SECURITY REQUIREMENTS ...................................................... 10
4
MODIFYING DEFAULT SETTINGS................................................................ 11
5
LOGGING ..................................................................................................... 12
IBM Propriatary
Understanding the New Contributor Web Grid
1
4
Introduction
The purpose of this document is to provide insight into the technology and
settings used with the new Contributor Eclipse based grid.
2 Install Routines
The new Contributor grid is built in Java using Eclipse (for more information
about Eclipse see http://www.eclipse.org). There is no longer a reliance on
ActiveX components, nor are there any COM registrations required.
A framework is built during installation, the Cognos Rich Client Platform
(CognosRCP). There is also a JRE and a provisioning agent installed.
The provisioning agent requires a new virtual directory. This is included
within the Cognos8/webcontent/contributor location.
The provision agent check for updates each time an open occurs. The agent
looks for updates to the client or updates to the Contributor Web site and
applies them.
There are four methods to deploy or install the Contributor grid.
2.1
A direct download from the Contributor Web site
This is the most common approach and has the lowest IT requirement. A
user opens the Contributor Web application and the install is initiated
automatically.
End users installs using the Web site download can be controlled from within
the Contributor Admin Console (CAC). Any changes are global changes
affecting all users for all applications.
In the CAC, select System Settings. Click the Web Client Settings tab. Select
the Allow automatic download and installation check box to allow the RCP to
be installed.
You can also select the Allow automatic client software updates check box to
allow the Provisioning agent to install/update the Planning client.
IBM Propriatary
Understanding the New Contributor Web Grid
5
If required, administrators can control the download and updates
functionality on an individual basis by changing settings on the end user’s
computer.
To change these settings, modify the CognosRCPStartup_NOT.ini file located
in the C:\Documents and Settings\<user>\Application Data\CognosRCP\rcp
folder.
Rename the Cognos RCPStartup_NOT.ini file to CognosRCPStartup.ini.
Within the Automatic Application Updates section of the CognosRCPStart.ini
file modify the pa-provagent-no-update and the pa-app-no-update settings to
true. This denies the user access to automatically update either the client or
the provisioning agent.
### AUTOMATIC APPLICATION UPDATES
### Specify that the provisioning agent is not to update itself.
pa-provagent-no-update=true
### Specify that the application is not to update (or install) itself
pa-app-no-update=true
You can require the use of the classic ActiveX client at an application level.
This is accomplished within the Go To Production Options. This setting is
applied for all users of the application.
The classic client and the new rich client can co-exist on the same computer.
The classic client is essentially the same client as version 8.3, so elevated
permissions are still required to install.
IBM Propriatary
Understanding the New Contributor Web Grid
6
When accessing the node tree from the Web site this information is now held
server-side, and does not require the rich-client to view.
Due to the fact the node tree is now held server side you can control the
node state refresh rate. This is defined in the CAC under Development >
Web-Client Configuration > Application Options.
IBM Propriatary
Understanding the New Contributor Web Grid
7
When you first try and access a node you are prompted to install the Client
Framework.
It opens the CognosRCP.msi installer package. You have the option to run or
save. This will also install the Contributor Components required for the Grid.
IBM Propriatary
Understanding the New Contributor Web Grid
Internet Explorer may ask permission to run the software; this is part of the
update from the provisioning agent. Contributor is installed as a plug-in on
top of the rich client platform.
If the install is successful you are prompted with a reminder to restart your
browser to ensure a successful install takes place.
IBM Propriatary
8
Understanding the New Contributor Web Grid
9
Once you restart your the browser, the next attempt to open a node will
trigger the install of the planning client using the provisioning agent.
2.2
Installed via the Planning Client media
This method requires the media to be copied to a location accessible by end
users. Users run iissetup.exe from within the Cognos_8_Planning_Client
media location.
Installing from the Client Media provides options to install the new grid, the
ActiveX grid as well as the Excel Add-On. For those users who do not wish to
move to the Eclipse based grid using the ActiveX grid is an option.
If the administrator requires modification to the download, or update
functionality for the grid, please view the section above explaining how to
manipulate those settings.
2.3
Install on IBM Cognos 8 Planning Servers
When installing either the Server or Administration tools install of IBM Cognos
8 Planning the Web Grid components are automatically installed, and no
further changes are required to enable the web grid.
2.4
Pushed to end user machines using the .msi files
IBM Propriatary
Understanding the New Contributor Web Grid
10
Installing using a “push” requires the use of the CognosRCP.msi and
contributor.msi files found in the <install>c8\webcontent\rcp_installs
directory. You need to use the MSIEXEC command line.
This type of install allows the administrator to automatically control the
update settings mentioned above by manipulating the NOUPDATE and
NOJUMPSTART switches. The switches you can use are:




TARGETDIR (target directory)
ALLUSERS (all users can use the client)
NOUPDATE (Provisioning agent does not check for updates)
NOJUMPSTART (small utility installed in the windows startup folder, for
quicker launch of the client)
3 Windows Security Requirements
Because the install goes to the %userprofile% > application data directory,
and there are, no DLLs to be registered, no COM registrations, and no
ActiveX components and there is no requirement for administrator access.
Small registry entries are made to HKEY_CURRENT_USER key which adds the
.cogrcp file association.
If you install for ALLUSERS, inflated permissions are required as a registry
key is written to HKEY_LOCAL_MACHINE to create the .cogrcp file
association.
The CogRCP file type is associated with the JRE on installation. If this isn’t
automatically associated you may do so yourself.
IBM Propriatary
Understanding the New Contributor Web Grid
4 Modifying default settings
Persistent setting can be controlled on an application level from within the
CAC. Persistent setting determines if the layout of the Web grid will be
retained locally or on the server.
IBM Propriatary
11
Understanding the New Contributor Web Grid
12
Within the C:\Documents and Settings\Administrator\Application
Data\CognosRCP\temp\provagent_8.4 directory a run time file is created. Its
typical name is cogrcp_<date/time>.cogrcp
The file contains the runtime settings of the provisioning agent. It can also be
modified to change any current runtime setting such as the persist Web client
settings.
This file can be used to open the Contributor Grid by simply double clicking it.
Because of the Java File association made earlier you now have the ability to
use the file to go directly to the model.
When a node is clicked, a cogrcp file is generated by the server and sent to
the client machine which runs the file.
To keep these files from being deleted, see the .cogrcp section of the
CognosRCPStartup_NOT.ini file.
5 Logging
Use of the PlanningErrorlog.csv file still occurs and is in the same location as
earlier releases.
CognosRCPStartup_NOT.ini file contained in the: C:\Documents and
Settings\Administrator\Application Data\CognosRCP\rcp is well documented,
and can be used to enable logging and debugging
To turn on logging the file, rename the file by removing the _NOT and then
uncomment the #.
### "debug=true" causes the logs to be saved always.
###
pa-debug=true
IBM Propriatary
Understanding the New Contributor Web Grid
13
###
### "pa-no-delete-logs=true" also causes the logs to be saved.
pa-no-delete-logs=true
Provisioning agent logs will be written to %userprofile%/application
data/cognosrcp/logs/provoagent_8.4.
The provoagent_8.4 logs displays any steps taken by the Provisioning Agent
such as updating the application.
Within the …\application data\CognosRCP\rcp directory there is a log
collecting utility installed called cognosRCPLogCollector.cogrcp.
The provisioning agent and applications installed by the provisioning agent
can create a number of different log file scattered across the file system.
The purpose of the log collector is to put all of those logs into one archive so
that users can easily forward the logs to their support organizations.
Logs are created in the following subdirectories:
$userprofile directory
$temp directory: userprofile/local setting/temp
$appdata directory – available as the APPDATA environment variable,
normally $userprofile/application data
IBM Propriatary
Understanding the New Contributor Web Grid
14
$install directory – normally $app data/cognosrcp
The log collector expects that the provisioning agent has been installed in the
standard location - $appdata/cognosrcp.
To use the log collector, open the log collector by double-clicking the
CognosRCPlogcollector.cogrcp file. The archive is created in the
%temp%/cognosrcplogcollector_time_date.zip file.
The zip contains the planningerrorlog.csv file, as well as any workspace logs,
(cognosrcp) and provisioning agent logs.
NOTE: The file will contain past log files as well as a new one is created each
day the grid is open.
IBM Propriatary
Fly UP