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 可以安装在 Windows 或 Oracle Linux 7 操作系统上。以下几小节介绍了每个平台的安装过程。
使用以下过程在 Windows 环境中安装 DIVAnet:
使用具有管理员权限的帐户启动 DIVAnet 安装程序可执行文件 DIVAnet_V2.1.version.exe
。
选择所需的组件,然后单击 Next。
选择 Java(如果以前没有安装在目标目录中)。
如果只想安装 DIVAnet 用户界面,则取消选择 DIVAnet Services。
指定目标安装目录。这将是 DIVAnet 主目录。然后单击 Install。
注:
可以使用 DIVArchive 安装目录作为 DIVAnet 主目录。但是,Oracle 建议将 DIVAnet 安装在单独的目录中。如果在 Linux 上运行,则必须创建一个名为 diva
的用户和一个名为 divanetsvc
的用户。divanetsvc
用户必须有权写入、读取和执行 diva
拥有的文件。diva
用户必须对 Linux systemctl
命令具有 sudo
权限。必须以 diva
用户、admin
用户或 root
用户身份来运行安装。必须在安装软件前创建 diva
用户。安装程序中提供了一个在安装前创建 diva
和 divanetsvc
用户的选项。
使用以下过程在 Linux 环境中安装 DIVAnet:
打开一个终端会话并导航到 DIVAnet 发行版的父目录。
将 DIVAnet 安装软件包(例如 DIVAnet-2.1-RELEASE.sh
)放在该目录中。安装程序可以将 DIVAnet 安装在此父目录的子目录中。
使用以下命令启动 DIVAnet 安装:
sh ./DIVAnet-2.1-RELEASE.sh
安装程序提供了一个在安装此软件前创建 Linux 先决条件用户 diva
和 divanetsvc
的选项。在创建这些用户并分配正确的权限后,选择安装 DIVAnet 软件的选项。
系统将提示您指定要安装 DIVAnet 的子目录名称。按 Enter 键将使用名为 DIVAnet
的默认子目录,您也可以指定一个定制子目录名称并按 Enter 键来创建安装目录。
DIVAnet 安装过程随后开始,并且所有文件和文件夹都将提取到指定的目标目录中。
以下各节介绍了完成安装可能需要执行的额外步骤。有关更多信息,请参见第 2 章。
要创建 DIVAnet 数据库,首先创建 DIVAnet 表,然后配置 DIVArchive 站点。
此步骤涉及创建 DIVAnet 数据库表,这些表将放在运行中的 Oracle 服务器上。只有 DIVAnet 完全安装才需要此步骤(请参见第 2 章)。
要运行 SQL 创建脚本,必须将 SQLPlus(Oracle 11g 或更高版本的客户机软件)安装到要安装 DIVAnet 的系统上。确保 sqlplus 实用程序的路径位于系统的 PATH
环境变量中。
打开一个命令行窗口或终端 shell。将目录切换到 DIVAnet 主目录(安装了 DIVAnet 的目录)。
将目录切换到 Program/Database/divanet/Install
。
运行以下命令:
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 数据库中的所有数据。将目录切换到 Program/Database/divanet/Install
。
运行以下命令:
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 连接字符串。
在创建 DIVAnet 表之后,必须在 DIVAnet 数据库中配置 DIVA 站点。运行 addSites
脚本,按如下方式在数据库中配置站点:
切换到 DIVAnet 主目录,然后导航到 Program/divanet/bin
子文件夹。
运行 addSites
脚本:
Windows:addSites.bat
Linux:addSites.sh
此脚本将引导您添加站点名称记录并配置站点名称、位置和注释。指向站点的网络连接在 ClientAdapter 配置文件中配置(请参见第 4 章)。应该创建易于理解且反映站点物理位置或功能的站点名称。
注:
在配置本地和远程 DIVAnet 服务时,要使用在该步骤中提供的站点名称。在运行addSites
脚本之前,确保已经对所需的站点名称达成一致。如果您在运行命令时犯了错误,可以从 addSites
脚本内以逻辑方式删除站点。当站点名称添加到数据库中之后,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 站点安装的每个服务执行每个步骤。
使用以下过程在 Windows 环境中安装 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 处理。
使用以下过程在 Linux 环境中安装 DIVAnet 服务:
打开一个终端会话并导航到 Program/divanet/bin
目录。
运行 divanetservice
脚本来安装所需的服务(DbSync、ClientAdapter 或 ManagerAdapter)。例如,要安装 ClientAdapter,请输入以下命令:
./divanetservice install ClientAdapter
在创建 Linux DIVAnet 服务后,可使用以下命令来管理这些服务:
操作 |
命令 |
---|---|
列出所有服务 |
|
启动服务 |
|
停止服务 |
|
重新启动服务 |
|
安装服务 |
|
卸载服务 |
|
service_name
参数可以是 DbSync
、ClientAdapter
或 ManagerAdapter
。还可以使用标准 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 指向同一个位置。
在 DbSync 服务启动之后,它将通过查询 ManagerAdapter 服务来同步已归档对象的信息。ManagerAdapter 服务反过来会从它所连接到的 DIVArchive 站点提取资产信息。因此,只有当您准备开始同步时,才应启动 DbSync 服务和 ManagerAdapter 服务。
注:
如果您停止 DbSync 服务,则在该服务重新启动之后,将自动从上次停止同步的位置再次同步。DivanetAdmin 命令行工具逐一监视每个站点上的数据库同步状态。如果 DIVAnet 正在对特定站点执行初始同步,将显示初始同步操作的完成百分比。如果站点是最新的,DivanetAdmin 将指示该站点是同步的。
DivanetAdmin 还可以用来重新同步站点。这涉及从该站点删除以前同步的所有已归档对象记录,然后从源重新同步这些记录。只有在极少情况下(例如,意外地从过时的数据库备份恢复源 DIVA 数据库),才需要使用重新同步。
在升级到新版本的 DIVAnet 之前,建议您备份现有的 DIVAnet 主目录。在升级之前,您还必须停止服务器上任何正在运行的 DIVAnet 服务或程序。使用以下过程升级 DIVAnet 软件:
按照安装 DIVAnet 软件一节中的说明进行操作。这会将最新的 DIVAnet 软件安装到 DIVAnet 主目录中。
如果是升级包含 DIVAnet 数据库的系统,必须运行 DIVAnet 数据库升级实用程序。要运行该实用程序,请将目录切换到 Program/divanet/bin
并运行以下命令:
Windows:upgradeDB.bat
Linux:./upgradeDB.sh
该脚本将提示您输入有关 DIVAnet 数据库的信息(包括数据库用户名和数据库所在的网络地址)。该实用程序将添加或修改必需的数据库对象。如果数据库已成功升级到最新发行版,则该脚本将只是返回成功消息。