Product:
Cognos Analytics 11.0.7
Microsoft Windows 2012 R2

Problem:
When you inside Cognos Administration on Dynamic Cubes click on “properties” for a specific cube you get a error.
If you surf direct to the dispatcher on port 9300, and do the same thing inside Cognos Connection you do not get a error. Therefor the error is with IIS. Check the windows event log for more details:

Error message:
An unhandled exception has occurred.
/ibmcognos
C:\Program Files\ibm\cognos\analytics\webcontent\
w3wp.exe
IIS APPPOOL\ICAPool
HttpException
The length of the query string for this request exceeds the configured maxQueryStringLength value. at System.Web.HttpRequest.ValidateInputIfRequiredByConfig() at System.Web.HttpApplication.PipelineStepManager.ValidateHelper(HttpContext context)

Solution:
Withing IIS Default Web Site > ibmcognos > bi

Click on ‘Configuration Editor’

Select Section ‘system.web/httpRuntime’
set the following attribute setting –

maxQueryStringLength = 2048 -> 8192
maxRequestLength = 4096 -> 8192

Restart IIS

More information:
https://www.ibm.com/support/knowledgecenter/en/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/t_gateway_iis.html

Adjust request size limits. (Sometimes this settings does not work and you need to edit as above).
Select the bi directory under the ibmcognos application created earlier.
Double-click Request Filtering.
Click Edit Feature Settings… from the right-hand panel.
Set Maximum URL length (bytes) to 8192.
Set Maximum query string (bytes) to 8192.
Click OK.

Product:
Cognos BI 10.2.2
Microsoft Windows 2012 R2 Server
Problem:
In a Active Directory Domain and Forrest, when we try to add AD groups to the internal Cognos groups in Cognos Connection – Administration – Security, we can not see all groups.
Solution:
AD Domain Local Groups can only be seen if they are in the same sub-domain as the Cognos Content Manager server. If the Cognos CM server is in a different domain than the DLGroup, it is not visible.

You should create a Cognos security group for your function, then to that Cognos group add AD groups from the different namespace you have created to allow users of different forest have access to the Cognos solution.

When you configure an authentication namespace for IBM® Cognos®, users from only one domain can log in. By using the Advanced properties for Active Directory Server, users from related (parent-child) domains and unrelated domain trees within the same forest can also log in. There is no cross-forest support; there must be a namespace for each forest.
If you set a parameter named chaseReferrals to true, users in the original authenticated domain and all child domains of the domain tree can log in to IBM Cognos. Users from a parent domain of the original authenticated domain or in a different domain tree cannot log in.
If you set a parameter named MultiDomainTrees to true, users in all domain trees in the forest can log in to IBM Cognos.
https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/t_includedomainsusingadvancedproperties.html#IncludeDomainsUsingAdvancedProperties

If you specify Binding Credentials (i.e. if you fill in this section), then:
• (in some environments) it can lead to performance problems. This is because it causes Cognos to ‘unbind’ its original user and re-bind as the ‘specified’ user
• You must ensure that the password (of the user that you choose) does not change/expire

=> Therefore, only fill in the ‘Binding credentials’ section if your “test” (see later) fails. If authentication fails, specify a Windows user ID and password for the Binding credentials property.
• Use the credentials of a Windows user who has at least ‘search’ and ‘read’ privileges for that server.
• This should be a domain user who can ‘see’ the folders inside the AD where the users are located.

http://www-01.ibm.com/support/docview.wss?uid=swg21380097

In order to setup SSO in a multi-domain Active Directory environment, follow these steps:

1. Launch “Cognos Configuration”
2, Create a new namespace
3. Make sure that this is set to “Active Directory” (not LDAP)
4. Use the root domain as the hostname
5. Locate “Advanced properties” and click edit/modify button
6. Enable either ‘ChaseReferrals’ or ‘MultiDomainTrees’.

TIP:

  • ChaseReferrals – This will allow users from ‘child’ domains (i.e. domains below the domain that your namespace is connected to) to logon
    • This is often the best choice (for performance reasons).
  • MultiDomainTrees – Allows users from ALL domains (inside the forest) to logon
    • If you are unsure where your users will be located, ‘MultiDomainTrees’ can be the best option (to ensure that all users are able to logon, wherever they are located).
    • However, this means that searches will traverse the entire forest, leading to performance slowdowns.

Once you have chosen, add one of the following entries:

  • chaseReferrals: True
  • multiDomainTrees: True

6. Decide on whether to use NTLM (“REMOTE_USER”) or KERBEROS authentication.
If you want to use NTLM/REMOTE_USER, then also add the following entry:

  • singleSignOnOption: IdentityMapping

Do not use this entry if you want to use Kerberos (which is the preferred option for many environments).
7. Perform a test on this namespace to make sure a connection can be made
8. Restart the service

 

From the web:
– universal group membership is replicated to all Global Catalogs (i.e. it has forest-wide replication scope). This can be beneficial (since it provides efficient way to retrieve group members) – but has its drawbacks (it increases volume of replication traffic).
– domain local groups do not have any limitations regarding their membership – i.e. they can contain accounts the same domain/forest or any trusted domain/forest. This does not apply to  domain global groups (they can contain only accounts from the same domain) or universal groups (they can contain only accounts from the same forest).
– universal group is a security or distribution group that contains users, groups, and computers from any domain in its forest as members. You can give universal security groups rights and permissions on resources in any domain in the forest.
– global group is a group that can be used in its own domain, in member servers and in workstations of the domain, and in trusting domains. In all those locations, you can give a global group rights and permissions and the global group can become a member of local groups. However, a global group can contain user accounts that are only from its own domain.
– domain local group is a security or distribution group that can contain universal groups, global groups, other domain local groups from its own domain, and accounts from any domain in the forest. You can give domain local security groups rights and permissions on resources that reside only in the same domain where the domain local group is located.

More information:
http://www-01.ibm.com/support/docview.wss?uid=swg21598533

https://www.ibm.com/support/knowledgecenter/en/SSEP7J_10.2.2/com.ibm.swg.ba.cognos.c8pp_inst.10.2.2.doc/c_enabling_single_signon_between_actdirsrv_and_cog_comp.html

http://www-01.ibm.com/support/docview.wss?uid=swg21341889

http://www-01.ibm.com/support/docview.wss?uid=swg21340833

Product:
Cognos BI 10.2.2
Microsoft Windows 2012 R2 Server
Problem:
What files should I save in a backup folder, before I apply a fix pack or do a upgrade of a Cognos BI 10.2.x installation?
Solution:
If you have done advance tuning to the Cognos functions then this files are maybe updated;
…\c10_64\configuration\CQEConfig.xml
…\c10_64\configuration\cclWinSEHConfig.xml
…\c10_64\configuration\rsvpproperties.xml
…\c10_64\webapps\p2pd\WEB-INF\p2pd_deploy_defaults.properties
…\c10_64\webapps\p2pd\WEB-INF\xts.properties
…\c10_64\tomcat\conf\server.xml
…\c10_64\webapps\p2pd\WEB-INF\services\reportservice.xml
…\c10_64\webapps\p2pd\WEB-INF\services\batchreportservice.xml
…\c10_64\webapps\p2pd\WEB-INF\classes\vierwerconfig.properties
…\c10_64\templates\ps\portal\system.xml

You should keep a copy of the original file you change with the ending .org like system.xml.org. Then you should copy your updated file with a ending like .ibm – then if the fix pack overwrites your system.xml file you have a copy of the file in system.xml.ibm, that you can copy back after the updated.

If you have done report customization then there is this files you need to make a copy off;

GlobalReportStyles.css 8.x styles Classes that were used in IBM Cognos 8 BI
GlobalReportStyles_none.css Simplified styles Classes that have minimal styling defined, useful for financial reports
GlobalReportStyles_1.css 1.x styles Classes that were used in IBM Cognos ReportNet
GlobalReportStyles_10.css 10.x styles Classes in the default style sheet for IBM Cognos 10 BI

They are in this folders

<c10_install>\bin\ The file in this location is used by Report Server for PDF and Microsoft Excel spreadsheet software outputs.
<c10_install>\webcontent\schemas\ The file in this location is used by IBM Cognos Viewer for HTML output.
<c10_install>\reportstyles\ The file in this location is not currently used.
<c10_install>\webcontent\reportstyles\ The file in this location is used by Report Studio.

Then you also may backup this files if you made changes there:
<c10_install>\webcontent\schemas\GlobalReportStyles_10.css.
<c10_install>\webcontent\pat\res\templates.xml.
<c10_install>\webcontent\pat\res\Resources.xml.
<c10_install>\webcontent\pat\res\reportstudio_en.xml.
<c10_install>\webcontent\pat\res\TableStyles.xml.
<c10_install>\webcontent\pat\res\ChartTemplates.xml.
<c10_install>\webcontent\pat\res\ReportPresets.xml.

You should also export a unencrypted cogstartup.xml file from each servers Cognos Configuration. Save this file in a separate folder like d:\temp\cogstartup backup 20171124.xml

Include the date, when you saved the file, in the filename.

More information:

https://www.ibm.com/support/knowledgecenter/en/SSEP7J_10.2.2/com.ibm.swg.ba.cognos.c8pp_inst.10.2.2.doc/t_installfixpacksunix.html

https://www.ibm.com/developerworks/library/ba-pp-infrastructure-cognos_specific_page702/index.html

Product:
Cognos BI 10.2.2
Microsoft Windows 2012 R2 Server
Problem:
How update the toolbar with links?
Solution: (copied from ibm website) http://www-01.ibm.com/support/docview.wss?uid=swg21694761

You need to update the system.xml file. This is found in folder C:\Program Files\ibm\cognos\c10_64\templates\ps\portal\system.xml on the Cognos BI report (dispatcher) server and on the Content manager server. It is the Cognos Presentation service that create the web-page, so where this is running (true) there the files will be read. Best  is to update it on all Cognos instances.

You can add user interface elements to IBM Cognos Connection to connect to external applications or to modify the functionality of IBM Cognos Connection. You can restrict access to these new user interface elements based on different user groups and roles.

To add a user interface element in IBM Cognos Connection, you must modify the portal system.xml file.

The xml:lang attribute of the label and tooltip elements in the system .xml file corresponds to the product locale in use at the time of the portal page generation. If a new product locale is added for IBM Cognos software, you must add a translation for the label and tooltip fields. When no label or tooltip is found that matches the product locale, nothing is displayed. The graphic that is referenced by the icon element must exist in the c10_location/webcontent/ps/portal/images directory.

Procedure
1. Stop the IBM Cognos service.
2. Open the c10_location/templates/ps/portal/system.xml file in an XML or text editor.
3. For the <system> element, add the <param name=”ui_add”> element:

      <param name=”ui_add”>
      <!–list of user interface elements–>
    </param>

4. Within the <param name=”ui_add”> element, define all the custom elements that you want to add.

For example, you can add a link to the IBM website in the main header in IBM Cognos Connection:

        <param name=”ui_add”>

          <CC_HEADER_MENU>

            <item>

              <url>

http://www.ibm.com

              </url>
              <target>_blank</target>
              <label xml:lang=”en”>IBM</label>
              <tooltip xml:lang=”en”>IBM</tooltip>
              <label xml:lang=”fr”>IBM</label>
              <tooltip xml:lang=”fr”>IBM</tooltip>
              <label xml:lang=”de”>IBM</label>
              <tooltip xml:lang=”de”IBM</tooltip>
              <label xml:lang=”ja”>IBM</label>
                <tooltip xml:lang=”ja”>IBM</tooltip>

</item>

</CC_HEADER_MENU>

</param>

        Using the following example, the IBM link and the associated icon are added to the

Launch

        menu in IBM Cognos Connection:
        <param name=”ui_add”>

          <CRN_HEADER_OPTIONS>

            <item>

              <url>

http://www.ibm.com

              </url>
              <target>_blank</target>
              <label xml:lang=”en”>IBM</label>
              <tooltip xml:lang=”en”>IBM</tooltip>
              <label xml:lang=”fr”>IBM</label>
              <tooltip xml:lang=”fr”>IBM</tooltip>
              <label xml:lang=”de”>IBM</label>
              <tooltip xml:lang=”de”>IBM</tooltip>
              <label xml:lang=”ja”>IBM</label>
              <tooltip xml:lang=”ja”>IBM</tooltip>
              <icon>action_search.gif</icon>

</item>

<CRN_HEADER_OPTIONS>

</param>

5. For information about all the user interface elements that you can add, see the topic ““Elements You Can Add”. Ensure that you match the case of each user interface element that you want to add.

6. Specify one or more groups or roles that you want to access the new interface element by adding their IDs as values of the show attribute. Use the IDs as documented in the topic “Referencing the required groups or roles in the system.xml file”. Separate the IDs using spaces.

Here is an example:

<param name=”ui_add”>

      <CC_VIEW_TOOLS>

        <item show=”Administrators RSUsers g1 g2″>

          <url></url>
          <target>_blank</target>
          <label xml:lang=”en”>

My_label in English

          </label>
          <label xml:lang=”fr”>

My_label in French

          </label>
          <label xml:lang=”de”>

My_label in German

          </label>
          <label xml:lang=”ja”>

My_label in Japanese

          </label>

</item>

</CC_VIEW_TOOLS>

</param>

7. Save the system.xml file.
8. Restart the IBM Cognos service.
Tip: You can have only one <param name=”ui_add”> element in the system.xml. Therefore, all items that you want to add must be placed inside this element.

 

More information on customization of reports from here
https://www.ibm.com/developerworks/library/ba-pp-infrastructure-cognos_specific_page702/index.html

report_figure6

As shown in picture, the style of a Cognos report or report object can be affected by many sources such as:

Properties
Global Cognos style sheet such as GlobalReportStyles_10.xml
Templates
Local Classes
Layout Component References
TableStyles.xml
ChartTemplates.xml
RAVE visualizations
ReportPresets.xml

If we want to create and modify classes that apply to all reports, we can modify the global Cognos style sheet. This is a useful strategy if we only have one corporate style for all reports.

There are four versions of the global Cognos style sheet as shown in Table below.

 Four versions of the global Cognos style sheet
CSS Version Report Style Description
GlobalReportStyles.css 8.x styles Classes that were used in IBM Cognos 8 BI
GlobalReportStyles_none.css Simplified styles Classes that have minimal styling defined, useful for financial reports
GlobalReportStyles_1.css 1.x styles Classes that were used in IBM Cognos ReportNet
GlobalReportStyles_10.css 10.x styles Classes in the default style sheet for IBM Cognos 10 BI

The exact CSS file used will be chosen based on how the report style is set for a given report. The default setting for IBM Cognos BI 10 is 10.x styles, as shown in Figure 8. You can open this dialog by selecting Report Properties from the File menu in IBM Cognos Report Studio.

report_figure8

Report Properties dialog above.

Each of the four CSS files identified above is installed by Cognos in four different locations, as shown in Table below.

Files are on both gateway and dispatcher (app) servers.
Directory Description
<c10_install>\bin\ The file in this location is used by Report Server for PDF and Microsoft Excel spreadsheet software outputs.
<c10_install>\webcontent\schemas\ The file in this location is used by IBM Cognos Viewer for HTML output.
<c10_install>\reportstyles\ The file in this location is not currently used.
<c10_install>\webcontent\reportstyles\ The file in this location is used by Report Studio.

Update the file GlobalReportStyles_10.css in all above folders.

In the following example we will modify the IBM Cognos 10 BI global style sheet GlobalReportStyles_10.css. This style sheet is used by Cognos Viewer for HTML output.

The following steps are a simple modification where we will modify GlobalReportStyles_10.css to increase the font size.

  1. On your IBM Cognos BI 10 server, find the file named <c10_install>\webcontent\schemas\GlobalReportStyles_10.css.
  2. Copy this file and save it as GlobalReportStyles_10_BU.css.
  3. Open the original GlobalReportStyles_10.css in a text editor.
  4. Find the text .ls /* list */.
  5. Scroll down to font-size: 8pt; and change it to font-size: 28pt;.
  6. Save the file and close it.
  7. Clear your browser’s cache and restart Report Studio.
  8. Create a new List report with any data source.Select the List object and view its properties. You will notice that the Font property is empty.
  9. Click the Run Report toolbar button to preview the HTML output in Cognos Viewer. It will pick up the new 28pt font size at runtime.

More information:

http://www-01.ibm.com/support/docview.wss?uid=swg21339054

http://www-01.ibm.com/support/docview.wss?uid=swg21694761

Product:
Cognos BI 10.2.2 fix pack 7
Microsoft Windows 2012 R2 Server
Issue:
When a user from a different domain than the servers are in, try to login to Cognos Connection, they get this error message.
Error:
CAM-AAA-0064
The function ‘bindToBestGCServer’ failed.
Solution:
There are two Microsoft Windows domains, Domain A and Domain B, that have a forest trust. In Cognos Configuration you have setup two namespace – one for Domain A and one for Domain B. The Cognos servers are in Domain A.
On the Microsoft Windows server IIS manager you have set Windows authentication on the CGI-BIN folder for the Cognos Gateway.
The user selects the namespace he want to login to first when he reach the cognos connection webpage.
Inside Cognos Configuration you only need:
+ In the Value – Advanced properties window, click Add.
+ In the Name column, type singleSignonOption (Case sensitive)
+ In the Value column, type IdentityMapping (Case sensitive)
+ Click OK.
+ Save configuration and restart Service for the setting to take effect

…to make the login work.
If you have also enter multiDomainTree=true you get above error.
If you only have ONE namespace setup in Cognos, then if all domains are the same Active Directory Forest, you need to add this values
chaseReferrals = True
MultiDomainTrees = True

Solution is very depending one your network infrastructure setup, you need to test different configurations.

Authentication in One Domain Tree
If you set a parameter named chaseReferrals to true, users in the original authenticated domain and all child domains of the domain tree can log in to Cognos. Users above the original authenticated domain or in a different domain tree cannot log in.

Authentication in All Domain Trees in the ‘Forest’
If you set a parameter named MultiDomainTrees to true, users in all domain trees in the forest can log in to Cognos.

More information
http://www-01.ibm.com/support/docview.wss?uid=swg21341889

https://www.ibm.com/support/knowledgecenter/en/SSEP7J_10.2.2/com.ibm.swg.ba.cognos.c8pp_inst.10.2.2.doc/c_enabling_single_signon_between_actdirsrv_and_cog_comp.html#stp_SSO_active_drctry
http://www-01.ibm.com/support/docview.wss?uid=swg21339641

Product:
Cognos Business Intelligence

Problem:
How to determine the Service Pack of the Cognos Business Intelligence product installed?

Solution (copied from IBM website before it is removed):
The component list cmplst.txt file displayed a full list of installed components. It is found on any server with a full or partial installation of Cognos Business Intelligence.
The table below maps the various build numbers to their more commonly referenced release names:
The build number indicates the MR (Maintenance Release) version, as per the following table:

IBM Cognos ReportNet
Build 1.1.316.16 is MR1
Build 1.1.413.8 is MR2
Build 1.1.510.0 is MR3
Build 1.1.610 is MR4

IBM Cognos 8 BI 8.1
8.1.108.33 is MR1
8.1.209.25 is MR2

IBM Cognos 8 BI 8.2
8.2.43.128 is the initial release
8.2.44 is SP1
8.2.45 is SP2
8.2.46 is SP3

IBM Cognos 8 BI 8.3
8.3.81.20 is the initial RTM
8.3.82 is SP1
8.3.83 is SP2
8.3.84 is SP3
8.3.85 is FP4
8.3.86 is FP5

IBM Cognos 8 BI 8.4
8.4.27.78 is the RTM or GA
8.4.28.15 is FP1
8.4.29.13 is FP2

IBM Cognos 8 BI 8.4.1
8.4.102.18-0 GA
8.4.103.16-0 FP1
8.4.104.13-0 FP2
8.4.105.14-0 FP3
8.4.106.12 FP4

IBM Cognos 10.1
10.1.4707.544-0 GA
10.1.4801.29-0 FP1

IBM Cognos 10.1.1
10.1.6235.152 – 10.1.1 GA
10.1.6301.14 – 10.1.1 FP1
10.1.6303.12 – 10.1.1 FP2
10.1.6304.10 – 10.1.1 FP3
10.1.6305.14 – 10.1.1 FP4
10.1.6306.40 – 10.1.1 FP5

IBM Cognos 10.2
10.2.1003.159 – 10.2 GA
10.2.1101.19 – 10.2 FP1
10. 2.1102.54 – 10.2 FP2
10. 2.1103.29 – 10.2 FP3
10. 2.1104.98 – 10.2 FP4
10.2.1105.45 – 10.2 FP5

IBM Cognos 10.2.1
10.2.5000.275 – 10.2.1 GA
10.2.5001.156 – 10.2.1 FP1
10.2.5002.78 – 10.2.1 FP2
10.2.5003.113 – 10.2.1 FP3
10.2.5004.54 – 10.2.1 FP4 (build 10.2.5004.53 may be found in versions prior to Aug 15, 2014)
10.2.5005.78 – 10.2.1 FP5
10.2.5006.79 – 10.2.1 FP6
10.2.5007.30 – 10.2.1 FP7
10.2.5008.29 – 10.2.1 FP8
10.2.5009.33 – 10.2.1 FP9
10.2.5010.46 – 10.2.1. FP10 (build 10.2.5004.43 indicates the withdrawn Fix Pack 10)
10.2.5011.54 – 10.2.1 FP11
10.2.5012.26 – 10.2.1 FP12
10.2.5013.81 – 10.2.1 FP13

IBM Cognos 10.2.2
10.2.6100.235 – 10.2.2 GA
10.2.6101.79 – 10.2.2 FP1
10.2.6102.54 – 10.2.2 FP2
10.2.6103.26 – 10.2.2 FP3
10.2.6104.43 – 10.2.2 FP4
10.2.6105.506 – 10.2.2 FP5 (build 10.2.6105.50 indicates the withdrawn Fix Pack 5)
10.2.6106.48 – 10.2.2 FP6
10.2.6107.28 – 10.2.2 FP7
10.2.6108.34 – 10.2.2 FP8
10.2.6109.59 – 10.2.2 FP9

Steps:
Within the Cognos BI install folder, look for a file called cmplst.txt. The default installation location is c:\program files\cognos\
Within this file, look for [Product Update Information]. If this section is missing or blank, then you have the RTM (first release) installed. If the section is populated, reference the table above to determine the service pack installed.

If you do not have access to the component list file (cmplst.txt):
Hit Ctrl-F3 within Cognos Configuration to bring up a Properties menu
On the Installed Components tab, the build numbers will also be displayed

http://www-01.ibm.com/support/docview.wss?uid=swg21343355

For Cognos Analytics
Name                            Release                                  Build Number
Cognos Analytics 11 GA 11.0.0.0                          11.0.0.15121723
Cognos Analytics 11 R1 11.0.1.0                           11.0.1.16031813
Cognos Analytics 11 R2 11.0.2.0                           11.0.2.16042816
Cognos Analytics 11 R3 11.0.3.0                           11.0.3.16062807
Cognos Analytics 11 R4 Initial 11.0.4.0                11.0.4.16090915
Cognos Analytics 11 R4 Refresh 11.0.4.0            11.0.4.16092813
Cognos Analytics R5 11.0.5.0                                11.0.5.16112119
Cognos Analytics R6 11.0.6.0                                11.0.6.17031315
Cognos Analytics R7 11.0.7.0                                11.0.7.17082211
Cognos Analytics R8 11.0.8.0                                11.0.8.17103116

http://www-01.ibm.com/support/docview.wss?uid=swg21990189
and for TM1 you can find the version here
http://www-01.ibm.com/support/docview.wss?uid=swg21964134

Product:
Cognos Business Intelligence (BI) 10.2.2 Fix pack 6
Microsoft Windows 2012 R2 server
Issue:
When adding a new domain to the list of namespaces in Cognos BI, during test or startup it give a error message.
New domain have in our example the name ExtAD
Error message:
[‘ExtAD’]
[ ERROR ] CAM-AAA-0146 The namespace ‘ExtAD’ is not available.
[ ERROR ] CAM-AAA-0064 The function ‘Configure’ failed.
[ ERROR ] CAM-AAA-0089 The provider is not initialized.
[ ERROR ] CAM-AAA-0036 Unable to authenticate because the credentials are invalid.
[ ERROR ] ADSI Error:
8009030C: LdapErr: DSID-0C09053E, comment: AcceptSecurityContext error, data 52e, v1db1
System Error:
The user name or password is incorrect.
Possible Solution:
The user logged into the Windows server where you have Cognos Configuration, does not have a account (or trust) in the new domain, so the test fail and the new Active Directory namespace is not shown.
Start Cognos Configuration and update the new namespace values
Enter a windows service account in the Bindings Credentials row in Cognos Configuration for the new namespace.
Enter in the format: domain.com\username
and the password (because it is a service account the password will never change).
Save the changes and restart the Cognos BI service where the content manager are.
Test to surf to the gateway again.

If Cognos 8 is running on the machine in the same forest as the configured domain/forest, you do not need to specifically set the bind credentials. However, if you run cross forest, then, you must provide the bind credentials

You would also need the binding credentials if AD is not configured to allow anonymous bind

More Information:
If the password is correct:
-2146893044 => 8009030C: LdapErr: DSID-0C0903A9, comment: AcceptSecurityContext error, data 775, v1db1 (account locked out)

If the pwd is incorrect returns:
-2146893044 => 8009030C: LdapErr: DSID-0C0903A9, comment: AcceptSecurityContext error, data 52e, v1db1 (unknown username or bad password)

https://social.technet.microsoft.com/Forums/lync/en-US/c1d8d706-a506-4973-9542-1e88a2a66ac0/ad-lds-and-locked-out-accounts-response-codes?forum=winserverDS

http://www-01.ibm.com/support/docview.wss?uid=swg21428900
http://www-01.ibm.com/support/docview.wss?uid=swg21432574

http://www-01.ibm.com/support/docview.wss?uid=swg21335624
https://www.ibm.com/support/knowledgecenter/SSEP7J_10.2.0/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.0.doc/t_ap_active_dir_srvr.html

Product:
Cognos Analytics 11.0.7
Microsoft Windows 2012 R2 Server

Issue:
On new Windows 7 computer you get a blank screen when you surf to Cognos Connection.

Error message in left corner of browser:
Webpage error details
User Agent: Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.1; WOW64; Trident/4.0; SLCC2; .NET CLR 2.0.50727; .NET CLR 3.5.30729; .NET CLR 3.0.30729; Media Center PC 6.0; InfoPath.3)

Message: ‘performance’ is undefined
Line: 42
Char: 3
Code: 0
URI: https://caservername/ibmcognos/bi/

Solution:
Install a different browser like Internet Explorer 11.

For any issues in CA11, please first check with a different browser like Chrome. Many issues is only in a specific version of Web Browser.

Cognos Analytics only supports IE11 and some other browsers.
https://www.ibm.com/software/reports/compatibility/clarity-reports/report/html/softwareReqsForProduct?deliverableId=A6C8D9F0FF5611E6A4D1A0107E2821F7&osPlatform=Windows#sw-13

To install IE11 you need SP1 for Windows 7 https://www.microsoft.com/en-us/download/details.aspx?id=5842 and this updates
https://support.microsoft.com/en-us/help/2847882/prerequisite-updates-for-internet-explorer-11

Press F12 and select network, to troubleshoot more inside IE.

Product:
Planning Analytics 2.0.2
Planning analytics workspace 2.0.25
Microsoft Windows 2016 standard server
Problem:
How install PAW with Microsoft 2016 Docker files?
Solution:
When using the Microsoft 2016 server with Docker EE, there is no need to have a Virtualize active in VMWARE, therefor is this a better solution. (If you not use Linux OS). Docker EE also does not cost anything extra, as it is part of the Microsoft 2016 licenses.
But to make this work you must:
– The Microsoft Windows 2016 server must be connected to Internet to download the Docker EE.
– Update Microsoft Windows 2016 standard server to the latest fix pack.
– You must use FQDN to access all servers.
– You must have 70 GB free disk space on the Microsoft Windows 2016 server.
– Turn off the Antivirus program on the Windows 2016 server where PAW is installed.
– After you start PAW you must always wait 10 minutes before you try to access it.
– Recommend that you only have ONE network card on the Microsoft Windows 2016 server for PAW.
paw1
Above only for your test server, on your laptop.
There is possible to download Docker EE and move it to a different server, according to this page,
https://docs.docker.com/engine/installation/windows/docker-ee/
I copy some of the information here:
Use the following steps when you want to install manually, script automated installs, or install on air-gapped systems.

  • PS> Expand-Archive docker.zip -DestinationPath $Env:ProgramFiles
  • # Extract the archive.
  • Copy the zip file to the machine where you want to install Docker. In a PowerShell command prompt, use the following commands to extract the archive, register, and start the Docker service.
  • https://download.docker.com/components/engine/windows-server/17.06/docker-17.06.2-ee-4.zip
  • PS> invoke-webrequest -UseBasicparsing -Outfile docker.zip
  • # On an online machine, download the zip file.
  • In a PowerShell command prompt, download the installer archive on a machine that has a connection.
  • # Clean up the zip file.
  • PS> Remove-Item -Force docker.zip
  • # Install Docker. This will require rebooting.
  • $null = Install-WindowsFeature containers
  • # Add Docker to the path for the current session.
  • PS> $env:path += “;$env:ProgramFiles\docker”
  • # Optionally, modify PATH to persist across sessions.
  • PS> $newPath = “$env:ProgramFiles\docker;” +
  • [Environment]::GetEnvironmentVariable(“PATH”,
  • [EnvironmentVariableTarget]::Machine)
  • PS> [Environment]::SetEnvironmentVariable(“PATH”, $newPath,
  • [EnvironmentVariableTarget]::Machine)
  • # Register the Docker daemon as a service.
  • PS> dockerd –register-service
  • PS> Start-Service docker
  • # Start the Docker service.
  • Test your Docker EE installation by running the hello-world container.
  • PS> docker container run hello-world:nanoserver

But for this installation, we will have the Microsoft Windows 2016 server connected to Internet.

Download the latest PA Workspace file (ipa) from IBM Fix Central
http://www-01.ibm.com/support/docview.wss?uid=swg27049597

In these instructions we use the version 25. Note; take the WIN version, the other is for Linux (or Windows 2012).

Unzip the file and place it on the Microsoft Windows 2016 server in a folder, e.g. \install\paw

paw2

The Start.ps1 file indicate that you have downloaded the correct program for Windows 2016.

Check that Microsoft Windows 2016 is update in control panel
paw3

You can go to settings from Server Manager or enter Settings in the search box.

paw4

By the way, we have IE Enhanced Security Configuration and DEP off during the installation. Turn off the Windows firewall during installation and first testing. Start up the firewall later.
paw5

After the update you need to reboot your Microsoft Windows 2016 server.

How install Docker EE

paw6

https://github.com/docker/labs/blob/master/windows/windows-containers/Setup-Server2016.md

PowerShell Package Provider (recommended)

Microsoft maintains a PowerShell package provider that lets easily install Docker on Windows Server 2016.
Run the following in an Administrative PowerShell prompt:

Install-Module -Name DockerMsftProvider -Force
Install-Package -Name docker -ProviderName DockerMsftProvider -Force
Restart-Computer -Force

So, ensure the server is connected to internet, and right click on start, and select Windows PowerShell (Admin).

Enter the below commands:

Install-Module DockerProvider -Force

Install-Package Docker -ProviderName DockerProvider -Force

paw7

For the questions about update the NUTGET, press Yes.

Then the download is done as shown in above picture.

Restart the Microsoft Windows server

paw8

Above error comes when you run Start.ps1 and you have not downloaded docker compose.

Download docker compose from here https://github.com/docker/compose/releases/tag/1.16.1

paw9

paw10

Copy to the file to \program files\docker folder and rename the file to docker-compose.exe.

Install IBM Planning Analytics Workspace

The Microsoft Windows 2016 server will need at least

  • 13308 MB of memory
  • 4 CPUs
  • 70,000 MB (70 GB) of storage

Here the official instructions
https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/t_paw_install.html

paw11

Then go to the powershell admin and run ./start.ps1

paw12

Click Y to start the admin tool

paw13

Accept the licenses

paw14

You must accept both the license tabs

paw15

Click OK and you are into the setup dialog.

paw16

If you want CAM security (then you need to fill in all above)

paw17

But for our test we will use Native TM1 security, then we only need to fill in above values.

paw18

The HTTPPortNumber is found in the TM1S.CFG file for the TM1 application that you will use as Authority to the PAW program. Above we use the Planning Sample application.

All users that will use the PAW program must be part of that application, so the users must in most cases be part of TWO TM1 instances, the “login” TM1 instance and the “Application” instance – where they should work on their Budget solution.

paw19

Fill in the server name and port number and click on Validate.

paw20

If you get above error, this can be a DNS or Network problem, change to use FQDN, even do the ping to the server is working.

paw21

paw22

Now you see the HTTP ports number the different TM1 instances are using on your server.

Click on UPDATE to start the services.

paw23

paw24

Go to the Antivirus software, in above dialog it is Microsoft Defender, and click on Settings to turn it off.

paw25

Turn off Real-time protection.

paw26

Start Internet explorer and surf to you server to test the installation of PAW , surf to your IP address of your Windows server.

http://192.168.254.24/login/form

paw27

Login with the user and password for the planning sample application. Now you need to test the installation by creating a workbook.

https://www.ibm.com/support/knowledgecenter/en/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_prism_gs.2.0.0.doc/c_prism_books_views.html

To check the version of docker enter: docker version

paw28

Enter Docker stats to see what memory is used by the services

paw29

Press CTRL+C to exit the session.

How to backup the PAW database

To take a backup of the databases inside PAW, recommend to run every week the ./Backup.ps1 script from the scripts folder. This will stop and start the services, making the backup possible.

paw30

The backup files are placed in the backup folder.

paw31

How stop PAW in a secure way:

Start a powershell prompt in administrator mode and enter ./paw.ps1 stop

paw32

When that is finish – then you can shut down the Microsoft Windows 2016 server.

Docker stats should show an empty page, if all services are closed.

You can start the PAW from the PowerShell prompt with commando ./paw.ps1 start

How upgrade PAW to later version:

Depending on the version of PAW the steps are different, but in general for version 25.

You must first backup your existing PAW data by use of the backup_for_upgrade.ps1

Copy the zip backup files to a save location.

Procedure from IBM site;

Copy the <paw_install_location>/config/paw.env file from your current installation to the new installation location.

Copy the <paw_install_location>/config/certs directory from your current installation to the new installation location.

Perform Installing of new Planning Analytics Workspace.

Reply “y” when you are prompted to install the Docker images. Reply “y” when you are prompted to open the administration tool.

In the Planning Analytics Workspace administration tool, restart all the services.

After you got all up and running, run the new Restore.ps1 script, and point to your saved files to read that data into the PAWs databases.

https://www.ibm.com/support/knowledgecenter/en/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/t_paw_backup_restore.html

How do i see PAW

Docker is running as a service in Windows 2016, and you have the PAW solution inside the docker service. Check Windows Task Managers details, to see if the PAW parts are running.

In new version of PAW you can set security better than in older versions, more information here
https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_prism_gs.2.0.0.doc/c_paw_administration_top_level.html

In new version of PAW you can share a view, here more information on how
https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_prism_gs.2.0.0.doc/t_prism_sharing.html

Note that version 25 of PAW does not support Single Sign On (SSO). That maybe will be accessible in a future version.

You cannot install more than one PAW on a server, due to network configuration issues.

All TM1 applications use SSL for communications between the programs, using their default certificates.

If you get error:

Unable to invoke ‘docker’. Ensure docker is installed and is on the PATH.

Then you have not reboot the server, after docker installation.

If you get error:

This error (HTTP 404 Not Found) means that Internet Explorer was able to connect to the website, but the page you wanted was not found. It’s possible that the webpage is temporarily unavailable. Alternatively, the website might have changed or removed the webpage.

For more information about HTTP errors, see Help.

Then the PAW is not started completely.

paw33

Above error show that the PAW underlying services are stopped. Check in Task Manager.

PAX (Planning Analysis for Excel) setup, is not covered in this article.

In the task manager you can see the processes that make up the Docker solution, under the details section;

paw35

MONGO database is running here.

paw36

REDIS database is running here.

paw37

The COUCH database is running here.

paw38

When all the services inside docker are stopped, there is no CPU activate or memory used.

More Information:

How setup SSO

http://www-01.ibm.com/support/docview.wss?uid=swg22000283

How setup PAX

https://www.ibm.com/support/knowledgecenter/en/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/t_installingcognos8analysisformicrosoftexcel.html

The latest functions in the different PAW versions

https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_prism_gs.2.0.0.doc/c_new_features_paw.html

Please note; that the PA 2.0 LOCAL PAW is released a few months later than the PA on cloud. Local is around 3 versions after.

paw34

Product:
Cognos Analytics 11.0.7
Microsoft Windows 2008/2012/2016 server
Problem:
How setup SSL with the IIS for the cognos users?
Solution:
For testing in your demo environment, you can create own certificate, but for setup in production you need to buy a certificate from trusted CA store.

More information on OPENSSL can be found  here https://www.feistyduck.com/books/openssl-cookbook/

Demo setup:
Download open ssl from here in a good installation package http://slproweb.com/products/Win32OpenSSL.html
ssl1
Check the file for virus before you install it.
Install openssl on your server
ssl2
Click next on all dialogs to install it
ssl3

ssl4

ssl5

ssl6

ssl7

ssl8

Create a folder c:\ssl
Start a command prompt as administrator
Change into c:\ssl directory.
Make a directory called keys.
Make a directory called certs.
Make a directory called requests.
Make a directory called demoCA.
Move to the demoCA folder
Make a directory called demoCA/newcerts.
Do Echo 01 >demoCA/serial.
Create an empty txt file called demoCA/index.txt.
ssl10
You can also try to Open notepad to create the index.txt file
SSL11
Save the file and close notepad.
ssl12
ssl13
Note the name of the server and domain to create the certs.
The name that is in the cert must exist in the DNS to make it work.
Generate the private key and CA certificate needed to sign requests
you need to add openssl\bin to path, otherwise you get below error
ssl14
Open control panel – system – advance settings
ssl15
ssl16
add the BIN folder to path and click OK

We will create a simple SSL cert, recommendation is that you create a newer and stronger cert in your testing.

Start a new administrative command prompt and move to SSL folder
Enter this command to create the ca key
openssl genrsa -des3 -out keys/ca.key 1024
ssl17
Ensure to enter the same password in all the steps.
e.g cognos101
generate a self-signed CA certificate that will be used later to sign all certificate requests
Enter this command to create the root ca
openssl req -new -x509 -out certs/ca.cer -key keys/ca.key -days 365
ssl18
Enter values that make sense for you.
Above is to setup the ca – this can also be done in Windows IIS to or use a public vendor like;
https://www.expertssl.se/
https://uk.godaddy.com/help/ssl-certificates-1000006#nav-1
https://really-simple-ssl.com/
ssl19
Start IIS on the Microsoft Windows Server 2016 where the Cognos gateway are installed.
Click on Server Certificates
ssl20
Click on Create certificate request
ssl21

ssl22
ssl23
Save file in request folder
Now create the cert with this command
openssl ca -md sha1 -policy policy_anything -cert certs/ca.cer -keyfile keys/ca.key -in requests/certreq.txt -days 365 -out certs/certreq.cer
ssl24
If you get errors, it can be that the index.txt file was not created in correct way.
ssl25
Check that a cert was created with this command
openssl x509 -text -in certs/certreq.cer
ssl26
Now you have a cert file.
Complete the process on the IIS server to import the cert now.
ssl27
Inside IIS manager mark the servername and click on SSL certificates
Click on complete certificate request
ssl28
Browse to the new cer file
Enter a name
And click OK
ssl29
After some time the cert will show up in the list.
Mark default web site and click on bindings
ssl30
Click on Add in site Bindings dialog.
ssl31
Select https
Select the SSL certificate from the drop-down list
ssl32
This is only the simplest demo setup, and therefor in production you should also follow things like this if above error comes up
https://support.microsoft.com/en-gb/help/954755/how-to-configure-intermediate-certificates-on-a-computer-that-is-runni
ssl33
If you can not save with a blank host name, enter a name and remove it later.
Click close.
Mark ibmcognos virtual folder in IIS manager and click on SSL settings
ssl34
ssl35
Mark Require SSL and click on Apply in top right corner.
Restart the iis webserver.
Now if you surf to http://labwin2012ca:9300/bi/ you go direct to cognos server and do not use a encrypoted session.
If you surf to https://labwin2012ca/ibmcognos you will get this message
ssl36
If you click on continue to this website – you will come through to the website.
To get away of this error message, we will import the trust cert (CA) into Internet Explorer.
ssl37
Go to internet options and click on content
ssl38
Click on Trusted Root Certification Authorities and click import
ssl39
Click next
ssl40
Mark the ca.cer file that was created by openssl
And click next
ssl41
There is a suggestion on how to do the SSL setup, there are other ways that are more correct.
Click Next
ssl42
Click finish
ssl43
Because this is a cert we created we get this warning, click yes, to import it to your laptops IE.
ssl44
If you check the cert should be in your IE now.
ssl45
Close IE and try to surf again.
ssl46
Now you get direct to CA 11 without errors. You see on the lock in the toolbar that it is a secure connection, you can click on the lock to get more information.
ssl47
if you use your own OPENSSL cert, you need to import the ca cert in every client computer to get a secure connection without error messages. Therefor it is simpler to buy a cert from a known CA.
You will also need to install the CA.CER in the Cognos BI server to be able to create PDF reports with pictures.
Copy your ca.cer to the cognos\bin folder
ssl48
Open an administrative dos prompt
Enter this command
ThirdPartyCertificateTool.bat -i -T -r “C:\Program Files\ibm\cognos\analytics\bin\ca.cer” -p NoPassWordSet
ssl49
Above error comes when the “ is of the wrong format.
ssl50
Enter the command in NOTEPAD to ensure you have the correct signs. Copy from notepad to the cmd prompt.
ssl51
Now restart Cognos services and try the report to PDF again.
Important that the reference to a picture in a Cognos report is relative like this
../samples/images/Alex_Active.png
ssl52
If you use the sample images that are stored in folder C:\Program Files\ibm\cognos\analytics\webcontent\bi\samples\images\
then it will work with both http://labwin2012ca:9300/bi/ (direct to BI services) and https://labwin2012ca/ibmcognos/bi (secure link to the IIS gateway).

Use F12 in IE to troubleshoot, if you get errors, you will see text like this
SEC7132: The certificate protecting this web site uses weak cryptography, SHA1. The web site should replace this certificate with a SHA2 certificate before SHA1 is no longer allowed https://labwin2012ca/ibmcognos/bi/pat/images/select_container.png

You need to create a stronger SSL cert, to not get above warning in the Web Browser.

SSL Setup in Production IIS server:
How setup SSL with a bought certificate.
Create a DNS alias for the server, so you have a good FQDN that will work in your domain.
Test that the users can surf to you IIS/IBMCOGNOS server with use of the dns alias like this
http://dnsalias.domain.com/ibmcognos/bi
Get a cert from your supplier for the DNS alias.
SSL53
You need to fill in information like this – please talk to your Internet provider, they can help.
You will get a PFX file that you will have a password to, normally you get the password by sms.
Place the cert file in a folder on the IIS server.
Import Cert to IIS
ssl54
Start IIS manager
Mark the computer (server)
Click on server certificates
ssl55
Click on Import to read in the certificate you have got from your ISP.
SSL56
Enter the path and filename of pfx file
Enter the password you have got for the certificate.
Leave it to store in Personal folder.
Click OK.
ssl57
Mark the default web site and click on Bindings to the right.
ssl58
Click on add to add the new cert
ssl59
Fill in the hostname
Click on select to select the cert you have read in.
Click OK
SSL60
Click Edit on the same line you saved.
Remove the host name so it is blank.
Click OK to save it again.
ssl61
Mark your IBMCOGNOS folder in IIS Manager and click on SSL settings
ssl35
Mark Require SSL and click Apply in the top right corner.
This will make that a user that surf to /IBMCOGNOS/ must have a cert.
We have left port 80 open to default website, so users do not get a message that the site does not exist.
To make it easier for users, we create a default.htm page with below content and place it in the iisroot folder (C:\inetpub\wwwroot). This should make users that surf only to the server name, are redirected to the correct address.
<html>
<head>
<title>Cognos Connection</title>
<meta http-equiv=”refresh” content=”0 ;url=https://labwin2012ca/ibmcognos”>
</head>
<body>
<a href=”https://labwin2012ca/ibmcognos” >click here</a>.
</body>
</html>
More information on how you could do it in old Cognos;
https://docs.microsoft.com/en-us/iis/configuration/system.webserver/httpredirect/

To get report with pictures to be created as PDF, you need to import the root cert to Cognos BI server.
Export CA cert from IE for your trust issuer
Go to Windows control panel
Open internet options
ssl62
Click on certificates
Click on Trusted Root Certificate Authorities
If you do not find your supplier in the list, check on your local Windows 7 computer, it can have more certificates than a Windows server.
ssl63
Select you certificate and click on Export
ssl64
Click next
ssl65
Select BASE-64 CER file and click Next
ssl66
Enter a filename and click next.
ssl67
CLick finish
ssl68
You will need to copy the cer file to your Cognos BIN folder.

Import CA cert to CA 11.0.7 content store
Place the ca2.cer file in your cognos BIN and BIN64 folder.
Start an administrative command prompt
Move to the bin folder
ssl69
Enter the command ThirdPartyCertificateTool.bat -i -T -r ca2.cer -p NoPassWordSet
The password is the password for the Cognos storage, most cases NoPassWordSet
This will get the cert into the Cognos store.
If you get an error like “short read” then the cer file is in the wrong format. Please export it again from IE.
In most cases you need to put the full path to the file like this
ThirdPartyCertificateTool.bat -i -T -r “C:\Program Files\ibm\cognos\analytics\bin\ca2.cer” -p NoPassWordSet
Then it should be possible to read in the cert without errors.
You must restart the Cognos Analytics service, to make it notice the new cert.
Test by create a cognos report with a picture and run it as a PDF.
You should use the ../samples/images/Alex_Active.png to the picture if you have the picture in folder C:\Program Files\ibm\cognos\analytics\webcontent\bi\samples\images

Cognos Framework manager will work, as long it points to the CA server and not the gateway.
So, FM and other clients like Cube Designer should point to http://servername:9300/bi/v1/disp
If FM use a Gateway URI that use HTTPS and point to the IBMCOGNOS, then you need to do the same import in their local store.
This is for all Cognos tools that uses Java.

When testing, ensure that the Cognos Service have started correct, and also ensure that the web browser you use, have the trusted root cert for you cert. You must clear the web browser cache between every test.

More information
https://www.digicert.com/csr-ssl-installation/iis-8-and-8.5.htm
https://www.ibm.com/support/knowledgecenter/en/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/c_thirdpartycertificatetoolcommands.html
http://www-01.ibm.com/support/docview.wss?uid=swg21339916
https://www.ibm.com/support/knowledgecenter/en/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.1.doc/t_importcacertificates.html
http://www-01.ibm.com/support/docview.wss?uid=swg21992784