PH61024: COGNOS ANALYTICS DOCUMENTATION: "CONFIGURING AN ACTIVE DIRECTORYNAMESPACE" REQUIRES UPDATE

APAR status

• Closed as documentation error.

Error description

• Cognos Analytics Documentation:
  
  
  "Configuring an Active Directory Namespace"
  
  
  https://www.ibm.com/docs/en/cognos-analytics/12.0.0?topic=server
  -configuring-active-directory-namespace
  
  Requires correction\update.
  
  Current documentation reading following:
  
  "------
  
  Before you begin
  For IBM Cognos to work properly with Active Directory Server,
  ensure that the Authenticated users group has Read privileges
  for the Active Directory folder where users are stored.
  If you are configuring an Active Directory namespace to support
  single signon with a Microsoft SQL Server or Microsoft Analysis
  Server data source, ensure the following configuration:
  ? The IBM Cognos gateway is installed on an IIS web server that
  is configured for Integrated Authentication on Microsoft Windows
  operating system.
  ? The gateway is assigned to the local intranet website in your
  web browser.
  ? Content Manager is installed on a Windows 2008 or Windows 2012
  server.
  ? Content Manager, Application Tier Components, IIS web server,
  and the data source server (Microsoft SQL Server or Microsoft
  Analysis Server) belong to the Active Directory domain.
  ? The data source connection for Microsoft SQL Server or
  Microsoft Analysis Server is configured for External Namespace
  and that namespace must be the Active Directory namespace.
  
  ------"
  
  NOTE line reading: "Content Manager is installed on a Windows
  2008 or Windows 2012 server."
  
  Documentation requires correction\update as Windows 2008 or
  Windows 2012 servers operating systems are becoming obsolete.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * ca users                                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * "Configuring an Active Directory Namespace"                  *
  * https://www.ibm.com/docs/en/cognos-analytics/12.0.0?topic=se *
  * rver-configuring-active-directory-namespace                  *
  *                                                              *
  * Requires correction\update.                                  *
  *                                                              *
  * NOTE line reading: "Content Manager is installed on a        *
  * Windows 2008 or Windows 2012 server."                        *
  *                                                              *
  * - this line requires correction\update as Windows 2008 or    *
  * Windows 2012 servers operating systems are becoming          *
  * obsolete.                                                    *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

•  The OS version references are removed from the sentence in
  question. It now reads as follows:
      Content Manager is installed on a Windows server.
  
  The change appears for 11.2.x and 12.0.x:
  
  
  https://www.ibm.com/docs/en/cognos-analytics/11.2.0?topic=server
  -configuring-active-directory-namespace
  
  https://www.ibm.com/docs/en/cognos-analytics/12.0.0?topic=server
  -configuring-active-directory-namespace
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels