3 安装 DIVAnet

在安装之前

  • 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

  1. 启动 DIVAnet 安装程序的可执行文件 DIVAnet_V2.0.version.exe

  2. 选择所需的组件,然后单击 Next

    • 选择 Java(如果以前没有安装在目标目录中)。

    • 如果只希望安装 DIVAnet 用户界面,则取消选择 DIVAnet Services

  3. 指定目标安装目录。这将是 DIVAnet 主目录。然后单击 Install

    注:

    可以使用 DIVArchive 安装目录作为 DIVAnet 主目录。但是,Oracle 建议将 DIVAnet 安装在单独的目录中。

以下各节描述为了完成安装而可能需要执行的额外步骤。有关更多信息,请参见第 2 章

创建 DIVAnet 数据库

要创建 DIVAnet 数据库,首先创建 DIVAnet 表,然后配置 DIVArchive 站点。

创建表

此步骤涉及到创建将在运行中的 Oracle 服务器上存在的 DIVAnet 数据库表。只有 DIVAnet 完全安装才需要此步骤(请参见第 2 章)。

创建 DIVAnet 数据库方案

要运行 SQL 创建脚本,必须将 SQLPlus(Oracle 11 客户机软件)安装到要在其上安装 DIVAnet 的系统上。

  1. 打开命令行窗口。将目录切换到 DIVAnet 主目录(装有 DIVAnet 的目录)。

  2. 将目录切换到 Program\Database\divanet\Install

  3. 运行以下命令:

    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 数据库方案,请执行以下步骤。

注意:

这将删除 DIVAnet 数据库中的所有数据。
  1. 将目录切换到 Program\Database\divanet\Install

  2. 运行以下命令:

    delete_divanet_user.bat syspassword username oracle_tns_name
    

    在上一个命令中,syspassword 是 Oracle 系统密码,username 是将包含 DIVAnet 表的 Oracle 用户名/方案名,oracle_tns_name 是要用于安装的 DIVAnet 数据库的 Oracle TNS 名称。如果没有为该数据库定义 TNS 名称,请参阅下一节来创建要用于添加和删除脚本的 Oracle 连接字符串。

Oracle 连接字符串

如果您没有为数据库定义 TNS 名称,则可以提供 Oracle 连接字符串。此字符串的格式如下所示:

netaddress:port/remote_servicename

其中:

  • netaddress:运行数据库的网络地址

  • port:客户机可以连接的端口

  • remote_servicename:Oracle 远程服务的名称。这不同于在本地使用的服务名称。DIVA Oracle 数据库安装包的默认 Oracle 远程服务名称为 lib5.world。完整连接字符串的示例:183.34.34.67:1521/lib5.world

添加站点

在创建 DIVAnet 表之后,必须在 DIVAnet 数据库中配置 DIVA 站点。运行 addSites.bat 脚本以按如下方式在数据库中配置站点:

  1. 切换到 DIVAnet 主目录,然后导航到 Program\divanet\bin 子文件夹。

  2. 运行 addSites.bat 脚本。此脚本将引导您添加站点名称记录并配置站点名称、位置和注释。指向站点的网络连接是在 ClientAdapter 配置文件中配置的(请参见第 4 章)。应该创建易于读取且反映站点物理位置或功能的站点名称。

    注:

    在配置本地和远程 DIVAnet 服务时,将使用在该步骤中提供的站点名称。在运行 addSites 脚本之前,确保所需的站点名称已经达成一致。如果您在运行 addSites.bat 命令时犯了一个错误,则 Oracle 会建议您重新创建数据库或与 Oracle 支持人员联系。当站点名称位于数据库中之后,DIVAnet 安装可以继续。

配置 DIVAnet 配置文件

请参阅第 2 章来确定需要配置哪些 DIVAnet 服务,然后参阅第 4 章以了解有关如何配置每个服务的详细信息。

在 DIVAnet 主目录下面的 Program\conf\divanet\templates 子目录中,对于需要配置的每个 DIVAnet 服务都有模板配置文件。每个模板文件都具有 .ini 扩展名。您应当提取每个文件并将它复制到父目录(在本例中为 Program\conf\divanet)。在复制每个文件时,确保删除 .ini 扩展名。

在每个 .ini 文件的顶部都记录了可用参数。对于每个 DIVAnet 站点,配置 ManagerAdapterConfig.xml。对于 DIVAnet 完全安装,还配置 ClientAdapterConfig.xmlDBSyncConfig.xml 文件。

许多参数可以保持其默认值。您不必更改 Program\conf\divanet\wrapper 文件夹中的任何配置文件。您可以选择向 divaEnv.conf 文件中添加信息(有关更多信息,请参见将脚本变量添加到配置文件)。

注:

如果您不熟悉应当将哪些参数修改为非默认值,请与 Oracle 支持人员联系。

安装和启动 DIVAnet 服务

请参见第 2 章以确定需要安装和配置哪些服务。

在正确设置了配置文件之后,安装和启动 DIVAnet 服务。针对要在每个 DIVAnet 站点安装的每个服务执行每个步骤。

  1. 切换到 DIVAnet 主目录(装有 DIVAnet 的目录)。

  2. 导航到 Program\divanet\bin 文件夹。

  3. 运行 InstallDivanetService.bat 脚本,为正要安装的服务提供包装器配置文件。例如,要安装 ManagerAdapter 服务(在运行要连接到 DIVAnet 的管理器的所有站点上均需要此服务),请运行以下命令:

    InstallDivanetService.bat ../../conf/divanet/wrapper/ManagerAdapterWrapper.conf
    
    • 对于 ClientAdapter 服务,请使用相同的命令和路径,但将 ClientAdapterWrapper.conf 作为文件名进行替换。

    • 对于 DbSync 服务,使用文件名 DBSyncWrapper.conf

  4. 在 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 指向同一个位置。

同步 DIVAnet 数据库

在 DbSync 服务启动之后,它将尝试通过求助于 ManagerAdapter 服务来同步已归档的对象信息。ManagerAdapter 服务反过来会从它所连接到的 DIVArchive 站点拉取资产信息。因此,只有当您准备开始同步时,才应当启动 DbSync 服务和 ManagerAdapter 服务。

注:

如果您停止 DbSync 服务,则在该服务重新启动之后,将自动从上次停止同步的位置再次同步。

DivanetAdmin 命令行工具逐一监视每个站点上的数据库同步状态。如果 DIVAnet 正在执行特定站点的初始同步,它将显示这个初始同步操作的完成百分比。如果站点是最新的,DivanetAdmin 将指示该站点是同步的

DivanetAdmin 还可以用来重新同步站点。这会涉及到删除以前从该站点同步的所有已归档对象记录,以及从源重新同步这些记录。只有在极少情况(例如,从过时的数据库备份中意外恢复源 DIVA 数据库时)下才应当使用重新同步。