TM1 tm1s.cfg配置参数参考

tm1s.cfg  tm1server的配置文件。

###########################################      以下根据情况修改         ##############################
## Admin Server的IP; 参数类型:必需,静态 ; 默认空
## 格式 win: AdminHost=hostname1;hostname2 或 linux: AdminHost=hostname1:hostname2
AdminHost=

## 设置 TM1 Server 的名称 ; 参数类型:可选,静态;默认Local
ServerName=server名称

## 指定服务器从中装入多维数据集、维度和其他对象的数据目录,可以列出多个数据目录,用分号进行分隔 ;参数类型:必需,静态
DataBaseDirectory=data

## 指定服务器保存其日志文件的目录 ;参数类型:可选,静态;默认=DataBaseDirectory。(如果使用了空格,那么必须使用引号引起来)
LoggingDirectory=logs

## 设置服务器端口号,以区分在同一台计算机上运行的多个服务器。参数类型:可选,静态; 有效的端口号介于 5001 和 65535 之间。如果 Tm1s.cfg 文件不包含 PortNumber 参数,那么 TM1 Server 会使用端口 5000
PortNumber=17422

## 设置 TM1 Server 用于侦听入局 HTTP(S) 请求(REST API 服务)的端口号;  参数类型:必需,静态; 默认5001
HTTPPortNumber=8022

## 确定一个用于接受客户端消息的二级端口,该消息关于是否继续或最终取消一个未耗尽线程储备的冗长操作进程;参数类型:可选,静态(可更改),动态设置; 默认启动时将自动动态分配此端口号
ClientMessagePortNumber=17492

## 为 TM1 REST API 的认证会话设置超时值(以分钟为单位),超时之后提示401;参数类型:可选,动态;默认20
HTTPSessionTimeoutMinutes=20

## 指定客户端连接的超时限制(以秒为单位);参数类型:可选,动态; 一天
IdleConnectionTimeOutSeconds=1800

## 设置用户访问视图时分配的最大内存量(以 MB 为单位);参数类型:可选,动态;默认500 
MaximumViewSize=1000

## 设置服务器上允许用户登录尝试失败的最大次数;参数类型:可选,动态;默认=3
MaximumLoginAttempts=5 

## 在关闭日志文件并创建新文件以前,指示该日志文件的文件大小上限 ; 参数类型:可选,动态 ; 默认100 MB 最小1 KB 最大2 GB ; 
AuditLogMaxFileSize=100 MB

## 要用于单个操作的线程数; 参数类型:可选,动态;默认-1,设置为服务器可用的最大线程数
## 如果是正数n,表示线程数T=n ;如果是负数-n,T=M-n+1,M是操作系统总cpu个数;MTQ=1 或 MTQ=0,说明多线程优化已关闭。
MTQ=23

## 使用此参数可调优多线程查询处理。此参数指定在检查是否需要多线程拆分之前所要处理的单元格数 ; 参数类型:可选,动态 ;默认10000
#MTQ.OperationProgressCheckSkipLoopSize=10000
## 使用此参数可调优多线程查询处理。如果将此参数设置为 False,将不允许对单个单元格合并进行多线程查询处理。参数类型:可选,动态;默认True
#MTQ.SingleCellConsolidation=True
## 使用此参数可在计算要用作 TI 数据源的视图时启用多线程查询处理。如果 MTQ 参数的值为 1(或 OFF),那么此功能将完全禁用,不能覆盖。
## 参数类型:可选,动态;默认T
#MTQQuery=T

## 将 RunningInBackground=T 这一行添加到 tm1s.cfg 后,UNIX 上的 IBM® TM1® Server 将以后台方式运行。参数类型:可选,静态
## 如果使用 startup_tm1s.sh 和 shutdown_tm1s.sh 脚本来启动和停止 TM1 Server,请设置 RunningInBackground=T。
#RunningInBackground=T

## 使第三方 Java 库可用于tm1,可以指定多个引用,用分号进行分隔;参数类型:可选,静态;
JavaClassPath=C:\Program Files\ibm\cognos\tm1_64\bin64\javaextensions\user\lib\poi-3.14-20160307.jar

## 此参数设置 (jvm.dll) 的路径,是从 TurboIntegrator 运行 Java 的必要参数;参数类型:可选,静态
JavaJVMPath=C:\Program Files\ibm\cognos\tm1_64\jre\bin\j9vm\jvm.dll

###########################################      以下不常修改         ##############################

## 打开 (T) 或关闭 (F) 审核日志 ; 参数类型:可选,动态 ; 默认F
AuditLogOn=T

## 启用后,此参数允许您使用完全相同的 AREA 定义在单独行上指定 N: 和 C: 级别的规则表达式 ; 参数类型:可选,静态 ; 默认F?
AllowSeparateNandCRules=T

## 指示当运行审核日志查询和检索结果集时,TM1 可以使用的最大内存量; 参数类型:可选,动态 ; 默认100 MB 最小1 KB 最大2 GB ; 
AuditLogMaxQueryMemory=100 MB

## 指示 TM1 在将事件从临时审核文件移到最终审核日志之前等待的最长时间(以分钟为单位) ; 参数类型:可选,动态 ;默认60,最小1
AuditLogUpdateInterval=60

## 如果设置了此参数,那么系统会强制发生数据更改时重新对数据加载程序语句求值。参数类型:可选,静态;默认F?
ForceReevaluationOfFeedersForFedCellsOnDataChange=T

## 此参数设置 IBM® TM1® Server 将使用的用户认证方式;参数类型:可选,动态;1-标准 TM1
IntegratedSecurityMode=1

## 指示 TM1 用于在网络上标识 IP 地址的因特网协议;参数类型:可选,静态;默认ipv4,可设置为dual,ipv6
IPVersion=ipv4

## 指定要传递给 Java 虚拟机 (JVM) 的参数的列表。参数由空格和横线字符分隔。例如,JavaJVMArgs=-argument1=xxx -argument2=yyy。
## 参数类型:可选,静态 如果要调试进程,那么可指定以下参数
#JavaJVMArgs=-Xrunjdwp:transport=dt_socket -server=y -suspend=n -address=1044

## 要使用数据加载程序来缩短多维数据集的重新装入时间,请将 PersistentFeeders 配置参数设置为 true (T),以将已计算的数据加载程序存储到 .feeders 文件中。
## 参数类型:可选,静态
PersistentFeeders=T

## 此参数会确定用户是否可以选择取消冗长视图计算。参数类型:可选,静态;默认T 
ProgressMessage=T

## 此参数用于管理 TM1 Server 处理子集的锁定行为的方式。参数类型:可选,动态;默认=-1 ;
## 当针对子集的其他请求暂挂时,TM1 Server 从不释放对该子集的锁定。这是缺省设置。它可优化单一用户的视图性能,但代价是多用户并发。
## 设置为大于零 (0) 的任何值时,TM1 Server 会在其他的子集请求暂挂时释放子集上的锁,然后在处理暂挂的请求之后要求进行锁定。当多个用户尝试访问同一子集,特别是该子集包含超过 100 个元素时,此设置可提高性能。
SubsetElementBreatherCount=1

## 启用对 TM1® Server 实例中运行的线程的动态日志记录。参数类型:布尔值,可选,动态;默认F ;必须在启动 TM1 Server 之前将 TopLogging=T 添加到 tm1s.cfg 文件,才能启用日志记录。
TopLogging=T
## 指定 TopLogging 记录器的日志记录频率(时间间隔,以秒为单位);参数类型:整数,可选,动态;默认=5;将此参数设置为 0 会禁用记录器。
TopScanFrequency=60
## 启用对每个线程的当前处理状态的日志记录;参数类型:可选,动态;默认T
TopScanMode.Threads=T

## 启用或禁用 TM1 上的 SSL。参数类型:可选(对于 SSL 是必需的),静态;默认T
UseSSL=F

## 如果将 IBM® TM1® Server 配置为使用集成登录,那么 SecurityPackageName 参数会定义安全性软件包,以认证您在 Microsoft Windows 中的用户名和密码。
#参数类型:可选,静态 ;请使用 Kerberos,除非您在本地运行 TM1
SecurityPackageName=Kerberos

## 设置执行自动保存服务器数据操作的时间(日);在随后的每天同一时间保存该多维数据集。与正常关闭时的情况一样,SaveTime 会重命名日志文件,打开新的日志文件,然后在保存后继续运行。
## 将 TM1® Server 作为 Windows 服务运行时,SaveTime 参数不可用。参数类型:可选,动态 ;
## 格式为 dd:hh:mm dd --  是自今天起系统开始自动保存数据的天数。例如,00 表示今天,01 表示明天 ;hh:mm 是 24 小时格式的每日时间。
Savetime=

###########################################      以下可选         ##############################

## 为用户提供对杂项的读取访问权限以及激活、停用和重新计划杂项的权限 ; 参数类型:可选,静态 ; 默认F?
#AllowReadOnlyChoreReschedule=T

## 在计算视图只包含规则计算值时,AllRuleCalcStargateOptimization 参数可提高性能 ; 参数类型:可选,静态 ; 默认F 
#AllRuleCalcStargateOptimization=T

## 将 MaximumViewSize 应用于整个事务而不是个别计算 ; 参数类型:可选,动态; 默认F 
#ApplyMaximumViewSizeToEntireTransaction=T

## 确定是要自动设置多维数据集依赖关系,还是必须手动识别每个多维数据集的多维数据集依赖关系 ; 参数类型:可选,静态 默认T
#AutomaticallyAddCubeDependencies=T

## 定义单个单元格或 Stargate 视图必需的最小规则计算数目,超出此数目后, TM1 会存储计算以供在当前服务器会话期间使用 ; 默认50
#CalculationThresholdForStorage=50

## 限制在 Cube Viewer 中由“检查数据加载程序”检查的单元格数目 ; 参数类型:可选,动态 ; 默认3,000,000
#CheckFeedersMaximumCells=1,000,000

## 指定可以与 TM1 连接的最高/低客户端版本;参数类型:可选,动态; 最高 默认=当前安装的服务器版本,最低 默认=8.4.00000
## 格式 m.n.tffhh, m = 主版本号,n = 次版本号,t = 维护版本号,ff = 修订包号,hh = 热修订号
#ClientVersionMaximum=9.4.10305
#ClientVersionMinimum=8.4.00000

## 禁用 TM1 内存管理器使用的内存高速缓存 -- 启用此参数,仅用于调试内存泄漏。启用该参数后,服务器性能可能会降低。 ; 
## 参数类型:可选,静态 ; 默认F
#DisableMemoryCache=F

## 确定用户是否可以在服务器上使用沙箱;参数类型:可选,动态;默认F 所有用户可以使用沙箱功能
#DisableSandboxing=F

## 指定服务器自动关闭的时间 ; 参数类型:可选,动态;格式为 dd:hh:mm ,dd 是自今天起的天数-00 表示今天,01 表示明天等,hhmm 是 24 小时格式的每日时间
#DownTime=01:03:30 指定在明天的凌晨 3:30 关闭服务器。

## 指定启用还是禁用创建多个层级;参数类型:可选(对于多个层级是必需的),静态;默认F 如果是使用多个层级,请将该参数设置更改为 T
EnableNewHierarchyCreation=T

## 指定是否启用虚拟沙箱维度功能;参数类型:可选,动态;默认F 
#EnableSandboxDimension=F

## 指定是启用还是禁用 TurboIntegrator 调试功能;参数类型:可选,动态;默认F
EnableTIDebugging=T

## 指示事件记录器是否已启用;参数类型:可选,动态;默认T
#EventLogging=T

## 指定检查线程集合的时间段,其中 1 是最小数字,0 表示禁用扫描;参数类型:可选,动态;默认1
#EventScanFrequency=1

## 当 Web 服务器上未安装 Microsoft Excel 时,允许将 Microsoft Excel 文件发布到 TM1 Web 以及将 Microsoft Excel 文件从 TM1 Web 导出。
## 请在您具有连接至 TM1 10.2.2 Server 的 TM1 10.1 Client 时,启用 ExcelWebPublishEnabled 参数
## 参数类型:可选,动态 ;默认F
#ExcelWebPublishEnabled=F

## 网络问题会导致事务日志更新失败,这可能会强制 TM1 Server 关闭。此配置参数指定受影响日志文件的目录路径 ;默认=logs目录
## 指定重试尝试次数,当事务日志更新失败时,定义重试尝试次数,如果在指定的重试次数之后,网络故障仍然存在,那么 TM1 Server 将自行终止;默认5
## 指定重试尝试之间的时间延迟(以毫秒为单位) 默认2000
## 参数类型:可选,动态;
#FileRetry.FileSpec=logs
#FileRetry.Count=5
#FileRetry.Delay=2000

## 指定用于存储索引文件(包括书签文件)的文件夹;参数类型:可选,静态;默认=DataBaseDirectory
#IndexStoreDirectory=

## 此参数允许您为单个 IBM® TM1® Server 指定 IPv4/IPv6 地址;参数类型:可选,静态
#IPAddressV4=""
#IPAddressV6=""

## 设置用于 IBM® TM1® Server 的语言。此参数适用于服务器生成的消息,并且当您将服务器作为应用程序(而不是 Windows 服务)运行时会在服务器对话框的用户界面中使用。
## 参数类型:可选,静态
#Language=eng

## 此配置参数确定当 TM1 Server 启动时是否装入专用子集。参数类型:可选,静态;默认F 
#LoadPrivateSubsetsOnStartup=F

## 此配置参数启用当 TM1® Server 启动时是否装入公共子集和视图,并使其保持装入,以避免在首次使用期间发生锁定争用。参数类型:可选,静态;默认T
#LoadPublicViewsAndSubsetsAtStartup=T

## 启用此参数时,IBM® TM1® Server 进程使用的内存页将保留在内存中(锁定),并且在任何情况下都不会将其调出到磁盘。这将使这些页面在内存中保留一段空闲时间段,使得在此空闲时间段之后对 TM1 数据的访问速度更快。
## 参数类型:可选,静态 ;默认F;此参数仅适用于在 Microsoft® Windows 64 位操作系统上运行的 TM1® Server。
#LockPagesInMemory=T

## 指定多维数据集装入和服务器装入的数据加载程序计算阶段是否为多线程,以便可以并行使用多个处理器核心。这会导致服务器装入时间缩短。参数类型:可选,静态
## 通常,此参数设置为等于 (可用处理器核心数) - 1 时,可实现最佳性能。(MaximumCubeLoadThreads 的最大值为 32。) 默认=0
## **启用 MaximumCubeLoadThreads 后,Cognos TM1 无法管理数据加载程序的计算顺序。由于多线程环境中存在某些求值顺序依赖性,因此可能出现处理顺序对应用程序产生不利影响的情况
#MaximumCubeLoadThreads=0

## 设置为个人工作区或沙箱分配到每位用户的最大 RAM 内存量(以 MB 为单位);参数类型:可选,动态;默认500 
#MaximumUserSandboxSize=500

## 指定 ODBC 接口库(.so 文件)在 UNIX 上的名称和位置。参数类型:可选(在 UNIX 上支持 ODBC 时是必需的),静态;
#ODBCLibraryPath=/usr/local/lib/unixODBC/lib/libodbc.so

## 指定访问服务器的客户端的最小密码长度。参数类型:可选,动态;默认未设置
#PasswordMinimumLength=8

## 如果在数据目录以外的其他目录中出现了日志,此参数表示临时未处理的审核日志的日志文件的位置。参数类型:可选,动态;默认=DataBaseDirectory
#RawStoreDirectory=目录

## 如果“取消”操作的等待时间过长,那么 ReceiveProgressResponseTimeoutSecs 参数会配置服务器切换客户端连接并释放资源。参数类型:可选,动态
#ReceiveProgressResponseTimeoutSecs

## 服务器装入按规则推导的数据时阻止单元格被覆盖。如果此参数设置为 T,那么每当服务器装入时,按规则推导的单元格都会被清零。这些单元格中的数据值将丢失
## 参数类型:可选,静态 默认F 
#RulesOverwriteCellsOnLoad=F

## 设置为 False 时,会将写入数据加载程序文件的操作延迟到调用 SaveDataAll 和 CubeDataSave 时执行,而不是在更改规则后以及在服务器启动时生成数据加载程序后立即更新这些文件。
## 参数类型:可选,动态 ;默认True
#SaveFeedersOnRuleAttach=True

## 生成一个日志,其中包含有关 TM1 的与集成登录相关联的安全活动详细信息。仅当 TM1 Server 配置为使用集成登录时,ServerLogging 参数才有用。参数类型:可选,动态
#ServerLogging=F

## StartupChores 是一个配置参数,标识在服务器启动时运行的杂项列表。如果未指定此参数,那么将不会运行杂项。参数类型:可选,静态
#StartupChores=ChoreName1:ChoreName2:ChoreName3:ChoreNameN

## 启用 Microsoft Excel 序列日期,而不是 TM1® 序列日期。参数类型:可选,静态;默认F
## 启用了 UseExcelSerialDate 时,TM1 规则函数和 TurboIntegrator 函数均使用 1900 年 1 月 1 日作为序列数据的基准时间,而不使用 1960 年 1 月 1 日。
#UseExcelSerialDate=F

## 启用或禁用 IBM® TM1® Server 上的视图合并优化。参数类型:可选,静态;默认T
#ViewConsolidationOptimization=T
## 此参数定义了用于启用了 ViewConsolidationOptimization 参数时实现视图合并优化的方法。参数类型:可选,静态 
## 默认ARRAY,可设置为 ARRAY  或 TREE
#ViewConsolidationOptimizationMethod=ARRAY


################################## 以下参数没有找到 待定 ##################################
GroupsCreationLimit=50
LicenseMetricTime=00:00:00
ParallelInteraction=T
ServerCAMIPVersion=ipv4
DistributedPlanningOutputDir=tunit

上一篇: