Joe Schmoe asks a fairly common question about Cognos Analytics data servers in the comments to my Framework Manager vs Data Modules article:

In Cognos Analytics 11.1.5, I don’t see a way to use a data source to feed a data module. It looks like in order to use data from a database, you need to use a package — which means you need to use Framework Manager anyway. Am I missing something?

Let’s take a look at how data servers work in Cognos Analytics to (eventually) answer Mr. Schmoe’s question.

What is a data server?

A data server is simply a connection to a database that has been defined within Cognos Analytics. This definition contains the database url, connection parameters, username and password necessary for Cognos to authenticate with, issue queries to and receive data from the desired database. A data server can be re-used by an infinite number of data modules to provide self-service users and report authors controlled access to desired data while maintaining high quality row-level security. Longtime Cognoids will no doubt say ‘Ryan, that sounds exactly like what we used to call a data source!’ Yes. Yes it does.

Cognos Analytics data server vs Cognos 10 data source

Cognos Analytics data servers and Cognos 10 data sources are fundamentally the same while having some differences in where and how they are configured. If you’re familiar with Cognos 10 you can breath a sigh of relief as your existing knowledge is almost 100% applicable. You just need to learn a slightly new UI.

Cognos Analytics data server

Introduced in Cognos Analytics

Provides a definition which Cognos uses to connect to a database

Configured via the manage menu

Requires JDBC drivers and uses exclusively JDBC connectivity

Uses Dynamic Query Mode exclusively

One data server can be used by infinite data modules

Source for data modules only – no Framework Manager [Editors note: Commentor Jerzy points out below that you can use data servers as a source for FM for DQM models only. I didn’t know that! Thanks Jerzy!]

Cognos 10 data source

Introduced in Cognos 8? 7? Reportnet? I was in college, it’s all very hazy

Provides a definition which Cognos uses to connect to a database

Configured via legacy administration console

Uses a wide variety of connection types including JDBC, ODBC and others

Uses Dynamic Query Mode or Classic Query Mode

One data source can be used by infinite Framework Manager packages

Source for Framework Manager only – no data modules (we’ll cover a simple workaround later in this article)

As you can see, data servers and data sources serve the same function within Cognos – defining a reusable database connection for Cognos – and have many of the same features. They differ primarily in the types of databases to which they can connect, the connectivity standard they use and how they are configured within Cognos.

Configuring data servers

Configuring a data server is easy and is – for the most part – a one time, ‘set it and forget it’ task most frequently done by Cognos administrators. Like everything in Cognos you have a few options for how to proceed. Before we dig into that though, let’s take a look at the info we need regardless of how we’re configuring data servers.

Data server configuration checklist

Identify which type of database you want to connect to Make sure you have permission to connect to it! Check to make sure it’s supported by Cognos Check to see if there are any special considerations for that database Acquire the relevant JDBC driver and install it in the ‘drivers’ folder of the Cognos install directory Ask your DBA for the following information: URL for connecting to the database

Database name

Schema name

Username for authentication

Password for authentication

Configuring a data server from scratch

Now that we have our ducks in a row we can build the data server. This is incredibly easy, though you might not know it from reading these instructions. Let me break it down for you:

Click the manage icon then select ‘Data server connections’ Click the plus button in the upper right of the data server connections window Select your database type from the list that appears The data server configuration window will automatically open for you to input your connection url from above. In authentication method, select ‘use the following signon’ and input your username and password Click ‘Test’ and ensure Cognos can connect to your database Click on the ‘Schemas’ tab and set the following: In ‘Load options’, choose whether or not you want Cognos to retrieve statistical samples from the database. I generally leave this alone. Turning this off will disable certain advanced features of Cognos – like auto joins in data modules

In ‘Tables’, select which tables you want to expose via the data server. I highly recommend you select only the tables which you need. Allowing Cognos to profile your entire production database during work hours is an extremely bad idea… Click ‘Save.’ Your data server is ready for use in data modules!

Converting Cognos 10 data sources to Cognos Analytics data servers

While it’s true that a data source configured in Cognos 10 cannot directly feed a data module, you can easily convert a data source to a data server provided the administrator has configured a jdbc connection for the data source. To do so follow these steps:

Click the manage icon then ‘Administration Console’ Click ‘Configuration’ tab and ‘Data Source Connections’ Click the ‘set Properties’ icon for the data source you wish to convert Check the ‘Connection’ tab Check the box next to ‘Allow web-based modeling’ Click ‘OK’ Exit the administration console and open ‘Data Servers’ in the ‘Manage’ menu. You should see your data source list as a data server.

Using data servers in Cognos analytics

By following the process outlined above we can easily use data servers to get our data into data modules and then into reports, dashboards or the new exploration feature without ever needing to reference Framework Manager. I hope this satisfies Mr. Schmoe and as always, contact me if you have any questions!

Read on to level up your Cognos skills!