04.TM1 Operation Guide 10.1.1

8/10/2019 04.TM1 Operation Guide 10.1.1

1/424

TM1 Operation Guide 10.1.1

Contents

1. Introduction

2. What's new

2.1. New features in Cognos TM1 Operations Guide version 10.1.1

2.1.1. New onitoring options avai!a"!e in the Cognos TM1 10.1.1 Operations Conso!e2.2. New features in version 10.1.0

2.2.1. Cognos TM1 Operations Conso!e

2.2.2. t1#fer

2.2.$. od"c%test too!

2.$. Changed features in version 10.1.0

2.$.1. &ara!!e! Interaction concurrenc set " defau!t

2.$.2. (ocuentation changes to the I)M Cognos TM1 Operation Guide

$. TM1 *ste and +eature Configuration

$.1. TM1 *ste and +eature Configuration Overview

$.2. Capa"i!it ,ssignents

$.2.1. Cognos TM1 ,pp!ication We" Capa"i!ities

$.2.2. *etting Capa"i!ities$.2.$. -nderstanding the ffect of )!an/s in the Capa"i!it ,ssignents

$.2.$.1. -nderstanding eca!c and Coit in a &ersona! Wor/space

$.$. -sing &ersistent +eeders

$.$.1. *aving data with persistent feeders

$.$.2. Modifing ru!es for cu"es with feeders

$.$.$. and!ing corrupted or inva!idated feeder fi!es

$.. Configuring and Managing *and"o#es in our TM1 nvironent

$..1. Meor -sage Considerations for *and"o#es and &ersona! Wor/spaces

$..2. Managing +i!es and +o!ders for *and"o#es

$..$. TM1 *erver Configuration &araeters for *and"o#es

$... -nderstanding *and"o# (ifferences ,ong (ifferent TM1 C!ients

$.3. -sing &ara!!e! Interaction with a Cognos TM1 server$.3.1. )est practice use of &ara!!e! Interaction

. Cognos TM1 ,din *erver Operations

.1. TM1 ,din *erver

.2. unning the Cognos TM1 ,din *erver on a Windows operating sste

.2.1. unning the Cognos TM1 ,din *erver as an ,pp!ication on Windows

.2.1.1. 4iewing ,din *erver *tatus

.$. unning the Cognos TM1 ,din *erver on -NI5

.$.1. 4iewing ,din *erver *tatus eport

.. *pecifing the 6ocation of the ,din ost

..1. *pecifing Mu!tip!e ,din osts

3. eote Cognos TM1 *erver Operations

3.1. Overview of eote *erver Operations3.2. *etting -p a eote TM1 *erver to un as an ,pp!ication

3.$. *etting -p a eote TM1 *erver to un as a Windows *ervice

3.$.1. Insta!!ing a TM1 *erver to un as a Windows *ervice

3.$.2. eoving a TM1 *erver fro unning as a Windows *ervice

3.. *tarting a eote TM1 *erver

3..1. *tarting a TM1 *erver *et -p as a Windows ,pp!ication

3..2. *tarting a TM1 *erver Insta!!ed as a Windows *ervice

3..2.1. *etting up a *ervice to *tart ,utoatica!!

3..$. *tarting a -NI5 TM1 *erver

3..$.1. Modifing the startup%t1s.sh *cript

Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j

25 26-09-20


2/424

3..$.2. unning the -NI5 TM1 *erver in )ac/ground Mode

3.3. Connecting to a eote *erver

3.3.1. efreshing the 6ist of eote *ervers

3.3.2. e7*etting the ,din ost

3.3.$. e7*etting 6oca! *erver Options

3.8. (isconnecting fro a eote *erver

3.9. *hutting (own a Windows TM1 *erver

3.9.1. *hutting (own a Windows TM1 *erver unning as a *ervice

3.:. *hutting (own a -NI5 TM1 *erver

3.:.1. *hutting (own a -NI5 TM1 *erver unning in )ac/ground Mode

3.;. 6ogging Transactions

3.;.1. (ata )ac/up and ecover

3.;.2. na"!ing and (isa"!ing 6ogging

3.;.$. 4iewing the Transaction 6og

3.;.. *etting *earch 6oc/ 6iit

3.;.3. )ac/ing Out ecords fro the Transaction 6og

3.;.8. eoving 6og +i!es fro the (is/

3.10. Monitoring *erver &erforance

3.11. Managing C!ient Connections

3.11.1. )roadcasting Messages to C!ients

3.11.2. (isconnecting C!ients fro the *erver3.11.$. *hutting (own a *erver eote!

3.12. eote *erver Meor Manageent

3.12.1. ,"out *targate 4iews

3.1$. -sing TM1 in )u!/ 6oad Mode

3.1$.1. Considerations for -sing )u!/ 6oad Mode

3.1$.1.1. *tarting )u!/ 6oad Mode

3.1$.1.2. nding )u!/ 6oad Mode

3.1$.2. TM1 C ,&I

3.1$.$. Tur"oIntegrator &rocess Coands

8. TM1 *ecurit Overview

8.1. Overview to authentication

8.2. O"


3/424

9.. ,ssigning -sers to Groups

9..1. Me"ership in Mu!tip!e Groups

9.3. *ecuring TM1 (ata

9.3.1. estricting ,ccess to the (ata (irector

9.3.2. ,ssigning &asswords

9.3.$. -sing *tandard *ecurit for &asswords

9.8. *etting and C!earing &asswords

9.8.1. *etting a &assword

9.8.2. C!earing a &assword

9.8.$. Changing a &assword

9.9. *etting an #piration for a -ser

:. *ste and &erforance Monitoring

:.1. Overview of TM1 *ste and &erforance Monitoring

:.2. -sing the ,din *erver 6og

:.2.1. Message *everit 6eve!s for ,din *erver 6ogging

:.2.2. Configuring ,din *erver 6ogging

:.2.$. na"!ing ,din *erver 6ogging

:.2.. 4iewing the ,din *erver 6og +i!e

:.$. 6ogging Transactions

:.$.1. (ata )ac/up and ecover

:.$.2. na"!ing and (isa"!ing Transaction 6ogging:.$.$. 4iewing the Transaction 6og

:.$.. )ac/ing Out ecords fro the Transaction 6og

:.$.3. eoving Transaction 6og +i!es fro the (is/

:.$.8. Trou"!eshooting> ecovering fro a Corrupt Transaction 6og +i!e

:.. -sing the *erver Message 6og

:..1. Message *everit 6eve!s

:..2. 6oggers

:..$. 6ogging &roperties +i!e

:... Configuring and na"!ing *erver Message 6ogging

:...1. na"!ing and (isa"!ing 6ogging

:...2. Configuring 6ogging Message 6eve!

:...$. Configuring 6ogging Output:..3. 4iewing the *erver Message 6og

:..3.1. *earching for Te#t in the Message 6og

:..3.2. Coping Te#t fro the Message 6og

:.3. C!ient 6ogging

:.8. -sing the ,udit 6og

:.8.1. -nderstanding ,udit 6og vents

:.8.1.1. O"


4/424

:.9.$. 4iewing &erforance *tatistics for C!ients@ Cu"es@ and *ervers

:.:. -sing the TM1 Top -ti!it

:.:.1. (isp!aing user naes in TM1 Top

:.:.2. Configuring the T1top.ini +i!e

:.:.$. unning TM1 Top

:.:.$.1. unning TM1 Top with Coand7!ine Options

:.:.. 4iewing and -nderstanding the TM1 Top (isp!a

:.:..1. Nora! disp!a ode

:.:..2. *and"o# disp!a ode

:.:..$. ?ueue disp!a ode

:.:... -nderstanding TM1 6oc/ Modes

:.:..3. -nderstanding Thread &rocessing *tates

:.:.3. TM1 Top Coands

:.:.8. Cance!ing a Thread's &rocessing

:.:.8.1. -nderstanding the Cance! &rocess

:.:.8.2. -nderstanding the 4erif &rocess

:.:.8.$. -sing the 4erif and Cance! Coands

:.;. -sing &erforance Counters

:.;.1. Iportant Note a"out unning &erforance Counter Too!s

:.;.2. ,vai!a"!e &erforance Counters

:.;.$. 4iewing &erforance Counters with the TM1 &erfMon -ti!it:.;.$.1. unning TM1&erfMon

:.;.$.2. 4iewing the TM1 &erfMon (isp!a Output

:.;.$.$. #iting TM1 &erfMon

:.;.. 4iewing &erforance Counters with the Microsoft Windows &erforance Monitor

:.;..1. Opening the Microsoft Windows &erforance Monitor

:.;..2. ,dding and 4iewing &erforance Counters in the Microsoft Windows &erforance

Monitor

:.10. Capturing Core (ups for TM1 *erver Crash ,na!sis

:.11. (e"ugging Too!s for Windows

:.11.1. Insta!!ing and unning ,(&!us

:.11.1.1. unning ,(&!us (irect! on the *erver

:.11.1.1.1. Monitoring the *erver:.11.1.1.2. -sing CT67C to +orce a *erver Crash

:.11.1.1.$. Ta/ing a *napshot of Current *erver *tate

:.11.1.2. unning ,(&!us eote! fro a C!ient

:.11.1.2.1. Insta!!ing and unning ,(&!us on the *erver

:.11.1.2.2. unning ,(&!us fro a C!ient

:.11.1.2.$. *topping ,(&!us

:.11.2. unning (r. Watson

:.11.2.1. *etting (r. Watson as the (efau!t (e"ugging Too!

:.11.$. Co!!ecting +i!es for ,na!sis +o!!owing a *erver Crash

:.11.. Transitting +i!es to Cognos

:.11..1. -p!oading fro a Coand &ropt

:.11..2. -p!oading fro a We" )rowser:.11..$. -p!oading to Aour +T& *erver

;. Cognos TM1 Too!s and -ti!ities

;.1. t1#fer

;.1.1. t1#fer snta#

;.1.2. Copressing directories with t1#fer

;.1.$. (ecopressing directories with t1#fer

;.1.. Notes on t1#fer

;.1.3. rror essages for t1#fer

;.1.8. t1#fer usage notes

;.2. od"c%test too!


25 26-09-20


5/424

10. -sing the Cognos TM1 Operations Conso!e

10.1. (isp!a user naes

10.2. Create an Operation Group for onitoring

10.$. ,dd an ,dinost and Cognos TM1 server nae to the Cognos TM1 Operations Conso!e

10.. *et the !og fi!e and server nueric paraeters

10.3. (own!oad or up!oad the configuration fi!e

10.8. (naic reporting using the Monitor option

10.9. ea!th chec/ indicator

10.:. ea!th status ta"

10.;. Monitor server eor and perforance data

10.10. *et a fi!ter

10.11. *chedu!e the !og fi!e

10.12. (own!oad the !og fi!e

10.1$. 4iew the !og fi!e

11. ,dinistering I)M Cognos TM1 We"

11.1. I)M Cognos TM1 We" Overview

11.2. ,dinistering the TM1 *erver fro I)M Cognos TM1 We"

11.2.1. ,dinistering &rocesses

11.2.2. ,dinistering Chores

11.2.$. *etting C!ient &roperties

11.2.. *etting Cu"e &roperties11.2.3. *etting (iension &roperties

11.$. Changing Aour &assword

11.. Configuring a Custo oepage for I)M Cognos TM1 We"

11..1. Configuring (ifferent oepages for Individua! -sers

11..2. Configuring a G!o"a! oepage for ,!! -sers

11..2.1. -sing the oe&ageO"


6/424

11.3.1.. ideWe"sheetToo!)ar &araeter

11.3.1.3. ideCu"eviewerToo!)ar &araeter

11.3.13. -sing the Custo6in/ &araeter to Open Other -6s and We" &ages

11.3.18. Configuring the I)M Cognos TM1 We" 4irtua! Cache (irector

11.3.19. Contro!!ing Chart *ca!ing and Increents with the *art,#isna"!ed &araeter

11.3.1:. na"!ing the We"sheet &aging Too!"ar

11.3.1;. -sing the TM1 We" &ageesetMode paraeter

11.3.20. ,!!owing pasting in va!idated ce!!s

11.3.21. Wrapping string va!ues in cu"e views

11.8. &erforing We" +o!der Maintenance

11.9. -sing I)M Cognos TM1 We" 6ogging

11.9.1. Message *everit 6eve!s for I)M Cognos TM1 We" 6ogging

11.9.2. I)M Cognos TM1 We" 6og

11.9.2.1. Configuring and na"!ing I)M Cognos TM1 We" 6ogging

11.9.2.2. 4iewing the I)M Cognos TM1 We" 6og +i!e

11.9.$. TM1 #ce! *ervices 6og

11.9.$.1. Configuring TM1 #ce! *ervices 6ogging

11.9.$.2. na"!ing TM1 #ce! *ervices 6ogging

11.9.$.$. 4iewing the TM1 #ce! *ervices 6og +i!e

12. -nderstanding Cu"e (ependenc

12.1. Changes in (ependenc Mapping12.2. C!earing Cu"e (ependencies

12.$. Creating Cu"e (ependencies

12.. -sing ,ddCu"e(ependenc to sta"!ish (ependencies

12..1. (e"ugging and Identifing Cu"e (ependencies

1$. ep!icating Cu"es

1$.1. ep!ication Overview

1$.1.1. e!ationships Created " ep!ication

1$.1.2. eBuired ,ccess &rivi!eges

1$.1.$. ,din *erver Considerations

1$.1.$.1. *etting up ep!ication

1$.1.. Configuring the T1s.cfg +i!e to *upport ep!ication

1$.2. Maintaining ep!ication Connections1$.2.1. Creating a ep!ication Connection

1$.2.2. Modifing a ep!ication Connection

1$.2.$. (e!eting a ep!ication Connection

1$.$. ep!ication &rocess

1$.$.1. ep!icating a Cu"e

1$.$.2. *pecifing Inforation a"out the ep!icated Cu"e

1$.$.2.1. *pecifing Cu"e Inforation

1$.$.2.2. *pecifing (iension Inforation

1$.$.2.$. *pecifing u!e Inforation

1$.$.2.. *pecifing 4iew Inforation

1$.$.2.3. *pecifing *u"set Inforation

1$.$.$. What appens when TM1 ep!icates a Cu"e1$.. *nchroni=ation &rocess

1$..1. *nchroni=ing on (eand

1$..2. *chedu!ing *nchroni=ation

1$..$. *nchroni=ing over -nsta"!e or Wide ,rea Networ/ Connections

1. ,ccessi"i!it features

1.1. e"oard shortcuts

1.2. I)M and accessi"i!it

13. Contro! Cu"es

13.1. *ecurit Contro! Cu"es

13.1.1. DCe!!*ecurit%Cu"eNae


25 26-09-20


7/424

13.1.2. DChore*ecurit

13.1.$. DC!ient*ecurit

13.1.. DCu"e*ecurit

13.1.3. D(iension*ecurit

13.1.8. D!eent*ecurit%(iensionNae

13.1.9. D&rocess*ecurit

13.2. C!ient and Group ,dinistration Contro! Cu"es

13.2.1. DC!ientsGroups

13.2.2. DC!ient&roperties

13.$. O"


8/424

1. IntroductionThis docuent is intended for use with I)MF CognosF TM1F .

This docuent descri"es TM1 architecture@ server operations@ authentication@ and coponent securit.

TM1 integrates "usiness p!anning@ perforance easureent and operationa! data to ena"!e copanies

to optii=e "usiness effectiveness and custoer interaction regard!ess of geograph or structure. TM1

provides iediate visi"i!it into data@ accounta"i!it within a co!!a"orative process and a consistent view

of inforation@ a!!owing anagers to Buic/! sta"i!i=e operationa! f!uctuations and ta/e advantage of newopportunities.

Finding information

To find I)M Cognos product docuentation on the we"@ inc!uding a!! trans!ated docuentation@ access

one of the I)M Cognos Inforation Centershttp>HHpu"!i"."ou!der.i".coHinfocenterHcogicHv1r00

Hinde#.


9/424

#. $%at&s ne

This section contains a !ist of new@ changed@ and reoved features for this re!ease.

It wi!! he!p ou p!an our upgrade and app!ication dep!oent strategies and the training reBuireents

for our users.

To !ocate the ost current product docuentation@ go to the I)MF CognosF TM1F inforation center

http>HHpu"!i"."ou!der.i".coHinfocenterHct1Hv10r10Hinde#.


10/424

#.1. 'e features in Cognos TM1 Operations Guide (ersion 10.1.1

6isted "e!ow are new features in I)MF CognosF TM1F Operation Guide since the !ast re!ease.

'e monitoring options a(ailable in t%e Cognos TM1 10.1.1 Operations Console

In this version of the software@ ou can onitor soe additiona! ites in the I)M Cognos TM1

Operations Conso!e.

)arent topic*What's new


425 26-09-20


11/424

#.1.1. 'e monitoring options a(ailable in t%e Cognos TM1 10.1.1

Operations Console

In this version of the software@ ou can onitor soe additiona! ites in the I)M Cognos TM1 Operations

Conso!e.

Monitor Cognos TM1 ser(er memory and performance information

CognosF TM1F sste eor and perforance statistics are now avai!a"!e through the Cognos TM1Operations Conso!e.

*ee Monitor server eor and perforance data.

Instant ser(er %ealt% c%ec" across all monitored ser(ers

The Cognos TM1 Operations Conso!e ea!th *tatus ta" shows the current status of a!! Cognos TM1

servers in the tree using the ea!th Chec/ icons.

*ee ea!th status ta".

Filtering log messages,dinistrators can now fi!ter the tpes of essages inc!uded in the Cognos TM1 Operations Conso!e !ogs

to e!iinate repetitive or unwanted essages and contro! the !og fi!e si=e.

*ee *et a fi!ter.

)arent topic*New features in Cognos TM1 Operations Guide version 10.1.1


425 26-09-20


12/424

#.#. 'e features in (ersion 10.1.0

6isted "e!ow are new features in I)MF CognosF TM1F since the !ast re!ease.

Cognos TM1 Operations Console

The I)M Cognos TM1 Operations Conso!e is a new wa for adinistrators to onitor and ta/e action

on Cognos TM1 server activit.

tm1+ferThe t1#fer uti!it copresses and oves I)M Cognos TM1 server o"


13/424

#.#.1. Cognos TM1 Operations ConsoleThe I)MF CognosF TM1F Operations Conso!e is a new wa for adinistrators to onitor and ta/e

action on Cognos TM1 server activit.

The Cognos TM1 Operations Conso!e provides a visua! and effective wa to understand how Cognos TM1

servers and user !oads are wor/ing. *ervers can "e identified and various aspects of the onitoring can

"e anaged using the Cognos TM1 Operations Conso!e. The conso!e is a we"7"ased c!ient that is

dep!oed and targeted to specific Cognos TM1 servers to generate !ogs and provide a graphica! disp!a to

he!p anage server !oads.

*ee the IBM Cognos TM1 Operations Console Guide.

)arent topic*New features in version 10.1.0


425 26-09-20


14/424

#.#.#. tm1+ferThe t1#fer uti!it copresses and oves I)MF CognosF TM1F server o"


15/424

#.#.-. odbc,test toolThe odbc_testtoo! is used to diagnose and test an I)MF CognosF TM1F O()C connection on -NI5.

*ee the od"c%test too!..

)arent topic*New features in version 10.1.0


425 26-09-20


16/424

#.-. C%anged features in (ersion 10.1.0

6isted "e!ow are changes to features in I)MF CognosF TM1F since the !ast re!ease.

)arallel Interaction concurrency set by default

The &ara!!e! Interaction feature introduced in the previous re!ease is now on " defau!t.

ocumentation c%anges to t%e I/M Cognos TM1 Operation Guide

, nu"er of configuration topics were oved fro this guide to "etter organi=e docuentation forthis re!ease.

)arent topic*What's new


425 26-09-20


17/424

#.-.1. )arallel Interaction concurrency set by defaultThe &ara!!e! Interaction feature introduced in the previous re!ease is now on " defau!t.

Iproveents to concurrenc processing achieved used the &ara!!e! Interaction feature are now

autoatica!! avai!a"!e to a!! users " defau!t. &revious! a configuration paraeter needed to "e set to

use this feature.

*ee the -sing &ara!!e! Interaction with a Cognos TM1 server.

)arent topic*Changed features in version 10.1.0


425 26-09-20


18/424

#.-.#. ocumentation c%anges to t%e I/M Cognos TM1 Operation Guide

, nu"er of configuration topics were oved fro this guide to "etter organi=e docuentation for this

re!ease.

The fo!!owing topics were oved fro the IBM Cognos TM1 Operation Guideto the IBM Cognos TM1

Installation and Configuration Guide>

CognosF TM1F sste architecture

T1s.cfg server configuration fi!e and paraeters

T1p.ini c!ient configuration fi!e and paraeters

Cognos TM1 authentication !ogon and **6 securit configuration

*ee the IBM Cognos TM1 Installation and Configuration Guide.

)arent topic*Changed features in version 10.1.0


425 26-09-20


19/424

-. TM1 System and Feature ConfigurationThis section descri"es how to configure the I)MF CognosF TM1F server and c!ients.

TM1 System and Feature Configuration O(er(ie

-se the fo!!owing coponents and features to configure the I)M Cognos TM1 server and c!ients.

Capability Assignments

,dinistrators can set certain capa"i!ities " usergroup using the Capa"i!it ,ssignent enu found

in the *erver #p!orer@ *erver Menu.

sing )ersistent Feeders

To iprove re!oad tie of cu"es with feeders@ set the &ersistent+eeders configuration paraeter to

true T to store the ca!cu!ated feeders to a .feeders fi!e.

Configuring and Managing Sandbo+es in your TM1 n(ironment

,s the TM1 adinistrator@ ou shou!d understand soe technica! ites when using *and"o#es and

&ersona! Wor/spaces in our TM1 environent.

sing )arallel Interaction it% a Cognos TM1 ser(er

&ara!!e! Interaction is an I)M Cognos TM1 server7re!ated feature that a!!ows for greater concurrenc

of read and write operations on the sae cu"e o"


20/424

-.1. TM1 System and Feature Configuration O(er(ie-se the fo!!owing coponents and features to configure the I)MF CognosF TM1F server and c!ients.

Configuration escription

T1s.cfg fi!e , configuration fi!e that specifies environent inforation for the TM1

server.

Aou can edit the T1s.cfg fi!e to ref!ect the environent of the

associated server.

+or detai!s and a cop!ete !isting of a!! the paraeters@ see the IBM

Cognos TM1 Installation and Configuration Guide.

T1p.ini fi!e , configuration fi!e that specifies the environent inforation for the

TM1 c!ients TM1 &erspectives@ TM1 ,rchitect@ and C!ient .

+or detai!s and a cop!ete !isting of a!! the paraeters@ see the IBM


Capa"i!it ,ssignents , set of capa"i!ities that adinistrators can ena"!e or disa"!e " user

group.

Capa"i!ities a!!ow ou to anage options such as &ersona! Wor/space

Write"ac/ Mode@ *and"o#es@ (ata eservation@ and access to *erver

#p!orer.

+or detai!s@ see Capa"i!it ,ssignents.

&ersistent +eeders , paraeter that can iprove re!oad tie of cu"es with feeders@

especia!! those with an cop!e# feeder ca!cu!ations@ " saving

feeders and then re7!oading the at server startup without

reca!cu!ating those feeders.

+or detai!s@ see -sing &ersistent +eeders.

*and"o#es , feature that a!!ows users to create and wor/ in their own data areas

separate fro "ase data.

,dinistrator tas/s for this feature inc!ude understanding the feature

and its eor usage@ ena"!ing the necessar configurationparaeters and anaging re!ated fi!es and fo!ders.

+or detai!s@ see Configuring and Managing *and"o#es in our TM1

nvironent.

&ara!!e! Interaction , server7re!ated feature that a!!ows for greater concurrenc of read

and write operations on the sae cu"e o"


21/424

Configuration escription

+or detai!s@ see -sing &ara!!e! Interaction with a Cognos TM1 server.

(ata eservation , server7re!ated feature that a!!ows ou to configure e#c!usive write7

access to regions of a cu"e for individua! users. Once reserved@ the

data in that region can on! "e odified " that specific user unti! thereservation is re!eased.

,dinistrator tas/s for ( inc!ude configuring re!ated properties in the

DCu"e&roperties contro! cu"e and the Capa"i!it ,ssignents window.

To actua!! app! and anage (ata eservations@ ou ust use the

re!ated Tur"oIntegrator and ,&I functions that a!!ow ou to

prograatica!! o"tain@ re!ease and anage reservations.

+or cop!ete detai!s@ see the J-sing (ata eservationsJ and Jna"!ing

(ata eservationJ sections in the I)M Cognos TM1 Developer Guide.

)arent topic*TM1 *ste and +eature Configuration


425 26-09-20


22/424

-.#. Capability Assignments,dinistrators can set certain capa"i!ities " usergroup using the Capa"i!it ,ssignent enu found in

the *erver #p!orer@ *erver Menu.

With the *erver #p!orer open@ se!ect a server to disp!a the *erver Menu and se!ect Capability

Assignments.

) defau!t a!! assignents are "!an/. The "!an/ settings have different ip!ications for each capa"i!it.

Changes ade to these assignents ta/e effect after ou !og out of TM1F then !og "ac/ in. )e sure tosave the settings to the server to have changes ta/e effect.

The fo!!owing capa"i!ities can "e set per usergroup>

Access to Ser(er +plorer

-se this capa"i!it to !aunch the *erver #p!orer " defau!t for this usergroup. Aou can set this

capa"i!it to (en to prevent the *erver #p!orer fro "eing used " this usergroup. ) defau!t@ this

capa"i!it is set to "!an/ or Grant. To "!oc/ access to the server e#p!orer@ c!ic/ the intersection of the

usergroup and the capa"i!it and se!ect eny.

)ersonal $or"space $ritebac" Mode

This capa"i!it defines how data changes are hand!ed in this usergroup.

When this capa"i!it is granted@ users have the a"i!it to ho!d data changes in a private wor/space

"efore anua!! deciding when to coit the changes to the "ase data. -sers can further "e granted

the a"i!it to nae and anage u!tip!e private scenarios ca!!ed sand"o#es see the *and"o#

Capa"i!it.

When &ersona! Wor/space Write"ac/ Mode is granted>

-sers operate in a non7direct write"ac/ situation so the can private! ad


23/424

the *and"o# capa"i!it. In that case@ users wor/ direct! in the "ase "ut have the option to save

changes to a naed sand"o#. When the create a naed sand"o#@ then the Coit and reset (ata

"uttons "ecoe avai!a"!e. If the ove "ac/ to the )ase@ the return to direct write"ac/. *ee *etting

Capa"i!itiesfor the possi"!e option co"inations of &ersona! Wor/space Write"ac/ Mode and *and"o#

capa"i!ities.

If the sste7wide a"i!it to have sand"o#es is turned off using the (isa"!e*and"o#ingKT in the

server configuration fi!e@ the &ersona! Wor/space Write"ac/ Mode and *and"o# capa"i!ities are

ignored. ) defau!t (isa"!e*and"o#ing is not present or is set to +.

Sandbo+

This capa"i!it ena"!es the usergroup to create naed sand"o#es that can "e used to "ui!d what7if

scenarios. With this capa"i!it granted@ users can create and nae ore than one set of data changes

which are over!aid on top of the "ase data. -sers can /eep their sand"o#es private and decide when

to coit the data changes to a/e the pu"!ic. *and"o#ing is a powerfu! feature@ "ut soe users

wi!! find the cop!e#it of anaging u!tip!e scenarios against a coon "ase cha!!enging.

) defau!t a!! users have this capa"i!it. The "!an/ setting acts !i/e a Grant.

To prevent this usergroup fro using naed sand"o#es@ set this capa"i!it to eny.

If the a"i!it to have sand"o#es is turned off using the (isa"!e*and"o#ing configuration paraeter in

the server's configuration fi!e@ the &ersona! Wor/space Write"ac/ Mode and *and"o# capa"i!ities are

ignored. ) defau!t this paraeter is not present or is set to +. (isa"!e*and"o#ing is descri"ed in the

IBM Cognos TM1 Installation and Configuration Guide.

ata 2eser(ation capabilities

(ata eservation ( is a server7re!ated feature that a!!ows ou to configure e#c!usive write7access

to regions of a cu"e for individua! users. Once reserved@ the data in that region can on! "e odified

" that specific user unti! the reservation is re!eased.

( uses the Manageata2eser(ationand ata2eser(ationO(erridecapa"i!ities to a!!ow

e"ers of a user group to acBuire@ re!ease@ and override (s for these!ves and other users.

+or detai!s@ see the J-sing (ata eservationsJ and Jna"!ing user groups to anage (ataeservationsJ sections in the I)MF CognosF TM1 Developer Guide.

Cognos TM1 Application $eb Capabilities

The Write"ac/ Mode and *and"o# capa"i!ities are ignored " Cognos TM1 ,pp!ication We".

Setting Capabilities

Aou deterine the write"ac/ ode using a co"ination of Grant or (en settings to the &ersona!

Wor/space Write"ac/ Mode and the *and"o# Capa"i!ities.

nderstanding t%e ffect of /lan"s in t%e Capability Assignments

) defau!t a!! Capa"i!it ,ssignents are set to "!an/@ which eans either (en or Grant depending

on the defau!t setting of each Capa"i!it.



425 26-09-20


24/424

-.#.1. Cognos TM1 Application $eb CapabilitiesThe Write"ac/ Mode and *and"o# capa"i!ities are ignored " CognosF TM1F ,pp!ication We".

In Cognos TM1 ,pp!ication We"@ the capa"i!ities are set " app!ication. ,!! users associated with a

particu!ar app!ication@ wor/ in the wa set for that app!ication.

If ou are wor/ing with u!tip!e sand"o#es@ ou ust su"it fro Cognos TM1 ,pp!ication We"@ ou

cannot su"it fro the Wor/f!ow page.

)arent topic*Capa"i!it ,ssignents


425 26-09-20


25/424

-.#.#. Setting CapabilitiesAou deterine the write"ac/ ode using a co"ination of Grant or (en settings to the &ersona!

Wor/space Write"ac/ Mode and the *and"o# Capa"i!ities.

To let t%e usergroup )ersonal

$or"space

$ritebac" Mode

Sandbo+

Wor/ direct! in the "ase with the a"i!it to create u!tip!e sand"o#es.

This is the defau!t case.

(en Grant

Wor/ in a sing!e@ private wor/ area without naed sand"o#es. Grant (en

Wor/ with "oth a Jdefau!tJ private wor/ area and naed sand"o#es. Grant Grant

Wor/ in (irect write"ac/ with no sand"o#. This is the c!assic TM1F

ode. This setting is sii!ar to the addition of (isa"!e*and"o#ingKT to

the configuration fi!e which prevents the use of sand"o#es and puts a!!

users into direct write"ac/.

(en (en



425 26-09-20


26/424

-.#.-. nderstanding t%e ffect of /lan"s in t%e Capability

Assignments) defau!t a!! Capa"i!it ,ssignents are set to "!an/@ which eans either (en or Grant depending on

the defau!t setting of each Capa"i!it.

+or e#ap!e@ )!an/ in the &ersona! Wor/space Write"ac/ Mode Capa"i!it eans (en. )!an/ in the

*and"o# Capa"i!it eans Grant.

When a user is a e"er of ore than one group@ the "!an/ setting a!!ows conf!icts that ight occur to

"e reso!ved "ased on an e#p!icit! set assignent.

When a user is a e"er of ore than one usergroup@ an e#p!icit! set Grant or (en overrides a "!an/.

In the case of conf!icting e#p!icit! set assignents@ a (en capa"i!it overrides a Grant.

*ee the J-sing &ersona! Wor/spaces and *and"o#esJ in the I)MF CognosF TM1F User Guidefor ore

inforation a"out the ip!ications of &ersona! Wor/spaces and *and"o#ing on users.

nderstanding 2ecalc and Commit in a )ersonal $or"space

The fo!!owing ta"!e shows the different effects of Coit and eca!c in a &ersona! Wor/space with

and without Bueuing.



425 26-09-20


27/424

-.#.-.1. nderstanding 2ecalc and Commit in a )ersonal $or"spaceThe fo!!owing ta"!e shows the different effects of Coit and eca!c in a &ersona! Wor/space with and

without Bueuing.

$ritebac" Action Sends ata

(irectead77L

eca!c

Write77L

eca!c

+ro the )ase TM1F Mode!.

To the )ase TM1 Mode!.

&ersona! Wor/spaceead77L

eca!c

Write77L

eca!c

+ro the )ase TM1 Mode!.

To the Personal Workspace.

&ersona! Wor/spaceCoit *ends the Personal Workspacedata to the TM1 )ase Mode!.

&ersona! Wor/space

with ?ueuing Coit *ends the &ersona! Wor/space to the Queue

When a!! resources are avai!a"!e@ the &ersona! Wor/space data is

processed and sent to the )ase TM1 Mode!.

)arent topic*-nderstanding the ffect of )!an/s in the Capa"i!it ,ssignents


425 26-09-20


28/424

-.-. sing )ersistent FeedersTo iprove re!oad tie of cu"es with feeders@ set the &ersistent+eeders configuration paraeter to true

T to store the ca!cu!ated feeders to a .feeders fi!e.

,n insta!!ation with server !oad ties of over 3 inutes can pro"a"! iprove their perforance using

this paraeter.

+or ore detai!s a"out the associated paraeter for this feature ca!!ed Cu"e*ave(ata@ see the IBM


When this paraeter is set to T and the server encounters a persistent feeder fi!e@ it !oads the saved

feeders which reduces the tie nora!! ta/en to reca!cu!ate those feeders. +eeders are saved when the

data is saved or ru!es are edited. Aou do not e#p!icit! save the feeders

+or insta!!ations with an cop!e# feeder ca!cu!ations persisting feeders and then re7!oading the at

server startup wi!! iprove perforance. +or sip!e feeders@ the tie ta/en to read feeders fro dis/

a e#ceed the tie to re7ca!cu!ate the feeders "ut ost insta!!ations wi!! "enefit.

-sing the &ersistent +eeders feature wi!! increase our sste si=e on dis/ on!. Meor si=e is not

affected " the use of this paraeter.

Sa(ing data it% persistent feedersWhen &ersistent+eedersKT@ and a cu"e that uses ru!es is saved@ the feeders are stored a!ong side the

cu"e data in a .feeders fi!e.

Modifying rules for cubes it% feeders

When ru!es for a cu"e are odified the feeders for the ru!es associated with that cu"e are re7run to

pic/ up an changes in the feeder stateents in the ru!es fi!e.

3andling corrupted or in(alidated feeder files

If a corrupted or inva!id feeder fi!e is detected@ a!! the saved feeders wi!! "e de!eted and the server

wi!! e#it with appropriate essages in the !og fi!e.



425 26-09-20


29/424

-.-.1. Sa(ing data it% persistent feedersWhen &ersistent+eedersKT@ and a cu"e that uses ru!es is saved@ the feeders are stored a!ong side the

cu"e data in a .feeders fi!e.

The cu"e fi!es are ca!!ed cue!na"e.cu" and cue!na"e.feeders.

When a cu"e is !oaded@ if a .feeders fi!e e#ists@ it is read to re7!oad the feeders and nora! feeder

eva!uation is s/ipped. If the feeders fi!e does not e#ist nora! feeder ca!cu!ation occurs and the .feeders

fi!e is written after a!! the feeders have "een ca!cu!ated. This wi!! "e the "ehavior the first tie the TM1Fserver is "rought up on a data director with the PersistentFeeders=T. ,s part of the server startup the

.feeders fi!es for a!! the re!evant cu"es wi!! "e written. , new persistent feeders fi!es is written for an

cu"e for which the persistent feeders fi!e is not found at server startup. This eans that the .feeders fi!es

a "e de!eted fro the data director to force a cop!ete re7ca!cu!ation of feeders when the server ne#t

starts. In a TI process@ use the (e!ete,!!&ersistent+eeders TI function to de!ete a!! persistent feeders.

The odified tie of the .feeders fi!e is copared to that of the "ase cu"e fi!e at !oad tie. If the cu"e

fi!e is newer than the feeders fi!e@ the .feeders fi!e is regarded as inva!id and is de!eted. The .feeders fi!e

is a!was written after the cu"e fi!e so it shou!d a!was "e newer than the cu"e fi!e.

)arent topic*-sing &ersistent +eeders


425 26-09-20


30/424

-.-.#. Modifying rules for cubes it% feedersWhen ru!es for a cu"e are odified the feeders for the ru!es associated with that cu"e are re7run to pic/

up an changes in the feeder stateents in the ru!es fi!e.

The TM1F server never de!etes feeders these!ves in eor so this reca!cu!ation wi!! on! add new

feeders@ it wi!! not de!ete feeders which a no !onger "e va!id due to the ru!e fi!e edits.

,fter the feeders are reca!cu!ated@ the persistent feeder fi!es for the cu"e whose ru!e was edited@ and a!!

dependent cu"es due to () stateents in the ru!es are rewritten. )ecause feeders in eor arenever de!eted@ this eans that ru!e fi!e edits a !eave soe feeders set which are no !onger va!id no

ru!es actua!! app!. These unused feeders wi!! "e saved with the persistent feeders. )ecause of the

possi"i!it of unused feeders@ the adinistrator a want to periodica!! during soe tie when there is

!itt!e deand on the server re7ca!cu!ate a!! the feeders. This is done " ca!!ing the

(e!ete,!!&ersistent+eeders Tur"oIntegrator function@ shutting down the server@ and then "ringing the

server "ac/ up. When the server is "rought "ac/ up@ "ecause there is no persistent feeder inforation@ a!!

the feeders wi!! "e re7ca!cu!ated and new persistent feeder inforation wi!! "e written to dis/. *ee the

Tur"oIntegrator +unctions chapter of the eference Guide for ore inforation.



425 26-09-20


31/424

-.-.-. 3andling corrupted or in(alidated feeder filesIf a corrupted or inva!id feeder fi!e is detected@ a!! the saved feeders wi!! "e de!eted and the server wi!!

e#it with appropriate essages in the !og fi!e.

In that case@ ou ust restart the server to re!oad and re7copute a!! of the feeders. The essages in

the !og wi!! "e of the for>

#$%%& '((O( #&1&!&)!1* 1+,1&,#%-*)) Cognos. -/erver 0ll persistent feeder files ill e deleted and

server ill s2ut don

#$%%& '((O( #&1&!&)!1* 1+,1&,#%-*)) TM1. -/erver (estart server to re!load dataase-

+eeder fi!es are deeed Jinva!idJ if there is a forat error in the fi!e@ or if the date7tie of the feeder fi!e

is o!der than the corresponding cu"e .C-) fi!e which a happen if one tries to anua!! cop feeder or

cu"e fi!es fro one data director to another. When a feeder fi!e is deeed to "e inva!id@ a essage is

written to the sste !og fi!e e#p!aining the e#act reason that the feeder fi!e is deeed to "e inva!id. The

essage has the for>

'((O( #&1&!&)!1* 1+,&&,##-+3$ TM1 -/erver Invalid feeder file detected for cue 455554 reason, ---

This essage wi!! tpica!! in the case of a u!ti7threaded !oad or an error with an cu"e which !oads

ear! in the startup process not "e near the end of the fi!e@ "ut rather wi!! "e in the idd!e of the !oadseBuence. *earching the essage !og for JOJ wi!! show the error.



425 26-09-20


32/424

-.4. Configuring and Managing Sandbo+es in your TM1 n(ironment,s the TM1F adinistrator@ ou shou!d understand soe technica! ites when using *and"o#es and

&ersona! Wor/spaces in our TM1 environent.

Meor usage for *and"o#es and &ersona! Wor/spaces

Managing the fi!es and fo!ders that support *and"o#es and &ersona! Wor/spaces

TM1 server configuration paraeters for *and"o#es and &ersona! Wor/spaces

The sand"o# feature !ets ou create our own &ersona! Wor/spaces or *and"o#es separate fro our

"ase data. , sand"o# is not a cop of the "ase data@ "ut is a separate over!a or !aer of our own data

va!ues that ou have entered on top of the "ase data.

The new data va!ues that ou enter in a *and"o# or &ersona! Wor/space are not saved to the "ase data

unti! ou e#p!icit! coit the changed data in the sand"o# to the "ase data. This "ehavior is different

than wor/ing direct! in "ase data where an new data va!ues that ou enter are written direct! "ac/ to

the TM1 server.

+or ore detai!s on using the *and"o# or &ersona! Wor/space feature@ see the inforation on *and"o#s

and &ersona! Wor/spaces in the I)MF CognosF TM1 User Guideand the I)M Cognos TM1

TuroIntegrator Guide.

Memory sage Considerations for Sandbo+es and )ersonal $or"spaces

If ou are using the sand"o# feature@ ou shou!d "e aware that sand"o#es reBuire usage of soe

additiona! aount of ,M eor and hard dis/ space. rror essages disp!a when users approach

their sand"o# eor !iit.

Managing Files and Folders for Sandbo+es

ach TM1 server stores the support fi!es for sand"o#es in the su"7fo!ders of the TM1 server data

director.

TM1 Ser(er Configuration )arameters for Sandbo+es

The TM1 server configuration fi!e@ T1s.cfg@ uses paraeters for ena"!ing and anaging the sand"o#

feature.

nderstanding Sandbo+ ifferences Among ifferent TM1 Clients

The sand"o# feature wor/s s!ight! different! in Cognos TM1 ,pp!ication We" copared to the !egac

c!ients of TM1 &erspectives @ *erver #p!orer@ and TM1 We".



425 26-09-20


33/424

-.4.1. Memory sage Considerations for Sandbo+es and )ersonal

$or"spacesIf ou are using the sand"o# feature@ ou shou!d "e aware that sand"o#es reBuire usage of soe

additiona! aount of ,M eor and hard dis/ space. rror essages disp!a when users approach

their sand"o# eor !iit.

Aou can contro! the aount of eor used for sand"o#es per user " ad


34/424

-.4.#. Managing Files and Folders for Sandbo+esach TM1F server stores the support fi!es for sand"o#es in the su"7fo!ders of the TM1 server data

director.

If ou are "ac/ing up this data@ ou a want to consider these fi!es and the ip!ications of "ac/ing up

and restoring sand"o# fi!es.

,dinistrators can de!ete sand"o#es using a variet of criteria.

*ee the *erver*and"o#es(e!ete configuration paraeter in the IBM. Cognos. TM1 Installation and

Configuration Guidefor ore inforation.

)arent topic*Configuring and Managing *and"o#es in our TM1 nvironent


425 26-09-20


35/424

-.4.-. TM1 Ser(er Configuration )arameters for Sandbo+esThe TM1F server configuration fi!e@ T1s.cfg@ uses paraeters for ena"!ing and anaging the sand"o#

feature.

DisableSandboxingparaeter

MaxUserSandboxSizeparaeter

+or ore detai!s a"out the T1s.cfg fi!e and these paraeters@ see the IBM Cognos TM1 Installationand Configuration Guide.

Capa"i!it ,ssignents

The use of &ersona! Wor/spaces or *and"o#es is contro!!ed using the Capa"i!it ,ssignents option

avai!a"!e on the *erver #p!orer@ *erver enu. *ee the *ste Configuration chapter of the I)MF

CognosF TM1 Operation Guidefor ore inforation.



425 26-09-20


36/424

-.4.4. nderstanding Sandbo+ ifferences Among ifferent TM1

ClientsThe sand"o# feature wor/s s!ight! different! in Cognos TM1F ,pp!ication We" copared to the !egac

c!ients of TM1 &erspectives @ *erver #p!orer@ and TM1 We".

This inforation is targeted to those users or adinistrators who use a co"ination of these c!ients.

efault Sandbo+ and /ase ata

egard!ess of other configuration settings@ in the Cognos TM1 ,pp!ication We" c!ient@ the defau!t sand"o#

is ca!!ed defau!t.

This option operates in the sae wa as the *and"o# feature in other c!ients. Aou cannot turn on a

&ersona! Wor/space in the Cognos TM1 ,pp!ication We" c!ient. Cognos TM1 ,pp!ication We" a!so does not

perit direct write"ac/ so ou cannot wor/ direct! with the "ase data when using Cognos TM1

,pp!ication We".

Cognos TM1 ,pp!ication We" users can su"it their sand"o# data to "ase data on! as part of the Cognos

TM1 ,pp!ication We" wor/f!ow process.

5isibility of Sandbo+es in ifferent TM1 Clients

) design@ Cognos TM1 ,pp!ication We" does not disp!a an sand"o#es created in TM1 &erspectives @

*erver #p!orer or TM1 We".

+or e#ap!e@ a sand"o# created in TM1 We" does not disp!a in the Cognos TM1 ,pp!ication We" c!ient

sand"o# drop7down !ist.



425 26-09-20


37/424

-.6. sing )arallel Interaction it% a Cognos TM1 ser(er&ara!!e! Interaction is an I)MF CognosF TM1F server7re!ated feature that a!!ows for greater concurrenc

of read and write operations on the sae cu"e o"


38/424

-.6.1. /est practice use of )arallel InteractionTo o"tain a#iu perforance gains provided " &ara!!e! Interaction@ fo!!ow these "est practice

guide!ines.

&ara!!e! Interaction &I is a server configuration that iproves response tie of writing data " reoving

!oc/ contention resu!ting fro concurrent cu"e data access when the sste reads data or when the

sste writes data. When ena"!ed@ &ara!!e! Interaction changes the CognosF TM1F O"

*upport of concurrent writers e#ecuting high7!eve! data spreading input

*upport of high user counts for readers deanding instantaneous access to fresh!7entered data

Maintenance of ore recent!7updated environents during cu"e data !oads over the course of a da

#ecution of Tur"oIntegrator (ata ,!!ocation processes sourcing data fro Input Cu"es

#ecution of Tur"oIntegrator (ata Manipu!ation processes to increenta!! "ui!d eader Cu"es

sourcing data fro Input Cu"es

&ara!!e! Interaction is usefu! for an Cognos TM1 app!ication invo!ving write"ac/ activit. *ufficient server

C&- cores are needed to rea!i=e the "enefit of &ara!!e! Interaction and to process the greater throughput

of concurrent read and write operations. *ufficient cores a!so ensure that an reaining J"!oc/ingJ

activit resu!ting fro eta data aintenance does not interfere with writer perforance. &ara!!e!

Interaction does not iprove Buer perforance@ so it is not recoended for Cognos TM1 read7on!

app!ications.

)arallel Interaction impact on Cognos TM1 ser(er core utili7ation

If the environent has sufficient server cores to process the increenta! transactiona! activit@ using

&ara!!e! Interaction in Cognos TM1 for wor/ that is su"


39/424

in Cognos TM1 ;.3.2 or higher with &ara!!e! Interaction On copared to Cognos TM1 ;.3.1. This situation

occurs "ecause with &ara!!e! Interaction@ writers uti!i=e C&- resources ore efficient! and copete with

readers for those resources. With the greater throughput of write activit in Cognos TM1 ;.3.2 or higher@

&ara!!e! Interaction ore freBuent! inva!idates interna! caches which can a!so negative! ipact reader

perforance.

&ara!!e! Interaction does not ie!d perforance "enefits for readers in read7on! Cognos TM1 app!ications.

)arallel Interaction&s impact on Cognos TM1 Semap%ore best practice

&rior to Cognos TM1 ;.3.2@ custoers ep!oed a Tur"oIntegrator )est &ractice ca!!ed J*eaphoreJ to

prevent Tur"oIntegrator process JthrashingJ a wastefu! situation of successive ro!!"ac/s and retries

which resu!ts in perforance issues for the end users. Thrashing is caused " concurrent e#ecution of

Tur"oIntegrator processes that !oc/ed the sae o"


40/424

&ara!!e! Interaction a!!ows for siu!taneous e#ecution of processes reading andHor writing to the sae

cu"e none of the data !oading processes "!oc/ing the others without the need for )atch -pdate *tart H

)atch -pdate Wait +inish. ee"er that processes doing eta data updates resu!t in "!oc/ing actions.

Cognos TM1 ;.3.2 tests with &ara!!e! Interaction On copared with siu!taneous data !oads using )atch

-pdate revea! that perforance is faster without )atch -pdate. Therefore@ when &ara!!e! Interaction is

On@ it is "est to reove the use of )atch -pdate fro Tur"oIntegrator processes.

+or read7on! environents where &ara!!e! Interaction is Off@ )atch -pdate *tartH)atch -pdate +inish Wait

reains a )est &ractice for increasing the perforance data !oading using siu!taneous data !oadingTur"oIntegrator processes.

)arallel Interaction impact on Cognos TM1 ser(er memory

Interna! testing coparing Cognos TM1 ;.3.1 to Cognos TM1 ;.3.2 with &ara!!e! Interaction have shown

the Cognos TM1 ;.3.2 *erver to a!!ocate "etween 10 to $0 ore ,M than the Cognos TM1 ;.3.1

server. *oe of this increased eor use is due to the interna! structures created " &ara!!e!

Interaction@ however the additiona! throughput of transactions and their ipact on 4iew Cache is a!so a

contri"uting factor. &!an for $0 ore eor usage with Cognos TM1 ;.3.2 than with prior versions of

Cognos TM1 .

Operations t%at cause ob8ect loc"ing and potential performance delays

&ara!!e! Interaction great! iproves writer perforance and provides predicta"!e perforance as reader

and writer user counts sca!e. owever@ there are Cognos TM1 operations that can as/ the "enefits of

&ara!!e! Interaction " !oc/ing o"

Log4j.logger.TM1.Cube.Dependency=INFO

ntries in the !og fi!e wi!! !oo/ !i/e the fo!!owing>


425 26-09-20


41/424

9968 [] INFO 2011-03-28 19:18:21.718 TM1.Cube.Dependency

Adding cube dependency: cube "SalesCube" depends on cube "PriceCube"

In this e#ap!e@ &riceCu"e is the ase cueand *a!esCu"e is the dependent cue. The correct

app!ication of this dependenc when creating an e#p!icit ,ddCu"e(ependenc function is as fo!!ows>

AddCubeDependency(PriceCube','SalesCube')

*ee -nderstanding Cu"e (ependencfor ore inforation.

5ieConstruct in a TurboIntegrator )rocess

-se a 4iewConstruct function in Tur"oIntegrator processes to pre7cache a view to iprove

perforance for su"seBuent 4iew e#ecution assuing the cache has not "een inva!idated. This

function "!oc/s reads and writes to the 4iew's cu"e for the duration of the process.

*ee the 4iewConstruct function in the IBM Cognos TM1 (eference Guide.

lement Maintenance

!eent Maintenance wi!! cause "!oc/s to readers and writers of an cu"e containing the aintained

diension. Contention issues a arise when the diension is aintained as part of a !onger running

Tur"oIntegrator process. Iso!ate eta data aintenance fro data aintenance in distinctTur"oIntegrator &rocesses so that the eta data aintenance operation doesn't carr its !oc/

throughout the data aintenance operation which is non7"!oc/ing with &ara!!e! Interaction. This

goa! can "e accop!ished in separate!7e#ecuted Chores or " using the TM1unTI uti!it to e#ecute

processes e#terna! to Cognos TM1 .

The TM1unTI uti!it was provided in TM1 ;.3.2 inor fo!!ow7up re!ease and is part of the standard

insta!!ation as of Cognos TM1 10.1.0.

pdating an Alias

-pdating an a!ias attri"ute causes "!oc/s to readers and writers of an cu"e containing the

aintained diension. Contention issues arise when the diension is aintained as part of a !onger

running Tur"oIntegrator process. Iso!ate a!ias aintenance in Tur"oIntegrator &rocesses to !essen the"!oc/ing ipact.

)arent topic*-sing &ara!!e! Interaction with a Cognos TM1 server


425 26-09-20


42/424

4. Cognos TM1 Admin Ser(er Operations

This section provides an overview of the I)MF CognosF TM1F ,din *erver and descri"es the tpica!

adinistrator tas/s of running the ,din *erver on Windows and -NI5 sstes.

+or detai!s a"out Cognos TM1 sste architecture@ see the IBM Cognos TM1 Installation and

Configuration Guide.

TM1 Admin Ser(erThe TM1 ,din *erver is a process that /eeps trac/ of a!! TM1 servers running on a networ/. ,n

,din *erver runs on a coputer /nown as an ,din ost.

2unning t%e Cognos TM1 Admin Ser(er on a $indos operating system

,fter ou insta!! the I)M Cognos TM1 ,din *erver on a Microsoft Windows sste@ ou can anage

the server either anua!! or " using the Cognos Configuration uti!it.

2unning t%e Cognos TM1 Admin Ser(er on 'I9

,fter ou insta!! the TM1 ,din *erver on a -NI5 sste@ ou can start@ stop and anage the ,din

*erver either anua!! or " using the I)M Cognos Configuration uti!it.

Specifying t%e :ocation of t%e Admin 3ost

Aou specif the !ocation of the ,din ost different! for c!ients user interfaces and reote servers.


425 26-09-20


43/424

4.1. TM1 Admin Ser(erThe TM1F ,din *erver is a process that /eeps trac/ of a!! TM1 servers running on a networ/. ,n ,din

*erver runs on a coputer /nown as an ,din ost.

When the TM1 server starts@ the server registers itse!f with an ,din *erver that is running on a specified

,din ost. TM1 c!ients reference the ,din *erver to deterine which TM1 servers are avai!a"!e on the

networ/.

The fo!!owing diagra shows how c!ients and servers use the ,din *erver.

The ,din *erver aintains the fo!!owing inforation for each avai!a"!e TM1 server>

*erver nae

I& address

&rotoco!

&ort nu"er

,!! this inforation is supp!ied " the TM1 server when the server registers itse!f on the ,din *erver.

,n ,din *erver ust "e running "efore a TM1 server can start. If ou have specified an ,din ost in

the T1s.cfg fi!e or the server coand !ine@ the TM1 server wi!! attept to connect to an ,din *erver

on that host. The TM1 server wi!! fai! to coe up if it is una"!e to connect to the ,din *erver for an

reason.

If ou have not specified an ,din ost@ the TM1 server attepts to connect to an ,din *erver on the!oca! achine. If an ,din *erver is not current! running on the !oca! achine@ the TM1 server starts a

new ,din *erver and connects to it.

The ,din *erver "ecoes aware of TM1 servers on the networ/ " !istening for notification fro the

servers. -sua!!@ the TM1 server sends notification of its presence at a regu!ar interva! ca!!ed the

Jheart"eat interva!@J which is 80 seconds " defau!t. When the ,din *erver detects the TM1 server@ that

server "ecoes registered and avai!a"!e to c!ients on the networ/. owever@ if the ,din *erver does not

detect the presence of a registered TM1 server over a period eBua! to three ties the heart"eat interva!@

that TM1 server is reoved fro the !ist of servers avai!a"!e on the networ/. ConseBuent!@ the TM1

server wi!! not "e avai!a"!e to c!ients on the networ/.


425 26-09-20


44/424

) defau!t@ the ,din *erver uses port 3;3. If port 3;3 is a!read in use@ ou can assign a new port

nu"er " creating a new service ca!!ed T1adsrv. ,!! TM1 app!ications !oo/ for a naed service ca!!ed

T1adsrv@ and if that service e#ists@ the app!ications use the port nu"er assigned to the service. If

the service does not e#ist@ TM1 app!ications use port 3;3.

)arent topic*Cognos TM1 ,din *erver Operations


425 26-09-20


45/424

4.#. 2unning t%e Cognos TM1 Admin Ser(er on a $indos operating

system,fter ou insta!! the I)MF CognosF TM1F ,din *erver on a Microsoft Windows sste@ ou can

anage the server either anua!! or " using the Cognos Configuration uti!it.

Aou can a!so run specific Tur"oIntegrator processes as part of startup.

*ee the JChoresJ chapter in the IBM Cognos TM1 TuroIntegrator Guidefor ore inforation.

Manually starting t%e Cognos TM1 Admin Ser(er on $indos

Aou can anua!! run the Cognos TM1 ,din *erver as a service or an app!ication on Microsoft Windows.

-se the T1adsd.e#e fi!e in the install6dirP"in director to run the ,din *erver as a Windows service.

To add the Cognos TM1 ,din *erver as a Windows service@ run the fo!!owing coand at a

coand propt fro the install6dirP"in director>

Tm1admsd -install

To reove the Cognos TM1 ,din *erver Windows service@ run the fo!!owing coand at a

coand propt fro the install6dirP"in director>

Tm1admsd -remove

-se the T1adsrv.e#e fi!e to run the ,din *erver as a Windows app!ication. +or detai!s@ see unning

the Cognos TM1 ,din *erver as an ,pp!ication on Windows.

sing Cognos Configuration to manage t%e Cognos TM1 Admin Ser(er on

$indos

+or detai!s on using the Cognos Configuration uti!it to anage the Cognos TM1 ,din *erver on a

Microsoft Windows operating sste@ see the IBM Cognos TM1 Installation and Configuration Guide.

2unning t%e Cognos TM1 Admin Ser(er as an Application on $indos

To run the ,din *erver as an app!ication@ use the T1adsrv.e#e e#ecuta"!e fi!e.



425 26-09-20


46/424

4.#.1. 2unning t%e Cognos TM1 Admin Ser(er as an Application on

$indosTo run the ,din *erver as an app!ication@ use the T1adsrv.e#e e#ecuta"!e fi!e.

This fi!e is p!aced in the install6dirP"in director when ou insta!! I)MF CognosF TM1F . Aou can run the

,din *erver " dou"!e7c!ic/ing the T1adsrv.e#e fi!e@ "ut we recoend that ou create a shortcut

to the e#ecuta"!e fi!e in the *tartup director on the ,din ost. That wa@ the ,din *erver is !aunched

whenever the ,din ost starts.

)rocedure

C!ic/ the Start"utton on the Windows tas/"ar.1.

Choose Settings@ Tas"bar.2.

C!ic/ the Start Menu )rogramsta".$.

C!ic/ Add.

The Create *hortcut dia!og "o# opens.

.

nter the fu!! path to T1adsrv.e#e in the Command linefie!d@ or c!ic/ /roseto navigate to the

fi!e.

3.

If necessar@ specif a coand !ine paraeter to set the heart"eat interva! for the ,din *erver.

)arameter

7 h

*ets the heart"eat interva!@ in seconds@ for TM1 servers registered with the ,din *erver.

The defau!t heart"eat interva! is 80 seconds.

8.

C!ic/ 'e+t.

The *e!ect &rogra +o!der dia!og "o# opens.

9.

*e!ect Startup.:.

C!ic/ 'e+t.

The *e!ect a Tit!e dia!og "o# opens.

;.

Tpe a nae for the shortcut and c!ic/ Finis%.10.

5ieing Admin Ser(er Status

When an ,din *erver is running as an app!ication on an ,din ost@ an icon is appended to the

Windows sste tra.

)arent topic*unning the Cognos TM1 ,din *erver on a Windows operating sste


425 26-09-20


47/424

4.#.1.1. 5ieing Admin Ser(er StatusWhen an ,din *erver is running as an app!ication on an ,din ost@ an icon is appended to the

Windows sste tra.

To view the current status of the ,din *erver@ dou"!e7c!ic/ the icon.

The I)MF CognosF TM1F ,din *erver window shows the fo!!owing inforation>

Tie at which the ,din *erver was started

Machine on which it is running

&ort "eing used

(etai!s of each TM1 server current! registered with the ,din *erver

To shut down an ,din *erver running as an app!ication@ c!ic/ Stop Admin Ser(er.

Aou cannot view the status of an ,din *erver running as a Windows service.

)arent topic*unning the Cognos TM1 ,din *erver as an ,pp!ication on Windows


425 26-09-20


48/424

4.-. 2unning t%e Cognos TM1 Admin Ser(er on 'I9,fter ou insta!! the TM1F ,din *erver on a -NI5 sste@ ou can start@ stop and anage the ,din

*erver either anua!! or " using the I)MF CognosF Configuration uti!it.

Manually starting t%e Cognos TM1 Admin Ser(er on 'I9

To anua!! run the TM1 ,din *erver on a -NI5 sste@ run the t1adsrv.e#e fi!e fro the

install6dirH"in director.

sing Cognos Configuration to manage t%e Cognos TM1 Admin Ser(er on 'I9

+or detai!s on using the I)M Cognos Configuration uti!it to anage the TM1 ,din *erver on a -NI5

sste@ see the IBM Cognos TM1 Installation and Configuration Guide.

5ieing Admin Ser(er Status 2eport

To view an ,din *erver status report@ run t1adstat.e#e fro the install6dirH"in director.



425 26-09-20


49/424

4.-.1. 5ieing Admin Ser(er Status 2eportTo view an ,din *erver status report@ run t1adstat.e#e fro the install6dirH"in director.

The ,din *erver report contains the fo!!owing inforation>

Tie at which the ,din *erver was started

Machine on which it is running

&ort "eing used

(etai!s of each TM1F server current! registered with the ,din *erver

)arent topic*unning the Cognos TM1 ,din *erver on -NI5


425 26-09-20


50/424

4.4. Specifying t%e :ocation of t%e Admin 3ostAou specif the !ocation of the ,din ost different! for c!ients user interfaces and reote servers.

To specif the ,din ost referenced " c!ients@ edit the ,dinost paraeter in the T1p.ini c!ient

configuration fi!e.

Aou can change the T1p.ini fi!e " using the TM1F Options enu in *erver #p!orer.

Aou can a!so anua!! edit the T1p.ini fi!e. +or ore inforation@ see the T1p.ini topic in the IBMCognos TM1 Installation and Configuration Guide.

To specif the ,din ost with which reote servers register@ use one of the fo!!owing ethods>

dit the ,dinost paraeter in the T1s.cfg fi!e.

-se the 7v coand7!ine paraeter when ou "ring up the Windows version of the TM1 server.

+or inforation on server configuration paraeters@ see the topic a"out the T1s.cfg fi!e in the IBM


Specifying Multiple Admin 3osts

Aou can set a TM1 c!ient to reference u!tip!e ,din osts " separating host naes with

seico!ons.



425 26-09-20


51/424

4.4.1. Specifying Multiple Admin 3ostsAou can set a TM1F c!ient to reference u!tip!e ,din osts " separating host naes with seico!ons.

, c!ient that specifies u!tip!e ,din osts can access an TM1 servers that are registered with the

,din *ervers on the specified hosts.

)arent topic**pecifing the 6ocation of the ,din ost


425 26-09-20


52/424

6. 2emote Cognos TM1 Ser(er OperationsThis section descri"es how I)MF CognosF TM1F reote servers wor/@ and how ou can anage their

operations.

+or cop!ete detai!s a"out Cognos TM1 sste architecture@ see the IBM Cognos TM1 Installation and

Configuration Guide.

+or detai!s on using the I)M Cognos Configuration uti!it to anage TM1 reote servers on a Windows or

-NI5 sste@ see the IBM Cognos TM1 Installation and Configuration Guide.

O(er(ie of 2emote Ser(er Operations

The fo!!owing figure i!!ustrates the operations of a reote TM1 server. These operations are e#p!ained

in the te#t that fo!!ows.

Setting p a 2emote TM1 Ser(er to 2un as an Application

,fter ou run the TM1 Insta!!ation Wi=ard on a Microsoft Windows sste and insta!! the sap!e TM1

servers@ ou can use the I)M Cognos Configuration uti!it to run each sap!e server as a Microsoft

Windows service. ,s an a!ternative@ ou can anua!! set up the TM1 server to run as an app!ication.

Setting p a 2emote TM1 Ser(er to 2un as a $indos Ser(ice

Aou can anua!! insta!! a TM1 server to run as a Windows service@ or reove an e#isting one@ using

the coand !ine options of the t1sd.e#e fi!e. The t1sd.e#e fi!e is insta!!ed in the installP"in

director.

Starting a 2emote TM1 Ser(er

The topics in this section descri"e how to start a!! versions of the TM1 server.

Connecting to a 2emote Ser(er

To connect to a reote TM1 server@ a c!ient ust point to an ,din ost on which an ,din *erver is

running. The ,din *erver aintains inforation a"out reote TM1 servers avai!a"!e on the

networ/@ inc!uding nae@ protoco!@ address@ and port nu"er. The ,din ost used " the c!ient is

specified in the T1p.ini fi!e.

isconnecting from a 2emote Ser(er

Aou can disconnect fro a reote server.

S%utting on a $indos TM1 Ser(er

Aou can shut down a reote server that has "een set up to run as a Windows app!ication.

S%utting on a 'I9 TM1 Ser(er

Aou can shut down a server running in the foreground.

:ogging Transactions

ach TM1 server trac/s the data transactions ade " its c!ients. When a c!ient changes a cu"e

va!ue@ TM1 records the change in a transaction !og fi!e naed T1s.!og@ which is !ocated in the TM1

server data director.

Monitoring Ser(er )erformance

TM1 inc!udes a perforance onitoring feature that !ets ou record the perforance statistics for

c!ients@ cu"es@ and servers. When ou ena"!e perforance onitoring@ TM1 popu!ates severa! contro!

cu"es on a inute7"7inute "asis. Aou can then "rowse these cu"es to ana!=e the server

perforance.

Managing Client Connections

,s a TM1 server adinistrator@ ou can use the C!ients Messaging Center to anage c!ient

connections.

2emote Ser(er Memory Management

The TM1 server uses a sparse eor anageent schee@ which a!!ows the server to ho!d ver


425 26-09-20


53/424

!arge cu"es in uch !ess space than the sae data wou!d occup in a re!ationa! data"ase. Therefore@

the eor anageent schee a!!ows the server to accoodate ver !arge data"ases in ,M

without the need to use dis/ space.

sing TM1 in /ul" :oad Mode

)u!/ 6oad Mode ena"!es I)M Cognos TM1 to run in a specia! optii=ed sing!e7user or sing!e

choreHprocess ode. This ode can a#ii=e Cognos TM1 perforance for dedicated tas/s during

ties when !itt!e or no other activit is e#pected.


425 26-09-20


54/424

6.1. O(er(ie of 2emote Ser(er OperationsThe fo!!owing figure i!!ustrates the operations of a reote TM1F server. These operations are e#p!ained in

the te#t that fo!!ows.

On startup@ the reote server !oads diensions and cu"es fro the data director into the server

achine ,M. ,t the sae tie@ the server opens a new transactiona! !og fi!e ca!!ed T1s.!og in the

data director. ,fter the cu"es are !oaded@ the reote server is avai!a"!e.

The reote TM1 server registers itse!f with one or ore ,din *ervers so that c!ients can connect to

the reote TM1 server.

C!ient app!ications contact ,din *ervers to !ocate avai!a"!e TM1 servers. The c!ients !og into the TM1

servers whose data the want to access.

C!ients edit the cu"e data@ sending the va!ues "ac/ to the TM1 server.

,s new va!ues are received fro c!ients@ the TM1 server writes the records to the T1s.!og fi!e@

/eeping trac/ of ever data change@ inc!uding the date and tie the edit occurred@ and the I( of the

c!ient who ade the edit.

,s the server ca!cu!ates new va!ues in response to c!ient reBuests@ the server stores the in eor@

increasing the aount of eor used " the server.

When the server shuts down@ a!! records in the T1s.!og fi!e are saved to dis/@ and the transaction

!og fi!e is renaed " appending a dateHtie stap to it. The T1s.!og fi!e is saved in the server's

data director to "ac/ out data transactions@ as descri"ed in )ac/ing Out ecords fro the

Transaction 6og.

If the server is intentiona!! shut down without saving the changes@ the !og fi!e is saved with a

tieHdate stap and the e#tension is changed to .re


55/424

iediate! written to dis/@ the transaction !og fi!e is renaed " appending a dateHtie stap to it@

and a new T1s.!og fi!e is created to accept an su"seBuent edits to cu"e va!ues.

,n changes to the etadata@ such as diension definitions and cu"e definitions@ are iediate!

saved to dis/. The changes to the etadata are not written to the transaction !og fi!e.

)arent topic*eote Cognos TM1 *erver Operations


425 26-09-20


56/424

6.#. Setting p a 2emote TM1 Ser(er to 2un as an Application,fter ou run the TM1F Insta!!ation Wi=ard on a Microsoft Windows sste and insta!! the sap!e TM1

servers@ ou can use the I)M Cognos Configuration uti!it to run each sap!e server as a Microsoft

Windows service. ,s an a!ternative@ ou can anua!! set up the TM1 server to run as an app!ication.

)rocedure

Open the install6dirP"in director in Windows Internet #p!orer.1.

ight7c!ic/ T1s.e#e.2.

*e!ect Create S%ortcut.

Windows creates *hortcut to T1s.e#e in the install6dirP"in director.

$.

ight7c!ic/ *hortcut to T1s.e#e..

*e!ect )roperties.

The &roperties window opens.

3.

C!ic/ the S%ortcutta".

The Target fie!d on this ta" contains the fu!! path to T1s.e#e.

8.

In the Target fie!d@ add the 7= f!ag and specif the fu!! path to the director containing the T1s.cfg

fi!e for the server.

+or e#ap!e@ 7= C>PTM1Psa!esdata indicates that the T1s.cfg fi!e for the server resides in the C>PTM1

Psa!esdata director.

'ote*If the path to the director contains an "!an/ spaces@ enc!ose the entire path with dou"!e

Buotes.

The contents of the Target fie!d shou!d rese"!e the fo!!owing>

"C:\Program Files\IBM\cognos\tm1\bin\tm1s.exe" -z C:\TM1\salesdata

9.

C!ic/ O;to save the shortcut.

Aou ight want to ove the shortcut to the des/top for eas access.

:.



425 26-09-20


57/424

6.-. Setting p a 2emote TM1 Ser(er to 2un as a $indos Ser(iceAou can anua!! insta!! a TM1F server to run as a Windows service@ or reove an e#isting one@ using

the coand !ine options of the t1sd.e#e fi!e. The t1sd.e#e fi!e is insta!!ed in the installP"in director.

The topics in this section descri"e how to configure a TM1 server to run as a Windows service.

Installing a TM1 Ser(er to 2un as a $indos Ser(ice

To insta!! a TM1 server to run as a Windows service@ use the fo!!owing coand !ine forat >

tm1sd.exe -installparameters

2emo(ing a TM1 Ser(er from 2unning as a $indos Ser(ice

To reove a TM1 server that is running as a service@ use the fo!!owing coand !ine forat.



425 26-09-20


58/424

6.-.1. Installing a TM1 Ser(er to 2un as a $indos Ser(iceTo insta!! a TM1F server to run as a Windows service@ use the fo!!owing coand !ine forat >

tm1sd.exe -installparameters

The fo!!owing ta"!e !ists the avai!a"!e paraeters.

)arameter 2e

(oain and user nae in the forat Do"ain8userna"e. +or e#ap!e@

entpP


59/424

6.-.#. 2emo(ing a TM1 Ser(er from 2unning as a $indos Ser(iceTo reove a TM1F server that is running as a service@ use the fo!!owing coand !ine forat.

tm1sd.exe -remove -n ServerName

where /erver9a"eis the Microsoft Windows service nae of the TM1 server ou want to reove.

+or e#ap!e@ the fo!!owing coand !ine reoves an e#isting service for the sdata TM1 server.

tm1sd.exe -remove -n sdata

)arent topic**etting -p a eote TM1 *erver to un as a Windows *ervice


425 26-09-20


60/424

6.4. Starting a 2emote TM1 Ser(erThe topics in this section descri"e how to start a!! versions of the TM1F server.

Starting a TM1 Ser(er Set p as a $indos Application

Aou can start a reote server that has "een set up as a Windows app!ication.

Starting a TM1 Ser(er Installed as a $indos Ser(ice

To start a reote server that has "een insta!!ed as a service@ cop!ete the fo!!owing steps.

Starting a 'I9 TM1 Ser(er

To assist ou in starting a -NI5 TM1 server@ a sap!e script naed startup%t1s.sh is avai!a"!e in the

install6dirH"in or H"in8 director.



425 26-09-20


61/424

6.4.1. Starting a TM1 Ser(er Set p as a $indos ApplicationAou can start a reote server that has "een set up as a Windows app!ication.

)rocedure

(ou"!e7c!ic/ the TM1F *a!es (ata icon.

2esults

, server window opens. The server window !ists the cu"es and diensions !oaded into the server ,M.

)arent topic**tarting a eote TM1 *erver


425 26-09-20


62/424

6.4.#. Starting a TM1 Ser(er Installed as a $indos Ser(iceTo start a reote server that has "een insta!!ed as a service@ cop!ete the fo!!owing steps.

)rocedure

Open the Microsoft Windows *ervices anager.

, !ist of insta!!ed services opens.

1.

*e!ect the entr for the TM1F server ou want to start@ for e#ap!e )lanning Sample@ and c!ic/ the

Start"utton.

,n ,din *erver ust "e running "efore a TM1 server can start. If ou have specified an ,din ost

in the T1s.cfg fi!e@ the TM1 server wi!! attept to connect to an ,din *erver on that host. The TM1

server wi!! fai! to coe up if it is una"!e to connect to an ,din *erver for an reason.

If ou have not specified an ,din ost@ the TM1 server attepts to connect to an ,din *erver on

the !oca! achine. If an ,din *erver is not current! running on the !oca! achine@ either as a

service or an app!ication@ the TM1 server starts a new ,din *erver app!ication and connects to it.

2.

Setting up a Ser(ice to Start Automatically

To set up an insta!!ed service to start autoatica!! when Microsoft Windows re"oots@ cop!ete thefo!!owing steps.



425 26-09-20


63/424

6.4.#.1. Setting up a Ser(ice to Start AutomaticallyTo set up an insta!!ed service to start autoatica!! when Microsoft Windows re"oots@ cop!ete the

fo!!owing steps.

)rocedure

Open Windows *ervices anager.

, !ist of insta!!ed services opens.

1.

(ou"!e7c!ic/ the TM1F Ser(erentr.

The Ser(ice )ropertiesdia!og "o# opens.

2.

*e!ect Automaticas the *tartup Tpe and c!ic/ O;.$.

)arent topic**tarting a TM1 *erver Insta!!ed as a Windows *ervice


425 26-09-20


64/424

6.4.-. Starting a 'I9 TM1 Ser(erTo assist ou in starting a -NI5 TM1F server@ a sap!e script naed startup%t1s.sh is avai!a"!e in the

install6dirH"in or H"in8 director.

With a few inor odifications@ ou can use this sap!e script to start our -NI5 TM1 server. When ou

use the script to start a server@ TM1 uses the T1s.cfg fi!e in the specified data director to direct the

"ehavior of the server.

Modifying t%e startup,tm1s.s% ScriptModif the path paraeters to custoi=e the startup%t1s.sh script.

2unning t%e 'I9 TM1 Ser(er in /ac"ground Mode

Aou can run the TM1 server in "ac/ground ode " adding the paraeter unningIn)ac/ground to

the t1s.cfg fi!e and setting the paraeter to T.



425 26-09-20


65/424

6.4.-.1. Modifying t%e startup,tm1s.s% ScriptModif the path paraeters to custoi=e the startup%t1s.sh script.

)rocedure

Open the fi!e in a te#t editor.1.

*et the tm1_pathparaeter to the director containing the t1s.e#e server e#ecuta"!e fi!e. In ost

circustances@ this director is install_dir/bin.

2.

*et the tm1_data_pathparaeter to our server data director.$.

*et the TM1_PATHparaeter to director containing the t1s.e#e server e#ecuta"!e fi!e. In ost

circustances@ this director is install_dir/bin.

'ote*Aou ust set "oth tm1_pathand TM1_PATHto the sae director.

.

*ave the script.

+or e#ap!e>

> ./startup_tm1s.sh /software/AutoInstall/TM1/samples/tm1/SData

Aou can save to a new fi!e nae if desired. If ou have insta!!ed u!tip!e TM1F servers@ ou shou!d

create server7specific scripts with uniBue fi!e naes for each server.

3.

un .Hstartup%t1s.sh or the new fi!e nae to start our TM1 server.8.

+ample

Note that if ou use an a"so!ute path to start the server@ ou ust use an a"so!ute path to stop it.

*ii!ar!@ if ou use a re!ative path to start the server@ ou ust use a re!ative path to stop it. +or

e#ap!e@ if ou use>

> ./startup_tm1s.sh "../samples/tm1/SData"

then the shutdown script ust a!so use the sae re!ative path>

> ./shutdown_tm1s.sh "../samples/tm1/SData"

Aou cannot i# and atch the path description ethods "etween startup and shutdown of the sae

data"ase.

)arent topic**tarting a -NI5 TM1 *erver


425 26-09-20


66/424

6.4.-.#. 2unning t%e 'I9 TM1 Ser(er in /ac"ground ModeAou can run the TM1F server in "ac/ground ode " adding the paraeter unningIn)ac/ground to the

t1s.cfg fi!e and setting the paraeter to T.

RunningInBackground=T

Aou ust anua!! add the unningIn)ac/ground paraeter to T1s.cfg. This paraeter is not part of

the standard t1s.cfg fi!e created when ou insta!! the TM1 server. +or detai!s a"out server configuration

paraeters@ see the IBM. Cognos. TM1 Installation and Configuration Guide.

When ou run the TM1 server in "ac/ground ode@ ou ust use shutdown%t1s.sh to shut down the

server. *ee *hutting (own a -NI5 TM1 *erver unning in )ac/ground Mode.

)arent topic**tarting a -NI5 TM1 *erver


425 26-09-20


67/424

6.6. Connecting to a 2emote Ser(erTo connect to a reote TM1F server@ a c!ient ust point to an ,din ost on which an ,din *erver is

running. The ,din *erver aintains inforation a"out reote TM1 servers avai!a"!e on the networ/@

inc!uding nae@ protoco!@ address@ and port nu"er. The ,din ost used " the c!ient is specified in the

T1p.ini fi!e.

)rocedure

,ccess *erver #p!orer.1.

(ou"!e7c!ic/ the icon for the server to which ou want to connect.

The *erver 6ogin dia!og "o# opens.

2.

nter the correct user nae and password@ and c!ic/ O;.

If the connection to the server is successfu!@ TM1 disp!as the Cu"es@ (iensions@ ep!ications@

&rocesses@ and Chores icons for that server. The ep!ications icon disp!as on! if ou !ogged in as a

e"er of the ,(MIN group.

'ote*The TM1 reote server coes with a predefined adinistrator I( of ,(MIN@ and a password of

app!e.

$.

2efres%ing t%e :ist of 2emote Ser(ers

If ou do not see the reote server to which ou want to connect in the !ist of avai!a"!e servers@ ou

can refresh this !ist.

2e!Setting t%e Admin 3ost

Aou can set or change the ,din ost.

2e!Setting :ocal Ser(er Options

The fo!!owing ta"!e descri"es the 6oca! *erver options that ou can change through the TM1 Options

dia!og "o#.



425 26-09-20


68/424

6.6.1. 2efres%ing t%e :ist of 2emote Ser(ersIf ou do not see the reote server to which ou want to connect in the !ist of avai!a"!e servers@ ou can

refresh this !ist.

)rocedure

C!ic/ File@ 2efres% A(ailable Ser(ers. TM1F disp!as a!! running servers that are registered on the

,din ost to which the c!ient is pointing.

)arent topic*Connecting to a eote *erver


425 26-09-20


69/424

6.6.#. 2e!Setting t%e Admin 3ostAou can set or change the ,din ost.

)rocedure

+ro *erver #p!orer@ c!ic/ File@Options.

The TM1F Options dia!og "o# opens.

1.

nter the nae of the ,din ost in the ,din ost fie!d. Aou can concatenate two or ore hosts "

separating the host naes with a seico!on.

Aou can a!so c!ic/ the drop7down enu to se!ect fro previous! accessed ,din osts.

2.

C!ic/ O;.

When ou change the ,din ost@ TM1 disconnects ou fro the reote servers to which ou are

connected and restarts our TM1 c!ient. If a !oca! server is running@ that server is shut down and

restarted.

$.



425 26-09-20


70/424

6.6.-. 2e!Setting :ocal Ser(er OptionsThe fo!!owing ta"!e descri"es the 6oca! *erver options that ou can change through the TM1F Options

dia!og "o#.

:ocal Ser(er Option escription

(ata (irector (irector for the !oca! server data fi!es.

Connect to 6oca!

*erver on *tartup

*e!ect or c!ear the Connect to 6oca! *erver on *tartup chec/ "o# to contro!

whether the TM1 c!ient autoatica!! connects to the !oca! server at startup.



425 26-09-20


71/424

6.>. isconnecting from a 2emote Ser(erAou can disconnect fro a reote server.

)rocedure

In *erver #p!orer@ se!ect the icon for the server fro which ou want to disconnect.1.

C!ic/ Ser(er@ :og Out.2.



425 26-09-20


72/424

6.?. S%utting on a $indos TM1 Ser(erAou can shut down a reote server that has "een set up to run as a Windows app!ication.

)rocedure

C!ic/ the Close"utton in the server window.

S%utting on a $indos TM1 Ser(er 2unning as a Ser(ice

Aou can shut down a reote server that has "een insta!!ed as a Microsoft Windows service.



425 26-09-20


73/424

6.?.1. S%utting on a $indos TM1 Ser(er 2unning as a Ser(iceAou can shut down a reote server that has "een insta!!ed as a Microsoft Windows service.

)rocedure

Open the Microsoft Windows *ervices anager.

, !ist of services opens.

1.

ight7c!ic/ the TM1F Ser(erand se!ect Stop.

+or detai!s and additiona! steps on shutting down a server fro a reote !ocation when !ogged in as

the TM1 ,(MIN user@ see Managing C!ient Connections.

2.

2esults

The TM1 server running as a Windows service autoatica!! shuts down during sste shutdown. In

soe instances@ a server running a !arge or cop!e# ode!@ ight not proper! shut down during sste

shutdown@ power fai!ure@ or anua! service shutdown. ,n iproper shutdown is defined as a shutdown in

which the TM1 server is suari! terinated "efore it has cop!eted a!! shutdown procedures. This can

happen during nora! sste shutdown "ecause Windows a!!ots a !iited tie ap

04.TM1 Operation Guide 10.1.1

Documents

Transcript of 04.TM1 Operation Guide 10.1.1