PVCS Version Manager
8.7.0.0
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: 著作権/免責事項/サポート

 

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

1.0 PVCS VM 8.6.3.3 より前のクライアントからの PVCS VM 8.7.0 File Server アクセス

2.0 パフォーマンスに関する考慮事項

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

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

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

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

3.1 夏時間への変更

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

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

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

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

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

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

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

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

3.10 "チェックイン時に必ず関連付け" は、デスクトップクライアント上に SourceBridge コンポーネントが必要 [DEF172990]

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

3.12 パスマップの競合

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

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

3.15 大規模プロジェクトでの、"Out of Memory Error" または、General Failure Operating

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

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

4.0 Windows における既知の問題

4.1 ユーザの切り替え機能が SSO PDB で利用できない

4.2 vconfig へのアクセスと vmwfvc.dll の更新には管理者ユーザ権限が必要

4.3 サードパーティ DLL 競合エラー: "The ordinal <number> could not be located in the dynamic link library <Name>.dll"

5.0 UNIX/Linux における既知の問題

5.1 "Error in getting local hostname"

5.2 Linux CAC: ActiveIdentity クライアント PIN キャッシュ設定

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

6.0 PCLI における既知の問題

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

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

 

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

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

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

7.2 Issue の関連付けの要求: SCC プロバイダを PVCS Version Manager SourceBridge に設定

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

8.1 サーバサイド処理が、デフォルトで有効化されている

8.2 サーバサイド処理が、File Server 上で、"localhost" の定義を必要とする

8.3 Eclipse: いくつかのサードパーティのフォルダを除外する必要がある。例 ibmconfig

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

8.5 Application Server による 8.5.1 以前のクライアントの拒否

 

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

9.0 パフォーマンスに関する考慮事項

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

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

10.0 既知の問題

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

10.2 イベントトリガの使用

10.3 ポップアップブロックにより Version Manager が正常に動作しない

10.4 Web Server Application が File Server 上で、"localhost" の定義を必要とする

 

パート 4: Version Manager WebDAV Server

11.0 既知の問題

11.1 Windows 7 からの VM WebDAV サーバへのログイン

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

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

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

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

11.6 権限を指定する

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

 

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

12.0 サポート

12.1 サポート情報

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

 

先頭に戻る

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

先頭に戻る


1.0 PVCS VM 8.6.3.3 より前のクライアントからの PVCS VM 8.7.0 File Server アクセス

VM 8.6.3.3 パッチで、PVCS VM File Server パスマップセキュリティに対する重要なセキュリティ強化が実装されました。

パスマップセキュリティは、プロジェクトデータベースセキュリティに加えて、PVCS VM File Server との認証をクライアントに強制し、低レベルなファイルアクセスを保護するために使用できます。 (詳細については、次の KB ドキュメントに添付されたファイルの 45 ページを参照してください: S126695: Using the File Server to Enhance Performance and Security with Version Manager 8.x)

パスマップセキュリティを使用するように File Server を構成すると、拡張パスマップセキュリティを無効化しない限り、VM 8.6.3.3 より前のクライアントからそのパスマップにアクセスできなくなります。

詳細については、次の KB ドキュメントを参照してください: KM000021414: PVCS VM 8.6.3.3+ Enhanced Path Map Security

先頭に戻る


2.0 パフォーマンスに関する考慮事項

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

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

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

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

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

ウイルス対策ソフトウェアに起因するパフォーマンス低下を改善する方法については、次の KB ドキュメントを参照してください: S123872: How to Improve Version Manager Performance When Using Real-Time Virus Scanners

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

Version Manager クライアントセッションが最初に File Server との通信を開始するたびに、File Server クライアントキャッシュにある古いファイルが Version Manager によって自動的に削除されます。

この機能を利用するには、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 ディレクトリになります。

先頭に戻る


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

3.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) を参照してください。

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

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

$Keyword::$123456::$

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

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

$Keyword::123456$

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

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

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

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

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

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

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

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

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

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

デフォルトでは、Version Manager は、ラベルの作成時に、不正な文字をチェックし(例えば、ダッシュ(-))、あれば拒否します。 不正な文字を含んだラベルを作成する必要がある場合は、ラベルの不正な文字をチェックするフィルタを無効にすることができます。 PVCS Version Manager コマンドラインガイドで、DisableBadLabelFilterディレクティブを参照してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

SBM サーバに HTTPS を使ってアクセスしている場合、VM I-Net Web Client からの SourceBridge 関連付けに失敗することがあります。 この問題を解決するには、SSL 証明書を JRE キーストアに追加します。 詳細については、次の KB ドキュメントを参照してください: S134480: Using SourceBridge from the VM I-Net Web Client when the connection to the SBM server uses HTTPS (Secure Sockets Layer - SSL)

3.10 "チェックイン時に必ず関連付け" は、デスクトップクライアント上に SourceBridge コンポーネントが必要 [DEF172990]

チェックイン時に関連付けを必須にするには、SourceBridge コンポーネントをデスクトップクライアントマシン上にインストールしなくてはなりません。 さもないと、チェックインは関連付けを必須にしていても、確認や警告を表示しません。

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

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

この問題を解決するには、次の KB ドキュメントを参照してください: S134480: PVCS VM: How to Configure Version Manager to use LDAP over SSL (LDAPS)

3.12 パスマップの競合

デフォルトでは、Version Manager クライアントは競合したパスマップへのアクセスを拒否し、メッセージを表示します。 競合しているパスマップはプロジェクトデータベースを開くダイアログに赤色で表示されます。 パスマップの競合はユーザが、2つ、または、それ以上のパスマップにアクセスした際に、完全もしくは一部が他のサーバのものと重複している場合に起きます。

これら競合を解決するには、PVCS Version Manager 管理者ガイド を参照ください。 不適切に扱われると競合パスマップは、ファイルに対して間違った操作を行う原因にもなります。

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

File Server のパスマップセキュリティを有効化するには、[アクセスコントロールデータベース]の [セキュリティを有効にする] オプションを有効にする必要があります。

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

〈セキュリティを有効にする(Enable access control database security)〉 チェックボックスは、〔プロジェクトデータベースの設定〕ダイアログの 〔全般(General)〕 タブ上にあります(デスクトップクライアントで [管理]-[詳細設定]を選択)。 〔オプション〕ツリーから[セキュリティ][アクセスコントロールデータベース]を選択します。

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

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

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

3.15 大規模プロジェクトでの、"Out of Memory Error" または、General Failure Operating

大規模プロジェクトでは、Version Manager インターフェイスの使用状況によっては、Java のメモリ割り当てを超えることがあります。

この問題を解決するには、次の KB ドキュメントを参照してください: S138022: Version Manager - How to fix Out Of Memory and java.lang.OutOfMemoryError messages

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

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

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

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

先頭に戻る


4.0 Windows における既知の問題

4.1 ユーザの切り替え機能が SSO PDB で利用できない

SSO/CAC ログインソースを使ったプロジェクトデータベースに対するユーザの切り替え機能は、VM I-Net Web クライアントでは利用できません。 ユーザーを切り替えるには、一旦ログアウトし、ほかのユーザーでログインし直してください。

4.2 vconfig へのアクセスと vmwfvc.dll の更新には管理者ユーザ権限が必要

vconfig.exe にアクセスするまたは、vmwfvc.dll ファイルを更新するには、Windows に管理者としてログインするもしくは、管理者として実行 オプションを使う必要があります。

詳しくは、Visual Studio: Windows 管理者ユーザを必要とする トピックを参照ください。

4.3 サードパーティ DLL 競合エラー: "The ordinal <number> could not be located in the dynamic link library <Name>.dll"

サードパーティ DLL の競合となった場合、ISLV.INI ファイルに、DLL 名の追加をしてみてください。 ISLV.INIファイルに[THIRDPARTY]セクションがない場合は、そのセクションを作成し、競合するDLLを以下のように追加します。

[THIRDPARTY]
PVCS.VM.THIRDPARTYDLLS=libeay32.dll:ssleay32.dll

DLL の名前は以下のようにします。

先頭に戻る


5.0 UNIX/Linux における既知の問題

5.1 "Error in getting local hostname"

Version Manager はワークステーションがネットワークに登録されるまで、ライセンスできません。 Version Manager を使用する前に、ネットワークに登録してください。

5.2 Linux CAC: ActiveIdentity クライアント PIN キャッシュ設定

Linux システム上の ActiveIdentity クライアントにより、PIN キャッシュが利用できます。特定の事情によっては、PIN の入力をしても結果的にアクセスできます。 この可能性を回避するには、キャッシュ保持の間隔を短くするか、ActiveIdentity クライアントの PIN キャッシュ機能を無効にします。 これにより、特定のシナリオにおいて、望ましくない結果になる恐れがあります。

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

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

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

先頭に戻る


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 PowerBuilder: 未修正リビジョンのロックは常に解除する必要がある

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

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

7.2 Issue の関連付けの要求: SCC プロバイダを PVCS Version Manager SourceBridge に設定

関連付けを必須にするためには、SourceBridge を設定するだけでなく、ご使用の Issue 管理システムと SCC プロバイダの設定をする必要があります。 PVCS Version Manager SourceBridge に SCC プロバイダを設定するには、PVCS Version Manager SCC Admin を使用します。

先頭に戻る


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

8.1 サーバサイド処理が、デフォルトで有効化されている

サーバサイド処理が、デフォルトで有効化されています。 従って、デフォルトで、すべてのイベントトリガは、サーバ側で実行されます。 上記の動作に不都合がある場合、以前のクライアント側処理の振る舞いに戻すことができます。 詳しくは、PVCS Version Manager IDE クライアント操作ガイド を参照ください(「setting default options for your particular IDE」セクション)。

8.2 サーバサイド処理が、File Server 上で、"localhost" の定義を必要とする

リッチ IDE でサーバサイド処理機能を使う場合、すべての File Server はリポジトリとして、同じサーバ上の統合を設定し、RIDE ユーザは、その File Server に接続します("localhost" もしくは、自身のサーバ名)。 この設定をするには、PVCS Version Manager 管理者ガイドの「File Server」を参照ください。

8.3 Eclipse: いくつかのサードパーティのフォルダを除外する必要がある。例 ibmconfig

いくつかのサードパーティツールが外部コンテントが追加されると作るフォルダによって、機能が失敗します。 アイテムがソースコントロール配下に追加されると、RIDE 統合が、_serena フォルダに追加されるため、ソースコントロール下のサードパーティフォルダを除外する必要があります。 ibmconfig フォルダは、その問題の一つと知られています。 詳しい、ソースコントロールからのファイル、フォルダの除外については、PVCS IDE 操作ガイド を参照ください。

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

リッチ統合は、ファイルの特定にデフォルトバージョン(ラベル)を使用し、Version Manager ワークスペースに表示されます。 混乱を避けるために、これがどう機能するのか理解することは重要です。

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

この混乱を回避するには:

詳しくは、Version Manager IDE クライアント操作ガイド を参照ください。

8.5 Application Server による 8.5.1 以前のクライアントの拒否

非常に大きなデータセット利用時のサーバ安定性を改善する為、VM Web Application Server は 8.5.1 以前のクライアントによるサーバサイド処理の使用を拒否します。 クライアントには以下のようなメッセージが表示されます:

[情報] サーバサイド処理は 8.4.1 サーバ以前では使用できません。 クライアントサイド処理に切り替えます。
このメッセージを回避するにはウインドウ>設定>チーム> Serena >クライアント / サーバ から「サーバサイド処理の有効化」のチェックを外してください。

クライアントは表示の通りプロジェクトデータベースに今までどおり従来のクライアントサイド処理にてアクセスできます。
この動作を無効にし、8.5.1以前のクライアントがサーバサイド処理にてアクセスすることを許容するにはサーバの ISLV.ini に以下のディレクティブを追加します

   [APP_SERVER]
   pvcs.appserver.rejectClientsWithoutHugeSetsCapability=false

これは RIDE プロジェクトのサイズが小さく、すぐにクライアントを 8.5.1 かそれ以降にアップグレードできない場合のみに使用します。

 

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

先頭に戻る


9.0 パフォーマンスに関する考慮事項

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

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

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

ウイルス対策ソフトウェアに起因するパフォーマンス低下を改善する方法については、次の KB ドキュメントを参照してください: S123872: How to Improve Version Manager Performance When Using Real-Time Virus Scanners

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

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

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

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

先頭に戻る


10.0 既知の問題

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

10.2 イベントトリガの使用

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

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

10.3 ポップアップブロックにより Version Manager が正常に動作しない

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

10.4 Web Server Application が File Server 上で、"localhost" の定義を必要とする

一つ、もしくは複数のサーブレットを Version Manager Web Application に定義する時、(Version Manager Web クライアントからの接続を可能とします)、プロジェクトデータベースが Version Manager File Server に存在する場合は、サーバ上にこれらの定義をしておく必要があります("localhost" もしくは、自身のサーバ名)。 この設定をするには、PVCS Version Manager 管理者ガイドの「File Server」を参照ください。

 

パート 4: Version Manager WebDAV Server

先頭に戻る


11.0 既知の問題

11.1 Windows 7 からの VM WebDAV サーバへのログイン

(Windows 7 のみ) Version Manager WebDAV サーバが使用しているダイジェスト認証機構は、Microsoft WebDAV ミニ リダイレクタと互換性がありません。 この問題を回避するには、次のナレッジベースのサポート記事を参照してください。

http://knowledgebase.serena.com/InfoCenter/index?page=content&id=D21501

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

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

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

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

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

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

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

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

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

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

11.6 権限を指定する

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

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

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

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

11.7 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: 著作権/免責事項/サポート

先頭に戻る


12.0 サポート

12.1 サポート情報

製品サポートを受けるには、portal.microfocus.com にログインしてください。

先頭に戻る


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

PVCS Version Manager と共にインストールされ、使用されるサードパーティ製コンポーネントに関するライセンス情報については、PVCS のインストールディレクトリを参照してください。


End Readme
Copyright © 2003-2024 Micro Focus or one of its affiliates.