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.xml 和 DBSyncConfig.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 数据库时）下才应当使用重新同步。