Serena PVCS Version Manager
Version 8.2.1
Readme ファイル:使用上の注意事項

この Readme には、Version Manager の最新リリースのインストールと使用に関する情報のうち、マニュアルやオンラインヘルプに記載されていない情報が書かれています。補足情報については、ブラウザでナレッジベースの記事を参照してください。

Version Manager Readme は次のファイルで構成されています。

この Readme ファイルは、いくつかのパートに分かれています。ご使用の Version Manager コンポーネントに対応するパートをお読みください。


目次

パート 1:Version Manager CLI、デスクトップクライアント、File Server、および PCLI
パート 2:Version Manager IDE クライアント
パート 3:Version Manager Web クライアント
パート 4:Version Manager WebDAV Server
パート 5:Serena Meritage
パート 6:著作権/免責事項/サポート

 

パート1:Version Manager CLI、デスクトップクライアント、File Server、および PCLI

1.0 性能に関する考慮事項

1.1 Version Manager コマンドでのシンボリックリンクの使用

1.2 ウイルス対策ソフトウェア

1.3 File Server のクライアントキャッシュファイルをすべて削除する

2.0 Windows および UNIX における既知の問題

2.1 夏時間への変更

2.2 固定長キーワード展開の構文は更新されました(8.1.2 現在)

2.3 バージョンラベルでのダッシュ(-)の使用(警告!)

2.4 Diff/Merge Tool:大きなファイルでスクロールバーが機能しない

2.5 権限エラーでプロジェクトデータベースのコピーができない

2.6 Configuration Builder から File Server のアーカイブにアクセスできない

2.7 2 バイト文字で構成された長いユーザ名を使った場合、〔Project Security(プロジェクトセキュリティ)〕ダイアログボックスで不具合が生じる

2.8 File Server:Admin ユーザ ID とパスワードではセミコロン(;)を使用しない

2.9 権限セットを割り当てられていないユーザに「Unlimited」権限セットが割り当てられる

2.10 SSL 対応サーバ上で Tracker の関連付けが失敗する

2.11 LDAP 接続/認証が失敗する

2.12 プロジェクトデータベースの新規作成前にパスマップの LDAP 認証を無効にする

2.13 File Server パスマップを保護するには、アクセスコントロールデータベースを保護する必要がある

2.14 INCLUDE ディレクティブと組み合わせて使うパス内に空白が含まれている場合、引用符で囲む必要がある

2.15 サイズの大きいプロジェクトのデータをエクスポート/インポートできない場合がある

2.16 DTK:PvcsSetProjectSemaphore() はファイルサーバでサポートされていない

2.17 〔Make Secure(保護)〕ダイアログボックスで値を変更した場合、Version Manager を再起動する

3.0 Windows における既知の問題

3.1 Windows Vista:VM Application Server を開始するには管理者ユーザ権限が必要である

3.2 Windows Vista:VM Application Server Admin サービスを実行するには〈管理者として実行(Run As Administrator)〉オプションを選択する必要がある

3.3 Windows Vista:vconfig へのアクセスや vmwfvc.dll の変更を行うには管理者ユーザ権限が必要である

4.0 UNIX における既知の問題

4.1 Solaris(イギリスおよびアイルランド):Java アプリケーションにおけるタイムスタンプの不整合を回避するため、パッチを適用する必要がある

4.2 PCLI:強制終了文字が PCLI コマンドと競合する

4.3 最大ファイル記述子数のデフォルト値が、一部の UNIX システムにおいて小さすぎる

5.0 Linux における既知の問題

5.1 Red Hat 9:日本語文字が正しく表示されない

6.0 PCLI における既知の問題

6.1 あるプラットフォーム上でエクスポートしたプロジェクトデータベースを別のプラットフォーム上でインポートすることはできない

6.2 ワークスペース名およびユーザ名の中でスラッシュ(/)、円記号(\)、角かっこ([])、およびコロン(:)を使った場合、問題が発生する可能性がある

 

パート2:Version Manager IDE クライアント

7.0 SCC IDE における既知の問題

7.1 Visual Studio:リビジョン情報が Tracker および TeamTrack に保存されない

7.2 PowerBuilder:未修正リビジョンのロックは常に解除する必要がある

8.0 FrontPage/InterDev における Web プロジェクトに関する既知の問題

8.1 FrontPage ではロックされているファイルを削除できる

8.2 FrontPage:フォルダ名、プロジェクト名、またはファイル名の中で角かっこ([])を使った場合、問題が発生する可能性がある

9.0 Eclipse および Visual Studio とのリッチな統合における既知の問題

9.1 Eclipse:ソース管理から空のフォルダを取得できない

9.2 VS .NET 2003:〔Set User Options(ユーザオプションの設定)〕ダイアログボックスで設定情報を修正した後に【Cancel(キャンセル)】をクリックしても、修正内容が引き続き表示される

9.3 VS .NET 2003:移動処理が失敗すると、動作が不安定になる可能性がある

9.4 VS .NET 2003:マルチプロジェクト型ソリューションはサポートされていない

9.5 VS .NET 2003 と VS 2005:デフォルトバージョン(ラベル)を適用/変更した場合、ファイルとプロジェクトが表示されない

9.6 VS 2005:Windows Vista を使用するには管理者ユーザ権限が必要である

 

パート3:Version Manager Web クライアント

10.0 性能に関する考慮事項

10.1 ウイルス対策ソフトウェア

10.2 File Server のクライアントキャッシュファイルをすべて削除する

10.3 サーバ上のログファイルと一時ファイルを削除する

11.0 既知の問題

11.1 Windows 2003 Server 上の IIS 6 で FireFox および Mozilla Web ブラウザを使用する

11.2 Vista と Internet Explorer 7:保護モードを無効にする

11.3 名前付けに関する考慮事項

11.4 イベントトリガの使用

11.5 作業ファイルを追加またはチェックインする際、キーワード値を更新する

11.6 Version Manager Web Server または Version Manager WebDAV Server の起動時にエラーが発生する

11.7 NT 認証を使っていて、かつ、Sun Java プラグイン 1.4.1 が有効になっている場合、Version Manager Web クライアントでログインエラーが発生する

11.8 iPlanet では、マルチバイト文字はサポートされていない

11.9 ポップアップウィンドウをブロックすると、Version Manager は正常に動作しない

11.10 Windows:Version Manager Application Server を起動してから停止するまでの間に、アーカイブへのアクセスに一度も使われなかった場合、フリーズする

11.11 Itanium 搭載サーバ上で Version Manager Web Server を実行すると、問題が発生する

11.12 サーブレット定義の中でアンド記号または大文字の ASCII 文字を使った場合、エラーが発生する

 

パート4:Version Manager WebDAV Server

12.0 既知の問題

12.1 クライアントに関する問題

12.2 WebDAV クライアントにおけるパスワード入手

12.3 接続に関する問題のトラブルシューティング

12.4 Version Manager WebDAV Server 経由ではデフォルトバージョンしか表示されない

12.5 権限を指定する

12.6 Version Manager Web Server または Version Manager WebDAV Server の起動時にエラーが発生する

12.7 WebDAV を IIS および Microsoft FrontPage Server Extensions と組み合わせて使用する

12.8 Solaris でユーロ文字を使用する

 

パート5:Serena Meritage

13.0 既知の問題

 

パート6:著作権/免責事項/サポート

14.0 サポート

14.1 サポート情報

15.0 サードパーティ製ソフトウェアに関する注意事項

15.1 サードパーティ製ソフトウェアに関する免責事項

15.2 サードパーティ製ソフトウェアの著作権

 

目次の先頭に戻る

パート1:Version Manager CLI、デスクトップクライアント、File Server、および PCLI

目次に戻る


1.0 性能に関する考慮事項

1.1 Version Manager コマンドでのシンボリックリンクの使用

Version Manager コマンドでパスを指定する際にシンボリックリンクを使った場合、実行に要する時間が長くなります。実行時間を短縮するには、シンボリックリンクではなく絶対パスを指定するか、または、Version Manager コマンドの完全修飾パスをご使用の環境に追加します。

1.2 ウイルス対策ソフトウェア

Serena PVCS Version Manager File Server を使っているときに、クライアント上で、リアルタイムスキャン型のウイルス対策ソフトウェアを実行すると、性能が低下するおそれがあります。これは、Version Manager のファイルキャッシュが更新されるたびに、ウイルス対策ソフトウェアによってファイルキャッシュがスキャンされるからです。性能低下を回避するには、キャッシュディレクトリをリアルタイムスキャンの対象から除外します。

デフォルトでは、ファイルキャッシュはシステムの一時ディレクトリ(環境変数 TMP または TEMP で指定)の下位の pvcsfs ディレクトリにあります。ファイルキャッシュの場所をデフォルト以外のディレクトリに設定するには、環境変数 FS_TMP または FS_TEMP でパスを定義します。

ウイルス対策ソフトウェアに起因する性能低下を改善する方法については、Serena のナレッジベースの記事 70042 を参照してください。この記事の内容は、クライアントとファイルサーバの両方に当てはまります。

1.3 File Server のクライアントキャッシュファイルをすべて削除する

Version Manager 8.0.2.6 および Version Manager 8.1.1 以降には、Version Manager File Server へのセッションの初回確立時に File Server のクライアントキャッシュディレクトリ内の古いファイルをすべて自動削除する機能が備わっています。

この機能を利用するには、islv.ini ファイルにエントリを追加します。

注:時間値のデフォルトの単位は秒ですが、<n>m 構文を使えば分で、<n>m 構文を使えば時間でそれぞれ指定できます。

指定例を次に示します(例の中の数値は、このエントリを指定しない場合のデフォルト値です)。

[PVCSGUI_6.5]

pvcs.fileserver.cache.cleanup.frequency=12h

キャッシュディレクトリ内の全ファイル削除処理の後 12 時間以上待機してから、全ファイル削除処理を再試行します。

pvcs.fileserver.cache.cleanup.age=24h
生成後 24 時間以上経過したファイルをすべて削除します。

pvcs.fileserver.cache.cleanup.mode=m
変更日時(m)を基準にしてファイルの経過時間を判断します。ファイルアクセス日時を基準にする場合は a、ファイル作成日時を基準にする場合は c を指定します。一部のファイルシステムでは、デフォルト値以外を指定すると動作に不具合が生じるおそれがあるので、デフォルト値を使うことを推奨します。

注:File Server のクライアントキャッシュディレクトリの場所は、環境変数 FS_TMP の値によって決まります。FS_TMP が定義されていない場合は、環境変数 FS_TEMP の値によって決まります。どちらの環境変数も定義されていない場合、デフォルトの場所は %TMP%\pvcsfs ディレクトリになります。TMP が定義されていない場合は、%TEMP%\pvcsfs ディレクトリになります。

目次に戻る


2.0 Windows および UNIX における既知の問題

2.1 夏時間への変更

ほとんどのユーザは夏時間の新しい日付の影響を受けません。ただし、Windows システムで環境変数 TZ を使っている場合、Version Manager の夏時間はデフォルトとして組み込みのハードコードされた米国中心の開始/終了日付が使用されます。

この問題を回避するには、必要に応じて環境変数 PVCSTZ を使い、オペレーティングシステムで提供される環境変数 TZ とタイムゾーン情報をオーバーライドできます。

注:8.1.4.0(2007 年春)の時点で、夏時間の日付は現行法を反映するよう更新されています。また、Version Manager 8.1.3.2 では新しい日付の更新を入手できます。この更新は下記のナレッジベースの記事に添付されています。

詳細については、ナレッジベースの記事『Is Version Manager affected by the changes to the U.S. Daylight Saving Time (DST) for 2007?』ID 5004791)を参照してください。

2.2 固定長キーワード展開の構文は更新されました(8.1.2 現在)

キーワードの内容に $ 文字が含まれている場合、新しい構文を使う必要があります。

$Keyword::$123456::$

各パラメータの内容は次のとおりです。

固定長キーワードの内容に $ 文字が含まれていない場合は、新しい構文または元の構文のいずれかを次のように使用することができます。

$Keyword::123456$

2.3 バージョンラベルでのダッシュ(-)の使用(警告!)

コマンドラインでバージョンラベルにダッシュ(-)を使用すると、リビジョン番号に関する演算処理であると解釈され、正しくないリビジョン基づいて処理が実行されることがあります。

このようになるのは、次の場合のみです。

この場合、処理が実行されるリビジョンは、数字とダッシュラベルを含まないリビジョン(上記の例では Beta)のリビジョン番号から、要求された、存在しないラベルの数字部分を引いた値になります。

具体的な例は、次のとおりです。

リビジョン 1.6 のバージョンラベルは、Beta です。

コマンドで使用された、存在しないラベルは、Beta-4 です。

実行された想定外のリビジョン演算は、1.6 - 4 = 1.2 です。

したがって、このコマンドで処理が行われるリビジョンは、1.2 です。

推奨事項:このようなラベルナンバリング方式を使用する必要がある場合は、存在しないラベルをコマンド内で指定しないでください。できれば、一連のラベルと一致する Beta のようなラベルが存在しないことを確認して、上記動作の発生を防止することを推奨します。

2.4 Diff/Merge Tool:大きなファイルでスクロールバーが機能しない

ファイルに 32,000 を超える行がある場合、Diff/Merge Tool が正しく機能しません。〈Next(次へ)〉、〈Previous(前へ)〉、および〈Go to line(行に移動)〉機能を使用して、大きなファイル内で移動します。スクロールバーを単独で使用しても、目的の位置に到達できない可能性があります。

2.5 権限エラーでプロジェクトデータベースのコピーができない

場合によっては、プロジェクトデータベースのコピー操作が権限エラーで失敗する可能性があります。次のすべての条件に一致する場合に、このエラーが発生する可能性があります。

この問題を回避するには、次のいずれかの操作を実行します。

2.6 Configuration Builder から File Server のアーカイブにアクセスできない

Configuration Builder では、Version Manager File Server はサポートされていません。

2.7 2 バイト文字で構成された長いユーザ名を使った場合、〔Project Security(プロジェクトセキュリティ)〕ダイアログボックスで不具合が生じる

2 バイト文字で構成された 21 文字以上のユーザ名は、〔Project Security(プロジェクトセキュリティ)〕ダイアログボックスを閉じるときに切り詰められます。場合によっては、このダイアログボックスを再度開けなくなります。

2.8 File Server:Admin ユーザ ID とパスワードではセミコロン(;)を使用しない

Version Manager File Server 管理ユーティリティから新しい Admin ユーザを作成する場合、ID またはパスワードでセミコロン(;)を使用しないでください。セミコロンを使用すると、次回管理ユーティリティにログインしたとき、失敗します。そのユーザを削除するまで他のユーザはログインできません。

2.9 権限セットを割り当てられていないユーザに「Unlimited」権限セットが割り当てられる

Version Manager デスクトップクライアントで[Admin(管理)]−[Security(セキュリティ)]を選択して、あるユーザの権限セットをすべて削除した場合、そのユーザには「Unlimited」権限セットが割り当てられたことになります。

ユーザに「Unlimited」権限セットを割り当てたくない場合、ユーザに権限セットを 1 つ以上割り当てます。

2.10 SSL 対応サーバ上で Tracker の関連付けが失敗する

Tracker Web クライアントが SSL 対応サーバ上で実行されている場合、関連付けが失敗する可能性があります。この問題を解決するには、次の手順を実行し、SSL 証明書を JRE キーストアに追加します。

  1. JDK 1.4.2x または 1.5x をダウンロードしてインストールします。

  2. 次のコマンドを実行します。

    JDK_Home\bin\keytool.exe -import -file Certificate_File -keystore Serena_Home\vm\common\jre\win32\lib\security\cacerts

  3. パスワードをキーストアに追加するためのプロンプトが表示されます。デフォルトのパスワードは changeit です。

参照先

TrackerLink と Secure Sockets Layer(SSL)を組み合わせて使用する

2.11 LDAP 接続/認証が失敗する

LDAP サーバが Secure Sockets Layer(SSL)を使うように設定されているが、VM_Install_Dir/vm/common/bin/OS ディレクトリに証明書データベースがないかまたは必要な SSL 証明書が証明書データベース内に格納されていない場合、次のようなエラーが通知されます。

注:Netscape 4.7x または Certutil で生成された証明書データベースは、複数のプラットフォームをサポートしていて、Microsoft Windows またはその他のプラットフォームで使用できます。

Netscape 4.7x を使用して証明書データベースを作成し、データを格納するには、次の手順を実行します。

  1. Netscape 4.7x を使用して次の URL を開きます。

    https://YourServer:SSLport

    各パラメータの内容は次のとおりです。

  2. 〔Netscape Certificate Name Check〕ウィンドウに表示される指示に従って、今後のセッションで使うサーバ証明書を受け付けます。

  3. Netscape を終了します。

  4. Netscape ユーザプロファイルディレクトリにある key3.db ファイルおよび cert7.db ファイルを VM_Install_Dir/vm/common/bin/OS ディレクトリにコピーします。

  5. Version Manager インターフェイス(デスクトップクライアント、IDE、Web クライアント、または WebDAV)を再起動します。

  6. ログインします。

注:2006 年 8 月現在、Netscape 4.7x は次の場所から入手できます。
http://browser.netscape.com/ns8/download/archive47x.jsp
この特定 URL を利用できない場合は、Netscape のメインページ(
http://www.netscape.com/)から開いてください。

Certutil を使用して証明書データベースを作成し、データを格納するには、次の手順を実行します。

Certutil は、Mozilla から提供されている Security NSS パッケージのコマンドラインユーティリティです。このユーティリティを使用して、cert7.db および cert8.db を生成します。

  1. 証明書データベースのフォルダを作成します。

    例:c:\certificate

  2. コマンドCertutil -N -d "Cetificate storage folder" を使用して、新しい証明書を作成します。

    例:certuil -N -d c:\certificate

  3. 次のファイルが生成されます。

  4. サーバ証明書を追加します。次のコマンドを使用して、ディレクトリサーバから証明書データベースにサーバ証明書を手動で追加する必要があります。

    Certutil -A -n "Nickname" -t "P,," -a -i certfile -d Certificate directory

    例:certutil -A -n "SerenaDirectoryserver" -t "P,," -a -i :\servernaDirectoryServer.cer -d c:\certificate

  5. VM LDAP 設定を Certificate Storage フォルダに接続します。

2.12 プロジェクトデータベースの新規作成前にパスマップの LDAP 認証を無効にする

特定のファイルサーバパスマップに対して LDAP 認証が有効になっている場合、そのパスマップに新しいプロジェクトデータベースを作成する前に LDAP 認証を無効にする必要があります。無効にしないと、エラーダイアログが表示され、プロジェクトデータベースは動作しません。プロジェクトデータベースを作成した後は LDAP 認証をもう一度有効にできます。

2.13 File Server パスマップを保護するには、アクセスコントロールデータベースを保護する必要がある

ファイルサーバパスマップでセキュリティが有効になっている場合は、〈アクセスコントロールデータベースのセキュリティ(Access control database security)〉を有効にする必要があります。

ファイルサーバパスマップのセキュリティを設定するには、Version Manager File Server Administration ユーティリティを使用します。〔パスマップ(Path Map)〕ページで、〔パスマップの追加(Add Path Map)〕または〔パスマップの編集(Edit Path Map)〕ダイアログボックスを開きます。〈アクセスコントロールデータベース(Access control database)〉フィールドまたは〈LDAP 認証(LDAP authentication)〉チェックボックスを有効にするには、〈アクセスコントロールデータベースのセキュリティ(Access control database security)〉チェックボックスも有効にする必要があります(以下を参照)。

〈アクセスコントロールデータベースのセキュリティ(Access control database security)〉チェックボックスは、〔プロジェクトデータベースの設定(Configure Project Database)〕ダイアログの〔全般(General)〕タブに配置されています(このダイアログを開くには、デスクトップクライアントで[Admin(管理)]−[Configure Project(詳細設定)]を選択します)。〈オプション(Options)〉ツリーで、[セキュリティ(Security)]−[アクセスコントロールデータベース(Access Control Database)]を選択します。

2.14 INCLUDE ディレクティブと組み合わせて使うパス内に空白が含まれている場合、引用符で囲む必要がある

あるコンフィグレーションファイル内で INCLUDE ディレクティブを使用し、かつ、インクルード対象のコンフィグレーションファイルへのパス内に空白が含まれている場合、パス全体を引用符で囲む必要があります。たとえば、サンプルプロジェクトデータベースがデフォルトの場所にインストールされている場合、そのコンフィグレーションファイルに対する INCLUDE ディレクティブを次のように定義します。

INCLUDE "c:\program files\serena\vm\common\sampledb\archives\basecfg.cfg"

2.15 サイズの大きいプロジェクトのデータをエクスポート/インポートできない場合がある

サイズの大きいプロジェクトのデータをエクスポートまたはインポートする際、Version Manager がメモリ不足に陥るおそれがあります。データの喪失を防ぐには、データのエクスポート後にエクスポート元プロジェクトを残しておきます。そうすれば、プロジェクトのサイズが大きすぎてデータをインポートできない場合、エクスポート元プロジェクトを使うことができます。

Version Manager PCLI(および Version Manager デスクトップクライアント)に割り当て可能なメモリ量を増やすには、コマンドを実行する前に環境変数 PVCS_MX を定義します。次の例は、環境変数の定義方法を示したものです。この例では、Version Manager で使われる Java ヒープサイズを 500 MB に変更します。

環境 コマンド
Windows set PVCS_MX=-Xmx500m
UNIX Bourne シェル PVCS_MX=-mx500m; export PVCS_MX
UNIX Korn シェル/Bash export PVCS_MX=-mx500m
UNIX C シェル setenv PVCS_MX mx500m

2.16 DTK:PvcsSetProjectSemaphore() はファイルサーバでサポートされていない

DTK 呼び出し PvcsSetProjectSemaphore() は、ファイルサーバでサポートされていません。以前のバージョンで、ビルドまたはバックアップに備えてアーカイブをロックするためにこの呼び出しを使っていた場合、ファイルサーバ上のアーカイブに対して同様の効果を得るには、Version Manager Administration ユーティリティで〈Enable write access(書き込み権限を許可)〉チェックボックスを選択解除します。

2.17 〔Make Secure(保護)〕ダイアログボックスで値を変更した場合、Version Manager を再起動する

〔Make Secure(保護)〕ダイアログボックスで値を変更した場合、Version Manager デスクトップクライアントを再起動します。同じ Version Manager セッションでこのダイアログボックスを再度開いた場合、以前に変更した内容は反映されず、ダイアログボックスを閉じたときに変更内容が失われるおそれがあります。

目次に戻る


3.0 Windows における既知の問題

3.1 Windows Vista:VM Application Server を開始するには管理者ユーザ権限が必要である

Version Manager Application Server を開始するには、Vista のユーザ権限が必要です。

詳細については、「VS 2005: Windows Vista を使用するには管理者ユーザ権限が必要である」のトピックを参照してください。

3.2 Windows Vista:VM Application Server Admin サービスを実行するには〈管理者として実行(Run As Administrator)〉オプションを選択する必要がある

毎回 Version Manager Application Server Admin を起動する際に、Application Server Admin のショートカットを右クリックして表示されるポップアップメニューで〈管理者として実行(Run as administrator)〉を選択するか、または、常に管理者として実行するようショートカットを設定することもできます。

3.3 Windows Vista:vconfig へのアクセスや vmwfvc.dll の変更を行うには管理者ユーザ権限が必要である

vconfig.exe にアクセスしたり、vmwfvc.dll ファイルを変更したりするには、Vista に管理者ユーザとしてログインするか、または Vista で〈管理者として実行(Run as administrator)〉オプションを使用する必要があります。

詳細については、「VS 2005: Windows Vista を使用するには管理者ユーザ権限が必要である」のトピックを参照してください。

目次に戻る


4.0 UNIX における既知の問題

4.1 Solaris(イギリスおよびアイルランド):Java アプリケーションにおけるタイムスタンプの不整合を回避するため、パッチを適用する必要がある

イギリスおよびアイルランドで Solaris を使うユーザは、Version Manager のアーカイブおよび作業ファイルのタイムスタンプに不整合が生じないようにするため、Sun Microsystems によって公開されているパッチをダウンロードしてインストールする必要があります。このパッチ(105210-10 以降)は、Sun Microsystems の顧客サポートサイト(http://sunsolve.Sun.com)で入手できます。

4.2 PCLI:強制終了文字が PCLI コマンドと競合する

HP-UX(Bourne シェルおよび Korn シェル)のデフォルトの強制終了文字は @ です。この文字は、PCLI の listfile コマンド(@listfile)と競合します。また、コマンドラインでワークスペースを指定する際にも競合します。以下に例を示します。

pcli listversionedfiles -prd:\productb -pp/newprj @listfile

または

pcli getworklocation -sp/@/mariec/myworkspace...

この競合を回避するには、強制終了文字を @ 以外の値に設定します。以下に例を示します。

stty kill ^U (強制終了文字を CTRL+U に設定)

4.3 最大ファイル記述子数のデフォルト値が、一部の UNIX システムにおいて小さすぎる

一部の PCLI 処理(ListVersionedFiles など)では、複数のファイルが同時に開くことがあります。一部の UNIX システムでは、最大ファイル記述子数がデフォルト値のままでは小さすぎます。最大ファイル記述子数を 128 以上に設定することを推奨します。データベースのサイズがきわめて大きい場合は、オペレーティングシステムで許容されている最大値に設定することを推奨します。C シェルの場合は、limit コマンドを使って上限値を設定します。Bourne シェルおよび Korn シェルの場合は、ulimit コマンドを使って上限値を設定します。最大ファイル記述子数のデフォルト値は、オペレーティングシステムごとに、またシステム構成によって異なります。最大ファイル記述子数のデフォルト値が、すでに 128 より大きい値に設定されている場合もあります。

最大ファイル記述子数の値が小さすぎる場合、さまざまな問題が発生するおそれがあります。よく発生する問題としては、多数のファイルを開くコマンド(AddFiles、ListVersionedFiles、ImportArchives など)においてファイルを開いたり探したりできない、というものがあります。

目次に戻る


5.0 Linux における既知の問題

5.1 Red Hat 9:日本語文字が正しく表示されない

〔Select Workfiles(作業ファイルの選択)〕ダイアログボックスの〈File name(ファイル名)〉フィールドなどでは、日本語文字が正しく表示されません。

この問題を解決するには、次の手順を実行します。

  1. 次のディレクトリに移動します。

    VM_Install_Dir/vm/common/java/linux/jre/lib

  2. font.properties.ja ファイルを font.properties.ja.old に名前変更します。

  3. font.properties.ja.Redhat8.0 ファイルを font.properties.ja に名前変更します。

場合によっては、この properties ファイルに記述されている特定のフォントをインストールする必要があります。特定のフォントをインストールする必要があるかどうかを調べるには、次のコマンドを実行します。

xlsfonts | grep fontName

目次に戻る


6.0 PCLI における既知の問題

6.1 あるプラットフォーム上でエクスポートしたプロジェクトデータベースを別のプラットフォーム上でインポートすることはできない

Windows 上であるプロジェクトデータベースをエクスポートした場合、そのプロジェクトデータベースは Windows 上でしかインポートできません。そのままでは、UNIX 上でインポートすることはできません。UNIX 上でインポートするには、エクスポートしたファイル内のすべてのパス名、およびエクスポートしたファイルによって参照されるコンフィグレーションファイル内のすべてのパス名を、手動で変換する必要があります。このことは、UNIX 上でエクスポートしたファイルを Windows 上でインポートする場合にも当てはまります。

6.2 ワークスペース名およびユーザ名の中でスラッシュ(/)、円記号(\)、角かっこ([])、およびコロン(:)を使った場合、問題が発生する可能性がある

ワークスペース名またはユーザ名の中にスラッシュ(/)、円記号(\)、角かっこ([])、またはコロン(:)が含まれている場合、PCLI コマンドおよびプロジェクトデータベースのインポート/エクスポート処理が失敗するおそれがあります。インポート/エクスポート処理を実行する前、またはその他の PCLI コマンドを使う前に、このような文字が含まれている名前を修正してください。

 

パート2:Version Manager IDE クライアント

目次に戻る


7.0 SCC IDE における既知の問題

7.1 Visual Studio:リビジョン情報が Tracker および TeamTrack に保存されない

TrackerLink または SourceBridge を VS.NET や ASP.NET Web アプリケーションで使用しているときに、Version Manager ファイルとリビジョン情報が Tracker または TeamTrack に保存されません。この問題を回避するには、他のプロジェクトで Version Manager COM インターフェイスを使用していない場合にこのインターフェイスの登録を解除します。COM インターフェイスの登録を解除するには、Windows コマンドラインから regsvr32 ユーティリティを実行します。

regsvr32 /u "C:\Program Files\Serena\vm\devint\bin\IFC_COM.dll"

注:上記の例では、Version Manager のデフォルトのインストール場所が反映されています。

7.2 PowerBuilder:未修正リビジョンのロックは常に解除する必要がある

Version Manager では、未修正ファイルに対するロックを常に解除するように、プロジェクトデータベースまたはプロジェクトを設定できます。PowerBuilder で Version Manager プロジェクトを使用する場合、このオプションを必ず設定してください。このオプションを設定しなかった場合、チェックアウト取り消し時または未修正リビジョンのチェックイン時に、PowerBuilder 内のオブジェクトが、関連付けられたバージョン管理ファイルと同期しなくなる可能性があります。また、関連付けられた Version Manager アーカイブがまだロックされている場合でも、PowerBuilder ではオブジェクトがロック解除されているように表示されることがあります。

詳細については、『Serena PVCS Version Manager 管理者ガイド』を参照してください。

目次に戻る


8.0 FrontPage/InterDev における Web プロジェクトに関する既知の問題

8.1 FrontPage ではロックされているファイルを削除できる

Microsoft FrontPage Server Extensions の制限により、あるユーザがチェックアウトしたファイルを別のユーザが削除できることがあります。誤ってファイルが削除されないようにするには、Windows セキュリティを使ってファイルを保護するか、またはファイルのチェックアウト時に他のユーザに通知します。

8.2 FrontPage:フォルダ名、プロジェクト名、またはファイル名の中で角かっこ([])を使った場合、問題が発生する可能性がある

フォルダ名、プロジェクト名、またはファイル名の中で角かっこ([])を使った場合、ソース管理処理が失敗するおそれがあります。フォルダ名、プロジェクト名、またはファイル名の中で角かっこ([])を使わないようにしてください。

目次に戻る


9.0 Eclipse および Visual Studio とのリッチな統合における既知の問題

9.1 Eclipse:ソース管理から空のフォルダを取得できない

Eclipse で空のフォルダがあるプロジェクトを作成する場合、即時同期処理を実行する必要があります。実行しない場合、プロジェクトに対する取得処理を実行できません。

9.2 VS .NET 2003:〔Set User Options(ユーザオプションの設定)〕ダイアログボックスで設定情報を修正した後に【Cancel(キャンセル)】をクリックしても、修正内容が引き続き表示される

〔Set User Options(ユーザオプションの設定)〕ダイアログボックスで設定情報を修正した後に【OK】ではなく【Cancel(キャンセル)】をクリックした場合、修正内容は無効になります。ただし、このダイアログボックスを再度開くと、修正後の情報が引き続き表示されます。このダイアログボックスの設定情報を正確にメモしてから【OK】をクリックしてください。

9.3 VS .NET 2003:移動処理が失敗すると、動作が不安定になる可能性がある

移動処理が失敗した場合、.NET では復元処理が試されます。ただし、復元できなかった場合、IDE の動作が不安定なままになるおそれがあります。この場合、資産を元の状態に戻し、移動処理を再度実行してください。

9.4 VS .NET 2003:マルチプロジェクト型ソリューションはサポートされていない

Visual Studio .NET のリッチな統合を使う場合、次の条件に当てはまるソリューションは開けません。

特に、ルートソリューションフォルダに配置されているプロジェクトに属するサブフォルダは、読み込むことができません。ソース管理でマルチプロジェクト型ソリューションを開くには、各プロジェクトを別々のフォルダに配置します。

9.5 VS .NET 2003 と VS 2005:デフォルトバージョン(ラベル)を適用/変更した場合、ファイルとプロジェクトが表示されない

リッチな統合ではデフォルトバージョン(ラベル)を使い、特定の Version Manager ワークスペースに表示するファイルを決定します。混乱を避けるには、その仕組みを理解することが重要です。

デスクトップクライアントを使ってデフォルトバージョンを適用するか、プロジェクトデータベースまたはワークスペースの既存のバージョンを変更した場合、バージョンラベルがあるファイルのみ Visual Studio に表示されます。プロジェクトとソリューションファイルにこれらのラベルがない場合、ファイルは表示されません。

混乱の可能性を避けるには、次の手順を実行します。

『Serena Version Manager IDE クライアント操作ガイド』を参照してください。

9.6 VS 2005:Windows Vista を使用するには管理者ユーザ権限が必要である

Windows Vista で統合機能を使用するには、Vista に管理者ユーザとしてログインするか、〈管理者として実行(Run As Administrator)〉オプションを有効にした状態で Visual Studio を起動する必要があります。

Visual Studio のショートカットを右クリックして表示されるポップアップメニューで〈管理者として実行(Run as administrator)〉を選択するか、または、常に管理者として実行するようショートカットを設定することもできます。

 

パート3:Version Manager Web クライアント

目次に戻る


10.0 性能に関する考慮事項

10.1 ウイルス対策ソフトウェア

Serena PVCS Version Manager File Server を使っているときに、Version Manager Web Server を実行しているコンピュータ上で、リアルタイムスキャン型のウイルス対策ソフトウェアを実行すると、性能が低下するおそれがあります。これは、Version Manager のファイルキャッシュが更新されるたびに、ウイルス対策ソフトウェアによってファイルキャッシュがスキャンされるからです。性能低下を回避するには、キャッシュディレクトリをリアルタイムスキャンの対象から除外します。

デフォルトでは、ファイルキャッシュはシステムの一時ディレクトリ(環境変数 TMP または TEMP で指定)の下位の pvcsfs ディレクトリにあります。ファイルキャッシュの場所をデフォルト以外のディレクトリに設定するには、環境変数 FS_TMP または FS_TEMP でパスを定義します。

ウイルス対策ソフトウェアに起因する性能低下を改善する方法については、Serena のナレッジベースの記事 70042 を参照してください。

10.2 File Server のクライアントキャッシュファイルをすべて削除する

Version Manager 8.0.2.6 および Version Manager 8.1.1 以降には、Version Manager File Server へのセッションの初回確立時に File Server のクライアントキャッシュディレクトリ内の古いファイルをすべて自動削除する機能が備わっています。

この機能を利用するには、islv.ini ファイルにエントリを追加します。

注:時間値のデフォルトの単位は秒ですが、<n>m 構文を使えば分で、<n>m 構文を使えば時間でそれぞれ指定できます。

指定例を次に示します(例の中の数値は、このエントリを指定しない場合のデフォルト値です)。

[PVCSGUI_6.5]

pvcs.fileserver.cache.cleanup.frequency=12h

キャッシュディレクトリ内の全ファイル削除処理の後 12 時間以上待機してから、全ファイル削除処理を再試行します。

pvcs.fileserver.cache.cleanup.age=24h
生成後 24 時間以上経過したファイルをすべて削除します。

pvcs.fileserver.cache.cleanup.mode=m
変更日時(m)を基準にしてファイルの経過時間を判断します。ファイルアクセス日時を基準にする場合は a、ファイル作成日時を基準にする場合は c を指定します。一部のファイルシステムでは、デフォルト値以外を指定すると動作に不具合が生じるおそれがあるので、デフォルト値を使うことを推奨します。

注:File Server のクライアントキャッシュディレクトリの場所は、環境変数 FS_TMP の値によって決まります。FS_TMP が定義されていない場合は、環境変数 FS_TEMP の値によって決まります。どちらの環境変数も定義されていない場合、デフォルトの場所は %TMP%\pvcsfs ディレクトリになります。TMP が定義されていない場合は、%TEMP%\pvcsfs ディレクトリになります。

10.3 サーバ上のログファイルと一時ファイルを削除する

Version Manager Web Server によって、サーバコンピュータ上にログファイルと一時ファイルが生成されます。これらのファイルが原因で問題が発生することはありませんが、削除しない場合、空きディスク領域がなくなるまでディスクが使用されます。これらのファイルを定期的に削除することを推奨します。

次のディレクトリに生成されたログファイルは、定期的に削除できます。

ファイル転送の途中でクライアントとサーバ間の接続が解除された場合、サーバ上に一時ファイルが生成されます。これらの一時ファイルを削除します。一時ファイルが生成される場所は、Windows の場合は VM_Install_Dir\vm\inet\temp ディレクトリ、UNIX の場合はシステム一時ディレクトリです。また、ユーザがプロジェクトからログアウトせずにブラウザを閉じた場合にも、履歴レポートおよび相違点レポートを基にして一時ファイルが生成されます。これらの一時ファイルも削除します。これらの一時ファイルが生成される場所は、VM_Install_Dir\vm\inet\temp\html ディレクトリです。

目次に戻る


11.0 既知の問題

11.1 Windows 2003 Server 上の IIS 6 で FireFox および Mozilla Web ブラウザを使用する

サーバが Windows 2003 上で IIS 6 を実行している場合は、Version Manager Web クライアントアプレットを FireFox および Mozilla ブラウザにインストールすることはできません。MIME タイプの .xpi ファイルを定義することで、この問題を回避できます。詳細については、installation_info.html ファイルの次のトピックを参照してください。

Windows 2003 Server 上の IIS 6 で FireFox および Mozilla Web ブラウザを使用する

11.2 Vista と Internet Explorer 7:保護モードを無効にする

Version Manager Web クライアントにアクセスするゾーンでは、保護モードを無効にする必要があります。この処理は Internet Explorer の[インターネットオプション]ダイアログボックスで行います([ツール]−[インターネット オプション]−[セキュリティ]タブを選択)。

11.3 名前付けに関する考慮事項

11.4 イベントトリガの使用

イベントトリガの機能は、Version Manager Web クライアントと Version Manager デスクトップクライアントの間でかなり違いがあります。この違いは、アーカイブの修正方法によるものです。Version Manager Web クライアントを使ってタスクを実行すると、Version Manager Web クライアントではなく Version Manager Web Server によってアーカイブが修正されます。したがって、イベントトリガから Version Manager Web クライアント経由で利用可能なデータおよび処理と、イベントトリガから Version Manager デスクトップクライアント経由で利用可能なデータおよび処理は、異なります。

イベントトリガを使用する場合、次の点に注意してください。

11.5 作業ファイルを追加またはチェックインする際、キーワード値を更新する

作業ファイルを追加またはチェックインした後、Version Manager Web クライアントによって作業ファイル内の拡張キーワード値が自動更新されることはありません。キーワード値を更新するには、作業ファイルを取得するか、または作業ファイルの場所にチェックアウトします。

11.6 Version Manager Web Server または Version Manager WebDAV Server の起動時にエラーが発生する

Version Manager Web Server または Version Manager WebDAV Server の起動時に、JVM_Bind:8080 または JVM_Bind:8090 というテキストを含む Java 例外エラーが通知されることがあります。このエラーが発生する理由は、次のいずれかです。

ポート番号を変更するには、VM_Install_Dir/vm/common/tomcat/conf/server.xml ファイルを開き、Http10Connector port= の値を変更します。

他のアプリケーションで次のポートが使われている場合、これらのポートも変更しなければならないことがあります。

これらのエントリの一方または両方の値を別のポート番号に変更する場合、VM_Install_Dir/vm/common/tomcat/conf/jk/workers.properties ファイル内の worker.apj12.port= 文および worker.apj13.port= 文で同じポートを指定します。

注:すでに Tomcat を 2 つインストールしている場合、シャットダウンポートを 8005 から未使用値に変更すべきです。変更しない場合、一方のアプリケーションのシャットダウンルーチンが呼び出されると、両方のアプリケーションが停止します。

11.7 NT 認証を使っていて、かつ、Sun Java プラグイン 1.4.1 が有効になっている場合、Version Manager Web クライアントでログインエラーが発生する

NT 認証を使っていて、かつ、Version Manager Web クライアントのユーザが Sun Java プラグイン 1.4.1x を使っている場合、認証処理で問題が発生します。それらのユーザがネイティブの JVM あるいは Sun Java プラグイン 1.4.2x または 1.5.x を使用できる場合、この認証処理の問題を回避できます。

11.8 iPlanet では、マルチバイト文字はサポートされていない

現在のところ、Version Manager Web クライアントと iPlanet Web サーバを組み合わせて使う場合、マルチバイト文字はサポートされていません。マルチバイト文字を使いたい場合は、Microsoft IIS Web サーバを使ってください。

11.9 ポップアップウィンドウをブロックすると、Version Manager は正常に動作しない

ブラウザでポップアップウィンドウをブロックするように設定すると、Version Manager Web クライアントが正常に動作しない可能性があります。ポップアップウィンドウブロック機能を無効にするか、または、ポップアップウィンドウの表示を許可されているサイトのリストに Version Manager サーバを追加してください。

11.10 Windows:Version Manager Application Server を起動してから停止するまでの間に、アーカイブへのアクセスに一度も使われなかった場合、フリーズアップする

Windows において、Version Manager Application Server を起動してから停止するまでの間に、Version Manager Application Server がアーカイブへのアクセスに一度も使われなかった場合、デーモンが正常に停止しません。この場合、Version Manager Application Server のコンソールウィンドウを閉じ、Windows のタスクマネージャで DaemonServer.exe プロセスを終了します。

11.11 Itanium 搭載サーバ上で Version Manager Web Server を実行すると、問題が発生する

Itanium プロセッサ搭載サーバを使っている場合、vm/common/bin/pvcsstart.bat ファイル内の -server-Xint に置換します。これにより、HotSpot コンパイラが無効になります。

11.12 サーブレット定義の中でアンド記号または大文字の ASCII 文字を使った場合、エラーが発生する

サーブレット定義の任意のフィールドでアンド記号または大文字の ASCII 文字を使った場合、Version Manager Web Server でエラーが発生します。

サーブレットの説明内でアンド記号(&)を使う必要がある場合は、そのまま「&」と入力するのではなく、「&amp;」のようにエンティティ形式で入力します。

 

パート4:Version Manager WebDAV Server

目次に戻る


12.0 既知の問題

12.1 クライアントに関する問題

WebDAV Server には接続できるが、WebDAV クライアントで作業を行うと問題が発生する場合、WebDAV クライアント側で WebDAV に関する不具合がある可能性があります。

次の作業を行うことを推奨します。

12.2 WebDAV クライアントにおけるパスワード入手

一部の WebDAV クライアント(例:Dreamweaver)では、認証パスワードを入力する必要があります。WebDAV クライアントを正しく動作させるため、Version Manager パスワードを入手することを推奨します。Version Manager パスワードを入手していない場合は、Version Manager デスクトップクライアントを使ってパスワードを定義します。

12.3 接続に関する問題のトラブルシューティング

Version Manager WebDAV Server への接続に関する問題をトラブルシューティングするには、まず、Tomcat サーバコンソールにエラーや例外が表示されているかどうかを調べます。

エラーが表示されない場合は、次の作業を実行します。

12.4 Version Manager WebDAV Server 経由ではデフォルトバージョンしか表示されない

デフォルトバージョン(ラベル)に対するワークスペース設定によって、WebDAV Server 経由で表示可能なファイルが決まります。Version Manager デスクトップクライアントと違って、Version Manager WebDAV Server では、デフォルトバージョン設定に合致するファイルだけが表示されます。デフォルトバージョンが設定されていない場合、トランクのチップリビジョンがデフォルトになります。この場合、Version Manager WebDAV Server 経由で表示されるのはこれらのチップリビジョンだけです。

12.5 権限を指定する

Version Manager WebDAV Server に接続した後、通常の処理(作業ファイルのチェックアウトや追加など)で発生する不具合の多くは、権限の不足が原因です。

注:WebDAV 経由でアーカイブを新規に作成するには、「アーカイブの作成」権限に加えて「バージョンラベルの割り当て」権限も必要です。

必要な権限を持つユーザとして Version Manager にログインし、指定された権限で実行可能な処理を実際に実行できるかどうかを確認します。Version Manager で処理を正しく実行できる場合、WebDAV Server を使った場合でもそれらの処理を実行できるはずです。

あるユーザの権限を変更した場合、Tomcat を再起動するかまたはそのユーザのカレントセッションがタイムアウトになるまでの間、変更内容はそのユーザに公開されません。

12.6 Version Manager Web Server または Version Manager WebDAV Server の起動時にエラーが発生する

Version Manager Web Server または Version Manager WebDAV Server の起動時に、JVM_Bind:8080 または JVM_Bind:8090 というテキストを含む Java 例外エラーが通知されることがあります。このエラーが発生する理由は、次のいずれかです。

ポート番号を変更するには、VM_Install_Dir/vm/common/tomcat/conf/server.xml ファイルを開き、Http10Connector port= の値を変更します。

他のアプリケーションで次のポートが使われている場合、これらのポートも変更しなければならないことがあります。

これらのエントリの一方または両方の値を別のポート番号に変更する場合、VM_Install_Dir/vm/common/tomcat/conf/jk/workers.properties ファイル内の worker.apj12.port= 文および worker.apj13.port= 文で同じポートを指定します。

注:すでに Tomcat を 2 つインストールしている場合、シャットダウンポートを 8005 から未使用値に変更すべきです。変更しない場合、一方のアプリケーションのシャットダウンルーチンが呼び出されると、両方のアプリケーションが停止します。

12.7 WebDAV を IIS および Microsoft FrontPage Server Extensions と組み合わせて使用する

IIS Web サーバ上で Microsoft FrontPage Server Extensions を実行している場合、Microsoft Web フォルダが自動検出されます。検出された場合、Web フォルダクライアントでは、WebDAV プロトコルが使われないので、WebDAV Server との間でデータのやりとりは発生しません。FrontPage Server Extensions によって Version Manager WebDAV Server が IIS Web サーバ経由でリダイレクトされるように設定した場合、Web フォルダクライアントと FrontPage Server Extensions との間でのみデータのやりとりが発生します。WebDAV Server との間では、データのやりとりは発生しません。

12.8 Solaris でユーロ文字を使用する

Solaris 上でユーロ文字が正しく処理されるようにするには、次の手順を実行します。

  1. Solaris の最新の OS パッチをインストールします。

  2. 〔Solaris Login(Solaris ログイン)〕ダイアログボックス(コンソール)で、〈Options(オプション)〉をクリックし、〈Language(言語)〉で〈en_ISO8859-15〉を選択します。

  3. ログインし、Version Manager WebDAV Server を起動するため、VM_Install_Dir/vm/common/bin ディレクトリにある ./pvcsstart.sh を実行します。

 

パート5:Serena Meritage

目次に戻る


13.0 既知の問題

「既知の問題」ファイルを参照してください。

パート6:著作権/免責事項/サポート

目次に戻る


14.0 サポート

14.1 サポート情報

Serena のサポート部門に問い合わせるには、support.serena.com でログインしてください。

目次に戻る


15.0 サードパーティ製ソフトウェアに関する注意事項

15.1 サードパーティ製ソフトウェアに関する免責事項

Version Manager Web Server、Version Manager File Server、および Version Manager WebDAV Server によって使われ、これらのソフトウェアと一緒に配布されるサードパーティ製コンポーネントに対して、以下の免責事項が適用されます。サードパーティ製コンポーネントに関する謝辞については、Serena PVCS Version Manager のマニュアルを参照してください。サードパーティ製コンポーネントに関する補足情報については、各コンポーネントのライセンスファイルを参照してください。

Java ランタイムエンジン、Tomcat、および Xerces Java パーサ(このソフトウェア)は現状有姿のままで提供されるものであり、商品性および特定目的に対する適合性について、明示であると黙示であるとを問わず、一切保証されません。Sun Microsystems、Apache Software Foundation、または Apache Software Foundation 参加企業は、いかなる場合も、このソフトウェアの使用によって発生する直接損害、二次的損害、偶発的損害、特別損害、懲罰的損害、または間接損害(代用品または代替サービスの調達、使用不能状態の発生、データの喪失、利益の喪失、業務の中断など)に対して、そのような損害が発生する可能性が忠告されていたとしても、いかなる責任法理(契約、厳格責任、不法行為(過失の場合と過失でない場合))に基づくものであろうと、責任を負わないものとします。

15.2 サードパーティ製ソフトウェアの著作権

DocuComp® comparison テクノロジは ASI Software からライセンス供与されています。
ソフトウェアの一部。DocuComp® comparison © 2004 ASI Software, Inc. All rights reserved.

この製品には、Apache Software Foundation(http://www.apache.org/
で開発されたソフトウェアが含まれています。

この製品には、OpenSSL Toolkit で使用するため OpenSSL Project で開発されたソフトウェアが含まれています(http://www.openssl.org/)。

Portions © Copyright 2006 Microsoft Corporation.Al Rights Reserved.

Portions © Copyright 1996, 1999 International Business Machines Corporation and others.All Rights Reserved.

Portions © Copyright Intalio Inc. and others.All Rights Reserved.

Portions © Copyright eHelp Corporation.All Rights Reserved.

 


以上
Copyright © 2003–2009 Serena Software, Inc. All rights reserved.