文件处理 CLI 命令

关于归档数据文件的名称

当 Guardium 数据归档 (或导出到聚集器)时，每天都有一个单独的数据文件。 根据导出/清除或归档/清除操作的配置方式，同一天导出的数据可能存在多个副本。 归档和导出数据文件的名称具有相同的格式：

<daysequence>-< hostname.domain >-w<run_datestamp>-d<data_date>。 dbdump.enc

• daysequence 是一个数字，表示归档数据的日期，以自 0 年以来的天数表示。 同一日期在名称的 data_date 部分中以 yyyy-mm-dd 格式显示。
• hostname.domain 是在其中创建归档的 Guardium 设备的主机名，后跟一个点字符和域名。
• run_datestamp 是归档或导出数据的日期，采用了 yyyymmdd.hhmmss 格式。
• data_date 是已归档数据的日期，采用了 yyyy-mm-dd 格式。

例如：732423-g1.guardium.com-w20050425.040042-d2005-04-22.dbdump.enc

backup config

这些命令将配置信息备份到内部管理表以及从这些表中复原配置信息。 backup config 命令将数据存储在 /media/backup 目录中。 backup config 命令将移除许可证信息和其他特定于机器的信息。 backup system 命令提供对配置和整个系统的更全面备份。

语法

backup config

restore config

backup system

本主题适用于 Guardium 内部数据库的备份和复原操作。 您可以备份或复原数据和/或配置信息。 这些命令将停止所有检查引擎和 Web Service 并在操作完成后将它们重新启动。

对于所有备份、导入和复原命令，根据在哪些存储系统上进行配置以及复原操作的类型，您将接收到一系列提示以要求您提供下列某项或者某几项内容。 请根据您的操作相应地对每个提示作出响应。 表 1 描述了可能会提示您的信息。

提供备份或复原操作所需的所有信息后，将会显示一系列消息来告知您操作结果。 例如，复原备份操作成功完成时，类似如下的消息将发送到

/var/IBM/Guardium/log/diag/depot/upgrade_<TimeStamp>.log 文件：

2019-05-16-165208 Upgrade of v10.0 to v11.0.0 completed successfully

阻止备份或归档脚本填充 /var

在运行之前，备份进程将检查 /var 是否有空间，如果没有，那么失败。 如果没有足够的空间用来备份，那么此进程也将警告用户。

归档进程将检查静态表的大小，并确保 /var 中有空间用来创建归档。

现在，如果使用的备份空间超过 50%，那么会在日志文件和 GUI 中记录一个错误

示例：

ERROR: /var backup space is at 60% used. Insufficient disk space for backup. CLI> backup system     1. DATA     2. CONFIGURATION  Please enter the number of your choice: (q to quit) 1      1. SCP     2. CONFIGURED DESTINATION  Enter the number of your choice: (q to quit) 2 Make sure destination is configured in the GUI under the System Backup option Please wait, this may take some time.

delete audit-data

仅在 Guardium 支持人员的指导下使用此命令。 此命令用于移除压缩的审计数据文件。 系统将提示您输入索引号以标识要移除的文件。 有关归档数据文件名的构造方式的信息，请参阅“归档数据文件名”。

系统将提示您标识要移除的文件。

语法

export audit-data

将来自指定日期 (yyyy-mm-dd) 的审计数据从各种内部 Guardium 表导出到压缩归档文件。 指定日期的数据将存储在 /var/dump 目录的压缩归档文件中。 创建的文件将在系统产生的消息中进行标识。 请参阅示例。 仅在 Guardium 支持人员的指导下使用此命令。

语法

示例

export audit-data 2005-09-16 2005-09-16

生成类似于以下内容的一组消息:

正在抽取 GDM_ACCESS 数据 ... 
正在抽取GDM_构造数据 ... 
正在抽取GDM_语句数据 ... 
正在抽取 GDM_OBJECT 数据 ... 
正在抽取 GDM_FIELD 数据 ... 
正在抽取 GDM_CONSTRUCT_TEXT 数据 ... 
正在抽取 GDM_SESSION 数据 ... 
正在抽取 GDM_EXCEPTION 数据 ... 
正在抽取 GDM_POLICY_VIOLATIONS_LOG 数据 ... 
正在抽取 GDM_CONSTRUCT_INSTANCE 数据 ... 
正在生成 tar 文件 ... /var/csvGenerationTmp ~ 
GDM_ACCESS.txt 
GDM_CONSTRUCT.txt 
GDM_CONSTRUCT_INSTANCE.txt 
GDM_CONSTRUCT_TEXT.txt 
GDM_EXCEPTION.txt GDM_FIELD.txt 
GDM_OBJECT.txt 
GDM_POLICY_VIOLATIONS_LOG.txt 
GDM_SENTENCE.txt 
GDM_SESSION.txt ~ 
生成完成， CSV 文件保存到 /var/dump/732570-supp2.guardium.com-w20050919110317-d2005-09-16.exp.tgz ok

每个指定的内部数据库表中的数据将以 CSV 格式写至一个文本文件中。 归档文件的名称以 exp.tgz 结尾，并且该名称的其余部分按“关于归档数据文件的名称”中描述的方式进行构造。

您可以使用 export file 命令将此文件传输到另一系统。

export file

此命令从 /var/IBM/Guardium/data/dump、/var/log 或 /var/IBM/Guardium/data/importdir 目录导出名为 filename 的单个文件。

仅在 Guardium 支持人员的指导下使用此命令。 要 将 Guardium 数据导出到聚集器或 归档数据，请在 "管理控制台" 面板上使用相应的菜单命令。

语法

local_path 必须是下列其中一项: /var/IBM/Guardium/data/dump, /var/log 或 /var/IBM/Guardium/data/importdir

export-public-transfer-key

此命令启动一个脚本，该脚本强制一组新的 SSH 密钥到指定的远程主机上。

将 ssh 传输密钥的公共部分导入远程主机。 有关详细信息，请参阅为数据存档、数据导出和数据集市启用 ssh 密钥对。

语法

export rotated_message_logs

使用此命令可将消息日志导出至远程目录。 每个日志在创建时使用唯一名称。

语法

fileserver

使用此命令可启动在 Guardium 设备上运行的基于 HTTPS的文件服务器。 此工具用于简化将补丁上载至单元或者从单元下载调试信息的任务。 每当此设备启动时，将会删除补丁上载至的目录中的任何文件。

语法

• IP address - 允许访问指定的文件服务器。 要检索用于启动文件服务器的 IP 地址，需要来自您正在使用的本地计算机的 IP 地址。 如果 IP 地址不是本地计算机 IP 地址，那么文件服务器将不会启动。
• Duration -指定使文件服务器保持活动状态的秒数 (60-3600)。 在指定的秒数过后，文件服务器将自动关闭。

在通过代理服务器将浏览器会话重定向的安全设置中，文件服务器客户机的 IP 地址与启动文件服务器的 SSH 客户机不相同。 相反，文件服务器客户机具有代理服务器的 IP 地址，您必须通过 IP address 参数传递该地址。 要查找代理 IP 地址，请检查浏览器设置或者“Guardium 监视器”界面中的“登录 Guardium”报告中显示的客户机 IP 地址。

示例

fileserver 10.0.0.1 3600 
Starting the file server... 
The file server is ready at https://guardium.system.com:8445 
The timeout has been set to 3600 seconds and it may timeout during the uploading. 

The upload will only be accessible from the IP you are logged in from: 10.0.0.1 
Press ENTER to stop the file server. 

在浏览器窗口中打开该文件服务器，然后执行下列其中一项操作：

• 要上载补丁，请单击“上载补丁”，然后遵循指示来执行操作。
• 要下载日志数据，请单击“Sqlguard 日志”，浏览到所需的文件，然后像下载任何其他文件一样下载该文件。

当您完成后，请返回到 CLI 会话并按 Enter 键以终止该会话。

import file

使用此命令可导入文件。

从运行命令时显示的列表中选择文件类型。 可以在 SCP ， FTP 和快照方法中使用通配符 (*) 作为文件名。

语法

import file

有关更多信息，请参阅 backup config 和 restore config。

导入 scanner_agent

语法

import scanner_agent <scp <agent> | sys <agent> <filename>

其中：

agent -受支持的 CVE 扫描程序代理程序 nessus 或 qualys。

更多信息，请参阅配置漏洞扫描代理。

import tsm config

在使用 TSM 执行任何存档或备份操作之前，将 Tivoli Storage Manager (TSM) 客户端配置文件上传到 Guardium 设备。 您始终需要上传 dsm.sys 文件，如果该文件包含多个服务器名称部分，您还需要上传 dsm.opt 文件。 有关如何创建这些文件的信息，请与公司的 TSM 管理员联系。

系统会提示您输入指定主机上用户账户的密码。

import tsm config <user@host:/path/[ dsm.sys | dsm.opt ]> 

参数

user@host - 在指定主机上访问文件的用户账户。

/path/[ dsm.sys | dsm.opt ] - 要导入文件的完整路径文件名。

如果 tsm 配置文件中有 passwordaccess=generate 字样，系统会搜索存储在本地文件中的密码。 根用户需要运行 dsmc 命令来创建本地密码文件。

Would you like to run a dsmc command now to ensure password is set locally (y/n)?     If the answer is y, run a "dsmc query options>>/dev/null" command, which will prompt user for password.

import tsm property

使用此 CLI 命令来将文件上载至 /opt/tivoli/tsm/client/ba/bin/guard_tsm.properties。

文件大小应为 1K。

语法

import tsm property user@host:file

此命令会将输入文件上载至 /opt/tivoli/tsm/client/ba/bin/guard_tsm.properties

重新启动 scanner_agent

重新启动指定的 CVE 扫描程序代理程序。

语法

restart scanner_agent <agent>

其中：

agent -受支持的 CVE 扫描程序代理程序 nessus 或 qualys。

更多信息，请参阅配置漏洞扫描代理。

restore backup

通过此命令，您可以将 Guardium 数据文件和/或配置文件从先前安装的系统复原和升级到较新的系统。 restore backup 命令不采用任何参数，但提供了一系列问题来确定要复原的文件。 为了使命令工作，需要在同一补丁级别的相同类型的机器上调用复原备份。

对于任何复原，您可以选择一个数据备份 (DATA) 文件、一个配置文件 (CONFIG) 或两种文件各选一个。

语法

restore config

这些命令将配置信息备份到内部管理表以及从这些表中复原配置信息。 backup config 命令将数据存储在 /media/backup 目录中。 backup config 命令将移除许可证信息和其他特定于机器的信息。 backup system 命令提供对配置和整个系统的更全面备份。

当复原配置时，您必须复原与创建备份的原始设备具有相同版本和补丁级别的备份。

语法

backup config

restore config

restore keystore

请仅在技术支持机构的指导下使用此命令。

使用此命令来复原 Web servlet 容器环境 (Tomcat) 使用的证书和私有密钥。

语法

restore keystore

restore pre-patch-backup

请仅在技术支持机构的指导下使用此命令。

使用此命令以在设备数据库启动或关闭时恢复 pre-patch-backup。

语法

restore pre-patchbackup Please enter the information to retrieve the file: Is the file in the local system? (y/n) n Start to recover with the backup profile parameters. Please check the recovery status in the log /var/log/guard/diag/depot/patch_installer.log ok -------------------------------------- If answer 'n', abort the operation. If answer 'y', need to enter the file name.

set up vmware tools

使用此 CLI 命令来安装可在 ESX 基础结构上运行的 VMware。

语法

setup vmware_tools [ install | uninstall ]

步骤 1: 打开 VM 客户机/控制台，然后选择包含 IBM® Guardium 设备的 VM 实例。 右键单击实例，然后从弹出菜单中选择 "访客 => 安装/升级 VMware 工具"。 这会使该实例能够通过安装点来访问 VMware Tools。

步骤 2: 运行 CLI 命令 (在 VM 客户机/控制台中) setup vmware_tools install以安装 VM 工具。

设置 scanner_agent

设置 CVE 扫描程序代理程序。

语法

setup scanner_agent <configure | enable | proxy | uninstall> <agent>

其中：

agent -受支持的 CVE 扫描程序代理程序 nessus 或 qualys。

更多信息，请参阅配置漏洞扫描代理。

show audit-data

使用此命令可以显示所有通过执行 CLI 命令 export audit-data 创建的文件。 有关审计数据文件的更多信息，请参阅 export audit-data。

语法

show audit-data <yyy-mm-dd> （显示审计数据 <yyy-mm-dd

显示 scanner_agent

语法

ca_bundle | configuration <agent> | status <agent> | supported >

其中：

agent -受支持的 CVE 扫描程序代理程序 nessus 或 qualys。

更多信息，请参阅配置漏洞扫描代理。

启动 scanner_agent

启动 CVE 扫描程序代理程序。

语法

start scanner_agent <agent>

其中：

agent -受支持的 CVE 扫描程序代理程序 nessus 或 qualys。

更多信息，请参阅配置漏洞扫描代理。

停止 scanner_agent

停止 CVE 扫描程序代理程序。

语法

stop scanner_agent <agent>

位置

agent -受支持的 CVE 扫描程序代理程序 nessus 或 qualys。

更多信息，请参阅配置漏洞扫描代理。

store language

语法

store language

store language
The following languages are available on this appliance:
	1.	French
	2.	German
	3.	Italian
	4.	Japanese
	5.	Korean
	6.	Polish
	7.	Pseudo
	8.	Simplified Chinese
	9.	Spanish
	10.	Traditional Chinese
Please enter the number of the language you want or 0 to quit: 

show 命令

show language

store tsm authorization

backupinitiationroot 在 TSM 服务器中设置为 ON 时，只有 root 用户和授权用户才能执行备份/归档。 backupinitiationroot 设置为 ON 并且 DSM.SYS 中的 password access 中设置为“generate”时，Guardium 备份和归档至 TSM 的操作将失败，并产生以下错误消息：

ANS1708E Backup operation failed. Only a root user can do this operation

非 root 用户必须被授权才能执行备份和归档。

此授权将通过执行 CLI 命令启用：

Store tsm authorization backupinitiationroot on

此授权将通过执行 CLI 命令禁用：

Store tsm authorization backupinitiationroot off

语法

store tsm authorization backupinitationiroot <on/off>

show 命令

show tsm authorization backupinitationiroot <on/off>

如果 backupinitiationroot 在 TSM 服务器中设置为 ON 时非 root Guardium 用户被授权执行备份和归档，那么此 CLI 命令显示 on。 否则，它显示 off。

重新引导后的 Vmware 内核问题

运行 Guardium 的 VMware ESX 4.1 虚拟机重新引导后可能会出现内核问题。

要更正这种情况，VMware 建议：在 ESX4.1 上安装更新 2，或者将 CPU/MMU 虚拟化设置为“对指令集和 MMU 虚拟化使用软件”。 此选项在“设置/选项/CPU/MMU 对指令集和 MMU 虚拟化使用软件”。