管理本地缓存电子仓库
可以指定站点中的一个电子仓库作为文件服务器站点的本地缓存电子仓库。
要启用电子仓库中的本地缓存功能,请在文件服务器站点中创建或更新电子仓库时,从“电子仓库类型”列表中选择“缓存电子仓库”电子仓库类型。
在本地缓存电子仓库中建立镜像
当在保存有本地缓存电子仓库的文件服务器站点上定义用以关联主机和文件夹的安装内容时,您可以创建一个备份以保护数据免受损失。通过在同一条目中指定文件夹的安装路径和备份存储位置,可以将每个可写本地缓存电子仓库文件夹与其镜像备份存储位置联系起来。如果数据在可读文件夹中丢失,可将备份储存位置中的数据复制到可读文件夹。
要配置备份:
1. 在“电子仓库配置”窗口中,选择可读文件夹,然后选择 > 。
2. 在“根路径”字段中,按以下格式输入用分号分开的两个路径:
<正常情况下要从中读取或写入的文件夹路径>;<该内容的镜像文件夹路径>
3. 复制文件服务器站点中所有主机上的安装内容,并提供到同一物理文件夹的路径。
4. 在“电子仓库配置”窗口中选择可读文件夹,选择 > 。选择“已启用”复选框,然后单击“确定”。
设置首选的内容缓存站点
为了最大限度地利用本章介绍的技术,用户必须将其内容缓存站点首选项设置为包含本地缓存电子仓库的文件服务器站点。因为这是一个易于更改的个人设定的首选项,所以考虑向用户说明一下本地缓存电子仓库的好处和位置。Windchill 解决方案的在线帮助提供了关于访问和设置用户首选项的详细信息。
从本地缓存到主要站点的内容复制
默认情况下,通过每 3 小时运行一次自动同步进程,会将内容从本地缓存电子仓库复制到主要电子仓库。也可手动执行 sysForceSync 操作。要更改自动同步进程的频率或执行 sysForceSync 操作,请使用 JConsole。也可使用 JConsole 查看有关完成的同步进程的信息,包括完成时间、运行数量、移动项目的数量和因出错而不能移动项目的数量。
从文件服务器站点上缓存电子仓库中移除未参考文件
非参考文件是与 Windchill 对象不再具有有效关联的内容文件。例如,当与某个文件关联的所有对象都已删除,或用户在更新对象时删除了文件与对象之间的关联时,该文件将不再被参考。
下列步骤描述了从文件服务器站点上的缓存电子仓库中移除 Windchill 中不再引用的文件的过程。此过程也会移除对通过上载到副本缓存而上载到文件服务器站点的复制内容的引用。该过程不适用于电子仓库的任何现有复制规则。如果上载到复制缓存的任何内容必须永久地存在于文件服务器站点上 (例如为了更快地下载的目的),则必须给这些对象创建复制规则。
从缓存电子仓库中移除未引用的文件
要从缓存电子仓库中移除未引用的文件:
1. 将 wt.fv.purgeUnreferencedFilesOlderThan 特性的值设置为 60。(该值代表天数。)
2. 在“电子仓库配置”窗口中,选择要移除非参考文件的目标电子仓库,并选择 > 。
将显示一个窗口,警告您将从系统中永久移除文件。
3. 也可选择“移动而不删除文件”复选框,将文件移动到备份位置而非仅仅删除这些文件。建议选择此复选框。
4. 单击“确定”。
如果选择“移动而不删除文件”复选框,系统会将备份文件存储在名称包含 .unreferenced 的电子仓库安装位置下的文件夹中。
重置复制
在重置复制之前,必须通过在“电子仓库配置”窗口中选择 > 来移除非参考文件。否则,会由于试图复制已经存在于电子仓库文件夹中的文件而导致复制操作失败。
要移除目标站点的所有先前复制内容,请在“电子仓库配置”窗口中选择 > 。当这样操作时,在执行下一个已安排复制操作过程中,将复制所有为其定义了复制规则的内容。文件服务器站点可能仍包含已上载到其缓存的内容,并且不会移除这类内容的引用。在站点被安排取消注册之前,如果要使用此选项必须慎之又慎。
重置未传送的复制项
当复制完成时,会有消息显示传送完成。该消息表示主要站点已成功向文件服务器站点发送消息,但这并不保证在文件服务器站点上已成功执行复制。
如果显示“未能复制”消息,请在“电子仓库配置”窗口上选择目标电子仓库,接着选择“重置未传送的同步复制项”,然后再次安排复制。
选择“重置未传送的同步复制项”将移除对先前未正确复制的内容的引用。这些引用在复制工作执行的 2 天之后自动删除,但是使用此选项可以尽快再次复制失败的内容。
预测复制
预测复制是一种能够使 Windchill 基于用户行为模式提前确定文件服务器站点中所需内容的功能。在用户或管理员没有设置显式复制排程情况下,预测复制会复制对象的将来小版本。您可使用 wt.fv.predictiveReplicationEnabled 特性启用或禁用此功能。默认情况下,特性设置为 true,表示启用预测复制。
发生下列情况会自动设置预测复制排程:
• 用户已将站点首选项设置为文件服务器,但用户请求的内容还没有通过已安排的复制来复制到首选站点。在这种情况下,这些内容会进行动态复制,并设置预测复制安排。
• 用户将内容上载到首选站点。
创建新规则
系统为预测复制创建特殊规则,然后复制应用该特殊规则的对象。对于用户而言,这些规则处于隐藏状态。
当创建此特殊规则后,如果尚未存在针对复制电子仓库的排程,将创建经常性预测复制排程。此预测复制操作每天将在 wt.properties 文件指定的具体时间运行。可对此排程的 scheduleType 进行如下命名:
PREDICTIVE
此安排仅为符合特殊预测复制规则或 scheduleType 的对象执行复制,例如:
PREDICTIVE+SCHEDULED
此排程按照预测复制规则和通常规则来执行复制。
在创建此特殊规则和排程之前,系统决定该电子仓库的排程是否存在。如果排程存在,则系统将决定对象类和电子仓库的复制规则是否已经存在。如果排程和复制规则均已存在,则不创建预测复制规则和排程。
作为预测复制的一部分,会将所有对象复制到指定为缓存的电子仓库。这将依赖于在专用复制特性中设置的值。
清除过期规则
当方法服务器启动时,将自动清除过期的预测复制规则。清除排程默认频率为 1 天,这意味着清除操作每天都会发生。
以下特性决定了预测复制规则是否过期:
wt.fv.predictiveReplicationDuration
此特性决定了预测复制规则运行的持续时间。测量单位为天。默认值为 90 天。
预测复制规则的过期日根据这一规则的创建日和在 wt.fv.predictiveReplicationDuration 特性中设置的持续时间进行确定。如果此特性设置为 90 天并且该规则创建于 90 天前,则系统会认为此规则过期并在清除进程中删除它。
首选项和选项
wt.properties 文件中的以下特性定义了预测复制首选项和选项:
特性
|
说明
|
wt.fv.predictiveReplicationDuration
|
预测复制规则运行的持续时间 (以天为单位)。这是一个“组织级”首选项。默认值为 90 天。
|
wt.fv.predictiveReplicationEnabled
|
决定是启用还是禁用预测复制。默认情况下,此特性设置为 true,表示启用预测复制。要禁用预测复制,需将此特性设置为 false。
如果禁用预测复制后再启用,系统将执行预测复制来复制在此特性设置为 true 后访问的内容的将来小版本。当关闭预测复制时,不会复制访问的内容。
|
wt.fv.predictiveReplicationAllIterations
|
决定是复制所有小版本还是仅复制最新小版本。默认值是 false,表示仅复制最新小版本。要复制所有小版本,请将此特性设置为 true。
|
wt.fv.predictiveReplicationAllVersions
|
确定是复制所有版本还是仅复制当前版本。默认值是 false,表示仅复制当前版本。要复制所有版本,请将此特性设置为 true。
|
wt.fv.predictiveReplicationPeriodicity
|
指定以天为单位的复制发生频率。默认值为 1 天。
|
wt.fv.predictiveReplicationScheduleTime
|
指定如下格式的排程时间:HH:MM:SS。默认值为 00:00:00。
|
专用复制
专用复制是指当远程站点上的内容不可用并且用户已将首选项设置为 Windchill 文件服务器时,将内容从主要站点复制到 Windchill 文件服务器。
如果用户尝试下载本地文件服务器上不存在的数据,则会从具有该数据的最近站点检索内容,同时将该内容复制到本地文件服务器。当下次其他本地用户下载同一文档时,会直接从本地文件服务器检索该文档。
当专用复制发生时,将创建预测复制规则和排程。
您可通过在 wt.properties 文件中设置 wt.fv.master.adhocCaching.flag 特性来控制专用复制。此特性可以取下列值:
• 0 = 禁用专用复制。
• 1 – 仅当用户的首选文件服务器上存在内容的规则时,才启用专用复制。
• 2 = 在所有条件下均启用专用复制。此为默认值。
wt.fv.master.adhocCaching.ThreadPoolSize 特性设置可用于专用复制的同步线程数。此特性的默认值是 3。
|
如果专用复制已配置副本电子仓库,则专用复制也可在主要站点上运行。
|
近似站点
当创建或编辑站点时,以新站点或更新站点的近似程度顺序设置站点列表。在专用复制过程中,系统以站点在列表中显示的顺序检查站点,从而决定从哪个站点检索内容。通过设置近似站点表,可以确保用最接近的站点尽可能快地实现用户请求。默认情况下,如果主要站点尚未按顺序包含在列表中的其他位置,则会将其添加到列表的末尾。
用户启动的复制
用户启动的复制可使用户收集和复制不能通过复制规则而很容易联系在一起的对象。当用户启动复制时,将立即开始复制进程。可以从“搜索结果”表的“操作”菜单上,也可通过对象详细页面信息的行级别“操作”菜单找到复制操作。
当用户选择复制操作时,“用户启动的复制”窗口将会出现。在此窗口上,用户必须标识供复制的目标文件服务器站点,并选取是复制 CAD 文档的所有依存对象、必需依存对象还是不复制任何依存对象。
|
选择要复制的依存对象仅适用于选定的 CAD 文档对象。对于每个目标 CAD 文档,依存对象使用“原存储”配置规范 (如果存在)。如果不存在,则使用最新的配置规范。
|
当用户启动复制操作之后,将发生如下过程:
1. 复制作业在后台启动。在“事件管理”实用程序中报告作业结果 (成功、失败和错误)。
2. 创建预测复制规则和排程,以复制所复制对象的将来小版本。
3. 复制所有复制作业中的对象到属于站点默认目标的电子仓库。
|
每个站点必须拥有一个作为该站点默认目标的电子仓库。如果作为站点默认目标的电子仓库已经存在,而您又选择了一个新电子仓库,则新电子仓库 (而非现有电子仓库) 将成为该站点的默认目标。
|
复制进程
Windchill 能够同时针对位于任何站点上的多个目标副本电子仓库执行并行复制或运行复制会话。位于主要站点上的内容将被复制到目标副本电子仓库中,这是由复制策略规则所决定的。在复制进程中,将该内容从主要站点提取至文件服务器站点,并且存储在分配给目标副本电子仓库的空间中。
复制进程概览
复制作业开始时,系统会完成以下步骤:
1. 系统根据为复制会话定义的复制规则来收集将被移动到文件服务器位置的内容。
2. 文件服务器将复制各内容文件,并将其存储在复制电子仓库位置。
3. 所有文件被成功地复制和存储后,复制作业会被标记为“已成功完成”或者“已完成但存在错误”。如果某项作业被标记为已完成但存在错误,则将意味着有一个或多个收集项无法被复制。
特性控制
要同时运行复制的多个活动会话,请使用 wt.fv.master.Replication.NumOfQueues 特性。此特性定义了用于同时执行复制会话的队列数。默认设置为 1。
在提高并发会话的最大数目时要慎重,因为每个会话都要占用大量资源并使用主要站点上用于内容传送的网络宽带。
当安排较多的复制会话时,它们会在并行队列中排队等待,这样在任何时候活动会话数都会等于或少于队列数。
|
可对队列进行配置以使其在指定的方法服务器上运行。该功能提供了另一种方式的复制活动。
|
删除注册的文件服务器
正常情况下,无法删除一个已注册的文件服务器。仅当已注册文件服务器的缓存电子仓库中的所有缓存对象都已由同步操作提取至主要站点后,才可删除该文件服务器。
此外,如果在上载至缓存电子仓库的文件中有任何失败的上载或部分上载,则无法删除此文件服务器。只有在一个月后,系统才会在清理进程中删除对这些文件的引用。
升级注意事项
您必须设置“站点”容器的容器引用,如下所示:
• 站点对象 - 对于所有预升级站点,将只读标志设置为 false,将启用标志设置为 true。
• 副本电子仓库对象 – 对于所有对象,在升级前为他们的状态设置标志。
将文件服务器移动到另一台机器
使用此过程以在保留电子仓库的同时将文件服务器移动到另一台机器上。
1. 使用一个不同的主机名来安装新的文件服务器。在后安装步骤中,请勿创建新站点。不过,请确保将公用密钥复制到文件服务器上。
2. 通过“文件服务器管理”实用程序使文件服务器处于脱机状态。这可确保文件服务器上不再发生任何下载或上载操作。
3. 将电子仓库文件夹复制到新服务器上。
4. 对每一个与文件服务器相关联的电子仓库,删除每个文件夹中名为 MOUNT_VALIDATION_DATA 的文件夹。
5. 使用“站点管理”实用程序,更新先前文件服务器的站点 URL 以指向新文件服务器的 URL。
6. 使用“电子仓库配置”实用程序更新文件服务器的主机名。
7. 使用“文件服务器管理”实用程序使文件服务器处于联机状态。
8. 通过“电子仓库配置”实用程序,以新路径更新安装路径。
9. 使用“电子仓库配置”实用程序验证所有文件服务器的文件夹安装。
增强文件服务器用户体验
以下功能可在配置及使用文件服务器时对用户体验提供帮助:
• 站点监视器 - 这是一个 daemon 线程,该线程以 Windchill 定义的时间间隔,对所有文件服务器站点执行 ping 操作并在主要站点中保存 ping 状况。以下特性指定了每个副本 ping 之间的时间间隔:
wt.intersvrcom.sitePingIntervalInMinutes
此监视器存在于系统中的每个方法服务器上,且每次 ping 操作的结果都存储在缓存中。方法服务器会在每次尝试对文件服务器站点执行 ping 操作之前检查 ping 结果。如果现有的 ping 是足够新近,则将跳过下一次 ping。
• 自动安装验证 – 该功能类似于“站点监视器”,验证由文件夹、文件或站点进行的安装。该功能可在群集环境下和在文件服务器站点上启用安装验证。
您还可以在“电子仓库配置”窗口中验证安装,方法是从左侧窗格的树中选择一个对象,如站点、电子仓库或文件夹,然后单击“验证”。
|
如果至少有一个尚未创建的安装,将出现一条警告消息。
|
当您通过“电子仓库配置”窗口来验证安装时,系统将执行以下操作:
1. 系统会向文件服务器站点发送安装验证所需的所有数据。
2. 文件服务器站点上的系统会验证与选定对象相关的所有现有安装。
3. 系统会向主要站点发送验证状况。
4. 主要站点上的系统会将与选定对象相关的所有安装的状况均更新为“有效”或“不存在”。
5. 系统会更新与选定对象相关的所有安装的“上次状况更新时间”时间戳。
• 管理隔离的文件 – 您可以标识隔离的文件、将文件从隔离区移除以及管理隔离区通知的频率。
任何 Windchill 视为已损坏的内容均被标记为隔离。隔离的内容是指 Windchill 发现的将要损坏或在某种程度上存在缺陷的内容。这样的内容将无法参与重新存储或复制的过程,直到将其从隔离区移除。
对于被隔离的对象,文件夹必须可访问;但内容不必可访问。这有助于避免隔离尚未安装的文件夹的文件。当进行重新存储或复制进程时,将自动筛选出隔离的对象,而不在进程中包括它们。
专用特性 wt.content.QuarantinedContentManager 可收集关于当前隔离文件的数据并从隔离区移除这些文件的子集。
要为系统中所有的隔离内容生成报告并在一个文件中存储它们,请使用以下命令:
java wt.content.QuarantinedContentManager [-reportAllQuarantined][<文件>]
要从当前位于隔离区的所有内容中移除隔离标志,请使用以下命令:
java wt.content.QuarantinedContentManager [-UnQuarantineAll]
还将创建一个记录每个隔离文件的单独日志。该日志中包括有关每个对象被隔离的原因的详细信息。
Windchill 管理员可以签发隔离内容的电子邮件通知。wt.content.QuarantineNotifyIntervalHours 特性指定一种以小时为单位的时间间隔。预订 JMX 隔离区通知的管理员以此时间间隔接收内容隔离事件的通知。默认值为 24 小时,这表示关于隔离事件的通知最多在每 24 小时时段内发送一次。如果将此特性的值设置为 0,则将为每个隔离事件发送通知。
帮助进行备份的实用程序
您可在主要站点上运行一个实用程序,来区分当前在主要站点和文件服务器站点上复制的文件,与已经检入到文件服务器站点但尚未复制到主要站点的文件。该实用程序专门用于指导备份进程。从命令行调用该实用程序的语法如下:
windchill -cp <path_to_codebase>
wt.fv.uploadtocache.CCS_BackupFilesList
该实用程序在日志目录中输出一个 ASCII 文件,其中列出了位于文件服务器站点、但不位于主要站点上的文件。文件按站点和每一个站点内的文件夹列出。该输出文件的名称使用以下语法:
ccs_backup_<时间戳>.log