多维ibm服务器系统安装

IBMPlanningAnalyticsV2R0TM1OperationsIBM注意在使用本资料及其支持的产品之前,请阅读第135页的『声明』中的信息.
产品信息本文档适用于IBMPlanningAnalyticsV2.
0,并且还可能适用于后续发行版.
LicensedMaterials-PropertyofIBM上次更新时间:2019-11-11CopyrightInternationalBusinessMachinesCorporation2007,2019.
目录简介.
ix第1章TM1系统和功能配置.
1多线程查询.
2功能分配.
2设置功能.
4功能分配中分配的交互.
4TM1ApplicationWeb功能.
5持久数据加载程序.
5使用持久数据加载程序保存数据.
5使用数据加载程序修改多维数据集的规则.
5处理已破坏或者已失效的数据加载程序文件.
6沙箱和个人工作区.
6沙箱和个人工作区的内存消耗.
6管理沙箱的文件和文件夹.
6沙箱的TM1Server配置参数.
6了解不同TM1客户端之间的沙箱差异.
7了解个人工作区中的重新计算和落实.
7第2章TM1AdminServer操作.
9在Windows上运行TM1AdminServer.
10将TM1AdminServer作为Windows上的应用程序运行.
10在UNIX上运行TM1AdminServer.
11指定管理主机的位置.
11第3章远程TM1Server操作.
13设置远程TM1Server以作为应用程序运行.
13启动设置为Windows应用程序的TM1Server.
14关闭设置为Windows应用程序的TM1Server.
14设置TM1Server以作为Windows服务运行.
14启动作为Windows服务安装的TM1Server.
15将服务设置为自动启动.
15移除作为Windows服务运行的TM1Server.
15关闭作为Windows服务运行的TM1Server.
16启动UNIXTM1Server.
16修改startup_tm1s.
sh脚本.
16在后台方式下运行UNIXTM1Server.
17关闭UNIXTM1Server.
17关闭在后台方式下运行的UNIXTM1Server.
17连接到远程服务器.
18刷新远程服务器列表.
18重置管理主机.
18重置本地服务器选项.
18从远程服务器断开连接.
19记录事务.
19监视服务器性能.
19管理客户端连接.
19向客户端广播消息.
19从服务器断开客户端的连接.
20远程关闭服务器.
20iii远程服务器内存管理.
20关于星门视图.
21在批量加载模式下使用TM1.
21使用批量加载模式的注意事项.
21启动批量加载模式.
22结束批量加载模式.
22TM1CAPI.
22TurboIntegrator进程命令.
22第4章PlanningAnalytics安全性概述.
23认证概述.
23TM1对象安全性.
23第5章管理用户和组.
25用户和组安全性概述.
25实施TM1安全方案.
25用户和组安全性示例.
25管理组和权限.
26管理组.
26安全管理组.
27数据管理组.
27操作管理组.
28添加和删除用户和组.
30添加用户.
30添加组.
30删除用户.
30删除组.
31将用户分配到组.
31多个组中的成员资格.
31保护TM1数据.
31限制对数据目录的访问.
31分配密码.
31保护密码.
32设置和清除密码.
32设置密码.
32清除密码.
32更改密码.
32设置用户的到期时间.
33第6章系统和性能监视.
35PlanningAnalytics和TM1日志.
35日志记录属性文件.
35TM1AdminServer日志.
39事务日志.
41消息日志.
44审核日志.
46ops记录器.
51TM1Top日志.
52TM1.
Mdx.
Interface记录器.
54搜索大型事务日志.
54控件多维数据集.
54启用性能监视.
55禁用性能监视.
55查看客户端、多维数据集和服务器的性能统计信息.
55TM1性能计数器.
55可用的TM1性能计数器.
56使用TM1PerfMon实用程序查看TM1性能计数器.
56iv使用MicrosoftWindows性能监视器查看性能计数器.
57第7章IBMPlanningAnalytics工具和实用程序.
59使用IBMCognosTM1OperationsConsole.
59IBMCognosTM1OperationsConsole工作流.
60配置CognosTM1OperationsConsole.
60启动并登录CognosTM1OperationsConsole.
61设置CognosTM1OperationsConsole.
61在CognosTM1OperationsConsole中监视.
63IBMCognosTM1OperationsConsole中的日志文件.
67使用看守程序来监视服务器活动.
72IBMCognosPerformanceManagementHub.
73打开PerformanceManagementHubWeb页面.
74配置日志记录.
74使用TM1Top实用程序.
75在TM1Top中显示用户名.
75配置Tm1top.
ini文件.
75运行TM1Top.
76查看和了解TM1Top显示.
77TM1Top命令.
81取消线程处理.
81其他调试工具.
82安装和运行ADPlus.
82运行Dr.
Watson.
85tm1xfer.
86在TM1Server崩溃后收集文件以用于分析.
91客户端日志.
91odbc_test工具.
92第8章了解多维数据集依赖关系.
95依赖关系映射更改.
95清除多维数据集依赖关系.
96创建多维数据集依赖关系.
96使用AddCubeDependency来建立依赖关系.
97调试和标识多维数据集依赖关系.
97第9章复制多维数据集.
99复制创建的关系.
100所需的访问权限.
102设置复制.
102配置tm1s.
cfg文件以支持复制.
102复制进程.
103复制多维数据集.
103指定有关复制的多维数据集的信息.
104TM1复制多维数据集时将出现的情况.
105同步进程.
105按需同步.
106安排同步.
106在不稳定的网络连接或广域网连接上进行同步.
106维护复制连接.
107创建复制连接.
107修改复制连接.
107删除复制连接.
107附录A辅助功能.
109键盘快捷键.
109IBM及辅助功能.
110v附录B控件多维数据集.
111安全性控件多维数据集.
111}CellSecurity_CubeName.
111}ChoreSecurity.
111}ClientSecurity.
112}CubeSecurity.
112}DimensionSecurity.
113}ElementSecurity_DimensionName.
113}ProcessSecurity.
114客户端和组管理控件多维数据集.
114}ClientsGroups.
114}ClientProperties.
115对象属性和特性控件多维数据集.
115}ConnectionProperties.
115}CubeProperties.
116}DimensionProperties.
116}DimensionAttributes.
117}ElementAttributes_DimensionName.
117}HierarchyProperties.
117性能监视控件多维数据集.
118}StatsByClient.
118}StatsByCube.
119}StatsByCubeByClient.
120}StatsByRule.
120}StatsForServer.
121其他控件多维数据集.
121}Hold_UserName_CubeName.
121附录C控制维度.
123}Chores.
123}ClientProperties.
123}Clients.
123}ConnectionProperties.
123}Connections.
124}CubeFunctions.
124}CubeProperties.
124}Cubes.
126}DimensionAttributes.
126}DimensionProperties.
126}Dimensions.
127}ElementAttributes_DimensionName.
127}Groups.
127}Hierarchies.
127}HierarchyProperties.
128}Hold.
128}LineNumber.
128}PerfClients.
128}PerfCubes.
129}Processes.
129}RuleStats.
129}StatsStatsByClient.
129}StatsStatsByCube.
130}StatsStatsByCubeByClient.
131}StatsStatsForServer.
131}Subsets_DimensionName.
131}TimeIntervals.
131vi}Views_CubeName.
132附录D由TM1处理的Excel事件.
133声明.
135viiviii简介本文档描述了IBMPlanningAnalytics体系结构、服务器操作、认证和组件安全性.
PlanningAnalytics集成了业务规划、绩效衡量和运作数据,这样,无论公司的地理位置或结构如何,都能对公司业务有效性和客户交互进行优化.
PlanningAnalytics提供了数据的直接可视性、协作过程中的责任和一致的信息视图,使管理者可以迅速平抑运营波动并利用新的机会.
查找信息要在Web上查找文档(包括所有已翻译的文档),请访问IBMKnowledgeCenter(http://www.
ibm.
com/support/knowledgecenter).
关于样本的免责声明SampleOutdoorsCompany、GreatOutdoorsCompany、GOSales、SampleOutdoors或GreatOutdoors名称的任何变体以及PlanningSample,均是虚构的业务运营,其中包含用于为IBM和IBM客户开发样本应用程序的样本数据.
这些虚拟记录包括销售事务、产品发布、财务和人力资源的样本数据.
如与实际名称、地址、联系电话或交易价有任何相似之处,纯属巧合.
其他样本文件可能包含手动生成或机器生成的虚构数据、根据学术性来源或公共来源编写的事实数据或者经版权所有者允许而使用的数据,这些数据用作开发样本应用程序的样本数据.
引用的产品名称可能是其各自所有者的商标.
未经授权,不得复制.
辅助功能辅助功能可以帮助身有残疾(如行动有障碍或视力不佳)的用户使用信息技术产品.
PlanningAnalytics有一些支持辅助功能的组件.
有关更多信息,请参阅辅助功能.
前瞻性声明本文档描述本产品当前具备的功能.
可能包含对当前不可用项目的引用.
请勿推断暗示任何未来可用性.
任何这样的引用并不意味着承诺要提供任何材料、代码或功能,也不承担任何法律责任.
IBM自行决定功能或功能性的开发、发布和时间安排.
安全注意事项有关IBMPlanningAnalytics的安全注意事项,请参阅《PlanningAnalytics安装和配置》.
有关管理用户和组认证的信息可在《TM1操作》文档的『管理用户和组』一章找到.
CopyrightIBMCorp.
2007,2019ixxIBMPlanningAnalytics:TM1Operations第1章TM1系统和功能配置可以使用以下组件和功能来配置IBMTM1Server和客户端以获得最高性能.
配置描述Tm1s.
cfg文件这是一个配置文件,用于指定TM1Server的环境信息.
您可以编辑Tm1s.
cfg文件以反映相关联服务器的环境.
有关更多信息,请参阅《PlanningAnalyticsLocal安装和配置》文档.
Tm1p.
ini文件这是一个配置文件,用于指定TM1Client(TM1Perspectives、TM1Architect和TM1Client)的环境信息.
有关更多信息,请参阅《PlanningAnalyticsLocal安装和配置》文档.
多线程查询多线程查询可同时计算多个结果流以改进查询性能.
多线程查询允许IBMCognosTM1通过在单独的核心上运行各个查询,以自动均衡核心的应用程序负载.
此多线程处理可提高大型查询和规则的效率及减少处理时间.
有关更多信息,请参阅第2页的『多线程查询』.
功能分配这是管理员可以按用户组启用或禁用的一组功能.
可以使用这些功能分配来管理一些选项,例如,个人工作区回写方式、沙箱、数据保留以及对服务器资源管理器的访问权限.
有关更多信息,请参阅第2页的『功能分配』.
持久数据加载程序这是一个参数,可以使用数据加载程序(尤其是使用许多复杂计算的数据加载程序)来缩短多维数据集的重新装入时间,即,保存数据加载程序,然后在服务器启动时将它们重新装入,而不用重新计算这些数据加载程序.
有关更多信息,请参阅第5页的『持久数据加载程序』.
沙箱这是一个功能部件,使用户能够创建它们自己的数据区,从而独立于基础数据在这些数据区中工作.
管理员针对此功能部件执行的任务包括:了解此功能部件及其内存使用情况、启用必需的配置参数以及管理相关文件和文件夹.
有关更多信息,请参阅第6页的『沙箱和个人工作区』.
数据保留这是一项与服务器相关的功能,可用于为各个用户配置对多维数据集各个区域的互斥写访问权限.
保留了该区域中的数据时,就只有该特定用户才能修改该数据,直到释放了此保留为止.
管理员针对DR功能执行的任务包括:在}CubeProperties控件多维数据集和功能分配窗口中配置相关的属性.
要应用和管理"数据保留"功能,必须使用相关的TurboIntegrator函数和API函数,以通过编程方式获取、释放和管理数据保留.
有关更多信息,请参阅《TM1开发人员指南》中的"使用数据保留"和"启用数据保留"这两节.
CopyrightIBMCorp.
2007,20191多线程查询可以通过使查询拆分为多个处理线程来改进查询的处理性能.
多线程查询允许IBMTM1通过在单独的核心上执行各个查询,以自动均衡核心的应用程序负载.
此多线程处理可改进大型查询和规则的效率及减少处理时间.
示例查询1将运行并接收父线程和7个工作者线程(共8个).
查询2将运行.
完成工作者线程中的子任务后,查询2将返回到"已排队",并且现在会将其中4个线程分配给查询2,结果是查询1和查询2各有4个线程.
查询3将运行.
这些线程将再次对现行线程完成其子任务,然后重新分配给新查询.
这将导致查询1拆分为3个线程,查询2拆分为3个线程,并且查询3拆分为2个线程(共8个线程).
此过程会一直进行到所有线程都最终均匀划分.
如果查询1已完成,而查询2和查询3仍处于现行状态,那么分配给查询1的线程将分配给查询2和查询3,以便查询2和查询3都保持4个线程.
详细信息缺省情况下,已启用多线程查询.
线程数设置为服务器上可用的最大核心数.
结果是使用所有核心的动态系统设置.
您可以使用tm1s.
cfg文件中的以下参数调优配置:MTQ:设置每个TM1查询的最大线程数.
MTQ.
OperationProgressCheckSkipLoopSize:指定在检查是否需要多线程拆分之前所要处理的单元格数.
MTQ.
SingleCellConsolidation:禁止对单个单元格合并进行多线程查询处理.
有关这些参数的信息,请参阅《PlanningAnalyticsLocal安装和配置》中的"tm1s.
cfg文件中的参数".
只有在服务器以低于100%的容量运行时才能从多线程查询改进受益.
例如,如果您让8个核心处理8个并行查询,那么没有任何一个服务器会利用多线程查询.
添加第9个并行处理查询会导致将查询处理线程拆分到多个核心中.
多线程查询可以提高数字多维数据集的性能,在其中将优化合并.
由于TM1无法合并字符串值,因此多线程查询对字符串多维数据集的性能没有影响.
注:TM1Server多线程查询不再受限于64位CPU核心.
超出64个处理器的MicrosoftWindows平台可充分利用此功能及其性能优势.
Logging要对多线程查询启用日志,请在与tm1s.
cfg文件位置相同的tm1s-log.
properties文件中输入以下行:要捕获星门创建时间,请添加:log4j.
logger.
TM1.
Cube.
Stargate=DEBUG要捕获工作单元分割,请添加:log4j.
logger.
TM1.
Parallel=DEBUG要捕获操作线程选取工作单元的事件,请添加:log4j.
logger.
TM1.
OperationThread=DEBUG功能分配管理员可以使用服务器资源管理器>服务器菜单中的"功能分配"菜单,按用户组设置某些功能.
打开服务器资源管理器后,右键单击服务器,然后单击功能分配.
缺省情况下,所有分配都是空白的.
对于每一个功能,空白设置都具有不同的含义.
您注销TM1并重新登录后,对大多数分配所进行的更改将生效.
允许导出为文本功能是动态的,设置该功能后,无需重新启动TM1Server.
2IBMPlanningAnalytics:TM1Operations可以按用户组设置以下功能:访问服务器资源管理器使用此功能在默认情况下启动此用户组的服务器资源管理器.
您可以将此功能设置为"拒绝"以阻止此用户组使用服务器资源管理器.
缺省情况下,此功能设置为空白,其相当于允许.
要阻止访问服务器资源管理器,请单击用户组和此功能的交集并选择拒绝.
个人工作区回写方式此功能定义了此用户组中数据更改的处理方式.
授予此功能时,用户可以在手动决定何时将更改落实到基础数据之前,将数据更改保留在私有工作区.
还可进一步允许用户命名和管理多个名为沙箱(请参阅沙箱功能)的私有情况的能力.
当允许个人工作区回写方式时:用户在非直接回写情况下操作,以便他们可以在将数据值提供给社区其他用户使用之前,自行调整数据集.
允许个人工作区回写方式时使用的特殊沙箱便于尝试不同的数据更改,而不会有指定沙箱的复杂操作.
更改的数据用不同的颜色显示,以提醒用户该更改尚未应用到基础数据中.
一旦落实了个人工作区中的数据更改,单元格颜色恢复到黑色,以确定其为基础数据的一部分.
用户必须手动落实其数据更改,才能使其对其他用户可用.
如果用户不习惯使用沙箱,例如,如果他们习惯于TM1较早版本的经典直接回写方式,那么他们可能会发现很难记住要手动按"落实"按钮来落实其更改.
通常情况下,使用个人工作区方式比使用直接回写方式更高效,因为基础数据发生更改的频率比每个数据更改都必须应用到基础数据的频率要低.
当此功能设置为拒绝时,用户没有"个人工作区回写",所以他们直接对基础数据进行工作.
这是此功能的缺省行为.
该功能设置的优点是快速实现数据更改,但许多用户希望在何时落实更改和何时使更改供其他用户可用等方面有灵活的控制权.
缺省情况下,不允许用户组拥有"个人工作区回写方式"功能.
该功能缺省为空白,相当于拒绝.
要使用户组可使用个人工作区,单击用户组与此功能的交集,并选择允许.
另请注意,用户组可能会拒绝"个人工作区回写方式"功能,但是仍然会使用"沙箱"功能.
在那种情况下,用户直接在基础数据中工作,但是可以选择将更改保存到命名沙箱.
当他们创建命名沙箱时,"落实"和"重置数据"按钮变为可用.
如果他们移回到"基础数据",那么返回到直接回写方式.
有关个人工作区回写方式和沙箱功能的可能的选项组合,请参阅第4页的『设置功能』.
如果在服务器配置文件中使用DisableSandboxing=T关闭系统范围内拥有沙箱的能力,那么会忽略"个人工作区回写方式"和"沙箱"功能.
缺省情况下,DisableSandboxing不存在或者设置为F.
沙箱此功能使用户组可以创建可用于构建假设情况场景的命名沙箱.
允许该功能时,用户可创建和指定多个数据更改集合,将在基础数据顶部覆盖这些更改.
用户可以将其沙箱作为私有沙箱,并决定落实数据更改使其变为公共沙箱的时间.
沙箱是一项强大的功能,但一些用户会觉得针对常规基础数据管理多种情况很复杂,难以应对.
缺省情况下,所有用户都具有此功能.
空白设置相当于允许.
要防止该用户组使用指定沙箱,将此功能设置为拒绝.
如果在服务器配置文件中使用DisableSandboxing配置参数关闭拥有沙箱的能力,那么会忽略"个人工作区回写方式"和"沙箱"功能.
缺省情况下,此参数不存在或者设为F.
DisableSandboxing在《PlanningAnalyticsLocal安装和配置》文档中进行了描述.
数据保留功能数据保留(DR)是一项与服务器相关的功能,允许您为各个用户配置对于多维数据集的各个区域的互斥写访问权限.
一旦保留了某个区域中的数据,就只有对该区域具有独占写入访问权限的特定用户才能修改其中的数据,直到释放了此保留为止.
DR使用ManageDataReservation和DataReservationOverride功能使用户组的成员能够获取、释放和覆盖他们自己和其他用户的DR.
有关详细信息,请参阅《TM1开发人员指南》文档中的"使用数据保留"和"使用户组能够管理数据保留"这两节.
第1章TM1系统和功能配置3合并输入传播"合并输入传播"允许或拒绝执行数据传播的功能,方法是直接在基于TM1Web的客户机(包括TM1Web和TM1ApplicationWeb)的合并单元格中进行输入.
如果将此功能设置为"拒绝",那么将阻止用户在合并单元格中输入来启动数据分布.
然而,将"合并输入分布"设置为拒绝时,用户仍可以使用右键单击菜单对合并单元格执行数据分布.
注:此功能不适用于ArchitectorPerspectives中的CubeViewer,因为在这些客户机中不允许直接在合并单元格中输入.
针对ADMIN用户组,此功能不能设置为拒绝.
空白设置相当于允许.
允许传播"允许传播"允许或拒绝访问任何TM1Client中的所有数据传播功能.
空白设置相当于允许.
允许导出为文本"允许导出为文本"允许或拒绝将多维数据集或视图数据导出为文本的功能.
导出大量多维数据集或视图会消耗大量资源,因此您可能想要拒绝某些用户组使用此功能.
当此功能设置为拒绝时,用户组的成员将无法将数据导出为文本,并会强制实施以下限制:当用户右键单击服务器资源管理器中的多维数据集或视图时,导出为文本数据选项会禁用.
尝试执行包含ASCIIOutput或TextOutput函数的TurboIntegrator进程会导致进程因权限错误而退出.
进程消息日志指示"Executionwasaborted.
NosecurityaccessforASCIIOutput"或"Executionwasaborted.
NosecurityaccessforTextOutput".
当此功能设置为允许时,用户组的成员可将数据导出为文本.
空白设置相当于允许.
设置功能可以使用"允许"或"拒绝"设置的组合将回写方式确定为个人工作区回写方式和沙箱功能.
要使用户组个人工作区回写方式沙箱在基础数据中直接操作,并具有创建多个沙箱的能力.
这是缺省情况.
拒绝允许使用单个私有工作区域,无需指定沙箱.
允许拒绝使用"缺省"私有工作区域和指定沙箱.
允许允许使用直接回写,无需沙箱.
这是经典TM1方式.
该设置与添加DisableSandboxing=T到配置文件类似,阻止使用沙箱,并使所有用户处于直接回写方式下.
拒绝拒绝功能分配中分配的交互缺省情况下,所有功能分配都被设置为空白,这意味着"拒绝"或"允许",这取决于每个功能的缺省设置.
例如,"个人工作区回写方式功能"中的"空白"意味着"拒绝".
沙箱功能中的空白意味着"允许".
当一个用户是多个组的成员时,空白设置允许基于任何明确设置的分配来解决可能出现的冲突.
当一个用户是多个用户组的成员时,任何明确设置的"允许"或"拒绝"覆盖空白.
如果明确设置分配时发生冲突,"拒绝"功能覆盖"允许".
4IBMPlanningAnalytics:TM1OperationsTM1ApplicationWeb功能TM1ApplicationWeb会忽略回写方式和沙箱功能.
在TM1ApplicationWeb中,功能由应用程序设置.
与特定应用程序关联的所有用户按照为该应用程序设置的方式操作.
如果您正在使用多个沙箱,那么必须从TM1ApplicationWeb提交,而不能从"工作流"页面提交.
持久数据加载程序要使用数据加载程序来缩短多维数据集的重新装入时间,请将PersistentFeeders配置参数设置为true(T),以将已计算的数据加载程序存储到.
feeders文件中.
对于其服务器装入时间超过5分钟的任何安装,使用此参数可以提高其性能.
当此参数设置为T并且服务器遇到持久数据加载程序文件时,它就会装入已保存的数据加载程序,从而缩短了重新计算这些数据加载程序通常所花的时间.
数据加载程序是在保存数据或者编辑规则时保存的.
您未显式保存数据加载程序.
对于具有许多复杂的数据加载程序计算的安装,持久保存数据加载程序,然后在服务器启动时将它们重新装入,这样做将提高性能.
对于简单的数据加载程序,从磁盘中读取数据加载程序所花的时间可能会超过重新计算数据加载程序所花的时间,但是大多数安装将获益.
使用"持久数据加载程序"功能部件只会增大磁盘上的系统大小.
使用此参数并不会影响内存大小.
有关更多信息,另请参阅《TM1参考指南》中的CubeSaveDataTurboIntegrator函数.
使用持久数据加载程序保存数据当PersistentFeeders=T并且保存了使用规则的多维数据集之后,数据加载程序将与多维数据集数据一起存储在.
feeders文件中.
多维数据集文件称为cube-name.
cub和cube-name.
feeders.
装入多维数据集之后,如果存在.
feeders文件,那么将读取此文件以重新装入数据加载程序,并且会忽略对数据加载程序进行正常评估.
如果不存在数据加载程序文件,那么将进行正常的数据加载程序计算,在计算了所有数据加载程序之后,会写入.
feeders文件.
这将是在PersistentFeeders=T的情况下,在数据目录中首次启动TM1server时的行为.
在服务器启动过程中,将写入所有相关多维数据集的.
feeders文件.
对于在服务器启动时找不到其持久数据加载程序的任何多维数据集,将写入新的持久数据加载程序文件.
这就意味着可能会从数据目录中删除.
feeders文件,从而强制在服务器下一次启动时完全重新计算数据加载程序.
在TI进程中,使用TI函数DeleteAllPersistentFeeders()来删除所有持久数据加载程序.
在装入时,会将.
feeders文件的修改时间与基础多维数据集文件的修改时间进行比较.
如果多维数据集文件比.
feeders文件更新,那么会认为.
feeders文件无效并将其删除.
由于始终是在写入多维数据集文件之后才写入.
feeders文件,因此,.
feeders文件始终应当比多维数据集文件更新.
使用数据加载程序修改多维数据集的规则修改多维数据集的规则之后,会重新运行与该多维数据集相关联的规则的数据加载程序,以使对规则文件中的数据加载程序语句所作的任何更改生效.
TM1Server决不会从内存中删除数据加载程序本身,因此,进行此重新计算将只添加新的数据加载程序,而不会删除由于编辑规则文件而可能变得不再有效的数据加载程序.
重新计算数据加载程序之后,会重写编辑了其规则的多维数据集的持久数据加载程序文件以及所有依赖多维数据集(这是由于规则中的DB(…)语句而导致).
因为决不会从内存中删除数据加载程序,所以这意味着编辑规则文件可能会设置某些不再有效(未真正应用规则)的数据加载程序.
这些未使用的数据加载程序将与持久数据加载程序一起保存.
由于可能存在未使用的数据加载程序,因此管理员可能希望定期(在对服务器有很少需求的某些时间段)重新计算所有数据加载程序.
这是通过调用TurboIntegrator函数DeleteAllPersistentFeeders(),关闭服务器,然后重新启动服务器来完成的.
重新启动服务器之后,因为没有持久数据加载程序信息,所以将重新计算所有数据加载程序,并且会将新的持久数据加载程序信息写入磁盘.
请参阅《TM1参考指南》文档中的『TurboIntegrator函数』一章.
第1章TM1系统和功能配置5处理已破坏或者已失效的数据加载程序文件如果检测到已破坏或者无效的数据加载程序文件,那么将删除所有已保存的数据加载程序,并且服务器将退出并在日志文件中提供适当的消息.
在这种情况下,您必须重新启动服务器以重新装入和重新计算所有数据加载程序.
日志中的消息将采用以下格式:27660ERROR2010-05-1419:10:26.
455Cognos.
Server将删除所有持久数据加载程序文件,服务器将关闭27660ERROR2010-05-1419:10:26.
455TM1.
Server重新启动服务器以重新装入数据库.
在下列情况下会认为数据加载程序文件"无效":数据加载程序文件中有格式错误;数据加载程序文件的日期/时间早于相应的多维数据集文件(.
CUB),如果用户尝试将数据加载程序文件或多维数据集文件从一个数据目录手动复制到另一个数据目录,就会发生这种情况.
当认为数据加载程序文件无效时,会将一条消息写入系统日志文件,用于说明认为此数据加载程序文件无效的确切原因.
此消息采用以下格式:ERROR2010-05-1419:00:22.
987TM1.
Server检测到多维数据集"xxxx"的无效数据加载程序文件原因:.
.
.
(在采用多线程装入的情况下,或者在启动过程中提早装入的多维数据集发生错误的情况下)此消息通常并不靠近文件末尾,而是位于装入序列的中部.
在消息日志中搜索"ERROR"将显示错误.
沙箱和个人工作区作为TM1管理员,当您在TM1环境中使用沙箱和个人工作区时,应该了解一些技术项目.
沙箱和个人工作区的内存消耗管理支持沙箱和个人工作区的文件和文件夹沙箱和个人工作区的TM1Server配置参数使用沙箱功能,您可以创建独立于基础数据的个人工作区或沙箱.
沙箱不是基础数据的副本,而是您在基础数据顶部输入的个人数据值的独立覆盖或独立层.
直到明确向基础数据落实沙箱中更改的值为止,才会将在沙箱或个人工作区中输入的新数据值保存到基础数据中.
此行为不同于直接在基础数据中工作,在基础数据中,输入的任何新数据值都将直接回写到TM1Server中.
沙箱和个人工作区的内存消耗如果正在使用沙箱功能,应该意识到沙箱需要使用一些额外的RAM内存和硬盘空间.
当用户接近其沙箱内存限制时,会显示错误消息.
可以通过调整TM1Server配置文件tm1s.
cfg中的MaximumUserSandboxSize参数来控制每个用户的沙箱所使用的内存量.
管理沙箱的文件和文件夹每个TM1Server都将沙箱的支持文件存储在TM1Server数据目录的子文件夹中.
如果正在备份此类数据,可能要考虑这些文件及备份和恢复沙箱文件的含义.
管理员可使用各种条件删除沙箱.
有关更多信息,请参阅《PlanningAnalytics安装和配置》文档中的ServerSandboxesDelete配置参数.
沙箱的TM1Server配置参数TM1Server配置文件tm1s.
cfg使用参数来启用和管理沙箱功能.
DisableSandboxing参数指定用户是否能够在服务器上使用沙箱.
MaximumUserSandboxSize参数用于设置针对个人工作区或沙箱要分配到每位用户的最大RAM内存量(以MB为单位).
"个人工作区"或"沙箱"的使用由服务器资源管理器>服务器菜单中可用的功能分配选项控制.
6IBMPlanningAnalytics:TM1Operations了解不同TM1客户端之间的沙箱差异与TM1Perspectives、服务器资源管理器和TM1Web的旧客户端相比,沙箱功能在CognosTM1ApplicationWeb中的工作方式略有不同.
该信息针对使用这些客户端组合的用户或管理员.
缺省沙箱和基础数据无论其他配置设置如何,在CognosTM1ApplicationWeb客户端中,缺省沙箱名为default.
此选项的操作与其他客户端中"沙箱"功能的操作相同.
不能在CognosTM1ApplicationWeb客户端中开启个人工作区.
CognosTM1ApplicationWeb也不允许直接回写,因此您在使用CognosTM1ApplicationWeb时无法直接处理基础数据.
CognosTM1ApplicationWeb用户只能在执行TM1ApplicationWeb工作流过程时将其沙箱数据提交至基础数据.
不同TM1客户端中沙箱的可视性按照设计,CognosTM1ApplicationWeb不显示在TM1Perspectives、服务器资源管理器或TM1Web中创建的任何沙箱.
例如,在TM1Web中创建的沙箱不会显示在CognosTM1ApplicationWeb客户端的沙箱下拉列表中.
了解个人工作区中的重新计算和落实下表显示了在"个人工作区"中排队和不排队进行"落实"和"重新计算"的不同效果.
回写操作发送数据直接读取-->重新计算写入-->重新计算从"基础TM1模型".
到"基础TM1模型".
个人工作区读取-->重新计算写入-->重新计算从"基础TM1模型".
到个人工作区.
个人工作区落实将个人工作区数据发送到"基础TM1模型".
排队的个人工作区落实将"个人工作区"发送到队列当所有资源都可用时,会处理"个人工作区"数据并将其发送到"基础TM1模型".
第1章TM1系统和功能配置78IBMPlanningAnalytics:TM1Operations第2章TM1AdminServer操作本节提供了IBMTM1AdminServer的概述并描述了在Windows和UNIX系统上运行AdminServer的典型管理员任务.
TM1AdminServer是一种进程,可以跟踪网络上运行的所有TM1Server.
AdminServer在称为管理主机的计算机上运行.
TM1Server启动时,该服务器会向指定管理主机上运行的AdminServer进行自我注册.
TM1Client将参考AdminServer来确定网络上可用的TM1Server.
下图显示了客户端和服务器使用AdminServer的方式.
TM1ClientTM1AdminServerTM1ServerTM1ServerAdminServer会维护每台可用TM1Server的以下信息:服务器名称IP地址协议端口号TM1Server在AdminServer上进行自我注册之后,会提供所有这些信息.
必须先运行AdminServer,然后才能启动TM1Server.
如果已在Tm1s.
cfg文件或服务器命令行中指定了管理主机,那么TM1Server将尝试与该主机上的AdminServer连接.
不管由于何种原因,如果TM1Server无法与AdminServer连接,那么它将无法启动.
如果尚未指定管理主机,那么TM1Server会尝试连接到本地机器上的AdminServer.
如果本地机器上当前未运行AdminServer,那么TM1Server会启动一个新的AdminServer并与其连接.
AdminServer通过侦听服务器发出的通知来识别网络中的TM1Server.
通常,TM1Server会按固定时间间隔(称为"脉动信号间隔",缺省为60秒)发送存在通知.
当AdminServer检测到TM1Server时,该服务器会变为已注册状态,并可用于网络上的客户端.
然而,如果在等于脉动信号间隔三倍的一段时间内,AdminServer未检测到存在已注册的TM1Server,那么该TM1Server会从网络上可用的服务器的列表中移除.
因此,该TM1Server将不可用于网络中的客户端.
缺省情况下,AdminServer使用端口5495.
如果端口5495已在使用,那么可以通过创建名为Tm1admsrv的新服务来分配新的端口号.
所有TM1应用程序都会查找名为Tm1admsrv的命名服务,如果该服务存在,那么应用程序会使用为该服务分配的端口号.
如果该服务不存在,那么TM1应用程序会使用端口5495.
CopyrightIBMCorp.
2007,20199在Windows上运行TM1AdminServer在MicrosoftWindows系统上安装IBMTM1AdminServer之后,可以通过手动方式或通过使用CognosConfiguration实用程序来管理该服务器.
还可在启动时运行特定TurboIntegrator进程.
有关更多信息,请参阅TM1TurboIntegrator文档中的『杂项』一章.
在Windows上手动启动TM1AdminServer在MicrosoftWindows上,可以手动将TM1AdminServer作为服务或应用程序运行.
使用install_dir\bin目录中的Tm1admsd.
exe文件来将AdminServer作为Windows服务运行.
要将TM1AdminServer作为Windows服务添加,请从install_dir\bin目录通过命令提示符运行以下命令:Tm1admsd-install要移除TM1AdminServerWindows服务,请从install_dir\bin目录通过命令提示符运行以下命令:Tm1admsd-remove使用Tm1admsrv.
exe文件将AdminServer作为Windows应用程序运行.
有关详细信息,请参阅第10页的『将TM1AdminServer作为Windows上的应用程序运行』.
使用CognosConfiguration在Windows上管理TM1AdminServer有关在MicrosoftWindows操作系统上使用CognosConfiguration实用程序来管理TM1AdminServer的详细信息,请参阅《PlanningAnalyticsLocal安装和配置》.
将TM1AdminServer作为Windows上的应用程序运行要将AdminServer作为应用程序运行,请使用Tm1admsrv.
exe可执行文件.
安装IBMPlanningAnalytics时,此文件被放置在install_dir\bin目录中.
您可以通过双击tm1admsrv.
exe文件来运行AdminServer,但是我们建议您在管理主机的启动目录中创建可执行文件的快捷方式.
这样,无论何时启动管理主机,都会启动AdminServer.
过程1.
单击Windows任务栏上的启动按钮.
2.
依次选择设置和任务栏3.
单击开始菜单程序选项卡.
4.
单击添加.
将打开创建快捷方式对话框.
5.
在命令行字段中输入到Tm1admsrv.
exe的完整路径,或者单击浏览浏览至该文件.
6.
必要时,可以指定命令行参数以设置AdminServer的脉动信号间隔.
参数-h设置已向AdminServer注册的TM1Server的脉动信号间隔(以秒为单位).
缺省的脉动信号间隔为60秒.
7.
单击下一步.
将打开SelectProgramFolder(选择程序文件夹)对话框.
8.
选择启动.
9.
单击下一步.
10IBMPlanningAnalytics:TM1Operations选择标题对话框随即打开.
10.
键入快捷方式的名称并单击完成.
查看AdminServer状态当AdminServer作为应用程序在管理主机上运行时,Windows系统托盘中会附加一个图标.
要查看AdminServer的当前状态,请双击该图标.
IBMTM1AdminServer窗口将显示以下信息:AdminServer的启动时间在哪台计算机上运行所用的端口当前向AdminServer注册的每台TM1Server的详细信息要关闭作为应用程序运行的AdminServer,请单击停止AdminServer.
您无法查看作为Windows服务运行的AdminServer的状态.
在UNIX上运行TM1AdminServer在UNIX系统上安装TM1AdminServer之后,可以通过手动方式或通过使用IBMCognosConfiguration实用程序来启动、停止和管理AdminServer.
在UNIX上手动启动TM1AdminServer要在UNIX系统上手动运行TM1AdminServer,请从install_dir/bin目录运行tm1admsrv.
exe文件.
使用CognosConfiguration在UNIX上管理TM1AdminServer有关使用IBMCognosConfiguration实用程序来管理UNIX系统上的TM1AdminServer的详细信息,请参阅《PlanningAnalytics安装和配置》.
查看AdminServer状态报表要查看AdminServer状态报表,请运行install_dir/bin目录中的tm1admstat.
exe.
AdminServer报表包含以下信息:AdminServer的启动时间在哪台计算机上运行所用的端口当前向AdminServer注册的每台TM1Server的详细信息指定管理主机的位置可以为客户端(用户接口)和远程服务器指定不同的管理主机位置.
指定客户端的管理主机要指定客户端所引用的"管理主机",请编辑Tm1p.
ini客户端配置文件中的AdminHost参数.
可以使用服务器资源管理器中的"TM1选项"菜单来更改Tm1p.
ini文件.
也可以手动编辑Tm1p.
ini文件.
有关更多信息,请参阅《PlanningAnalyticsLocal安装和配置》中的Tm1p.
ini主题.
第2章TM1AdminServer操作11指定远程服务器的管理主机要指定远程服务器向其注册的管理主机,请使用以下其中一种方法:–编辑Tm1s.
cfg文件中的AdminHost参数.
–使用-v命令行参数启动Windows版本的TM1Server.
有关服务器配置参数的信息,请参阅《PlanningAnalyticsLocal安装和配置》中有关Tm1s.
cfg文件的主题.
指定多个管理主机您可以通过使用分号分隔主机名,将TM1Client设置为引用多个管理主机.
指定多个管理主机的客户端可以访问向指定主机上的AdminServer注册的任何TM1Server.
12IBMPlanningAnalytics:TM1Operations第3章远程TM1Server操作本节描述了IBMTM1远程服务器如何工作,以及可以如何管理这些服务器的操作.
下图说明了远程TM1Server的操作.
1.
当启动TM1Server时,会将所有TM1数据从TM1数据目录装入到服务器计算机的RAM.
2.
当TM1Server正在运行时,所有多维数据集数据都位于RAM中.
从TM1Client接收到的所有编辑都存储在名为Tm1s.
log的事务日志文件中.
3.
TM1Client将从服务器中检索多维数据集值.
这些客户端还会将对多维数据集值的编辑发送到TM1Server.
4.
当关闭TM1Server时,或者发出显式保存数据命令时,会将对多维数据集值所做的任何更改从事务日志文件写入到数据目录中.
有关更多信息,请参阅TM1Server概述.
设置远程TM1Server以作为应用程序运行在MicrosoftWindows系统上运行"PlanningAnalytics安装向导"并安装样本TM1数据库之后,可使用IBMCognosConfiguration实用程序将每个样本数据库作为MicrosoftWindows服务运行.
或者,您也可以手动设置TM1Server以作为应用程序运行.
过程1.
在WindowsInternetExplorer中打开pa_install_directory\bin目录.
2.
在Tm1s.
exe上单击鼠标右键.
3.
选择创建快捷方式.
Windows将在pa_install_directory\bin目录中创建Tm1s.
exe的快捷方式.
4.
在快捷方式Tm1s.
exe上单击鼠标右键.
CopyrightIBMCorp.
2007,2019135.
选择属性.
将打开"属性"窗口.
6.
单击快捷方式选项卡.
该选项卡中的"目标"字段包含Tm1s.
exe的完整路径.
7.
在"目标"字段中,添加-z标记并指定包含服务器的Tm1s.
cfg文件的目录的完整路径.
例如,-zC:\TM1\salesdata指示服务器的Tm1s.
cfg文件位于C:\TM1\salesdata目录中.
注:如果目录的路径包含任何空格,请用双引号将整个路径引起来.
"目标"字段的内容应类似以下内容:"C:\ProgramFiles\IBM\cognos\tm1\bin\tm1s.
exe"-zC:\TM1\salesdata8.
单击确定保存快捷方式.
您可能需要将快捷方式移动到桌面,以方便使用.
启动设置为Windows应用程序的TM1Server可以启动设置为Windows应用程序的远程服务器.
过程双击"TM1销售数据"图标.
结果将打开服务器窗口.
该服务器窗口列出了装入到服务器RAM中的多维数据集和维度.
关闭设置为Windows应用程序的TM1Server可以关闭设置为作为Windows应用程序运行的远程服务器.
过程在服务器窗口中单击关闭按钮.
设置TM1Server以作为Windows服务运行可以使用tm1sd.
exe文件的命令行选项手动安装TM1Server以作为Windows服务运行,或移除现有TM1Server.
tm1sd.
exe文件安装在pa_install_directory\bin目录中.
要安装TM1Server以作为Windows服务运行,请使用以下命令行格式:tm1sd.
exe-installparameters.
下表列出了可用的参数.
参数必选/可选描述-n必需TM1Server的名称.
这将成为在您显示已安装服务的属性时所显示的Windows服务名称.
-z必需包含TM1数据库的tm1s.
cfg文件的数据目录.
14IBMPlanningAnalytics:TM1Operations参数必选/可选描述-u可选您工作所使用计算机的有效用户名称.
使用以下格式之一:域和用户名的格式为Domain\username.
例如,entp\jsmith.
当地用户帐户的用户名称.
如果未提供用户名称,缺省使用当前用户名称.
-w可选以上帐户的密码.
例如,以下命令行将安装sdataTM1Server以作为当前用户的Windows服务.
tm1sd.
exe-install-nsdata-zC:\ProgramFiles\Cognos\TM1\Custom\TM1Data\SData启动作为Windows服务安装的TM1Server要启动已作为服务安装的远程服务器,请完成以下步骤.
过程1.
打开MicrosoftWindows服务管理器.
将打开已安装服务的列表.
2.
选择您想要启动的TM1Server的条目,例如PlanningSample,然后单击启动按钮.
必须先运行AdminServer,然后才能启动TM1Server.
如果在Tm1s.
cfg文件中指定了管理主机,那么TM1Server将尝试连接到该主机上的AdminServer.
如果TM1Server出于任何原因无法连接到AdminServer,那么它将无法启动.
如果尚未指定管理主机,那么TM1Server会尝试连接到本地机器上的AdminServer.
如果AdminServer当前未在本地计算机上运行(无论是作为服务还是应用程序),TM1Server都会启动新的AdminServer应用程序并与其连接.
将服务设置为自动启动要将已安装的服务设置为在MicrosoftWindows重新引导时自动启动,请完成以下步骤.
过程1.
打开Windows服务管理器.
将打开已安装服务的列表.
2.
双击TM1Server条目.
将打开服务属性对话框.
3.
选择自动作为启动类型,然后单击确定.
移除作为Windows服务运行的TM1Server要移除作为服务运行的TM1Server,请使用以下命令行格式.
tm1sd.
exe-remove-n其中,是要移除的TM1Server的MicrosoftWindows服务名称.
第3章远程TM1Server操作15例如,以下命令行将移除sdataTM1Server的现有服务.
tm1sd.
exe-remove-nsdata关闭作为Windows服务运行的TM1Server可以关闭作为MicrosoftWindows服务安装的远程服务器.
过程1.
打开MicrosoftWindows服务管理器.
将打开服务的列表.
2.
右键单击TM1Server,然后选择停止.
有关以TM1Admin用户身份登录时从远程位置关闭服务器的详细信息和其他步骤,请参阅第19页的『管理客户端连接』.
结果在系统关闭时,作为Windows服务运行的TM1Server将自动关闭.
在某些情况下,运行大型或复杂模型的服务器可能会在系统关闭、断电或手动关闭服务期间非正常关闭.
非正常关闭的定义是,TM1Server在完成所有关闭过程前突然终止的一种关闭.
这种情况可能会发生在正常系统关闭期间,因为Windows为服务关闭分配的时间有限(大约20秒).
在分配的时间结束后,无论是否完成了服务关闭,都将进行系统关闭.
当TM1Server作为服务运行时,它将自动恢复发生非正常关闭的先前会话中所做的任何数据更改.
将从服务器的Tm1s.
log文件的记录中恢复更改.
有关Microsoft关闭服务的方法的详细信息,或者有关增大Windows为服务关闭分配的时间量的详细信息,请参阅Microsoft支持网站.
启动UNIXTM1Server为帮助您启动UNIXTM1Server,在pa_install_directory/bin或/bin64目录中提供了名为startup_tm1s.
sh的样本脚本.
对此样本脚本进行几处小的修改后,就可以使用它来启动UNIXTM1Server.
当使用该脚本启动服务器时,TM1将使用指定数据目录中的Tm1s.
cfg文件指引服务器的行为.
修改startup_tm1s.
sh脚本修改路径参数以定制startup_tm1s.
sh脚本.
过程1.
使用文本编辑器打开该文件.
2.
将tm1_path参数设置为包含tm1s.
exe服务器可执行文件的目录.
在大部分情况下,此目录为pa_install_directory/bin.
3.
将tm1_data_path参数设置为您的服务器数据目录.
4.
将TM1_PATH参数设置为包含tm1s.
exe服务器可执行文件的目录.
在大部分情况下,此目录为pa_install_directory/bin.
注:必须将tm1_path和TM1_PATH设置为相同的目录.
5.
保存脚本.
例如:>.
/startup_tm1s.
sh/software/AutoInstall/TM1/samples/tm1/SData如果需要,可以保存为一个新文件名.
如果已安装了多个TM1Server,那么您应当为每个服务器使用唯一的文件名创建特定于服务器的脚本.
16IBMPlanningAnalytics:TM1Operations6.
运行.
/startup_tm1s.
sh(或新的文件名)来启动TM1Server.
在后台方式下运行UNIXTM1Server可以通过将参数RunningInBackground添加到tm1s.
cfg文件并将该参数设置为T,在后台方式下运行TM1Server.
RunningInBackground=T必须手动将RunningInBackground参数添加到tm1s.
cfg.
该参数不是在安装TM1Server时创建的标准tm1s.
cfg文件的组成部分.
有关服务器配置参数的详细信息,请参阅《PlanningAnalytics安装和配置》.
另请参阅第17页的『关闭在后台方式下运行的UNIXTM1Server』.
关闭UNIXTM1Server您可以关闭在前台运行的服务器.
过程1.
在您启动服务器的窗口中按Ctrl+C.
2.
在退出前,服务器会提示您将所有数据保存到磁盘.
按ENTER(或RETURN)键保存所有数据.
键入No并按ENTER键以在不保存数据的情况下关闭服务器.
关闭在后台方式下运行的UNIXTM1Server要关闭在后台方式下运行的TM1Server,请运行位于pa_install_directory/bin目录中的关闭实用程序tm1srvstop.
exe.
shutdown实用程序tm1srvstop.
exe接受以下参数:参数描述-n必需要关闭的TM1Server的名称.
请注意,必须已在后台方式下启动该服务器.
-v必需注册TM1Server所在的AdminServer的IP地址.
-user必需关闭服务器的人员的用户名.
该用户必须具有关闭服务器所必需的权限.
-pwd必需关闭服务器的用户的密码.
-time可选运行shutdown_tm1s.
sh之后的关闭服务器的延迟(以秒为单位).
-cancel可选取消任何先前发出的shutdown_tm1s.
sh命令.
有效值是T和F.
-unsave可选缺省情况下,TM1会在使用shutdown_tm1s.
sh命令关闭TM1Server之前保存数据.
-unsave参数将在不保存数据的情况下关闭服务器.
有效值是T和F.
第3章远程TM1Server操作17例如,以下命令行允许名为Admin且密码为Administrator的用户关闭在位于207.
110.
100.
206的管理主机上注册的名为TM1SERV的TM1Server.
该命令行指示在发出命令和关闭服务器之间有30秒的时间间隔.
服务器在未保存数据的情况下关闭.
tm1srvstop.
exe-nTM1SERV-v207.
110.
100.
206-userADMIN-pwdAdministrator-time30-unsaveT或者,可以使用shutdown_tm1s.
sh来关闭服务器.
但是,此方法具有以下限制:shutdown_tm1s.
sh脚本只适用于运行TM1Server的本地计算机.
如果使用startup_tm1s.
sh和shutdown_tm1s.
sh脚本,那么必须确保TM1Server配置文件(tm1s.
cfg)中存在以下行:RunningInBackground=T.
连接到远程服务器要连接到远程TM1Server,客户端必须指向正在运行AdminServer的管理主机.
管理服务器维护关于可在网络上使用的远程TM1Server的信息,包括名称、协议、地址和端口号.
客户端使用的管理主机在Tm1p.
ini文件中指定.
过程1.
访问服务器资源管理器.
2.
双击要连接的服务器的图标.
将打开"服务器登录"对话框.
3.
输入正确的用户名和密码,然后单击确定.
如果成功连接到服务器,那么TM1将显示该服务器的"多维数据集"、"维度"、"复制"、"进程"和"杂项"图标.
(仅当作为管理组的成员登录时,才显示"复制]"图标.
)注:TM1远程服务器中提供的预定义管理员标识为admin,密码为apple.
刷新远程服务器列表如果在可用服务器列表中看不到要连接的远程服务器,您可以刷新该列表.
过程单击文件>刷新可用服务器.
TM1将显示在客户端指向的管理主机上注册的所有正在运行的服务器.
重置管理主机您可以设置或更改"管理主机".
过程1.
在服务器资源管理器中,单击文件>选项.
"TM1选项"对话框将打开.
2.
在"管理主机"字段中输入管理主机的名称.
可通过用分号分隔主机名来连接两个或更多主机.
也可以单击下拉菜单,以从以前访问过的管理主机中进行选择.
3.
单击确定.
更改管理主机时,TM1将断开与已连接的远程服务器的连接,并重新启动TM1Client.
如果本地服务器正在运行,服务器将被关闭并重新启动.
重置本地服务器选项下表描述了您可以通过"TM1选项"对话框更改的本地服务器选项.
18IBMPlanningAnalytics:TM1Operations本地服务器选项描述数据目录本地服务器数据文件的目录.
启动时连接到本地服务器选中或清除"启动时连接到本地服务器"复选框可以控制TM1Client是否在启动时自动连接到本地服务器.
从远程服务器断开连接您可以从远程服务器断开连接.
过程1.
在服务器资源管理器中,选择要断开连接的服务器的图标.
2.
单击服务器>注销.
记录事务每个TM1Server都会跟踪由其客户端执行的数据事务.
当客户端更改多维数据集值时,TM1将在名为Tm1s.
log的事务日志文件中记录更改,该文件位于TM1Server数据目录中.
有关更多信息,请参阅第35页的『PlanningAnalytics和TM1日志』中的第41页的『事务日志』.
监视服务器性能TM1包括性能监视功能,您可以使用该功能记录客户端、多维数据集和服务器的性能统计信息.
当启用性能监视时,TM1将每分钟填充数个控件多维数据集.
然后,可以浏览这些多维数据集来分析服务器性能.
有关更多信息,请参阅第54页的『控件多维数据集』和第111页的『附录B控件多维数据集』.
管理客户端连接作为TM1Server管理员,您可以使用客户端消息传递中心来管理客户端连接.
任务包括:向客户端广播消息从服务器断开客户端的连接远程关闭服务器向客户端广播消息如果您是TM1Server管理组的成员,那么可以向连接到服务器的任何客户端广播消息.
例如,您可以通知客户端它们即将与服务器断开连接或服务器即将关闭.
过程1.
在服务器资源管理器的左窗格中,选择要在其上广播消息的服务器.
2.
依次单击服务器、服务器管理器.
将打开"客户端消息中心"对话框.
3.
选择不执行操作可以在不关闭TM1Server的情况下广播消息.
4.
选择广播消息.
第3章远程TM1Server操作195.
在"广播消息"框中输入要广播的消息.
6.
单击选择客户端.
"子集编辑器"将打开,其中包含当前连接到TM1Server的所有客户端的子集.
不能向当前未连接到服务器的客户端发送消息.
7.
选择希望接收消息的客户端并单击确定.
8.
在"客户端消息中心"中单击确定来广播消息.
从服务器断开客户端的连接可以从TM1Server断开客户端的连接.
过程1.
在服务器资源管理器的左窗格中,选择要与客户端断开连接的服务器.
2.
依次单击服务器、服务器管理器.
将打开"客户端消息中心"对话框.
3.
选择断开客户端连接.
4.
指定分钟间隔,以确定将在何时断开客户端连接.
5.
单击选择客户端.
子集编辑器将打开,其中包含服务器上存在的所有客户端的子集.
该子集不是当前连接的所有客户端的子集.
6.
选择要断开连接的客户端,并单击确定.
将向所有选定客户端一条含警告的消息,内容是将在您在步骤4中指定的间隔后断开连接.
7.
如果要向选定客户端广播更详细的消息,您可以选择"向选定客户端广播消息"选项,并在"广播消息"框中输入消息.
8.
在"客户端消息中心"中单击确定.
远程关闭服务器可以从TM1Client远程关闭服务器.
过程1.
在服务器资源管理器的左窗格中,选择要关闭的服务器.
2.
单击服务器>服务器管理器.
将打开"客户端消息中心"对话框.
3.
选择关闭服务器.
4.
指定分钟间隔,以确定将在何时关闭服务器.
5.
单击确定.
当前连接到服务器的所有客户端都将收到一条消息,内容是服务器将在您在步骤4中指定的分钟数内关闭.
远程服务器内存管理TM1Server使用稀疏内存管理方案,该方案允许服务器存储非常大的多维数据集,而所占空间比相同数据在关系数据库中所占空间小得多.
因此,内存管理方案允许服务器在RAM中容纳大型的数据库而无需使用磁盘空间.
服务器使用的RAM不是静态的.
当远程服务器计算合并时,服务器将存储该结果供以日后参考.
第二次请求合并值时,TM1可以不用计算就传递值,这样会极大提高速度.
20IBMPlanningAnalytics:TM1Operations由于越来越多的合并被存储起来且不需要重新计算,因此远程服务器内存管理方式意味着服务器运行时间越长,其速度越快.
服务器使用的内存量将日益增长.
服务器不会逐个字节提取内存,而是时常提取大片内存.
在TM1Server终止之前,TM1不会将内存释放回操作系统.
相反,TM1会将不再需要的内存放入垃圾列表,以便在需要时复用.
因此,TM1Server的内存消耗(如操作系统所报告)是当前实际内存用量和垃圾内存的总计.
可以通过查看}StatsForServer控件多维数据集来查看实际内存用量和垃圾内存的准确报表(如第111页的『附录B控件多维数据集』中所述).
所有的远程服务器平台都支持虚拟内存(其中磁盘空间作为RAM使用).
服务器在虚拟内存中运行,但是这极大地降低了性能.
最佳做法是,始终在真实RAM中保留所有多维数据集.
您应该通过使用系统监视实用程序来关注内存消耗.
如果系统运行缓慢,则可能需要将更多的RAM添加到您的服务器.
某些操作系统会保留将分配给任何一个进程的内存可配置限制.
如果系统显示无法提取应当对其可用的所有内存,您可能希望查看操作系统参数.
可以通过将MaximumViewSize参数添加到Tm1s.
cfg服务器配置文件来限制分配给任何单个视图的内存量.
有关配置参数的更多详细信息,请参阅《PlanningAnalytics安装和配置》.
关于星门视图星门视图是当您使用CubeViewer或电子表格内浏览器浏览多维数据集时,TM1创建的TM1多维数据集的已计算和已存储的子部分.
星门视图的目的是更快地访问多维数据集数据.
星门视图与TM1视图对象不同.
星门视图仅包含多维数据集已定义部分的数据,不包含视图对象中存在的格式化信息和浏览器设置.
当在CubeViewer或电子表格内浏览器中浏览多维数据集时,TM1创建的星门视图仅包含由当前标题元素与行和列子集定义的数据.
当您访问检索时间大于}CubeProperties控件多维数据集中的VMT属性所定义的阈值的视图时,TM1将存储星门视图.
(如果未明确定义VMT值,那么当视图所用时间超过五秒时,会生成星门视图.
这是}CubeProperties控件多维数据集中未指定VMT时的缺省阈值.
)只有生成星门视图的浏览器视图保持不变时,星门视图才会一直仅保留在内存中.
重新计算浏览器视图时,TM1会根据重新计算的视图创建新的星门视图并替换内存中现有的星门视图.
关闭浏览器视图时,TM1会将星门视图从内存中移除.
在批量加载模式下使用TM1批量加载模式使IBMTM1能够以经过特别优化的单用户或单杂项/进程方式运行.
此方式可以在预期没有或几乎没有其他活动时针对专用任务最大限度提高TM1性能.
一些使用批量加载模式的示例包括:需要手动执行维护操作的TM1管理员.
要装入大量数据的夜间窗口.
TM1通常以多用户方式运行;在此方式下,多个用户、杂项和进程可以全部同时运行并访问TM1数据.
在批量加载模式下,TM1Server将通过以下方法来阻止并发活动:临时暂挂其他用户、杂项和进程,并消除多用户环境所需的开销.
批量加载模式并不会真正注销用户,只是暂挂这些用户与TM1的交互.
一旦完成了批量加载模式,就会重新激活先前登录的所有用户,并且将恢复与TM1的用户交互.
可以直接在TI进程中启用批量加载模式,也可以使用TM1API来启用此模式.
在任何一种情况下,都可使用命令来进入和退出批量加载模式.
使用批量加载模式的注意事项使用批量加载模式时,应考虑下列事项.
批量加载模式不会向最终用户显示提醒消息.
因此,您需要计划和协调批量加载模式的使用.
第3章远程TM1Server操作21在批量加载模式下,只有单一用户或进程可以处于活动状态.
当服务器处于批量加载模式时,不得向此服务器建立新的连接.
TI进程不能使用ExecuteCommand来启动尝试重新登录到相同TM1Server的命令行程序.
登录尝试将失败.
批量加载模式启用时,任何计划执行的计划杂项将被停用,不会运行.
启动批量加载模式当服务器进入批量加载模式时,由其他线程执行的所有处理都将暂停.
任何现有的用户线程和正在运行的杂项都将暂挂.
只有已启动批量加载模式的线程才将保持活动状态.
除了已启动批量加载模式的杂项之外,将取消激活所有其他计划的杂项.
所有特定于系统的线程连接也将暂挂.
结束批量加载模式禁用批量加载模式之后,将恢复运行所有系统线程和用户线程,并且将允许用户登录.
使用TM1API来启用批量加载模式的定制应用程序还应该调用必需的TM1API函数以退出批量加载模式.
但是,如果客户端连接已断开(发生了网络故障,或者客户端注销、崩溃或断开连接),那么服务器将自动退出批量加载模式.
同样,如果TI进程/杂项正在批量加载模式下运行,进程退出后,无论是成功退出还是出现错误,服务器都会自动退出批量加载模式.
当服务器返回到正常的多用户方式时,先前已取消激活的所有杂项都将重新激活,并返回到它们的正常调度.
如果先前已安排运行杂项,但是这些杂项被批量加载模式阻止,那么将不会立即执行这些杂项,而将根据安排来执行.
您可能需要调整计划杂项的启动时间,以防在批量加载模式启用期间被锁定.
TM1CAPI使用下列TM1API函数来启用和禁用批量加载模式.
TM1VTM1ServerEnableBulkLoadMode(TM1PhPool,TM1ServerhServer)TM1VTM1ServerDisableBulkLoadMode(TM1PhPool,TM1ServerhServer)其中:TM1P是使用TM1ValPoolCreate获得的池句柄.
TM1Server是当前服务器的句柄.
TurboIntegrator进程命令可以在TurboIntegrator进程的"序言"或"结语"部分启用批量加载模式.
为了提高效率,建议在进程的"序言"部分中第一个语句或者非常接近第一个语句的位置启用批量加载模式.
在进程中启用批量加载模式之后,只能在"结语"部分的最后一行禁用此模式.
如果您尝试在此进程中的任何其他位置禁用批量加载模式,那么将不会编译此进程.
如果在TurboIntegrator进程中启用该模式,那么该模式将保持启用直到显式禁用或杂项完成为止.
这意味着您必须首先在杂项的进程中启动该模式,然后在禁用该模式之前运行一系列TurboIntegrator进程.
您还可以反复进入并退出批量加载模式,从而仅对一个杂项的某些关键部分使用此模式.
使用EnableBulkLoadMode()和DisableBulkLoadMode()TurboIntegrator命令在TurboIntegrator进程中启用和禁用批量加载模式.
使用批量加载模式时,只能在TurboIntegrator进程的"结语"部分的最后一行使用DisableBulkLoadMode()函数.
22IBMPlanningAnalytics:TM1Operations第4章PlanningAnalytics安全性概述您可以控制对服务器的访问和认证.
IBMPlanningAnalytics中的安全性功能允许您控制认证和对象安全性.
这会定义登录到IBMTM1Server的用户以及允许这些用户访问的对象.
有关配置认证安全性的完整详细信息,请参阅《PlanningAnalyticsLocal安装和配置》文档.
认证概述可以配置IBMTM1Server以使用特定认证方式控制用户登录访问.
缺省情况下,安装TM1Server时,会将其配置为使用标准CognosTM1认证.
安装TM1Server之后,您可以通过更改TM1配置文件中的参数来更改认证方法.
表1.
TM1Server认证方法认证方法描述TM1认证TM1Server会要求您输入用户名和密码,并根据安全多维数据集登录信息验证登录信息.
集成登录MicrosoftWindows会执行CognosTM1认证.
LDAP认证TM1Server会要求您输入用户名和密码,并根据外部LDAP服务器验证登录信息.
IBMCognos安全性TM1Server使用IBMCognos安全性认证用户.
TM1对象安全性作为PlanningAnalytics管理员,您可以通过为组分配特定级别的对象安全性,控制对对象的访问.
假设TM1数据库中有一个名为Executives的组.
您希望这些主管复审存储在TM1数据库中BudSummary多维数据集内的公司预算摘要数据.
可以使用TM1为Executives组分配对BudSummary多维数据集的"读"权限.
使用与TM1套件中任何产品相同的方式设置TM1访问控制.
例如,如果Executives组中的用户在运行TM1Perspectives时具有对BudSummary多维数据集的"读"访问权限,那么这些用户在运行TM1Web客户端时也具有对该多维数据集的"读"访问权限.
要了解有关用于为TM1对象设置安全性的过程的更多信息,请参阅《TM1开发人员指南》文档.
CopyrightIBMCorp.
2007,20192324IBMPlanningAnalytics:TM1Operations第5章管理用户和组在IBMPlanningAnalytics中,安全性基于用户所属的组.
用户和组安全性概述PlanningAnalytics通过将用户组织成组来管理安全性.
PlanningAnalytics包括一组预定义的管理组,同时允许您创建自己的定制组.
用户可以属于一个或多个组.
TM1具有两种主要类型的用户组:管理组仅包括预定义组:"管理组"、"数据管理组"、"操作管理组"和"安全管理组".
有关更多信息,请参阅第26页的『管理组和权限』.
用户组包括所有用户创建的组,通常包含非管理TM1用户.
您可以使用TM1的"客户端/组"对话框来管理TM1用户和组.
"客户端/组"对话框分别组织组和用户.
作为TM1管理员,您必须运行TM1Architect或TM1Perspectives来管理IBMTM1Server上的安全性.
实施TM1安全方案您可以实施TM1安全方案来保护远程服务器上的对象.
过程1.
定义安全性组.
2.
为这些组分配访问权限.
3.
定义TM1用户.
4.
将用户分配到组.
可以实施以下安全级别:多维数据集级别的安全性控制对多维数据集的访问.
元素级别的安全性控制对由元素标识的单元格的访问.
维度级别的安全性控制在维度中添加、移除和重排元素的能力.
此类安全性独立于多维数据集级安全性和元素级安全性(用户对维度不具有访问权限的情况除外).
单元格级别的安全性控制对单元格的访问.
注:TM1Client和Server使用TM1用户名和密码通过网络直接通信.
此安全性独立于标准文件系统安全性,并且不受用户对网络目录或文件服务器的访问权限的影响.
用户和组安全性示例为了说明IBMPlanningAnalytics安全性并允许您尝试使用安全性功能,随PlanningAnalytics一起安装的TM1样本数据(Sdata)随附了一组预定义的组和用户.
要查看这些组和用户,请右键单击服务器资源管理器中的Sdata服务器,然后单击安全性>客户端/组.
将显示"TM1客户端/组"对话框.
下表包括了示例用户的密码.
注:密码隐藏在"客户端/组"窗口中,并且显示为"已定义"或"未定义".
CopyrightIBMCorp.
2007,201925用户名Password组成员资格AdminappleADMINUsr1red北美洲Usr2orange南美洲Usr3blue北美洲和南美洲管理组和权限IBMPlanningAnalytics通过将管理用户分成以下预定义的管理员组,支持分离PlanningAnalytics中的管理职责与角色.
管理组管理组的成员有权访问TM1的所有区域,并代表具有所有权限的超级用户.
安全管理组安全管理组只能在TM1中执行安全操作.
这些操作包括创建、编辑和删除TM1用户和组.
此组可以管理其他用户对TM1对象(例如,多维数据集、维度和规则)的访问权限,但是此组不能查看这些TM1对象中的数据.
数据管理组数据管理组具有对与安全性无关的一切内容的管理权限.
此组可以查看、编辑和保存TM1对象,例如多维数据集、维度、规则和进程.
此组中的成员可以采用只读方式查看安全设置,但不允许修改安全设置.
操作管理组操作管理组只能在TM1中执行维护操作.
此组可以执行TM1Server维护和运行工作,例如断开用户的连接或取消线程.
操作管理组中的成员无权访问任何TM1元数据、多维数据集数据或其他任何数据.
这些管理员组的安全性分配是硬编码的,不可修改.
您可以使用这些预定义的管理员组来控制和分离不同用户的TM1管理角色,以满足内部或外部安全性需求和规则.
注:TM1中的复制和同步操作只能由管理组的成员执行.
数据管理组、操作管理组和安全管理组的成员没有执行这些操作的全部访问权限.
管理组管理组是仅针对管理目的而创建的,应该只包含一小组可信的TM1管理员.
管理组成员始终对远程服务器上的所有对象具有最高安全性级别,他们可以执行以下管理任务:分配和撤销其他用户的访问权限.
创建和删除多维数据集、维度、元素、进程和杂项.
添加、删除和重排维度中的元素.
更改多维数据集数据.
创建和删除公共视图和子集.
保留和锁定多维数据集、元素和维度,从而使其他用户无法对其进行更新.
取消对多维数据集、元素和维度的保留和锁定.
在服务器上创建复制的对象.
更改TM1单元格安全性.
创建和删除TM1规则.
26IBMPlanningAnalytics:TM1Operations同时属于多个组的用户具有所有组中最高级别的权限.
例如,管理组和安全管理组或管理组和数据管理组的共有成员资格将视为管理组.
某些限制适用于每个预定义组.
有关更多信息,请参阅每个组的定义.
管理组的成员是唯一可以将用户添加到管理组的TM1用户.
安全管理组安全管理组的成员可以访问TM1的安全性相关功能,但是不能查看非安全性TM1对象(例如,多维数据集、维度和规则)中的数据.
允许此组中的成员创建、编辑和删除TM1用户和组.
另外,这些用户可以管理其他用户对TM1对象(例如,多维数据集和维度)的访问权限.
如果没有使用集成登录,安全性管理员也能重新设置用户密码.
作为安全管理组的成员,您可以使用服务器资源管理器中的下列工具来管理TM1安全性:"客户端/组"窗口将TM1Client分配给TM1组.
"安全性分配"窗口控制对TM1对象(例如,多维数据集、维度和进程)的用户访问权限.
安全性控件多维数据集手动应用TM1对象和用户组的安全性权限.
复制和同步的限制条件安全管理组的成员没有在TM1中执行复制和同步操作所需的所有访问权限,因此不应该尝试执行这些操作.
规则和进程的限制条件安全管理组中的成员不能编写或修改规则和进程.
他们无法查看规则,但是能以只读方式查看进程.
有关进程的更多信息,请参阅《TM1开发人员指南》文档.
将安全管理成员资格与其他组合并不倾向于将安全管理组中的成员资格与数据管理组或任何其他用户组中的成员资格合并.
安全性管理限制访问非安全性对象,无论用户属于其他哪个组,这些限制总是适用.
另外,将用户分配给安全管理组后,TM1不允许再将其添加到任何其他用户组.
这些限制防止安全性管理成员被添加到其他的组而获得安全管理组成员不允许拥有的数据访问和操作权限.
将安全管理组与TM1CAPI配合使用TM1CAPI不允许编程人员为安全管理组配置共有的成员资格.
客户端组分配功能拒绝任何欲将安全管理组成员放到其他组的尝试.
将用户添加到管理组的限制条件不允许将安全管理组的成员将用户添加到管理组.
只有完整管理组中的成员可以将其他用户添加到管理组.
这将防止安全管理组在管理组中创建具有全部管理权限的用户帐户.
数据管理组数据管理组中的成员具有对与安全性无关的一切事务的管理权限.
此组中的用户可以查看、编辑和保存TM1对象,包括多维数据集、维度、规则和进程.
数据管理组能以只读方式查看安全设置,但不允许此组的成员修改任何安全设置.
例如,作为数据管理组的成员,您可以打开TM1对象(多维数据集、维度和进程)的"客户端/组"窗口或任一"安全性分配"窗口.
但是,这些窗口以只读方式显示,并且您不能进行更改.
用户组中的成员资格允许合并数据管理组和任何其他用户组中的成员资格.
然而,此合并视为数据管理组.
用户组访问权限施加的任何限制都会被数据管理访问权限覆盖.
例如,如果用户是数据管理组和用户组的成员,并且该用户组没有对多维数据集的安全权限,那么用户可以根据其数据管理权限来查看该多维数据集.
第5章管理用户和组27安全管理组和数据管理组中的成员资格不倾向于将数据管理组中的成员资格与安全管理组中的成员资格合并.
如果用户同时属于数据管理组和安全管理组,那么该用户的安全权限仅限于安全管理组.
同时具有安全性管理和数据管理组成员身份的用户允许查看和编辑用户和组安全性设置.
复制和同步的限制条件数据管理组的成员没有在TM1中执行复制和同步操作所需的所有访问权限,因此不应该尝试执行这些操作.
安全性控件多维数据集规则的限制条件数据管理无法创建用于安全性控件多维数据集的规则.
该限制条件将阻止数据管理创建可以修改安全性控件多维数据集内单元格的规则.
操作管理组操作管理组只能在TM1中执行维护操作.
操作管理组中的成员无权访问任何TM1元数据、多维数据集数据或其他任何数据.
作为操作管理组的成员,您可以通过TM1RESTAPI来执行以下TM1Server操作.
查看线程查看TM1Server中运行的线程.
示例方法:GET语法:http://localhost:5657/api/v1/Threads取消线程取消操作.
示例方法:POST语法:http://localhost:5657/api/v1/Threads('13124')/tm1.
CancelOperation断开用户的连接断开用户的连接,但处于活动状态的现有线程将继续运行,直到完成为止.
操作管理可以断开管理组成员的连接.
此方法是对先前行为的更改.
示例方法:POST语法:http://localhost:5657/api/v1/Users('Admin')/tm1.
Disconnect查看TM1Server配置查看在TM1Server的tm1s.
cfg文件中定义的配置参数.
示例方法:GET语法:http://localhost:5657/api/v1/ActiveConfiguration/Administrationhttp://localhost:5657/api/v1/StaticConfiguration/Administration28IBMPlanningAnalytics:TM1Operations编辑TM1Server配置指定在TM1Server的tm1s.
cfg文件中定义的配置参数.
示例方法:PATCH语法:http://localhost:5657/api/v1/StaticConfiguration/AdministrationBody:{"AdminHost":"xxx.
xxx.
xxx"}查看TM1Server记录器查看为TM1Server配置的记录器.
示例方法:GET语法:http://localhost:5657/api/v1/Loggers编辑TM1Server记录器为TM1Server配置记录器.
示例方法:PATCH语法:http://localhost:5657/api/v1/Loggers('TM1.
Login')Body:{"Level":"Debug"}检索消息日志条目数检索TM1Server消息日志中的条目数.
示例方法:GET语法:http://localhost:5657/api/v1/MessageLogEntries/$count检索消息日志条目检索TM1Server消息日志条目.
示例方法:GET语法:http://localhost:5657/api/v1/MessageLogEntriesskip=82第5章管理用户和组29添加和删除用户和组您可以在TM1Server上添加和删除用户和组.
添加用户要添加用户,请完成以下步骤.
过程1.
打开服务器资源管理器.
2.
选择您正在使用的服务器的图标.
3.
右键单击该图标,然后单击安全性>客户端/组.
将打开"客户端/组"对话框.
4.
单击客户端>添加新客户端.
将打开"创建新客户端"对话框.
5.
在"输入新客户端名称"框中输入新用户的名称.
注:TM1会忽略用户名和密码中的空格.
例如,TM1会将含有空格的"McCormick"与没有空格的"McCormick"名称视为相同的名称.
6.
单击确定.
TM1会将用户作为新行添加到"客户端/组"网格中.
第一次添加新用户时,系统会根据以下规则向该用户授予缺省的对象安全权限:如果已为服务器定义了用户组,那么新用户对服务器上的所有对象都具有None权限.
您必须将用户分配到组,以允许访问TM1对象.
如果已为服务器定义了用户组,则新用户对服务器上的所有对象具有写入权限.
添加组您可以在IBMTM1Server上最多添加65,535个组.
过程1.
打开服务器资源管理器.
2.
选择您正在使用的服务器的图标.
3.
右键单击服务器图标,然后单击安全性>客户端/组.
将打开"客户端/组"对话框.
4.
单击组>添加新组.
将打开"创建新组"对话框.
5.
在EnterNewGroupName(输入新组名称)框中输入新组的名称.
6.
单击确定.
TM1会将组添加为"客户端/组"对话框中的新列.
删除用户要添加用户,请完成以下步骤.
过程1.
在服务器资源管理器中,右键单击服务器图标,然后单击安全性>客户端/组.
2.
在客户端/组对话框中,单击要删除的用户.
3.
单击客户端>删除客户端.
30IBMPlanningAnalytics:TM1Operations4.
单击是确认删除.
删除组要删除组,请完成以下步骤.
过程1.
在服务器资源管理器中,右键单击服务器图标,然后单击安全性>客户端/组.
2.
在客户端/组对话框中,单击代表您要删除的组的那一列中的单元格.
3.
单击组>删除组.
4.
单击是确认删除.
将用户分配到组您可以将用户分配到组.
过程1.
在服务器资源管理器中,右键单击服务器图标,然后单击安全性>客户端/组.
2.
在客户端/组对话框中,单击用户名和组名交叉处的复选框.
3.
单击确定.
多个组中的成员资格同时属于多个组的用户具有所有组中最高级别的权限.
例如,在样本数据中,Usr3是两个组的成员.
北美洲,对区域维度中的元素Canada、Mexico和UnitedStates具有"写"访问权限,对区域维度中的其他元素具有"读"访问权限.
南美洲,对区域维度中的元素Argentina、Brazil、Chile和Uruguay具有"写"访问权限,对区域维度中的其他元素具有"读"访问权限.
TM1向Usr3提供对区域维度中Argentina、Brazil、Canada、Chile、Mexico、UnitedStates和Uruguay元素的"写"访问权限,以及对该维度中其他元素的"读"访问权限.
保护TM1数据因为您的公司使用PlanningAnalytics进行高级规划和分析,所以数据可能是敏感且机密的.
PlanningAnalytics为您提供保护数据所需要的所有工具,但是实际的安全性只取决于您实施的过程.
限制对数据目录的访问使用网络文件系统安全性时,您应该总是保护数据目录,以便其对任何人都不可视,除了服务器自己使用的网络登录.
无论服务器上的安全性如何周全,只要用户可以看到数据目录,那么就可以使用TM1直接从磁盘查看数据,而无需连接到TM1Server.
分配密码管理组的成员对网络系统的权限类似于超级用户或root用户的权限;他们可以访问任何地方,执行任何操作.
请慎重分配管理密码,并确保管理用户知道不能向任何人泄露或分享其密码.
第5章管理用户和组31保护密码使用与处理其他网络密码相同的方式来处理PlanningAnalytics密码.
请确保用户知道不能共享密码.
另外,鼓励或要求用户经常更改自己的密码.
设置和清除密码您可以设置、清除和更改用户的密码.
密码可以包含任何键盘字符.
密码不区分大小写.
例如,密码ABC123与abc123相同.
密码中允许使用空格,但是TM1Server会忽略空格.
TM1Server将密码ABC123DEF视为与ABC123DEF相同.
设置密码您可以设置密码.
过程1.
在服务器资源管理器中,右键单击服务器图标,然后单击安全性>客户端/组.
2.
在客户端/组对话框中,单击用户名和"密码"列交叉处的单元格.
该单元格包含值未定义.
3.
为该用户输入新密码,然后按Enter键.
密码最多可以包含256个字符.
TM1将提示您重新输入新密码.
4.
重新键入密码,然后单击确定.
该单元格现在包含值已定义.
5.
单击确定.
清除密码要清除密码,请完成以下步骤.
过程1.
在服务器资源管理器中,右键单击服务器图标,然后单击安全性>客户端/组.
2.
在客户端/组对话框中,选择"密码"列和用户名交叉处的单元格.
3.
单击客户端>清除密码.
确认是否确实要清除密码.
4.
单击是.
TM1会清除密码,并在单元格中显示值未定义.
5.
单击确定.
注:清除密码后,用户可以在下次登录到TM1Server时重建密码.
更改密码您可以在连接到远程服务器之后随时更改密码.
非管理员用户同样可以执行此操作.
过程1.
在服务器资源管理器中,选择正在使用的服务器的图标.
2.
单击服务器>安全性>更改密码.
将显示"更改密码"对话框.
32IBMPlanningAnalytics:TM1Operations3.
在"密码"框中键入新密码,然后单击确定.
TM1将提示您重新输入新密码.
4.
重新键入密码,然后单击确定.
设置用户的到期时间将用户添加到TM1时,可以对该用户可以访问服务器的天数设置限制.
过程1.
在服务器资源管理器中,右键单击服务器图标,然后单击安全性>客户端/组.
2.
在客户端/组对话框中,在用户名与"到期天数"列交叉处的单元格中,输入您要允许用户访问TM1Server的天数.
在指定的天数过后,该用户将无法登录此服务器.
3.
单击确定.
第5章管理用户和组3334IBMPlanningAnalytics:TM1Operations第6章系统和性能监视IBMPlanningAnalytics包含一组工具,用于对您组织中的TM1Server进行日志记录和实时性能监视.
您可以使用以下工具监视TM1Server的性能和活动.
PlanningAnalytics和TM1日志可以使用PlanningAnalytics日志来监视TM1Server和TM1AdminServer的性能.
例如,维度和多维数据集在装入时会生成消息,并且TM1Server在启动和停止时会报告消息.
可以通过选择性打开或关闭日志记录属性文件中的各个TM1记录器,控制日志记录的数量和焦点.
默认记录配置是TM1所有区域的INFO级别消息.
注:可以管理IBMPlanningAnalytics日志文件以防止在TM1数据库日志目录中累积日志文件.
当TM1Server或PlanningAnalytics管理尝试访问现有日志文件时,日志文件累积可能会导致问题.
PlanningAnalytics提供以下日志文件:AdminServer日志日志文件:\bin64\中的tm1admsrv.
log属性文件:\bin64\中的tm1admsrv-log.
properties有关更多信息,请参阅第39页的『TM1AdminServer日志』.
事务日志日志文件:\bin64\\中的tm1s.
log属性文件:\bin64\\中的tm1s-log.
properties有关更多信息,请参阅第41页的『事务日志』.
TM1消息日志日志文件:\bin64\\中的tm1server.
log属性文件:\bin64\\中的tm1s-log.
properties有关更多信息,请参阅第44页的『消息日志』.
TM1审核日志日志文件:tm1rawstore.
有关更多信息,请参阅第46页的『审核日志』.
ops记录器:已在PlanningAnalyticsV2.
0.
3中添加属性文件:\bin64\\中的tm1s-log.
properties有关更多信息,请参阅第51页的『ops记录器』.
TM1Top日志已在PlanningAnalyticsV2.
0.
7中添加属性文件:\bin64\\中的tm1s-log.
properties有关更多信息,请参阅第52页的『TM1Top日志』.
TurboIntegrator进程错误日志日志文件:TM1ProcessError.
log有关更多信息,请参阅TM1ProcessError.
log文件.
TM1事件日志日志文件:tm1event.
log有关更多信息,请参阅下载数据库日志文件和EventLogging.
日志记录属性文件您可以使用日志记录属性文件tm1s-log.
properties来控制为TM1的不同组件记录哪些日志级别.
CopyrightIBMCorp.
2007,201935tm1s-log.
properties文件是文本文件,包含用于配置对特定TM1Server的日志记录的参数.
有关更多信息,请参阅第37页的『在tm1s-log.
properties中配置日志记录参数』和第38页的『在tm1s-log.
properties中配置日志记录级别』.
每个TM1Server都使用其自己的tm1s-log.
properties文件,并在每次启动服务器时检查该文件.
启动之后,服务器会检查对属性文件的更新,并根据需要调整记录.
您可以实时更新属性文件,并且TM1Server会动态读取更改并调整日志记录.
注:TM1本地服务器仅在启动时才检查tm1s-log.
properties文件.
所安装的某些样本TM1数据库的目录中提供了样本tm1s-log.
properties文件.
示例tm1s-log.
properties文件log4j.
logger.
TM1=INFO,S1#S1设置为SharedMemoryAppenderlog4j.
appender.
S1=org.
apache.
log4j.
SharedMemoryAppender#指定共享内存段的大小log4j.
appender.
S1.
MemorySize=5MB#指定最大文件大小log4j.
appender.
S1.
MaxFileSize=100MB#指定最大备份索引log4j.
appender.
S1.
MaxBackupIndex=20#指定GMT或本地时区log4j.
appender.
S1.
TimeZone=GMTlog4j.
logger.
Event=INFO,S_Eventlog4j.
appender.
S_Event=org.
apache.
log4j.
SharedMemoryAppenderlog4j.
appender.
S_Event.
MemorySize=1MBlog4j.
appender.
S_Event.
MaxFileSize=100MBlog4j.
appender.
S_Event.
MaxBackupIndex=1log4j.
appender.
S_Event.
File=tm1event.
loglog4j.
appender.
S_Event.
Format=TM1Eventlog4j.
appender.
S_Event.
TimeZone=GMT启用和禁用日志记录当TM1Server在服务器配置文件tm1s.
cfg所在的目录中检测到日志属性文件时,会启用日志记录.
过程1.
编辑示例日志属性文件tm1s-log.
properties的副本,以配置日志消息级别和输出设置,如第38页的『在tm1s-log.
properties中配置日志记录级别』和第37页的『在tm1s-log.
properties中配置日志记录参数』中所述.
2.
将tm1s-log.
properties放置在要监视的TM1数据库的配置文件Tm1s.
cfg所在的目录中.
tm1s.
cfg文件的位置通常是TM1数据库的数据目录,但也可以是其他位置(取决于特定TM1配置).
例如,如果tm1s.
cfg文件位于MicrosoftWindows系统上的C:\salesdata目录中,那么将tm1s-log.
properties文件复制到此目录中.
将tm1s-log.
properties文件放置到tm1s.
cfg文件所在的目录中之后,服务器将基于tm1s-log.
properties文件中配置的设置来启动日志记录.
无需重新启动TM1Server来初始化日志记录,除非您正在运行本地服务器.
注:TM1本地服务器仅在启动时才检查日志属性文件tm1s-log.
properties.
启动之后,本地服务器永远不会检查tm1s-log.
properties文件中的更改,因此本地服务器tm1s-log.
properties文件中的所有设置都必须视为静态.
如果更改本地服务器的任意日志属性,则必须重新启动服务器才能应用新的日志设置.
3.
要临时关闭日志记录,请将TM1记录器值设置为INFO或OFF.
建议使用值INFO.
将记录器值设置为INFO将继续一些日志,但是与设置DEBUG相比,数量会大大减少.
使用设置INFO代替OFF很有用,因为TM1仍将记录WARN、ERROR和FATAL级别的重要消息.
将记录器值设置为OFF将停止该记录器的所有日志,因此您可能错过任何潜在的WARN、ERROR和FATAL消息.
36IBMPlanningAnalytics:TM1Operations在tm1s-log.
properties中配置日志记录参数使用以下参数在tm1s-log.
properties文件的appender部分中配置日志记录输出.
参数描述MemorySize指定共享内存段的大小.
该内存表写入日志文件之前将日志消息发送到的系统内存区域.
缺省值为5MB.
使用以下格式:log4j.
appender.
S1.
MemorySize=大小单位其中:Size(大小)是表示内存大小的数值.
单位可以是KB或MB.
例如,要将MemorySize设置为5MB,请输入以下值:log4j.
appender.
S1.
MemorySize=5MBMaxFileSize指定日志文件可占据磁盘空间的最大文件大小.
缺省大小为100MB.
使用以下格式:log4j.
appender.
S1.
MaxFileSize=SizeUnits其中:"大小"是表示文件大小的数值.
单位可以是KB、MB或GB.
例如,要将日志文件大小限制为10MB,请输入以下内容:log4j.
appender.
S1.
MaxFileSize=10MB如果MaxBackupIndex参数设置为1或更大,那么日志记录进程将在日志文件达到MaxFileSize时自动创建备份文件.
备份文件的总数目由MaxBackupIndex选项确定.
MaxBackupIndex一个数值,指定保存多少备份文件后才清除最早的日志文件.
缺省值为20.
如果设置为0-不保存备份日志文件,并覆盖当前的日志文件且在其每次达到MaxFileSize时重新开始.
如果设置为1或更大-将维持备份文件总数为x个,其中x等于MaxBackupIndex值.
每次达到MaxFileSize时都将重复备份进程,覆盖最早的备份文件,从而仅保留最新的备份文件.
第6章系统和性能监视37参数描述TimeZone指定日志文件中消息时间戳记的时间范围.
使用以下格式:log4j.
appender.
S1.
TimeZone=Zone其中可以将"范围"设置为GMT或当地时间.
如果设置为"当地时间",那么日志消息的时间戳记将基于运行TM1Server的机器的当地时间.
如果设置为GMT,则日志消息的时间戳记将基于格林威治标准时间.
如果将该参数设置为GMT或当地时间以外的值,或未设置该参数,则它将缺省为GMT.
File指定日志文件.
例如:log4j.
appender.
S2.
File=tm1event.
log其中,文件名为tm1event或tm1top.
log例如,要使用ops记录器生成紧急日志消息:log4j.
logger.
Event=INFO,S2log4j.
appender.
S2=org.
apache.
log4j.
SharedMemoryAppenderlog4j.
appender.
S2.
MemorySize=5MBlog4j.
appender.
S2.
MaxFileSize=100MBlog4j.
appender.
S2.
MaxBackupIndex=1log4j.
appender.
S2.
TimeZone=Locallog4j.
appender.
S2.
File=tm1event.
loglog4j.
appender.
S2.
Format=TM1EventFormat指定日志的格式.
例如:log4j.
appender.
S2.
Format=TM1Event其中,格式为TM1Event或TM1Top例如,要动态监视正在运行的线程,并将线程状态输出到tm1top.
log:log4j.
logger.
Top=INFO,S_Toplog4j.
appender.
S_Top=org.
apache.
log4j.
SharedMemoryAppenderlog4j.
appender.
S_Top.
MemorySize=5MBlog4j.
appender.
S_Top.
MaxFileSize=100MBlog4j.
appender.
S_Top.
MaxBackupIndex=20log4j.
appender.
S_Top.
File=tm1top.
loglog4j.
appender.
S_Top.
Format=TM1Top在tm1s-log.
properties中配置日志记录级别使用日志属性文件中的以下两个语句作为标准配置,以记录TM1所有区域的所有INFO级别的日志.
log4j.
rootLogger=INFO,S1log4j.
logger.
TM1=INFO使用以下格式配置特定消息级别的日志:TM1logger=Messagelevel,Appender其中:TM1记录器是您要记录的TM1子组件的名称.
请联系客户支持机构,以辅助使用TM1记录器.
消息级别是您要记录的消息严重性级别.
有效值包括:DEBUG、INFO、WARN、ERROR、FATAL或OFF,如『消息严重性级别』一节中所述.
38IBMPlanningAnalytics:TM1Operations输出器是输出目标.
将值S1用于TM1共享内存输出器,该输出器在将消息保存到文件之前将它们传输到内存.
消息级别记录方式如下:将日志设置为DEBUG将报告所有严重性级别的消息.
将日志设置为WARN,将报告WARN、ERROR和FATAL消息.
将记录设置为OFF将禁用特定TM1记录器的所有记录.
例如,要打开所有TM1子组件在DEBUG级别上的记录,请使用以下语句:log4j.
rootLogger=DEBUG,S1log4j.
logger.
TM1=DEBUGTM1AdminServer日志AdminServer日志文件包含有关客户端、AdminServer和各个TM1Server之间通信的消息.
在对将TM1传输层安全性(TLS)用于定制证书或MicrosoftWindows证书库中的证书时所遇到的连接问题进行故障诊断时,TM1AdminServer日志非常有用.
AdminServer日志中的大多数消息是在客户端和服务器的启动过程中创建的.
以下事件发生时会记录消息:TM1Server启动,并向TM1AdminServer进行注册.
TM1Client会与TM1AdminServer联系,以获取可用TM1Server的列表.
在TM1Client、TM1AdminServer和各个TM1Server之间建立了SSL安全性.
请参阅《PlanningAnalyticsLocal安装和配置》文档中的PlanningAnalyticsLocal安全性.
启用AdminServer日志记录缺省情况下,安装TM1时,会启用TM1AdminServer的日志记录.
安装会将tm1admsrv-log.
properties文件和TM1AdminServer程序文件tm1admsrv.
exe放至\bin64目录.
当TM1AdminServer启动,并在相同目录中检测到tm1admsrv-log.
properties文件时,会激活记录.
配置AdminServer日志记录TM1AdminServer日志记录的配置包含在tm1admsrv-log.
properties文件中.
此文件位于\bin64目录中.
tm1admsrv-log.
properties文件的各部分是:记录器部分配置您要记录的TM1子组件和消息严重性级别.
示例:log4j.
rootLogger=INFO*,R1log4j.
logger.
TM1=INFO*INFO是消息级别.
输出器部分示例:控制记录的输出目标.
缺省配置使用RollingFileAppender选项将消息写入tm1admsrv.
log文件.
#R1设置为RollingFileAppenderlog4j.
appender.
R1=org.
apache.
log4j.
RollingFileAppenderlog4j.
appender.
R1.
File=tm1admsrv.
log*log4j.
appender.
R1.
MaxFileSize-10MB第6章系统和性能监视39log4j.
appender.
R1.
MaxBackupIndex=2*tm1admsrv.
log是日志文件名称.
模式布局部分控制输出字段和写入日志文件的消息格式.
缺省的设置使用GMT时间参考.
示例:#R1使用PatternLayoutlog4j.
appender.
R1.
layout=org.
apache.
log4j.
PatternLayoutlog4j.
appender.
R1.
layout.
ConversionPattern=%t%p%d(%Y-%m-%d%H:%M:%S,%Q)%c%m%nlog4j.
appender.
R1.
layout.
TimeZone=GMT缺省的日志配置记录所有INFO级别的消息.
您可以通过编辑tm1admsrv-log.
properties文件中的以下两条语句来调整日志消息级别:log4j.
rootLogger=INFO,R1log4j.
logger.
TM1=INFO例如,使用DEBUG日志级别替换INFO:log4j.
rootLogger=DEBUG,R1log4j.
logger.
TM1=DEBUG注:缺省日志记录配置供日常使用,通常不需要进行调整.
如果需要配置日志属性文件以进行故障诊断,请联系客户支持机构寻求帮助.
AdminServer日志记录的消息严重性级别AdminServer日志将消息分类为三种严重性级别.
这些级别也在tm1admsrv-log.
properties文件中使用,以将日志记录配置为特定级别.
参数描述DEBUG详细的技术消息,在客户支持机构或开发工程师需要调试应用程序时,这些消息会很有用.
将日志配置为该级别后,将记录DEBUG、INFO和ERROR消息.
INFO参考消息,突出显示应用程序的进度并报告应用程序内的正常转换.
将日志配置为该级别后,将记录INFO和ERROR消息.
ERROR您应该注意的错误情况.
应采取操作来修复问题,或者将该问题报告给客户支持机构.
将日志配置为该级别后,将仅记录ERROR消息.
查看AdminServer日志文件缺省的日志记录配置将日志消息写入tm1admsrv.
log文件中.
日志文件是ASCII文本文件,可以使用任何文本编辑器(例如MicrosoftWindows记事本)打开.
过程1.
在\bin64目录中找到tm1admsrv.
log文件.
2.
使用文本编辑器(例如MicrosoftWindows记事本)打开并查看日志文件.
日志文件中的每一行均代表一条按以下格式排列的唯一消息:40IBMPlanningAnalytics:TM1Operations线程标识消息级别日期和时间子组件名称消息文本3948INFO2007-01-1919:10:22,128TM1.
Comm.
SSL连接到远程机器时出错1260DEBUG2007-01-1919:14:04,396TM1.
Server已初始化记录器3328DEBUG2007-01-1919:14:04,396TM1.
EventTimwed等待事件0043B858已成功3328DEBUG2007-01-1919:14:04,396TM1.
Event破坏事件0043B858已成功1260DEBUG2007-01-1919:14:04,396TM1.
Event信号事件0043B858已成功事务日志每个TM1数据库都会在tm1s.
log文件中记录其客户端所做的数据更改,例如对多维数据集数据的更改.
无法在数据库级别禁用此日志记录.
可以对特定多维数据集启用和禁用多维数据集日志记录.
事务日志文件可以用于审核和数据恢复.
当客户端更改多维数据集值时,TM1将在tm1s.
log文件中记录更改,该文件位于TM1Server数据目录中,例如\bin64\samples\tm1\SData\tm1s.
log.
tm1s.
log文件中记录了以下信息:进行更改的日期和时间进行更改的客户端的名称新数据是简单数据(N)还是字符串数据(S)更改前的值更改后的值进行更改的多维数据集的名称标识已更改单元格的元素请考虑以下影响事务日志记录的方案:通过在}CubeProperties多维数据集中设置LOGGING列,可以对特定多维数据集启用和禁用事务日志记录.
仅在手动用户数据输入期间,多维数据集事务通常才需要事务日志记录.
有关更多信息,请参阅第42页的『启用和禁用事务日志记录』.
可以在执行TurboIntegrator进程期间使用CubeSetLogChanges()TurboIntegrator函数来启用和禁用事务日志记录.
您可能希望在执行将大量数据装入到多维数据集的TurboIntegrator进程期间,禁用事务日志记录.
有关更多信息,请参阅CubeSetLogChanges.
考虑在执行TurboIntegrator进程期间是否需要事务日志记录.
通常,如果可以重新运行TurboIntegrator进程以将相同数据重新装入到多维数据集,那么可以在执行TurboIntegrator进程期间禁用事务日志记录.
当前事务日志文件名为tm1s.
log.
tm1s.
log文件由TM1数据库锁定,无法使用文本编辑器来查看或编辑.
在SaveDataAll(SaveDataAll在关闭或重新启动时自动执行)期间,当前的事务日志文件会重命名为tm1s.
log.
在TM1数据库启动时,以及在没有重新启动TM1数据库的情况下执行SaveDataAll期间,将生成空的tm1s.
log文件.
有关更多信息,请参阅SaveDataAll.
事务日志文件不是由TM1数据库管理的,因为这些日志文件包含对可能是复查所必需的数据所做更改的记录.
事务日志文件可能会变得很大.
请考虑保留历史事务日志文件的时间长度(历史文件会命名为tm1syyyymmddhhmmss.
rej).
此时间长度可根据存储更改的需求来确定.
如果必须永久存储历史事务日志文件,那么建议对早于特定日期的事务日志文件进行压缩,或者将这些文件移至存储解决方案.
可以在文本编辑器中打开和检查历史事务日志文件.
建议使用可以打开大文件的文本编辑器.
第6章系统和性能监视41如果有意关闭服务器而不保存更改,那么日志文件保存时会加上时间戳记,且扩展名更改为.
rej.
可以通过TurboIntegrator处理tm1s.
log文件以恢复事务.
在不正确的服务器关闭期间,tm1s.
log会保持原样,不会在关闭期间加上时间戳记.
服务器重新启动时,会识别到存在旧的tm1s.
log文件,并提示您选择是使用新日志还是从旧的现有日志恢复.
如果您的响应是恢复,那么服务器将搜索同一文件(tm1s.
log)的末尾并在其中继续进行日志记录;但是,如果您的响应是拒绝,那么服务器会创建tm1s.
rej文件并开始记录到新的tm1s.
log.
日志文件是用逗号分隔的ASCII文件,如下例所示:"19980602212741","19980602212741","Admin","N","380.
","250.
","salescube","Budget","Belgium","LSeries1.
6LSedan","Units","Jun","""19980602212744","19980602212744","Admin","N","430.
","600.
","salescube","Budget","Belgium","LSeries1.
6LSedan","Units","Sep","""19980602212749","19980602212749","Admin","N","610.
","800.
","salescube","Budget","Belgium","LSeries1.
6LSedan","Units","Oct",""有关更多信息,另请参阅TM1Server概述.
启用和禁用事务日志记录默认情况下,TM1将事务记录到服务器上装入的所有多维数据集.
作为系统管理员,您可以选择关闭特定多维数据集的日志记录.
禁用日志记录时,TM1会加速更新数据,但是您无法在系统发生故障时恢复更新.
过程1.
打开服务器资源管理器.
2.
选择正在使用的服务器的多维数据集图标.
3.
选择多维数据集>安全性分配.
"TM1安全性分配"对话框将打开.
4.
单击"日志"列和多维数据集名称交叉处的单元格.
TM1在复选框包含X时启用日志记录,在复选框为空时禁用日志记录.
5.
单击确定.
查看事务日志可以查询事务日志(tm1s.
log)以查看当前位于TM1Server数据目录中的所有日志的记录.
查询事务日志时,TM1会将所有日志文件合并到一个满足查询参数的逻辑文件中.
例如,如果查询从格林威治标准时间2002年1月2日下午2:30起的所有记录,那么TM1将返回具有时间戳记20020102143000或更近时间戳记的所有事务日志中的所有记录.
过程1.
在服务器资源管理器中选择服务器.
2.
单击服务器>查看事务日志.
将打开"事务日志查询"对话框.
3.
单击参数字段中的右箭头以设置用于查询的参数.
您可以设置四个参数:参数描述开始时间查询在开始时间或此时间之后写入事务日志的所有记录.
查询的开始日期和时间.
日期和时间格式为MM/DD/YYYYHH:MM:SSGMT.
缺省开始日期和时间是启动查询日的00:01:00GMT.
结束时间查询的结束日期和时间.
日期和时间格式为MM/DD/YYYYHH:MM:SS缺省为这是开放的结束日期和时间.
如果您接受缺省值,那么TM1将查询直到启动查询时间为止的所有记录.
42IBMPlanningAnalytics:TM1Operations参数描述客户端对其进行查询的客户端.
可以查询单个客户端或所有客户端.
缺省值为所有客户端(*).
多维数据集对其进行查询的多维数据集.
可以查询单个多维数据集或所有多维数据集.
缺省为所有多维数据集(*).
4.
单击确定.
查询将返回一个表,其中包含满足所设置参数的所有事务记录.
该表显示在"事务日志查询结果"对话框中.
缺省情况下,记录按照LOGTIME升序排序.
5.
要对其他列进行排序,请单击列标题.
要更改列排序的顺序,请再次单击列标题.
6.
单击编辑>查找以在查询结果表中搜索记录.
设置搜索锁定限制当事务日志进行搜索时,其他用户会被锁定而不可在日志上执行活动.
缺省情况下,日志会搜索5000行,然后临时释放锁定,以便其他用户可访问日志.
可以使用tm1s.
cfg文件中设置的LogReleaseLineCount参数更改在临时释放锁定之前搜索的行数.
有关更多信息,请参阅《PlanningAnalytics安装和配置》文档中tm1s.
cfg文件中的参数.
数据备份和恢复正常关闭服务器时,TM1将通过在日志文件后面附加时间戳记来重命名该文件,并使用以下命名约定:tm1syyyymmddhhmmss.
log.
在TM1Server运行期间,tm1s.
log文件会保持打开状态.
时间戳记yyyymmddhhmmss代表关闭服务器时的当前格林威治标准时间.
例如,如果服务器在2002年1月2日下午2:30关闭,那么日志文件名为tm1s20020102143000.
log.
当服务器异常关闭时,TM1将自动恢复数据,并将tm1s.
log文件保留在磁盘上.
下次启动服务器时,TM1可使用以下两种方式的任意一种来恢复更改:自动恢复更改-将TM1Server作为MicrosoftWindows服务运行时,使用此方式提示恢复更改-将TM1Server作为应用程序运行时,使用此方式如果您故意关闭TM1Server而不保存数据,那么TM1将保存带有时间戳记的事务日志并将文件扩展名更改为.
rej.
例如,tm1s20020102143000.
rej.
.
rej日志文件可确保您总是拥有数据事务的记录(即使在未保存数据的情况下关闭了服务器).
如果您意外关闭了服务器而未保存更改,则可以通过TurboIntegrator处理.
rej文件以恢复数据.
使用事务日志恢复事务在查询事务日志后,您可以使用"事务日志查询结果"对话框恢复事务.
当您恢复事务时,OLDVALUE列中的值将替换NEWVALUE列中的值.
过程1.
突出显示要恢复的一个或多个事务.
要突出显示单个事务,请单击该事务.
要突出显示多个相邻的事务,请单击第一个事务,然后按住Shift键并单击最后一个事务.
要突出显示多个不相邻的事务,请按住Ctrl键并单击每个事务.
2.
依次单击编辑、选择.
现在,所有突出显示的事务都在与第一列旁边的框中显示一个复选标记.
复选标记指示这是选中要恢复的事务.
要在事先没有突出显示事务的情况下选中全部事务,请依次单击编辑、全选.
3.
依次单击编辑、恢复.
第6章系统和性能监视43TM1会采用与LOGTIME列所标识的时间顺序相反的顺序恢复事务.
从磁盘移除事务日志文件服务器已运行一段时间后,TM1日志文件会占用大量的磁盘空间.
您应该根据更改量和磁盘大小,经常移除磁盘上的旧日志文件.
您可以在清除这些文件之前对其进行备份.
请勿在TM1Server运行时移除日志文件.
首先关闭该服务器,然后再删除磁盘上的日志文件.
故障诊断:从已被破坏的事务日志文件恢复在某些情况下,由于服务器崩溃或断电而引起的TM1Server意外关闭或不完整的关闭,可能导致事务日志文件被破坏.
如果出现这种情况,服务器将无法重新启动.
在这种情况下,您需要对导致关闭的原因进行故障诊断,验证事务日志文件是否已被破坏,移除日志文件并联系客户支持寻求帮助.
确定事务日志文件是否已被破坏TM1Server在意外关闭后重新启动时,将尝试从事务日志文件tm1s.
log恢复数据.
如果TM1检测到日志文件已被破坏,那么服务器不会启动,并且会通过直观提示或记录的消息向您通知该情况.
具体的消息类型取决于您运行TM1Server的方式:在UNIX系统上运行或作为MicrosoftWindows服务运行.
作为MicrosoftWindows应用程序运行.
解决已被破坏的事务日志文件要解决此问题,请将事务日志文件tm1s.
log从TM1Server数据目录移动到系统上的临时位置.
现在,您可以成功重新启动服务器,但是您还可以联系客户支持寻求帮助以解决意外关闭的原因.
在UNIX系统上或作为MicrosoftWindows服务运行的TM1Server如果您在UNIX系统上或作为MicrosoftWindows服务运行TM1Server,那么在尝试重新启动服务器时,TM1会取消自动恢复,并将警告消息写入TM1Server消息日志tm1server.
log中.
此消息指示事务日志已被破坏.
下表显示TM1Server消息日志中指示被破坏的事务文件的消息示例和警告消息.
线程标识消息级别日期和时间子组件名称消息文本4076FATAL2007-10-3018:20:10,203TM1.
Server错误事务日志记录:828.
7.
.
.
4076FATAL2007-10-3018:20:14,921TM1.
Server服务器已终止作为MicrosoftWindows应用程序运行的TM1Server如果将TM1Server作为Windows应用程序运行,那么当服务器重新启动时,TM1会首先提示您恢复更改.
如果选择否,服务器将继续运行,但是导致意外关闭的问题仍可能存在.
如果选择是,那么TM1会显示警告消息,并且还会向TM1Server消息日志写入消息.
选择确定以关闭TM1Server.
消息日志TM1Server在tm1server.
log文件中记录有关服务器活动的状态消息.
这些消息包含有关活动的详细信息,例如执行的进程、杂项、装入的多维数据集和维度以及同步复制.
TM1Server消息日志记录系统旨在最大限度减少对性能的影响,同时允许加强控制日志记录所产生数据的数量和焦点.
日志系统包括以下组件:44IBMPlanningAnalytics:TM1Operations消息严重性级别-按严重性对消息进行分类和报告的类别:DEBUG、INFO、WARN、ERROR和FATAL.
TM1记录器-这些参数加强控制针对TM1特定区域或子组件的选择性日志记录.
日志记录属性文件-一个基于文本的文件,它使您能够为特定TM1Server配置和启用日志记录.
消息日志查看器-用于在服务器资源管理器和Architect中查看消息日志的工具.
注:日志消息仅以英文显示.
TM1数据库会自动管理消息日志.
缺省情况下,最大日志文件大小为100MB.
日志文件增长到大于100MB时,TM1数据库会自动对其进行转存.
tm1server.
log文件会重命名为tm1server.
log.
1,然后创建空的tm1server.
log文件.
缺省情况下,TM1数据库会保留最多20个TM1数据库消息日志文件(tm1server.
log、tm1server.
log.
1、.
.
.
tm1server.
log.
19).
最大日志文件大小和最大历史文件数基于tm1s-log.
properties文件中的配置设置.
配置消息日志记录使用日志属性文件tm1s-log.
properties的副本,以配置和启用特定TM1Server的消息记录.
有关更多信息,请参阅第35页的『日志记录属性文件』.
消息严重性级别日志系统将消息分类为多种严重性级别.
参数描述DEBUG详细的技术消息,在客户支持机构或工程师需要调试应用程序时很有用.
示例:"SSL连接已打开"、"正在删除内存中的SQL连接"INFO参考消息,突出显示应用程序的进度并报告应用程序内的正常转换.
示例:"服务器已准备就绪"、"正在装入维度.
.
.
"WARN您应该注意的潜在危害情况.
可能需要采取措施,但并不中断服务器运行.
示例:"尝试添加超出组创建限制的新组"ERROR您应该注意的错误情况.
应采取操作来修复问题,或者将该问题报告给客户支持机构.
错误可能很严重以至于导致服务器关闭,也可能导致当前客户端请求被取消.
示例:"连接到远程计算机时出错"、"无法创建多维数据集"FATAL非常严重的错误事件,很可能导致服务器关闭或当前客户端请求被取消.
您应该立即采取措施修正此问题,并向客户支持机构报告此事件.
查看TM1Server消息日志要查看TM1Server已记录的消息列表,请完成以下步骤.
过程1.
在服务器资源管理器中选择服务器.
2.
依次单击服务器、查看消息日志.
将打开"消息日志"窗口.
下表定义了消息日志字段.
第6章系统和性能监视45消息字段描述线程标识生成日志记录事件的TM1Server中的线程标识号.
示例:2488消息级别报告的消息的严重性级别:DEBUG、INFO、WARN、ERROR或FATAL.
日期和时间记录消息时的日期和时间,基于日志属性文件中的TimeZone参数设置.
日期和时间可以记录为GMT或"当地时间".
有关更多详细信息,请参阅第37页的『在tm1s-log.
properties中配置日志记录参数』.
报告的格式为:yyyy-mm-ddhh:mm.
ss,milliseconds示例:2006-10-0216:49.
01,925TM1记录器名称生成消息或活动的TM1子组件的名称.
示例:Starttime:TueDec05200611:02:47消息文本预定义的文本消息,用于描述所报告的错误或活动.
3.
如果日志中的消息显示了执行的进程或复制的错误状况,您可以双击该消息以查看活动产生错误的详细原因.
在消息日志中搜索文本您可以在消息日志中搜索文本.
过程1.
单击编辑>查找或按Ctrl+F组合键.
将打开Find(查找)对话框.
2.
输入要查找的文本,然后单击查找下一个.
如果找到了文本,包含匹配文本的行将突出显示,并显示在"消息日志"窗口中.
从消息日志复制文本您可以从消息日志复制文本.
过程1.
选择要复制的文本行.
2.
选择编辑>复制或按Ctrl+C组合键进行复制.
当前选择的行被复制到MicrosoftWindows剪贴板中,然后可粘贴到其他应用程序中.
审核日志TM1审核日志会监视元数据的更改,例如维度、视图和子集的修改.
此日志还跟踪登录和TurboIntegrator进程执行.
当法律或法规,如Sarbanes-Oxley,需要对任务重要软件中的某些活动进行审核时,该日志可用于责任说明目的.
每个TM1Server都会维护自己单独的审计日志.
管理员可以使用服务器的审核日志回答这些问题:更改了哪个对象如何修改该对象谁作的更改46IBMPlanningAnalytics:TM1Operations何时作的更改缺省情况下,审核日志被禁用,您必须为想要监视的每台服务器手动启用该功能.
审核日志记录的开启或关闭适用于所有活动类型.
不能仅对某些活动类型启用审核日志记录.
有关更多信息,请参阅第48页的『配置审计日志记录』.
活动审核日志文件处于锁定状态,无法在文本编辑器中打开.
使用tm1s.
cfg文件中的AuditLogOn参数可启用和禁用审核日志记录.
您可以通过使用TM1服务器资源管理器中提供的"审核日志"窗口来查询和查看审核日志.
重新启动时TM1数据库会转存该日志文件.
历史审核日志文件会命名为tm1auditstore.
log.
TM1数据库不会自动管理审核日志记录.
如果已启用审核日志记录,那么应确定审核日志在日志记录目录中的保留时间.
审核日志文件可能很大.
了解审核日志事件审核日志包含主要TM1对象和系统范围活动的更改记录.
这些记录称作事件.
TM1对象事件审核日志监视TM1对象的活动.
会为所有对象记录一整套事件(例如对象已创建或对象已删除).
另外,将记录特定于每个对象的事件.
例如,进程执行事件是仅为进程对象所作的记录.
下面是受监视的对象:应用程序杂项客户端多维数据集维度元素组进程规则子集视图系统范围事件系统范围的事件包括与TM1Server直接相关的操作,例如,成功和失败的登录尝试,服务器启动和关闭以及对服务器参数的更改.
用于维度排序事件的审核日志消息对维度中的元素排序或更改其顺序时,审核日志中记录的确切消息取决于使用的排序方法:自动或手动.
自动维度排序当您为维度设置自动类型排序时,审核日志会记录有关操作的特定描述消息.
右键单击维度并选择设置元素顺序,然后使用维度元素排序对话框执行自动排序.
例如,针对account维度的自动排序更改,将在审核日志中报告以下消息:"136","account","DESCENDING","DimensionSortElementsSensepropertysetforDimension'account':DESCENDING""审核日志"窗口将显示以下消息:维度"account"的SortElementsSense属性设置为"DESCENDING".
手动维度排序使用维度编辑器在手动方式下编辑维度顺序时,审核日志仅记录常规消息.
手动方式包括手动更改元素顺序,或在维度编辑器中在"编辑"菜单中选择"排序",然后单击"设置维度顺序"按钮,最后保存维度.
第6章系统和性能监视47例如,针对account维度的手动排序更改,将在审核日志中报告以下常规消息:21,account,Dimensionupdated:account"审核日志"窗口将显示以下消息:维度"account"已更新.
配置审计日志记录缺省情况下,审核日志被禁用.
您必须使用TM1Server配置文件(tm1s.
cfg)中的审核日志参数手动配置审核日志记录.
要启用特定TM1Server的审核日志,请完成以下步骤.
过程1.
打开该服务器的tm1s.
cfg文件.
2.
在tm1s.
cfg文件中设置以下参数:AuditLogOn=TAuditLogUpdateInterval=603.
重新启动服务器.
注:更改AuditLogOn参数的值之后,必须重新启动TM1Server才能应用新值.
有关tm1s.
cfg文件和审核日志参数的更多详细信息,请参阅《PlanningAnalytics安装和配置》文档中的tm1s.
cfg文件中的参数.
更新审核日志最新事件当启用审核日志时,TM1会在后台运行日志记录,并按照设置的时间间隔自动更新审核日志.
时间间隔由tm1s.
cfg文件里的AuditLogUpdateInterval参数决定.
您可以通过在TM1服务器资源管理器中使用"进程审核日志事件"命令,随时手动更新审核日志.
此行为用最新事件更新审核日志,尤其适合于刚打开AuditLog(审核日志)窗口运行查询的时候.
过程1.
在服务器资源管理器中选择TM1Server.
2.
单击服务器>进程审核日志事件.
3.
单击是确认更新进程.
现在,审核日志包含了最新审核事件记录.
使用审核日志窗口来查看日志消息可以通过TM1服务器资源管理器中提供的"审核日志"窗口来访问审核日志的内容.
通过审核日志窗口查询审核日志和浏览查询检索到的审核日志事件消息.
审核日志窗口包含以下两个主要的面板:"查询面板"-使用查询面板创建查询以查询某个特定时间段或事件类型的审核日志.
"结果面板"-使用结果面板查看和浏览通过查询检索到的记录.
打开"审核日志"窗口可以打开"审核日志"窗口.
过程1.
在服务器资源管理器中选择TM1Server.
2.
依次单击服务器、查看审核日志.
将打开"审核日志"窗口.
48IBMPlanningAnalytics:TM1Operations然后,可以选择所需要的查询参数,并单击运行查询按钮以检索查询记录.
创建和运行查询在"审核日志"窗口的"查询"面板中使用搜索参数可缩小搜索范围.
过程1.
设置日期和时间选项.
选项包括预定义的时间周期(含今天),最近10天,30天,60天和90天.
如果您正在寻找特定事件间隔的事件,那么从时间段下拉框选择定制时间段.
输入开始和结束时间.
2.
设置事件所有者选项.
此选项将询问问题"谁引起此事件".
这可以是实际TM1用户或计划的杂项.
单击全部,以搜索由任何用户或任何计划的杂项引起的事件.
单击客户端,以搜索只由用户引起的事件.
单击计划的杂项,以搜索只由计划的杂项引起的事件.
要选择特定用户或计划的杂项,请单击相关字段旁边的"选择"按钮.
将打开选择客户端或选择杂项对话框.
要选择单个用户或杂项,单击该项目即可.
要选择相邻范围内的多个用户或杂项名称,单击该范围中的第一个项目,然后按住Shift键并单击该范围中的最后一个项目即可.
要选择多个不相邻的用户或杂项名称,按住Ctrl键并单击各个项目即可.
3.
设置事件类型选项.
使用此选项,以选择您要搜索的确切事件类型.
例如,"查找失败的登录尝试"或"查找维度删除事件".
单击全部搜索两种类型审核事件:系统范围事件和对象相关事件.
单击系统范围只搜索系统范围的审核事件.
要搜索特定的系统范围事件,从事件列表中选择该事件.
缺省设置*搜索所有系统范围事件.
单击对象,以搜索只与TM1对象相关的事件.
对象选项具有以下分选项:设置对象类型选项,以将查询限制为仅特定类型的TM1对象.
例如,仅与维度相关的事件.
设置对象名称以查找特定对象名称的事件.
设置事件选项以查询特定对象事件.
事件列表根据对象类型下拉框中所选择的对象类型的变化而变化.
单击对象名称字段旁边的"选择对象名称"按钮,以显示可在其中按名称选择对象的对话框.
要选择单个对象名称,单击该项目即可.
要选择相邻范围内的多个对象名称,单击该范围中的第一个项目,然后按住Shift键并单击该范围中的最后一个项目即可.
要选择多个不相邻的对象名称,按住Ctrl键并单击各个项目即可.
第6章系统和性能监视49注:将"对象类型"设置为元素时,"选择对象名称"按钮由于元素列表太大无法显示而变为禁用状态.
如果要搜索与特定元素相关的事件,必须按照以下格式手动输入元素名称:DimensionName:ElementName例如:区域:意大利4.
单击运行查询按钮.
查询检索结果显示在结果面板网格中.
查看结果结果面板网格将查询审核日志记录整理到以下列中.
消息字段描述日期事件的日期和时间.
用户导致触发事件的TM1客户端(用户)或计划的杂项.
事件类型/描述事件简要描述.
对象类型与事件关联的TM1对象类型.
对象名称与事件关联的TM1对象的名称.
详细信息显示图标以表明指定事件的详细信息存在.
如果存在事件的详细信息,那么您可通过单击该记录的详细信息来查看详细信息.
用户可通过单击栏标题对栏的网格中的结果进行升序或降序排列.
查看事件详细信息有些事件已存储其他信息作为事件详细信息.
如果事件具有详细信息,那么在该事件的"详细信息"列中将显示"详细信息"图标.
要浏览事件的详细信息,请单击该事件的"详细信息"图标.
事件详细信息显示在"审核日志详细信息"窗口,独立于主要"审核日志"窗口.
可一次打开多个"审核日志详细信息"窗口并进行并排比较.
将数据复制到Windows剪贴板可以将事件数据从网格中复制到Windows剪贴板上.
可在"审核日志"和"审核日志详细信息"窗口中使用复制功能.
过程要复制事件数据,请突出显示"结果"网格中的单个单元格,然后单击"结果"工具栏上的复制按钮.
使用查找功能"结果"面板包含"查找"工具,用来搜索"结果"网格中的指定文本.
过程1.
单击"结果"工具栏中的查找.
"查找"对话框随即出现.
50IBMPlanningAnalytics:TM1Operations2.
输入要查找的文本3.
单击查找下一个.
如果找到文本,将在结果网格中突出显示包含匹配文本的单元格.
导出结果"结果"面板也包括导出选项,用来导出XML、逗号分隔和标签分割文件格式的结果.
可在AuditLog(审核日志)和AuditLogDetails(审核日志详细信息)窗口中使用导出功能.
过程1.
单击"结果"工具栏中的导出.
将打开"另存为"对话框.
2.
输入文件名称和位置.
3.
使用保存类型选项选择文件格式.
XML(*.
xml)CSV(逗号分隔)(*.
csv)文本(标签分割)(*.
txt)4.
单击保存.
ops记录器已在V2.
0.
3中添加TM1Server使用监视代码来生成紧急性质的日志消息,这些消息将推送到ops.
logger.
推送到此记录器的紧急事件包括以下事件:线程及其状态相关线程状态高争用池内存大小杂项故障事件日志记录是使用tm1s.
cfg文件中的EventLogging配置参数启用的.
启用了事件日志记录,但未定义事件记录器时,TM1Server会修改tm1s-logs.
properties文件以添加事件记录器的定义.
以下属性将添加到tm1s-log.
properties文件中:log4j.
logger.
Event=INFO,S2log4j.
appender.
S2=org.
apache.
log4j.
SharedMemoryAppenderlog4j.
appender.
S2.
MemorySize=5MBlog4j.
appender.
S2.
MaxFileSize=100MBlog4j.
appender.
S2.
MaxBackupIndex=1log4j.
appender.
S2.
TimeZone=Locallog4j.
appender.
S2.
File=tm1event.
loglog4j.
appender.
S2.
Format=TM1Event此外,以下设置将添加到tm1s.
cfg文件中:EventLogging=TEventScanFrequency=1EventThreshold.
PooledMemoryInMB=0EventThreshold.
ThreadBlockingNumber=5EventThreshold.
ThreadRunningTime=600EventThreshold.
ThreadWaitingTime=20这些设置如下进行定义:EventScanFrequency指定检查线程集合的周期,其中1是最小数字,0表示禁用扫描.
第6章系统和性能监视51EventThreshold.
PooledMemoryInMB指定针对服务器的池式内存超过特定值这一事件打印消息的阈值.
EventThreshold.
ThreadBlockingNumber=5指示线程阻塞至少五个其他线程时打印警告.
EventThreshold.
ThreadRunningTime=600指示线程持续运行600秒时打印警告.
EventThreshold.
ThreadWaitingTime=20指示某个线程被其他线程阻塞20秒时打印警告.
有关更多信息,请参阅tm1s.
cfg文件中的参数.
如果EventLogging=F,那么TM1Server不会修改tm1s-logs.
properties文件.
注:除非事件中的线程更改其状态,否则不会针对同一事件打印多个警告.
由于ops.
logger依赖于启用新的日志文件,因此会创建缺省tm1s-logs.
properties文件(如果不存在).
如果tm1s-logs.
properties文件存在,那么会附加新条目,并将旧条目作为副本进行备份.
注:缺省文件大小为100MB.
达到限制时,将使用新数据覆盖该文件.
TM1Top日志已在V2.
0.
7中添加TM1Server动态监视正在运行的线程,并且使用Top记录器将线程状态输出到tm1top.
log文件.
您还可以针对特定数据库记录有关沙箱和作业队列的信息.
您可以在IBMPlanningAnalyticsLocalonCloud和IBMPlanningAnalytics中使用Top记录器.
您可以从IBMPlanningAnalytics管理下载日志.
有关更多信息,请参阅下载数据库日志文件.
注:tm1top.
log文件的内容与TM1Top日志相同.
在PlanningAnalyticsLocal上,TM1Top实用程序安排为不推荐使用.
配置tm1s.
cfg参数默认情况下,Top记录器为Off.
要启用日志记录,必须先将TopLogging=T添加到tm1s.
cfg文件,然后再启动TM1Server.
注:无法在PlanningAnalytics管理中配置此参数.
可在tm1s.
cfg文件中配置以下设置:TopLogging启用在TM1Server实例中运行的线程的动态日志记录.
Top记录器还可针对特定数据库显示有关沙箱和作业队列的信息.
布尔值,动态默认值=FALSETopScanFrequency日志记录频率(时间间隔),以秒计.
周期越短,日志文件的大小增加速度越快.
管理TM1数据库线程日志文件与管理TM1数据库消息日志相同.
TM1模型中的并发活动量还可确定TM1数据库线程日志填充使文件大小增大的速率.
整数,动态默认值为5秒0禁用Top记录器.
TopScanMode.
Threads启用每个线程的当前处理状态的日志记录.
此信息包含启动线程的用户或进程的名称、线程正在执行的API函数、锁定的最后一个对象的锁定状态、线程使用的对象数和当前API函数或杂项进程已处理的总时间(以秒计).
默认值=T52IBMPlanningAnalytics:TM1OperationsTopScanMode.
Sandboxes针对当前服务器的活动沙箱、某个用户的所有沙箱所使用的总内存以及此用户的沙箱数量启用日志记录.
默认值=FTopScanMode.
SandboxQueueMetrics启用沙箱队列度量的日志记录.
将针对队列中的每个沙箱记录沙箱的节点名称、队列中沙箱的状态以及在处理前沙箱位于队列中的时间长度.
默认值=F有关更多信息,请参阅tm1s.
cfg文件中的参数.
如果TM1Server在开启TopLogging的情况下启动,那么在尚无配置时,服务器将Top记录器配置添加到tm1s-log.
properties文件.
日志级别为INFO.
特殊日志格式由定义的格式参数控制,此参数必须设置为TM1Top.
添加以下配置信息:log4j.
logger.
Top=INFO,S_Toplog4j.
appender.
S_Top=org.
apache.
log4j.
SharedMemoryAppenderlog4j.
appender.
S_Top.
MemorySize=5MBlog4j.
appender.
S_Top.
MaxFileSize=100MBlog4j.
appender.
S_Top.
MaxBackupIndex=20log4j.
appender.
S_Top.
File=tm1top.
loglog4j.
appender.
S_Top.
Format=TM1Top在启用Top记录器并且将配置设置添加到tm1s-log.
properties后,您可以禁用或启用Top记录器,而不重新启动TM1Server.
TM1RESTAPI支持可使用TMIRESTAPI读取和修改Top记录器及其设置:GET/api/v1/ActiveConfiguration/Administration/TopLogPATCH/api/v1/StaticConfiguration/Administration/TopLog{"ScanFrequency":"P0DT00H00M02S"}GET/api/v1/Loggers('Top')PATCH/api/v1/Loggers('Top'){"Level":"Off"}有关更多信息,请参阅TopLogSettings和TopScanMode.
日志示例=====2019-01-0922:20:54GMT2019-01-0917:20:54local=====Server:PlanningSample10744Th:Pseudo-Idle----022584Th:DynamicConfig-Idle----0676Admin:1Idle----04920SaArchitectIdle----0=====2019-01-0922:20:56GMT2019-01-0917:20:56local=====Server:PlanningSample8120C:SleepEvery10s-Run:R-ProcessSyncSleep_10Prolog(6)010744Th:Pseudo-Idle----022584Th:DynamicConfig-Idle----0676Admin:1Run:R-POST/api/v1/Cubes('plan_BudgetPlan')/Views('def')/tm1.
Execute-122620>Workunitfor676---第6章系统和性能监视53--03284>Workunitfor676-----022376>Workunitfor676-----017568>Workunitfor676-----02940>Workunitfor676-----0128>Workunitfor676-----020552>Workunitfor676-----04920SaArchitectIdle----0TM1.
Mdx.
Interface记录器已在V2.
0.
7中添加TM1.
Mdx.
Interface记录器在设置为DEBUG级别时报告语法错误.
在IBMPlanningAnalyticsV2.
0.
6或更低版本中,TM1.
Mdx.
Interface记录器在设置为ERROR级别时报告语法错误.
但是,当PlanningAnalyticsforMicrosoftExcel或PlanningAnalyticsWorkspace在内部生成无效MDX时,将用以下格式的大量条目快速填满tm1server日志:11276[6b5]ERROR2017-10-1613:51:10.
237TM1.
Mdx.
InterfaceSyntaxerroratornear:'hildren},{[Entity]characterposition21现在,仅在日志记录级别设置为DEBUG时才显示这些错误.
搜索大型事务日志已在V2.
0.
7中添加如果存在太多无效记录,例如,事务日志的一次搜索中有超过500条无效记录,那么搜索将停止,并会在服务器日志中生成错误消息.
需要用户干预以清除事务日志.
此更改避免服务器长时间执行搜索并阻止其他活动.
例如,错误消息包含以下文本:Startsfrom,over500badtransactionrecordsfound,transactionlogsearchingstopped.
错误消息指示启动搜索的位置.
例如,如果用户搜索12月1日到12月12日,那么服务器搜索多个日志文件.
"Startsfrom"指示事务日志中清除必须开始的位置.
搜索大型事务日志的此行为更改阻止TM1Server生成大型日志.
但是,如果日志变为过大,那么需要用户干预以清除无效记录.
已在V2.
0.
9中更改此行为在IBMPlanningAnalyticsV2.
0.
9中已更改.
缺省行为是搜索所有日志.
您可以配置在搜索停止之前允许的无效日志数的限制.
此配置参数是专用的.
请联系支持人员以了解更多信息.
控件多维数据集控制多维数据集存储客户端、多维数据集和服务器的每分钟性能统计信息.
此性能数据在以下TM1控件多维数据集内进行跟踪和存储:}StatsByClient、}StatsByCube、}StatsByCubeByClient和}StatsForServer.
当启用性能监视时,TM1将每分钟填充数个控件多维数据集.
然后,可以浏览这些多维数据集来分析服务器性能.
在性能监视期间将填充以下控件多维数据集.
有关更多信息,请参阅第111页的『附录B控件多维数据集』.
控件多维数据集名称描述}StatsByClient跟踪服务器上每个客户端的消息计数、平均消息大小、总耗用时间及其他度量.
}StatsByCube跟踪服务器上用于每个多维数据集的内存.
54IBMPlanningAnalytics:TM1Operations控件多维数据集名称描述}StatsByCubeByClient跟踪服务器上每个客户端和多维数据集的单元格更新数目和耗用时间、单元格检索、视图计算和视图检索.
}StatsForServer跟踪连接的客户端、活动的线程以及服务器使用的内存.
启用性能监视可以在服务器会话期间启用性能监视.
过程1.
在服务器资源管理器中选择服务器.
2.
依次单击服务器、启动性能监视器.
结果已在每个会话的基础上启用性能监视.
如果要在每个服务器会话启动时启用性能监视,可以在Tm1s.
cfg文件中设置PerformanceMonitorOn参数以在服务器启动时自动开始性能监视.
禁用性能监视可以在服务器会话期间结束性能监视.
过程1.
在服务器资源管理器中选择服务器.
2.
依次单击服务器、停止性能监视器.
查看客户端、多维数据集和服务器的性能统计信息启用性能监视后,可以查看状态.
过程1.
在服务器资源管理器中,依次单击视图、显示控件对象.
现在,将显示所有控件多维数据集,包括性能监视控件多维数据集.
2.
打开任一性能监视控件多维数据集以查看多维数据集.
可用的控件多维数据集包括:StatsByClientStatsByCubeStatsByCubeByClientStatsForServer有关更多信息,请参阅第111页的『附录B控件多维数据集』和第123页的『附录C控制维度』.
注:性能监视器不会更新以反映在它运行时创建的任何新多维数据集或添加的任何新用户.
重新启动性能监视器,使用所添加的项目更新它.
TM1性能计数器TM1性能计数器是连续更新值的集合,提供对特定TM1Server属性和活动(例如,多维数据集、视图、子集、维度的使用和读/写活动)的实时监视.
可使用MicrosoftWindows性能监视器以图形格式或使用TM1PerfMon实用程序以纯文本格式查看性能计数器.
第6章系统和性能监视55这些值可实时增大和减小,以跟踪特定TM1属性和多维数据集、视图、子集、维度以及读/写活动的活动.
可以使用以下工具查看性能计数器:TM1PerfMon实用程序-TM1性能计数器的纯文本显示,在MicrosoftWindows和UNIX系统上的控制台窗口中运行.
TM1PerfMon实用程序只能监视本地TM1Server.
MicrosoftWindows性能监视器-一种MicrosoftWindows工具,提供TM1性能计数器的交互式图形显示,以监视本地和远程WindowsTM1Server.
要点:要在MicrosoftWindows系统上运行TM1PerfMon,您需要具有与运行MicrosoftWindows性能监视器相同的管理员权限.
用户必须是本地管理员组的成员才能运行TM1PerfMon或MicrosoftWindows性能监视器.
用户必须同时是本地和远程系统上的管理员组的成员,才能使用MicrosoftWindows性能监视器来监视远程TM1Server.
64位IntelItaniumII系统不支持使用MicrosoftWindows性能监视器来查看TM1性能计数器.
使用此配置运行TM1时,请使用TM1PerfMon控制台实用程序来查看TM1性能计数器.
可用的TM1性能计数器TM1提供30多种性能计数器的集合,组成若干组,例如"多维数据集"、"维度"、"子集"、"内存"、"线程"和"视图".
TM1性能计数器的示例包括:创建的线程创建和破坏的视图和维度创建的、复制的、破坏的和删除的子集读取锁定请求和等待使用TM1PerfMon实用程序查看TM1性能计数器TM1PerfMon是MicrosoftWindows和UNIX系统的控制台实用程序,可提供TM1性能计数器的文本显示.
运行TM1PerfMon从MicrosoftWindows或UNIX系统的命令行中运行tm1perfmon.
exe文件.
使用以下格式和参数:tm1perfmon-servernameName-loopLoopCount-sleepSleepTime其中:Name是要监视的TM1Server的名称.
当服务器名称包含空格时,请使用引号.
例如:-servername"planningsample"LoopCount是重复或刷新计数器值显示的次数.
缺省值为1,不循环.
该值是可选的.
值为0会导致TM1PerfMon无限循环.
要在循环时取消TM1PerfMon,请按Ctrl+Break键返回到命令提示符.
SleepTime是循环之间的时间(以秒为单位).
缺省值为5秒.
该值是可选的.
例如,以下命令行将持续运行TM1PerfMon,以监视名为planningsample的TM1Server.
显示内容将保持每5秒(使用sleep选项的缺省值)刷新一次,直到您按Ctrl+Break组合键退出.
tm1perfmon-servername"planningsample"-loop056IBMPlanningAnalytics:TM1Operations以下命令行将运行TM1PerfMon以监视salesdataTM1Server,共循环10次,更新显示之间的刷新率为5秒.
tm1perfmon-servernamesalesdata-loop10-sleep5如果不包括loop和sleep选项的值(如以下示例中所示),那么TM1PerfMon将只运行并显示TM1性能计数器一次.
tm1perfmon-servernamesalesdata注:通过在tm1s.
cfg文件中设置PerfMonIsActive,可以为TM1Server打开或关闭性能计数器的更新.
请参阅PerfMonIsActive.
可以在TM1PerfMon仍执行循环时退出该实用程序.
随时按Ctrl+Break键.
查看TM1PerfMon显示输出可以查看TM1PerfMon的显示输出.
该显示输出看起来类似于以下内容:C:\>tm1perfmon-servercdataTM1版本:9.
0.
3.
226输出日期和时间:星期二(2006年12月5日)17:36:42计数器名称/值线程:创建的线程数6线程:线程创建重试次数0线程:线程创建失败次数0视图:创建的视图数23视图:创建的空视图数0视图:销毁的视图数0维度:创建的维度数0维度:销毁的维度数119多维数据集:失效的多维数据集数0多维数据集:失效的依赖多维数据集数1子集:创建的空子集数0子集:通过表达式计算的子集数0子集:使用空表达式计算的子集数0子集:通过表达式计算的子集数0子集:通过表达式创建的子集数0子集:通过MDX表达式创建的子集数0子集:重复的子集数0子集:销毁的子集数0子集:删除的子集数0此显示中的标题字段包括:字段描述计数器名称每个TM1性能计数器的组名称和计数器名称.
显示的格式为:GroupName:CounterName例如:Threads:ThreadsCreated值TM1性能计数器在特定输出日期和时间的数值.
使用MicrosoftWindows性能监视器查看性能计数器使用MicrosoftWindows性能监视器以仅适用于WindowsTM1Server的图形显示方式来查看TM1性能计数器.
MicrosoftWindows性能监视器随当前版本的MicrosoftWindows提供,并作为Microsoft管理控制台的加载项运行.
打开MicrosoftWindows性能监视器可以打开MicrosoftWindows性能监视器.
过程依次单击开始、设置、控制面板、管理工具、性能.
将打开MicrosoftWindows性能监视器.
在MicrosoftWindows性能监视器中添加和查看TM1性能计数器您可以通过在MicrosoftWindows性能监视器中使用"添加计数器"对话框来添加TM1性能计数器,从而查看这些性能计数器.
在该对话框中,还可以查看每个计数器的简短说明.
在该对话框中,还可以查看每个计数器的简短说明.
第6章系统和性能监视57过程1.
在"性能监视器"工具栏中单击添加.
将显示"添加计数器"对话框.
注:打开或关闭"添加计数器"对话框时,MicrosoftWindows有时会显示以下消息.
"至少有一个数据示例丢失.
数据收集所使用时间长于预期.
您可以通过增加示例时间间隔来避免此消息.
在此会话期间此消息将不再显示.
"此消息仅供参考,如果在添加新计数器时系统变得太忙,通常会显示.
单击确定以清除该消息.
2.
从"性能对象"列表中选择IBMCognosTM1.
可用的性能计数器显示在性能计数器列表中.
3.
从可用的计数器列表中选择一个性能计数器.
还可以单击"说明"来查看当前所选计数器的文本描述.
4.
选择要监视的服务器的实例.
5.
单击添加将所选计数器添加到性能显示中.
6.
单击关闭以关闭AddCounters(添加计数器)对话框并返回性能监视器.
"性能监视器"会将TM1性能计数器添加到监视进程并更新显示.
TM1性能计数器58IBMPlanningAnalytics:TM1Operations第7章IBMPlanningAnalytics工具和实用程序将以下工具和实用程序与IBMPlanningAnalytics配合使用.
CognosTM1OperationsConsole(在V2.
0.
9中不推荐使用)基于Web的高级图形用户界面.
请参阅第60页的『IBMCognosTM1OperationsConsole工作流』.
PerformanceManagementHub向IBMPlanningAnalyticsforMicrosoftExcel、OperationsConsole和其他TM1Client应用程序提供公共应用程序服务的服务器框架.
您可以使用Web界面设置配置选项.
请参阅第73页的『IBMCognosPerformanceManagementHub』.
tm1xfer在MicrosoftWindows和UNIX平台上,该命令行实用程序用于对TM1Server数据库文件进行压缩并将其从一个平台移至另一个平台,同时保留对象的混合大小写名称.
请参阅第86页的『tm1xfer』.
ODBC_testodbc_test工具用于诊断和测试UNIX上的TM1ODBC连接.
请参阅第92页的『odbc_test工具』.
调试工具有关专为调试TM1Server而设计的工具,请参阅第82页的『其他调试工具』.
TM1RunTI命令行界面工具,用于从任何能够发出操作系统命令的应用程序内部启动CognosTM1TurboIntegrator(TI)进程.
请参阅TM1TurboIntegrator文档中的使用TM1RunTI.
Synchronized()可在TurboIntegrator脚本中使用CognosTM1TurboIntegrator(TI)函数,以强制串行执行指定的TurboIntegrator进程集.
请参阅TM1TurboIntegrator文档中的使用synchronized()串行执行TurboIntegrator进程.
使用IBMCognosTM1OperationsConsole在V2.
0.
9中不推荐使用TM1OperationsConsole是基于Web的实用程序,用于显示并记录TM1Server活动.
可以使用TM1OperationsConsole来设置和查看日志文件.
注:在IBMPlanningAnalyticsV2.
0.
9中不推荐使用IBMTM1OperationsConsole.
您可以使用IBMPlanningAnalytics管理来监视PlanningAnalytics和PlanningAnalyticsLocal中的数据库.
要了解更多信息,请参阅监视和管理数据库.
事务日志用于跟踪由登录到一台TM1Server的客户端进行的数据事务的日志文件.
记录的信息包括进行更改的日期和时间、进行更改的客户端的名称、更改前后的值、进行更改的多维数据集的名称以及标识已更改单元格的元素.
服务器消息日志包含有关TM1Server活动详细信息(例如,执行的进程、杂项、装入的多维数据集和维度以及同步的复制)的日志文件.
审计日志监视TM1对象和系统范围事件的更改(例如,维度、视图和子集的修改以及成功/不成功的登录活动)的日志文件.
CopyrightIBMCorp.
2007,201959IBMCognosTM1OperationsConsole工作流在V2.
0.
9中不推荐使用使用此列表可识别需要在CognosTM1OperationsConsole中执行的任务以及查找更多相关信息的位置.
注:缺省情况下,安装TM1时,会安装CognosTM1OperationsConsole.
有关更多信息,请参阅CognosTM1OperationsConsoleinstallation.
缺省情况下,CognosTM1OperationsConsole配置为使用称为Admin的监视组来监视SDataTM1Server.
要更改这些缺省值,请使用pmhub配置.
1.
创建您的逻辑运算组.
2.
验证管理访问权(在此服务器上).
3.
出于安全目的,您可以使用第62页的『显示用户名』参数.
4.
"运行状态检查"使用图标直观显示服务器的当前状态.
请参阅第63页的『在CognosTM1OperationsConsole中监视』以获取列表.
5.
要使用服务器配置参数的缺省设置,请跳转至下一步.
如果想要更改基本参数,请参阅配置.
6.
要获取快速状态报表,请双击服务器名称以创建新的"运行状况状态"选项卡,如第62页的『服务器运行状态』中所述.
"运行状况状态"选项卡中填充"高级"版本的状态报表.
您可以添加选项卡并通过其他类型的日志文件填充这些选项卡.
7.
单击配置方式图标,从而能够配置其他日志文件.
8.
单击服务器选择复选框.
此操作显示调度新日志按钮.
您可以向下拖动底部窗格以显示窗口的全部内容.
单击调度新日志按钮并定义新日志的参数.
9.
要查看日志,请切换至"监视"方式,然后右键单击服务器并选择查看日志.
此操作将打开一个新的"监视器"按钮,并在其中填充调度日志.
如果当前时间早于开始时间,那么不会显示任何内容.
您还可以验证管理访问权.
您可以过滤结果以提高可读性.
10.
设置完成后,即可保存和重新装入日志文件配置.
11.
您可以更改布局以适合需求.
您可以利用其他日志信息重新填充底部窗格.
12.
设置看守程序.
13.
也可在TM1OperationsConsole中监视TM1ApplicationsServer,如第66页的『监视CognosTM1ApplicationServer』中所述.
配置CognosTM1OperationsConsole在V2.
0.
9中不推荐使用缺省情况下,CognosTM1OperationsConsole配置为使用样本管理主机localhost、服务器sdata以及名为admin的组进行认证,以便您可以快速入门和熟悉运用.
如果需要,您可以编辑这些配置以定制认证服务器.
过程1.
输入http://servername:portnumber/pmhub/pm/admin以打开配置屏幕.
2.
要更改缺省管理主机、服务器和要监视的组,请展开配置>操作控制台TM1监视器.
单击各个设置以对其进行更改.
如果要将MicrosoftInternetExplorer8与CognosTM1OperationsConsole配合使用,请参阅MicrosoftInternetExplorer文档并确保以下设置:启用该选项以在每次访问时刷新Web页面禁用脚本调试选项60IBMPlanningAnalytics:TM1Operations启动并登录CognosTM1OperationsConsole在V2.
0.
9中不推荐使用要打开IBMCognosTM1OperationsConsole,请输入用于标识组件的端口和服务器名称的URL.
过程1.
在Web浏览器中,输入以下Web地址:http://servername:port_number/pmhub/pm/opsconsole其中servername是安装了CognosTM1OperationsConsole和Web应用程序服务器的计算机.
如果您当前已登录到运行CognosTM1ApplicationWeb的Web服务器,那么可使用关键字localhost.
或者,您可使用计算机名、主机名、域名或托管应用程序的Web服务器的IP地址.
port_number是运行Web应用程序服务器的端口号.
对于随CognosTM1安装提供的WebSphereLiberty版本,缺省端口号为9510.
2.
在登录页面上,输入以下字段的值,然后单击登录.
要使用缺省监视组,请输入名称空间:使用下拉列表选择可用的名称空间.
如果系统由CAM提供保护,那么名称空间则是保证TM1系统安全的CognosAnalytics名称空间.
如果系统未由CAM提供保护,那么名称空间是adminhost/tm1server(例如localhost/SData).
用户名:admin密码:apple请参阅设置CognosTM1OperationsConsole以快速入门.
设置CognosTM1OperationsConsole在V2.
0.
9中不推荐使用IBMCognosTM1OperationsConsole设置任务.
在添加生产组并且标识您希望监视的服务器后,您才可以使用TM1OperationsConsole.
TM1OperationsConsole会以监视方式打开.
您可以单击配置图标以切换到配置方式来对日志和看守程序报表进行配置.
使用监视图标以随时切换回监视方式.
添加操作组、管理主机和服务器在V2.
0.
9中不推荐使用IBMCognosTM1OperationsConsole已安装并开始运行之后,请添加操作组并标识管理主机和服务器.
例如,您可能有指定为"开发"、"生产"或"测试"的服务器组.
1.
从工具栏单击添加操作组或使用"操作"菜单来选择添加操作组.
2.
输入该组的名称.
您可以使用任意名称.
3.
单击创建.
4.
右键单击该操作组,然后选择添加管理主机.
5.
输入管理主机的标准名称.
缺省设置使用localhost.
6.
单击确定7.
右键单击所添加的管理主机,然后选择添加TM1Server.
8.
输入要监视的服务器的名称.
要使用缺省设置,请输入SData.
请参阅监视CognosTM1ApplicationsServer,以获取有关如何在TM1OperationsConsole中监视TM1ApplicationServer的详细信息.
第7章IBMPlanningAnalytics工具和实用程序61验证管理访问权在V2.
0.
9中不推荐使用在执行CognosTM1OperationsConsole中的特定功能之前,必须输入有效的管理员凭证.
过程1.
右键单击TM1Server.
2.
选择验证管理访问权.
3.
输入管理员标识的有效用户名和密码凭证.
4.
单击确定.
显示用户名在V2.
0.
9中不推荐使用MaskUserNameInServerTools参数将确定在IBMCognosTM1OperationsConsole中是显示还是遮掩用户名.
在Tm1s.
cfg中设置MaskUserNameInServerTools=TRUE后,出于安全目的,将在CognosTM1OperationsConsole中遮掩用户名.
要取消遮掩名称,管理员可以在CognosTM1OperationsConsole中右键单击服务器,然后单击验证管理访问权以验证管理员状态.
缺省情况下,此参数设置为FALSE.
如果未以显式方式将此参数设置为TRUE,那么即使在尚未验证管理员访问权限时,CognosTM1OperationsConsole也会显示用户名.
服务器运行状态在V2.
0.
9中不推荐使用"服务器运行状态"选项卡可使用图标提供由CognosTM1OperationsConsole监视的服务器的几乎即时的状态反馈.
注:在可以显示数据之前,必须验证管理访问权.
表2.
CognosTM1OperationsConsole运行状况状态图标图标状态联机.
服务器已联机.
服务器正在运行.
正在启动.
正在启动服务器正在进入批量加载模式.
服务器正在进入批量加载模式.
批量加载模式.
服务器处于批量加载模式.
脱机.
服务器已脱机/无法联系.
此服务器未运行或已无法连接到CognosTM1OperationsConsole.
正在停止.
正在停止服务器.
不受支持.
不支持脉动信号.
运行状况状态选项卡还会显示服务器中的线程数和等待授予锁定的线程数.
由于运行状况状态每10秒更新一次,因此信息为在最多10秒内反映的当前信息,这取决于自上次刷新以来服务器状态更改的时间.
如果报表包含刷新率,那么将按为该报表指定的刷新率更新数据.
62IBMPlanningAnalytics:TM1Operations在CognosTM1OperationsConsole中监视在V2.
0.
9中不推荐使用IBMCognosTM1TM1OperationsConsole中提供以下报表和日志.
要查看这些报表,请右键单击想要使用的服务器,并选择监视以及想要的报表.
在可以显示数据之前,您可能需要验证管理器访问权或者调度日志(如果未自动调度日志).
您还可以选择将日志记录至磁盘或者导出日志.
请参阅过滤以获取有关如何减少显示的详细信息.
对于其中某些报表,向下拖动底部窗格以显示完整的窗口内容.
状态"基本"或"高级"警告:在服务器负载很重的情况下使用此报表的缺省高级版本最多会降低10%的系统性能.
沙箱显示服务器沙箱中正在使用的线程.
沙箱队列显示沙箱队列中的作业.
性能统计信息显示服务器内存和性能统计信息报表.
您必须首先通过右键单击服务器名称并且选择启动性能监视器来进行性能统计信息收集,此报表才会显示信息.
进程显示任何TurboIntegrator进程中包含的线程.
杂项显示"杂项"所涉及的服务器活动.
内存使用情况图形提供服务器内存使用情况的图形显示.
线程详细信息图形提供关于服务器线程活动的图形显示.
您可以使用以下日志:事务日志文件在TM1Client更改多维数据集值时,显示Tm1s.
log中记录的事务.
消息日志在日志文件中显示关于服务器活动的TM1Server记录状态消息.
这些消息包含有关活动的详细信息,例如,已执行的进程、杂项、已装入的多维数据集和维度,以及已同步的复制.
审核日志显示元数据更改,例如,对维度、视图和子集所作的修改.
基本和高级服务器状态报表在V2.
0.
9中不推荐使用您可以查看服务器状态信息的基本和高级版本.
关于此任务双击服务器名称,或者右键单击服务器并选择监视>状态>高级或者选择基本.
警告:在服务器负载很重的情况下使用此报表的缺省高级版本最多会降低10%的系统性能.
结果报表将在新的"监视"选项卡中显示.
要减少内容,请使用过滤器按钮(请参阅第70页的『在IBMCognosTM1OperationsConsole中过滤结果』).
要将日志导出至文件,请选择将日志记录至磁盘.
第7章IBMPlanningAnalytics工具和实用程序63沙箱和沙箱队列报表在V2.
0.
9中不推荐使用沙箱活动过程双击服务器名称,或者右键单击服务器,然后选择监视>沙箱或沙箱队列.
结果报表在"监视"选项卡中显示服务器上的沙箱活动.
仅当开启且正在使用沙箱时,您才能在此看到数据.
性能统计信息报表在V2.
0.
9中不推荐使用您可以在CognosTM1OperationsConsole中监视服务器的服务器内存和性能统计信息.
过程1.
要开始收集服务器和性能统计信息,请右键单击服务器并选择启动性能监视器.
2.
要查看日志,请右键单击服务器并选择监视>性能统计信息.
"性能统计信息"报表上提供以下统计信息:用于视图的内存用于计算的内存用于数据加载程序的内存用于输入数据的内存总内存使用量另外,每个受监视服务器的"状态"选项会显示以下统计信息:MemoryUsedGarbageMemoryTurboIntegrator进程报表在V2.
0.
9中不推荐使用您可以在CognosTM1OperationsConsole中监视服务器的TurboIntegrator进程.
过程1.
如果您尚未启动性能监视,请右键单击服务器,验证管理访问权,然后右键单击该服务器并单击启动性能监视器.
如果尚未打开PerformanceMonitoring,那么将显示缺省值或从上次运行显示中获取的值.
2.
右键单击服务器并选择监视器>进程"进程"窗格上提供以下统计信息:进程名称、Current当前状态、完成状态、客户端名称、最后启动时间、最后结束时间和最后持续时间.
客户端名称包含有关与特定进程相关联的线程的信息.
客户端名称字段中的每个条目均采用"客户端标识线程标识"格式.
多个条目之间用分号隔开.
如果线程由客户端启动,那么名称包含客户端名(例如,"Admin,512"),其中admin为客户端名称,而512为相应的线程标识.
如果线程由杂项启动,那么在方括号中将显示杂项名称及其相应的线程标识.
当大量线程与某个进程相关联时,单击节点箭头将会提供类似如下的列表:完成状态:NORMAL-进程已正常执行UNKNOWN-无法捕获到进程状态REJECTED_RECORD-用户要求跳过此记录并使用ItemReject()TI函数在日志中记录错误64IBMPlanningAnalytics:TM1OperationsMINOR_ERRORS-执行完成,但发生的不严重错误数少于最大数量PROCESS_BREAK-用户执行了ProcessBreak()函数ABORTED_BY_PROCESSQUIT-执行被ProcessQuit()TI函数异常中止ABORTED_WITH_ERROR-进程已异常中止,因为发生严重错误ABORTED_ON_INIT-进程已异常中止,因为在进程启动阶段发生严重错误.
将根据在"配置"窗口中的"内存统计信息刷新率"中指定的频率来刷新"进程"窗格.
监视杂项在V2.
0.
9中不推荐使用您可以在CognosTM1OperationsConsole中监视处理的杂项过程1.
如果您尚未启动性能监视,请右键单击服务器,验证管理访问权,然后右键单击该服务器并单击启动性能监视器.
2.
要查看在服务器上运行的杂项的统计信息,请右键单击服务器并单击监视器>杂项将显示杂项的以下信息:杂项名称、完成状态、当前状态、客户端名称、最后启动时间、最后持续时间(秒)、下一次激活时间和当前进程.
内存使用情况图形在V2.
0.
9中不推荐使用以图表形式显示内存使用情况.
右键单击想要使用的服务器,并选择监视器>内存使用情况图形.
图1.
内存使用情况图形线程详细信息图形在V2.
0.
9中不推荐使用"线程详细信息图形"以图表形式显示线程信息.
右键单击想要使用的服务器,然后选择监视器>线程详细信息图形.
第7章IBMPlanningAnalytics工具和实用程序65图2.
线程详细信息图形监视CognosTM1ApplicationServer在V2.
0.
9中不推荐使用您可以监视CognosTM1ApplicationServer的服务器活动.
过程1.
要将CognosTM1ApplicationServer添加至CognosTM1OperationsConsole,请右键单击要列示该CognosTM1ApplicationServer的操作组.
2.
选择添加应用程序服务器.
3.
输入要用于标识此应用程序服务器的名称,然后单击创建.
4.
右键单击您刚才添加的名称,然后选择配置.
5.
在该对话框中填写字段:IP输入应用程序服务器的IP地址.
IP字段也可以是完全限定域名或NetBIOS名称.
上下文输入规划服务的名称,例如,pmpsvc端口号:输入在JVMforTM1中所指定的端口号.
此端口号为您在应用程序服务器JRE选项中所指定的jmx端口号.
最高刷新周期(秒)通常,刷新周期为2.
最常见容差因子(秒)除非您想要扩大容差,否则请输入0.
最常见超时(秒)通常,超时值为1.
6.
单击确定.
如果CognosTM1ApplicationsServer正在运行,那么运行状况状态将变为绿色并且活动正在被监视.
如果CognosTM1ApplicationsServer的状态不为绿色,请确保正在使用IBMCognosConfiguration来运行服务.
66IBMPlanningAnalytics:TM1Operations7.
大多数用户更愿意使用SSL来安全地监视TM1ApplicationsServer.
但是,您也可以不使用SSL来监视TM1ApplicationsServer.
这种方法安全性较差,但不需要执行第67页的『监视TM1ApplicationsServer时使用TLS』中所述的额外认证步骤.
要在不使用SSL的情况下监视TM1ApplicationServer,请修改jvm参数-Dcom.
sun.
management.
jmxremote.
ssl=true将其更改为-Dcom.
sun.
management.
jmxremote.
ssl=false8.
重新启动TM1ApplicationsServer.
监视TM1ApplicationsServer时使用TLS在V2.
0.
9中不推荐使用使用TLS时,请执行这些附加步骤来监视应用程序服务器.
为使用TLS,您需要在运行CognosTM1ApplicationServer的机器上创建安全证书,然后将该证书导出到CognosTM1OperationsConsole机器并配置CognosTM1OperationsConsole机器,以便使用这一新的证书仓库.
有关更多信息,请参阅《PlanningAnalytics本地安装和配置》中的配置TM1Server以使用自定义TLS.
使用TM1OperationsConsole的TM1ApplicationsServer的日志文件在V2.
0.
9中不推荐使用IBMCognosTM1OperationsConsole可跟踪和监视TM1ApplicationsServer中的活动.
当您为自动日志记录选择将日志记录至磁盘时,写入日志消息的速率与监视窗口中的数据刷新率相同.
利用将日志记录至磁盘进行CognosTM1ApplicationsServer监视时,新的日志内容将覆盖日志文件中较旧的监视数据.
与CognosTM1Server的配置不同,不能将日志追加用于CognosTM1ApplicationServer.
还可以调度CognosTM1ApplicationServer日志记录.
可记录两种类型的ApplicationServer数据:ApplicationServer统计信息ApplicationServer会话信息在所有监视器窗口中均提供将日志记录至磁盘选项.
单击将日志记录至磁盘以创建自动日志.
将继续记录数据,直到您通过下列方式关闭日志记录为止:取消选中将日志记录至磁盘、关闭监视器窗口或关闭CognosTM1OperationsConsole.
IBMCognosTM1OperationsConsole中的日志文件在V2.
0.
9中不推荐使用您可以计划日志,使用"将日志记录至磁盘"选项,或者启用自动日志记录.
在日志中显示任何数据之前,您必须第62页的『验证管理访问权』.
您可以使用TM1OperationsConsole访问这些TM1Server日志:事务日志文件在TM1Client更改多维数据集值时,显示Tm1s.
log中记录的事务.
消息日志在日志文件中显示关于服务器活动的TM1Server记录状态消息.
这些消息包含有关活动的详细信息,例如,已执行的进程、杂项、已装入的多维数据集和维度,以及已同步的复制.
审核日志显示元数据更改,例如,对维度、视图和子集所作的修改.
右键单击服务器并选择视图日志、消息日志、事务日志或审计日志以打开这些日志文件.
有关这些日志以及如何启用的详细信息,请参阅《TM1操作》文档的『系统和性能监视』一章.
处理日志在V2.
0.
9中不推荐使用这些主题描述可如何调整日志文件的显示.
第7章IBMPlanningAnalytics工具和实用程序67配置日志文件和服务器数字参数在V2.
0.
9中不推荐使用使用配置选项来设置数字参数,这些参数定义日志文件数字及其他服务器参数的收集方式.
对每个日志文件填写以下参数.
日志周期指定将写入日志文件的更新之间的时间间隔.
例如,如果将屏幕刷新间隔设置为2秒,则可将LogPeriod设置为10秒,从而使屏幕每显示五次便输出一次以减少写入文件的数据量.
缺省值为2秒.
日志追加缺省情况下,系统不会追加新日志文件,而是用新日志文件覆盖现有日志.
选择True以将新日志文件追加至现有日志.
刷新周期缺省情况下,日志等待2秒才能刷新数据.
可在此处输入更长或更短的刷新时间(以秒计).
容差因子缺省情况下,数据是新的(0).
为允许日志中的数据保留下来,请在此处输入数字(以秒计)来表示数据可保留多久才需要新的轮询.
超时缺省情况下,尝试连接至服务器的操作将在2秒后终止.
可更改此数目以缩短或延长放弃之前日志保持尝试的时间.
如果IBMCognosTM1OperationsConsole服务器未能在此处指定的秒数内获得updated状态,那么将发送旧数据(如果存在)并指示发生了超时.
内存统计信息刷新周期缺省情况下,日志等待2分钟才能刷新数据.
可在此处输入更长或更短的刷新时间(以分钟计).
内存统计信息容差因子缺省情况下,数据是新的(0).
为允许内存统计信息中的数据保留下来,请在此处输入数字(以秒计)来表示数据可保留多久才需要新的轮询.
内存统计信息超时缺省情况下,尝试连接至服务器的操作将在2分钟后终止.
可更改此数目以缩短或延长放弃之前日志保持尝试的时间.
如果IBMCognosTM1OperationsConsole服务器未能在此处指定的分钟数内获得updated状态,那么将发送旧数据(如果存在)并指示发生了超时.
调度日志在V2.
0.
9中不推荐使用您可以计划日志,使用"将日志记录至磁盘"选项,或者启用自动日志记录.
过程1.
要调度日志,请单击配置>日志记录选项卡.
2.
根据想要监视的服务器的种类,单击TM1Server选项卡或TM1Applications选项卡.
3.
选中要为其创建日志的服务器.
您可能需要拖拽窗格以显示调度日志图标.
68IBMPlanningAnalytics:TM1Operations图3.
显示TM1OperationsCosnole窗格的底部.
4.
要创建新日志,请单击调度新日志.
5.
定义该日志的参数:日志类型选择一种或多种日志:日志状态、日志高级状态(包括对象争用列)、日志沙箱和日志沙箱队列日志持续时间输入开始日期、开始时间、结束日期、结束时间和日志频率(以秒计).
在字段中单击打开日历以设置日期.
状态选中要记录日志的状态:空闲、运行、落实、回滚、等待、登录或完成.
线程选中要记录日志的线程类型:系统线程、杂项或用户线程.
6.
定义完详细信息之后,单击创建.
7.
可以使用过滤按钮来减少屏幕上显示的日志数目.
8.
在保存日志文件之后,使用以更改日志文件的参数.
使用"将日志记录至磁盘"以保存日志文件在V2.
0.
9中不推荐使用可使用在大多数日志屏幕上显示的"将日志记录至磁盘"复选框来存储日志文件.
过程1.
单击可在大多数日志上找到的将日志记录至磁盘选项.
将日志记录至磁盘的操作会生成当前屏幕活动的日志.
2.
要查看日志,您可以右键单击服务器并选择查看日志.
检查想要查看的日志并单击确定.
3.
或者转至此服务器的日志位置,例如,C:\ProgramFiles\IBM\cognos\tm1_64\bin64\opsconsoledata\localhost\sdata\admin\Logs,以查找日志的.
csv文件.
第7章IBMPlanningAnalytics工具和实用程序69查看日志在V2.
0.
9中不推荐使用在生成日志后,使用"查看日志"选项可显示日志.
监视服务器的用户可以查看由其他用户创建的所有调度.
此用户还可以对这些调度执行所有支持的操作.
但是,如果所有者删除所监视的服务器,那么该调度也会被删除并将无法再供其他用户使用.
过程1.
右键单击要查看其日志的服务器.
2.
选择查看日志.
结果此时将显示"查看日志"对话框,其中包括所有日志的列表.
"日志类型"指示日志是调度的日志还是自动日志.
可以使用过滤按钮来限制屏幕上仅显示感兴趣的结果.
在IBMCognosTM1OperationsConsole中过滤结果在V2.
0.
9中不推荐使用可以使用过滤功能来减少在日志或列表中找到的条目数.
过滤日志在"监视"选项卡上,可以过滤结果.
没有将任何过滤器应用于结果时,将显示.
单击此按钮以显示您可以用来过滤结果的状态列表:空闲、运行、落实、回滚、等待、登录或完成.
接着,选择要监视的线程:系统线程、杂项和用户线程.
过滤列表使用过滤器字段和应用过滤器按钮来对服务器列表或日志列表进行过滤.
您可预先输入此字段以识别所显示的服务器或日志的任何方面的信息.
例如,在"日志记录"选项卡上,可以过滤服务器列表.
图4.
应用过滤器导出日志在V2.
0.
9中不推荐使用您可以导出日志文件.
过程1.
单击可在大多数日志上找到的导出选项.
2.
从显示的窗口中选择日志内容.
3.
将内容粘贴到另一个文件,例如,文本文件.
70IBMPlanningAnalytics:TM1Operations下载日志文件的csv版本在V2.
0.
9中不推荐使用要下载日志的csv版本,请使用下载日志文件选项.
过程1.
右键单击所需的服务器并选择下载日志文件.
2.
单击要下载的日志的"选择"按钮.
任意时间选择日志上的Log_to_Disk选项,就会在此处为屏幕的当前版本创建条目.
3.
确认您想要下载该日志并根据需要选择"保存"或"打开"对话框.
4.
浏览到要用于存储此文件的位置,然后单击保存.
下载和上载CognosTM1OperationsConsole配置文件在V2.
0.
9中不推荐使用可使用"上载和下载配置文件"选项保存CognosTM1OperationsConsole设置的详细信息.
过程1.
要保存CognosTM1OperationsConsole的当前配置,请单击下载配置文件,然后将文件保存到您选定的位置.
2.
要安装当前tm1opsconsoleconfig.
xml配置,请单击上载配置文件,浏览到配置文件所在的位置,然后单击确定TM1Server事务日志在V2.
0.
9中不推荐使用事务日志列出指定时间范围内在指定服务器上发生的事务.
有关此日志以及如何使用的详细信息,请参阅《TM1操作》文档的『系统和性能监视』一章.
过程1.
要获取事务活动的日志,请右键单击服务器并选择事务日志.
2.
单击"开始日期"、"开始时间"、"结束日期"、"结束时间"以定义将记录事务的时间段.
如果仅设置"开始时间"和"结束时间",那么时间段将缺省为所有天数.
3.
您还可以使用"用户"、"多维数据集"或"标记"过滤器以标识想要用作过滤器的各个列中的特定值.
4.
要生成日志的文本文件,请单击导出并选择生成的窗口内容.
然后,您可以将此信息粘贴到空的文本文件.
5.
要恢复任何更改的数据,请单击回退.
6.
在设置参数时,单击确定以从服务器中检索数据,用于TM1OperationsConsole.
日志记录将继续,直至会话注销结束或者到达结束时间段.
TM1Server消息日志在V2.
0.
9中不推荐使用在日志文件中显示关于服务器活动的TM1Server记录状态消息.
这些消息包含有关活动的详细信息,例如,已执行的进程、杂项、已装入的多维数据集和维度,以及已同步的复制.
有关此日志以及如何使用的详细信息,请参阅《TM1操作》文档的『系统和性能监视』一章.
过程1.
要获取消息日志,请右键单击服务器并选择消息日志.
2.
单击"开始日期"、"开始时间"、"结束日期"、"结束时间"以定义将记录事务的时间段.
如果仅设置"开始时间"和"结束时间",那么时间段将缺省为所有天数.
3.
您还可以使用"线程"、"级别"或"记录器"过滤器以标识想要用作过滤器的各个列中的特定值.
4.
要生成日志的文本文件,请单击导出并选择生成的窗口内容.
然后,您可以将此信息粘贴到空的文本文件.
第7章IBMPlanningAnalytics工具和实用程序715.
您还可以使用查看进程日志以查看进程日志.
6.
在设置参数时,单击确定以启动日志记录.
日志记录将继续,直至会话注销结束或者到达结束时间段.
TM1Server审计日志在V2.
0.
9中不推荐使用在日志文件中显示关于服务器活动的TM1Server审核日志.
有关此日志以及如何使用的详细信息,请参阅《TM1操作》文档的『系统和性能监视』一章.
过程1.
要获取审计活动的日志,请右键单击服务器并选择查看审计日志.
2.
单击"开始日期"、"开始时间"、"结束日期"、"结束时间"以定义将记录事务的时间段.
如果仅设置"开始日期"和"结束日期",那么时间段将缺省为所有天数.
3.
您还可以使用"对象类型"、"对象名称所有者类型"、"所有者名称"、"事件类型"、"事件代码"以标识想要用作过滤器的各个列中的特定值.
4.
要生成日志的文本文件,请单击导出并选择生成的窗口内容.
然后,您可以将此信息粘贴到空的文本文件.
5.
您还可以使用查看详细信息以查看各条日志条目.
6.
在设置参数时,单击确定以启动日志记录.
日志记录将继续,直至会话注销结束或者到达结束时间段.
使用看守程序来监视服务器活动在V2.
0.
9中不推荐使用可以使用看守程序规则来建立一组用于识别正在监视的服务器或进程的特定状态的条件,以及在满足条件时可执行的操作.
例如,可以创建看守程序规则,用于在IBMCognosTM1Server上的线程数达到50时写入日志.
关于此任务对于TM1Server,任何具有服务器管理员凭证的用户都只能配置一个看守程序.
然后,该看守程序可供其他用户使用.
如果设置服务器的用户删除了受监视服务器,那么该服务器上运行的看守程序也会被删除,并且看守程序将停止运行.
过程1.
单击.
2.
单击看守程序选项卡.
此选项卡将显示用户正在监视的服务器以及已针对这些服务器设置的相应看守程序规则的状态.
3.
单击要对其添加看守程序规则的服务器.
4.
要编辑看守程序规则的详细信息,必须首先验证您的管理状态.
单击验证并输入此服务器上的管理员用户的用户名和密码.
切记:您可能需要拖动窗格以在底部窗格中显示规则设置区域.
5.
要创建新规则,单击.
6.
使用网格来指定希望执行看守程序事件的时间.
单击要用于标准的字段(例如,状态)、要应用的运算符(例如,等于)和值.
例如,可以设置"状态等于忙碌".
您可以使用字段的任一相应值.
"状态"字段接受以下值:运行、空闲、忙碌、落实、回滚、登录、等待和完成.
7.
缺省情况下,满足条件时执行的操作设置为终止.
您可以将操作更改为记录以将消息写至文件.
8.
在为规则定义条件之后,单击保存.
9.
根据需要添加其他规则.
可使用以下图标来对规则执行操作:单击编辑规则以更改现有规则的条件.
72IBMPlanningAnalytics:TM1Operations单击删除规则以移除规则.
单击刷新以刷新规则列表.
10.
设置看守程序进程运行的频率.
11.
单击保存以保存此服务器的看守程序.
12.
要使看守程序规则生效,请单击启动.
看守程序将根据输入的频率运行.
如果服务器满足规则条件,那么将执行操作.
13.
要停止看守程序运行,请单击停止.
示例此示例在TM1Server上的线程计数超过20时记录事件:ThreadcountGreaterThan20ActionEqualsLog此示例在管理用户启动任何进程200秒后停止该进程:UserEqualsAdminThresholdEquals200ActionEqualsKill此示例在非管理用户运行名为Rogue的TurboIntegrator脚本超过100秒时记录事件:UserNotEqualsAdminThresholdEquals100ObjectEqualsRogueActionEqualsLog此示例停止非管理用户启动的名为Process_MonthlyDataLoad的进程.
UserNotEqualsAdminObjectEqualsProcess_MonthlyDataLoadFunctionEqualsProcessExecuteExActionEqualsKillIBMCognosPerformanceManagementHubIBMCognosPerformanceManagementHub(PMHub)是公共服务器框架,在该框架下IBMCognos性能管理产品进行互操作.
PMHub向IBMCognosAnalysisforMicrosoftExcel、OperationsConsole和其他TM1Client应用程序提供公共应用程序服务.
图5.
IBMCognosPerformanceManagementHubPMHub提供基于Web的用户界面,您可以用来设置配置选项.
第7章IBMPlanningAnalytics工具和实用程序73打开PerformanceManagementHubWeb页面您可以通过使用IBMCognosPerformanceManagementHubWeb页面来设置配置选项.
过程1.
在Web浏览器中,转至以下URL:http://[server_name]:9510/pmhub/pm/admin例如,如果您正在登录运行TM1ApplicationServer的计算机,那么请转至http://localhost:9510/pmhub/pm/admin.
"管理和配置"页面将显示.
2.
展开配置并选择类别.
配置设置将显示.
3.
要更改值,请双击"值"列中的单元格,输入值,然后按Enter键.
配置日志记录您可以调整IBMCognosPerformanceManagementHub的缺省消息记录设置.
您还可以启用其他日志.
根据server.
xml文件中定义的设置,PerformanceManagementHub(PMHub)通过WebSphereLibertyProfile记录消息.
server.
xml文件位于\wlp\usr\servers\tm1\中.
缺省情况下,所有ERROR和WARNING日志消息都写入.
.
/logs/tm1_messages.
log中.
tm1_messages.
log文件包含日志记录组件写入或捕获的所有消息(跟踪消息除外).
当文件大小达到20MB,文件会转存到.
.
/logs/tm1_messages_{datestamp}.
log.
只保留两个文件.
元素的以下属性在server.
xml文件中定义缺省日志设置:consoleLogLevel="WARNING"logDirectory="${wlp.
user.
dir}/.
.
/.
.
/logs"messageFileName="tm1_messages.
log"maxFiles="2"maxFileSize="20"您可以调整这些设置,例如,要更改保留的日志文件数,请更改maxFiles的值.
您还可以启用其他日志记录.
console.
log包含来自JVM进程的重定向的标准输出和标准错误消息.
缺省日志级别为AUDIT.
trace.
log包含产品写入或捕获的所有消息.
例如,要为以com.
ibm.
ba开头的所有组件生成最细级别的高级跟踪日志记录,请将以下属性添加到server.
xml文件中的日志记录元素:traceFileName="pmhub_trace.
log"traceFormat="ADVANCED"traceSpecification="*=audit:com.
ibm.
ba.
*=finest"那么元素的属性如下所示:consoleLogLevel="WARNING"logDirectory="${wlp.
user.
dir}/.
.
/.
.
/logs"messageFileName="tm1_messages.
log"maxFiles="2"maxFileSize="20"traceFileName="pmhub_trace.
log"traceFormat="ADVANCED"traceSpecification="*=audit:com.
ibm.
ba.
*=finest"有关WebSphere日志记录的更多信息,请参阅IBMKnowledgeCenter上的日志记录和跟踪.
74IBMPlanningAnalytics:TM1Operations使用TM1Top实用程序TM1Top实用程序动态监视在TM1Server的实例中运行的线程.
TM1Top还可显示有关特定服务器的沙箱和作业队列的信息.
此实用程序类似于UNIXTop实用程序,后者允许动态监视在给定系统上运行的进程.
TM1Top是独立实用程序,在MicrosoftWindows系统上的控制台(命令)窗口内运行.
它旨在使对TM1Server以及支持网络和系统的需求降至最低.
除用户启动的登录进程外,TM1Top不使用TM1Server中的任何多维数据集或维度资源,也不使用TM1Server上的数据或锁定或者与其进行交互.
支持TM1Top的服务器端处理在单独的轻线程中运行,以允许TM1Top即使在服务器对用户无响应时仍报告服务器状态.
注:TM1Top用户界面和帮助文本未进行翻译,在非英语版本的TM1中将以英语显示.
在TM1Top中显示用户名MaskUserNameInServerTools参数确定在TM1Top控制台显示器中显示还是遮掩用户名.
在Tm1s.
cfg中设置MaskUserNameInServerTools=TRUE后,出于安全目的,在TM1Top中会遮掩用户名.
要取消遮掩名称,管理员可以使用V(验证)命令以管理员身份登录.
默认情况下,此参数设置为FALSE.
如果未以显式方式将此参数设置为TRUE,那么即使在尚未验证管理员访问权限时,TM1Top控制台也会显示用户名.
配置Tm1top.
ini文件在运行TM1Top之前,可以编辑初始化文件Tm1top.
ini.
Tm1top.
ini文件是用于指定TM1Top实用程序的环境信息的ASCII文件.
默认情况下,示例Tm1top.
ini文件安装在install_dir\bin目录中.
运行TM1Top时,Tm1top.
ini文件应该与TM1Top可执行文件位于相同的目录中.
下面是一个已配置的Tm1top.
ini文件示例.
adminhost=servername=planningsamplelogfile=c:\temp\tm1top.
loglogperiod=50logappend=Trefresh=10adminsvrsslcertid=adminsvrsslcertauthority=adminsvrsslcertrevlist=exportadminsvrsslcert=adminsvrsslexportkeyid=如果配置TM1以使用SSL进行安全性数据传输,那么必须在Tm1top.
ini文件中配置SSL参数.
有关将TM1Top配置为使用SSL的详细信息,请参阅第75页的『配置Tm1top.
ini文件』.
编辑Tm1top.
ini文件时,请勿在参数名和参数值之间包含任何空格.
下表描述了Tm1top.
ini文件中的参数.
参数描述AdminHost运行AdminServer的计算机的机器名称或IP地址.
默认值为localhost.
LogFile指定将日志信息写入的路径和文件.
随着TM1Top运行,可以将状态行连续写入此ASCII文件,从而可监视持续的活动.
格式为:logfile=path-to-log-file其中,path-to-log-file必须指定完整的路径、文件名和文件扩展名.
不提供默认的文件名和文件扩展名.
第7章IBMPlanningAnalytics工具和实用程序75参数描述LogPeriod指定将写入日志文件的更新之间的时间间隔.
该值应该为Refresh时间参数的倍数.
此参数的格式为:logperiod=nn其中,nn是日志文件更新之间消耗的秒数.
将其设置为零会禁用日志.
例如,如果将屏幕刷新间隔设置为2秒,则可将LogPeriod设置为10秒,从而使屏幕每显示五次便输出一次以减少写入文件的数据量.
默认值为2秒.
LogAppend指定是否将日志数据附加到使用LogFile参数设置的日志文件,或者是否在启动新会话时覆盖该文件.
如果未设置LogAppend参数,那么现有的日志文件将被覆盖.
有效值为T和F,如下例所示:如果设置LogAppend=T,那么日志数据将附加到由LogFile参数指定的日志文件.
如果设置为LogAppend=F,那么现有的日志文件将被覆盖.
默认值为F,覆盖现有日志文件.
刷新刷新TM1Top显示的时间间隔.
格式为:refresh=nn其中nn是以秒为单位的时间间隔.
默认值为2秒.
ServerNameTM1Server名称.
这是服务器配置文件Tm1s.
cfg中的ServerName.
注:您也可以在启动TM1Top时在命令提示符处输入这些值,这将覆盖Tm1top.
ini文件中的值.
有关详细信息,请参阅第76页的『使用命令行选项运行TM1』.
运行TM1Top要运行TM1Top,请编辑Tm1top.
ini文件以设置要使用的参数,然后运行.
exe命令.
过程1.
根据"第75页的『配置Tm1top.
ini文件』"中的描述,编辑初始化文件Tm1top.
ini.
2.
将Tm1top.
exe和Tm1top.
ini文件放置在install_dir\bin目录中.
注:默认情况下,在安装TM1Server时,Tm1top.
exe文件和示例Tm1top.
ini文件会安装在install_dir\bin目录中.
3.
从命令提示符处运行Tm1top.
exe文件以启动TM1Top.
tm1top.
exe默认情况下,将从包含TM1Top可执行文件的相同目录中读取Tm1top.
ini文件.
要为Tm1top.
ini文件指定不同的位置,请按如下所述使用-i命令行参数.
tm1top.
exe-ipath-to-initialization-file使用命令行选项运行TM1可以在启动TM1Top时在命令行中输入基本参数值来覆盖Tm1top.
ini文件中的值.
76IBMPlanningAnalytics:TM1Operations注:如果TM1配置为使用SSL,那么无法在命令行中输入SSL安全性参数,而必须在Tm1top.
ini文件中指定.
有关详细信息,请参阅"配置TM1Top实用程序以使用SSL".
使用以下格式通过命令行选项运行TM1Top:tm1top.
exe-OptionName1OptionValue1-OptionName2OptionValue2.
.
其中OptionName和OptionValue可为以下参数和值的任一组合:-adminhost管理主机名-servername服务器主机名-refresh刷新间隔-logfile文件路径-logperiodnnn-logappendT或F例如,要在ServerName参数设置为sdata且refresh参数设置为5秒的情况下运行TM1Top,请输入以下命令:tm1top.
exe-servernamesdata-refresh5注:对于包含空格的参数值应使用引号,如下所示:tm1top.
exe-servername"planningsample"要显示可用参数的列表,请使用/选项,如下所示:tm1top.
exe/有关TM1Top参数的更多详细信息,请参阅第75页的『配置Tm1top.
ini文件』.
查看和了解TM1Top显示在TM1Top运行时,会显示一组字段和状态信息.
显示的每一行都表示正在监视的TM1Server中运行的一个唯一线程.
控制台窗口的标题栏显示AdminHost、ServerName和Refresh参数的当前值.
注:要查看更多行或更宽的显示,可以调整控制台窗口大小或者使用较小的字体大小.
如果显示内容充满了整个控制台窗口,可以使用键盘上的上下方向键进入控制台窗口中的下一页或前一页.
TM1Top可通过在程序运行时按相关键来采用下列不同显示方式运行:正常(n)沙箱(s)队列(q)正常显示方式在正常显示方式下,状态字段由TM1Top显示.
字段名描述标识TM1Server中底层系统线程的线程标识.
第7章IBMPlanningAnalytics工具和实用程序77字段名描述用户名启动线程的用户或进程的名称.
它可以是以下三种线程类型之一.
用户线程-登录到TM1的实际用户的名称.
的值表示该用户当前处于登录状态.
注:MaskUserNameInServerTools参数确定在TM1Top控制台显示器中显示还是遮掩用户名.
有关详细信息,请参阅第75页的『在TM1Top中显示用户名』杂项线程-TM1Server上运行的杂项.
杂项线程的名称按以下格式显示:C:杂项名称用户名(续)杂项下运行的进程名称显示在Function(函数)字段中.
系统线程-TM1Server上运行的TM1系统进程.
显示的格式为:Th:系统线程的名称Th:Pseudo-Pseudo线程用于清理用户定义的合并(UDC)对象.
Th:Stats-Stats线程代表用户在TM1Architect和"服务器资源管理器"中选择"启动性能监视器"选项时启动的性能监视功能的线程.
Th:DynamicConf-此线程动态读取和更新TM1Server配置文件tm1s.
cfg中的参数.
状态特定线程的当前处理状态.
该值可以是以下各值之一:空闲运行落实回滚等待登录有关更多信息,请参阅第80页的『了解TM1线程进程状态』.
函数线程当前正在执行的API函数.
如果线程正在运行杂项,与交互式用户的函数相反,"函数"字段将显示杂项下当前执行的进程名称.
对象锁定状态上次锁定的对象的锁定状态.
显示的格式为:R#IX#W#其中:R、IX和W代表对象的不同锁定方式.
有关更多信息,请参阅第79页的『了解TM1锁定方式』.
#是每种特定锁定方式下的锁定数目.
注::对象的名称显示在"状态"字段中.
78IBMPlanningAnalytics:TM1Operations字段名描述用户锁定状态一个线程使用的所有对象的总锁定状态和计数.
显示的格式为:R#IX#W#其中:R、IX和W代表对象的不同锁定方式.
有关更多信息,请参阅第79页的『了解TM1锁定方式』.
#是每种特定锁定方式下所有对象的总锁定数目.
时间当前API函数或杂项进程已处理的总时间(以秒为单位).
API函数或杂项进程的名称显示在"函数"字段中.
沙箱显示方式可以将TM1Top切换到沙箱方式.
在TM1Top运行时按下s键会切换到沙箱方式.
按下n会返回到正常TM1Top显示.
除了"标识"和"用户名"字段以外,以下字段在沙箱方式中变为可用:字段描述活动沙箱当前活动沙箱的名称.
总沙箱内存用户为所有沙箱耗用的"总沙箱内存".
沙箱数此用户的沙箱数.
队列显示方式可以将TM1Top切换到队列方式.
在TM1Top运行时按下q键会切换到队列方式.
按下n会返回到正常TM1Top显示.
除了"标识"和"用户名"字段以外,下列字段在队列方式中将变得可用:字段描述名称队列中沙箱的名称.
节点名队列中沙箱的节点名.
状态获取队列中沙箱的状态时的日期、时间和状态.
队列中的时间在处理沙箱之前,它存在于队列中的时间长度.
了解TM1锁定方式TM1使用一组锁定方式(共三种方式)来控制对TM1数据的访问.
当TM1Server正在运行时,会将这些锁定应用于被访问的各个对象,例如多维数据集、视图和维度.
TM1Top会显示正在TM1Server中运行的当前线程所使用的对象的这些锁定状态.
TM1Top将锁定状态显示在"状态"、"对象锁定状态"和"总锁定状态"字段下面.
下表描述了TM1对象的锁定方式.
第7章IBMPlanningAnalytics工具和实用程序79锁定方式描述RR锁定(读取锁定)-共享锁定,允许若干线程同时从一个对象读取内容,但是不允许另一个线程修改或写入该对象,直到R锁定被释放.
IXIX锁定(写入目的锁定)-当所有R锁定都已释放后,保留线程获取对象的W锁定权限的锁定.
一次仅允许一个线程具有对象的IX锁定.
WW锁定(写入锁定)-唯一锁定,一次仅允许一个线程访问对象及将更改写入对象.
其他线程无法读取或修改该对象,直到W锁定被释放.
了解TM1线程进程状态TM1Top在"状态"字段中显示每个线程的当前处理状态.
线程可以是以下处理状态之一.
状态描述空闲线程当前未处理.
运行表明线程正在运行.
同时按以下格式显示锁定方式和线程访问的对象:运行:锁定方式-(对象名称)-对象类型其中:锁定方式是其中一种可能的对象锁定方式;R、IX或W.
有关更多信息,请参阅第79页的『了解TM1锁定方式』.
"对象名称"是"函数"字段中显示的API函数处理的最后一个TM1对象的名称.
"对象类型"是一个代表TM1对象类型的数值.
提交线程当前正在对其所访问的对象提交更改.
回滚指示线程在提交时遇到冲突且无法继续.
线程将自动重新尝试,直到冲突被解决.
等待线程当前正在等待完成特定的情况.
显示的格式为:等待:"等待"状态-(对象名称)-对象类型其中:"等待状态"可以是以下情况之一:–WR-(WaitForWriterEvent)线程正在等待释放R锁定,从而可以获得对象的W锁定.
–IXR-(WaitForIXReaderEvent)线程正在等待W锁定完成,从而可以获得对象的R锁定或IX锁定.
–IXC-(WaitForIXConflictEvent)线程正在请求IX锁定,但是需要等待另一个具有同一对象的IX锁定的线程完成并释放该锁定.
–IXCur-(WaitForIXCurrentEvent)线程正在请求对象的IX锁定,但是需要等待具有同一对象的R锁定的线程释放其锁定.
–WC-(WaitForCompletionEvent)线程正在等待另一个线程完成并释放其锁定.
–DRR-(释放数据保留)线程正在等待释放数据保留.
对象名称是"函数"字段中显示的API函数处理的最后一个TM1对象的名称.
对象类型是一个代表TM1对象类型的数值.
80IBMPlanningAnalytics:TM1Operations状态描述登录用户当前正在登录到TM1Server.
TM1Top命令TM1Top提供了命令提示符来与实用程序进行交互.
可以在由左上角的Cmd:_标识的TM1Top命令提示符处输入以下命令:命令描述N显示TM1Top正常(线程状态)方式.
S显示TM1Top沙箱方式.
Q显示TM1Top队列方式.
W将当前TM1Top信息写至文件.
X退出TM1Top实用程序.
H显示帮助文本.
V验证TM1Top管理员会话.
显示用户名和密码提示,以便TM1管理员可登录到TM1Top的当前会话,并且可输入命令来取消其他线程中的处理.
C取消其他线程中的处理.
注:在使用"取消"命令之前,管理员必须首先使用V(验证)命令登录到TM1Top的当前会话.
K取消作业队列中对应特定作业标识编号的沙箱提交.
需要管理员使用V(验证)命令进行登录.
上、下方向键如果状态行超出控制台窗口高度,可使用上下方向键滚动状态显示.
取消线程处理系统管理员可以使用TM1Top请求取消某些需要大量处理的线程操作或功能.
TM1Top只能取消状态为运行的线程,这些线程正在运行有关TurboIntegrator处理、构造视图或计算视图的功能.
TM1Top显示中的状态字段下面指示了线程的状态.
此功能提供了一种方法,可以取消因耗用大量服务器处理时间而对其他线程造成不良影响的操作.
例如,陷于循环的TI处理,或用户试图计算巨大而费力的视图时.
要取消线程,必须同时使用取消和验证命令.
了解取消进程取消进程用于取消正在运行的线程.
如果线程处于"运行"状态,且进程包括TurboIntegrator处理、构建视图或计算视图,那么可以取消线程.
运行时,线程将检查是否设置了"退出指示器",如果已设置,则线程将退出当前操作.
第7章IBMPlanningAnalytics工具和实用程序81了解验证进程作为完整登录过程和根本无安全性之间的一种折衷方案,TM1Top要求TM1Top用户必须首先通过"验证"确定拥有管理员访问权限,然后才能使用"取消"命令.
TM1Top设计为无需用户登录到服务器即可运行.
这允许TM1Top针对资源可能死锁的服务器运行.
如果需要登录进程,那么登录进程也会被死锁,因为该进程需要访问在资源锁下操作的多维数据集和其他数据.
然而,只允许运行TM1Top的任意用户取消用户线程是不可取的.
使用V(验证)命令启动此验证进程.
可以提前启动并在TM1Top连接期间保持该进程.
使用验证和取消命令可以验证TM1Top会话和取消线程.
过程1.
输入V以显示以下提示来验证TM1Top会话:VerifyAdminAccessAdminUserName:2.
输入管理员用户的登录名.
将显示以下提示:VerifyAdminAccessAdminPassword:3.
输入管理员用户的密码.
如果输入的管理员用户名和密码有效,则将显示以下确认信息:AdminaccessverifiedPressanykeytocontinue:4.
验证该会话后,输入C启动"取消"进程.
将显示以下提示:CancelprocessingofathreadThread-id:5.
输入要取消的线程的标识.
可以在TM1Top显示的第一列中查找线程标识.
其他调试工具可以使用ADPlus或Dr.
Watson作为调试工具来收集Windows系统上的服务器崩溃信息.
您还可以收集文件或设置客户端日志记录.
安装和运行ADPlusADPlus包含在MicrosoftDebuggingToolsforWindows软件包中.
可以在以下网址下载此软件包的最新版本:http://www.
microsoft.
com/whdc/devtools/debugging/default.
mspx.
同时提供了32位版本和64位版本的DebuggingToolsforWindows,请务必下载适合于您的操作系统的版本.
有关ADPlus的完整详细信息(其中包括系统需求),请参阅http://support.
microsoft.
com/kb/286350.
82IBMPlanningAnalytics:TM1Operations在TM1Server上直接运行ADPlus直接在安装了TM1Server的计算机上运行ADPlus.
过程1.
启动TM1Server.
2.
打开命令提示符窗口,并浏览至DebuggingToolsforWindows目录.
3.
打开Windows任务管理器,并记下Tm1s.
exe(如果将服务器作为应用程序运行)或Tm1sd.
exe(如果将服务器作为服务运行)的进程标识(PID).
4.
命令提示符输入处,输入adplus–crash–p[PID]例如,adplus–crash–p492如果您无法确定要监视的服务器的进程标识,那么还可以使用下列其中一个命令来启动ADPlus:adplus-crash-pntm1sd.
exe(如果将TM1Server作为服务运行)adplus-crash-pntm1s.
exe(如果将TM1Server作为应用程序运行)5.
会出现一条警告消息,指出未设置环境变量.
您不必根据此警告而执行任何操作.
单击确定以忽略此警告.
会出现另一条消息,指出将在DebuggingToolsforWindows目录中创建一个新的子目录.
新的子目录(名为Crash_Mode_DateStamp_TimeStamp)将接收在TM1Server崩溃时所生成的转储文件.
6.
单击确定以忽略此消息.
请注意,您的桌面上现在将打开一个新的命令提示符窗口.
MicrosoftConsoleDebugger(cdb.
exe)将在此窗口中运行,如下图中所示.
从TM1Server捕获.
dmp文件当服务器崩溃时,会在Crash_Mode_DateStamp_TimeStamp子目录中创建三个转储文件(.
dmp).
IBM需要.
.
.
2ndchance_AccessViolation.
.
.
文件以调试服务器崩溃.
使用CTRL-C来强制TM1Server崩溃可以强制服务器崩溃.
在cdb.
exe命令提示符窗口中输入Ctrl-C.
获得的转储文件(.
dmp)的名称将包括.
.
.
1st_chance_CONTROL_C_ORDebug_Break.
.
.
字符串.
这是IBM调试TM1Server时需要的文件.
生成当前服务器状态的快照可以获取当前服务器状态的快照,并同时让TM1Server保持运行:第7章IBMPlanningAnalytics工具和实用程序83过程1.
启动TM1Server.
2.
打开Windows任务管理器,并记下Tm1s.
exe(如果将TM1Server作为应用程序运行)或Tm1sd.
exe(如果将TM1Server作为服务运行)的进程标识(PID).
3.
打开命令提示符窗口,并运行cd命令以切换到DebuggingToolsforWindows目录.
4.
在命令提示符处,输入adplus–hang–p.
例如,adplus–hang–p492注:即使adplus已经在以-crash方式运行,也可以运行-hang命令.
会出现一条警告消息,指出未设置环境变量.
您不必根据此警告而执行任何操作.
5.
单击确定以忽略此警告.
会出现另一条消息,指出ADPlus正在以HANG方式运行.
此消息还指出将在DebuggingToolsforWindows目录中创建一个子目录.
新的子目录(称为Hang_Mode_DateStamp_TimeStamp)将接收用于记录当前服务器状态的转储文件.
6.
单击确定以忽略此消息.
将立即生成新的转储文件并记录当前服务器状态.
7.
在DebuggingToolsforWindows目录中打开此新子目录,并注意是否存在单个转储文件(.
dmp).
这是IBM调试您的服务器时需要的文件.
从TM1Client远程运行ADPlus可以在不同计算机上运行ADPlus.
在某些环境中,您可能想要从正在运行TM1Client的计算机中管理和运行ADPlus,而不是直接从TM1Server中管理和运行ADPlus.
在服务器上安装并运行ADPlus可以在正运行TM1Server的计算机上安装和运行ADPlus.
过程1.
安装MicrosoftDebuggingToolsforWindows软件包.
2.
在调试工具安装目录中创建名为Remoteshell.
cmd的批处理文件.
此批处理文件应当包含下面这一行:C:\ProgramFiles\DebuggingToolsforWindows(x86)\remote.
exe/s"cmd.
exe"remoteshell3.
从命令提示符处输入以下行:当前时间之后2分钟,采用24小时制C:\ProgramFiles\DebuggingToolsforWindows(x86)\remoteshell.
cmd例如,如果系统时钟显示为4:45PM,那么在命令提示符处输入以下行:at16:47C:\ProgramFiles\DebuggingToolsforWindows(x86)\remoteshell.
cmd此命令将在下午4:47运行remoteshell.
cmd批处理文件4.
经过所指定的时间之后,在命令提示符处运行at命令.
不要对此命令添加任何参数,仅输入at.
如果成功运行了remoteshell.
cmd批处理文件,那么您应当看到一份报告,报告中列出了状态、日期、时间和命令行列表,例如,"c:\ProgramFiles\DebuggingToolsforWindows\remoteshell.
cmd".
有关at命令的更多详细信息,请参阅http://technet2.
microsoft.
com/windowsserver/en/library/40b9beb1-3578-48f9-93e1-7ca6760c1c151033.
mspx.
5.
打开Windows任务管理器,并记下Tm1s.
exe(如果将TM1Server作为应用程序运行)或Tm1sd.
exe(如果将TM1Server作为服务运行)的进程标识(PID).
从TM1Client运行ADPlus时,您需要知道PID.
84IBMPlanningAnalytics:TM1Operations从TM1client运行ADPlus可以从安装了TM1Client的计算机中运行ADPlus.
过程1.
从TM1Server计算机上的调试工具安装目录中复制remote.
exe和breakin.
exe文件.
2.
在运行TM1Client的计算机上,将remote.
exe和breakin.
exe保存到一个容易识别的目录中.
这些指示信息都假定remote.
exe保存在C:\debuggers目录中.
3.
打开命令提示符窗口,并通过执行cd命令切换至C:\debuggers文件夹.
4.
输入以下命令:remote.
exe/cremoteservernameremoteshell其中,remoteservername是安装了TM1Server的计算机的名称;而不是TM1Server的名称.
例如,如果smithers是安装了服务器的计算机的名称,那么您应输入以下命令remote.
exe/csmithersremoteshell5.
现在,您会在客户端的命令提示符窗口中运行服务器上的命令.
要确认您是否已正确连接至服务器,请在命令提示符处输入dirC:\.
您应当看到服务器上C驱动器中的内容.
6.
从命令提示符处,运行cd命令以切换到TM1Server计算机上的调试工具安装目录.
7.
在命令提示符处输入以下命令:Adplus-crash-quiet-pPID是TM1Server的进程标识.
例如,如果服务器的进程标识为1588,请在命令提示符处输入Adplus-crash-quiet-p1588.
您应该接收到一条消息,确认调试器已连接至TM1Server.
现在,ADPlus就可以收集调试信息,并且将继续监控服务器,直到服务器崩溃为止.
停止ADPlus可以停止ADPlus.
通常,您想让ADPlus一直运行到服务器崩溃为止.
但是,如果您需要停止ADPlus,请在客户端上的命令提示符处输入breakin.
exe.
例如:breakin.
exePID是TM1Server的进程标识.
例如,如果TM1Server的进程标识是1588,那么在命令提示符处输入breakin.
exe1588以停止调试进程.
运行Dr.
WatsonDr.
Watson已经包含在Windows操作系统中,因此您不需要安装此工具.
过程1.
从Windows任务栏中,单击开始,然后单击运行.
2.
在"运行"对话框中输入drwtsn32,然后单击确定.
3.
在Dr.
Watson对话框中,可以将"日志文件路径"设置为任何路径,可以将"崩溃转储"设置为您需要的任何路径/文件名.
记下您为"崩溃转储"设置的路径/文件名,这是因为必须将此文件发送给IBM进行分析.
4.
仅设置和启用下列选项:指令数:10要保存的错误数:10崩溃转储类型:完全第7章IBMPlanningAnalytics工具和实用程序85转储符号表转储所有线程内容创建崩溃转储文件5.
单击确定以开始运行Dr.
Watson.
将Dr.
Watson设置为缺省调试工具如果系统上安装了ADPlus或者另一个调试工具,那么您可能需要将Dr.
Watson设置为缺省调试器.
过程1.
从Windows任务栏中,单击开始,然后单击运行.
2.
在"运行"对话框中输入drwtsn32-i,然后单击确定.
现在,您就可以确认Dr.
Watson是否正在作为缺省调试器运行.
3.
从Windows任务栏中,单击开始,然后单击运行.
4.
在"运行"对话框中输入regedit,然后单击确定.
5.
在"注册表编辑器"中,单击编辑,然后单击查找.
6.
在注册表中搜索AeDebug.
AeDebug键的设置应当表明已将drwatsn32设置为您的调试器.
tm1xfertm1xfer实用程序将TM1Server对象从一个平台压缩并移动到另一个平台,同时为MicrosoftWindows和UNIX平台上的对象保留混合大小写的名称.
tm1xfer语法tm1xfer工具使用一个参数.
tm1xfer||-v|-h|-仅处理首个参数.
应用程序会忽略任何额外的参数.
下表描述了每个参数的含义.
任何不正确的参数或无效的文件名以及路径都会生成相应的错误消息.
表3.
tm1xfer参数参数描述指定包含要修改和压缩以便传输的文件的TM1数据库目录的路径和名称.
指定包含所有数据库文件的压缩文件路径和名称.
此文件将解压缩至具有相同名称的新目录.
-v显示tm1xfer工具的版本号.
-h显示应用程序的综合帮助文档.
-显示简短帮助对话框,其中包括使用语法和版本号.
没有参数显示简短帮助对话框(与-相同).
使用tm1xfer压缩目录要将TM1数据库文件压缩,请在后接包含TM1数据库文件的目录路径和名称的命令行中调用tmlxfer工具.
tm1xfer工具将识别出目录并将其压缩.
创建的新文件具有扩展名".
zip",其中包含所有压缩的数据库文件.
新文件的名称是在命令行中指定的目录的名称.
原始目录的名称还存储在.
zip文件内部.
如果已存在.
zip文件,那么tm1xfer工具会警告您具有相同名称的文件已存在并提示您指明是否用新文件改写较旧文件.
如果选择是,那么tm1xfer工具将继续压缩数据库文件并改写较早的.
zip文件.
否则,应用程序将退出并且不更改任何文件.
86IBMPlanningAnalytics:TM1Operationstm1xfer工具执行以下操作:tm1xfer搭建处理文件名和文件对象所必需的特定平台,以确保在压缩过程中将每个文件均转换为此格式.
主数据库目录中的所有子目录均会以递归方式压缩.
tm1xfer会忽略原始存储文件并且它们不会包括在压缩文件中.
如果检测到原始存储文件,那么tm1xfer会警告您在迁移前手动处理审核日志事件.
tm1xfer会忽略维度差异文件并且它们不会包括在压缩文件中.
tm1xfer采用与常用压缩应用程序不同的方式将文件存储在压缩文件内部.
因此,在使用常用的压缩应用程序(例如WinZip)对先前通过tmlxfer工具压缩的TM1文件进行解压时,获得的解压文件会产生不可用的文件.
这样做是为了让用户尽量少用其他压缩应用程序,因为tm1xfer工具执行其他压缩实用程序不执行的额外文件处理.
压缩示例以下示例假定在MicrosoftWindows平台上的TM1Server上存在称为"销售计划"的TM1,数据库,并且光盘上的数据库目录称为sales_planning.
C:\Users\obaluch\Documents\dbfile>dirVolumeindriveChasnolabel.
VolumeSerialNumber4C9A-1CE1DirectoryofC:\Users\obaluch\Documents\dbfile05/11/201105:54PM.
05/11/201105:54PM.
.
05/11/201106:11PMsales_planning0Files(s)0bytes(s)3Dir(s)91,081,957,376bytesfree要将数据库文件移至AIX服务器,请在Windows平台上的命令提示中调用以下命令:C:\Users\obaluch>tm1_xfersales_planning此操作将产生以下文件:C:\Users\obaluch\Documents\dbfile>dirVolumeindriveChasnolabel.
VolumeSerialNumber4C9A-1CE1DirectoryofC:\Users\obaluch\Documents\dbfile05/11/201105:54PM.
05/11/201105:54PM.
.
05/11/201106:11PMsales_planning05/11/201106:24PM43,611,174sales_planning.
zip1Files(s)43,611,174bytes(s)3Dir(s)91,038,346,202bytesfreetm1xfer工具将识别出sales_planning是具有数据库文件的目录,并将其压缩成".
zip"文件.
结果是称为sales_planning.
zip的另一个文件.
使用tm1xfer解压目录要将包含TM1数据库文件的压缩文件解压,请在后接压缩文件路径和名称的命令行中调用tm1xfer工具.
tm1xfer工具将识别出压缩文件并将其解压.
目录在创建时与已压缩的原始目录的名称相同,通常与.
zip文件相同,但是也并非始终如此.
这是真实的情况,因为原始目录的名称存储在.
zip文件内部并且输出目录使用存储的名称命名.
如果zip文件名更改为其他名称,那么它还将使用原始名称.
如果已存在具有相同名称的目录,tm1xfer工具会发出警告消息并提示您指明是否应将其改写.
如果选择是,那么应用程序将删除当前目录并使用zip文件名创建空目录.
如果选择否,那么应用程序将退出并且不对任何文件进行更改或解压.
在主数据库目录内部,tm1xfer工具会重新构建原始子目录层级.
第7章IBMPlanningAnalytics工具和实用程序87数据库文件会在目录内部解压和进行处理,以处理混合大小写的对象名称和基于Unicode的平台以及区域设置.
在Windows平台上,存储的文件具有使用UTF-16编码的混合大小写的文件名.
文件不需要嵌入式对象名称.
由于在.
zip文件内部的文件使用混合大小写并使用UTF-16存储,因此通常没必要进行其他转换.
必须编辑文件路径、}applications文件以及同名文件夹中的工作簿,从而必须将任何引用中包含"/"的路径转换为包含"\"的路径.
在UNIX平台上,使用8位编码(例如UTF-8或ISO-8859-1)以及全小写来存储文件.
如果已使用UTF-8,那么将使用该系统对Unicode字符编码.
否则,Unicode字符会转换为U+xxxx格式,其中xxxx是该字符的UTF-16代码点.
tm1xfer工具不会自动修改tm1s.
cfg文件.
您必须手动更改任何设置,例如数据库路径.
tm1xfer工具不会自动修改服务器名称,例如MicrosoftExcel工作簿应用程序内部的服务器名称.
解压示例在AIX系统中,称为sales_planning.
zip的压缩文件会复制到数据库目录应位于的文件系统.
要提取数据库文件,请在AIX上运行以下命令:发出命令bash-3.
2$lsaix64testssales_planning.
zipbash-3.
2$tm1xfersales_planning.
zip之后:bash-3.
2$lsaix64testssales_planningsales_planning.
ziptm1xfer工具会识别出sales_planning.
zip是压缩文件,然后继续将数据库文件解压缩并修改文件名和文件,以处理混合大小写的对象和Unicode编码.
这是在当前平台和区域设置上完成的.
tm1xfer说明在使用tm1xfer时,请记住以下其他事项.
tm1xfer工具将位于数据库文件夹中的大多数文件压缩和解压缩,但以下类型除外:原始存储和维度差异.
要点:如果存在原始存储,那么针对该TM1Server运行"处理审核日志事件…"命令.
Unicode预编码的文件中未保留案例当Unicode预编码的文件存在于数据库中时,tm1xfer日志将显示中检测到Unicode预编码的文件格式.
要修复此问题,请在MicrosoftWindows操作系统上重新保存视图、子集和维度,然后再次运行tm1xfer工具.
然后,将文件传输到UNIX,并再次运行tm1xfer工具以将数据库解压缩.
使用除tm1xfer工具外的另一个应用程序创建的档案库.
tm1xfer工具可用于将数据库文件打包,并将数据库文件在同类平台上运行的两个TM1Server之间移动,例如,从Windows移至Windows.
在此例中,文件以tm1xfer格式压缩,然后对Windows以及当前区域解压缩.
请务必记住,tm1xfer会过滤掉一些文件类型.
这些包括原始存储和维度差异,因此这些将丢失.
tm1xfer归档文件的格式与其他压缩实用程序(WinZip或WinRar)的文件格式不同.
因此,使用tm1xfer创建的档案库不能使用其他压缩实用程序解压,反之亦然.
如果必须在平台类型相同并且区域相同的两个系统之间移动数据库文件的完整副本,那么使用不进行任何文件处理的压缩使用程序(例如WinZip或tar)可能会是更好的主意.
另一方面,在区域不同的相同平台上运行的系统之间移动数据库文件时,应使用tm1xfer工具,因为它将根据区域修改文件;例如,在两个UNIX系统之间,其中一个使用en_US.
utf8区域而另一个使用en_US.
iso8859188IBMPlanningAnalytics:TM1Operations具有较早版本的TM1Server的平台如果文件版本至少为TM1V9.
1及以上,那么tm1xfer工具将进行验证.
如果文件版本低于9.
1,那么将忽略该文件.
处理专用应用程序虽然专用应用程序的内容已传输,并且对应用程序(例如Web表格)中的TM1对象文件的任何引用均已修改,以确保UNIX上的引用保持有效,但是tm1xfer工具不会保留已从Windows迁移至UNIX的专用应用程序的原始名称.
tm1s.
cfg中的服务器名称在将数据库传输至另一个主机后,如果TM1Server的名称不同(通常会出现此情况),那么必须在tm1s.
cfg文件中手动更改服务器名称.
tm1xfer不会自动进行此更改.
工作簿中的服务器名称自定义应用程序通常包含许多工作簿,这些工作簿包含对TM1Server名称的引用.
当在异构平台(Windows到UNIX,或UNIX到Windows)之间传输TM1数据库后,必须更改此名称,此名称在同一平台上的服务器之间移动时会经常更改.
对于更改工作簿中的服务器名称,tm1xfer不提供任何帮助.
tm1xfer的错误消息下表列出了您在使用tm1xfer时可能会遇到的错误消息.
表4.
tm1xfer的错误消息消息描述补救措施您的Java安装版本不支持此区域设置此程序不支持文件系统编码.
更新您的Java安装版本,以使其支持文件系统编码不存在在命令行参数中提供的文件或目录名称是不存在的文件或目录.
确保命令行中的文件名称或目录名称正确.
无法解析:在解析文件的完整路径时出现问题.
使用消息中的特定信息来确定问题的来源.
无法解析:在解析基本目录的完整路径时出现问题.
使用消息中的特定信息来确定问题的来源.
无法序列化文件列表:在将此Java对象写至磁盘时出错.
使用消息中的特定信息来确定问题的来源.
无法打开以进行读取:tm1xfer没有对数据库目录中的此文件进行读取的权限.
检查文件系统权限.
使用消息中的特定信息来确定问题的来源.
写入到zip文件时出错:写入到zip文件时存在问题.
确保磁盘未满并且该tm1xfer具有合适的写权限.
使用消息中的特定信息来确定问题的来源.
关闭zip文件时出错:关闭zip文件时出现问题.
当tm1xfer退出时,通常此问题会自行解决.
使用消息中的特定信息来确定问题的来源.
打开zip文件时出错:tm1xfer将检查缺失的文件;但是,Java需要FileNotFoundException日志消息.
使用消息中的特定信息来确定问题的来源.
:不是有效的档案库存在传递的参数,但不是tm1xfer创建的有效档案库确保命令行中的文件名正确.
第7章IBMPlanningAnalytics工具和实用程序89表4.
tm1xfer的错误消息(续)消息描述补救措施读取zip文件时出错:读取zip文件时出错.
文件可能已损坏或者可能存在权限问题.
确保已正确传输zip文件并且tm1xfer对其具有读访问权限.
使用消息中的特定信息来确定问题的来源.
读取时出错读取当前文件时出现未指定的错误使用消息中的特定信息来确定问题的来源.
解释路径时出错:解析此路径时存在问题使用消息中的特定信息来确定问题的来源.
文件读取错误:读取此文件时出现问题.
确保tm1xfer具有对该文件的读取权限.
在读取应用程序条目维度时出错读取数据库中的}ApplicationEntries.
dim时出错.
如果无法使用TM1打开}ApplicationEntries.
dim,那么该文件可能已损坏.
如果该文件未损坏,那么确保文件权限对tm1xfer给予读访问权限.
tm1xfer的用法说明首次使用tm1xfer时,这些说明可能会有帮助.
在MicrosoftWindows上,此命令在CMD.
EXE(或兼容的命令处理器)中执行.
在UNIX中,使用任何合适的shell(例如,Cshell或Bash).
标准TM1安装版本不将TM1Serverbin目录添加到用户PATH变量.
由于您通常会在包含TM1数据文件的目录(不是bin目录)中运行此工具,因此您可能会碰到"未将tm1xfer识别为内部或外部命令、可运行程序或批处理文件.
"错误.
有三种方式来处理此情况:1.
使用TM1Serverbin路径名称完全限定命令名称;例如:"c:\ProgramFiles\IBM\cognos\tm1\bin\tm1xfer"2.
使用SET命令将TM1Server路径临时添加到PATH变量;例如,设置PATH=%PATH%;c:\ProgramFiles\IBM\cognos\tm1\bin\tm1xfer3.
要将TM1Server路径永久设置为PATH变量,请执行以下操作:右键单击我的电脑,单击属性、高级选项卡,单击环境变量,滚动以在系统变量中查找PATH,单击编辑,然后使用分号分隔符将TM1Server的bin路径附加至现有路径,例如:;c:\ProgramFiles\IBM\cognos\tm1\bin\tm1xfer.
在您的操作系统中,这些步骤可能略有不同.
注:在CMD.
EXE中指定Windows路径或文件名时,如果在名称中包含任何空格,那么必须将字符串用双引号引起来.
例如,要在名为DataFiles的文件夹中执行tm1xfer,您需要指定tm1xfer"DataFiles"而不是tm1xferDataFiles.
tm1xfer将某文件夹名称作为起点并将所有一切均封装在该文件夹内部及其下方.
通常,它仅在Data目录中使用.
在Data文件夹中可能还有共驻的其他文件,例如tm1s.
cfg和日志文件.
您可以将这些文件放在特殊的文件夹中.
如果需要将这些文件复制到目标平台,那么应在可用于包含Data文件夹副本以及其他所有待传输文件的某处创建临时文件夹.
然后,可使用tm1xfer将该临时文件夹打包.
两个典型的用例情况是:(a)将TM1数据库(以及应用程序数据)移至其他服务器(b)将在一个平台(例如Windows)上开发的TM1数据库部署到其他平台(例如Linux或AiX).
在情况(a)中,您可能要迁移.
log文件、tm1s.
cfg等所有文件;在情况(b)中,您可能仅要复制Data文件夹.
在情况(a)中,您可能需要更改tm1s.
cfg(例如,在目标计算机上,盘符或路径将有所变化).
在情况(b)中,由于路径约定不同(反斜线与斜线等等)而更改tm1s.
cfgtm1xfer生成消息.
通过使用CMD.
EXE或UNIXShell重定向选项可以将其定向至某文件,例如,tm1xferdata>tm1xfer.
log90IBMPlanningAnalytics:TM1Operations在运行tm1xfer打包文件之前,应关闭TM1Server.
tm1xfer有时将检测是否已正确关闭TM1Server,并提示用户以确定他们是否应继续.
在TM1Server崩溃后收集文件以用于分析如果TM1Server崩溃,那么您必须收集以下文件供IBM支持机构和工程师进行分析:由调试工具生成的转储文件.
如果您正在运行ADPlus,那么转储文件名为ProcessID_ProcessName_2nd_chance_AccessViolation_TimeStamp.
dmp.
例如,PID-492_TM1SD.
EXE_2nd_chance_AccessViolation_full_ODB8_2008-03-08_10-17-59-052_01EC.
dmp如果您正在运行Dr.
Watson,那么转储文件名和位置是您启动Dr.
Watson时使用"崩溃转储"选项设置的.
Tm1server.
log文件.
此文件位于TM1Server数据目录中.
在崩溃的服务器会话期间生成的所有TM1ProcessError.
log文件.
生成进程错误日志文件时,TM1将指定唯一的名称,此名称使您能够轻松识别生成该错误文件的TurboIntegrator进程以及该文件的创建时间.
文件名是按TM1ProcessError_timestamp_processname.
log约定指定的.
在此约定中,timestamp是生成此文件的时间(表示为yyyymmddhhmmssGMT),processname是导致错误的TurboIntegrator进程的名称.
可能有多个TM1ProcessError.
log文件与已崩溃的服务器会话相关联.
所有TM1ProcessError.
log文件都存储在服务器数据目录中.
除非IBM支持机构明确请求TM1事务日志(Tm1s.
log),否则请不要收集此日志.
客户端日志提供了一个客户端记录工具,它可以收集有关TM1Client(例如IBMCognosTM1Architect和IBMCognosTM1Perspectives)活动的数据.
由于存在大量可以收集的数据,因此,只应在客户支持机构的指导下使用此工具.
下面是一个样本客户端日志:log4j.
rootLogger=DEBUG,R1#ServerExplorelog4j.
logger.
COrionMainApp=DEBUGlog4j.
logger.
CCubeView=DEBUGlog4j.
logger.
CubeViewGrid=DEBUGlog4j.
logger.
COrionTreeView=DEBUGlog4j.
logger.
COrionApp=DEBUGlog4j.
logger.
CMultiSelect=DEBUGlog4j.
logger.
CCreateSandbox=DEBUGlog4j.
logger.
loggerViewDimension=DEBUG#SubsetEditorlog4j.
logger.
CSubsetWnd=DEBUGlog4j.
logger.
CSubsetEntry=DEBUGlog4j.
logger.
CSubsetListProp=DEBUGlog4j.
logger.
CSubsetListBox2=DEBUGlog4j.
logger.
CSubsetListView1=DEBUGlog4j.
logger.
CSubsetRegExp=DEBUGlog4j.
logger.
CSubsetSelByAttr=DEBUGlog4j.
logger.
CSingleSelect=DEBUG#ISBlog4j.
logger.
CXLCtrlsApp=DEBUGlog4j.
logger.
CConnectServerDlg=DEBUGlog4j.
logger.
CViewCtrl=DEBUGlog4j.
logger.
CGetViewDlg=DEBUGlog4j.
logger.
CubeViewerISB=DEBUGlog4j.
logger.
ExcelReportPrintDPage=DEBUGlog4j.
logger.
CTM1Connector=DEBUGlog4j.
logger.
ExcelReportPrintIncludedSheetsPage=DEBUGlog4j.
logger.
CAutoExcel=DEBUGlog4j.
logger.
SubsetEditorIntLog=DEBUG#Perspectiveslog4j.
logger.
TM1Perspectives=DEBUGlog4j.
logger.
TM1AF=DEBUGlog4j.
logger.
TM1ExcelAPI=DEBUGlog4j.
appender.
R1=org.
apache.
log4j.
RollingFileAppender第7章IBMPlanningAnalytics工具和实用程序91log4j.
appender.
R1.
File=c:\\ClientDebugLog.
loglog4j.
appender.
R1.
MaxFileSize=10MBlog4j.
appender.
R1.
MaxBackupIndex=50log4j.
appender.
R1.
layout=org.
apache.
log4j.
PatternLayoutlog4j.
appender.
R1.
layout.
ConversionPattern=%X{pid}%t%p%d{%Y-%m-%d%H:%M:%S,%Q}%c%m%nlog4j.
appender.
R1.
layout.
TimeZone=GMT要打开客户端日志记录,请在客户端机器上的C:\DocumentsandSettings\Administrator\ApplicationData\Applix\TM位置中创建名为tm1p-log.
properties的文件.
TM1p.
ini文件必须位于相同的文件夹中.
确保在日志文件的log4j.
appender.
R1.
File=c:\\ClientDebugLog.
log行中也设置了该位置.
如果将日志文件直接放在C盘上,如示例log4j.
appender.
R1.
File=c:\\ClientLog.
log中所示,那么务必要使用反斜杠\\.
如果您想使用temp目录,请使用正斜杠来指定此位置:log4j.
appender.
R1.
File=c:/temp/ClientLog.
log如果您更改了tm1p-log.
properties文件,那么务必使用新位置来更新file参数,例如:location.
log4j.
appender.
R1.
File=c:\\ClientDebugLog.
log如果此文件存在,并且其中至少有一个组件设置为DEBUG,那么将收集客户端日志.
log4j.
rootLogger=DEBUG只能设置为OFF或DEBUG(这会开启客户端日志记录).
要关闭日志,请移除此文件或者将它重命名.
可以通过将值从DEBUG更改为OFF,从而对单个组件关闭日志.
要定制日志文件,您可以更改:日志文件的位置,此位置是在log4j.
appender.
R1.
File=c:\\ClientDebugLog.
log中设置的日志文件的最大大小,此大小是在log4j.
appender.
R1.
MaxFileSize=10MB中设置的.
达到此大小时,就会创建一个新的日志文件.
备份索引,此索引是在log4j.
appender.
R1.
MaxBackupIndex=50中设置的.
odbc_test工具odbc_test工具用于诊断和测试UNIX上的IBMCognosTM1ODBC连接.
使用odbc_test测试ODBC访问代码的方式与TM1Server使用此代码的方式完全相同.
其中一个进程开关是TM1Server配置文件目录的路径,与TM1Server的-z开关类似,因此可以使用odbc_test在UNIX上加载完全相同的ODBC库.
语法odbc_test-z[-dbname-user-passwd-query-n#-of-rows-to-retrieve][-n数字-或-记录][-t(进行计时)][-r重复次数][-h]打印帮助文件.
使用-u以使底层SQL调用使用ODBC接口较广的Unicode风格.
指定-t开关以将运行此项的调用定时,并使用配置目录的路径以加载库和列出可用的数据源.
此程序将运行指定查询并列出前10个记录.
在处理命令行开关之前会读取文件odbc_test.
ini.
此文件中的字段是:92IBMPlanningAnalytics:TM1Operationsconfig_dir:path-to-config-directory:dataset_name:user_name:user_passwd:sql_query:sql_query:将合并行和所有后续行以进行SQL查询.
第7章IBMPlanningAnalytics工具和实用程序9394IBMPlanningAnalytics:TM1Operations第8章了解多维数据集依赖关系IBMTM1Server建立了依赖关系,因此它可以正确地使多维数据集高速缓存失效.
依赖关系通常是在用户对多维数据集执行查询,并且该查询包括另一个多维数据集中按规则计算的值时建立的.
可以根据规则在基础多维数据集中的作用域来建立与一个或多个多维数据集的依赖关系.
下面是TM1中依赖关系的一个简单示例:在此简单用例下,基础多维数据集内的高速缓存在下列情况下将失效:在基础多维数据集中进行了更改或在依赖多维数据集中进行了更改由于已经建立了依赖关系,因此,当依赖多维数据集中进行了更改时,还必须更改基础多维数据集.
如果没有此依赖关系映射,那么基础多维数据集数据可能会变得与依赖多维数据集不一致.
由于基础数据依赖于依赖多维数据集中的数据,因此,如果在依赖多维数据集中进行了任何更改,就会要求也更改基础高速缓存.
依赖关系映射更改本主题描述多维数据集依赖关系映射.
现在,依赖关系行为遵循下列规则:一旦建立了依赖关系,就不会在数据失效时将此依赖关系清除.
可以使用函数AddCubeDependency函数来提前建立多维数据集依赖关系.
创建了依赖关系之后,将由受影响的多维数据集之间的对象锁定来保护依赖关系列表.
由对象锁定来保护依赖关系列表并且会"保留"多维数据集这一事实对应用程序升级有重大影响.
当读取者查询多维数据集时,以及需要添加到或者写入该多维数据集的依赖关系列表对象时,依赖关系会阻止写入者和读取者使用多维数据集对象.
在执行读取查询期间,此锁定将一直存在.
对于快速查询,此影响最小,但是存在每个多维数据集之间的依赖关系的一次性成本.
但是,对于较慢的查询,通常可能会长时间阻止其他用户使用.
在复杂的应用程序中,当用户仅执行某些规则时,依赖关系对象最初可能会被多次锁定.
以下是一个示例:在此示例中,箭头表示数据按照规则连接进行流动的路径.
多维数据集B有两项规则:一项规则用于从多维数据集C中获取信息,另一项规则用于从多维数据集D中获取信息.
多维数据集D有单项规则,用于从多维数据集E和F中获取信息.
CopyrightIBMCorp.
2007,201995当用户1从多维数据集B中读取时,在此多维数据集中已计算的规则需要从多维数据集C中获取的数据.
因此,多维数据集B、多维数据集C和相关的多维数据集对象会被阻止,直到用户1完成查询为止.
当用户2从多维数据集B中读取时,在此多维数据集中已计算的规则需要从多维数据集D中获取的数据.
现在,多维数据集B、多维数据集D和相关的多维数据集对象会被阻止,直到用户2完成查询为止.
为了解决这种情况,创建了TurboIntegrator函数AddCubeDependency以建立依赖关系.
此函数允许用户在发生诸如重新启动服务器之类的事件之后建立依赖关系.
清除多维数据集依赖关系下表描述了将破坏多维数据集的依赖关系的TM1事件或操作.
事件依赖关系操作服务器关闭将破坏多维数据集依赖关系列表.
规则编译(注意:对维度进行任何更新都会导致规则编译.
)仅消除那些已经删除或者修改了规则的多维数据集.
清除多维数据集依赖关系之后,根据应用程序和用户活动级别,您可能想手动建立那些多维数据集依赖关系.
创建多维数据集依赖关系下表描述了将添加多维数据集依赖关系的TM1事件或操作.
事件依赖关系操作服务器启动已计算的数据加载程序将创建依赖关系.
服务器启动和持久数据加载程序持久数据加载程序也会存储每个多维数据集的依赖关系映射.
规则编译特定多维数据集规则的已计算数据加载程序将创建依赖关系.
规则计算根据查询所执行的规则来创建依赖关系.
TI函数TI函数可以创建多维数据集之间的依赖关系.
96IBMPlanningAnalytics:TM1Operations使用AddCubeDependency来建立依赖关系AddCubeDependency函数用来创建两个多维数据集之间的手动依赖关系.
AddCubeDependency是一个TurboIntegrator函数,仅在TurboIntegrator进程中有效.
此函数将创建多维数据集A和多维数据集B之间的手动创建的依赖关系.
语法:AddCubeDependency('CubeA','CubeB');参数描述CubeA基础多维数据集的名称.
CubeB依赖多维数据集的名称.
多维数据集B依赖于一项规则,而此规则又依赖于多维数据集A.
可以在TurboIntegrator的"高级"选项卡中的任何位置设置此函数.
调试和标识多维数据集依赖关系可能需要使用TurboIntegrator来预先设置依赖关系.
要标识现有的多维数据集依赖关系,需要深入了解应用程序,以便您可以分析每个包括控件多维数据集的多维数据集的所有规则.
即使您已经具备了有关应用程序的该级别的知识,也要启用下列日志功能,以在建立多维数据集依赖关系时标识这些依赖关系,这一点很重要.
例如,将以下命令添加至tm1s-log.
properties文件时:log4j.
logger.
TM1.
Cube.
Dependency=DEBUG会返回用于标识依赖关系的以下信息:INFO2010-06-0918:09:23.
728TM1.
Cube.
DependencyAddingcubedependency:cube"}ElementSecurity_}Cubes"dependsoncube"}CubeSecurity"用于完成此任务的TurboIntegrator命令为:AddCubeDependency('}CubeSecurity','}ElementSecurity_}Cubes');第8章了解多维数据集依赖关系9798IBMPlanningAnalytics:TM1Operations第9章复制多维数据集您可以在不同的IBMTM1Server之间复制多维数据集,并且可在复制的多维数据集之间同步更新.
根据您的访问权限,您可以将多维数据集(及其相关联的维度、规则、子集和视图)从一个服务器复制到另一个服务器,并可以在复制的多维数据集之间以指定的时间间隔或按需同步更新.
将多维数据集从一个服务器复制到另一个服务器的过程称为复制.
注:IBMPlanningAnalytics中的复制和同步操作只能由管理组的成员执行.
其他预定义组(数据管理组、操作管理组和安全管理组)的成员没有执行这些操作所需要的全部访问权限.
使用复制的优点复制具有以下优点.
由于用户可以在本地更新多维数据集而不必进行网络通讯,因此加快了响应时间.
即使用户未连接到原始多维数据集所在的远程服务器上,也可以对多维数据集的副本进行访问和更新.
极大地增强了TM1的可伸缩性.
TM1为复制的多维数据集提供双向同步.
在同步过程中,TM1将数据更新和元数据从原始多维数据集复制到其复制版本,然后将数据更新从复制的版本复制回原始多维数据集.
使用复制时的注意事项以下是复制的注意事项:TM1版本复制过程中的所有TM1Server必须是同一版本.
远程服务器只能复制位于远程服务器上的多维数据集.
不可以复制位于本地服务器上的多维数据集.
本地服务器仅当TM1Client将其本地服务器作为独立进程运行时,才能将多维数据集复制到其本地服务器.
机器必须具有网卡.
要将本地服务器作为独立进程运行,客户端需要选择"TM1选项"对话框中的"本地服务器执行方式:独立进程"选项.
访问权限将远程服务器上的源多维数据集复制到本地服务器上时,远程服务器上本地客户端对其具有NONE访问权限的任何元素的值都是零.
如果客户端对合并(包含客户端对其具有NONE访问权限的元素)具有读取(或更高级别)访问权限,那么该合并将仅显示为客户端对其具有读取(或更高级别)访问权限的那些元素的总和.
该合并(如报告给客户端的那样)将不会是所有元素的总和(如在源多维数据集中一样).
注:设置安全性级别和建立到本地服务器的复制时,您必须了解复制客户端对其至少不具有"读"访问权限的数据的含义.
Tm1s.
cfg文件必须将Tm1s.
cfg文件配置为使用相同TM1AdminServer注册目标服务器和源服务器.
有关更多信息,请参阅第102页的『配置tm1s.
cfg文件以支持复制』.
目录路径和多维数据集名称的长度目标TM1Server的数据目录路径名与要复制的多维数据集的名称总长度不能超出大约256个字符的Windows路径名限制.
如果超出此限制,那么由于路径名或多维数据集名称过长,TM1会显示以下错误消息:无法注册多维数据集.
事务日志记录如果正在执行同步过程,必须为目标服务器上作为复制和同步过程的一部分的镜像多维数据集启用事务日志记录.
如果正在执行双向同步,必须为源服务器和目标服务器上的所有相关多维数据集启用事务日志记录.
TM1使用这些日志文件来跟踪对源多维数据集和镜像多维数据集进行的更改.
要验证是否已启用事务日志记录,请参阅第42页的『启用和禁用事务日志记录』.
CopyrightIBMCorp.
2007,201999CubeProperties控件多维数据集CubeProperties控件多维数据集内存储的值特定于TM1Server,并且在复制过程中不会从主服务器复制到目标服务器.
例如,如果要在目标服务器上为某个复制多维数据集设置度量维度,那么必须在目标服务器上的CubeProperties控件多维数据集内手动设置该值.
复制创建的关系复制会在两个多维数据集之间和两个服务器之间创建关系.
关系有两种类型:多维数据集和服务器.
复制会创建服务器配置.
多维数据集关系当您复制多维数据集时,原始多维数据集称为源多维数据集,而该多维数据集的副本称为镜像多维数据集.
可以在多个不同服务器上复制一个多维数据集,也可以复制已复制过的多维数据集.
服务器关系要复制多维数据集,您必须登录远程服务器,并创建复制连接.
该连接将刚登录的远程服务器建立为源服务器,并将从该处登录的服务器作为目标服务器.
建立复制连接之后,您可以通过此连接复制所需任意数量的多维数据集.
TM1使用复制连接的登录标识来确定您对源数据的访问权限.
同一TM1Server可以同时作为某些多维数据集的目标服务器和其他多维数据集的源服务器.
在这种情况下,在目标服务器和源服务器之间将存在两个复制连接,如下图所示.
同步进程发生在服务器级别,而不是多维数据集级别.
同步复制连接时,TM1将更新作为相同复制连接组成部分的所有镜像多维数据集.
例如,如果您将多维数据集A和B从中央服务器复制到区域4服务器,则当您为这两个服务器之间的复制连接启动同步进程时,这两个多维数据集都将更新.
典型服务器配置下图显示了在复制多维数据集时,TM1创建的典型服务器配置.
注:作为TM1管理员,您必须确保整个复制过程未创建任何循环.
当您在许多不同的服务器上复制单个多维数据集时,会创建服务器的星形配置.
例如,您可以将多维数据集A从中央服务器复制到四个区域服务器.
100IBMPlanningAnalytics:TM1Operations当您复制已复制的多维数据集时,会创建服务器的链配置.
例如,使用服务器的星形配置,多维数据集A可以从Region3复制到本地服务器.
可以将星形配置和链配置结合起来,如下图所示.
第9章复制多维数据集101所需的访问权限要复制多维数据集,您需要具有以下访问权限.
对要复制的多维数据集的"读"访问权限或更高权限.
如果您仅对多维数据集内的某些元素具有访问权限,那么TM1会复制那些元素的值,但是不会填充多维数据集的剩余部分.
对创建所复制多维数据集所在的服务器的管理访问权限.
您必须位于该服务器上的管理组中.
预定义组(数据管理组、操作管理组和安全管理组)的成员没有执行复制和同步操作所需要的全部访问权限.
用户对其本地服务器具有管理访问权限,并可以复制对本地服务器具有"读"访问权限的任何多维数据集.
作为TM1管理员,您负责复制远程服务器上的多维数据集.
注:虽然您在拥有对多维数据集的"读"访问权限时可以复制该多维数据集,但是您需要拥有对该多维数据集的保留访问权限,才能在同步进程期间将更新回写多维数据集.
请参阅第105页的『同步进程』.
设置复制您必须按照以下三个阶段来设置TM1系统的复制.
过程1.
在目标服务器和源服务器之间创建复制连接.
有关更多信息,请参阅第103页的『复制进程』.
2.
将一个或多个多维数据集从目标服务器复制到源服务器.
3.
如果同步是按需执行,那么在对多维数据集进行更新之后,启动同步进程.
有关更多信息,请参阅第105页的『同步进程』.
配置tm1s.
cfg文件以支持复制建立复制连接时,源和目标TM1Server必须都在同一TM1AdminServer上进行注册.
各服务器可以在其他的AdminServer上注册,但是目标和源服务器必须共享至少一个共用AdminServer.
如果这两个服务器未使用同一AdminServer,那么复制和同步结果将不可预测.
102IBMPlanningAnalytics:TM1Operations过程1.
编辑目标TM1Server的Tm1s.
cfg文件中的AdminHost参数,使其向源服务器注册所在的AdminServer注册.
AdminHost=;其中:是目标TM1Server注册所在的TM1管理主机的计算机名或IP地址.
是源TM1Server注册所在的TM1管理主机的计算机名或IP地址.
2.
您可将计算机名和IP地址结合使用,同时也可列出多个管理主机:例如:AdminHost=boston;newyork或AdminHost=192.
168.
1.
17;192.
168.
1.
22或AdminHost=boston;192.
168.
1.
17;192.
168.
1.
22;myserver;192.
168.
1.
40下一步做什么有关更多信息,另请参阅第9页的『第2章TM1AdminServer操作』.
复制进程在两个服务器之间创建复制连接之后,可以将多维数据集从源服务器复制到目标服务器.
TM1允许复制控件多维数据集,包括以下多维数据集:}DimensionProperties}CubeProperties}ConnectionProperties在大多数情况下,不应该复制这些多维数据集.
如果复制它们,要意识到发生同步时目标服务器上的多维数据集会覆盖源服务器上的多维数据集,从而删除通过UI进行的所有复制和同步设置.
复制多维数据集复制多维数据集时,目标TM1Server的数据目录路径名和多维数据集名称的总长度不能超出大约256个字符的MicrosoftWindows路径名限制.
如果超出此限制,那么由于路径名或多维数据集名称过长,TM1会显示以下错误消息:无法注册多维数据集.
过程1.
双击目标服务器的复制图标.
树将展开以列出现有复制连接.
2.
双击要使用的复制连接.
树将展开以列出可以复制的多维数据集.
3.
在要复制的多维数据集上单击鼠标右键,然后单击复制.
将打开"复制多维数据集"对话框.
第9章复制多维数据集1034.
选中"复制多维数据集"对话框,如第104页的『指定有关复制的多维数据集的信息』中所述.
5.
单击确定.
TM1将复制多维数据集,如第105页的『TM1复制多维数据集时将出现的情况』中所述.
注:单击确定以复制多维数据集之后,不能更改此特定复制的规范.
但是,您可以创建另一个具有不同规范的源多维数据集的复制版本.
指定有关复制的多维数据集的信息复制多维数据集对话框使您可以指定以下有关创建的镜像多维数据集的信息:镜像多维数据集的名称.
镜像多维数据集各维度的名称.
镜像多维数据集使用从源服务器复制的维度还是本地维度.
当同步多维数据集时是否同步从源服务器复制的维度.
镜像多维数据集是否使用从源多维数据集复制的规则.
当同步多维数据集时是否同步从源服务器复制的规则.
下图显示了从库存服务器复制损耗多维数据集时显示的"复制的多维数据集"对话框.
复制状态可能会有所不同,这取决于是否已复制多维数据集中的维度.
注:下面各节描述了如何更改TM1缺省设置.
我们建议,除非您完全了解更改的含义,否则请勿更改任何缺省设置.
多维数据集信息缺省情况下,TM1会使用源多维数据集名称来命名镜像多维数据集.
过程1.
要指定镜像多维数据集的另一个名称,请在"名称"字段中输入名称.
注:如果正在复制多维数据集中的规则,请勿对该多维数据集进行重命名.
2.
要复制多维数据集并允许以后进行同步,请选中复制数据并设置为同步.
3.
要复制多维数据集但不允许以后进行同步,请选中复制数据但不设置为同步.
维度信息缺省情况下,TM1指定镜像多维数据集中的每个维度都将从源服务器进行复制,然后在镜像多维数据集与其源多维数据集同步时进行同步.
TM1不会在复制维度时更改维度名称.
复制多维数据集时可以覆盖维度的缺省设置.
过程1.
要重命名一个维度,请慢单击该维度两次(不要双击),然后输入新名称.
警告:如果正在复制关联多维数据集中的规则,请勿重命名维度.
2.
要指示TM1复制维度而不对其进行同步,请选择该维度,然后清除"设置维度以进行同步"选项.
3.
要指示TM1使用本地维度,而非所复制的维度:双击维度以打开"选择要在复制的多维数据集中使用的维度"对话框.
选择要使用的维度并单击确定.
警告:缺省情况下,TM1会使用源维度覆盖本地维度.
如果您不想TM1覆盖该维度,请选择"不覆盖维度"选项.
这会自动指示TM1将本地维度视为独立维度.
规则信息缺省情况下,TM1指定镜像多维数据集中的每个规则都从源多维数据集进行复制,然后在镜像多维数据集与其源多维数据集同步时进行同步.
104IBMPlanningAnalytics:TM1Operations过程1.
要指定您想要TM1复制规则而不对它们进行同步,请清除"设置规则以进行同步"选项.
2.
要指定您不想TM1复制镜像多维数据集的规则,请选择不复制规则选项.
查看信息缺省情况下,TM1指定镜像多维数据集中的每个公共视图都从源多维数据集进行复制,然后在镜像多维数据集与其源多维数据集同步时进行同步.
过程要指定您不想TM1复制镜像多维数据集的视图,请清除复制视图选项.
子集信息缺省情况下,TM1指定镜像多维数据集中的每个公共子集都从源多维数据集进行复制,然后在镜像多维数据集与其源多维数据集同步时进行同步.
过程要指定您不想TM1复制镜像多维数据集的子集,请清除复制子集选项.
TM1复制多维数据集时将出现的情况TM1复制多维数据集时,会发生以下操作.
(可选)TM1会复制多维数据集维度.
当启动复制进程时,您确定要复制的维度以及同步多维数据集时这些维度中要同步的维度.
您还可以选择使用一个或多个本地维度以及复制的多维数据集.
(可选)TM1会复制多维数据集规则.
当启动复制进程时,您确定要复制的规则以及同步多维数据集时这些规则中要同步的规则.
将多维数据集显示为目标服务器上"多维数据集"图标下的图标.
为每个复制的多维数据集在属性栏的"复制服务器"字段中命名源服务器.
为每个复制的维度在属性栏的"复制服务器"字段中命名源服务器.
同步进程总是从目标服务器起始同步进程,目标服务器即是包含镜像多维数据集的服务器.
必须具有该服务器的管理员权限才能启动同步进程.
可以按需进行同步或将同步进程计划为自动进行.
TM1会更新作为同一复制连接组成部分的所有镜像多维数据集中的数据.
您不能指定要更新的各个多维数据集.
TM1还会更新复制的维度(如果您更改了其定义和规则).
TM1总是将源多维数据集中的更新写入镜像多维数据集.
TM1会使用您对镜像多维数据集进行的更新执行以下操作:–如果更新是由对源多维数据集具有保留访问权限的用户执行的,则会将更新回写源多维数据集.
–如果更新是由对源多维数据集具有"读"或"写"访问权限的用户执行的,则不会将更新回写源多维数据集.
TM1使用事务日志文件来跟踪对源多维数据集和镜像多维数据集进行的更改.
在同步进程期间,TM1会使用日志文件来确定要进行的更新.
–如果正在执行同步过程,必须为目标服务器上作为复制和同步过程的一部分的镜像多维数据集启用事务日志记录.
–如果正在执行双向同步,必须为源服务器和目标服务器上的所有相关多维数据集启用事务记录.
要验证是否已启用事务日志,请参阅IBMCognos《TM1操作》文档中的第42页的『启用和禁用事务日志记录』.
第9章复制多维数据集105如果特定单元格存在更新冲突,那么TM1会使用最新的更新,而无论在何处进行此更新(即,在源多维数据集中还是在镜像多维数据集中).
发生同步时,无论是由于预定的杂项或人工执行的影响,都会在目标TM1服务器上的logfiles目录中创建记录在同步期间发生的所有操作的日志文件.
同步日志文件被命名为TM1ReplicationLog__.
log.
例如,TM1ReplicationLog_20140308035140_SData.
log.
同步日志记录在同步期间发生操作的时间、建立同步的用户名称以及对操作的简要描述.
20140308041525[Admin]=>Synchronizationto"PlanningSample"started.
20140308041525[Admin]=>CurrentR&Svalues:LastSyncTime=20140308041233LastSyncTimeMaster=20140308041233LastSyncStarRecord=20140308040749.
20140308041525[Admin]=>Start:Replicationofobjectsnotyetcopied.
20140308041525[Admin]=>End:Replicationofobjectsnotyetcopied.
20140308041526[Admin]=>Replicatingdimension"plan_version".
20140308041526[Admin]=>Synchronizingcube:(P)"plan_BudgetPlan"=>(S)"plan_BudgetPlan"20140308041526[Admin]=>WARNING:NochangesfoundinPlanetserver.
20140308041526[Admin]=>Synchronizationofcube"plan_BudgetPlan"completed:StarSynchronizingcube:(P)"promotions"=>(S)"promotions"20140308041526[Admin]=>Synchronizationofcube"promotions"completed:StarSynchronizingcube:(S)"plan_BudgetPlan"=>(P)"plan_BudgetPlan"20140308041528[Admin]=>WARNING:NochangesfoundinStarserver.
20140308041528[Admin]=>Synchronizationofcube"plan_BudgetPlan"completed:PlanetSynchronizingcube:(S)"promotions"=>(P)"promotions"20140308041528[Admin]=>Synchronizationofcube"promotions"completed:PlanetSynchronizationto"PlanningSample"completed.
LastSyncTime=20140308041527LastSyncTimeMaster=20140308041526LastSyncStarRecord=20140308041234.
按需同步要按需同步更新,请完成以下步骤.
过程1.
在服务器资源管理器中,访问包含镜像多维数据集的服务器.
2.
双击"复制"图标.
3.
右键单击要同步其多维数据集的复制连接的图标,并单击同步所有数据.
安排同步您可以创建一个杂项,以使用TurboIntegrator自动定期更新同步数据.
过程1.
在服务器资源管理器中,选择要自动同步的目标服务器下的杂项图标.
2.
在杂项图标上单击鼠标右键,并单击创建新杂项.
将打开杂项设置向导.
3.
选择要自动同步的复制.
4.
单击箭头按钮以将复制从"可用"列表移动到"选定"列表.
5.
单击下一步.
将显示杂项设置向导的第二个屏幕.
6.
使用日历和"时间"字段来设置启动同步的开始日期和时间.
7.
使用"杂项执行频率"框中的字段来设置应执行同步的间隔.
8.
单击完成以完成计划.
在不稳定的网络连接或广域网连接上进行同步可使用MaximumSynchAttempts和SyncUnitSize参数来增强在不稳定的网络连接上执行的同步进程,如具有高延迟性、低宽带性以及传输质量不佳的长距离广域网(WAN).
有关更多详细信息,请参阅《PlanningAnalytics安装和配置》中的MaximumSynchAttempts和SyncUnitSize参数.
106IBMPlanningAnalytics:TM1Operations维护复制连接要复制多维数据集,您必须先在两个服务器之间创建复制连接.
创建复制连接要在两个服务器之间创建复制连接,请完成以下步骤.
过程1.
打开服务器资源管理器.
2.
确保目标服务器可见.
3.
双击目标服务器的"复制"图标.
例如,要将多维数据集从sdata服务器复制到financiareporting1服务器,请双击financiareporting1服务器下面的"复制"图标.
将打开"创建服务器复制对象"对话框.
注:如果服务器已经具有复制连接,那么必须通过选择"复制"图标,右键单击该图标,然后单击插入新复制来打开"创建服务器复制"对话框.
4.
按如下所示填写该对话框:在源服务器框中选择源服务器.
指定连接源服务器时使用的用户名和密码.
如果源服务器使用Cognos8安全性(CAM认证),那么在附带名称空间框中输入源服务器的Cognos8名称空间标识.
请注意,您必须提供名称空间的名称空间标识,而不是提供名称空间的描述性名称.
5.
单击确定.
系统将连接至所指定的服务器,并且在目标服务器的"复制"图标下面添加服务器名称.
创建复制连接之后,可以手动同步目标服务器和源服务器之间的数据,或者创建杂项来自动化同步.
有关详细信息,请参阅第105页的『同步进程』.
修改复制连接您可以更改复制连接的用户名和密码属性.
如果更改这些属性,那么会作为另一个用户登录复制服务器.
源多维数据集与镜像多维数据集之间的现有复制关系可能不再有效.
新客户端的权限可能与旧客户端的那些权限不等效.
在这种情况下,同步进程无法进行.
过程1.
打开服务器资源管理器.
2.
访问包含要修改的复制连接的服务器.
3.
双击"复制"图标将其展开.
4.
在要修改其连接的服务器上单击鼠标右键,并单击修改复制参数.
将打开"修改服务器复制对象"对话框.
5.
进行适当的更改,并单击确定.
删除复制连接您可以通过删除复制连接,断开源服务器与目标服务器之间的关系.
执行此操作时,会删除源多维数据集与镜像多维数据集之间的关系.
您仍可以更新多维数据集的本地副本,但是无法再将更新与源多维数据集同步.
第9章复制多维数据集107过程1.
打开服务器资源管理器.
2.
访问包含要删除的复制连接的服务器.
3.
双击"复制"图标将其展开.
4.
在要删除其连接的服务器上单击鼠标右键,并单击删除复制.
注:如果您创建了杂项来自动化同步,那么必须先删除该杂项,然后再删除复制.
有关自动化同步的详细信息,请参阅第105页的『同步进程』.
108IBMPlanningAnalytics:TM1Operations附录A辅助功能辅助功能可以帮助身有残疾(如行动有障碍或视力不佳)的用户使用信息技术产品.
键盘快捷键除应用程序特定键以外,还可使用标准MicrosoftWindows导航键.
可使用键盘快捷键在应用程序中浏览并执行任务.
如果您正在使用屏幕朗读器,那么您可能需要最大化窗口以便键盘快捷键表完全展开且可访问.
注:以下键盘快捷键基于美式标准键盘.
表5.
键盘快捷键操作快捷键执行活动命令按钮的命令Enter键关闭可关闭的对象或窗格Ctrl+W转到第一项或第一个对象;转到第一项Home键转到最后一项或最后一个对象;转到最后一项End键在应用程序窗格间前进F8在应用程序窗格间后退Shift+F8将焦点移至应用程序栏(蓝色点)Alt+F10组合键移至同一级别中选项卡索引顺序中的下一项;当您在结尾处时,循环到第一个选项卡索引选项卡移至同一级别中选项卡索引顺序中的上一项;当您在开始处时,循环到最后一个选项卡索引Shift+Tab组合键切换打开或关闭空格键移至下一个选项按钮并选择该按钮向右箭头键、向下箭头键移至上一个选项按钮并选择该按钮向上箭头键、向左箭头键打开并显示下拉列表的内容向下箭头键关闭打开的下拉列表Esc键移至当前节点后的下一个可选择节点.
如果您选择的节点具有子节点且已展开,那么会转到第一个子节点向下箭头键移至上一个可选择节点向上箭头键如果当前选择未展开,那么将其展开.
如果节点已展开,那么会转到第一个子节点向右箭头键和加号如果当前选择已展开,那么将其折叠起来.
如果节点已折叠,那么会转到当前选择之前的父节点向左箭头键和减号展开子菜单项向右箭头键折叠子菜单项向左箭头键打开上下文菜单右键单击(MozillaFirefox);Shift+F10(MicrosoftInternetExplorer)CopyrightIBMCorp.
2007,2019109表5.
键盘快捷键(续)操作快捷键关闭打开的上下文菜单Esc键向下滚动向下箭头键或PageDown键向上滚动向上箭头键或PageUp键移至画布同一级别中选项卡索引顺序中的下一个窗口小部件选项卡移至画布同一级别中选项卡索引顺序中的上一个窗口小部件Shift+Tab组合键添加数据库实例Alt+N组合键上载配置文件Alt+U组合键下载配置文件Alt+I组合键垂直平铺Alt+Q组合键水平平铺Alt+W组合键框平铺Alt+P组合键刷新树Alt+R组合键IBM及辅助功能有关IBM对辅助功能所作的承诺的更多信息,请参阅IBM辅助功能中心.
IBM辅助功能中心(https://www.
ibm.
com/able/)110IBMPlanningAnalytics:TM1Operations附录B控件多维数据集IBMTM1使用控件多维数据集.
IBMTM1Server会自动生成控件多维数据集.
缺省情况下,启用所有控件多维数据集的日志.
为每个控件多维数据集提供以下信息:目的构成多维数据集的维度注:有关控制维度的完整描述,请参阅第123页的『附录C控制维度』.
要切换控件多维数据集和其他控件对象在"服务器浏览器"中的显示,请依次单击视图、显示控件对象.
"服务器浏览器"中显示的所有控件多维数据集都具有一个右花括号(})的前缀.
例如,}CellSecurity_SalesCube.
安全性控件多维数据集安全性控件多维数据集将TM1对象的安全权限应用于TM1Server上的用户组.
其中大多数控件多维数据集中填充了在"TM1安全性分配"窗口中分配的权限,但是您也可以直接在这些控件多维数据集中应用权限.
然而,您不能将权限应用于管理组;此组总是对TM1Server上的所有对象具有管理权限.
}CellSecurity_CubeName启动用于定义单元格级安全性的进程时,TM1会创建一个空的}CellSecurity_CubeName控件多维数据集.
要执行此操作,请在"服务器浏览器"中选择多维数据集,然后依次单击安全性、创建单元格安全性多维数据集.
可以使用控件多维数据集为选定的多维数据集定义单元格级安全性.
TM1将单元格级安全性应用于用户组.
}CellSecurity_CubeName控件多维数据集中的单元格可以包含以下三种字符串之一,它们对应于您可以分配给单元格的安全权限:读取写入无有关定义单元格级安全性的详细信息以及安全权限的定义,请参阅IBMCognos《TM1开发人员指南》.
维度}CellSecurity_CubeName多维数据集包含您要为其定义单元格级安全性的多维数据集中存在的所有维度.
此外,}CellSecurity_CubeName多维数据集还包含以下维度:维度元素}Groups为TM1Server定义的每个用户组.
例如,如果您要为TM1样本数据中的SalesCube创建单元格安全控件多维数据集,那么生成的}CellSecurity_SalesCube多维数据集会包含SalesCube的所有维度(actvsbud、region、model、account1和month)以及}Groups维度.
}ChoreSecurity}ChoreSecurity控件多维数据集存储TM1Server上所有杂项的安全权限.
CopyrightIBMCorp.
2007,2019111此控件多维数据集中填充的是在"TM1安全性分配"窗口中应用的值,通过依次单击"服务器资源管理器"中的杂项和安全性分配可以访问该窗口.
您也可以直接在}ChoreSecurity多维数据集中输入安全权限.
}ChoreSecurity多维数据集中的单元格可以包含字符串Read,这样将分配Read安全权限.
也可以将这些单元格保留为空,这样将分配None安全权限.
有关使用TM1用户界面来定义杂项安全性的详细信息以及安全权限的定义,请参阅《TM1开发人员指南》.
维度}ChoreSecurity控件多维数据集包含以下维度:维度元素}Chores当前在TM1Server上定义的每个杂项.
}Groups为TM1Server定义的每个用户组.
}ClientSecurity}ClientSecurity控件多维数据集定义用户组对TM1Server上各个客户端的属性的访问权限.
例如,在TM1Server随附的标准SData样本数据库中,管理组对该服务器上所有客户端的属性都具有管理访问权限.
北美洲和南美洲对该服务器上所有客户端的属性都具有"读"访问权限.
例如,在TM1Server随附的标准SData样本数据库中,管理组和数据管理组对该服务器上所有客户端的属性都具有管理访问权限.
安全管理组对该服务器上所有客户端的属性都具有"读"访问权限,且北美洲和南美洲对属性没有任何访问权限.
在}ClientSecurity多维数据集中定义的访问权限非常重要,因为有多种API函数在读取和/或设置客户端属性时需要具有特定权限.
例如,只有客户端是对属性具有管理访问权限的组的成员时,才能使用TM1ClientPasswordAssign功能,因为已为这样的客户端分配了密码.
同样,TM1ObjectPropertyGet功能需要对客户端属性具有"读"访问权限,而TM1ObjectPropertySet则需要具有"写"访问权限.
在创建新用户或新组时,TM1既不会通过UI来填充此多维数据集,也不会分配访问权限.
您必须直接在}ClientSecurity多维数据集中分配访问权限.
}CubeSecurity}CubeSecurity控件多维数据集存储TM1Server上所有多维数据集(包括其他控件多维数据集)的安全权限.
此控件多维数据集中填充的是在"TM1安全性分配"窗口中应用的值,通过依次单击"服务器资源管理器"中的多维数据集和安全性分配可以访问该窗口.
您也可以直接在}CubeSecurity多维数据集中输入安全性定义.
}CubeSecurity控件多维数据集中的单元格可以包含以下五种字符串之一,这些字符串对应于您可以分配给多维数据集的安全权限:读取写入保留管理Lock该多维数据集不接受字符串None.
要将None权限分配给多维数据集,请将}CubeSecurity多维数据集中相应的单元格保留为空.
112IBMPlanningAnalytics:TM1Operations有关通过TM1用户界面来定义多维数据集安全性的详细信息以及安全权限的定义,请参阅IBMCognos《TM1开发人员指南》.
维度}CubeSecurity控件多维数据集包含以下维度:维度元素}CubesTM1Server上可用的多维数据集.
}Groups为TM1Server定义的组.
}DimensionSecurity}DimensionSecurity控件多维数据集存储TM1Server上所有维度(包括控制维度)的安全性定义.
此控件多维数据集中填充的是在"TM1安全性分配"窗口中应用的值,通过依次单击"服务器资源管理器"中的维度和安全性分配可以访问该窗口.
您也可以直接在}DimensionSecurity多维数据集中输入安全性定义.
}DimensionSecurity控件多维数据集中的单元格可以包含以下五种字符串之一,这些字符串对应于您可以分配给维度的安全权限:读取写入保留管理Lock该多维数据集不接受字符串None.
要将None权限分配给维度,请将}DimensionSecurity多维数据集中的相单元格保留为空.
有关使用TM1用户界面来定义维度安全性的详细信息以及安全权限的定义,请参阅《TM1开发人员指南》.
维度}DimensionSecurity控件多维数据集包含以下维度:Dimension元素}DimensionsTM1Server上可用的维度.
}Groups为TM1Server定义的组.
}ElementSecurity_DimensionName}ElementSecurity_DimensionName控件多维数据集存储DimensionName维度中所有元素的安全性定义.
您已为其定义元素安全性的每个维度均存在一个唯一的}ElementSecurity_DimensionName多维数据集.
此控件多维数据集中填充的是在"TM1安全性分配"窗口中应用的值,通过在"服务器资源管理器"选择一个维度并依次单击维度、安全性和元素安全性分配可以访问该窗口.
您也可以直接在}ElementSecurity_DimensionName多维数据集中输入安全性定义.
此控件多维数据集中的单元格可以包含以下五种字符串之一,这些字符串与您可以分配给维度的安全权限相对应:读取附录B控件多维数据集113写入保留管理锁定该多维数据集不接受字符串None.
要将None权限分配给元素,请将控件多维数据集中的相应单元格保留为空.
有关通过TM1用户界面来定义元素安全性的详细信息以及安全权限的定义,请参阅IBMCognos《TM1开发人员指南》.
维度}ElementSecurity_DimensionName多维数据集包含以下维度:Dimension元素DimensionName该维度的所有元素.
}Groups为TM1Server定义的组.
}ProcessSecurity}ProcessSecurity控件多维数据集存储TM1Server上所有TurboIntegrator进程的安全性定义.
维度}ProcessSecurity多维数据集包含以下维度:Dimension元素}Processes在TM1Server上定义的所有进程.
}Groups为TM1Server定义的组.
客户端和组管理控件多维数据集客户端和组管理控件多维数据集将客户端分配到用户组,并存储TM1Server上所有客户端的属性.
}ClientsGroups}ClientsGroups多维数据集存储TM1Server上所有客户端的组分配.
此控件多维数据集中填充的是反应在"客户端/组"窗口中所应用的分配的值,通过依次单击"服务器浏览器"中的服务器、安全性、客户端/组可以访问该窗口.
您也可以直接在}ClientsGroups多维数据集中输入值.
有关将客户端分配到用户组的详细信息,请参阅IBMCognos《TM1开发人员指南》.
}ClientsGroups多维数据集中的单元格包含的字符串用于将客户端分配到TM1Server上一个或多个可用的用户组.
在此示例中:管理客户端被分配到管理组Usr1客户端被分配到北美组Usr2客户端被分配到南美组Usr3客户端被同时分配到北美组以及南美组114IBMPlanningAnalytics:TM1Operations维度}ClientsGroups控件多维数据集包含以下维度:维度元素}Clients当前为TM1Server定义的客户端.
}Groups为TM1Server定义的组.
}ClientProperties}ClientProperties控件多维数据集存储TM1Server上所有客户端的属性值.
您可以使用客户端属性来定义客户端密码、允许的最大连接数、客户端状态及其他信息.
}ClientProperties多维数据集中填充的是反映"客户端/组"窗口中的设置的值,通过依次单击"服务器浏览器"中的服务器、安全性、客户端/组可以访问该窗口.
在}ClientProperties多维数据集中,某客户端的MaximumPorts值为0即表示没有为该客户端定义最大端口限制.
可以直接在}ClientProperties多维数据集中输入或编辑MaximumPorts和PasswordExpirationDays的值.
注:不应直接在多维数据集中编辑PASSWORD的值.
密码以加密格式存储在多维数据集中;如果您直接在多维数据集中编辑密码,那么密码将无法使用,从而使客户端无法登录到TM1Server.
维度}ClientProperties多维数据集包含以下维度:维度元素}Clients当前为TM1Server定义的客户端.
}ClientProperties可为TM1Client设置的属性,包括:Password、PasswordExpirationDays和MaximumPorts.
有关此维度的全部详细信息,请参阅第123页的『附录C控制维度』.
对象属性和特性控件多维数据集对象属性和特性控件多维数据集存储TM1Server上对象的属性值和特性值.
}ConnectionProperties}ConnectionProperties控件多维数据集存储TM1Server上所有复制连接的属性值.
复制连接属性用于定义建立复制连接的客户端和密码,以及中心和卫星服务器的同步状态.
维度}ConnectionProperties多维数据集包含以下维度:附录B控件多维数据集115Dimension元素}Connections为TM1Server定义的复制连接.
}ConnectionProperties可为复制连接设的属性包括:用户、密码、Syncstar以及Syncplanet.
有关此维度的全部详细信息,请参阅第123页的『附录C控制维度』.
}CubeProperties}CubeProperties控件多维数据集存储TM1Server上所有多维数据集(包括本机多维数据集和复制的多维数据集)的属性值.
此控件多维数据集中填充的是反映"多维数据集属性"对话框中的设置的值,通过在服务器浏览器中选择多维数据集,然后依次单击多维数据集、属性可访问该对话框.
对于复制的多维数据集,}CubeProperties多维数据集中填充的是反映"复制多维数据集"对话框中的设置的值,通过在"服务器浏览器"中选择复制连接下的多维数据集,然后依次单击多维数据集、复制可以访问该对话框.
}CubeProperties控件多维数据集还存储了多个只能直接在该控件多维数据集中设置的属性,例如VMM和VMT.
多维数据集属性定义多维数据集在TM1Server上的装入方式、要用作度量维度的维度、要用作时间维度的维度以及是否启用多维数据集日志记录.
对于复制的多维数据集,}CubeProperties多维数据集中的值还用于定义复制的源多维数据集、多维数据集的复制状态以及规则与视图是否应同步.
维度}CubeProperties多维数据集包含以下维度:Dimension元素}CubesTM1Server上可用的多维数据集.
}CubeProperties可为多维数据集设置的属性.
有关此维度的全部详细信息,请参阅第123页的『附录C控制维度』.
}DimensionProperties}DimensionProperties控件多维数据集存储TM1Server上所有维度(包括本机维度和复制的维度)的属性值.
此控件多维数据集中填充的是反映DimensionElementOrdering对话框中的设置的值,通过在"服务器浏览器"中选择维度,然后依次单击维度、设置元素顺序可以访问该对话框.
对于复制的多维数据集,}DimensionProperties多维数据集中填充的也是反映"复制多维数据集"对话框中的设置的值,通过在"服务器浏览器"中选择复制连接下的多维数据集,然后依次单击多维数据集、复制可以访问该对话框.
维度属性定义维度在TM1Server上装入和排序的方式.
对于复制的维度,}DimensionProperties多维数据集中的值还用于定义已复制维度的源维度、维度的复制状态以及子集与属性是否应同步.
维度}DimensionProperties多维数据集包含以下维度:Dimension元素}DimensionsTM1Server上可用的维度.
116IBMPlanningAnalytics:TM1OperationsDimension元素}DimensionProperties可为维度设置的属性.
有关此维度的全部详细信息,请参阅第123页的『附录C控制维度』.
}DimensionAttributes}DimensionAttributes控件多维数据集存储IBMTM1Server上所有维度(包括本机维度和复制的维度)的属性值.
此控件多维数据集中填充的是反映"属性编辑器"窗口中的设置的值,通过在"服务器资源管理器"中选择维度组,然后依次单击维度、编辑属性可以访问该窗口.
您也可以直接在}DimensionAttributes多维数据集中输入属性值.
注:启动服务器时,缺省情况下不会创建}DimensionAttributes控件多维数据集.
它在使用IBMPlanningAnalyticsWorkspace或IBMTM1PerformanceModeler访问服务器时进行创建.
维度}DimensionAttributes多维数据集包含以下维度:维度元素}DimensionsTM1Server上可用的维度.
}DimensionAttributes已在TM1Server上为维度定义的属性.
}ElementAttributes_DimensionName}ElementAttributes_DimensionName控件多维数据集存储DimensionName维度的元素属性值.
您已为其定义元素属性的每个维度都存在一个唯一的}ElementAttributes_DimensionName多维数据集.
}ElementAttributes_DimensionName多维数据集中填充的是反映"属性编辑器"窗口中的设置的值,通过在"服务器浏览器"中选择维度,然后依次单击维度、编辑元素属性可以访问该窗口.
您也可以直接在}ElementAttributes_DimensionName多维数据集中输入元素属性值.
维度}ElementAttributes_DimensionName多维数据集包含以下维度:Dimension元素DimensionName该维度的所有元素.
}ElementAttributes_DimensionName为DimensionName维度定义的元素属性.
有关定义元素属性的详细信息,请参阅IBMCognos《TM1开发人员指南》.
}HierarchyProperties}HierarchyProperties控件多维数据集存储TM1维度的层级级别的定制已命名级别.
可以在}HierarchyProperties控件多维数据集中输入您自己为这些级别定义的名称,然后可以在TM1外部使用这些名称以通过IBMCognosReportStudio、MDX语句或其他MDXOLAP工具来访问TM1数据.
还可以使用该控件多维数据集来向维度分配缺省成员.
有关将已命名的级别与维度一起使用的详细信息,请参阅《TM1开发人员指南》中的相关章节.
附录B控件多维数据集117维度}HierarchyProperties多维数据集包含以下维度:维度元素}Dimensions包含TM1Server中所有维度名称的列表.
}Hierarchies仅包含一个用于将已命名级别分配给选定维度的元素.
}HierarchyProperties包含以下两种元素类型名为defaultMember的单个元素,用于分配维度的缺省成员.
一组21个元素(level000-level020),用于为维度层级级别分配名称.
有关更多详细信息,请参阅第128页的『}HierarchyProperties』.
性能监视控件多维数据集TM1包括性能监视功能,您可以使用该功能记录客户端、多维数据集和服务器的性能统计信息.
当启用性能监视时,TM1将在服务器启动时,填充性能监视控件多维数据集.
可以浏览这些多维数据集来分析服务器性能.
注:TM1Server仅报告一次数据加载程序使用的内存.
如果没有规则或多维数据集数据的更改,那么内存消耗量表示服务器成功启动后记录的静态值.
如果在运行服务器期间对规则、数据加载程序或多维数据集数据进行了更改,那么}StatsByCube控件多维数据集内的"用于数据加载程序的内存"值将在下次服务器启动时更新.
可以使用Maintain_detailed_feeder_memory_stats多维数据集属性来生成特定多维数据集的详细数据加载程序内存使用情况的统计信息.
(cubeName,propertyName)元组的值为"YES"将开启计算使用的详细数据加载程序内存.
注:计算使用的详细数据加载程序内存旨在用于在预生产过程中帮助设计多维数据集.
此步骤完成时,属性值应该切换为"NO",以便在生产过程中能以快得多的速度计算使用的数据加载程序内存.
在每台服务器上启用性能监视.
要为服务器启用性能监视,请在"服务器资源管理器"中选择该服务器,然后单击服务器、启动性能监视器.
有关更多信息,请参阅第13页的『第3章远程TM1Server操作』.
}StatsByClient对于服务器上的每个客户端,}StatsByClient控件多维数据集会跟踪消息计数、平均消息大小,总耗时及其他度量.
维度}StatsByClient多维数据集包含以下维度:118IBMPlanningAnalytics:TM1Operations维度元素}StatsStatsByClient该维度包含以下度量:消息计数消息字节数请求计数耗时字节数/消息在第123页的『附录C控制维度』中对度量进行了说明.
}PerfClients服务器上的每个客户端加上合并元素ClientsTotal(它是所有客户端的合并).
}TimeIntervals请参阅第123页的『附录C控制维度』中对}TimeIntervals维度的描述.
}StatsByCube对于服务器上的每个多维数据集,}StatsByCube控件多维数据集会跟踪内存使用量、已填充的字符串单元格数、已填充的数字单元格数、存储的计算单元格数、已装入数据的单元格数以及存储的视图数.
维度}StatsByCube多维数据集包含以下维度:维度元素}StatsStatsByCube该维度包含以下度量:用于计算的内存用于数据加载程序的内存用于输入数据的内存用于视图的内存:计算已经打开的视图数.
计算所有视图(无论是私有视图还是公共视图)的数目,不用考虑用户是谁.
此计数并不依赖于登录者是谁.
已加载数据的单元格数已填充的数字单元格数已填充的字符串单元格数存储的已计算单元格数存储的视图数:计算已经打开的所有视图的数目,无论是私有视图还是公共视图,也不用考虑用户是谁.
包括已经查看的所有视图.
规则计算高速缓存不命中率:规则计算高速缓存不命中数加上不命中百分比,除以填充的叶单元格总数.
一般计算步骤数:执行多维数据集规则评估所需的一般内部步骤数.
此计算可直接与用于确定是否将值添加到规则计算高速缓存的CALCULATIONTHRESHOLD多维数据集属性进行比较.
总内存使用量附录B控件多维数据集119维度元素}PerfCubes该维度包含服务器上每个多维数据集的数字元素,加上合并元素"多维数据集合计"(其为所有客户端的合并).
}TimeIntervals请参阅第123页的『附录C控制维度』中对}TimeIntervals维度的描述.
}StatsByCubeByClient对于服务器上的每个客户端和多维数据集,}StatsByCubeByClient控件多维数据集会跟踪单元格更新次数和耗时、单元格检索、视图计算和视图检索.
在视图中通过Architect设置单元格时,单元格更新不会工作.
维度}StatsByCubeByClient多维数据集包含以下维度:维度元素}PerfClients服务器上的每个客户端加上合并元素ClientsTotal(它是所有客户端的合并).
}PerfCubes服务器上的每个多维数据集加上合并元素"多维数据集合计",其为所有多维数据集的合并.
}CubeFunctions该维度包含以下数字元素:单元格更新单元格检索视图计算视图检索有关此维度的全部详细信息,请参阅第123页的『附录C控制维度』.
}StatsStatsByCubeByClient该维度包含以下度量:计数耗时(毫秒)有关此维度的全部详细信息,请参阅第123页的『附录C控制维度』.
}TimeIntervals请参阅第123页的『附录C控制维度』中对}TimeIntervals维度的描述.
}StatsByRule}StatsByRule控件多维数据集存储TM1服务器上多维数据集的性能统计信息.
要允许存储规则的统计信息,您必须在}CubeProperties控件多维数据集中将关联多维数据集的Rule_Stats属性设置为"是".
每次更改或编译规则时,都会清除并更新}StatsByRule控制多维数据集内的数据.
这能让您立即看到规则更改的影响.
}StatsByRule控件多维数据集中的数据在服务器会话之间不持久储存,每次您重新启动TM1服务器时都将被清除.
}StatsByRule控件多维数据集包含以下维度:120IBMPlanningAnalytics:TM1OperationsDimension元素}CubesTM1服务器上的每个多维数据集都作为元素包括在}Cubes维度中.
要查看不同多维数据集规则的统计信息,请从}Cubes维度中选择新的多维数据集名称.
}LineNumber从1到10,000的数字元素.
元素对应于TM1规则中的行号.
注:TM1ArchitectandPerspectives中的规则编辑器不指示行号.
要查看带行号的规则,请在包括行号的文本编辑器中打开cube_name.
rux文件.
TM1PerformanceModeler中的规则编辑器包括行号.
}RuleStats包含的元素对应于TM1服务器上存储的规则的信息和统计信息,包括:规则文本总运行数最短时间最长时间平均时间总时间上次运行时间有关详细信息,请参阅第129页的『}RuleStats』控制维度.
为"最短时间"、"最长时间"、"平均时间"、"上次运行时间"和"总时间"记录的时间,其单位均为毫秒(千分之一秒).
某些规则的执行时间不到1毫秒,结果显示的时间为0.
很有可能简单规则运行多次,但总时间显示为0.
}StatsForServer}StatsForServer控件多维数据集会跟踪该服务器的已连接客户端数、活动线程数和内存使用量.
维度}StatsForServer多维数据集包含以下维度:维度元素}StatsStatsForServer该维度包含以下度量:连接的客户端数活动线程数内存使用量(字节)无效内存(字节)有关此维度的全部详细信息,请参阅第123页的『附录C控制维度』.
}TimeIntervals请参阅第123页的『附录C控制维度』中对}TimeIntervals维度的描述.
其他控件多维数据集以下各节描述了TM1Server上可用的所有其他控件多维数据集.
}Hold_UserName_CubeName}Hold_UserName_CubeName控件多维数据集会跟踪UserName客户端在CubeName多维数据集上保留的单元格.
附录B控件多维数据集121维度}Hold_UserName_CubeName多维数据集包含以下维度:维度元素}Hold该维度包含以下元素:OriginalVal保留状态有关此维度的全部详细信息,请参阅第123页的『附录C控制维度』.
}Hold_UserName_CubeName多维数据集中的其他维度}Hold_UserName_CubeName多维数据集还包含CubeName多维数据集中存在的所有维度.
例如,}Hold_Admin_Sales多维数据集包含}Hold维度以及Sales多维数据集中存在的所有维度.
122IBMPlanningAnalytics:TM1Operations附录C控制维度IBMTM1使用控制维度来跟踪性能统计信息、管理安全性、管理客户端和组以及存储对象属性和特性.
}Chores}Chores维度仅在}ChoreSecurity控件多维数据集中使用.
此维度包含的字符串元素对应于在IBMTM1Server上定义的杂项的名称.
}ClientProperties此}ClientProperties维度仅在}ClientProperties控件多维数据集中使用.
此维度包含的以下字符串元素对应于可在IBMTM1Server上为客户端定义的以下属性.
元素描述MaximumPorts指示单个客户端可以在TM1Server上打开的最大端口(连接)数.
PASSWORD存储和显示加密格式的客户端密码.
PasswordExpirationDays指示给定客户端密码的有效天数.
PasswordLastTimeUpdated指示上次更新给定客户端密码的时间(GMT).
时间格式为:yyyymmddhhss.
STATUS当客户端登录TM1Server时,STATUS值为ACTIVE.
否则,STATUS值为空.
}Clients}Clients维度包含的字符串元素对应于在IBMTM1Server上定义的客户端.
此维度在}ClientGroups和}ClientProperties控件多维数据集中使用.
}ConnectionProperties}ConnectionProperties维度仅在}ConnectionProperties控件多维数据集中使用.
此维度包含的以下字符串元素对应于可在IBMTM1Server上为复制连接定义的属性.
元素描述INTEGRATEDSECURITY确定复制连接是否使用集成登录.
如果此连接使用集成登录,那么此属性的值为YES,否则该值为NO.
LASTSYNC数据在卫星服务器(从中建立复制连接)上的上次同步时间(GMT).
时间格式为:yyyymmddhhss.
CopyrightIBMCorp.
2007,2019123元素描述LASTSYNCSTAR数据在复制连接的中心服务器上的上次数据同步时间(GMT).
时间格式为:yyyymmddhhss.
LASTSYNCSTARRECORD导致数据从中心服务器移至卫星服务器的最新同步时间(GMT).
时间格式为:yyyymmddhhss.
此元素与LASTSYNCSTAR的不同之处在于:即使同步未导致任何数据从中心服务器移至卫星服务器,LASTSYNCSTAR还是会报告最新同步时间.
NAMESPACE与使用IBMCognos8安全性的服务器建立复制连接时,这是Cognos名称空间的名称空间标识.
请注意,此属性存储Cognos名称空间的标识,而不是存储该名称空间的描述性名称.
PASSWORD以加密的格式存储和显示密码,以建立复制连接.
SYNCPLANET确定在同步进程中是否更新卫星服务器上的数据.
如果更新了卫星服务器上的数据,那么此属性的值为YES,否则该值为NO.
SYNCSTAR确定在同步进程中是否更新中心服务器上的数据.
如果更新中心服务器上的数据,那么此属性的值为YES,否则该值为NO.
USER对于给定复制连接,存储建立连接的用户的名称.
}Connections}Connections维度包含的字符串元素对应于在IBMTM1Server上定义的复制连接.
此维度仅在}ConnectionProperties控件多维数据集中使用.
}CubeFunctions}CubeFunctions维度仅在}StatsByCubeByClient控件多维数据集中使用.
该维度包含以下与可在多维数据集上执行的函数相对应的字符串元素:元素描述单元格检索由用户在非存储视图中检索的单元格.
此度量标准包括已计算的单元格,例如规则、合并和用户定义的计算.
单元格更新单元格更新包括通过CubeViewer、电子表格内浏览器、TM1Web和切片进行的用户输入.
此度量标准不包括通过规则计算或其他方法进行的单元格更新.
视图计算请求的视图数,可以是针对CubeViewer或切片的用户请求.
视图检索要求和显示的视图数.
}CubeProperties}CubeProperties维度仅在}CubeProperties控件多维数据集中使用.
124IBMPlanningAnalytics:TM1Operations此维度包含的以下字符串元素对应于可在IBMTM1Server上为多维数据集定义的属性.
元素描述CALCULATIONTHRESHOLD设置计算高速缓存的计算步骤数阈值.
设置此多维数据集属性会覆盖在tm1s.
cfg文件中定义的全局值CalculationThresholdForStorage.
DemandLoad指示是启动服务器时自动装入多维数据集,还是仅当请求多维数据集值时"根据需要"装入.
当根据需要装入多维数据集时,DemandLoad属性的值为YES,否则属性值为NO.
Lock在锁定多维数据集时,此属性会存储已锁定多维数据集的TM1Client的名称.
Logging指示是否对给定多维数据集启用记录.
当启用了多维数据集记录时,此属性的值为YES,否则该值为NO.
Measures_Dimension如果已为给定多维数据集定义了度量维度,此属性将存储维度的名称.
Replication对于复制的多维数据集,此属性存储与复制的多维数据集相关联的复制连接的名称.
RepSrcName对于复制的多维数据集,此属性将存储源多维数据集的名称.
RepStatus如果在服务器上复制了某个多维数据集,那么RepStatus的值为Copied,否则此属性值为空.
Rule_Stats此属性确定是否已收集与多维数据集相关联的规则的性能统计信息.
要启用统计信息收集,请将Rule_Stats属性设置为YES.
要禁用统计信息收集,请将该属性设置为"否"(此为缺省值).
规则统计信息将存储在}StatsByRule控件多维数据集中.
Rule_Stats是动态属性,这意味着该属性不需要重新启动服务器就可以生效.
然而,可能需要最长60多秒才能使动态属性更改应用于TM1Server.
SyncRule对于复制的多维数据集,此属性指示同步相关多维数据集时是否对规则进行同步.
SyncViews对于复制的多维数据集,此属性指示同步相关多维数据集时是否对视图进行同步.
Time_Dimension如果已为给定多维数据集定义了时间维度,此属性将存储维度的名称.
附录C控制维度125元素描述VMM对于每个多维数据集,此属性可以确定用于存储星门视图的服务器上保留的RAM量.
星门视图的可用内存越多,性能将越好.
然而,您必须确保有足够的内存可用于TM1Server来装入所有多维数据集.
VMM的值以千字节表示.
如果未指定VMM值,那么缺省值为128千字节.
VMM的有效范围为0-2,147,483,647KB.
VMM的实际上限由系统上可用的RAM量来决定.
VMT对于每个多维数据集,此属性定义一个时间阈值(以秒为单位),超出此阈值时将触发存储TM1星门视图的算法.
如果计算多维数据集视图需要的时间超出了指定的阈值,那么TM1将尝试存储星门视图.
如果没有足够的内存可用于存储星门视图,那么TM1将清除当前未使用的最旧的星门视图,并继续以此方式清除视图,直到有足够的内存可用.
如果未指定VMM值,那么缺省值为五秒.
有效范围为1到259,200秒.
有关星门视图的详细信息,请参阅第21页的『关于星门视图』.
}Cubes}Cubes维度包含的字符串元素对应于IBMTM1Server上的多维数据集(包括控件多维数据集).
}DimensionAttributes}DimensionAttributes维度包含与IBMTM1Server上为维度定义的属性相对应的数字元素.
}DimensionAttributes维度在}DimensionAttributes控件多维数据集中使用.
注:启动服务器时,缺省情况下不会创建}DimensionAttributes维度.
它在使用IBMPlanningAnalyticsWorkspace或IBMTM1PerformanceModeler访问服务器时进行创建.
}DimensionProperties}DimensionProperties维度仅在}DimensionProperties控件多维数据集中使用.
}DimensionProperties维度包含的以下字符串元素对应于可在IBMTM1Server上为维度定义的属性.
元素描述Default_Hierarchy当前未使用.
DemandLoad当前未使用.
Last_Time_Updated上次更新维度的时间(GMT).
时间格式为:yyyymmddhhss.
Lock在锁定维度时,此属性会存储已锁定该维度的TM1Client的名称.
Replication对于复制的多维数据集,此属性将存储与复制的多维数据集相关联的复制连接的名称.
126IBMPlanningAnalytics:TM1Operations元素描述RepSrcName对于复制的维度,此属性存储源维度的名称.
RepStatus如果在服务器上复制维度,那么RepStatus的值为Copied.
否则,RepStatus值为空.
SortComponentsSense对合并的中间组件(子项)进行排序时,此属性将存储应用于排序的方向.
可以按升序或降序对组件进行排序.
SortComponentsType此属性指示应用于合并的中间组件(子项)的排序类型.
排序有两种类型:ByName和ByInput.
实际上,ByInput排序不会执行任何排序,它会按上一次保存维度时所显示的顺序保留这些组件.
SortElementsSense对维度元素进行自动排序时,此属性将存储应用于排序的方向.
可以按升序或降序对元素进行排序.
SortElementsType当对维度元素进行自动排序时,此属性将存储所使用的排序类型.
元素排序有四种类型:ByName、ByLevel、ByHierarchy和ByInput.
实际上,ByInput排序不会执行任何排序,它会按上一次保存维度时所显示的顺序保留这些元素.
如果保留为空白,那么将应用ByInput.
SortElementsType适用于所有维度元素,包括合并和叶元素.
SyncAttributes对于复制的多维数据集,此属性指示同步关联维度时是否对元素属性进行同步.
SyncSubsets对于复制的多维数据集,此属性指示同步关联维度时是否对子集进行同步.
}Dimensions}Dimensions维度包含的字符串元素对应于IBMTM1Server上的维度(包括控制维度).
}Dimensions维度仅在}DimensionsProperties控件多维数据集中使用.
}ElementAttributes_DimensionName}ElementAttributes_DimensionName维度包含与为DimensionName维度定义的元素属性相对应的数字元素.
}ElementAttributes_DimensionName维度仅在}ElementAttributes_DimensionName控件多维数据集中使用.
}Groups}Groups维度包含的以下字符串元素对应于在IBMTM1Server上定义的用户组.
}Groups维度仅在}ClientGroups控件多维数据集中使用.
}Hierarchies}Hierarchies维度在}HierarchyProperties控件多维数据集中使用.
附录C控制维度127此维度仅包含一个可与HierarchyProperties维度一起使用的名为hierarchy0的元素,用于将已命名级别分配给TM1维度的层级级别.
}HierarchyProperties}HierarchyProperties维度在}HierarchyProperties控件多维数据集中与}Hierarchies维度一起用于将已命名级别分配给TM1维度的层级级别.
}HierarchyProperties维度包含以下元素:元素描述defaultMember字符串元素,用于存储维度的缺省成员的名称.
如果TM1数据是从外部应用程序(如IBMCognosReportStudio)中检索到的,那么此处输入的元素名称可能会过滤该维度.
使用维度层级中顶层元素的名称,以便缺省检索所有维度元素.
level000-level020一组字符串元素,用于存储维度的层级级别的定制名称.
}Hold}Hold维度可以在任何}Hold_UserName_CubeName多维数据集中使用.
UserName是已对多维数据集值应用保留的TM1用户的名称,而CubeName是在其中保留值的多维数据集的名称.
}Hold维度包含以下元素:元素描述OriginalVal此数字元素跟踪在CubeName多维数据集中编辑的叶元的最新值.
这些最新值可用于多种数据传播方法,且不应该被编辑.
HoldStatus此字符串元素识别由CubeName多维数据集中的UserName保留的单元格.
值H指示UserName已将保留的叶应用到单元格.
值C表示UserName已将保留的合并应用到单元格.
}LineNumber}LineNumber控制维度包含从1到10,000的数字元素.
此控制维度中的元素对应于TM1规则(.
rux)文件中的行号.
}LineNumber控制维度在}StatsByRule控件多维数据集中独占使用,该多维数据集用于存储有关TM1规则的信息和统计信息.
}PerfClients}PerfClients维度包含的数字元素对应于在IBMTM1Server上定义的客户端,以及所有名为ClientsTotal的客户端的合并.
}PerfClients维度在以下性能监视多维数据集中使用:}StatsbyClient128IBMPlanningAnalytics:TM1Operations}StatsByCube}StatsByCubeByClient}PerfClients维度不同于}Clients维度,因为}PerfClients维度包含数字元素,而}Clients维度包含字符串元素.
}PerfCubes}PerfCubes维度包含的数字元素对应于IBMTM1Server上的多维数据集,以及所有名为CubesTotal的多维数据集的合并.
}PerfCubes维度在}StatsByCube和}StatsByCubeByClient性能监视多维数据集中使用.
}PerfCubes维度不同于Cubes维度,因为}PerfCubes维度包含数字元素,而}Cubes维度包含字符串元素.
}Processes}Processes维度包含的字符串元素对应于在IBMTM1Server上定义的TurboIntegrator进程.
}Processes维度仅在}ProcessSecurity控件多维数据集中使用.
}RuleStats}RuleStats控制维度包含的元素对应于在TM1Server上存储的规则的信息和统计信息.
此控制维度在}StatsByRule控件多维数据集中独占使用,该多维数据集用于存储有关TM1Server上规则的信息和统计信息.
以下元素包括在}RuleStats控制维度中.
元素描述规则文本规则文本的开始,用于帮助您识别规则.
总运行数规则运行的总次数.
最短时间规则运行花费的最短时间(以毫秒为单位).
最长时间规则运行花费的最长时间(以毫秒为单位).
平均时间平均规则运行时间(以毫秒为单位).
总时间规则花费的时间总量(以毫秒为单位).
上次运行时间最近一次执行规则花费的时间量(以毫秒为单位).
}StatsStatsByClient}StatsStatsByClient维度在}StatsByClient控件多维数据集中使用.
该维度包含以下度量:元素描述字节数/消息每条消息的平均字节数.
此元素的值是根据}StatsByClient多维数据集规则中的['Bytes/Message']=['MessageBytes']/['MessageCount']语句计算的.
附录C控制维度129元素描述耗时(毫秒)处理对TM1Server的请求所需的时间(以毫秒为单位).
消息字节数在请求中已发送的字节数.
消息计数消息是向TM1Server发出的请求,用于获取对象列表(例如,维度列表).
请求计数度量向TM1Server请求信息的请求数.
}StatsStatsByCube}StatsStatsByCube维度仅在}StatsByCube控件多维数据集中使用.
启用性能监视后,该维度将跟踪性能统计信息,且该维度包含以下元素:元素描述用于计算的内存此度量测量所有TM1计算(包括合并、规则和用户定义的计算)中使用的内存.
用于数据加载程序的内存此度量测量用于通过TM1规则为单元格加载数据的内存量.
用于输入数据的内存这包括分配给通过TurboIntegrator或进程工作表装入的数据的内存.
这将计算除切片或CubeViewer输入之外的所有数据输入所使用的内存.
用于视图的内存此度量测量用于为TM1Server上的给定多维数据集存储视图的内存量(以字节为单位).
已加载数据的单元格数这是数据加载程序的目标多维数据集中的单元格数.
已填充的数字单元格数此度量将计算给定多维数据集中的所有已填充字符串单元格数.
字符串单元格是由至少一个字符串元素进行标识的单元格.
已填充的字符串单元格数此度量将计算给定多维数据集中的所有已填充字符串单元格数.
字符串单元格是由至少一个字符串元素进行标识的单元格.
存储的已计算单元格数此度量将计算所有存储的已计算单元格数(包括规则、维度合并和用户定义的合并).
存储的视图数此度量将计算给定多维数据集的已命名视图数.
规则计算高速缓存不命中率规则计算高速缓存不命中数加上不命中百分比,除以填充的叶单元格总数.
一般计算步骤数执行多维数据集规则评估所需的一般内部步骤数.
此计算可直接与用于确定是否将值添加到规则计算高速缓存的CALCULATIONTHRESHOLD多维数据集属性进行比较.
总内存使用量由多维数据集使用的总内存量(以字节为单位).
130IBMPlanningAnalytics:TM1Operations}StatsStatsByCubeByClient}StatsStatsByCubeByClient维度仅在}StatsByCubeByClient控件多维数据集中使用.
该维度包含以下元素:元素描述计数对于给定多维数据集函数,此度量将计算已执行函数的数目.
耗时(毫秒)对于给定类型的多维数据集函数,此度量将计算执行所有函数所需的耗时.
}StatsStatsForServer}StatsStatsForServer维度仅在}StatsForServer控件多维数据集中使用.
启用性能监视后,该维度将跟踪性能统计信息,且该维度包含以下元素:元素描述垃圾内存在TM1Server运行期间,TM1不会将内存释放回操作系统.
然而,服务器会将未使用的内存保留到"垃圾站"中,以供以后使用.
此度量代表已分配给服务器但尚未使用的内存.
已用内存量服务器使用的总内存量(以字节为单位).
活动线程数这将测量TM1Server上活动的线程数.
每个客户端连接构成一个线程.
线程还用于执行杂项和进程.
连接的客户端数此统计信息将测量与TM1Server的活动连接数.
一个客户端可以同时具有与TM1Server的多个活动连接.
该度量中将对每个连接进行计数.
}Subsets_DimensionName}Subsets_维度用于跟踪每个维度中的子集.
此维度中的每个元素代表一个子集.
在创建和销毁维度时,动态且自动地创建和销毁}Subsets_维度.
在创建和销毁子网时,使用元素进行更新.
您可以使用此维度以编写在维度中的子网列表上进行迭代的TurboIntegrator进程.
此维度的属性可用于子集名称的本地化.
在创建或销毁子网时,服务器写入到此维度.
如果同时在不同的TurboIntegrator进程中创建两个或更多子网,那么这可能导致锁定.
为避免此锁定模式,应该尽可能创建临时子网,例如,在不需要对象在TurboIntegrator进程完成后存在时.
创建临时子网并不会更新}Subsets_维度.
有关更多信息,请参阅《TM1参考指南》中的SubsetCreate.
}TimeIntervals所有性能监视控件多维数据集都使用}TimeIntervals控制维度.
此维度包含168个数字元素,表示分钟级和小时级的时间间隔,如下所示:附录C控制维度131120个元素对应于当前小时和上一小时的分钟.
当前小时中的元素名为0M00、0M01、.
.
.
0M59.
上一小时中的元素名为1M00、1M01、.
.
.
1M59.
每分钟都进行性能监视多维数据集的采样.
新值将以当前小时按分钟连续存储.
小时完成后,当前小时的值将被复制到上一小时,并且当前小时的数据将被清除以接受新值.
48个元素对应于当前天和前一天的小时.
当前天中的元素名为0H00、0H01、.
.
.
0H23.
前一天的元素名为1H00、.
.
.
1H01、1H23.
每小时都会将分钟的新汇总(平均)值发布在相应的小时元素中.
某天结束后,当前天的数据将代替前一天的数据,并且当前天的数据将被清除以接受新数据.
启动性能监视器后,此维度中的小时和分钟将反映系统时钟时间.
例如,如果您在本地系统时间上午10:31启动了性能监视器,那么第一个接收值的}TimeIntervals元素是0M31,即当前小时的第31分钟.
下一个接收值的元素将是0M32.
}Views_CubeName}Views_维度用于跟踪每个多维数据集中的视图.
此维度中的每个元素代表一个视图.
在创建和销毁多维数据集时,动态且自动地创建和销毁}Views_维度.
在创建和销毁视图时,使用元素进行更新.
您可以使用此维度以编写在多维数据集中的视图列表上进行迭代的TurboIntegrator进程.
此维度的属性可用于视图名称的本地化.
在创建或销毁视图时,服务器写入到此维度.
如果同时在不同的TurboIntegrator进程中创建两个或更多视图,那么这可能导致锁定.
为避免此锁定模式,应该尽可能创建临时视图,例如,在不需要对象在TurboIntegrator进程完成后存在时.
创建临时视图并不会更新}Views_维度.
有关更多信息,请参阅《TM1参考指南》中的ViewCreate.
132IBMPlanningAnalytics:TM1Operations附录D由TM1处理的Excel事件某些MicrosoftExcel事件由用于Excel的IBMTM1加载项进行处理.
Excel事件名称描述NewWorkbook处理此事件可以跟踪打开的工作簿数.
WorkbookOpen处理此事件可以跟踪打开的工作簿数,也可以设置TM1工具栏和图表的状态.
WorkbookBeforeSave处理此事件可以检测从属TM1对象的修改状态并提示保存此类对象.
WorkbookBeforeClose处理此事件可以检测从属对象的修改状态并提示保存此类对象,还可以在卸载TM1加载项时卸载TM1工具栏和菜单栏.
为达到此目的,TM1将检测工作簿的保存状态、发布相应的"保存提示"消息框并处理当前工作簿的保存.
WorkbookActivate处理此事件可以正确设置TM1工具栏和菜单栏的状态.
WorkbookAddinUninstall处理此事件可以从工作簿移除TM1工具栏和菜单栏.
SheetActivate处理此事件可以更新TM1工具栏和菜单栏状态,以及更新特定于表的变量.
SheetDeactivate处理此事件可以检测工作表删除.
SheetSelectionChange处理此事件可以更新TM1菜单和工具栏状态.
SheetChange处理此事件可以使用对特定单元格进行的更改来更新TM1数据库.
SheetBeforeDoubleClick处理此事件以在特定TM1单元格上发布特定于TM1的对话框.
SheetBeforeRightClick处理此事件可以添加和修改Excel上下文菜单.
CopyrightIBMCorp.
2007,2019133134IBMPlanningAnalytics:TM1Operations声明本信息是为在全球提供的产品和服务编写的.
本材料的其他语言版本可从IBM获取.
但是,您可能需要拥有该语言的产品副本或产品版本,才能对其进行访问.
IBM可能在其他国家或地区不提供本文档中讨论的产品、服务或功能.
有关您当前所在区域的产品和服务的信息,请向您当地的IBM代表咨询.
任何对IBM产品、程序或服务的引用并非意在明示或暗示只能使用IBM的产品、程序或服务.
只要不侵犯IBM的知识产权,任何同等功能的产品、程序或服务都可以代替IBM产品、程序或服务.
但是,评估和验证任何非IBM产品、程序或服务的操作,由用户自行负责.
此文档可能描述未包括在您已购买的程序或许可证权利中的产品、服务或功能.
IBM可能已拥有或正在申请与本文档内容有关的各项专利.
提供本文档并未授予用户使用这些专利的任何许可.
您可以以书面形式将许可查询寄往:IBMDirectorofLicensingIBMCorporationNorthCastleDriveArmonk,NY10504-1785U.
S.
A.
有关双字节(DBCS)信息的许可查询,请与您所在国家或地区的IBM知识产权部门联系,或以书面形式将查询寄往:IntellectualPropertyLicensingLegalandIntellectualPropertyLawIBMJapanLtd.
19-21,Nihonbashi-Hakozakicho,Chuo-kuTokyo103-8510,Japan本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区:InternationalBusinessMachinesCorporation"按现状"提供本出版物,不附有任何种类的(无论是明示的还是暗含的)保证,包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证.
某些国家或地区在某些交易中不允许免除明示或暗含的保证.
因此本条款可能不适用于您.
本信息中可能包含技术方面不够准确的地方或印刷错误.
此处的信息将定期更改;这些更改将编入本资料的新版本中.
IBM可以随时对本出版物中描述的产品和/或程序进行改进和/或更改,而不另行通知.
本信息中对非IBMWeb站点的任何引用都只是为了方便起见才提供的,不以任何方式充当对那些Web站点的保证.
那些Web站点中的资料不是IBM产品资料的一部分,使用那些Web站点带来的风险将由您自行承担.
IBM可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任.
本程序的被许可方如果要了解有关程序的信息以达到如下目的:(i)允许在独立创建的程序和其他程序(包括本程序)之间进行信息交换,以及(ii)允许对已经交换的信息进行相互使用,请与下列地址联系:IBMSoftwareGroupAttention:Licensing3755RiversideDr.
Ottawa,ONK1V1B7Canada只要遵守适当的条款和条件,包括某些情形下的一定数量的付费,都可获得这方面的信息.
本资料中描述的许可程序及其所有可用的许可资料均由IBM依据IBM客户协议、IBM国际软件许可协议或任何同等协议中的条款提供.
CopyrightIBMCorp.
2007,2019135此处包含的任何性能数据都是在受控环境中测得的.
因此,在其他操作环境中获得的数据可能会有明显的不同.
有些测量可能是在开发级的系统上进行的,因此不保证与一般可用系统上进行的测量结果相同.
此外,有些测量是通过推算而估计的,实际结果可能会有差异.
本文档的用户应当验证其特定环境的适用数据.
涉及非IBM产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取.
IBM没有对这些产品进行测试,也无法确认其性能的精确性、兼容性或任何其他关于非IBM产品的声明.
有关非IBM产品性能的问题应当向这些产品的供应商提出.
所有关于IBM未来方向或意向的声明都可随时更改或收回,而不另行通知,它们仅仅表示了目标和意愿而已.
本信息仅用于规划目的.
在所描述的产品上市之前,此处的信息会有更改.
本信息包含在日常业务操作中使用的数据和报表的示例.
为了尽可能完整地说明这些示例,示例中可能会包括个人、公司、品牌和产品的名称.
所有这些名字都是虚构的,若现实生活中实际业务企业使用的名字和地址与此相似,纯属巧合.
版权许可:本信息包括源语言形式的样本应用程序,这些样本说明不同操作平台上的编程方法.
如果是为按照在编写样本程序的操作平台上的应用程序编程接口(API)进行应用程序的开发、使用、经销或分发为目的,您可以任何形式对这些样本程序进行复制、修改、分发,而无须向IBM付费.
这些示例并未在所有条件下作全面测试.
因此,IBM不能担保或暗示这些程序的可靠性、可维护性或功能.
这些样本程序"按现状"提供,不附有任何种类的保证.
对于因使用这些样本程序而造成的任何损失,IBM概不负责.
凡这些样本程序的每份拷贝或其任何部分或任何衍生产品,都必须包括如下版权声明:(贵公司的名称)(年).
此部分代码是根据IBMCorp.
的样本程序衍生出来的.
CopyrightIBMCorp.
(输入年份).
如果您正在查看本信息的软拷贝,图片和彩色图例可能无法显示.
此软件产品不使用cookie或其他技术来收集个人可标识信息.
产品信息本文档适用于IBMPlanningAnalyticsV2.
0.
0,并且还可能适用于后续发行版.
版权LicensedMaterials-PropertyofIBMCopyrightIBMCorp.
2007,2019.
USGovernmentUsersRestrictedRights–Use,duplicationordisclosurerestrictedbyGSAADPScheduleContractwithIBMCorp.
IBM、IBM徽标和ibm.
com是InternationalBusinessMachinesCorp.
在全球许多管辖区域注册的商标或注册商标.
其他产品和服务名称可能是IBM或其他公司的商标.
IBM商标的当前列表可以在Web上的"Copyrightandtrademarkinformation"中获取,网址为:www.
ibm.
com/legal/copytrade.
shtml.
下列各项是其他公司的商标或注册商标:Microsoft、Windows、WindowsNT和Windows徽标是MicrosoftCorporation在美国和/或其他国家或地区的商标.
Adobe、Adobe徽标、PostScript和PostScript徽标是AdobeSystemsIncorporated在美国和/或其他国家或地区的注册商标或商标.
注册商标Linux的使用依据LinuxFoundation的子许可证;LinuxFoundation是此标记全球范围所有者LinusTorvalds的独家被许可方.
UNIX是TheOpenGroup在美国和其他国家或地区的注册商标.
136声明Java和所有基于Java的商标和徽标是Oracle和/或其关联机构的商标或注册商标.
RedHat、JBoss、OpenShift、Fedora、Hibernate、Ansible、CloudForms、RHCA、RHCE、RHCSA、Ceph和Gluster是RedHat,Inc.
或其子公司在美国和其他国家或地区的商标或注册商标.
Microsoft产品截屏需经Microsoft的允许才能使用.
声明137138IBMPlanningAnalytics:TM1OperationsIBM