Cognos TM1 Web installation

You can install IBM® Cognos® TM1® Web on a computer that is separate from the computer where you installed the Cognos TM1 Server and other Cognos TM1 components.

Note: Starting with the 2.0.9.2 LC release of Planning Analytics Local, TM1 Web is no longer part of the web tier within the Planning Analytics Local installer. Instead, TM1 Web is installed with the IBM Planning Analytics Spreadsheet Services installer. The IBM Planning Analytics Spreadsheet Services installer is part of the 2.0.55 SC and later releases.

This documentation describing how to install TM1 Web as part of the web tier within Planning Analytics Local is provided for customers who are installing an LC release prior to 2.0.9.2 and have not yet upgraded to the 2.0.55 SC (or later) release of TM1 Web. If you need details on installing TM1 Web with the IBM Planning Analytics Spreadsheet Services installer, see Installing IBM Planning Analytics Spreadsheet Services (TM1 Web).

You can deploy TM1 Web on an IBM WebSphere® Application Server. For more information, see Installing TM1 Web.

When you install TM1 Web, TM1 Applications Web is also installed. For more information, see TM1 Web architecture.

Note: Add the <PA_install_directory>\bin64\ directory to the library path environment variable (LD_LIBRARY_PATH). This is required only when you install IBM TM1 Web on a computer that is separate from the computer where you installed TM1 Server .

Check for changes to web.xml file

If you are upgrading IBM Planning Analytics TM1 Web with IBM Planning Analytics Local version 2.0.5, you install a new version of the web.xml file called web.xml.new and your existing web.xml file is preserved.

To take advantage of fixes applied in this release, you must use the web.xml.new file and you must reapply any changes that you made to your previous configuration settings. In particular, restore your values for session-timeout.

  1. Back up the existing web.xml file in <PA_installation_location>/webapps/tm1web/WEB-INF. For example, rename web.xml to web.xml.old. This step backs up your current settings.
  2. Rename web.xml.new to web.xml. This step uses the new version of web.xml that is supplied with IBM Planning Analytics Local version 2.0.5.
  3. Replace the entry for session-timeout in web.xml with the entry from web.xml.old. This step restores any changes that you made to this property previously.

    For example:

    <session-config>
        <session-timeout>20</session-timeout>
    </session-config>

Install Cognos TM1 Web

The following items are an overall checklist for installing Cognos TM1 Web.

  1. Check prerequisites. For more information, see Check for changes to web.xml file.
  2. Install Cognos TM1 Web.
  3. Use the WebSphere administrative console to start the application server.
  4. Run and test Cognos TM1 Web from your network environment.
  5. Edit the Cognos TM1 Web configuration file to support a multiple computer environment.
  6. Configure the TM1 Web login page using AdminHostName and TM1ServerName parameters.
  7. Configure authentication and data transmission security.
  8. Modify CognosTM1 Web configuration parameters.
  9. Configure the web browsers in your environment.