版本控制参数

以下参数适用于版本控制：

[component-name ]
指定版本控制下的项目的名称。名称必须是唯一的，并用方括号括起。 component-name 不区分大小写。需要此参数来开始组件定义。
version="x.x. yyymmd"
指定版本编号 (x.x) 以及定义组件版本的日期 (yyyymmdd)。此参数是必需的，且必须用双引号引起。版本控制通过比较服务器上的版本号和日期与客户端上的版本号和日期来验证组件的版本。两者的版本号和日期必须一致才能将组件视为在客户端和服务器上同步。如果启用了校验和特性，则可以根据需要在更新文件前通过校验和对文件进行验证。
control-type
指定此组件的版本控制类型。以下设置对于 control-type 有效：

设置		描述

dir_ctl	指定组件表示目录。您必须提供目录参数以指定目录的路径。您还可以提供文件名参数，从而为目录中的文件指定掩码并在需要升级时进行升级。子目录不会在 UNIX 或 Windows 上升级。
file_ctl		指定组件表示文件。您必须提供目录和文件名参数以指定文件路径。
Nxenv_ctl		指定此组件表示用于存储内部 CA Service Desk Manager 环境变量的 client_nx.env 文件。 CA Service Desk Manager 版本控制和选项管理器会自动维护该文件。有一个 nxenv_ctl 组件，其组件名称必须是 CLIENT_NXENV。
ver_ctl		这是默认的控件类型。它指定组件是通用的；也就是说，不与任何特定外部对象相关。您可以使用通用组件为整体客户端或对于自动升级过大的文件或目录提供版本控制。控制类型为 ver_ctl 的组件不能进行升级；当服务器处在升级模式时，如果版本不匹配 ver_ctl 组件，则会导致客户端连接失败。

filename="filename"
指定版本控制下的文件的名称。它不包含目录规格。 file_ctl 组件必需此函数，但对于目录 (dir_ctl) 控制组件却是可选的。当用于目录组件时，文件名参数将起文件掩码的作用，用来限制与 dir_ctl 组件相关的文件。例如，如果 dir_ctl 组件的文件名是 *.README，那么来自该目录的升级将仅包含以“.README.”结尾的文件。
directory="directory"
指定 dir_ctl 组件目录的路径，或指定包含 file_ctl 组件文件的目录的路径。对于 ver_ctl 和 nxenv_ctl 组件，此参数被忽略。目录路径必须用引号引起，并应包含对前置 $ 的环境变量的引用。

注意：始终使用正斜杠（而不是反斜杠）分隔路径名中的子目录，即使在 Windows 服务器上也是如此。

link="link-directory"
以跟上述目录参数相同的格式在客户端上指定链接目录。此参数对于 file_ctl 和 dir_ctl 组件可选，而对于 ver_ctl 和 nxenv_ctl 组件则可被忽略。如果已指定，则对 Linux 客户端的升级会使符号链接连上链接目录，指向已复制到由目录参数指定位置的实际文件。对 Windows 客户端的升级会使实际文件同时被复制到链接和目录位置。
source="source-directory"
（可选）指定服务器上的不同目录，服务器可以在此检索要交付的文件。此参数的格式与上述目录参数格式相同。如果要交付到客户端的文件与服务器上该目录位置下的对应文件不同，该参数将十分有用。此参数用于通知服务器从 source-directory 检索文件并将其交付给客户端上由目录参数指定的位置。在指定源参数时需要目录参数。
effectivity="effect-spec"
（可选）指定客户端是否应获取此组件。它允许您避免将组件下载到某些客户端。如果客户端不包括在有效规格中，则不会获得该组件。如果忽略此参数，所有客户端均会收到组件。有效规格使用下列符号：
- +（加号）
  表示要添加客户端组。
- -（减号）
  表示要排除客户端组。

以下客户端组有效：

例如，下列规格表示只有 UNIX 客户端获得文件：

effectivity = "+ UNIX_CLIENTS"

checksum
客户端上组件的校验和与服务器上相应的校验和不一致时，指向要升级的组件。如果将其应用到目录，则校验和将应用到每个文件。
min_release=“release” 和 max_release="release"
指定应向其分发此组件的最旧和最新的客户端。 Server_default.ver 文件中的语句定义了版本。这些参数具有以下形式，其中 Gaxx 指明版本，而其后的值是与版本相关的 genlevel。
```
! Release GA50 50MVV000900 50W7T000900
! Release GA45 45MW000900 50WTT000900
```
此顺序表示 GA50 较 GA45 新。
[component-name ]
指定版本控制下的项目的名称。名称必须是唯一的，并用方括号括起。 component-name 不区分大小写。需要此参数来开始组件定义。

设置	描述
文件	这是默认的组件类型。它指定了复制到客户端的文件可从由目录参数指示的服务器位置直接获取。
exe_file	指定了复制到客户端的文件可服务器上的位置获取，具体取决于客户端的操作系统，如下所示： windows (Windows) sun4Sol (Solaris) hp (HP-UX) aix—(AIX) linux (Linux) linux390 (Linux390) 这些子目录的位置取决于目录参数设置。如果此参数已设置，则子目录将位于指示的目录下。否则，它们将位于主 CA Service Desk Manager 安装目录的 bin 目录下。

设置

描述

文件

这是默认的组件类型。它指定了复制到客户端的文件可从由目录参数指示的服务器位置直接获取。

exe_file

指定了复制到客户端的文件可服务器上的位置获取，具体取决于客户端的操作系统，如下所示：

这些子目录的位置取决于目录参数设置。如果此参数已设置，则子目录将位于指示的目录下。否则，它们将位于主 CA Service Desk Manager 安装目录的 bin 目录下。

o_mode="owner-mode"
为文件所有者指定文件访问权限。
g_mode="group-mode"
为文件所有者组中的用户指定文件访问权限（仅适用于 UNIX 客户端）。
w_mode="world-mode"
为不在文件所有者组中的用户指定文件访问权限（仅适用于 UNIX 客户端）。

三种模式的参数均允许在服务器上维护相同可执行文件的不同版本。它们在复制到客户端时指定对文件的访问控制。这些参数仅在升级操作时使用。它们包含具有下列重要程度的一到三个字符：

PC 客户端忽略“写”和“执行”权限。

您可以指定一个或多个文件访问模式的任意组合。在 UNIX 客户端上，文件被设置为指定的访问模式。在 PC 客户端上，文件被设置为可写或只读，这取决于是否指定了 w_mode。