Adding a component to your configuration

The cogstartup.xml file contains configuration settings used by IBM® Cognos® PowerPlay® and by default components. You can change the components that Cognos PowerPlay uses by copying XML elements from sample files into the cogstartup.xml file. You can then edit the configuration values to suit your environment.

Cognos PowerPlay can use only one instance at a time of the following elements:
  • A cryptographic provider
  • A configuration template for the IBM Cognos service

Procedure

  1. Go to the pp_installation_location/configuration/samples directory.
  2. Choose a sample file to open in an editor:
    • To use a cryptographic provider, open the Cryptography_language_code.xml file.
    • To send log messages somewhere other than a file, open the Logging_language_code.xml file.
    • To use a medium or large template for the amount of resources the Cognos PowerPlay process uses, open the CognosService_language_code.xml file.
  3. Copy the elements that you need.
    Tip: Ensure that you copy the code including the start and end tags for the <crn:instance> element.
  4. Go to the pp_installation_location/configuration directory.
  5. Open the cogstartup.xml file in an editor.
  6. Paste the code from the sample file to the cogstartup.xml file and replace the appropriate <crn:instance> element.
  7. Change the values of these new elements to suit your environment.

    For the <crn:instance> element, do not change the class attribute. You can change the name attribute to suit your environment.

  8. Save and close the file.
  9. Run IBM Cognos Configuration in silent mode by typing the following command:

    ./cogconfig.sh -s

    This ensures that the file is valid and that passwords are encrypted.