3 安装 DIVAnet

在安装之前

  • DIVAnet 是分布式应用程序,这表示它通常安装在多个系统上。请参阅第 2 章,了解 DIVAnet 应当安装在哪些系统和服务器上,以及应当安装哪些特定的 DIVAnet 服务。

  • 每个与 DIVAnet 相连的 DIVArchive 站点都必须运行 DIVArchive 7.3.1 或更高版本。

  • DIVAnet 可以安装在 64 位 Windows 平台上,也可以安装在 64 位 Oracle Linux 平台上(发行版 7 或更高版本)。DIVAnet 可以与 DIVArchive 安装在同一主目录中,也可以安装在自己的目录中。

  • 在 Windows 计算机上,DIVAnet 安装程序需要管理员权限。在 Linux 计算机上,DIVAnet 安装程序需要使用名为 diva 的用户。

  • 默认情况下,DIVAnet 安装程序处理 DIVAnet 服务文件、DIVAnetUI 和兼容 64 位 Java 8 Java Runtime Environment (JRE) 的安装。DIVAnet 使用所安装的 JRE 执行操作。安装 DIVAnet 数据库需要 DIVAnet 系统上直接安装了 Oracle Database 11g 发行版 2 或更高版本以及 Oracle SQLPlus(Oracle 11 或更高版本的客户机软件)。

  • 如果要重新安装 DIVAnet,请确保 DIVAnet 组件未在运行。

安装 DIVAnet 软件

DIVAnet 可以安装在 Windows 或 Oracle Linux 7 操作系统上。以下几小节介绍了每个平台的安装过程。

DIVAnet Windows 安装

使用以下过程在 Windows 环境中安装 DIVAnet:

  1. 使用具有管理员权限的帐户启动 DIVAnet 安装程序可执行文件 DIVAnet_V2.1.version.exe

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

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

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

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

    注:

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

Oracle Linux DIVAnet 安装

如果在 Linux 上运行,则必须创建一个名为 diva 的用户和一个名为 divanetsvc 的用户。divanetsvc 用户必须有权写入、读取和执行 diva 拥有的文件。diva 用户必须对 Linux systemctl 命令具有 sudo 权限。必须以 diva 用户、admin 用户或 root 用户身份来运行安装。必须在安装软件前创建 diva 用户。安装程序中提供了一个在安装前创建 divadivanetsvc 用户的选项。

使用以下过程在 Linux 环境中安装 DIVAnet:

  1. 打开一个终端会话并导航到 DIVAnet 发行版的父目录。

  2. 将 DIVAnet 安装软件包(例如 DIVAnet-2.1-RELEASE.sh)放在该目录中。安装程序可以将 DIVAnet 安装在此父目录的子目录中。

  3. 使用以下命令启动 DIVAnet 安装:

    sh ./DIVAnet-2.1-RELEASE.sh

  4. 安装程序提供了一个在安装此软件前创建 Linux 先决条件用户 divadivanetsvc 的选项。在创建这些用户并分配正确的权限后,选择安装 DIVAnet 软件的选项。

  5. 系统将提示您指定要安装 DIVAnet 的子目录名称。按 Enter 键将使用名为 DIVAnet 的默认子目录,您也可以指定一个定制子目录名称并按 Enter 键来创建安装目录。

    DIVAnet 安装过程随后开始,并且所有文件和文件夹都将提取到指定的目标目录中。

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

创建 DIVAnet 数据库

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

创建表

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

创建 DIVAnet 数据库方案

要运行 SQL 创建脚本,必须将 SQLPlus(Oracle 11g 或更高版本的客户机软件)安装到要安装 DIVAnet 的系统上。确保 sqlplus 实用程序的路径位于系统的 PATH 环境变量中。

  1. 打开一个命令行窗口或终端 shell。将目录切换到 DIVAnet 主目录(安装了 DIVAnet 的目录)。

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

  3. 运行以下命令:

    Windows:

    create_divanet_user.bat {syspassword} {username} {userpassword} {oracle_tns_name}

    Linux:

    create_divanet_user.sh {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. 运行以下命令:

    Windows:

    delete_divanet_user.bat syspassword username oracle_conn_string
    

    Linux:

    delete_divanet_user.sh syspassword username oracle_conn_string
    

    在上一个命令中,syspassword 是 Oracle 系统密码,username 是将包含 DIVAnet 表的 Oracle 用户名或方案名称,oracle_conn_string 是要使用的 DIVAnet 数据库的 Oracle TNS 名称,或者是 Oracle 连接字符串(参见下文)。如果没有为该数据库定义 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 脚本,按如下方式在数据库中配置站点:

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

  2. 运行 addSites 脚本:

    Windows:addSites.bat

    Linux:addSites.sh

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

    注:

    在配置本地和远程 DIVAnet 服务时,要使用在该步骤中提供的站点名称。在运行 addSites 脚本之前,确保已经对所需的站点名称达成一致。如果您在运行命令时犯了错误,可以从 addSites 脚本内以逻辑方式删除站点。当站点名称添加到数据库中之后,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 站点安装的每个服务执行每个步骤。

安装 DIVAnet Windows 服务

使用以下过程在 Windows 环境中安装 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 Linux 服务

使用以下过程在 Linux 环境中安装 DIVAnet 服务:

  1. 打开一个终端会话并导航到 Program/divanet/bin 目录。

  2. 运行 divanetservice 脚本来安装所需的服务(DbSync、ClientAdapter 或 ManagerAdapter)。例如,要安装 ClientAdapter,请输入以下命令:

    ./divanetservice install ClientAdapter

管理 DIVAnet Linux 服务

在创建 Linux DIVAnet 服务后,可使用以下命令来管理这些服务:

表 3-1 Linux DIVAnet 服务

操作
命令

列出所有服务

./divanetservice list

启动服务

./divanetservice start service_name

停止服务

./divanetservice stop service_name

重新启动服务

./divanetservice restart service_name

安装服务

./divanetservice install service_name

卸载服务

./divanetservice uninstall service_name


service_name 参数可以是 DbSyncClientAdapterManagerAdapter。还可以使用标准 Linux 系统 V systemctl 命令语法来管理 DIVAnet 服务。要了解有关 systemctl 命令的更多信息,可以在 Linux 命令提示符下输入 man systemctl

查看日志

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 数据库),才需要使用重新同步。

升级 DIVAnet

在升级到新版本的 DIVAnet 之前,建议您备份现有的 DIVAnet 主目录。在升级之前,您还必须停止服务器上任何正在运行的 DIVAnet 服务或程序。使用以下过程升级 DIVAnet 软件:

  1. 按照安装 DIVAnet 软件一节中的说明进行操作。这会将最新的 DIVAnet 软件安装到 DIVAnet 主目录中。

  2. 如果是升级包含 DIVAnet 数据库的系统,必须运行 DIVAnet 数据库升级实用程序。要运行该实用程序,请将目录切换到 Program/divanet/bin 并运行以下命令:

    Windows:upgradeDB.bat

    Linux:./upgradeDB.sh

    该脚本将提示您输入有关 DIVAnet 数据库的信息(包括数据库用户名和数据库所在的网络地址)。该实用程序将添加或修改必需的数据库对象。如果数据库已成功升级到最新发行版,则该脚本将只是返回成功消息。