附录 C
Calendar Server 5.x 到 6.0 的升级/迁移进程

本附录介绍了如何将 Sun™ ONE 或 iPlanet™ Calendar Server 5.x 升级/迁移到 Calendar Server 6.0，包括：

用于升级到 Calendar Server 6.0 的升级/迁移进程
用于将更改合并到 Calendar Server 6.0 XSL 文件的 XSL 提示

 

---

升级/迁移进程

升级到 Calendar Server 6.0 的步骤：

在安装了 Calendar Server 5.x 的服务器上，更改到 /opt/SUNWics5/cal/sbin 目录，并停止 Calendar Server 5.x：

./stop-cal

备份以下 Calendar Server 5.x 目录和文件：
日历数据库目录 - 默认位置是：
/var/opt/SUNWics5/csdb。
Calendar Server 日志目录 - 默认位置是：
/var/opt/SUNWics5/logs。
ics.conf 配置文件 - 默认位置是：
/opt/SUNWics5/cal/bin/config/ics.conf。
备份所有已自定义的 Calendar Server 5.x 文件，包括：
/opt/SUNWics5/cal/bin/data 中的用户界面 (UI) XSL 文件
邮件格式文件 - 默认位置是：
/opt/SUNWics5/cal/bin/config/language/
default.html 文件 - 默认位置是：
/opt/SUNWics5/cal/bin/html/language/
HTML 文件 - 例如位于：
/opt/SUNWics5/cal/bin/html/language/
时区文件，例如 timezones.ics 和 change_timezone.xml。

language 目录包括用于您要使用的语言的文件。例如，en 表示英语、de 表示德语、es 表示西班牙语、fr 表示法语、ja 表示日语、zh-TW 表示繁体中文，zh-CN 表示简体中文。

更改到 /opt/SUNWics5/cal/ 目录，并卸载 Calendar Server 5.x。您必须以超级用户（root 用户）身份运行。例如：

./uninst

删除 /opt/SUNWics5 目录下的所有文件。
运行 Java Enterprise System 安装程序，以在 /opt/SUNWics5 目录中安装 Calendar Server 6.0。有关信息，请参阅《Sun Java Enterprise System 安装指南》。
更改到 /opt/SUNWics5/cal/sbin 目录，运行 comm_dssetup.pl 实用程序，以将 Sun ONE Directory Server 5.x 配置为与 Calendar Server 6.0 一起使用。有关 comm_dssetup 的信息，请参阅 Directory Server 设置脚本 (comm_dssetup.pl)。
运行 Calendar Server 6.0 配置程序 (csconfigurator.sh) 以创建新的 ics.conf 配置文件。有关更多信息，请参阅 Calendar Server 配置程序 (csconfigurator.sh)。
如果要保留 5.x 配置，请将 ics.conf 文件从备份位置或磁带复制到 /etc/opt/SUNWics5/config/ics.conf 文件。
为 ics.conf 文件设置 UNIX 用户和组 ID（默认值为 icsuser 和 icsgroup）以及权限。例如：

chown icsuser:icsgroup /opt/SUNWics5/cal/config/ics.conf
chmod 600 /opt/SUNWics5/cal/config/ics.conf

运行 cs5migrate 实用程序，以将 Calendar Server 5.x 数据库迁移到 6.0。有关信息，请参阅 cs5migrate 实用程序。
如果 cs5migrate 迁移成功，请将迁移的 6.0 数据库复制到 /var/opt/SUNWics5/csdb 目录。确保 /csdb 目录中所有文件的所有者为 icsuser 和 icsgroup（或在 ics.conf 文件中指定的用户 ID 和组 ID）。
Calendar Server 6.0 XSL。XML、HTML 和邮件格式文件与 5.x 版本有很大的不同。如果您在步骤 3 中保存了 5.x 文件，则必须手动将 5.x 文件的自定义更改合并到 6.0 文件。有关将更改合并到 XSL 文件的提示，请参阅 XSL 提示。
更改到 /opt/SUNWics5/cal/sbin 目录，并启动 Calendar Server 6.0.x：

./start-cal

使用 Calendar Express 登录到 Calendar Server 6.0，并确保您能够查看 Calendar Server 组件（事件和代办事件）。

 

---

XSL 提示

如果您要将更改合并到 Calendar Server 6.0 XSL 文件，请遵循以下提示和规则以避免常见错误：

访问属性时，请勿使用错误的语法。例如：

./element@attribute

应为：

./element/@attribute

@ 号前面的斜线 (/) 很重要。

请勿将斜线 (/) 放在节点的末尾。例如：

/node1/node2/

应为：

node1/node2

请勿使用不匹配的左括号和右括号。例如，要具有取决于值的不同背景颜色，您可能需要在不同的 <xsl:when> 语句中写入多个 <TD bgcolor={$bgcolor_variable}>，所有变量都要以单个 </TD> 结尾。

如果分析器报告括号不匹配，您可能需要将 <TD> 写为 &lt;TD&gt;。

但也可以使用以下方法之一：

定义一个新的变量，并根据不同的状态设置变量的值，然后将这个新的变量用于 <TD> 行中。
或者，使用用于该 <TD> 的 <xsl:attribute> 单独定义 bgcolor。

在任何一种情况下，您都可以仅以一个 <TD> 行结束。一般情况下，请勿使用“线性化”标记，例如 &lt; TR>。

请勿在应闭合标记之前闭合标记。例如：

<INPUT type="checkbox" name="ceGroupInviteAll"/>     <xsl:choose>       <xsl:when test="/calendar/usrctx/userprefs@ceGroupInviteAll='0'">         </xsl:when>           <xsl:otherwise>           <xsl:attribute name="checked"/>       </xsl:otherwise>     </xsl:choose>

请注意第一行末尾的斜线 (/)。它用于闭合 INPUT 标记；以便大多数分析器忽略那些以后检查的属性。执行此操作的正确方法是删除第一行中最后的斜线 (/)，并在结束时添加 </INPUT>。例如：

<INPUT type="checkbox" name="ceGroupInviteAll">     <xsl:choose>       <xsl:when test="/calendar/usrctx/userprefs@ceGroupInviteAll='0'">         </xsl:when>           <xsl:otherwise>           <xsl:attribute name="checked"/>       </xsl:otherwise>     </xsl:choose> </INPUT>

请勿使用未声明的变量。确保在使用这些变量之前先声明这些变量。某些分析器忽略未声明的变量，但其它分析器将它们标记为错误。
请勿在变量名称中使用空格。例如：

<xsl:variable name="test ">

请勿对多个变量使用同一个名称。请勿以不同级别重复声明同一变量。
请勿使用 position(.)。它应为 position()。
请勿使用“//node”。例如：

<xsl:value-of select="//panel[@name='weekgrid']/weekcal[1]/weekday[1]/command[2]"/>

请勿使用双斜线 (//)。

请勿使用实体，例如 &nbsp; 和 &amp;。它们应被声明为 DOCTYPE 行中的实体。例如：

<!DOCTYPE xsl:stylesheet [<!ENTITY nbsp "&#160;">]>

请勿使用十六进制值。必须将 &#149; 等值声明为 DOCTYPE 行中的实体。例如：

<!DOCTYPE xsl:stylesheet [<!ENTITY nbsp "&#160;"> <!ENTITY bullet "&#149;">]>

要在 xsl 中使用 #149，请将其写为：

<xsl:text>&bullet;</xsl:text>

请勿使用错误的 stylesheet 标记。将以下内容用于您写入的所有新的 xsl 文件：

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

请勿在 <xsl text> 中使用注释。例如：

<xsl:text><!-- This is a comment --></xsl:text>.

请勿在 <xsl:text> 节点中写入注释。

请勿在模板规则中使用太复杂的模式。不要使用太复杂和太长的规则，请使用“and”和“or”，并尝试在规则中使用 <xsl:choose> 以使这些规则更简单。
请勿使用计数来检验是否存在。要检验节点是否存在，不应检验 count(node) 是否大于零，只需检验节点是否存在。
请勿使用太多的 XSLT 函数。尝试减少 XSLT 函数（例如 string-length）的使用，特别是在经常使用的模板中。
请勿使用 for-each。在需要的位置尝试使用 apply-templates，而不要使用 for-each。这会使 XSLT 的式样更好、更自然。
请勿在开头或结尾使用 [-sibling] 轴。
请勿在同一模板中多次试用同一节点。如果需要多次试用同一节点，请试用一次并将结果保存在变量中。
请勿在条件表达式中使用尖扩号。请在条件表达式中使用 &lt; 和 &gt;，而不要使用“<”和“>”。
请勿将 value="" 用于单选按钮和复选框：例如：

<xsl:attribute name="checked" value=""/>

应为：

<xsl:attribute name="checked"/>

请勿使用不存在的节点和属性。例如，如果在 /calendar/usrctx 节点下不存在 usrctx 和 intervalMinutes：

/usrctx/@intervalMinutes

请勿在打开和闭合 BR 之间使用 xsl 代码。例如：

<BR> <xsl:if>.......</xsl:if></BR>

对于一个空行，请仅使用 <BR/>。

请勿使用太多的空格或太多的缩进。尽管空格使 xsl 更具可读性，但它使 xsl 的工作方式有所不同。
请勿在 i18n.xsl 文件中使用太多的变量。而且，请勿声明在应用程序中未使用的变量。

上一个      目录      索引      下一个

---

版权所有 2003 Sun Microsystems, Inc.。保留所有权利。