This section of the Readme describes general installation issues.
If you install an IBM Cognos product, then install other IBM Cognos products, custom installations after the first installation may indicate that the product tools or books are already installed. For example, if you install Impromptu Web Reports, then install IBM Cognos Query, the installation program may indicate that the IBM Cognos Query tools are already installed.
This occurs because some tools are used by several IBM Cognos products. After they are installed by the first product installation, they don’t need to be installed again, so the installation program indicates that they are already installed.
When trying to add a virtual directory in Java System Web Server 6.x (formerly Sun ONE, formerly iPlanet), you may receive this error:
Incorrect Usage: Bad Directory Mapping
The directory mapping cannot contain whitespace.
This error occurs because of the space between "Program Files", the default installation location for Series 7. Virtual directories in Java System Web Server 6.x cannot contain spaces. To avoid this problem, do not install Series 7 to the Program Files location.
For more information about how to produce the euro currency symbol, see http://www.microsoft.com/windows/euro.mspx
One of the fonts that is provided is called Andale WT. This font is available for use with PowerPlay User, Impromptu User, and Impromptu Administrator. More importantly this font can be used as the default font used for PDF generation in PowerPlay Enterprise Server and Impromptu Web Reports. Note that Swiss 721 SWM, not Andale WT, is the default font for use with Western European languages (Latin-1). The Andale Font is an accurate Unicode 2.1 font, and includes a backslash character ("\") at hexadecimal position 5C. While this is compliant with standards, the popular practice in Japan is to use the hexadecimal position 5C for the Yen symbol ("¥"). Customers using Japanese data may find that Andale is displaying backslashes where Yen symbols are intended.
There is an alternative font, Andale WT J, available from Cognos support. Andale WT J is identical to Andale WT except that is has a Yen symbol at position 5C instead of a backslash. Customers using Japanese data may prefer to use the Andale WT J font. Use of the Andale WT J font is restricted by the same licensing provisions as Andale WT, which form part of IBM Cognos standard End User Licensing Agreement.
If you set up your AIX system so that all servers are running IBM HTTP Server version 2.0.47 with Apache mod extensions, heavy loads will cause the Web server to crash.
IBM recommends that you install the cumulative fix PQ85834 for HTTP Server version 2.0.47. You can download this patch from the following location:
http://www.ibm.com/support/docview.wss?rs=177&context=SSEQTJ&q1=pq85834&uid=swg24006719
IBM Cognos products require a directory server instance to store user authentication information. A copy of Sun Java System Directory Server 6.1 is provided on the Supplementary Software CD for this purpose.
On UNIX computers, the Sun Java System Directory Server 6.1 instance does not start automatically after re-boot. The instance must be started manually or by running a script at system startup time.
install_location/ds6/bin/dsadm startinstance_path
/var/Sun/mps/ds6/bin/dsadm start /var/Sun/mps/data61
When configuring SSL for the Access Manager Server, a cert7.db file is required. In the Access Manager Administrator Guide, you are instructed to use the certutil utility to create this file. On UNIX, the version of certutil in the installation_location/cognos/bin directory generates only cert8.db files.
For Series 7 Version 4, you must use the certutil utility included on the IBM Cognos product CD to generate the cert7.db file. The utility is located in the support_files/sun_one/certutil folder.
When you install a Series 7 Version 4 MR2 (or later) product, you can now install user-writable files to a new Documents and Settings directory. This new directory allows you to take better advantage of the security model of operating systems, such as Microsoft Windows Vista, that do not allow users without administrative privileges to write to directories that are nested under the Program Files directory.
If you are installing to a location where Series 7 Version 4 products do not exist, you can select a Documents and Settings location that is different than the default location, installation_location/data. For example, in the installation wizard, you could set the Documents and Settings location to be the following:
C:\Documents and Settings\user_name\Cognos
After you specify the Documents and Settings directory, a set of subdirectories containing the necessary writable files and folders is created, such as the following:
In versions earlier than IBM Cognos Series 7 Version 4 MR2, users needed to have write access to files and locations nested under the installation_location directory, including workspace files, .ini files, and log files.
If you are installing to a location where Series 7 Version 4 products already exist, the Documents and Settings location is set to your existing installation_location directory. This setting ensures compatibility with previously installed Series 7 Version 4 releases. Your files are located where they were before the MR2 product installation. The only change is that the Access Control List (ACL) of the directory cer5 is modified. For more information, see Access Control List Modified for Installation Location When Installing Over an Existing Series 7 Version 4 Installation.
When you install a Series 7 Version 4 MR2 (or later) product to a directory that contains an existing Series 7 Version 4 installed product, the Access Control List (ACL) for this directory is modified to allow all users to have Write permission to the directory.
This ACL modification is required for operating systems, such as Microsoft Windows Vista, that do not allow users to write to directories that are nested under the Program Files directory unless they have administrative privileges. The default install location for Series 7 has always been nested under the Program Files directory.
In versions earlier than IBM Cognos Series 7 Version 4 MR2, users needed to have write access to several locations nested under the installation_location directory, including template directories, .ini files, and log files.
If you are installing to a location where Series 7 Version 4 products already exist, the installation location for Documents and Settings is set to your existing installation_location directory. This setting ensures compatibility with previously installed Series 7 Version 4 releases. Your files are all still located where they were before the MR2 product installation. The only change is that the ACL of the directory cer5 is modified.
If you are installing to a location where Series 7 Version 4 products do not exist, you can select a Documents and Settings location. The ACL for this location is modified so that all users can write to this location.
Series 7 Version 4 MR2 and later products provide an updated ObjectStore version containing a patch that prevents potential corruption of your IWR data store. If you are running any version of ObjectStore earlier than this, you must upgrade to the version provided with your Series 7 Version 4 MR2 product. To check if your ObjectStore installation is up to date, perform the following steps.
If the returned version is earlier than ObjectStore 6.1.2.1, you must uninstall ObjectStore and then install the new version.
For information about installing and uninstalling ObjectStore, see the IBM Cognos Series 7 Solution Installation Guide.