. If some modelers will be installing on Windows
Vista, you must create an export file from a Windows Vista computer.
We suggest creating separate folders on the Web or LAN location
for Windows and Windows Vista.After you install Transformer, you can perform these tasks:
If you installed Transformer on a Windows Vista computer, and you plan to use the cogtr.xml.samples file as a templateUpdate default preferences for Windows Vista
If you want to use Transformer models from IBM Cognos Series 7 and you want to continue to use IQD data sources,Add IBM Cognos Series 7 Data Sources to the Transformer
To make Transformer available for modelers to install and use, you can perform these tasks:
With security enhancements in Windows Vista, Microsoft changed the structure of user directories. If you want to use the cogtr.xml.samples file as a template, you must edit the default preferences settings. If you want all users to have the same default directories, you must change the default preferences to a common location to which users have access. If you want users to have the Windows Vista directories, you can delete the default preferences for the directories.
The instructions in this topic are for the installer or administrator. If you are the Transformer modeler or business specialist who wants to download and use Transformer, see Deploying IBM Cognos 8 Transformer for Modelers
Log on as the administrator.
In the c8_location\configuration directory, open cogtr.xml.sample in a text editor in elevated mode by right-clicking on the text editor and selecting Run as Administrator.
If you want all users to have the same default directories, change the directories to a location to which all users have read and write access.
The directories to change are as follows:
If you want users to have the Windows Vista default directories, delete the preferences specified in step 3 from the file.
The Windows Vista default directories for Transformer are
CubeSaveDirectory
Documents\Transformer\PowerCubes
DataSourceDirectory
In IBM Cognos Configuration, under Environment, Data files location property
DataWorkDirectory
In IBM Cognos Configuration, under Environment, Temporary files location property
LogFileDirectory
Documents\Transformer\Logs
ModelSaveDirectory
Documents\Transformer\Models
ModelWorkDirectory
In IBM Cognos Configuration, under Environment, Temporary files location property
Change other settings as required.
Save the file as cogtr.xml.
The changes are applied the next time you open Transformer.
If you plan to use Transformer models and data sources from IBM Cognos Series 7, you must add the location of your IBM Cognos Series 7 data sources to the Transformer gateway file.
The instructions in this topic are for the installer or administrator. If you are the Transformer modeler or business specialist who wants to download and use Transformer, see Deploying IBM Cognos 8 Transformer for Modelers
Log on as the administrator.
In the c8_location\CS7Gateways\bin directory, open cs7g.ini in a text editor.
On Windows Vista, open it in elevated mode by right-clicking on the text editor and selecting Run as Administrator.
Add the locations for your IBM Cognos Series 7 data sources to the file.
Save the file.
The changes are applied the next time you open Transformer.
Your organization may have specialized business or power users who want to build PowerCubes that are modeled on a combination of corporate and personal data sources. These users may want to do their own analysis of the data for their line of business or a small group of users. An installer or administrator can download an executable file to a Web or LAN location, where modelers can run the file to launch the IBM Cognos 8 Transformer installation wizard.
The instructions in this topic are for the installer or administrator. If you are the Transformer modeler or business specialist who wants to download and use Transformer, see Deploying IBM Cognos 8 Transformer for Modelers
Before you make the installation file available to Transformer modelers, other resources and permissions must be set up:
Database client software is installed, or available for modelers to install, on the Transformer computers that are used to access IBM Cognos 8 data sources or IBM Cognos Series 7 IQD data sources.
Modelers must have privileges to create a data source in IBM Cognos Administration.
Modelers do not need direct access to IBM Cognos Administration. They can create and update data sources by using Transformer or command line tools. You can provide modelers with a secured folder in IBM Cognos Connection in which to publish PowerCube packages.
Modelers must have access to a location in which to store the PowerCube after building it.
This location must also be accessible to the IBM Cognos 8 service and can be a secured share on a LAN.
Modelers may require special privileges to remotely run the IBM Cognos 8 PowerCube Connection utility, which is located on the IBM Cognos 8 server. For more information, see the topic about updating published PowerCubes and PowerCube connections in the Transformer User Guide.
To build PowerCubes on a specific Transformer server, modelers should have FTP privileges to transfer models and execute privileges to build cubes on that server.
Modelers can transfer models and execute cube builds using scripts. Modelers can also use automated methods to build PowerCubes. For more information, see the Administration and Security Guide.
Insert the CD for IBM Cognos 8 Transformer modeling product.
If the Welcome page of the installation wizard appears, exit the wizard.
On the CD, locate the c8transformerinstall.exe file.
Copy the file to a secure location to which your Transformer modelers have access.
If you want to make the Transformer installation file available to Transformer modelers, the modelers will need the dispatcher and encryption settings to configure Transformer on their local computer. You can export the configuration from one Transformer computer for use with all other Transformer computers. The modelers can copy the exported configuration file to their Transformer installation directory and then run the command to configure the Transformer computer silently.
The instructions in this topic are for the installer or administrator. If you are the Transformer modeler or business specialist who wants to download and use Transformer, see Deploying IBM Cognos 8 Transformer for Modelers
If you updated the coglocale, cogtr.xml, or cs7g.ini files on the Transformer computer, you must copy these files to the Web or LAN location so that Transformer modelers can download them to their computer.
To export the configuration, the source computer must
have the same IBM Cognos 8 components as the Transformer
modeler computers . If some modelers will be installing on Windows
Vista, you must create an export file from a Windows Vista computer.
We suggest creating separate folders on the Web or LAN location
for Windows and Windows Vista.
In IBM Cognos Configuration, from the File menu, click Export as.
If you want to export the current configuration to a different folder, in the Look in box, locate and open the folder.
Ensure that the folder is protected from unauthorized or inappropriate access.
In the File name box, type a name for the configuration file.
Click Save.
Rename the exported file to cogstartup.xml.
Copy the exported cogstartup.xml file from the source computer to the same Web or LAN location as the Transformer installation file.
If you changed the global configuration on the source computer, copy the coglocale.xml file from the source computer to the same Web or LAN location as the Transformer installation file.
The default location of the coglocale.xml file is c8_location\configuration.
If you updated the cogtr.xml, copy it from the c8_location\configuration directory to the same Web or LAN location as the Transformer installation file.
If you updated the cs7g.ini file, copy it from the c8_location\CS7Gateways\bin directory to the same Web or LAN location as the Transformer installation file.
If you are the business specialist or Transformer modeler, you must now deploy Transformer so that you can build PowerCubes and publish them to selected users or groups.
If you have not completed the installation, follow the steps to install Transformer. To configure Transformer so that it can communicate with the IBM Cognos 8 dispatcher, follow the steps to configure Transformer.
If IBM Cognos Connection is secured, you must have privileges to create data sources and publish packages in IBM Cognos Connection.
You can upgrade models from Series 7.x versions of Transformer if you have saved them as MDL files.
You can continue to use PowerCubes built with Series 7.3 and higher versions of Transformer in IBM Cognos 8. However, to use IBM Cognos 8 authentication providers, you must upgrade the PowerCubes. After upgrading, the PowerCubes are no longer compatible with Series 7 Transformer.
To upgrade PowerCubes to IBM Cognos 8 PowerCubes, you must:
open the Series 7.x Transformer model MDL file in IBM Cognos 8 Transformer
rebuild the PowerCube in the IBM Cognos 8 Transformer
For more information, see Upgrading Transformer Models and PowerCubes.
To support the use of IBM Cognos 8 data sources (including packages and reports) in Transformer, ensure that the database client is installed on the Transformer computer.
From the Web or LAN location that the administrator provided, run the c8transformerinstall.exe file.
The contents are expanded to the Documents and Settings\username\Local settings\Temp directory and then the Transformer installation wizard opens.
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.
In the Finish page of the wizard, 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.
Create a MANPATH environment variable and configure it with the following value:
/c8_location/webcontent/documentation/en/cogtr.1
The cogtr.1 file provides the syntax for UNIX command line options that are supported by IBM Cognos 8 Transformer. The man page for IBM Cognos 8 Transformer is accessible in UNIX by typing cogtr man from the c8_location/bin directory.
Go to the same Web or LAN location as the Transformer installation file.
If any .xml files are present, copy them to the Transformer_location\configuration directory, where Transformer_location is the directory where you installed Transformer.
The default location is C:\Program Files\Cognos\c8.
If an .ini file is present, copy it to the Transformer_location\CS7Gateways\bin directory.
Go to the Transformer_location\bin directory.
Type the configuration command:
./cogconfig.bat -s
IBM Cognos Configuration applies the configuration settings specified in the local copy of cogstartup.xml, encrypts credentials, generates digital certificates, and starts the IBM Cognos 8 service.
To test IBM Cognos 8 Transformer, from the Start menu, click Programs, IBM Cognos 8,Transformer.
If you see the Transformer window, your installation is working.
After Transformer is installed and running successfully, delete the installation files that were extracted from the installation file.
