TM1 Registration and Maintenance of Windows Services Tip or Technique

Tip or Technique
TM1 Registration and
Maintenance of Windows Services
Product(s): TM1
Area of Interest: Infrastructure
TM1 Registration and Maintenance
of Windows Services
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 www.cognos.com
This document is maintained by the Best Practices, Product and Technology
team. You can send comments, suggestions, and additions to
[email protected] .
IBM Cognos Proprietary Information
TM1 Registration and Maintenance
of Windows Services
3
Contents
1
INTRODUCTION ............................................................................................ 4
1.1
1.2
1.3
PURPOSE .............................................................................................................. 4
APPLICABILITY ....................................................................................................... 4
EXCLUSIONS AND EXCEPTIONS .................................................................................... 4
2
REGISTER THE SERVICE ............................................................................... 4
3
UNREGISTER THE SERVICE .......................................................................... 5
4
TM1 ADMIN SERVICE AND SERVER SERVICE ............................................... 6
5
START AND STOP TM1 SERVICES ................................................................. 8
6
HOW TO EDIT THE TM1 SERVICES VIA REGEDIT ......................................... 9
IBM Cognos Proprietary Information
TM1 Registration and Maintenance
of Windows Services
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
IBM Cognos Proprietary Information
TM1 Registration and Maintenance
of Windows Services
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
IBM Cognos Proprietary Information
TM1 Registration and Maintenance
of Windows Services
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
IBM Cognos Proprietary Information
6
TM1 Registration and Maintenance
of Windows Services
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.
IBM Cognos Proprietary Information
TM1 Registration and Maintenance
of Windows Services
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.
IBM Cognos Proprietary Information
TM1 Registration and Maintenance
of Windows Services
9
Name Conventions:
a.)
b.)
c.)
d.)
TM1 Server
Adm Server
Server Service
Adm Service
- Tm1s.exe
- Tm1admsrv.exe
- Tm1sd.exe
- 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
You want to expand here to get to the Tm1
services.
When you do these 2 should be present
IBM Cognos Proprietary Information
TM1 Registration and Maintenance
of Windows Services
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
IBM Cognos Proprietary Information