Componenten van Cognos Business Intelligence installeren

IBM® Cognos Business Intelligence installeren op de computer waarop u voorheen IBM WebSphere Application Server Network Deployment en de databaseclient hebt geïnstalleerd. Het Cognos-product bestaat uit twee componenten (Cognos BI Server en Cognos Transformer); u moet beide componenten installeren als onderdeel van deze implementatie.

1. Maak een map voor gedeelde netwerken waarbij Cognos Transformer gebruikscijfers kan publiceren (in de vorm van PowerCubes) voor toegang door rapporten.

   De map voor gedeelde netwerken wordt gebruikt als u meerdere Cognos clustert. U kunt de map elke naam geven die u wilt. Leg deze locatie vast zodat u deze kunt toewijzen aan de eigenschap cognos.cube.path wanneer u het bestand bij stap 6 cognos-setup.properties instelt.

   Opmerking: De map wordt alleen naar Cognos gedelegeerd voor het opslaan van de PowerCube, dus het moet een nieuwe map of een bestaande lege map zijn.
2. Bereid het Cognos BI Server-pakket voor:
   1. Download het Cognos BI Server-pakket naar een tijdelijke locatie op de server.
   2. Maak een directory voor het uitgevouwen pakket. Bijvoorbeeld:
      • AIX of Linux: /opt/biserver_10.1.1
      • Windows: C:\biserver_10.1.1
   3. Vouw het pakket uit in de nieuwe directory.
3. Bereid het pakket van Cognos Transformer voor:
   1. Download het pakket van Cognos Transformer naar een tijdelijke locatie op de server.
   2. Maak een directory voor het uitgevouwen pakket. Bijvoorbeeld:
      • AIX of Linux: /opt/transformer_10.1.1
      • Windows: C:\transformer_10.1.1
      Belangrijk: Wegens potentieel conflicterende bestandsnamen kan het Transformer-pakket geen directory delen met het BI Server-pakket. Als u de pakketten op dezelfde locatie uitpakt, worden er bibliotheken overgeschreven. Dit leidt tot een niet-functionerende server.
   3. Vouw het pakket uit in de nieuwe directory.
4. Bereid het pakket voor het instellen van de Cognos-server voor:

   CognosConfig.zip of CognosConfig.tar bevindt zich in de map /Cognos binnen de productmedia van Connections.

   1. Download het CognosConfig-pakket naar een tijdelijke locatie op de server.
   2. Maak een directory voor het uitgevouwen pakket. Bijvoorbeeld:
      • AIX of Linux: /opt/CognosSetup
      • Windows: C:\CognosSetup
   3. Vouw het pakket uit in de nieuwe directory.
5. Stel het JDBC-stuurprogramma in:
   1. Zoek het JDBC-stuurprogramma van type 4 dat is geleverd door uw databaseserver-product.
   2. Kopieer het JDBC-stuurprogramma naar de volgende locatie: /CognosSetup/BI-Customization/JDBC
   Belangrijk: Om Cognos BI verbinding te laten maken met de SQL-server moet u het stuurprogramma Microsoft JDBC Driver 4.0 for SQL Server installeren. Hiermee worden twee versies van JDBC-jar geïnstalleerd: sqljdbc.jar ensqljdbc4.jar. Als deze bestanden zich beide in Lotus_Connections_Install/Cognos/BI-Customization/JDBC bevinden, dan mislukt de verbinding met de SQL-server omdat het erop lijkt dat het standaard de waarde sqljdbc.jar krijgt, maar sqljdbc4.jar is vereist. Verwijder het bestand sqljdbc.jar zodat de Cognos-installatie werkt.
   Opmerking: Als u werkt met DB2v10, moet u ervoor zorgen dat u het jdbc-stuurprogramma v10.1 FP1 of hoger gebruikt. U kunt het stuurprogramma vinden via de technote voor DB2 JDBC-stuurprogrammaversies technote.
6. Bereid het bestand cognos-setup.properties voor door een waarde in te vullen voor iedere eigenschap.

   Het bestand cognos-setup.properties bevindt zich in de directory CognosSetup waar u bij stap 4 het pakket voor het instellen van de Cognos-server hebt uitgevouwen. Dit bestand levert waarden die tijdens de installatie worden gebruikt. Iedere eigenschapsinstelling in het bestand heeft een beschrijving.

   In het bestand worden enkele aan de database gerelateerde eigenschappen gebruikt om een verbinding tot stand te brengen met de databases van Gebruikscijfers en Cognos. Deze instellingen worden gedeeld met alle ondersteunde databasetypen: DB2, Oracle en SQL Server. Dus een bepaalde eigenschap kan een andere betekenis hebben op een ander databasetype. Raadpleeg de tabel van het databasetype van uw voorkeur om deze eigenschappen zorgvuldig in te vullen.

   Tabel 2. DB2-gerelateerde eigenschappen in de cognos-installatie, eigenschappenbestand. Eigenschapsbeschrijvingen voor DB2 waarin ook namen en waarden worden afgebeeld.

   Naam van eigenschap	Waarde	Beschrijving
   cognos.db.type	db2	Geeft het type DB2-database aan.
   cognos.db.host	[DB2_server_hostname]:[Port]	Hostnaam van de DB2-server en de poort van de database-instance die de Cognos-database bevat.
   cognos.db.name	COGNOS	Gemaakt door het installatieprogramma voor de IBM Connections-database.
   cognos.db.user	LCUSER	De aangewezen DB2-databasegebruiker die is vereist in het installatieprogramma van de Connections-database.
   cognos.db.password	[password]	Het wachtwoord van LCUSER.
   metrics.db.type	db2	Geeft het type DB2-database aan.
   metrics.db.host	[DB2_server_hostname]:[Port]	Hostnaam van de DB2-server en de poort van de database-instance die de Gebruikscijfers-database bevat.
   metrics.db.name	METRICS	Gemaakt door het installatieprogramma voor de IBM Connections-database.
   metrics.db.local.name	[Database_alias]	Het alias van de Gebruikscijfers-database dat in een eerdere stap voor De DB2-databaseclient installeren voor Cognos Transformer is gemaakt.
   metrics.db.user	LCUSER	De aangewezen DB2-databasegebruiker die is vereist in het installatieprogramma van de Connections-database.
   metrics.db.password	[password]	Het wachtwoord van LCUSER.

   Tabel 3. Oracle-gerelateerde eigenschappen in de cognos-installatie, eigenschappenbestand. Eigenschapsbeschrijvingen voor Oracle waarin ook namen en waarden worden afgebeeld

   Naam van eigenschap	Waarde	Beschrijving
   cognos.db.type	oracle	Geeft het type Oracle-database aan.
   cognos.db.host	[Oracle_server_hostname]:[Port]	Hostnaam en Poort van de Oracle-databaseserver. Poort is de poort waarop de Oracle-databaseserver luistert, doorgaans poort 1521.
   cognos.db.name	[Database_service_name]	Het SID van de database die de Cognos-database bevat. Opmerking: Het moet het SID zijn als de servicenaam en het SID op deze database van elkaar verschillen; anders mislukt het installatiescript vanwege de validatie van de databaseverbinding. Voer de opdracht select instance_name from v$instance uit voor de Oracle-database om het SID van de database te vinden.
   cognos.db.user	COGNOS	Gemaakt door het installatieprogramma voor de Connections-database.
   cognos.db.password	[password]	Het wachtwoord van databasegebruiker COGNOS.
   metrics.db.type	oracle	Geeft het type Oracle-database aan.
   metrics.db.host	[Oracle_server_hostname]:[Port]	Hostnaam en Poort van de Oracle-databaseserver. Poort is de poort waarop de Oracle-databaseserver luistert, doorgaans poort 1521.
   metrics.db.name	[Database_service_name]	De servicenaam van de database die de Gebruikscijfers-database bevat. Opmerking: Dit zou de servicenaam moeten zijn als de servicenaam en het SID op deze database verschillen; anders mislukt het installatiescript vanwege DB Connection-validatie.
   metrics.db.local.name	[Local_tns_name]	Het TNS-alias dat in een eerdere stap voor De Oracle-databaseclient installeren voor Cognos Transformer is gemaakt.
   metrics.db.user	METRICSUSER	Gemaakt door het installatieprogramma voor de Connections-database.
   metrics.db.password	[password]	Het wachtwoord van databasegebruiker METRICSUSER.

   Tabel 4. SQL Server-gerelateerde eigenschappen in de cognos-installatie, eigenschappenbestand. Eigenschapsbeschrijvingen voor SQL Server waarin ook namen en waarden worden afgebeeld.

   Naam van eigenschap	Waarde	Beschrijving
   cognos.db.type	sqlserver	Geeft het type SQL Server-database aan.
   cognos.db.host	[SQLSERVER_hostname]:[Port]	Hostnaam en Poort van de SQL Server-machine en de poort van de database-instance die de Cognos-database bevat.
   cognos.db.name	COGNOS	Gemaakt door het installatieprogramma voor de IBM Connections-database.
   cognos.db.user	COGNOSUSER	Gemaakt door het installatieprogramma voor de Connections-database.
   cognos.db.password	[password]	Het wachtwoord van databasegebruiker COGNOSUSER.
   metrics.db.type	sqlserver	Geeft het type SQL Server-database aan.
   metrics.db.host	[SQLSERVER_hostname]:[Port]	Hostnaam van de SqlServer-machine en de poort van de database-instance die de Gebruikscijfers-database bevat.
   metrics.db.name	METRICS	Gemaakt door het installatieprogramma voor de Connections-database.
   metrics.db.local.name	[Database_instance_name]	De naam van de database-instance die de Gebruikscijfers-database bevat. Opmerking: Als de Gebruikscijfers-database in een standaardinstance van SQL Server is gemaakt, stelt u metrics.db.local.name in op leeg. Als de Gebruikscijfers-database is gemaakt in een instance met de naam SQL Server, zoals bijvoorbeeld, DBSERVER1, stelt u metrics.db.local.name in op DBSERVER1
   metrics.db.user	METRICSUSER	Gemaakt door het installatieprogramma voor de Connections-database.
   metrics.db.password	[password]	Het wachtwoord van databasegebruiker METRICSUSER.

   Enkele andere instellingen moeten in deze bestanden worden opgemerkt:

   • De map voor gedeelde netwerken wordt vertegenwoordigd door de eigenschap cognos.cube.path. Stel deze eigenschap in op de naam die u hebt gebruikt voor de map voor gedeelde netwerken die u hebt gemaakt bij stap 1.
   • Het beheerdersaccount van Cognos dat is opgegeven voor de instelling cognos.admin.username, moet een geldige LDAP-gebruiker zijn. Dit is niet de WebSphere-beheerder. Om deze reden moet u vooraf al een gebruiker hebben ingesteld in de LDAP. Meer informatie hierover vindt u in het onderwerp De Cognos-beheerder maken.
     Opmerking: De gebruikersnaam van de Cognos-beheerder mag geen spatie bevatten.
   • De wachtwoorden die in dit bestand zijn opgeslagen, worden verwijderd als het script is voltooid. Voeg eerst de wachtwoorden opnieuw in als u het script opnieuw moet uitvoeren. U kunt de wachtwoorden weglaten uit het eigenschappenbestand en ze invoeren op de opdrachtregel als u het script uitvoert, zoals afgebeeld bij stap 10.
7. (RedHat Linux 6 64-bits systemen) Voer de volgende opdracht uit om bibliotheken vooraf te laden die nodig zijn voor de installatiescripts die bij de volgende stap worden gebruikt:

   exporteer LD_PRELOAD=/usr/lib64/libfreebl3.so

8. (SuSE 11 zLinux-systemen) Maak een symbolische koppeling naar het pakket libXm.so.3:

   De kit openmotif22-libs-32bit-2.2.4-138.18.1 bevat libXm.so.4, terwijl het installatieprogramma van Cognos issetup een koppeling vormt naar libXm.so.3 en een fout tegenkomt in het geval deze niet beschikbaar is. U voorkomt deze fout door een symbolische koppeling te maken naar libXm.so.3 met de volgende opdracht:

   ln -s /usr/lib/libXm.so.4 /usr/lib/libXm.so.3

9. (Microsoft SQL Server) Als u Microsoft SQL Server gebruikt als uw databasebeheersysteem moet u deze configureren om verbindingen op afstand te ondersteunen voordat u het script cognos-setup.bat|sh uitvoert. Anders mislukt de validatie van de database. Zie de Microsoft-site voor informatie over het inschakelen van verbindingen op afstand voor SQL Server.
10. Voer het script cognos-setup.sh|bat uit om componenten van Cognos BI Server en Transformer te installeren.
    Alle eigenschappen die in het bestand cognos-setup.properties zijn opgegeven, kunnen worden opgenomen als parameters als u dit script uitvoert. U kunt wachtwoorden beter op deze manier opgeven dan ze toevoegen aan het eigenschappenbestand. Deze worden namelijk uit het bestand gewist nadat het is uitgevoerd. Gebruik de volgende syntaxis voor eigenschappen die u tijdens de uitvoering opgeeft:

    cognos-setup.sh|bat -property_name1=property_value1 -property_name2=property_value2

    Het eigenschappenbestand bevat bijvoorbeeld instellingen voor vier wachtwoorden. U kunt ze tijdens de uitvoering allemaal invoegen door ze op te nemen in de opdrachtregel, zoals afgebeeld:

    cognos-setup.sh -was.local.admin.password=WASadmin_pwd -cognos.admin.password=CognosAdmin_pwd -cognos.db.password=CognosContentStore_pwd -metrics.db.password=Metrics_DB_pwd

    Uitvoer van deze bewerking wordt opgeslagen in /CognosSetup/cognos-setup.log.

    Waarschuwing: Als er een fout optreedt tijdens het uitvoeren van het script cognos-setup.bat|sh, corrigeert u de fout en voert u het script opnieuw uit voordat u naar de volgende stap gaat. Als u bijvoorbeeld een onjuist wachtwoord hebt opgegeven in het bestand cognos-setup.properties, wijzigt u het wachtwoord en voert u het script cognos-setup.sh|bat opnieuw uit. Houd er rekening mee dat als u wachtwoorden hebt toegevoegd aan het eigenschappenbestand, deze na de vorige uitvoering zijn gewist en opnieuw moeten worden opgegeven. Als er een ander probleem optreedt, kunt u Problemen met componenten van Cognos Business Intelligence oplossen raadplegen voor een mogelijke oplossing.
11. Voer nu het script cognos-configure.sh|bat uit om de Cognos-server te configureren en databaseverbindingen in te stellen.

    De eigenschappen die in dit script zijn opgegeven, kunnen worden opgenomen als parameters als u dit script uitvoert. U doet dit met behulp van de afgebeelde syntaxis bij de vorige stap.

    Uitvoer van deze bewerking wordt opgeslagen in /CognosSetup/cognos-configure.log.

    Waarschuwing: Als er een fout optreedt tijdens het uitvoeren van het script cognos-configure.sh|bat, corrigeert u de fout en voert u het script opnieuw uit voordat u naar de volgende stap gaat. Als u bijvoorbeeld een onjuist wachtwoord hebt opgegeven in het bestand cognos-setup.properties, wijzigt u het wachtwoord en voert u het script cognos-setup.sh|bat opnieuw uit. Houd er rekening mee dat als u wachtwoorden hebt toegevoegd aan het eigenschappenbestand, deze na de vorige uitvoering zijn gewist en opnieuw moeten worden opgegeven. Als er een ander probleem optreedt, kunt u Problemen met componenten van Cognos Business Intelligence oplossen raadplegen voor een mogelijke oplossing.
12. (RedHat Linux 6 64-bits systemen) Stel de variabele LD_PRELOAD in op de lijst van JVM-omgevingsvariabelen van de Cognos-server. De omgevingsvariabele LD_PRELOAD moet telkens worden ingesteld nadat een Linux-systeem opnieuw wordt gestart. Dit doet u door deze variabele als volgt toe te voegen aan de lijst met JVM-omgevingsvariabelen:
    1. Start server1 van het WebSphere Application Server-systeem waarop u Cognos BI hebt geïmplementeerd.
    2. Meld u aan bij de beheerconsole van WebSphere Application Server.
    3. Navigeer naar Servers > Server Types > WebSphere application servers.
    4. Klik op de link cognos_server.
    5. Klik op JAVA en vervolgens op Procesbeheer > Procesdefinitie > Omgevingsitems.
    6. Klik op Nieuw om het volgende item toe te voegen:

       LD_PRELOAD = /usr/lib64/libfreebl3.so

13. Stop de Cognos-server en server1 als deze actief zijn. U start de Cognos-server nadat u deze in de volgende taak naar Deployment Manager hebt gefedereerd.
    Opmerking: Wanneer u in de toekomst de Cognos-server wilt stoppen, moet u WebSphere Application Server stoppen die hiervoor als host fungeert. Wacht ten minste 1 hele minuut om er zeker van te zijn dat alle Cognos-processen (AIX of Linux: cgsServer.sh- en CAM_LPSvr-processen; Windows: cgsLauncher.exe- en CAM_LPSvr-processen) volledig zijn gestopt voordat u probeert om de server opnieuw te starten.