Install IBM
Cognos 8 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.
Samples are on a separate CD in your IBM Cognos 8
product. If you want to use the samples, you must install them from
the IBM Cognos 8 Business Intelligence Samples 8.4 CD.
Stopping
the Service
If you need to stop the IBM Cognos 8 service, it is
important to also stop the following:
Web servers that host IBM Cognos 8
content
applications that are related to the IBM Cognos 8 service,
such as Framework Manager, IBM Cognos 8 Transformer, IBM
Cognos Connection, IBM Cognos Administration, and Metric Designer
any SDK applications that are running
Upgrading
your Installation
If you are upgrading from a previous release of IBM Cognos products,
you must use the upgrading steps. For information about upgrading
from ReportNet or Metrics Manager, see Upgrading to IBM Cognos 8.
If you are upgrading from ReportNet or an earlier version of
IBM Cognos 8, all the distributed components must be the
same version of IBM Cognos 8. If you install IBM Cognos 8 in
new locations, you must update the locations using IBM Cognos Configuration.
If
you are upgrading IBM Cognos 8 BI in an environment that
includes earlier versions of other IBM Cognos 8 products,
such as IBM Cognos 8 Controller 8.3, IBM Cognos 8
Planning 8.3, or IBM Cognos 8 BI Analysis for
Excel 8.3, install the new version of IBM Cognos 8
BI in a separate location from the other IBM Cognos 8 product
and configure IBM Cognos 8 BI to operate independently
of that product. After you upgrade the other product to a compatible version
with IBM Cognos 8 BI, you can then configure the two products
to operate together.
Windows Installations
For Windows installations, 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.
UNIX Installations
For UNIX installations, you can install server components using
a graphical user interface or by running a silent installation.
To run graphical-mode installation, the console attached to your
UNIX computer must support a Java-based graphical user interface.
Also, IBM 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.
Cognos Content Database as Content Store
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.
Printer Requirements
To ensure that reports print properly on
Windows, Adobe Acrobat requires that you configure at least one
printer on the operating system where Application Tier Components
are installed. All reports, regardless of the print format that
you choose, are sent as temporary PDF files to Adobe Reader for
printing.
Steps
for UNIX and Linux
If you are installing to a directory with other IBM Cognos 8
components, stop the IBM Cognos 8 service.
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.
IBM Cognos 8 requires a JVM, such as IBM Java, to run
on Linux.
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.
On AIX, if you are using a servlet gateway, 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.
Mount the CD for
your IBM Cognos product using Rock Ridge file extensions.
Important: To mount the IBM 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 an IBM 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.
To start the installation wizard, go to the operating system
directory on the CD or in the directory where the installations
files were downloaded and extracted, and then type
./issetup
Note: When you use the issetup command with XWindows,
Japanese characters in messages and log files may be corrupted.
When installing in Japanese on UNIX or Linux, first set environment
variables LANG=C and LC_ALL=C (where C is the language code, for
example ja_JP.PCK on Solaris), and then start the installation wizard.
If you do not use XWindows, run an unattended
installation 
.
Follow the directions in the installation wizard and copy
the required files to your computer.
Install IBM 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 IBM Cognos 8 on a computer that
has ReportNet or an earlier version of IBM Cognos 8 and
you want to keep the earlier version, you must install IBM Cognos 8
in a different directory.
If you are installing it in a directory that contains other IBM
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.
When you are prompted about installing non-English product
documentation, click OK to continue.
Choose how to proceed in the Finish page
of the installation wizard:
We recommend that you do not configure
IBM Cognos 8 immediately because you must do other tasks
first to ensure that your environment is properly set up. However,
if the console attached to your computer supports a Java-based graphical
user interface, you can click Start IBM Cognos Configuration.
If you want to see late-breaking information about IBM Cognos 8,
select View the Readme and then click Finish.
If the console attached to your computer does not support
a Java-based graphical user interface, click Finish.
You
can later configure IBM Cognos 8 using IBM Cognos Configuration
by starting cogconfig.sh in the c8_location/bin directory,
or running a silent configuration or editing cogstartup.xml in c8_location/configuration directory.
Append the c8_location/bin directory to the appropriate
library path environment variable.
On Linux, set the PRINTER environment variable to the name
of your printer.
To ensure the security and integrity of IBM Cognos 8,
it is important to protect the installation directory from unauthorized
or inappropriate access.
If you want users to see product documentation in a language
other than English, you must install the Supplementary Languages
Documentation component in the location where you installed the
Gateway components. For more information, see Install Translated Product Documentation.
If you want to use the samples that are available for IBM Cognos 8, install
the IBM Cognos 8 samples.
You must also update your Java security framework before
you can configure IBM Cognos 8. Otherwise, you may receive
the following error:
[Cryptography]
1. [ ERROR ] java.lang.NoClassDefFoundError:
javax/net/ServerSocketFactory:
Steps for Windows
If you are installing in a directory with other IBM Cognos 8
components, stop the IBM Cognos 8 service.
Insert the IBM Cognos product disk or go to the location
where the installation files were downloaded.
The installation wizard starts automatically from the product
disk.
If no Welcome page appears, go to
the operating system directory and double-click the issetup.exe
file.
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.
Follow the directions in the
installation wizard to copy the required files to your computer.
Install IBM Cognos 8 components in a directory that
contains only ASCII characters in the path name. Some Windows Web
servers do not support non-ASCII characters in directory names.
If you are installing IBM Cognos 8 on a computer that
already has ReportNet, and you want to keep ReportNet running, you
must install IBM Cognos 8 in a different directory.
If you are installing in a directory that contains other IBM
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.
When you are prompted about installing non-English product
documentation, click OK to continue.
In the Finish page
of the installation wizard,
If you want to configure IBM Cognos components
immediately, click Start IBM Cognos Configuration.
If you want to see late-breaking information about IBM Cognos
components, click View the IBM Cognos Readme.
Click Finish.
Use the Windows Start menu to start IBM
Cognos Configuration from the shortcut folder.
To ensure the security and integrity of IBM Cognos 8,
it is important to protect the installation directory from unauthorized
or inappropriate access.
If you want users to see product documentation in a language
other than English, you must install the Supplementary Languages
Documentation component in the location where you installed the
Gateway components. For more information, see Install Translated Product Documentation.
If you want to use the samples that are available for IBM Cognos 8, install
the IBM Cognos 8 samples.
