TM1 Registration and Maintenance of Windows Services

Transcription

1 Tip or Technique TM1 Registration and Maintenance Product(s): TM1 Area of Interest: Infrastructure

2 2 Copyright Copyright 2008 Cognos ULC (formerly Cognos Incorporated). Cognos ULC is an IBM Company. 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. Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in this document. This document shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to the information contained in this document will be documented in subsequent editions. This document contains proprietary information of Cognos. All rights are reserved. No part of this document may be copied, photocopied, reproduced, stored in a retrieval system, transmitted in any form or by any means, or translated into another language without the prior written consent of Cognos. Cognos and the Cognos logo are trademarks of Cognos ULC (formerly Cognos Incorporated) in the United States and/or other countries. IBM and the IBM logo are trademarks of International Business Machines Corporation in the United States, or other countries, or both. All other names are trademarks or registered trademarks of their respective companies. Information about Cognos products can be found at This document is maintained by the Best Practices, Product and Technology team. You can send comments, suggestions, and additions to cscogpp@ca.ibm.com.

3 3 Contents 1 INTRODUCTION PURPOSE APPLICABILITY EXCLUSIONS AND EXCEPTIONS REGISTER THE SERVICE UNREGISTER THE SERVICE TM1 ADMIN SERVICE AND SERVER SERVICE START AND STOP TM1 SERVICES HOW TO EDIT THE TM1 SERVICES VIA REGEDIT... 9

4 4 1 Introduction 1.1 Purpose This document provides some tips and techniques on registering and maintaining the TM1 Windows Services. 1.2 Applicability This document is applicable to TM1 9.1 SP2 and prior. 1.3 Exclusions and Exceptions No exclusions or exceptions have been identified. 2 Register the service In the TM1 installation directory you will find an application named TM1sd.exe which can be executed in a command line window. With this application you are able to register and unregister TM1 Data Directories as a Windows Service. Use the parameters install and remove to do so. E.g. your TM1 data directory is C:\Cognos Data\BigBoxFinancialsData Open the Windows Command Prompt Go to the bin-directory of your TM1 Server Installation With the following command Tm1sd.exe -install BigBox C:\Cognos Data\BigBoxFinancialsData you will register a TM1-Service with the name BigBox

5 5 You can now start and stop the TM1 cubes from this data directory by using this Windows Service. 3 Unregister the service To unregister this service use the command Tm1sd.exe remove <Service Name> e.g. Tm1sd.exe remove BigBox

6 6 4 TM1 Admin Service and Server Service During the installation of TM1 server, by default it will install as a service. By default we set the TM1 service and TM1 Admin Service with a logon account so that TM1 will have access to all network resources. Everything is OK until a user want to install a TM1 services manually. The steps to do so are the same as Server 7 (see information below). The problem is when a

7 7 user installs the TM1 services manually by default they will install as a Local System Account You will need to click on This account and enter your domain\username and password. If you are manually installing the admin server as a service the same steps apply here as well.

8 8 You will need to install multiple services using the following parameters Tm1sd -install <-nservicename> <-zconfigpath> <-uusername> <-wpassword> Tm1sd -remove <-nservicename> 1.) You can put any orders for -n, -z, -u, -w parameters. 2.) If you don't use the parameters, the default values are: ServiceName Tm1sd ConfigPath - system window directory UserName & Password - LocalSystem account 3.) There should be NO space between -n, -z, -u, -w and their parameter (ie. ntm1sv, NOT -n Tm1sv) 4.) If there is a space inside a parameter, use double quote to wrap it up. (ie. - n"tm1 sv") 5.) UserName format: DomainName\UserName or.\username if it belongs to the built-in domain. Example: Tm1sd -install ntm1sv -z"c:\tm1data\data Test" -ucognos\jhuang -wpwd Tm1sd -remove ntm1sv 5 Start and Stop TM1 Services 1.) Relationship between Adm Service and Server Service. Adm Service is a dependency of Server Service. So we can start Adm Service first, then start Server Services. Or we can start first Server Service directly and it will start Adm Service automatically before Server Service start. When we stop services, we stop Server Services first and stop Adm Service last. If we stop Adm Service first, it will warn you there are still some server services running, stopping Adm Service will stop all the Server Service. 2.) Relationship between Services and Servers ( Adm server and TM1 servers ) We can t start an Adm Service if there is a Adm server running, so we have to shut it down and then start Adm Service. If there is an Adm Service running, we can start many Server Services or TM1 Servers.

9 9 Name Conventions: a.) TM1 Server - Tm1s.exe b.) Adm Server - Tm1admsrv.exe c.) Server Service - Tm1sd.exe d.) Adm Service - Tm1admsd.exe 6 How to EDIT the TM1 Services via REGEDIT Got to C:\winnt double click on regedit.exe You should see this Click on HKEY_LOCAL_MACHINE - Expand it so you see When you do these 2 should be present You want to expand here to get to the Tm1 services.

10 10 When you click on one the right side of the screen should show your true information Check both tm1admsd and tm1sd If you need to change the ImagePath double click on ImagePath