notes.ini – Sanmao的幸福(?)生活

调整 XPages 相关的内存设置

Sanmao — Wed, 06 Jun 2012 03:31:33 +0000

XPages 为我们带来了新的开发体验，但其服务器端组件树、服务器端状态存储等特性会消耗大量的内存。Domino 8.5.2 版之后，为 HTTP JVM 分配的内存默认为64M，如果使用了较多的 XPages 的话，一般来说这个默认值是不够的。可以通过以下 Notes.ini 参数调整（增加到256M）：

HTTPJVMMaxHeapSize=256M
HTTPJVMMaxHeapSizeSet=1

如果使用了较多的XPages，通常来说32位操作系统推荐设置为256M，64位操作系统+32位Domino为1024M，64位操作系统+64位Domino为物理内存的1/4。当然具体环境请酌情调整。

加快 XPages 第一次访问时的速度

Sanmao — Wed, 06 Jun 2012 03:02:58 +0000

在实际使用 XPages 的过程中，我们发现第一次访问时会非常慢，有时候甚至要等5秒钟以上。这是因为第一次访问时需要加载一些 XPages 相关的 class，所以耗时比较长。

为了解决这个问题，在 Domino 8.5.3 中引入了 XPages 预加载功能。通过以下 Notes.ini 参数实现：

XPagesPreload=1
XPagesPreloadDB=myDb.nsf/myXPage.xsp,myDb.nsf/test.xsp

请参考：Domino Designer 8.5.3 中的新增功能

在 NSD 中查看 LotusScript 的调用堆栈

Sanmao — Wed, 30 Nov 2011 08:57:33 +0000

通过添加以下 Notes.ini 参数，可以抓取 LotusScript 的调用堆栈，帮助我们分析宕机等问题：

DEBUG_LS_DUMP=1

结果格式如下：

LotusScript Call Stack
<@@ ------ LotusScript Interpreter -> Call Stack for [ nlnotes: 0ef8: 1494] (Time 10:38:14) ------ @@>

[3] COUNTVIEWS
[2] GETDBINFO @ line number 7
[1] COUNTDOCUMENTS @ line number 12
[0] INITIALIZE @ line number 2

请参考：Examining LotusScript call stack after a crash or hang with NSD

通过服务器命令批量拷贝数据库

Sanmao — Thu, 21 Jul 2011 09:27:49 +0000

首先在控制台输入以下命令，启用额外的数据库拷贝命令（不是群集也可以用）：

set config CLUSTER_ADMIN_ON=1

无需重启服务器，以下命令就可以用于拷贝数据库了：

CL copy serverA!!db1.nsf serverB!!db2.nsf（将 serverA 上的 db1 新建拷贝到 serverB 的 db2）

CL copy serverA!!db1.nsf serverB!!db2.nsf REPLICA（将 serverA 上的 db1 新建副本到 serverB 的 db2）

CL copy serverA!!db1.nsf serverB!!db2.nsf TEMPLATE（将 serverA 上的 db1 新建拷贝为模板到 serverB 的 db2，不含文档）

CL copy db1.nsf db2.nsf（将 db1 从当前服务器新建拷贝到 db2）

将各个拷贝数据库的命令写成一个文本文件copydb.txt，保存到服务器的程序目录：

CL copy db1.nsf bak/db1.ntf TEMPLATE

CL copy db2.nsf bak/db2.ntf TEMPLATE

然后在服务器控制台输入：

< copydb.txt

就完成了批量备份数据库设计为模板库的工作。

请参考：Cluster_admin_on

nsd.sh 导致 cpu 100%占用

Sanmao — Wed, 22 Dec 2010 07:17:13 +0000

今天我们的 Linux 测试服务器突然开始响应缓慢，而前几天都还是好的。连到服务器上发现 cpu 占用一直是100%，而占用的进程是很多个 nsd.sh。最终通过搜索技术支持网站找到原因：Domino 数据目录下有不符合命名规范的数据库（如“~”、“/”、中文字符等）。解决方法如下：

重命名不符合规范的数据库文件
添加 notes.ini 参数 DISABLE_SAVENSDCONFIG=1

请参考：Multiple nsd.sh processes running causing high cpu usage

更改 Domino 生成 HTML 页面的 DOCTYPE

Sanmao — Wed, 08 Dec 2010 10:52:40 +0000

我们知道所有的浏览器都有怪癖模式（Quirks Mode）和标准模式（Standards Mode）。怪癖模式是为了兼容老旧的网页，去模拟早期浏览器（如 IE5.5）的非标准实现；而标准模式会尽可能的按照标准去执行。而激活不同模式的关键正是 HTML 页面的 DOCTYPE。

现在已经是 2010 年了，可是 Domino 生成的默认的 DOCTYPE 还是：

在目前所有流行的浏览器下它都会触发怪癖模式。所以我们需要以下 Notes.ini 参数来改掉它：

DominoCompleteDoctype = 0 或 1 或 2

0 = !DOCTYPE HTML PUBLIC “W3CDTD HTML 4.01 TransitionaEN”
1 = !DOCTYPE HTML PUBLIC “-W3DTD HTML 4.01 TransitionalEN” “http://www.w3.org/TR/html4/loose.dtd”
2 = !DOCTYPE HTML PUBLIC “W3CDTD HTML 4.0EN” “http://www.w3.org/TR/html4/strict.dtd“

我们只是想要触发标准模式，那么用 1 就可以了。不过由于是通过 Notes.ini 修改的，肯定会影响到所有的表单，想要更改个别的表单可以使用 $$HTMLFrontMatter 域。

参考链接：Working with the DOCTYPE，HTMLOptions and HTMLTagAttribute fields，用doctype激活浏览器模式

为 Java 代理设置编译器的”-target”参数

Sanmao — Tue, 24 Aug 2010 03:02:26 +0000

从 8.0 版开始，出于对旧版本兼容性的考虑，在 Designer 中编写 Java 代理时，编译器会生成与 Domino 6(JVM 1.2) 兼容的 class 文件。我们可以通过以下 Notes.ini 参数来修改它（以 1.5 为例，重启客户端生效）：

JavaCompilerTarget=1.5

对于兼容版本的设定，这里有个权衡需要把握：版本设定的越高可用的新特性越多，但同时能够兼容的 Domino 版本越少。大家可以按照实际需要，参考下表来选择。

JavaCompilerTarget=	等同的 javac 参数	兼容的 Notes/Domino 版本
1.1	-source 1.3 -target 1.1	N/D 5.0 及以上
1.2	-source 1.3 -target 1.2	N/D 6.0 及以上
1.3	-source 1.3 -target 1.3	N/D 6.0 及以上
1.4	-source 1.4 -target 1.4	N/D 7.0 及以上
1.5	-source 1.5 -target 1.5	N/D 8.0 及以上
1.6	-source 1.6 -target 1.6	N/D 8.5 及以上
CurrentJavaVersion （取当前版本 Notes 附带的 Java版本，以 N/D 8.5 为例，此值等同于 1.6）	-source 1.6 -target 1.6	N/D 8.5 及以上

参考链接：JavaCompilerTarget

禁用 Domino HTTP 服务器的 Trace 方法

Sanmao — Tue, 27 Jul 2010 09:16:44 +0000

在最近客户提交的一份安全检查报告中，有一条是检测到 Domino HTTP 服务器启用了 Trace 方法，可能存在安全漏洞。虽然在 IBM 技术支持文档中宣称此处不存在安全漏洞，但也提供了禁用它的方法：

使用了 Internet 站点配置：在站点配置文档的配置标签页中，禁止 Trace 方法
未使用 Internet 站点配置：在 Notes.ini 中加入一行 HTTPDisableMethods=TRACE

请参考：How to enable or disable HTTP methods

通过 Notes.ini 参数禁用 xPage 功能

Sanmao — Thu, 01 Jul 2010 09:05:23 +0000

Domino 8.5 版引入了新的设计元素：xPage。我承认这是个很强大的东西，但在很多生产服务器我们还没有用到它。而我向来有关闭这种不使用的功能的洁癖，所以通过以下参数可以将其禁用：

INOTESDISABLEXPAGECMD=1

设置参数后重启 HTTP 服务即可生效。

记录 Web 代理的执行

Sanmao — Wed, 09 Jun 2010 01:55:57 +0000

在开发过程中我们经常使用 msgbox 语句来调试代理，由于种种原因有时这些调试语句会被带入测试/生产环境。这种问题一旦发生，一般来说很难定位它究竟来自哪个代理。

此时我们可以在 notes.ini 中添加

Debug_Agent_Thread=1

参数来打开 Web 代理调试功能，在代理开始和结束时，控制台会打印出代理的名称、所在数据库以及 thread id。有了这些信息，我们就很容易定位调试语句的来源了。

请参考：Lotus Notes.ini Entry – Debug_Agent_Thread