Install Server Components   

Use the installation wizard to select the server components that you want to install and the location on your computer where you want to install them. Only the components that you choose to install are copied from the CD to your computer. You can install the gateway, Application Tier Components, and Content Manager components on multiple computers.

In previous versions of Cognos 8, the samples were installed automatically with the server components. Now the samples are on a separate CD in your Cognos 8 product. If you want to use the samples, you must install them from the Cognos 8 Business Intelligence Samples 8.3 CD. For more information, see Install the Cognos 8 Samples.

For instructions about installing Framework Manager, see Install Framework Manager.

For instructions about installing Metric Designer, see Install Metric Designer.

For instructions about installing Cognos 8 Transformer, see Install Cognos 8 Transformer.

In you are upgrading Cognos 8 BI in an environment that includes earlier versions of other Cognos 8 products, such as Cognos 8 Controller 8.2, Cognos 8 Planning 8.2, or Cognos 8 BI Analysis for Excel 8.2, install the new version of Cognos 8 BI in a separate location from the other Cognos 8 product and configure Cognos 8 BI to operate independently of that product. After you upgrade the other product to a compatible version with Cognos 8 BI, you can then configure the two products to operate together.

If you want to use Cognos Content Database as your content store, you must select it in the installation wizard. If you are installing components on several computers, you need to only install one Cognos Content Database. If you install Cognos Content Database on the same computer as Content Manager, and you later decide to use another database for your content store, you must uninstall Cognos Content Database.

On UNIX, you can install server components using either a character-based interface or a graphical user interface. To run graphical-mode installation, the console attached to your UNIX computer must support a Java-based graphical user interface.

On UNIX, Cognos 8 respects the file mode creation mask (umask) of the account running the installation program. This affects only the installation directories. It does not affect the file permissions within the directories. However, run-time generated files, such as logs, respect the mask. We recommend umask 022 on the installation directory.

On Windows, ensure that you have administrator privileges for the Windows computer you are installing on. Also ensure that your computer has a TEMP system variable that points to the directory where you want to store temporary files. During installation, files from the CD are temporarily copied to this directory.

If you plan to install Cognos 8 Transformer and you will be using PowerCubes that are secured against a Cognos Series 7 namespace, you must install Content Manager on a computer that supports Cognos Series 7.

Important: For successful failover between Content Managers, ensure that the system clocks on the Content Manager computers are synchronized.

Steps for UNIX and Linux

1. If you are installing to a directory with other Cognos 8 components, stop the Cognos 8 service.

2. Set the JAVA_HOME environment variable to point to the installation location of your Java Runtime Environment (JRE).

   An example of the installation location of a Java Runtime Environment is /directory/java/java_version/jre.

   Cognos 8 requires Sun Java to run on Linux.

3. On HP-UX, set the _M_ARENA_OPTS environment variable as follows:

   _M_ARENA_OPTS 1:4

   This increases the memory allocation for HP-UX to more closely match that of other UNIX platforms.

4. On AIX, set the AIXTHREAD_SCOPE environment variable as follows:

   AIXTHREAD_SCOPE=S

   This sets the contention scope for user threads to system-wide, which supports more efficient scheduling of user threads.

5. Mount the CD for your Cognos product using Rock Ridge file extensions.

   Important: To mount the Cognos CD on HP-UX, do the following:

   • Add the pfs_mount directory in your path.

     For example,

     PATH=/usr/sbin/:$PATH

     export PATH

   • To start the required NFS daemons and run the daemons in the background, type bg pfs_mountd and then type bg pfsd

   • To mount the drive, type

     pfs_mount -t rrip <device><mount_dir> -o xlat=unix

     For example,

     pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix

     You can now install or copy files as a non-root user using a Cognos CD from this drive.

   • When the installation is complete, type pfs_umount /cdrom and kill the pfsd and pfs_mountd daemons to unmount the CD.

6. Go to the directory on the CD that is appropriate for your operating system.

   For example, for Solaris, go to the solaris directory.

7. Start the installation wizard:

   • If you use XWindows, type

     ./issetup

     Note: When you use the issetup command with XWindows, Japanese characters may be corrupted. When installing on UNIX, use the console display to install components and specify English-only for the installation by setting LANG=C and LC_ALL=C.

   • If you do not use XWindows, type

     ./issetupcc

8. Follow the directions in the installation wizard and copy the required files to your computer.

   Install Cognos 8 components in a directory that contains only ASCII characters in the path name. Some UNIX and Linux Web servers do not support non-ASCII characters in directory names.

   If you are installing Cognos 8 on a computer that already has ReportNet and you want to keep the ReportNet, you must install Cognos 8 in a different directory.

   If you are installing it in a directory that contains other Cognos 8 components, you are prompted for the location of a directory in which to store backup copies of the files that will be overwritten.

9. Choose how to proceed in the Finish page of the installation wizard:

   • We recommend that you do not configure Cognos 8 immediately because you must do other tasks first to ensure that your environment is properly set up. However, if you do not plan to install the Cognos 8 samples and the console attached to your computer supports a Java-based graphical user interface, you can click Start Cognos Configuration.

   • If you want to see late-breaking information about Cognos 8, select View the Readme and then click Finish.

     Tip: For character-mode installations on UNIX and Linux, close the readme text file by pressing Ctrl + C or Q.

   • If the console attached to your computer does not support a Java-based graphical user interface or if you plan to install the Cognos 8 samples, click Finish.

     You can later configure Cognos 8 using Cognos Configuration by starting cogconfig.sh in the c8_location/bin directory, or editing cogstartup.xml in c8_location/configuration directory.

10. Append the c8_location/bin directory to the appropriate library path environment variable.

    • For Solaris and Linux, LD_LIBRARY_PATH

    • For AIX, LIBPATH

    • For HP-UX, SHLIB_PATH

11. On Linux, set the PRINTER environment variable to the name of your printer.

To ensure the security and integrity of Cognos 8, it is important to protect the installation directory from unauthorized or inappropriate access.

If you want to use the samples that are available for Cognos 8, install the Cognos 8 samples.

If you use Oracle, DB2, or Sybase you can now set up the database client for the content store and the metric store . If you have installed Cognos Content Database, you do not have to set up the database client.

You must also update your Java security framework before you can configure Cognos 8. Otherwise, you may receive the following error:

[Cryptography]

1. [ ERROR ] java.lang.NoClassDefFoundError:
javax/net/ServerSocketFactory: 

Steps for Windows

1. If you are installing to a directory with other Cognos 8 components, stop the Cognos 8 service.

2. Insert the CD for your Cognos product.

   The Welcome page of the installation wizard should appear.

   If no Welcome page appears, in the win32 directory on the CD, double-click the issetup.exe file.

3. Select the language to use for the installation.

   The language that you select determines the language of the user interface. You can change the language to any of the installed languages after installation.

4. Follow the directions in the installation wizard to copy the required files to your computer.

   If you are installing Cognos 8 on a computer that already has ReportNet, and you want to keep ReportNet running, you must install Cognos 8 in a different directory.

   If you are installing in a directory that contains other Cognos 8 components, you are prompted for the location of a directory in which to store backup copies of the files that will be overwritten.

5. In the Finish page of the installation wizard,

   • If you do not plan to install the Cognos 8 samples and want to configure Cognos components immediately, click Start Cognos Configuration.

   • If you want to see late-breaking information about Cognos components, click View the Readme.

6. Click Finish.

   Use the Windows Start menu to start Cognos Configuration from the shortcut folder.

If you want to use the samples that are available for Cognos 8, install the Cognos 8 samples. If you use Oracle, DB2, or Sybase you can now set up the database client for the content store and the metric store . If you have installed Cognos Content Database, you do not have to set up the database client.

Install the Cognos 8 Samples

The Cognos 8 samples illustrate product features and technical and business best practices. You can also use them for experimenting with and sharing report design techniques, and for troubleshooting. If you want to use the samples, install them from the Cognos 8 Business Intelligence Samples 8.3 CD.

Steps for UNIX and Linux

1. Mount the CD using Rock Ridge file extensions.

   Important: To mount the Cognos CD on HP-UX, do the following:

   • Add the pfs_mount directory in your path.

     For example,

     PATH=/usr/sbin/:$PATH

     export PATH

   • To start the required NFS daemons and run the daemons in the background, type bg pfs_mountd and then type bg pfsd

   • To mount the drive, type

     pfs_mount -t rrip <device><mount_dir> -o xlat=unix

     For example,

     pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix

     You can now install or copy files as a non-root user using a Cognos CD from this drive.

   • When the installation is complete, type pfs_umount /cdrom and kill the pfsd and pfs_mountd daemons to unmount the CD.

2. Go to the directory on the CD that is appropriate for your operating system.

3. Start the installation wizard:

   • If you use XWindows, type

     ./issetup

     Note: When you use the issetup command with XWindows, Japanese characters may be corrupted. When installing on UNIX, use the console display to install components and specify English-only for the installation by setting LANG=C and LC_ALL=C.

   • If you do not use XWindows, type

     ./issetupcc

4. Follow the directions in the installation wizard and copy the required files to your computer.

   Install the samples in the same location as the server components.

5. In the Finish page of the installation wizard, click Finish.

To set up and configure the Cognos 8 samples, see Setting Up the Samples.

Steps for Windows

1. Insert the CD.

2. Go to the directory on the CD that is appropriate for your operating system.

3. Start the installation wizard by clicking issetup.exe.

   The Welcome page of the installation wizard should appear.

4. Select the language to use for the installation.

   The language that you select determines the language of the user interface. You can change the language to any of the installed languages after installation.

5. Follow the directions in the installation wizard to copy the required files to your computer.

   Install the samples in the same location as the server components.

6. In the Finish page of the installation wizard, click Finish.

7. Click Finish.

   Use the Windows Start menu to start Cognos Configuration from the shortcut folder.

To set up and configure the Cognos 8 samples, see Setting Up the Samples.

Default Settings for Cognos 8  

The following table lists the default ports and URI settings for Cognos 8. After installation, you can use the configuration tool to change the settings . You can also change them by editing the cogstartup.xml file in the c8_location\configuration directory.

The following table lists the default settings used by Cognos 8 for Tomcat. The non-SSL and SSL connectors are automatically updated in the server.xml file when you use Cognos Configuration to change the dispatcher port or to enable the SSL protocol . You can directly update the shutdown port using Cognos Configuration.