Cognos Installation and Configuration Guide Of

Analytics
Version 1.0

Envision Enterprise Solutions Pvt. Ltd.

CONFIDENTIALITY: The contents of this proposal represents intellectual effort from Envision, and are confidential and bound by
copyright laws. No part of this proposal other than information which has been based on the document supplied by the recipient, or in
public domain, may be divulged to any third party without a written consent from Envision. This proposal is an intellectual property and
hence you are notified that any review, copying, or distribution is strictly prohibited.

Confidential @2018 Envision All rights reserved Page 1 of 37

  Open the path of the cognos analytics page and right click on the Analytics Application
and run as administrator as shown below.

 Click Next

Confidential @2018 Envision All rights reserved Page 2 of 37

  Select the preferred installation and Click Next

Confidential @2018 Envision All rights reserved Page 3 of 37

  Select I Accept and Click Next

 Click Next.

Confidential @2018 Envision All rights reserved Page 4 of 37

  Click Yes and then Next.

 Select the type of installation and Click Next.

 Provide the user credentials and Click Next.

Confidential @2018 Envision All rights reserved Page 5 of 37
  Click Install.

Confidential @2018 Envision All rights reserved Page 6 of 37

  Click Done.

Confidential @2018 Envision All rights reserved Page 7 of 37

  Analytics Samples Installation.

 Click Next.

Confidential @2018 Envision All rights reserved Page 8 of 37

  Check I Accept and Click Next.

 Click Next.

Confidential @2018 Envision All rights reserved Page 9 of 37

  Click Yes.

Confidential @2018 Envision All rights reserved Page 10 of 37

  Click Install.

 Click Done.

Confidential @2018 Envision All rights reserved Page 11 of 37

  Framework Manager Installation.

Confidential @2018 Envision All rights reserved Page 12 of 37

  Click Next.

 Select I Accept and Click Next

Confidential @2018 Envision All rights reserved Page 13 of 37

  Click Next

Confidential @2018 Envision All rights reserved Page 14 of 37

  Click Yes and Click Next

 Click Install.

Confidential @2018 Envision All rights reserved Page 15 of 37

  Click Done.

Confidential @2018 Envision All rights reserved Page 16 of 37

  Login to Maximo
Create a new user “cognos” from users application.

 Then grant database access to the user for tables below.

grant select on MAXIMO.MAXUSER to cognos;

grant select on MAXIMO.GROUPUSER to cognos;
grant select on MAXIMO.PERSON to cognos;
grant select on MAXIMO.MAXGROUP to cognos;
grant select on MAXIMO.MAXPROPVALUE to cognos;

 If you are using DB2, the new MXCSP database user must also be an Operating System
(OS) User. The DB2 user must first be added as an OS user before adding them as a
database user.

 Copy
C:\IBM\SMP\maximo\reports\cognos\c11\configuration\mxcognosdatasources.prop
erties (SMP path) file to
C:\Program Files\IBM\cognos\analytics\configuration folder and edit the file content
like below and save.

maximoDataSource.url = jdbc:db2://192.168.2.234:50005/MAXDB76
maximoDataSource.driver = com.ibm.db2.jcc.DB2Driver

Confidential @2018 Envision All rights reserved Page 17 of 37

 maximoDataSource.username = maximo (user name of db)
maximoDataSource.password = <a valid password for above username>
maximoDataSource.schemaowner = MAXIMO

 Copy following files to C:\Program Files\IBM\cognos\analytics\webapps\p2pd\WEB-

INF\lib folder.

C:\IBM\SMP\maximo\applications\maximo\lib\db2jcc.jar
C:\IBM\SMP\maximo\applications\maximo\lib\db2jcc_license_cu.jar
C:\IBM\SMP\maximo\reports\cognos\c11\webapps\p2pd\WEB-
INF\lib\CAM_AAA_MXCSP.jar

 Create a content store in Cognos Configuration (Delete the existing Content store).
 Right click on the content store and generate ddl. Then execute the commands from the
file and create a new database to connect in cognos.

 Please find the attached DDL command for Analytics.

DDL Commands.txt

 Open Cognos Configuration and set Allow anonymous access to False.

Confidential @2018 Envision All rights reserved Page 18 of 37

  Right click on Authentication > New resource > Namespace (Delete the existing
Namespace).

 Config maximo namespace as following.

Confidential @2018 Envision All rights reserved Page 19 of 37

  Config URIs as shown below.

 Save the Config changes and start the Cognos service.

Confidential @2018 Envision All rights reserved Page 20 of 37

  While starting the cognos server if you get an error as this (Cognos does not do a clean
start. This error occurs
'com.cognos.pogo.config.HandlerFactory', 'pogo', 'Failure'.DPR-DPR-1035
Dispatcher detected an error.)

Then, add these(xbean.jar, xbean_xpath.jar) jar files this folder(C:\Program

Files\IBM\cognos\analytics\webapps\p2pd\WEB-INF\lib) to overcome the error.

 Once the cognos server is started as shown below.

Confidential @2018 Envision All rights reserved Page 21 of 37

  Sign In to Maximo with maxadmin user. Open System Configuration > Platform
Configuration > System Properties app
and set the properties like below. Save the properties and click Live Refresh action to
apply change settings.

mxe.report.cognos.content.store.package.location = PUBLIC
mxe.report.cognos.datasource = MXDB
mxe.report.cognos.db.schemaName = MAXIMO
mxe.report.cognos.db.type = DB2
mxe.report.cognos.maxappurl = http:// 10.6.0.77:9080/maximo
mxe.report.cognos.namespace = maximo
mxe.report.cognos.serverURL = http://10.6.0.77:9300/bi/v1/disp
mxe.rest.webappurl = http://10.6.0.77/maxrest
mxe.report.cognos.querymode = compatible

Confidential @2018 Envision All rights reserved Page 22 of 37

  Open Administration > Report Administration app and select Cognos Analytics from
More Actions (make
sure to turn off the popup blocker in your browser).

Confidential @2018 Envision All rights reserved Page 23 of 37

  Go to Manage and click on Adiministration Console

 Open Security tab and click maximo directory.

Confidential @2018 Envision All rights reserved Page 24 of 37

  Verify your maximo Security Groups and Users are listed there.

 Click on the Configuration tab and highlight Data Source Connections.

Confidential @2018 Envision All rights reserved Page 25 of 37

  Click on the new Data Source Icon . Enter the name of your database used in
mxe.report.cognos.datasource in UPPERCASE.

 Select the Type of data source and Click Next.

Confidential @2018 Envision All rights reserved Page 26 of 37

  Enter the name of the database that is connected to your maximo.

 Make sure that the signon is checked and enter the user name and password of your
database and click on test the connection.

Confidential @2018 Envision All rights reserved Page 27 of 37

Confidential @2018 Envision All rights reserved Page 28 of 37
  If you get an error as above during your data source connection, create an ODBC
connection and the try to connect. By default, it will take db2 instance(50000).

Confidential @2018 Envision All rights reserved Page 29 of 37

  Click Finish.

 Open Cognos Analytics.

 Click New Folder button to create a PUBLIC folder.

 Create C:\cognos\My Projects\Metadata folder for project base.

 Open MXCOGNOS End point and set property values like following.

Confidential @2018 Envision All rights reserved Page 30 of 37

  Open MAXADMIN record in Security > Security Groups app and grant access
Cognos Reporting option to the Object
Structures app. Finally save the record.

 Copy cognosaxis.jar and cognosClient.jar files from

C:\IBM\SMP\maximo\reports\cognos\c11\sdk to C:\Program Files
(x86)\ibm\WebSphere\AppServer\lib.

Confidential @2018 Envision All rights reserved Page 31 of 37

  Sign Out from Maximo and login to WebSphere Integrated Solutions Console and restart
the MXServer.

 Publishing a package:

 Sign In to Maximo with maxadmin user, open Integration > Object Structures
app for Consumed By
filter then enter reporting.

 Open REP_ITEM Object Structure and select Publish as Cognos Package from Select
Actions.

Confidential @2018 Envision All rights reserved Page 32 of 37

  Copy C:\IBM\SMP\maximo\reports\cognos\Packages\DB2_Oracle\PublicMX76.zip
file to C:\Program Files\IBM\cognos\analytics\deployment
folder.
 Launch the cognos configuration from Report Administrator and highlight the Content
Administrator.

 Then click New Import .

 Click Next.

Confidential @2018 Envision All rights reserved Page 33 of 37

  Click Next.

Confidential @2018 Envision All rights reserved Page 34 of 37

  Click Next.

 Check Your Specifications and Click Next.

 Click Finish.

Confidential @2018 Envision All rights reserved Page 35 of 37

  Click Run.

 Confirm the imported package and click IBM Cognos Connection from Launch link.

Confidential @2018 Envision All rights reserved Page 36 of 37

  Copy all image files from C:\IBM\SMP\maximo\reports\cognos\images folder to
C:\Program Files\IBM\cognos\analytics\webcontent\samples\images folder.

Confidential @2018 Envision All rights reserved Page 37 of 37