DIVAnet 是分布式应用程序,这表示它通常安装在多个系统上。请参阅第 2 章,了解 DIVAnet 应当安装在哪些系统和服务器上,以及应当安装哪些特定的 DIVAnet 服务。
每个与 DIVAnet 相连的 DIVArchive 站点都必须运行 DIVArchive 7.3.1 或更高版本。
DIVAnet 可以安装在 64 位 Windows 平台上,可以安装在 DIVArchive 所在的同一主目录中,也可以安装在单独的目录中。
运行 DIVAnet 安装程序需要管理员权限。
默认情况下,DIVAnet 安装程序处理 DIVAnet 服务文件、DIVAnetUI 和兼容 64 位 Java 8 Java Runtime Environment (JRE) 的安装。DIVAnet 使用所安装的 JRE 进行执行。安装 DIVAnet 数据库需要在 DIVAnet Windows 系统上直接安装 Oracle Database 11g 发行版 2 或更高版本,以及 Oracle SQLPlus(Oracle 11 或更高版本的客户机软件)。
如果要重新安装 DIVAnet,请确保 DIVAnet 组件未在运行。
启动 DIVAnet 安装程序的可执行文件 DIVAnet_V2.0.version.exe
。
选择所需的组件,然后单击 Next。
选择 Java(如果以前没有安装在目标目录中)。
如果只希望安装 DIVAnet 用户界面,则取消选择 DIVAnet Services。
指定目标安装目录。这将是 DIVAnet 主目录。然后单击 Install。
注:
可以使用 DIVArchive 安装目录作为 DIVAnet 主目录。但是,Oracle 建议将 DIVAnet 安装在单独的目录中。以下各节描述为了完成安装而可能需要执行的额外步骤。有关更多信息,请参见第 2 章。
要创建 DIVAnet 数据库,首先创建 DIVAnet 表,然后配置 DIVArchive 站点。
此步骤涉及到创建将在运行中的 Oracle 服务器上存在的 DIVAnet 数据库表。只有 DIVAnet 完全安装才需要此步骤(请参见第 2 章)。
要运行 SQL 创建脚本,必须将 SQLPlus(Oracle 11 客户机软件)安装到要在其上安装 DIVAnet 的系统上。
打开命令行窗口。将目录切换到 DIVAnet 主目录(装有 DIVAnet 的目录)。
将目录切换到 Program\Database\divanet\Install
。
运行以下命令:
create_divanet_user.bat syspassword username userpassword oracle_tns_name
在上一个命令中,syspassword 是 Oracle 系统密码,username 是将包含 DIVAnet 表的 Oracle 用户名/方案名,oracle_tns_name 是要用于安装的 DIVAnet 数据库的 Oracle TNS 名称。如果没有为该数据库定义 TNS 名称,则可以参阅下一节来实时创建 TNS 名称。
要删除 DIVAnet 数据库方案,请执行以下步骤。
注意:
这将删除 DIVAnet 数据库中的所有数据。将目录切换到 Program\Database\divanet\Install
。
运行以下命令:
delete_divanet_user.bat syspassword username oracle_tns_name
在上一个命令中,syspassword 是 Oracle 系统密码,username 是将包含 DIVAnet 表的 Oracle 用户名/方案名,oracle_tns_name 是要用于安装的 DIVAnet 数据库的 Oracle TNS 名称。如果没有为该数据库定义 TNS 名称,请参阅下一节来创建要用于添加和删除脚本的 Oracle 连接字符串。
在创建 DIVAnet 表之后,必须在 DIVAnet 数据库中配置 DIVA 站点。运行 addSites.bat
脚本以按如下方式在数据库中配置站点:
切换到 DIVAnet 主目录,然后导航到 Program\divanet\bin
子文件夹。
运行 addSites.bat
脚本。此脚本将引导您添加站点名称记录并配置站点名称、位置和注释。指向站点的网络连接是在 ClientAdapter 配置文件中配置的(请参见第 4 章)。应该创建易于读取且反映站点物理位置或功能的站点名称。
注:
在配置本地和远程 DIVAnet 服务时,将使用在该步骤中提供的站点名称。在运行 addSites 脚本之前,确保所需的站点名称已经达成一致。如果您在运行addSites.bat
命令时犯了一个错误,则 Oracle 会建议您重新创建数据库或与 Oracle 支持人员联系。当站点名称位于数据库中之后,DIVAnet 安装可以继续。请参阅第 2 章来确定需要配置哪些 DIVAnet 服务,然后参阅第 4 章以了解有关如何配置每个服务的详细信息。
在 DIVAnet 主目录下面的 Program\conf\divanet\templates
子目录中,对于需要配置的每个 DIVAnet 服务都有模板配置文件。每个模板文件都具有 .ini
扩展名。您应当提取每个文件并将它复制到父目录(在本例中为 Program\conf\divanet
)。在复制每个文件时,确保删除 .ini
扩展名。
在每个 .ini
文件的顶部都记录了可用参数。对于每个 DIVAnet 站点,配置 ManagerAdapterConfig.xml
。对于 DIVAnet 完全安装,还配置 ClientAdapterConfig.xml
和 DBSyncConfig.xml
文件。
许多参数可以保持其默认值。您不必更改 Program\conf\divanet\wrapper
文件夹中的任何配置文件。您可以选择向 divaEnv.conf
文件中添加信息(有关更多信息,请参见将脚本变量添加到配置文件)。
注:
如果您不熟悉应当将哪些参数修改为非默认值,请与 Oracle 支持人员联系。请参见第 2 章以确定需要安装和配置哪些服务。
在正确设置了配置文件之后,安装和启动 DIVAnet 服务。针对要在每个 DIVAnet 站点安装的每个服务执行每个步骤。
切换到 DIVAnet 主目录(装有 DIVAnet 的目录)。
导航到 Program\divanet\bin
文件夹。
运行 InstallDivanetService.bat
脚本,为正要安装的服务提供包装器配置文件。例如,要安装 ManagerAdapter 服务(在运行要连接到 DIVAnet 的管理器的所有站点上均需要此服务),请运行以下命令:
InstallDivanetService.bat ../../conf/divanet/wrapper/ManagerAdapterWrapper.conf
对于 ClientAdapter 服务,请使用相同的命令和路径,但将 ClientAdapterWrapper.conf
作为文件名进行替换。
对于 DbSync 服务,使用文件名 DBSyncWrapper.conf
。
在 Windows 的“服务”窗口中,应当会看到下面的一个或多个 DIVAnet 服务:
Divanet ManagerAdapter
Divanet ClientAdapter
Divanet DbSync
这些服务可以按照任意顺序启动,但是请记住,在 DbSync 服务和 ManagerAdapter 服务都启动之后,数据库同步过程将自动启动。启动 ClientAdapter 服务以允许建立新的 DIVAnet 连接和进行新的 API 处理。
DIVAnet 应用程序提供两种主要类型的日志:
跟踪日志-位于 DIVAnet 主目录内的 Program\log\divanet
子文件夹中。每个 DIVAnet 服务(ManagerAdapter、DbSync 和 ClientAdapter)都在 Program\log\divanet
文件夹下面创建其各自的一个子文件夹,并在该子目录中生成其日志文件。
包装器服务日志-首先检查这些日志以确保应用程序正在以正确方式启动。这些日志位于 DIVAnet 主目录内的 Program\log\divanet
子文件夹中。其命名类似于 Wrapper.conf
文件,但是具有 .log
文件扩展名(例如:ManagerAdapterWrapper.log
)。
配置 DIVAnet 时的最常见错误是在指定站点名称时出现的错误。DIVAnet 网络中的所有 DIVA 站点都必须使用同一组站点名称。站点名称必须在所有配置文件中和 DIVAnet 数据库中保持一致。必须在所有的服务配置文件中正确配置 LocalSitename 参数。
您还应当检查 DIVArchive Source/Destination。例如,默认情况下,如果站点 diva1 有一个 Source/Destination 与站点 diva2 上的 "Source/Destination" 同名,则 DIVAnet 会将它们视为指向相同的逻辑 Source/Destination。如果在两个不同的 DIVArchive 站点上配置了相同的 Source/Destination 名称,DIVAnet 将假定这些 Source/Destination 指向同一个位置。
在 DbSync 服务启动之后,它将尝试通过求助于 ManagerAdapter 服务来同步已归档的对象信息。ManagerAdapter 服务反过来会从它所连接到的 DIVArchive 站点拉取资产信息。因此,只有当您准备开始同步时,才应当启动 DbSync 服务和 ManagerAdapter 服务。
注:
如果您停止 DbSync 服务,则在该服务重新启动之后,将自动从上次停止同步的位置再次同步。DivanetAdmin 命令行工具逐一监视每个站点上的数据库同步状态。如果 DIVAnet 正在执行特定站点的初始同步,它将显示这个初始同步操作的完成百分比。如果站点是最新的,DivanetAdmin 将指示该站点是同步的。
DivanetAdmin 还可以用来重新同步站点。这会涉及到删除以前从该站点同步的所有已归档对象记录,以及从源重新同步这些记录。只有在极少情况(例如,从过时的数据库备份中意外恢复源 DIVA 数据库时)下才应当使用重新同步。