Serena ChangeMan Version Manager
版本 8.1.1
自述文件:安装信息
上次更新时间 2005 年 8 月 10 日
内部版本994

本自述文件包含有关安装和使用 Version Manager 当前版本的信息,手册或联机帮助中不包含这些信息。有关其他信息,可以通过浏览器在 KnowledgeBase(知识库)文章中查找。

Version Manager 自述文件包括以下文件:

要查看主许可协议,请参阅 MasterLicenseAgreement.pdf

本自述文件可分成不同的部分。请阅读与正在使用的 Version Manager 组件相对应的部分。


目录

第 1 部分:Version Manager CLI、桌面客户端和 PCLI
第 2 部分:Version Manager IDE 客户端
第 3 部分:Version Manager Web 客户端
第 4 部分:Version Manager WebDAV 服务器
第 5 部分:版权/声明/支持信息

 

第 1 部分:Version Manager CLI、桌面客户端和 PCLI

1.0 支持的平台/软件

1.1 支持的 Windows 平台

1.2 支持的 UNIX 平台

2.0 安装

2.1 从早期版本升级之前卸载

2.2 文件服务器和 Web 服务器应用程序必须一起安装

2.3 Linux 错误:"Illegal end day of week in month(非法的月份结束日)"; PCLI 和桌面锁定

2.4 停止服务器并同时升级客户端和服务器 [必需]

2.5 升级前移除 NT 服务(Version Manager 文件服务器、Web 服务器或 WebDAV 服务器)[必需]

2.6 工作站安装

2.7 Windows 安装

2.8 UNIX 安装

2.9 用户必须在升级 Version Manager 后安装新的 Web 客户端 Applet [必需]

2.10 UNIX 上的 Serena ChangeMan Builder 集成

 

第 2 部分:Version Manager IDE 客户端

3.0 支持的平台/软件

3.1 支持的平台

3.2 支持的 IDE

3.3 仅将 Windows 安全性用于 Web 项目

3.4 支持的 Serena TrackerLink 版本

3.5 Eclipse 充分集成:TeamTrack 集成需要 Java Runtime Environment (JRE) 1.4.2_06 或更高版本

3.6 Eclipse 与 .NET 的充分集成:需要 TeamTrack 6.3 以显示日语字符

4.0 安装

4.1 必须在升级前卸载先前的 IDE 客户端

4.2 TrackerLink 用户必须选择源控制提供程序

4.3 在安装 SourceBridge 之前将 SCC 提供程序设置为 Version Manager

4.4 Eclipse 2:UNC 工作站安装需要对 setup.ini 文件进行编辑

4.5 Windows 2003 Server 上的 IIS 6 需要进行额外设置

4.6 Eclipse:有时在安装完 Version Manager 后插件无法进行初始化

 

第 3 部分:Version Manager Web 客户端

5.0 支持的 Web 服务器平台

5.1 支持的 Windows 平台

5.2 支持的 UNIX 平台

6.0 支持的 Web 客户端平台

6.1 支持的 Windows 平台

6.2 支持的 UNIX 平台

7.0 升级考虑事项

7.1 从早期版本升级之前卸载

7.2 Windows:未向非管理员用户提供明显的方法来卸载 Web 客户端

7.3 升级前移除 NT 服务(I-Net 或 WebDAV 服务器)[必需]

7.4 迁移 Version Manager Servlet 的长列表

8.0 安装

8.1 加载较旧 Applet 时出现 Applet 安装问题

8.2 在 Internet Explorer 和 TrackerLink 中使用 JRE 1.4.0x 时产生问题

8.3 因禁用 Cookie 而产生登录问题

8.4 单独安装 Web 服务器应用程序需要使用附加步骤

8.5 在 Windows 2000 上安装 Version Manager Web 客户端

8.6 Pentium IV 服务器上的 iPlanet Web 服务器

8.7 UNIX:必须将浏览器位置添加到路径中

8.8 Apache Web 服务器和动态共享对象 (DSO) 支持

8.9 运行 configure_inet 配置其他 Web 服务器

8.10 将 TrackerLink 用于安全套接字协议层 (SSL)

8.11 Web 客户端安装会在客户端计算机上生成大的临时 Web 服务器安装文件

8.12 将 Web 客户端用于 Version Manager 文件服务器

8.13 在 Windows 2003 Server 上准备 IIS 6

 

第 4 部分:Version Manager WebDAV 服务器

9.0 支持的平台

9.1 服务器要求

9.2 客户端要求

10.0 安装

10.1 升级前移除 NT 服务(I-Net 或 WebDAV 服务器)[必需]

10.2 Apache Web 服务器和动态共享对象 (DSO) 支持

10.3 将 Microsoft Office 用于 Version Manager WebDAV 服务器

 

第 5 部分:版权/声明/支持信息

11.0 支持

11.1 支持信息

12.0 有关第三方软件的声明

12.1 第三方软件免责声明

 

返回页首

第 1 部分:Version Manager CLI、桌面客户端和 PCLI

返回目录


1.0 支持的平台/软件

1.1 支持的 Windows 平台

支持 Version Manager(适用于 Windows)的平台如下:

系统要求

除了操作系统要求,最低系统要求如下:

客户端系统 – 最低要求
平台 内存 CPU 磁盘空间
Win 2000 Pro 128 MB P200 140 MB
Win 2000 Server 128 MB P200 140 MB
Win XP Pro 128 MB P400 140 MB
Win 2003 Server 128 MB P400 140 MB

推荐的系统要求如下:

客户端系统 – 推荐要求
平台 内存 CPU 磁盘空间
Win 2000 Pro 256 MB P550 140 MB
Win 2000 Server 256 MB P550 140 MB
Win XP Pro 256 MB P550 140 MB
Win 2003 Server 256 MB P550 140 MB

服务器的内存要求取决于同时访问服务器的用户数和正在运行的后台进程数(默认情况下,正在运行的后台进程数为 5 至 20 个)。使用下表中的公式计算内存需求。

服务器系统
  基数 并发用户 后台进程 合计
公式 256 MB + 6 MB/用户 + 8 MB/后台进程 = ?
示例 256 MB 6 x 100 = 600 MB 8 x 20 = 160 MB = 1016 MB

说明:本示例采用的是 100 个并发用户和 20 个后台进程。本示例仅用于说明该公式的用法,并不用作推荐值。

1.2 支持的 UNIX 平台

支持 Version Manager(适用于 UNIX)的平台如下:

系统要求

除了操作系统要求,最低系统要求如下:

客户端系统 – 最低要求
平台 内存 磁盘空间
Solaris 64 MB 112 MB
HP-UX 64 MB 141 MB
AIX 64 MB 65 MB
Red Hat Linux 64 MB 117 MB
SuSE 64 MB 117 MB

推荐的系统要求如下:

客户端系统 – 推荐要求
平台 内存 磁盘空间
Solaris 128 MB 112 MB
HP-UX 128 MB 141 MB
AIX 128 MB 65 MB
Red Hat Linux 128 MB 117 MB
SuSE 128 MB 117 MB

说明:内存要求是按 Version Manager 的“会话”来计算的。

服务器的内存要求取决于同时访问服务器的用户数和正在运行的后台进程数(默认情况下,将要运行的后台进程数为 5 至 20 个)。使用下表中的公式计算内存需求。

服务器系统
  基数 并发用户 后台进程 合计
公式 256 MB + 6 MB/用户 + 8 MB/后台进程 = ?
示例 256 MB 6 x 100 = 600 MB 8 x 20 = 160 MB = 1016 MB

说明:本示例采用的是 100 个并发用户和 20 个后台进程。本示例仅用于说明该公式的用法,并不用作推荐值。

安装期间的其他空间要求

在 Linux、Solaris、HP-UX 和 AIX 上安装 Version Manager 8.1.1 将在 $TMP(除非删除此数据,否则将持续存在)指定的目录中占用大量空间,并且会将大量数据放置在 VM_Install_Dir/VM8.1.1_inst 目录中。下表提供了安装期间所需的近似临时空间量(大小以字节表示):

平台 $TMP 目录 VM8.1.1_inst 合计
Linux 108236 208612 316848
Solaris 108388 205232 313620
HP-UX 203568 404326 607894
AIX 98756 186334 285090

说明:大约需要 170 MB 的额外空间才能扩展 vm811unixpatch.tar 以便能够使用;但是,可以将该数据写入网络上的任何位置—甚至写入 CD-ROM。

返回目录


2.0 安装

2.1 从早期版本升级之前卸载

如果计划在先前版本的相同安装位置安装 Version Manager,则必须在升级前卸载先前版本。可以保留样例数据库,但是应当移除所有其他文件。无法执行这些卸载任务会在升级时导致冲突。

要在 Windows 上保留 Servlet 定义,请备份 PVCSServlets.properties 文件,然后在安装新版本后将其恢复至 VM_Install_Dir\vm\inet\props\PVCSServlets.properties。接着,启动 Version Manager Web 服务器应用程序配置实用工具,并确保“Location of Netscape Configuration Files”(Netscape 配置文件的位置)和/或“Location of Microsoft IIS Scripts Directory”(Microsoft IIS 脚本目录的位置)与新服务器安装的所需位置相匹配(由于这两个位置都是从 PVCSServlets.properties 继承而来)。最后,依次转至 Servlets 选项卡,从列表中选择第一个 servlet,单击“Modify”(修改),然后单击“Apply”(应用)。对于其余的所有 servlet,重复该步骤。

UNIX 上 Version Manager Server 6.8.00 的用户应当保留 VM6800_Install_Dir/vminet/tomcat/webapps/vminet/WEB-INF/web.xml 文件,而 Version Manager I-Net 6.8.1x 或更高版本的用户应当保留 VM681x_Install_Dir/vm/common/tomcat/webapps/vminet/WEB-INF/web.xml 文件。安装新版本后,对于引用添加到旧 web.xml 文件的项目数据库的每个 servlet,复制从 <servlet> 直到并包括 </servlet> 的部分,然后将这些部分添加到新的 web.xml 文件(该文件可以在 VM_Install_Dir/vm/common/tomcat/webapps/vminet/WEB-INF/web.xml 找到)。每个 servlet 均包含的这两个 <servlet-mapping> ... </servlet-mapping> 部分都应复制到新的 web.xml 文件。

无法保留在 UNIX Version Manager Server 6.8.00(使用 servlets.properties 文件)的先前版本中定义的 Servlet。

卸载前,请确保 Version Manager Web 服务器和您的 Web 服务器(IIS、iPlanet、Java System Web Server 或 Apache)不在运行中。

备份配置文件

保存以下文件的备份副本是一种很好的方法:

Install_Dir\vm\common\bin\pvcsstart.bat(UNIX 上的 pvcsstart.sh
Install_Dir\vm\common\tomcat\conf\jk\uriworkermap.properties
Install_Dir\vm\inet\props\PVCSServlets.properties
(仅适用于 Web 服务器)
Install_Dir\vm\common\tomcat\webapps\vminet\WEB-INF\web.xml
(仅适用于文件服务器)
Install_Dir\vm\common\tomcat\webapps\webdav\WEB-INF\web.xml
(仅适用于 WebDAV 服务器)
Install_Dir\vm\common\tomcat\webapps\merantfs\WEB-INF\server-config.wsdd

2.2 文件服务器和 Web 服务器应用程序必须一起安装

安装 Version Manager 文件服务器组件时,还必须同时选择 Web 服务器应用程序;否则,无法正确启动文件服务器。

2.3 Linux 错误:"Illegal end day of week in month(非法的月份结束日)"; PCLI 和桌面锁定

如果选择安装样例数据库,则安装期间会出现该错误消息。尝试运行 PCLI 命令时也会出现该错误;桌面客户端和 PCLI 会挂起。如果将本地时区设置为“Australia/Melbourne”(澳大利亚/墨尔本),则也会出现该错误。设置为其他时区时,也会出现该错误。

可以通过指定等效时区(不同名称、相同时间)来解决此问题。下面是更改时区的两种方法:

2.4 停止服务器并同时升级客户端和服务器 [必需]

如果使用 Version Manager Web 服务器、文件服务器或 WebDAV 服务器,则必须在升级前停止服务器。有关详细信息,请参阅《Serena ChangeMan Version Manager Installation Guide》(Serena ChangeMan Version Manager 安装指南)。

如果使用 Version Manager 文件服务器,则必须安装 Version Manager 客户端和服务器的最新版本。

2.5 升级前移除 NT 服务(Version Manager 文件服务器、Web 服务器或 WebDAV 服务器)[必需]

如果作为 NT 服务安装 Version Manager 应用程序服务器,则必须在升级前移除该服务。

要移除该服务,请执行以下步骤:

  1. 从“Start”(开始)菜单的 Serena 子菜单启动 Version Manager 应用程序服务器配置实用工具。

  2. 单击 Remove NT Service(移除 NT 服务)按钮。

  3. 重新启动计算机。

2.6 工作站安装

使用目录名称长于 8 个字符的 UNC 路径名称进行安装

如果要使用所包含的任何目录名称均长于 8 个字符的路径名称安装到服务器,则会首先需要将一个网络驱动器映射至该位置,然后使用驱动器映射安装 Version Manager。如果不使用驱动器映射,则会显示一条错误消息,说明到设置可执行文件的路径无效。

要在从 Version Manager 的网络安装进行安装或操作时避免出错,请确保网络路径名称所包含的目录名称不长于 8 个字符。

使用 Microsoft Novell 客户端驱动程序可能无法安装工作站

如果使用 Microsoft Novell 客户端驱动程序访问 Netware 服务器,则 Version Manager 的工作站安装无法预见。建议使用 Novell Netware 客户端驱动程序。

Eclipse 2:UNC 工作站安装需要对 setup.ini 文件进行编辑

请参阅下面的名称为“第 2 部分:Version Manager IDE 客户端”的相关主题

2.7 Windows 安装

Windows 2000 安装需要管理员权限

如果没有管理员权限,则安装会导致 InstallShield 错误,该错误要求移除 winnt/IsUnist.exe 文件。移除此文件也需要管理员权限。

如果在没有管理员权限的情况下尝试安装 Version Manager,并且 winnt/IsUnist.exe 文件已删除,则会显示一个错误框,该框带有一个 X(背景为红色)和一个 OK(确定)按钮。单击 OK(确定)将终止安装进程;忽略该错误框可使安装成功完成。

可能需要升级 IDE 客户端

如果 IDE 客户端的现有安装程序早于 6.7.11 SP2,则必须在升级 Version Manager 时升级该客户端。早于 6.7.11 SP2 的 Version Manager IDE 客户端的 Build 不会与 Version Manager 的较新 Build 兼容。

安装到 UNC 共享的根时显示所需空间为零

安装到 UNC 共享的根时,安装程序指示所需空间为零。如果在该共享上选择一个目录,则安装程序会正确显示所需空间。在任一情况下,假设在该共享上实际具有足够的磁盘空间,则均会正确安装 Version Manager。

根驱动器上磁盘空间不足无法安装 Version Manager

要成功安装 Version Manager,在包含 Windows 的驱动器上需要 450 MB 的硬盘空间(150 MB 用于 CD-ROM 安装),在目标驱动器上需要 600 MB 的空间。如果删除在安装期间创建的临时文件,则安装 Version Manager 后便不需要该空间量。

2.8 UNIX 安装

UNIX 平台必需的操作系统补丁程序

有些 UNIX 平台在按 Version Manager 的使用方式运行 JRE 之前需要补丁程序。有关更多信息,请参阅位于 support.serena.com 的 Serena 支持(使用“Advanced Search”(高级搜索)页面搜索 KB70396)。

HP-UX:推荐的内核参数设置

设置以下内核参数以使 Version Manager Web 和文件服务器在 HP-UX 上正常运行:

max_thread_proc 1000
maxfiles 2000

重要说明:设置内核参数后,必须重新生成内核。

UNIX 上的最终用户授权

要在 UNIX 上设置最终用户工作站的授权,名为 vmreg 的 shell 脚本会更新 $PVCS_BINDIR 目录中的 license.ini 文件和/或最终用户主目录中的 .islvrc 文件。Version Manager 安装脚本和启动脚本会自动运行 vmreg,但是管理员和用户也可以运行该脚本。例如,管理员可以将当前的配置文件信息保存在 $PVCS_BINDIR/license.ini 中,然后用户可以通过运行 vmreg 将该信息移动到用户的个人 .islvrc 文件中。使用命令行(而非 PCLI 或桌面客户端)的最终用户需要在使用命令行之前运行 vmreg 一次。

可以使用以下方法调用该脚本:

2.9 用户必须在升级 Version Manager 后安装新的 Web 客户端 Applet [必需]

安装 Version Manager 后,Linux、Solaris、HP-UX 和 AIX 上的 Web 客户端用户必须在登录到新服务器之前安装新的 Web 客户端 applet。无法执行该操作会导致不可预测的行为,例如用户在成功执行签出操作后看到错误消息。

2.10 UNIX 上的 Serena ChangeMan Builder 集成

Serena ChangeMan Builder 到 Version Manager 的集成可能失败。要避免出现此问题,请确保具有最新的 Serena ChangeMan Builder 补丁程序。可以从 support.serena.com 获取该补丁程序。如果 Serena ChangeMan Builder CD 标记为 MB 8010,则该 CD 已经包含修复程序。标记为 Merant Build 8010 的 CD 需要补丁程序。

 

第 2 部分:Version Manager IDE 客户端

返回目录


3.0 支持的平台/软件

3.1 支持的平台

支持 Version Manager IDE 客户端的平台如下:

以下 Web 服务器配置可用于 Microsoft FrontPage 和 Visual InterDev Web 项目:

Web 服务器 操作系统
IIS 5.0 Windows 2000 Server
IIS 6.0 Windows 2003 Server

说明:如果在 Windows 2003 Server 上使用的是 IIS 6,则还需要将 isapi-redirect.dll 设置为 Web 服务扩展文件。请参阅 Microsoft 知识库文章 328419

3.2 支持的 IDE

Version Manager IDE 客户端支持以下开发环境:

说明:对于与 IBM VisualAge for Java 的集成,必须按上述方法安装适当的 IBM 补丁程序。

3.3 仅将 Windows 安全性用于 Web 项目

与 Visual InterDev/FrontPage Web 项目关联的 Version Manager 项目依赖 Windows 安全性。请不要为 Web 项目配置访问控制数据库。

有关详细信息,请参阅《Serena ChangeMan Version Manager IDE Client Implementation Guide》(Serena ChangeMan Version Manager IDE 客户端实现指南)。

3.4 支持的 Serena TrackerLink 版本

Version Manager IDE 客户端经过认证可用于 Serena TrackerLink 6.5 和更高版本。但是,需要使用 Tracker 6.6 或更高版本以实现“Clean up associations on undo checkout”(在撤消签出时清除关联)功能。

3.5 Eclipse 充分集成:TeamTrack 集成需要 Java Runtime Environment (JRE) 1.4.2_06 或更高版本

如果使用的是 Java Runtime Environment (JRE) 的旧版本,则由于 JRE 1.4.2_06 的先前版本存在 TeamTrack 身份验证问题,因此“Eclipse Issue”(Eclipse 问题)视图不会显示报告和问题。

3.6 Eclipse 与 .NET 的充分集成:需要 TeamTrack 6.3 以显示日语字符

除非在 TeamTrack 6.3 或更新版本中使用“Serena Issues”(Serena 问题)视图,否则该视图不会正确显示日语字符。

返回目录


4.0 安装

4.1 必须在升级前卸载先前的 IDE 客户端

要使用 Version Manager IDE 客户端版本 8,必须在安装 Version Manager 8 之前卸载系统上任何先前的 IDE 客户端版本。如果希望在安装 Version Manager 8 后使用 IDE 客户端的较旧版本,则必须在安装较旧软件前卸载 Version Manager 8。

4.2 TrackerLink 用户必须选择源控制提供程序

如果将 Serena TrackerLink 安装到系统上,则安装 IDE 客户端后,该程序仍为活动的源控制提供程序。

要在安装 TrackerLink 的情况下使用 IDE:

  1. 退出任何打开的 IDE。

  2. 从“Start”(开始)菜单的 Serena Tracker 程序组中选择 TrackerLink。这时将出现“Serena TrackerLink”对话框。

  3. 从“SCC Provider”(SCC 提供程序)下拉列表中选择 Serena ChangeMan Version Manager。

  4. 单击“Activate”(激活)按钮。下次启动 IDE 时更改即可生效。

要在未安装 TrackerLink 的情况下使用 IDE:

  1. 退出任何打开的 IDE。

  2. 从 Windows 的“Start”(开始)菜单中选择“Serena”、“Serena ChangeMan Version Manager”、“Version Manager IDE Client”(Version Manager IDE 客户端)、“Select Serena Provider”(选择 Serena 提供程序)。这时将出现“Select Serena Provider”(选择 Serena 提供程序)对话框。

  3. 选择 Serena ChangeMan Version Manager。

  4. 单击“OK”(确定)。下次启动 IDE 时更改即可生效。

4.3 在安装 SourceBridge 之前将 SCC 提供程序设置为 Version Manager

如果当前将 TrackerLink 用于 SCC IDE,但是希望转而使用 SourceBridge (TeamTrack),则在安装 SourceBridge 前将 SCC 提供程序从 TrackerLink 更改为 Version Manager。然后,SourceBridge 将其本身设置为 SCC 提供程序,并且将 SCC 信息传递至 Version Manager。

要设置 SCC 提供程序,请启动 Version Manager SCC Admin。有关详细信息,请参阅《Serena ChangeMan Version Manager IDE Client Implementation Guide》(Serena ChangeMan Version Manager IDE 客户端实现指南)。

如果在仍将 TrackerLink 设置为 SCC 提供程序的情况下安装 SourceBridge,则 SourceBridge 将尝试使用 TrackerLink 作为 SCC 提供程序。而源控制将不会工作。

要更正该错误,请在“SourceBridge”对话框的“System Settings”(系统设置)选项卡中设置 SCC 提供程序。有关详细信息,请参阅《Serena ChangeMan Version Manager Administrator's Guide》(Serena ChangeMan Version Manager 管理员指南)的“About Setting Up SourceBridge”(关于设置 SourceBridge)部分。

4.4 Eclipse 2:UNC 工作站安装需要对 setup.ini 文件进行编辑

如果使用 UNC 路径将 Version Manager 安装到网络以备执行 Eclipse 2 插件的工作站安装,则必须在安装到工作站前编辑 setup.ini 文件,否则 Eclipse 集成不会正常工作。

要修改 UNC 工作站安装以用于 Eclipse 2:

  1. 按照《Serena ChangeMan Version Manager Installation Guide》(Serena ChangeMan Version Manager 安装指南)中的所述将 Version Manager 安装到网络位置。

  2. 使用文本编辑器打开 \workinst\setup.ini 文件。

  3. 找到该文件的 [Workstation] 部分。该文本将类似于以下内容:

    [Workstation]
    InstallDir=\\server\shared\serena\
    vmdevint=\\server\shared\serena\vm\common\vmdevint

  4. InstallDir= 行的 UNC 路径更改为可用于所有工作站的驱动器映射。例如:

    [Workstation]
    InstallDir=g:\serena\
    vmdevint=\\server\shared\serena\vm\common\vmdevint

  5. 保存该文件。

  6. 现在即可安装到各个工作站。

4.5 Windows 2003 Server 上的 IIS 6 需要进行额外设置

如果在 Windows 2003 Server 上使用的是 IIS 6,则还需要将 isapi-redirect.dll 设置为 Web 服务扩展文件。请参阅 Microsoft 知识库文章 328419

4.6 Eclipse:有时在安装完 Version Manager 后插件无法进行初始化

解决方法:重新启动以更新系统的路径信息。

第 3 部分:Version Manager Web 客户端

返回目录


5.0 支持的 Web 服务器平台

5.1 支持的 Windows 平台

支持的操作系统:

支持的 Web 服务器:

说明:如果在 Windows 2003 Server 上使用的是 IIS 6,则还需要设置 isapi-redirect.dll 作为 Web 服务扩展文件。请参阅 Microsoft 知识库文章 328419

要求:

服务器的内存要求取决于同时访问服务器的用户数和正在运行的后台进程数(默认情况下,将要运行的后台进程数为 5 至 20 个)。使用下表中的公式计算内存需求。

服务器系统
  基数 并发用户 后台进程 合计
公式 256 MB + 6 MB/用户 + 8 MB/后台进程 = ?
示例 256 MB 6 x 100 = 600 MB 8 x 20 = 160 MB = 1016 MB

说明:本示例采用的是 100 个并发用户和 20 个后台进程。本示例仅用于说明该公式的用法,并不用作推荐值。

5.2 支持的 UNIX 平台

支持的操作系统:

支持的 Web 服务器:

要求:

服务器的内存要求取决于同时访问服务器的用户数和正在运行的后台进程数(默认情况下,将要运行的后台进程数为 5 至 20 个)。使用下表中的公式计算内存需求。

服务器系统
  基数 并发用户 后台进程 合计
公式 256 MB + 6 MB/用户 + 8 MB/后台进程 = ?
示例 256 MB 6 x 100 = 600 MB 8 x 20 = 160 MB = 1016 MB

说明:本示例采用的是 100 个并发用户和 20 个后台进程。本示例仅用于说明该公式的用法,并不用作推荐值。

6.0 支持的 Web 客户端平台

支持 Version Manager Web 客户端的平台显示如下。

6.1 支持的 Windows 平台

操作系统:

Web 浏览器:

6.2 支持的 UNIX 平台

操作系统:

Web 浏览器:

返回目录


7.0 升级考虑事项

7.1 从早期版本升级之前卸载

如果计划在先前版本的相同安装位置安装 Version Manager,则必须在升级前卸载先前版本。可以保留样例数据库,但是应当移除所有其他文件。无法执行这些卸载任务会在升级时导致冲突。

要在 Windows 上保留 Servlet 定义,请备份 PVCSServlets.properties 文件,然后在安装新版本后将其恢复至 VM_Install_Dir\vm\inet\props\PVCSServlets.properties。接着,启动 Version Manager Web 服务器应用程序配置实用工具,并确保“Location of Netscape Configuration Files”(Netscape 配置文件的位置)和/或“Location of Microsoft IIS Scripts Directory”(Microsoft IIS 脚本目录的位置)与新服务器安装的所需位置相匹配(由于这两个位置都是从 PVCSServlets.properties 继承而来)。最后,依次转至 Servlets 选项卡,从列表中选择第一个 servlet,单击“Modify”(修改),然后单击“Apply”(应用)。对于其余的所有 servlet,重复该步骤。

UNIX 上 Version Manager Server 6.8.00 的用户应当保留 VM6800_Install_Dir/vminet/tomcat/webapps/vminet/WEB-INF/web.xml 文件,而 Version Manager I-Net 6.8.1x 或更高版本的用户应当保留 VM681x_Install_Dir/vm/common/tomcat/webapps/vminet/WEB-INF/web.xml 文件。安装新版本后,对于引用添加到旧 web.xml 文件的项目数据库的每个 servlet,复制从 <servlet> 直到并包括 </servlet> 的部分,然后将这些部分添加到新的 web.xml 文件(该文件可以在 VM_Install_Dir/vm/common/tomcat/webapps/vminet/WEB-INF/web.xml 找到)。每个 servlet 均包含的这两个 <servlet-mapping> ... </servlet-mapping> 部分都应复制到新的 web.xml 文件。

无法保留在 UNIX Version Manager Server 6.8.00(使用 servlets.properties 文件)的先前版本中定义的 Servlet。

卸载前,请确保 Version Manager Web 服务器和您的 Web 服务器(IIS、iPlanet、Java System Web Server 或 Apache)不在运行中。

备份配置文件

保存以下文件的备份副本是一种很好的方法:

Install_Dir\vm\common\bin\pvcsstart.bat(UNIX 上的 pvcsstart.sh
Install_Dir\vm\common\tomcat\conf\jk\uriworkermap.properties
Install_Dir\vm\inet\props\PVCSServlets.properties
(仅适用于 Web 服务器)
Install_Dir\vm\common\tomcat\webapps\vminet\WEB-INF\web.xml
(仅适用于文件服务器)
Install_Dir\vm\common\tomcat\webapps\webdav\WEB-INF\web.xml
(仅适用于 WebDAV 服务器)
Install_Dir\vm\common\tomcat\webapps\merantfs\WEB-INF\server-config.wsdd

7.2 Windows:未向非管理员用户提供明显的方法来卸载 Web 客户端

如果未完全移除 applet,则在安装其他版本后会出现异常行为。按照以下步骤移除 applet:

版本 7.5 或更低版本

  1. 在 <Windows Dir>\Downloaded Program 文件中,右键单击 VM I-Net applet,然后将其移除。

  2. 移除 <Windows System Dir>\vmi660.dll。

  3. 移除 <Windows Dir>\Java\lib\vmi660.zip。

  4. 在注册表编辑器中,移除以下条目:

    HKEY_CLASSES_ROOT\CLSID\{CCF028C4-4631-11D3-90BD-00A0C9B727E1}

版本 8.0 或更高版本

  1. 在 <Windows Dir>\Downloaded Program 文件中,右键单击 VM I-Net applet,然后将其移除。

  2. 移除 <Windows System Dir>\vmi660.dll。

  3. 移除 <Windows Dir>\Java\lib\vmi660.jar。

  4. 在注册表编辑器中,移除以下条目:

    HKEY_CLASSES_ROOT\CLSID\{CCF028C4-4631-11D3-90BD-00A0C9B727E1}

7.3 升级前移除 NT 服务(I-Net 或 WebDAV 服务器)[必需]

如果作为 NT 服务安装 PVCS Version Manager 应用程序服务器,则必须在升级前移除该服务。要执行此操作,请启动 Version Manager I-Net 配置实用工具。默认情况下,通过依次选择“Start”(开始)、“Programs”(程序)、“PVCS Version Manager”、“PVCS VM I-Net”、“PVCS VM I-Net Configuration Utility”(PVCS VM I-Net 配置实用工具)运行 Version Manager I-Net 配置实用工具。单击 Remove NT Service(移除 NT 服务)按钮。

7.4 迁移 Version Manager Servlet 的长列表

说明: 此过程适用于所有平台。

尝试从 5 个以上的 servlet 中手动重新配置 Version Manager Web 服务器,这很不现实。可以将关键配置文件“迁移”至新的服务器以帮助自动化该过程;但是,如果迁移的是非常多的 servlet,则需要了解以下信息:

  1. 如果安装目录相同,则这些文件的内部路径应当仍然有效。但是,应当仔细检查以下文件:

    ...\Serena\vm\common\tomcat\webapps\vminet\WEB-INF\web.xml

  2. 如果服务器名称相同,则该参数应当仍然有效;但是,如果迁移至新的服务器,则应当修改以下文件:

    ...\Serena\vm\common\tomcat\webapps\vminet\WEB-INF\web.xml
    ...\Serena\vm\inet\props\PVCSServlets.properties

  3. 对于 Version Manager 8.0,使用其他 AJP 辅助(AJP13 而非 AJP12)。建议同时执行更改。检查以下文件:

    ...\Serena\vm\common\tomcat\conf\jk\uriworkermap.properties

  4. 目前,Version Manager 7.5 具有一个已过时的参数。应当将其移除。并且不会将其写入新文件中。

    编辑以下文件:

    ...\Serena\vm\common\tomcat\webapps\vminet\WEB-INF\web.xml

    移除“ProjectServletAlias”的 servlet 映射。这是一次精心的编辑。必须作出注释或准确移除整个部分。只要您非常细心,即可容易地鉴别格式。格式如下:

    <servlet-mapping>
      <servlet-name> ProjectServletAlias </servlet-name>
      <url-pattern> /ProjectRootName </url-pattern>
    </servlet-mapping>

警告:建议在修改现有文件前对文件进行备份。

附加说明:文件服务器所用的项目数据库 (PDB) 看上去与上述配置文件中的任何其他 PDB 相同;无需执行其他操作即可访问文件服务器 PDB。

返回目录


8.0 安装

8.1 加载较旧 Applet 时出现 Applet 安装问题

如果尝试在另一实例正在运行时安装 Version Manager Web 客户端,则会出现错误。在安装 Version Manager Web 客户端之前关闭其他浏览器窗口。

说明:在有些情况下,可能需要移除旧 applet。请参阅卸载 Web 客户端

8.2 在 Internet Explorer 和 TrackerLink 中使用 JRE 1.4.0x 时产生问题

使用 Sun 的 JRE 1.4.0x 会导致 Internet Explorer 不稳定,并且不建议在 Version Manager Web 客户端中与 TrackerLink 一起使用。使用 JRE 1.4.2x 或 1.5x。

8.3 因禁用 Cookie 而产生登录问题

如果在浏览器中禁用 cookie,则将无法登录到 Version Manager Web 客户端。Version Manager Web 客户端使用 cookie 来存储登录信息。

8.4 单独安装 Web 服务器应用程序需要使用附加步骤

如果在安装 Version Manager 后添加 Version Manager Web 服务器应用程序,则必须运行 Version Manager Application Server Admin 工具并执行以下步骤:

  1. 转至 Servlets 选项卡。
  2. 选择一个 servlet(SampleDB 将足以满足需要)。
  3. 单击 Modify(修改)。
  4. 单击 Apply(应用)。

否则,无法访问 /vminet.html 或(安装文件服务器时)/serenafs/Admin

8.5 在 Windows 2000 上安装 Version Manager Web 客户端

要在 Windows 2000 Server 计算机上安装 Version Manager Web 客户端,必须具有本地管理员权限。

8.6 Pentium IV 服务器上的 iPlanet Web 服务器

要在 Pentium IV 服务器上启动 iPlanet Web 服务器,必须禁用内部 servlet 支持。从“iPlanet Web Server Administration”(iPlanet Web 服务器管理)页面,选择一个服务器进行管理。选择 Servlets 选项卡,然后选中 Activate the Servlet Engine(激活 Servlet 引擎)下的 No(否)选项。

8.7 UNIX:必须将浏览器位置添加到路径中

为正确加载 Version Manager applet,必须将浏览器位置添加到路径中:

export PATH=/apps/mozilla:$PATH

另:必须使用 PATH 语句启动浏览器:

mozilla &

8.8 Apache Web 服务器和动态共享对象 (DSO) 支持

要运行 Version Manager Web 服务器或 Version Manager WebDAV 服务器,Apache Web 服务器必须包含动态共享对象 (DSO) 支持。要确认 Web 服务器是否包含 DSO 支持,请从 Apache 的 bin 目录中运行以下命令:

./httpd -l

如果 mod_so.c 列在命令的输出中,则 Apache 安装包含 DSO。

如果 Apache 安装不包含 DSO 支持,则必须获取一个包含该支持的安装,编译自己的 Apache 服务器以包含 DSO 支持(在 Apache 1.3 README.configure 文件或 Apache 2.0 INSTALL 文件中进行了详细说明;在 Apache 的源分发中可以找到),或使用其他 Web 服务器。

8.9 运行 configure_inet 配置其他 Web 服务器

可以在安装完成后配置其他 Web 服务器以与 Version Manager 一起工作。要实现此目的,请运行命令:
VM_Install_Dir/vm/OS/bin/configure_inet VM_Install_Dir

例如:
/usr/serena/vm/linux/bin/configure_inet /usr/serena

8.10 将 TrackerLink 用于安全套接字协议层 (SSL)

要在启用 SSL 的服务器上将 TrackerLink 用于 Version Manager Web 客户端和 Tracker Web 客户端,必须将 SSL 证书添加到 JRE 密钥库。否则,TrackerLink 问题关联将会失败。

安装和配置 Tracker Web 服务器和 Version Manager Web 服务器后,执行以下操作:

  1. 如果尚未安装 JDK 1.4.2x 或 1.5x,则下载并安装该软件。

  2. 确定在 Web 服务器上启用 SSL 的证书文件的位置。证书文件由签署机构(如 VeriSign)签发,其文件扩展名为 .CER

  3. 运行以下命令:

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

    其中:

  4. 提示时,输入 JRE 密钥库的密码。默认密码为 changeit

8.11 Web 客户端安装会在客户端计算机上生成大的临时 Web 服务器安装文件

Version Manager Web 客户端安装完成后,如果磁盘空间是一个考虑因素,则可以删除名为“Serena ChangeMan Version Manager.msi”的文件。该文件通常位于名为“C:\Windows\Downloaded Installations”的文件夹中,所占空间大约为 110 MB。

删除该文件后,仍然可以使用“Add/Remove Programs”(添加/删除程序)修改或移除 Version Manager。

8.12 将 Web 客户端用于 Version Manager 文件服务器

要使 Web 客户端用户能够访问位于 Version Manager 文件服务器上的项目数据库,必须配置 Web 服务器以访问文件服务器。通过在运行 Version Manager Web 服务器的系统上运行桌面客户端并在“Admin”(管理员)、“File Server”(文件服务器)菜单中输入文件服务器规范,即可实现此目的。然后,确保在设置 servlet 时为项目数据库指定一个文件服务器路径映射基于客户端名称的位置。无需对 Web 客户端本身进行任何设置。

8.13 在 Windows 2003 Server 上准备 IIS 6

如果在 Windows 2003 Server 上使用的是 IIS 6,则还需要将 isapi-redirect.dll 设置为 Web 服务扩展文件。请参阅 Microsoft 知识库文章 328419

 

第 4 部分:Version Manager WebDAV 服务器

返回目录


9.0 支持的平台

9.1 服务器要求

支持的操作系统:

支持的 Web 服务器:

9.2 客户端要求

支持的操作系统:

说明:WebDAV 的只读支持可用于 Windows XP DAV 文件系统和 Mac OS DAV 文件系统。

支持的 WebDAV 客户端如下:

其他支持 WebDAV 的客户端也可能有效,但目前还不受支持。

返回目录


10.0 安装

10.1 升级前移除 NT 服务(I-Net 或 WebDAV 服务器)[必需]

如果作为 NT 服务安装 PVCS Version Manager 应用程序服务器,则必须在升级前移除该服务。要执行此操作,请启动 Version Manager I-Net 配置实用工具。默认情况下,通过依次选择“Start”(开始)、“Programs”(程序)、“PVCS Version Manager”、“PVCS VM I-Net”、“PVCS VM I-Net Configuration Utility”(PVCS VM I-Net 配置实用工具)运行 Version Manager I-Net 配置实用工具。单击 Remove NT Service(移除 NT 服务)按钮。

10.2 Apache Web 服务器和动态共享对象 (DSO) 支持

要运行 Version Manager Web 或 Version Manager WebDAV 服务器,Apache Web 服务器必须包含动态共享对象 (DSO) 支持。要确认 Web 服务器是否包含 DSO 支持,请参阅“Web 客户端”部分的主题

10.3 将 Microsoft Office 用于 Version Manager WebDAV 服务器

默认情况下,Version Manager WebDAV 服务器经配置可以与 Serena ChangeMan Meritage 客户端一起使用。Meritage 是 Office 的一个扩展功能,该功能使您可以从 Word、Excel 或 PowerPoint 内部使用 Version Manager 功能(如签入和签出)。如果不希望使用 Meritage,而是希望使用 Office 作为 WebDAV 客户端,则需要通过对 VM_Install_Dir/mv/common/tomcat/webapps/SampleDB.dav/WEB-INF/classes/webdav.properites 中的以下行进行注释来配置 WebDAV 服务器。

Dav.NoLockAgent.Microsoft-Office=Microsoft Data Access Internet Publishing Provider DAV

重要说明:必须重新启动 Tomcat 和任何已配置的 Web 服务器以使此更改生效。

有关 Meritage 和 Version Manager WebDAV 服务器的更多信息,请参阅用户和安装指南。

第 5 部分:版权/声明/支持信息

返回目录


11.0 支持

11.1 支持信息

要联系 Serena 技术支持,请登录 support.serena.com

返回目录


12.0 有关第三方软件的声明

12.1 第三方软件免责声明

以 Version Manager Web 服务器、Version Manager 文件服务器和 WebDAV 服务器所使用的以及随其分发的第三方组件的名义,特此提供以下免责声明。有关任何第三方组件的致谢信息,请参阅 Serena ChangeMan Version Manager 文档;有关这些组件的其他信息,请参阅单独的 LICENSE 文件。

JAVA RUNTIME ENGINE, TOMCAT AND XERCES JAVA PARSER(本软件)按“原样”提供,不承诺任何明示或暗示的担保,包括但不限于某种特殊目的的适销性和适用性的暗示性担保。在任何情况下,SUN MICROSYSTEMS 或 APACHE SOFTWARE FOUNDATION 及其纳税人均不对由于以任何方式使用本软件所引起的直接的、间接的、偶然的、特殊的、惩罚性的或后果性损害(包括但不限于获得替代品或服务;无法使用、丢失数据、损失利润或业务中断),无论此类损害是如何造成的,基于何种责任推断,是否属于合同范畴、严格赔偿责任或侵权行为(包括疏忽或其他原因)承担任何责任,即使被告知发生此类损害的可能性。

 

返回目录


自述文件结束
版权所有 © 2003–2005 Serena Software, Inc. 保留所有权利。

$Revision: 1.0 $