Install Cognos 8 Transformer

You can install Cognos 8 Transformer, the metadata modeling tool for creating PowerCubes for use with Cognos 8, on the same computer as other Cognos 8 components, or on a different computer. You can install Cognos 8 Transformer on the same computer as Cognos Series 7 Transformer.

Transformer can now be made available more easily for business specialists who want to design models and build PowerCubes for their own use. For example, IT departments can provide business specialists or Transformer modelers with a Web-based, downloadable installation program from a corporate or secured portal, allowing for easy distribution of the installation files. For more information, see Create a Network Installation Location for Transformer Modelers and Deploying Cognos 8 Transformer for Modelers.

If you install Cognos 8 Transformer on the same Windows computer as other Cognos 8 components, all required files are copied to one computer. Default settings are used for the configuration. You can change these default settings if necessary, or if you install Cognos 8 Transformer on a separate computer from Cognos 8.

If you will be using PowerCubes that are secured against a Cognos Series 7 namespace, Content Manager must be installed on a computer that supports Cognos Series 7.

When you select a language in the installation wizard, it determines the language of the user interface. Only that language is installed. You cannot change the language properties after installation. If you want to change the language of the user interface, you must reinstall Cognos 8 Transformer.

For a complete UNIX or Linux installation of Cognos 8 Transformer, you must install client components on a Windows computer and server components on UNIX or Linux computers. The Cognos 8 Transformer client provides a graphical user interface for use on Windows computers. You then build cubes on your UNIX or Linux computer. On Linux, models must contain a Cognos 8 package query as a data source. Models that contain a Cognos Series 7 data source are not supported on Linux.

Before you install Cognos 8 Transformer, we recommend that you close all programs that are currently running to ensure that the installation program copies all the required files to your computer.

If you are installing on Windows, ensure that you have administrator privileges for the Windows computer you are installing on. If you are not an administrator, ask your system administrator to add you to the Administrator group on your computer.

Note: When Transformer 8.3 is installed on Windows Vista, if you do not have Administrator privileges on the computer and you make changes to the cogtr.xml file, the updated file is saved by default to a Virtual Store directory and not to the c8_location/configuration directory.

You must install and configure all Cognos 8 server components before you install Cognos 8 Transformer.

Steps for UNIX or Linux

1. Insert the CD for Cognos 8 Transformer into the UNIX or Linux computer.

2. To start the installation, type ./issetup

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

   Tip: The Series 7 IQD Bridge component is not supported on Linux and HP-UX Itanium.

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

   • We recommend that you do not configure Cognos 8 Transformer immediately because you must do other tasks first to ensure that your environment is properly set up. However, if you want to begin configuration immediately 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 Transformer, 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 want to configure Cognos 8 Transformer later, click Finish.

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

5. Create a MANPATH environment variable and configure it to point to the cogtr.1 file in the c8_location/webcontent/documentation/en directory.

   The cogtr.1 file provides the syntax for UNIX command line options that are supported by Cognos 8 Transformer. The man page is accessible in UNIX by typing man.

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

If you use Oracle, DB2, or Sybase as the database server for the content store in a distributed installation, you must now install the database client software on the same computer where you installed Cognos 8 Transformer.

Steps for Windows

1. Insert the CD for Cognos 8 Transformer modeling 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.

2. Select the language to use for the installation.

   The language that you select determines the language of the user interface. You cannot change the language after installation because only the selected language is installed.

3. 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.

4. 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.

5. Click Finish.

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

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

If you use Oracle, DB2, or Sybase as the database server for the content store in a distributed installation, you must now install the database client software on the same computer where you installed Cognos 8 Transformer.

Default Settings for Cognos 8 Transformer

The following table lists the default settings for the Cognos 8 ports and URIs that are used by Cognos 8 Transformer. 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.