Date post: | 02-Jun-2018 |
Category: |
Documents |
Upload: | gabrielauctus |
View: | 229 times |
Download: | 0 times |
of 425
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
8/10/2019 04.TM1 Operation Guide 10.1.1
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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!
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
25 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
25 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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/10/2019 04.TM1 Operation Guide 10.1.1
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#.
8/10/2019 04.TM1 Operation Guide 10.1.1
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#.
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
14/424
#.#.#. tm1+ferThe t1#fer uti!it copresses and oves I)MF CognosF TM1F server o"
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Cognos TM1 Installation and Configuration Guide.
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*TM1 *ste and +eature Configuration
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
)arent topic*Capa"i!it ,ssignents
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*Capa"i!it ,ssignents
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Cognos TM1 Installation and Configuration Guide.
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.
)arent topic*TM1 *ste and +eature Configuration
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*-sing &ersistent +eeders
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*-sing &ersistent +eeders
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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".
)arent topic*TM1 *ste and +eature Configuration
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*Configuring and Managing *and"o#es in our TM1 nvironent
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*Configuring and Managing *and"o#es in our TM1 nvironent
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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"
8/10/2019 04.TM1 Operation Guide 10.1.1
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>
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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/.
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*Cognos TM1 ,din *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*Cognos TM1 ,din *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Cognos TM1 Installation and Configuration Guide.
Specifying Multiple Admin 3osts
Aou can set a TM1 c!ient to reference u!tip!e ,din osts " separating host naes with
seico!ons.
)arent topic*Cognos TM1 ,din *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
:.
)arent topic*eote Cognos TM1 *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*eote Cognos TM1 *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*eote Cognos TM1 *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic**tarting a eote TM1 *erver
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic**tarting a eote TM1 *erver
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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#.
)arent topic*eote Cognos TM1 *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
$.
)arent topic*Connecting to a eote *erver
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*Connecting to a eote *erver
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*eote Cognos TM1 *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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.
)arent topic*eote Cognos TM1 *erver Operations
Operation Guide 10.1.1 http://pic.dhe.ibm.com/infocenter/ctm1/v10r1m0/advanced/print.j
425 26-09-20
8/10/2019 04.TM1 Operation Guide 10.1.1
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