NetBackup IT Analytics 系统管理指南

说明

从列出主机和主机属性的逗号分隔文件中导入主机详细信息。

用法

execute load_package.loadServerFile('<file_name>'
[,'<source_name>']);

file_name 是 csv 文件的完全限定路径。示例：

/opt/aptare/database/hosts.csv

source_name 是一个可选的、不区分大小写的字符串，最多包含 100 个字符，代表主机详细信息的来源；例如，CMDB 可能与更改管理数据库有关。保留此源信息是为了获取历史记录，以跟踪将主机添加到数据库的方式。如果没有为此参数提供任何内容或提供的是 NULL，则会将 CSV 加载作为源插入到报告数据库中。

加载文件规范

逗号分隔文件的规范如下：

path_to_host_group, internal_name, external_name, 
description, location, IP_address, make, model, OS

示例：

/APTARE/Test,testhost01,testhost01,description,location,
172.20.16.1,Sun,E450,Solaris 10
/APTARE/Test,testhost02,testhost02,,location,
172.20.16.2,Sun,,Solaris

每个字段的详细规范如下：

internal_name              CHAR(128)    NOT NULL
external_name              CHAR(128)    NOT NULL
description                CHAR(256)
location                   CHAR(64)
ip_address                 CHAR(40)
make                       CHAR(64)
model                      CHAR(64)
os_version                 CHAR(128)

数据约束

字段值不能包含嵌入式逗号。

第一个字段 path_to_host_group 必须是现有主机组的完整路径，否则将不会插入主机。

csv 文件必须存在且可读。

指定 csv 文件名时必须使用单引号。

逻辑条件

如果主机已存在于指定的主机组中，实用程序将会更新其详细信息。

如果主机不在报告数据库中，则实用程序会将其添加到指定的主机组中。

如果主机属性字段在输入文件中的值为 NULL，则数据库中的相应字段将不会对已有行进行更新。

更新已有行时，实用程序会区分输入文件中的大小写。

由于记录的主键为 internal_name，因此无法通过此实用程序更新主机的 internal_name。

如果某行中传递的参数超过 9 个，实用程序会跳过该行。

日志记录

实用程序会将所有添加、更新、警告和错误记录到 scon.log 文件中，该文件在 Linux 系统上的默认位置为 /tmp，在 Windows 系统上的默认位置为 C:\opt\oracle\logs。日志记录字符串通常采用以下格式：

日期 -> 时间 -> 级别 -> load_package:sub_routine -> 操作

其中：

级别为 DBG、INFO、WARN 或 ERR。

sub_routine 是正在执行的子例程（例如 loadHostLine）。

操作是正在报告的操作。

示例：

14-MAY 21:56:08 INFO : updating host: z0001-web0600-s 
in /APTARE/Infrastructure