付録 C
Calendar Server 5.x から 6.0 へのアップグレード / 移行プロセス

この付録では、Sun^TM ONE または iPlanet^TM 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 設定 Perl スクリプト(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.0 のファイルから6.0 のファイルに手作業でマージする必要があります。XSL ファイルに変更内容をマージするヒントについては、「XSL のヒント」を参照してください。
/opt/SUNWics5/cal/sbin ディレクトリに移動し、Calendar Server 6.0 を起動します。

./start-cal

Calendar Express を使用して Calendar Server 6.0 にログインし、Calendar Server コンポーネント (イベントおよび todo (タスク)) が表示されることを確認します。

 

---

XSL のヒント

Calendar Server 6.0 XSL ファイルに変更内容をマージしている場合は、以下のヒントや指針に従って、よくある間違いを避けるようにしてください。

属性にアクセスするときは、誤った構文を使用しないでください。たとえば

./element@attribute

これは次のようでなければなりません。

./element/@attribute

アットマーク (@) の前のスラッシュ (/) を忘れないでください。

ノードの末尾に (/) を付けないでください。たとえば

/node1/node2/

これは次のようでなければなりません。

node1/node2

開タグと閉タグが対応するようにしてください。たとえば値に応じてバックグラウンドカラーを変更する場合、さまざまな <xsl:when> ステートメントに複数の <TD bgcolor={$bgcolor_variable}> を記述し、その最後に 1 つだけ </TD> を記述することがあります。

構文解析で開閉タグの対応のエラーが出る場合は、<TD> を &lt;TD&gt; と記述できます。

その代わりに、次のどちらかの方法を使用してください。

新しい変数を定義し、異なる状態に応じてその値を設定します。次に、定義した新しい変数を <TD> 行で使用します。
または、その <TD> の <xsl:attribute> 属性を使用して bgcolor を個別に定義します。

どちらの場合も、<TD> 行は 1 つだけになります。一般に、&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>

この例では、1 行目の末尾にスラッシュがあります。これでは INPUT タグが閉じられてしまうため、ほとんどのパーサーではこれ以降チェックされる属性が無視されてしまいます。この問題を修正するには、1 行目の最後のスラッシュを削除し、終了する場所に </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;">]>

16 進数値を使用しないでください。&#149; などの値は、DOCTYPE 行でエンティティとして宣言している必要があります。たとえば

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

#149 を xsl で使用するには、次のように記述します。

<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) が 0 よりも大きいことを確認するのではなく、単にノードが存在することを確認します。
XSLT 関数を使用しすぎないでください。特に頻繁に使用するテンプレートでは、string-length などの XSLT 関数の使用を減らすようにしてください。
for-each を使用しないでください。可能な場所では、for-each ではなく apply-templates をできるだけ使用するようにします。こうすることで、XSLT がより良く、より自然なものになります。
[preceding-sibling] または [following-sibling] 軸 (axes) を使用しないでください。
1 つのテンプレート内で、同じノードを複数回評価しないでください。同じノードを複数回評価する必要がある場合は、1 回評価したら、その結果を変数に保存します。
条件式では角かっこを使用しないでください。条件式では、< や > の代わりに、&lt; や &gt; を使用します。
ラジオボタンやチェックボックスでは、value="" を使用しないでください。たとえば

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

これは次のようでなければなりません。

<xsl:attribute name="checked"/>

存在しないノードや属性を使用しないでください。たとえば usrctx および intervalMinutes が /calendar/usrctx ノードの下に存在しない場合

/usrctx/@intervalMinutes

xsl コードを BR の開タグと閉タグの間で使用しないでください。たとえば

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

空行の場合は、<BR/> だけを使用してください。

大量の空白文字や過度のインデントは使用しないでください。空白文字やインデントを使用すると、xsl は読みやすくなりますが、空白文字によって xsl の動作が変わることがあります。
i18n.xsl ファイルでは変数を使用しすぎないでください。また、アプリケーション内で使用しない変数を宣言しないでください。

前へ      目次      索引      次へ

---

Copyright 2003 Sun Microsystems, Inc. All rights reserved.