Skip Headers
Oracle® Argus Insight Installation Guide
Release 7.0.1

E28479-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

6 Configuring the Cognos 8 Environment

This chapter describes how to configure the Cognos 8 environment. You must configure the Cognos 8 environment in the order specified in this guide.

This chapter includes the following topics:

If you are using BusinessObjects XI instead of Cognos 8, see Chapter 7 for information about configuring the BusinessObjects environment for Argus Insight.

Before attempting to configure the environment, verify that you have installed all required hardware and software. For more information, see Section 1.2, "Software and Hardware Requirements."

6.1 Upgrading Cognos Server for Argus Insight 7.0.1

This section describes the following tasks that you must complete if you are upgrading your Cognos Server for Argus Insight 7.0.1:

6.1.1 Configuring Custom Java Authentication

To configure custom Java authentication:

  1. Go to IBM Cognos Administration and stop the Cognos services.

  2. Navigate to the following folder:

    \\Cognos_Server\Argus_Insight_Install_Path\Java Authentication\JDBC_PowerReports

  3. Copy the CAM_AAA_JDBC_PowerReports.jar file from that folder to the following location on the Cognos 8 Server:

    \\Cognos_8_Install_Path\ c8\webapps\p2pd\WEB-INF\lib

  4. Define the configuration parameters:

    1. Navigate to the following folder:

      \\Cognos_8_Install_Path\ c8\Configuration

    2. Open the JDBC_Config_PowerReports.properties file for editing.

    3. Modify the existing values of the following parameters only if the database changed from the 7.0 database:

      Parameter Value to Enter
      Server Enter the IP address or the name of the Database Server.
      SID Enter the instance/service name of the Argus Insight data mart.
      Port Enter the database port number.

    4. Save and close the file.

  5. Navigate to the following folder:

    Program Files\cognos\c8\bin\jre\1.5.0\lib\security

  6. Backup the following two JAR files:

    • local_policy.jar

    • US_export_policy.jar

  7. Go to the following URL:

    https://www14.software.ibm.com/webapp/iwm/web /preLogin.do?source=jcesdk

    Note:

    You will need the user ID and password from IBM Cognos to download the files required in next step.
  8. Log in to the IBM site.

  9. Select the Unrestricted JCE Policy files for SDK for all newer versions (1.4.2+) option and click Continue.

  10. Click I agree to agree to the license terms and then check I confirm.

  11. Click the Download Now link.

  12. Download the files and extract into a folder.

  13. Locate the following two JAR files in the extract folder:

    • local_policy.jar

    • US_export_policy.jar

  14. Copy those jar files into the following folder:

    Program Files\cognos\c8\bin\jre\1.5.0\lib\security

  15. Go to IBM Cognos Administration and restart the Cognos services.

6.1.2 Deleting Data Resources and Packages

If you are upgrading from Argus Insight 7.0 to Argus Insight 7.0.1, you need to delete the data sources and packages that are no longer supported.

To delete the obsolete data sources and packages:

  1. Go to IBM COGNOS Administration.

  2. Click the Configuration tab and delete the following data sources:

    • Administration Statistics

    • Clinical Trial Analysis

    • Medical Analysis

    • Submission Statistic

    • Overdose-Pregnancy-Interaction

  3. Navigate to Public Folders, ArgusInsight, Packages, and then delete the following packages:

    • Administration Statistics

    • Clinical Trial Analysis

    • DrillThrough

    • Medical Analysis

    • Overdose-Pregnancy-Interaction

    • Submission Statistics

6.1.3 Deleting Folders and Reports

If you are upgrading from Argus Insight 7.0 to Argus Insight 7.0.1, you need to delete numerous folders and reports that are no longer supported.

To delete the obsolete folders and reports:

  1. Go to IBM COGNOS Administration.

  2. Navigate to Public Folders, ArgusInsight, and then delete the DrillThrough folder.

  3. Navigate to Public Folders, ArgusInsight, and select Compliance.

    1. Delete the Analysis folder.

    2. Navigate to the Reports subfolder. Delete the Compliance reports listed in Table 6-1.

      Table 6-1 Compliance Reports to Delete

      KPI List Report Country Group 2

      Outstanding Report Submission by Responsible Group Listing - Detail

      KPI Overview Report Group 1

      Outstanding Report Submission by Responsible Group Listing - Summary

      KPI Overview Report Group 2

      Outstanding Report Submissions by Destination Listing - Detail

      Labeling Detail Listing by Case Number

      Outstanding Report Submissions by Destination Listing - Summary

      Labeling Detail Listing by Preferred Term

      Reporting Compliance by Destination (Count)

      Labeling Summary

      Reporting Compliance by Destination (Percentage)

      Outstanding Expedited Reports by Responsible Group

      Reporting Compliance by Responsible Group

       

      Reports Out of Compliance with Delayed Workflow Detail


  4. Navigate to Public Folders, ArgusInsight, Configuration, and select Reports. Delete the Configuration reports listed in Table 6-2.

    Table 6-2 Configuration Reports to Delete

    Workflow Configuration by State

    Workflow Configuration by Transition


  5. Navigate to Public Folders, ArgusInsight, and select General.

    1. Delete the Analysis folder.

    2. Navigate to the Reports subfolder. Delete the General reports listed in Table 6-3.

      Table 6-3 General Reports to Delete

      Case Count by Reporter Type

      Relevant Medical History Listing

      Case Narrative Listing - Multilingual

      SAE Clinical Trial Co-Medication

      Case Origin Listing

      SAE Clinical Trial Laboratory Test

      Clinical Medical Review List

      SAE Clinical Trial Medical Conditions

      Detailed Line Listing by SOC

      SAE Clinical Trial Project Overview

      Downgraded Reports Listing

      Simple Line Listing by SOC

      Literature Listing

      Simple Line Listing by Case Number


  6. Navigate to Public Folders, ArgusInsight, and select Management.

    1. Delete the Analysis folder.

    2. Navigate to the Reports subfolder. Delete the Management reports listed in Table 6-4.

      Table 6-4 Management Reports to Delete

      Case Load History by Day

      Cases by Reporter Type Tabulation

      Case Load History by Month

      Delayed Workflow Listing by Case

      Case Load History by Quarter

      Delayed Workflow Listing by Workflow State

      Case Load History by Week

      First and Last Reporter Contact

      Case Load History by Year

      Listing of Cases Due for Lock

      Case Processing Times Listing

      Listing of Cases Late for Lock

      Case Seriousness Distribution

      Product Tabulation by Site and Case Source

      Case Seriousness Distribution Graphical Summary

      Report Volume History

      Case Volume by Reporter Type

      Reports by Causality

      Case Volume History (Reporter Type)

      Reports by Month

      Case Volume History (Seriousness)

      Reports by Product Family

      Case Volume History - Initial and Significant Follow-up

      Reports by Seriousness

      Case Volume History split by Initial and Follow-up

      Reports by Year


  7. Navigate to Public Folders, ArgusInsight, and select Pharmacovigilance.

    1. Delete the Analysis folder.

    2. Navigate to the Reports subfolder. Delete the Pharmacovigilance reports listed in Table 6-5.

      Table 6-5 Pharmacovigilance Reports to Delete

      Age Group vs. Gender

      Event (PT) vs. Duration of Treatment until Event

      Aggregate Diagnosis Listing

      Event vs. Duration of Treatment until Event

      Annual Product Review

      Event vs. Report Type

      Case Listing

      Fatal Case Listing

      Case Listing with all Regimens and Events

      Fatal/Life-Threatening Cases Listing

      Clinical Case Listing

      Frequency Listing of Events

      Clinical Trial Causality

      Gender Group by Age Group

      Data Quality Indicator (Alphabetically by Quality Indicator)

      MedDRA SOC-PT Group by Age Group

      Data Quality Indicator (Ascending Order of Count)

      MedDRA SOC-PT Group by Daily Dose

      Data Quality Indicator Listing

      MedDRA SOC-PT Group by Gender

      Dechallenge and Rechallenge Listing

      MedDRA SOC-PT Group Report Type, Event Seriousness, Causality

      Dosage Frequency Tabulation

      Product and Disease Listing

      Dose Formulation Product Relationship

      Seriousness Case Listing

      Duration of Treatment until Event (Time to Onset) per Event

      Temporal Relationships

      Event (PT) vs. Daily Dose

      Top 10 Substances


  8. Delete the Analysis folder from each Enterprise specific folder.

6.1.4 Importing the Content Repository for an Upgrade

Skip to Section 6.2.6, "Importing the Content Repository" to complete the final steps for the upgrade.

6.2 Setting Up Cognos Server and Configuration for New Installation

This section describes how to set up Cognos Server and configure your environment for a new installation of Argus Insight.

If you are upgrading from Argus Insight 7.0, see Section 6.1, "Upgrading Cognos Server for Argus Insight 7.0.1" for the installation procedures.

6.2.1 Configuring IIS 7.0 on the Cognos 8 Server

This section describes the following tasks that you must complete to configure Internet Information Services 7.0 (IIS 7.0) on the Cognos 8 Server:

6.2.1.1 Checking that CGI or ISAPI Is Enabled in IIS

To check that CGI or ISAPI is enabled in IIS:

  1. Click Start.

  2. Navigate to Administrative Tools and select Server Manager. The Server Manager window opens. Surrounding text describes smgr_roles1.gif.

  3. Click the Add Role Services link to the right of the Role Services section. The Add Role Services dialog box opens.

    Surrounding text describes iis_cognos_addrole.gif.
  4. Expand Application Development (Installed).

  5. Verify that the CGI and ISAPI Extensions are listed as (Installed).

    • If these role services are not installed, select the appropriate check box and then click Install. Follow the instructions on the screen to complete the installation.

    • If these role services are already installed, click Cancel. The system returns to the Server Manager window.

6.2.1.2 Creating the Cognos 8 Virtual Directories

To create the Cognos 8 virtual directories:

  1. Navigate to Roles, Web Server (IIS), and select Internet Information Services (IIS) Manager.

  2. Expand the server node in the Connections pane.

  3. Expand Sites.

    Surrounding text describes cognos_vir_directory1.gif.
  4. Right-click Default Web Site, and select Add Virtual Directory. The Add Virtual Directory dialog box opens.

    Surrounding text describes cognos_vir_directory2.gif.
    1. In the Alias field, enter Cognos 8.

    2. In the Physical path field, enter the complete path to the Cognos 8 Web content directory. The default path is:

      drive:\Program Files\cognos\c8\webcontent

    3. Click OK.

  5. Right-click your newly-created Cognos 8 virtual directory and select Add Virtual Directory. The Add Virtual Directory dialog box opens.

    1. In the Alias field, enter cgi-bin.

    2. In the Physical path field, enter the complete path to the Cognos 8 cgi-bin directory. The default path is:

      drive:\Program Files\cognos\c8\cgi-bin

    3. Click OK.

6.2.1.3 Editing ISAPI or CGI Extensions

To edit the ISAPI or CGI extensions:

  1. Select the server node in the Connections pane.

    Surrounding text describes iis_cognos_isapi_cgi.gif.
  2. Double-click the ISAPI and CGI Restrictions icon.

  3. Click the Add link in the Actions pane. The Edit ISAPI or CGI Restriction dialog box opens.

    Surrounding text describes iis_cognos_edit_res.gif.
    1. In the ISAPI or CGI path field, enter the path to either the cognos.cgi file or the cognosisapi.dll file depending on which one you will use.

      Note:

      For Argus Insight, Oracle recommends that you use cognos.cgi. In addition, you may need to surround the path in double quotes if it contains any spaces.

      The default path for each file is as follows:

      drive:\Program Files\cognos\c8\cgi-bin\cognosisapi.dll

      drive:\Program Files\cognos\c8\cgi-bin\cognos.cgi

    2. Select the Allow extension path to execute check box.

    3. Click OK.

Alternative Method

  1. Select the server node in the Connections pane.

  2. Double-click the ISAPI and CGI Restrictions icon.

  3. Click the Edit Feature Settings link in the Actions pane. The Edit ISAPI and CGI Restriction Settings dialog box opens.

    Surrounding text describes iis_cognos_edit_res2.gif.
  4. Select the Allow unspecified CGI Modules check box.

  5. Click OK.

6.2.1.4 Adding the Module Mapping

To add the module mapping:

  1. Open the Internet Information Services (IIS) Manager.

  2. Expand the virtual directory folder and click the cgi-bin virtual directory.

  3. Double-click the Handler Mappings icon.

  4. Click the Add Module Mapping link in the Actions pane. The Add Module Mapping dialog box opens.

    Surrounding text describes iis_cognos_add_mod.gif.
    1. In the Request path field, enter either *.cgi or *.dll depending on which one you need.

    2. In the Module field, select either CGIModule or IsapiModule from the list.

    3. In the Executable field, you enter a value depending on the module you are using.

      If you are using an ISAPI Module, you must enter the complete path to the cognosisapi.dll. You can click the ellipsis icon to browse to the file location.

      If you are using a CGI Module, you do not need to enter a value into the Executable field.

    4. In the Name field, enter a realistic name for this mapping. For example, ISAPI-Cognos.

  5. Click Request Restrictions.

    1. Click the Mapping tab, and select Invoke handler only if request is mapped to: File.

      Surrounding text describes iis_cognos_map_tab.gif.
    2. Click the Verbs tab, and select All verbs.

      Surrounding text describes iis_cognos_verbs_tab.gif.
    3. Click the Access tab, and select Specify the access required by the handler: Execute.

      Surrounding text describes iis_cognos_acc_tab.gif.
    4. Click OK to save your changes. The system returns to the Add Module Mapping dialog box.

  6. Click OK.

    Depending on the method used in Section 6.2.1.3, "Editing ISAPI or CGI Extensions," the system may display the following message:

    Surrounding text describes iis_cognos_mm_msg.gif.
  7. Click Yes. Your new module mapping should be added to the Module Mapping List.

6.2.1.5 Editing the Module Mapping

For Cognos Administration to function properly, you must manually edit the directive that you added to the IIS configuration file in the previous step (see Section 6.2.1.4, "Adding the Module Mapping").

To edit the module mapping:

  1. Navigate to the following folder:

    COGNOS_HOME/c8/cgi-bin

    Note:

    Ensure that you have access permissions on the cgi-bin folder so you can save the changes you make to the web.config file.
  2. Open the web.config file for editing.

  3. Locate the appropriate add name statement in the web.config file depending on whether you are using CGI or ISAPI.

    For CGI, locate this statement:

    <add name="CGI-cognos" path="*.cgi" verb="*" modules="CgiModule" resourceType="Unspecified" />

    For ISAPI, locate this statement:

    <add name="ISAPI-Cognos" path="cognosisapi.dll" verb="*" modules="IsapiModule" scriptProcessor="E:\Program Files\Cognos\C84_64\cgi-bin\cognosisapi.dll" resourceType="Unspecified" requireAccess="Execute" preCondition="bitness32" />

  4. Add allowPathInfo="true" to the end of the statement.

    For CGI:

    <add name="CGI-cognos" path="*.cgi" verb="*" modules="CgiModule" resourceType="Unspecified" allowPathInfo="true" />

    For ISAPI:

    <add name="ISAPI-Cognos" path="cognosisapi.dll" verb="*" modules="IsapiModule" scriptProcessor="E:\Program Files\Cognos\C84_64\cgi-bin\cognosisapi.dll" resourceType="Unspecified" requireAccess="Execute" preCondition="bitness32" allowPathInfo="true"/>

  5. Save your changes and close the web.config file.

6.2.1.6 Allowing CGI Application to Use Execute

To allow the CGI application to use execute:

  1. Open the Internet Information Services (IIS) Manager.

  2. Expand the virtual directory folder and click the cgi-bin virtual directory.

  3. Double-click the Handler Mappings icon.

  4. Click the Edit Feature Permissions link in the Actions pane. The Edit Features Permissions dialog box opens.

    Surrounding text describes iis_cognos_permissions.gif.
  5. Select the Execute check box.

  6. Click OK.

6.2.2 Configuring the Java Database Components

To configure the Java Database Components (JDBC) in the Cognos 8 environment:

  1. Navigate to the following Oracle installation path:

    Oracle_Installation_Path\product\Oracle_Version\client_1\sqldeveloper\jdbc\lib

  2. Copy the ojdbc5.jar file to the following location on the Cognos 8 environment:

    Cognos_Installation_Path\c8\webapps\p2pd\web-inf\lib

6.2.3 Copying the Authentication Settings for Report Writer

To copy the authentication settings for Report Writer:

  1. Navigate to the following location on the Argus Insight Web Server:

    \\Argus_Insight_Installation_Path\ArgusInsight\ASP\Reports

  2. Copy the PR.asp file to the following location on the Cognos 8 Server:

    \\Cognos_8_Installation\cognos\c8\cgi-bin

6.2.4 Configuring Custom Java Authentication

To configure custom Java authentication:

  1. Copy the CAM_AAA_JDBC_PowerReports.jar file from this location:

    \\Cognos_Server\Argus_Insight_Install_Path\Java Authentication\JDBC_PowerReports

    To this location on the Cognos 8 Server:

    \\Cognos_8_Install_Path\ c8\webapps\p2pd\WEB-INF\lib

  2. Copy the JDBC_Config_PowerReports.properties file from this location:

    \\Cognos_Server\Argus_Insight_Install_Path\Java Authentication\JDBC_PowerReports

    To this location on the Cognos 8 Server:

    \\Cognos_8_Install_Path\ c8\Configuration

  3. Define the configuration parameters:

    1. Go to the Cognos Server.

    2. Open the JDBC_Config_PowerReports.properties file for editing.

    3. Modify the existing values of the following parameters:

      Parameter Value to Enter
      Server Enter the IP address or the name of the Database Server.
      SID Enter the instance/service name of the Argus Insight data mart.
      Port Enter the database port number.

    4. Save and close the file.

  4. Copy the ContentStore.zip file from this location:

    \\Cognos_ 8_Server_Name\Argus_Insight_Install_Path\Cognos 8\Contentstore

    To this location on the Cognos 8 Server:

    \\Cognos_8_Install_Path\ c8\Deployment

  5. Navigate to the following folder:

    Program Files\cognos\c8\bin\jre\1.5.0\lib\security

  6. Backup the following two JAR files:

    • local_policy.jar

    • US_export_policy.jar

  7. Go to the following URL:

    https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk

    Note:

    You will need the user ID and password from IBM Cognos to download the files required in next step.
  8. Log in to the IBM site.

  9. Select the Unrestricted JCE Policy files for SDK for all newer versions (1.4.2+) option and click Continue.

  10. Click I agree to agree to the license terms and then check I confirm.

  11. Click the Download Now link.

  12. Download the files and extract into a folder.

  13. Locate the following two JAR files in the extract folder:

    • local_policy.jar

    • US_export_policy.jar

  14. Copy those jar files into the following folder:

    Program Files\cognos\c8\bin\jre\1.5.0\lib\security

6.2.5 Configuring the Cognos 8 Environment

This section describes the following tasks that you must complete to configure the Cognos 8 environment:

6.2.5.1 Opening the IBM Cognos 8 Configuration Window

You use the options in the IBM Cognos 8 Configuration window to define environment group and logging properties, security properties, and data access properties.

To open the IBM Cognos 8 Configuration window:

  1. Click Start.

  2. Navigate to All Programs, IBM Cognos 8, and then select IBM Cognos Configuration. The IBM Cognos Configuration window opens.

    Surrounding text describes cc1.gif.

    Note:

    The windows displayed during the Cognos 8 configuration are labeled either IBM Cognos 8 or Cognos 8. Both labels refer to the same Cognos configuration.

6.2.5.2 Setting the Environment Properties for Cognos 8

To define the environment group properties and the environment logging properties:

  1. Open the IBM Cognos 8 Configuration window.

  2. Select Environment. The system displays the Environment - Group Properties in the right pane.

    Surrounding text describes cc2.gif.
  3. Set the following environment properties to the required value:

    Environment Property Required Value
    Sort buffer size in MB 16
    Gateway URI http://localhost:80/cognos8/cgi-bin/cognos.cgi
    Dispatcher URIs for gateway http://localhost:9300/p2pd/servlet/dispatch/ext
    Controller URI for gateway http://localhost:80/cognos8/controllerServer
    External dispatcher URI http://localhost:9300/p2pd/servlet/dispatch
    Internal dispatcher URI http://localhost:9300/p2pd/servlet/dispatch
    Content Manager URIs http://localhost:9300/p2pd/servlet
    Dispatcher URI for external applications http://localhost:9300/p2pd/servlet/dispatch

  4. Navigate to Environment and select Logging. The system displays the properties for the Logging component.

    Surrounding text describes cc3_cropped.gif.
  5. Set the following logging properties to the required value:

    Logging Property Required Value
    Local log server port number 9362
    Enable TCP? False
    Local log server worker threads 10

6.2.5.3 Setting the Security Properties for Cognos 8

To define the security properties:

  1. Open the IBM Cognos 8 Configuration window.

  2. Navigate to Security, Authentication, and select Cognos.

    Surrounding text describes cc4.gif.
  3. Set the Allow anonymous access? property to True.

  4. Navigate to Security and select IBM Cognos Application Firewall.

    Surrounding text describes cc5.gif.
  5. Set the Enable CAF validation? property to False.

6.2.5.4 Setting the Data Access Properties for Cognos 8

To define the data access properties:

  1. Open the IBM Cognos 8 Configuration window.

  2. Navigate to Data Access, Content Manager, right-click Content Store, and then select Delete from the menu.

    Surrounding text describes cc6_cropped.gif.

    The system prompts for confirmation that you want to delete the Content Store.

  3. Click Yes.

  4. Navigate to Data Access, right-click Content Manager, select New resource, and then select Database.

    Surrounding text describes cc8_cropped.gif.
  5. Complete the New Resource - Database dialog box as follows:

    • In the Name field, type CNTSTORE. This is the name of the database resource.

    • In the Type field, select Oracle database.

    • Click OK.

    The system returns to the IBM Cognos Configuration window, selects the newly-created CNTSTORE resource database, and displays the resource properties for the database.

    Surrounding text describes cc10.gif.
  6. Enter the value for the Database server and port number as:

    Database_Server_Name:1521

    where:

    Database_Server_Name is the name of the server where your content store database is stored.

  7. Select User ID and password, and click the icon next to it. The Value - User ID and password dialog box opens.

    Surrounding text describes cc11.gif.
    1. In the User ID field, type the ID for the content store database user.

    2. In the Password field, type the password for the content store database user.

    3. In the Confirm password field, re-enter the password for verification.

    4. Click OK.

      Note:

      The contents store database user is created in the Cognos content store database. This user is given grants of Connect, Resource, and Create View, along with Unlimited Tablespace Grant.

      The character set of the Cognos content store database should only be UTF.

      Make sure that the content store database entry is added in the TNSNames.ora file on the Cognos 8 server.

  8. Enter the database instance name for the Cognos 8 repository in the Service name field.

    Surrounding text describes cc12.gif.

6.2.5.5 Creating the Namespace for Argus Insight Authentication

To create the namespace for Argus Insight authentication:

  1. Open the IBM Cognos 8 Configuration window.

  2. Navigate to Security, right-click Authentication, click New resource, and then select Namespace.

    Surrounding text describes cc13_cropped.gif.
  3. Complete the New Resource – Namespace dialog box as follows:

    • In the Name field, type PowerReports.

    • In the Type field, type Custom Java Provider.

    • Click OK.

    The PowerReports - Namespace - Resource Properties window opens.

    Surrounding text describes cc15.gif.
  4. Set the Namespace ID property to PowerReports.

  5. Set the Java class name property to JDBCPowerReports.

6.2.5.6 Saving Your Configuration and Starting the Cognos 8 Service

To save the configuration and start the Cognos 8 service:

  1. Open the File menu and select Save to save your changes to the configuration settings. The system displays the following dialog box and lists each task as it is performed:

    Surrounding text describes cc16.gif.
  2. Click Close when the system completes all the configuration tasks.

  3. Click the Start icon in the IBM Cognos Configuration window to run the Cognos 8 service.

    Surrounding text describes cc17.gif.

    The system begins to run the IBM Cognos 8 service.

    • If there are no problems with the configuration, the system completes the test phase and starts the IBM Cognos 8 service successfully.

    • If there are possible problems with the configuration, the system stops running the service and displays a warning message. When you click OK to acknowledge the warning message, the system opens another dialog box with more information. For example:

    Surrounding text describes cc19.gif.

    At this point, you can:

    • Click Details for more information about the warnings and errors.

    • Click Cancel to stop the process. If the warnings or errors are due to reasons other than mail server connection failure, cancel the process and check your configuration again.

    • Click Continue to ignore the warnings and errors, and complete the process of starting the IBM Cognos 8 service. For example, you can ignore warnings that the mail server cannot be reached (see the previous illustration).

  4. Click Close to exit.

  5. Open the File menu and select Exit to exit from the IBM Cognos 8 configuration.

6.2.6 Importing the Content Repository

Note:

If your security settings on the server do not permit you to view the Cognos connection, add the site URL (http://Cognos_8_Server/cognos8) to the list of local intranet sites.

To import the content repository to the database:

  1. Log in to the IBM Cognos 8 Server as a user with administrator privileges.

  2. Start Internet Explorer.

  3. Enter the URL in the following format:

    http://Cognos_8_Server/cognos8

    The IBM Cognos 8 main window opens.

    Surrounding text describes cogconf1.gif.
  4. Click Administer IBM Cognos content. The IBM Cognos Administration window opens.

  5. Click the Configuration tab.

  6. Click the Content Administration link. The Content Administration window opens.

    Surrounding text describes cogconf5.gif.
  7. Click the New Import icon. The system starts the New Import wizard.

  8. Click Next to continue. The wizard prompts for the encryption password.

  9. Type the password and click OK. The wizard prompts for the name, description, and location of the Argus Insight deployment.

    Surrounding text describes cogconf9.gif.
  10. Leave the default values and click Next to continue. The wizard prompts you to select the public folders content.

    Surrounding text describes cogconf10.gif.
  11. Select the Name check box to choose all the check boxes in this category, and click Next.

    The wizard prompts you to select the directory content and options to include in the import.

    Surrounding text describes cogconf12.gif.
  12. Select the directory content and options to include in the import. The options that you select depends on whether you are performing a new install or an upgrade.

    Directory Content and Options New Install Upgrade
    Include Cognos groups and roles Selected NOT selected
    Include distribution lists and contacts NOT selected NOT selected
    Include data sources and connections Selected NOT selected
    Include signons Selected NOT selected

  13. Click Next. The wizard prompts you to specify the general options.

    Surrounding text describes cogconf13.gif.
  14. Set the Access permissions depending on whether you are performing a new install or an upgrade:

    • If you are performing a new install, you MUST select the Include access permissions check box.

    • If you are performing an upgrade, do NOT select the Include access permissions check box.

  15. Verify that the remaining general options are set as follows:

    • For External namespaces, verify that Do not include references to external namespaces is selected, but dimmed.

    • For Entry ownership, set the owner to The user performing the import and apply to New and existing entries.

    • For the Deployment record, select Basic for the Recording level.

  16. Click Next. The wizard displays the summary screen.

    Surrounding text describes cogconf14.gif.
  17. Review the summary information, and click Next. The wizard prompts you to select the type of New Import action.

    Surrounding text describes cogconf15.gif.
  18. Select the Save and run once option, and click Finish. The wizard prompts you to selection the options for this import.

  19. Select Upgrade all report specifications to the latest version and click Run. The wizard summarizes your selection for this import.

  20. Click OK to run the import.

  21. Verify the import as follows:

    1. Click More corresponding to the newly imported Content Store.

    2. Click View run history to view the deployment history.

    3. Verify that the Status column displays the status as Succeeded.

    4. Click Close to exit.

The repository import is complete.

Note:

If the database changed from the 7.0 database, you must also update the source data information after importing the content repository. Skip to Section 6.2.7.2, "Editing Sign On" for instructions.

6.2.7 Configuring Cognos Security

This section includes the following topics:

6.2.7.1 Configuring Cognos Users and Roles

To configure Cognos user and roles:

  1. Set up an administrator user in the Cognos environment. An administrator user is an Argus Insight user who is part of the system administrator role.

    Surrounding text describes cog15.gif.
  2. Log in to Argus Insight as a user with administrator privileges.

  3. Click the Tools tab in the upper-right corner of the Argus Insight Home page to open the ADMINISTRATION TOOLS page.

  4. Click the List Maintenance tab.

  5. Select Profile Switches from the List Maintenance Items group.

  6. Define the COGNOS ADMIN USER attribute.

    1. Select COGNOS ADMIN USER from the Attributes group.

    2. Click Modify. The following Modify Attribute dialog box opens:

      Surrounding text describes aimod1.gif.
    3. Enter the value for the Cognos administrator user.

    4. Click OK to save your changes and return to the List Maintenance tab.

  7. Define the COGNOS ADMIN PASSWORD attribute.

    1. Select COGNOS ADMIN PASSWORD from the Attributes group.

    2. Click Modify. The following Modify Attribute dialog box opens:

      Surrounding text describes aimod2.gif.
    3. Click the Value field, and type the password for the Cognos administrator.

    4. Re-type the password in the Confirm Password field for verification.

    5. Click OK to save your changes and return to the List Maintenance tab.

  8. Verify that the following List Maintenance entries are configured.

    • COGNOS SERVER

    • COGNOS ADMIN USER

    • COGNOS ADMIN PASSWORD

    This role will have all rights required to run various parts of Argus Insight application. All Insight users will become part of this role during their first login.

  9. Define the COGNOS USER ROLE NAME attribute.

    1. Select COGNOS USER ROLE NAME from the Attributes group.

    2. Click Modify. The following Modify Attribute dialog box opens:

      Surrounding text describes aimod3.gif.
    3. Click the Value field, and type the Cognos User Role Name you want to create in Cognos environment.

    4. Click OK to save your changes and return to the List Maintenance tab.

The system adds the newly configured role to the following roles:

  • Analysis Users

  • Query User

  • Author

6.2.7.2 Editing Sign On

To edit your sign-on information:

  1. Log in to the Cognos 8 Server as an administrator user.

  2. Start Internet Explorer.

  3. Type the URL in the following format and press Enter:

    http://Cognos_8_Server/cognos8

    The IBM Cognos 8 home page opens.

    Surrounding text describes cogconf1.gif.

    Note:

    If your security settings on the server do not permit you to view the Cognos connection, add the site URL (http://Cognos_8_ Server/cognos8) to the list of local intranet sites.
  4. Click Administer IBM Cognos content. The IBM Cognos Administration window opens.

    Surrounding text describes ibm1.gif.
  5. Click the Configuration tab.

  6. Click Data Source Connections and click PRMART.

    Surrounding text describes cog2a.gif.
  7. Click PRMART.

  8. Click the More link to the right of the PRMART link. The Perform an action - PRMART pane opens.

    Surrounding text describes cog2c.gif.
  9. Click Set properties. The Set properties page for PRMART opens.

    Surrounding text describes cog2f.gif.
  10. Click the Signon tab.

  11. Click the Edit the signon link. The system opens the following pane:

    Surrounding text describes cog2h.gif.
    1. In the User ID field, type the ID for the APR_APP user.

    2. In the Password field, type the password for the APR_APP user.

    3. In the Confirm Password field, re-type the password for verification.

    4. Click OK to set the password.

  12. Click OK again to return to this screen:

    Surrounding text describes cog2j.gif.
  13. Click the PRMART link, click the More link, and then click Set properties.

  14. Click the Connection tab. The system displays the following information:

    Surrounding text describes cog2n.gif.
  15. Click the pencil icon to edit the connection string. The system displays the Edit the connection string - Oracle pane.

    Surrounding text describes cog2o.gif.
  16. Set the following information in the SQL*Net connect strings field:

    • Set the HOST as the Argus Insight Database Server Name.

    • Set the PORT as the Argus Insight Database Port Number.

    • Set the SERVICE_NAME as the Argus Insight Database Instance Name.

  17. Click the Test the connection link. Wait until the system opens the Test the connection - PRMART pane and then click Test.

    Surrounding text describes cog2p.gif.
  18. Wait for the testing results and verify that the connection succeeded.

    Surrounding text describes cog2q.gif.
  19. Click Close.

  20. Click Close.

  21. Click OK.

  22. Click OK.

6.2.7.3 Activating the PowerReports Namespace

To activate the PowerReports namespace:

  1. Open the Cognos 8 configuration.

  2. Click Start, All Programs, IBM Cognos 8, and then select IBM Cognos Configuration. The IBM Cognos Configuration window opens.

  3. Navigate to Security, Authentication, and then select Cognos. The system displays the Cognos - Namespace - Resource properties pane.

  4. Set the Allow Anonymous access? property to False.

    Surrounding text describes coco2.gif.
  5. Open the File menu and select Save.

  6. Open the Actions menu and select Restart to restart the Cognos 8 service. The system displays status information about each task being performed during the restart.

    Surrounding text describes cc19.gif.

    During the Cognos service restart, the system may display the following message if there are any warnings:

    Surrounding text describes cc18.gif.
  7. Process any warning message as follows:

    1. Click OK.

    2. Click Details to obtain more information about the warning.

      Depending on the type of warning, you can:

      — Click Continue to ignore the warning and continue with the process of restarting the IBM Cognos 8 service. For example, you may want to ignore a warning that the connection to the mail server failed.

      — Click Cancel to stop the restart process. If the warnings are due to reasons other than a mail server connection failure, you should stop the process, check your configuration, and then restart the IBM Cognos 8 service.

  8. Wait until the system performs all the configuration tasks and displays the status for each task.

    Surrounding text describes coco6.gif.
  9. Click Close to exit the Cognos configuration.

    Note:

    Make sure that you remove the Everyone user group from the Directory Administrator and System Administrator roles of Cognos. Before doing this, make sure that you have a valid user as part of the System Administrator role in Cognos.

    If you have not added any user as part of the System Administrator role in Cognos, then you have to add Everyone user group in System Administrator roles of Cognos again.

    To add the Everyone user group in the System Administrator role of Cognos:

    1. Connect to the Content Store database as the content store user.

    2. Navigate to the following folder:

      Cognos_Installation_Path\c8\configuration\schemas\content

    3. Run the AddSysAdminMember.sql script.

    4. Commit the changes.

6.2.8 Configuring the LDAP Settings

This section describes how to integrate the LDAP authentication with Argus Insight and Cognos. Be sure to follow all installation procedures in the specified order:

6.2.8.1 Configuring the Active Directory

To configure the Active Directory on the Cognos Server:

  1. Go to Cognos Server and open the Cognos configuration.

  2. Navigate to Security, Authentication, and then add a namespace.

  3. Select Active Directory as the Type.

  4. Configure the Active Directory NameSpace.

  5. Provide the Bind credentials, save the configuration, and restart the Cognos service.

    Surrounding text describes act1.gif.
  6. Click Modify and set the value to 1.

6.2.8.2 Configuring LDAP in COGNOS for SunOne

To configure LDAP for Active Directory:

  1. Configure SunOne on Cognos 8 Server.

  2. Go to Cognos Server and open the Cognos configuration.

  3. Navigate to Security, Authentication, and then add a namespace.

  4. Select LDAP as the Type.

  5. Configure the SunOne NameSpace.

  6. Enter NameSpaceID, Host and Port, Base Distinguish Name, user lookup as "uid=$(user ID)" and unique identifier as "uid." No need to enter any bind credentials.

    Surrounding text describes act2.gif.
  7. Save the Cognos configuration and restart the Cognos service.

6.2.8.3 Setting Up the Cognos LDAP Configuration in Argus Insight

  1. Log in to the Argus Insight application.

  2. Click the Tools tab in the upper-right corner of the Argus Insight Home page to open the ADMINISTRATION TOOLS page.

  3. Click the List Maintenance tab.

  4. Select LDAP from the List Maintenance Items group. The system updates the right panel with the list of attributes that you can configure.

  5. Select the Cognos LDAP Name Space Configuration attribute and click Modify. The Modify Cognos LDAP Namespace Configuration window opens.

    Surrounding text describes ai1.gif.
  6. Click Add. The Modify Cognos LDAP Namespace Configuration dialog box opens.

    Surrounding text describes ai2.gif.
  7. Complete the Modify Cognos LDAP Namespace Configuration dialog box as follows:

    1. In the LDAP Server Alias field, select the LDAP server from the list. This field lists the LDAP servers configured in Argus Safety.

    2. In the Namespace ID field, type the namespace identifier for either Active Directory or SunOne (whichever you have configured in Cognos).

    3. In the User Name field, type the name of the Cognos and Insight user who is part of a configured LDAP namespace in Cognos and is a Cognos administrator.

    4. In the Password field, type the password for the configured Cognos administrator user.

    5. In the Confirm Password field, re-type the password for verification.

    6. Click OK to save the Cognos LDAP Namespace configuration.

6.2.8.4 Setting Up Report Packages for Cognos LDAP

When Cognos is configured for LDAP authentication, Argus Insight requires a different set of packages and models for Release 7.0.1.

To publish the report packages required for running reports on Cognos with LDAP:

  1. Go to Cognos Server.

  2. Open the Framework Manager:

    1. Click Start.

    2. Navigate to All Programs, IBM Cognos8, and select Framework Manager.

  3. Open the File menu and select Open.

  4. Navigate to the following location:

    Argus_Insight_Installation_Directory\Oracle\ArgusInsight\Cognos8\Models\LDAP Models

  5. Open the Compliance folder.

  6. Select the Compliance.cpf file, and then click Open.

  7. Select the configured LDAP namespace to authenticate user.

  8. Enter the user credentials to log in.

  9. Open the View menu and select Project Viewer.

    1. In the Project Viewer pane, click Packages.

    2. In the project tree, select Packages, right-click Compliance, and then select Publish Packages. The Publish wizard opens.

  10. Click Next to continue through each of the Publish wizard screens until you have the option to publish the package.

  11. Click Publish.

    The system displays a message that a package with that name already exists and prompts if you want to overwrite the package.

  12. Complete the publish process as follows:

    1. Click Yes to overwrite the package.

    2. Click Finish.

    3. Click Close to exit from the Publish wizard.

  13. Open the File menu and click Close. When the system prompts if you want to save the changes you made to the project, click No.

  14. Navigate back to the LDAP Models folder (see Step 4), and repeat the process for each package in the LDAP Models folder:

    • Configuration

    • Custom Compliance

    • General

    • Management

    • Pharmacovigilance

    • Report Writer