TM1 9.5 Quick Installation and Upgrade Guide Nature of Document: Tip or Technique Product(s): TM1 9.5 Area of Interest: Upgrade/Migration
2 Copyright and Trademarks Licensed Materials - Property of IBM. Copyright IBM Corp. 2010 IBM, the IBM logo, and Cognos are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. IBM does not accept responsibility for any kind of loss resulting from the use of information contained in this document. The information contained in this document is subject to change without notice. This document is maintained by the Best Practices, Product and Technology team. You can send comments, suggestions, and additions to cscogpp@ca.ibm.com. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
3 Table of Contents 1 Introduction...4 1.1 1.2 1.3 Purpose... 4 Applicability... 4 Exclusions and Exceptions... 4 2 TM1 9.5 Server Install and Upgrade...4 3 TM1 Web 9.5 Install and Configuration...11 4 TM1 Contributor 9.5 Configuration...15 5 Troubleshooting the install... 28
4 1 Introduction 1.1 Purpose The purpose of this document is to provide additional quick installation guidance on installing IBM Cognos TM1 9.5 and upgrading existing TM1 models. This document should be used in combination with the IBM Cognos TM1 Installation Guide version 9.5. 1.2 Applicability Upgrading to IBM Cognos TM1 9.5 from TM1 9.4.1. 1.3 Exclusions and Exceptions This example is performed on a 32-bit Windows 2003 Server with Apache Tomcat and IIS. This example installation is performed on a single server using basic TM1 security settings (Mode = 1 (and Mode = 5 but without specifying Cognos 8 Security)). 2 TM1 9.5 Server Install and Upgrade 1) Backup Existing TM1 Data The first step in upgrading your TM1 Servers and TM1 Webs is to make a complete backup of your TM1 Server Data Directories and your TM1 Web Directory. Please refer to the Proven Practice Document: TM1 Backup and Recovery Guide for further details on creating a backup for TM1 Data. The screenshot below shows two compressed backup files: TM1Data.7z for the TM1 Data Directory; and wwwroot.7z for the TM1 Web files. These files can be used to restore the TM1 9.4 Server data and TM1 9.4 Web virtual directory should anything go wrong during the upgrade to TM1 9.5.
5 2) Install Pre-Requisites The next step is to verify that you have all of the pre-requisites installed on the machine that will have TM1 9.5 installed on it. From Windows Start go to Control Panel > Add Remove Programs and verify that Microsoft.Net Framework 3.5 has been installed. If you do not see Microsoft.NET Framework 3.5 then you must download it from: http://www.microsoft.com/downloads/details.aspx?familyid=333325fd-ae52-4e35b531-508d977d32a6&displaylang=en Then install it and verify it has been applied by returning to the Control Panel and viewing the Add/Remove Programs list. Note: You may be prompted to re-start your computer after installing the Microsoft.NET Framework 3.5.
6 3) Install TM1 9.5 Server Software TM1 Installation Wizard should start automatically when you insert the TM1 9.5 software CD. Alternatively, you can commence installation by running Setup.exe from the TM1 Install folder. Note: If you are upgrading from a prior TM1 version such as TM1 9.4.1, it is not necessary to uninstall the prior version if you will be installing TM1 9.5 into the same directory. TM1 9.5 will overwrite the previous version program files in that directory. Your data directories should not be affected by the installation of TM1 9.5 over a prior version. After accepting the Software License Agreement, you will be presented with the option of choosing which TM1 Products you would like to install. You are limited to choosing a single product on this screen. However, if you want to install additional products onto the current computer you can re-start the TM1 9.5 Setup.exe and choose Modify and then select the additional components. Alternately, you could choose Custom in the next screen and select all of the components that you would like to install. Thereby, eliminating the need to re-run the Setup.exe to install the additional software components.
7 Then after selecting the product, you are also prompted to select a Standard or Custom Installation Option. The Standard option will install all the components for the product you selected from the previous screen. You also have the option to change the installation location at this point by clicking on the Change... button. Next, you will be provided with the option of accepting the default ports for TM1 Admin Host and the TM1 Admin Server SSL. You have the option to change the TM1 Admin Server SSL port number at this point if you find that it conflicts with other programs.
8 The TM1 Admin Host and several other TM1 processes run as a Service on Windows and at this point in the installation process, you are prompted to enter an account which TM1 can use to launch the Services in Windows upon start-up. Usually, this account should have administrator privileges. Enter the account and passwords in the boxes provided and click Next.
9 Next you can click Install and the software should begin the installation process. When the installation completes, you will receive a success message and then you may click the Finish button. 4) Starting and Verifying the TM1 9.5 Server Installation After the TM1 9.5 Server Installation has completed, you should verify that the installation worked by starting the TM1 Services and navigating a TM1 Server instance.
10 To begin, open the Administration Tools from the Control Panel and open Services. Scroll down the list of services until you see TM1 Admin Server. Right-click on that service and choose Start from the drop-down menu. Also, if you are running any TM1 Server instances as a Windows Service, you can start them now. After starting the TM1 Services, you can now launch TM1 Architect to verify that your TM1 Server instance(s) are opening correctly in the TM1 version 9.5.
11 Navigate the Applications, Cubes, Views, Dimensions, etc and when you are satisfied that the TM1 Server is complete and running as expected, you can Exit the program. 3 TM1 Web 9.5 Install and Configuration After completing the TM1 Server 9.5 installation, the next step covered in the quick guide is to install and configure the TM1 Web 9.5 components. To install TM1 Web 9.5, re-launch Setup.exe for TM1 9.5 and choose Modify. Expand the Clients section of the Components Installation Wizard and choose: TM1 Web Components.
12
13 Provide credentials that will allow TM1 Web to install this software on the server. You may accept the default directory or provide a new location for the installation. If you are upgrading from TM1 Web 9.4.1, it is recommended to install TM1 Web 9.5 in the same directory. TM1 Web 9.5 will simply overwrite the TM1 Web 9.4 files.
14 After the TM1 Web 9.5 components have installed you will received the successful installation message. Click Finish.
15 TM1 Web 9.5 installs a complete and pre-configured IIS Virtual Directory that can be accessed by opening IIS and browsing your Web Sites and Virtual Directories. You can immediately start using TM1 Web to work with your TM1 Server instances and the Cube Views within those TM1 Servers. You can navigate to TM1 Web 9.5 from your browser by entering the following URL: http://localhost/tm1web/ Where localhost is the name of the server where TM1Web is installed. TM1 Web 9.5 working with upgraded TM1 9.4 model: Planning Sample. 4 TM1 Contributor 9.5 Configuration TM1 Contributor 9.5 is new functionality for TM1. So, there is no comparable upgrade path. The example below takes the existing TM1 9.4 Server called Planning Sample that was upgraded to TM1 Server 9.5 in the previous examples and deploys that model with the new TM1 Contributor 9.5 functionality. Pre-requsites: 1) Install.NET Framework v3.5 2) TM1 Web 9.5 3) Install Java Runtime Environment (JRE) version 6
16 4) Install Apache Tomcat or IBM Websphere Community Edition In this example, Apache Tomcat is used. Note: Apache Tomcat requires that Java Runtime Environment (JRE) version 6 be installed before you are permitted to install Apache Tomcat on your server. After installing Apache Tomcat, ensure that the encoding is set for utf=-8 in the file: tomcatusers.xml The default location for this file is: C:\Program Files\Apache Software Foundation\Tomcat 6.0 \conf\ Open tomcat-users.xml in Notepad and look at the first line of the file. If required, change the encoding value to utf-8 and Save the file. The default port for Apache Tomcat is port 8080. To login to Apache Tomcat, navigate your browser to the following URL: http://localhost:8080/ Where localhost is the name of the server where Apache Tomcat is installed.
17 Login to Tomcat Manager by clicking on the Tomcat Manager link in the upper-left section of the Apache Tomcat main page. Deploy the WAR file called pmpsvc.war that was included in the installation of TM1 Contributor 9.5. This file is located in the following directory:... \Program Files\Cognos\TM1\Cadmin\pmpsvc.war After Tomcat deploys the pmpsvc WAR file, it will be displayed under Applications in Tomcat Manager.
To launch TM1 9.5 Contributor, enter the following URL: http://localhost :8080/pmpsvc 18
19 The first time you log into TM1 9.5 Contributor you will be presented with an initialization screen. The values should be populated based on the components that you have installed. If the information is correct click OK. You will then be prompted for your TM1 login information. Enter your TM1 user ID and password and click Login.
20 When you have arrived at the TM1 Contributor main page, look for a folder icon in the upperright section of the screen. This folder is named Design an Application The first time you click on this folder you will be prompted to download and install a.msi file called CognosRCP.msi
Click Run to install the file. After the install completes, re-start your browser session and navigate back to the TM1 Contributor Page. Then click on the Design an Application folder again. The TM1 Contributor 9.5 Administration Tool should now launch and present you with the following Application Design screen: 21
22 Once you are in the TM1 Contributor Administration Tool, you can follow the process wizard to help you design and deploy TM1 Contributor models.
23 You can drag cube views and hierarchy dimensions from the TM1 Objects pane to the Design pane.
Validate the application that you have designed... Deploy the application... 24
25 Assign security and rights to each node in the dimension hierarchy... Verify your TM1s.cfg security setting for this TM1 Server... Note: It is a best practice to define the Integrated Security Mode before designing the TM1 Contributor application. Once an Integrated Security Mode has been defined for one TM1 Contributor application, that same Integrated Security Mode should be used for all TM1 Contributor Applications.
26 After the TM1 Contributor application has been created, it will be displayed in the main TM1 Contributor screen. However, one more step is required to launch the application. You must click on the far-right folder called: Activate this Application... Now the TM1 Contributor application can be opened and navigated.
27
28 Users can input data, use planning capabilities and create Sandbox Areas to perform What-If Analysis. Finally, workflow capabilities are provided to improve communication within the planning process. 5 Troubleshooting the install Error attempting to open Design an Application folder in TM1 Contributor. ModelingADT.msi and CognosRCP.msi have not been installed, yet. Solution: install the.msi files from the command line. Installing the ModelingADT.msi file...
Installing the CognosRCP.msi file. 29