附錄 C
Calendar Server 5.x 至 6.0 升級/移轉程序

本附錄說明如何將 Sun™ ONE 或 iPlanet™ Calendar Server 5.x 升級/移轉至 Calendar Server 6.0，包括：

升級/移轉程序，用於升級至 Calendar Server 6.0
XSL 提示，用於將變更併入 Calendar Server 6.0 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 安裝程式，將 Calendar Server 6.0 安裝在 /opt/SUNWics5 目錄中。如需相關資訊，請參閱「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 和群組 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：

./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> 行中使用這個新變數。
或者，使用 <xsl:attribute> 為 <TD> 單獨定義 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] 軸或後面的 [-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 檔案中使用過多變數。同樣，請勿宣告不在應用程式中使用的變數。

上一個      目錄      索引      下一個

---

Copyright 2003 Sun Microsystems, Inc.。版權所有。