Contents x
    How to Create a Connection in MetaManager™
    • 02 May 2022
    • 2 Minutes to read
    • Contributors
    • Print
    • Dark
      Light
    Contents

    How to Create a Connection in MetaManager™

    • Updated on 02 May 2022
    • 2 Minutes to read
    • Contributors
    • Print
    • Dark
      Light
    Article summary

    Creating Your Connection to Cognos

    A connection is defined by MetaManager™ as the unique combination of IBM Cognos Connection URL and logon credentials.

    » Connection Properties

    Name - The name field represents a logical name for the connection you are establishing (i.e. Development, Production, etc.). The information is used for a connection is displayed in the following locations within MetaManager™:

    ▸ The Gateway Selection dropdown in the top right corner of the MetaManager™ user interface
    ▸ The root node in all MetaManager™ portal trees
    ▸  In command line to specify connection information
    ▸ In any files saved by MetaManager™ to specify connection information

    »   URL

    The gateway or dispatcher URL used to connect to your IBM Cognos Connection portal. This can be found in your IBM Cognos Configuration properties. The URL is either the gateway or dispatcher to IBM Cognos Connection. For example, use the following format:

    ▸ Gateway: http://your.domain.com/9300/bi or http://your.domain.com/ibmcognos/bi if using IIS - https:// may be used as well.
    ▸ Dispatcher: http://your.domain.com:9300/p2pd/servlet/dispatch
    NOTE: In some environments, the gateway can be used if IBM Cognos Application Firewall (CAF) is enabled. However, in other instances the dispatcher must be used as an alternative. If possible, the gateway is preferable, as when users run reports from MetaManager™, if the dispatcher is used, graphics / icons may not display in the content. This is because the dispatcher does not utilize the web server to determine the location of these graphical files.

    »   Authentication

    credentials.gifThe IBM Cognos Connection Authentication grid supports entering logon credentials for multiple namespaces. Specifying logon credentials is optional. When MetaManager™ connects to a connection, it will attempt to use the anonymous account if no credentials have been specified. The user can then choose to manually logon and / or logon into more namespaces if desired. If the anonymous account is disabled then the user will be prompted to log on. This behavior mimics the behavior of IBM Cognos Connection. If credentials are specified in this data grid, then an explicit logon request will be issued to the IBM Cognos Connection server when the user chooses the applicable connection from the dropdown box within MetaManager™.


    The user will not receive any error message if the credentials are invalid, but instead the user will simply not have the associated access to that connection within MetaManager™. As a result, when the user expands the MetaManager™ portal tree, they will be required to logon manually if the anonymous account is disabled.;

    NOTE: To log on to multiple namespaces, click the link Log on to multiple namespaces and enter the credentials for each namespace.

    NOTE: If the master password is cleared, then the passwords for any established credentials will also be cleared and become invalid. The user should either delete the credentials or reset the passwords. If not, MetaManager™ will send failing logon requests to the server when the server is selected form the dropdown.

    If you find that you are unable to create your connection successfully please contact support. 

    Next Article: Setting Up MetaManager's Performance Options

    What's Next