V4.2 FP1:

update_db_schemas.pl

使用 update_db_schemas.pl 脚本对一个或多个修订包或临时修订应用所有必需的模式更新。

描述

Network Manager V4.2开始,当您下载新的修订包或临时修订时,下载包含 update_db_schemas.pl 脚本和关联的更新文件。 这些更新文件包括所有修订包和临时修订的所有 NCIM 拓扑数据库模式更改,直到当前修订为止。

您可以通过运行 update_db_schemas.pl 脚本将当前修订包或临时修订的所有模式更改应用于 NCIM 拓扑数据库。 同时更新所有 NCIM 数据库。 该脚本还会对多个修订包或临时修订应用模式更改。 例如,如果对于特定主要发行版,您未安装修订包 1 ,但现在正在安装修订包 2 ,那么运行 update_db_schemas.pl 脚本将应用修订包 1 和修订包 2 的所有模式更改。
注: 并非每个修订包都包含数据库模式更新。 有关修订包及其是否包含数据库模式更新的列表,请参阅 发行说明- IBM Tivoli Network Manager IP Edition 4.2。 如果要升级到的修订包或中间的任何修订包包含数据库模式更改,那么必须运行 update_db_schemas.pl 脚本。

此脚本与 list_applied_updates.pl 脚本协同工作。 此脚本应用模式更改, list_applied_updates.pl 脚本用于检查是否应用了特定修订包或临时发行版的更改。

注: 请勿直接运行提供的 SQL 脚本。 直接运行这些脚本可能会导致模式错误。 要更新数据库模式,请始终运行 update_db_schemas.pl 脚本,该脚本会对系统进行相应的更改。

运行脚本

该脚本具有以下语法。
  • 使用域名来指定登录详细信息:
    $NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/sql/update_db_schemas.pl -domain DOMAIN_NAME [ -dbname DATABASE_NAME ] [-preview [PREVIEW_FILE] ] [ -debug ]
  • 显式指定登录详细信息:
    $NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/sql/update_db_schemas.pl -server DATABASE_TYPE [ -dbname DATABASE_NAME ] -host DATABASE_HOST -username DATABASE_USERNAME -password DATABASE_PASSWORD [ -port DATABASE_PORT ] [-preview [PREVIEW_FILE] ] [ -debug ]
以下是如何运行脚本的示例:
  1. 预览将应用的模式更新。
    $NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/sql/update_db_schemas.pl -domain DOMAIN_NAME -preview
  2. 应用模式更新。
    $NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/sql/update_db_schemas.pl -domain DOMAIN_NAME
    注: 当模式更新程序成功应用给定修订包的所有更改时,它会将一行写入 ncim.schemaAudit 表,并提供包含这些更改的文件的名称以及应用这些更改时的时间戳记。

命令行选项

下表描述此脚本的命令行选项。
表 1. update_db_schemas.pl 命令行选项
命令行选项 描述
-debug 可选: 打印额外的调试信息。
-dbname 数据库名称 可选: 数据库的服务名称 (或 Oracle SID)。缺省值为 NCIM。
-领域 域名 Network Manager 域的名称。 这是脚本从相关 DbLogin.cfg 文件检索数据库登录详细信息的便捷方法。 在这种情况下,不需要选项 -server ,-host ,-username ,-password 和 -port。
注: 。 如果您有多个共享相同登录详细信息的域,那么只需要对其中一个域运行脚本。 对使用相同登录详细信息的其他域运行该脚本不会产生任何影响。
-help 可选: 提供有关此命令的帮助。
-东道主 DATABASE_HOST 数据库服务器主机名。 如果指定了 -domain 选项,那么不需要此选项。
-暗号 数据库密码 数据库用户的密码。 如果指定了 -domain 选项,那么不需要此选项。
-港 DATABASE_PORT 可选: 数据库端口 (如果未使用缺省值)。 如果指定了 -domain 选项,那么不需要此选项。
- 预览 [PREVIEW_FILE ] 可选: 打印要对文件进行的模式更改。 缺省情况下,此文件位于 /tmp/nm-update.sql中。 要为文件指定其他名称,请在 -preview 选项后指定名称。 如果执行此操作,那么预览将写入当前目录中具有该名称的文件。
-server 数据库类型 数据库类型 (Oracle 或 Db2)。 如果指定了 -domain 选项,那么不需要此选项。
-updatesDir

V4.2 修复包 6:可选。 模式更新文件的位置。 缺省值为 /updates/db2//updates/oracle/(相对于运行脚本的目录)。 如果该目录不存在,那么脚本将在 $NCHOME/precision/scripts/sql/updates/SERVER中进行查找。

-用户名 数据库用户名 数据库的用户名。 如果指定了 -domain 选项,那么不需要此选项。