用于存储管理的 onpsm 实用程序

使用 onpsm 实用程序可管理 GBase 8s 主存储管理器目录、设备、锁定和对象。

先决条件：要运行 onpsm 实用程序，您必须是用户 root 或 gbasedbt，或者是 bargroup 组的成员。

语法

目录选项

设备选项

对象选项

池选项

表 1. onpsm 实用程序目录选项
元素	用途	重要注意事项
- C check	检查存储管理器目录表，这些表用于存储有关存储管理器所管理的池和设备的元数据	此命令可识别有问题的文件。
- C check -l	检查目录表时显示索引键
- C check -n	指示存储管理器不修正发现的错误
- C detail	显示有关存储管理器目录表的详细信息
- C export	将 GBase 8s Primary Storage Manager 目录表导出到名为 psm_catalog.exp 的目录
- C import	将当前 GBase 8s Primary Storage Manager 目录替换为从 psm_catalog.exp 目录中的文件重新创建的目录。	仅当发生系统问题、丢失当前目录以及需要还原到导出的目录时，才应导入目录。如果需要导入目录，请先运行 onpsm -C init 命令，然后再运行 onpsm -C import 命令。
- C init	删除存储管理器的目录表
- C init -d	删除文件设备中的存储管理器目录表和备份对象
- C unlock	对存储管理器目录解锁	如果存储管理器因为发生故障而从备份或复原会话异常退出，那么存储管理器目录表可能会保持锁定。如果目录表处于锁定状态，您可以释放这些锁定。
-y	指定在删除目录表之前不要求确认

表 2. onpsm 实用程序设备选项
元素	用途	重要注意事项
-D add	将设备添加到 -g 选项指定的池中	在添加设备前，收集有关设备的信息。请参阅收集有关文件目录和设备的信息。
-D del	除去设备：如果使用 -g 选项，将从 -g 选项指定的池中除去设备，而保留 GBase 8s Primary Storage Manager 目录中的设备对象。如果使用 -d 选项，将从所有池中除去设备，并从该设备中的文件系统中除去所有备份对象	如果使用 -g 选项删除设备，可以根据需要复原对象。如果除去设备，存储管理器将无法向该设备添加新对象。
-D list	显示系统中所有设备的列表
-D purge	从 GBase 8s Primary Storage Manager 目录中除去缺少的存储管理器对象
-D scan	扫描设备中的对象以验证 GBase 8s Primary Storage Manager 目录中是否存在这些对象，以便可以根据需要复原这些对象如果对象不在目录中，此命令将向目录添加该对象。	如果命令无法向目录添加对象，此命令将忽略缺少的文件。要能够向目录添加缺少的对象，必须满足以下条件：该对象标识不能分配给存储管理器中的其他任何对象。文件不能重命名或重定位到设备内部的其他目录中该对象版本不能分配给存储管理器中的其他任何对象。
-D update	修改有关设备的信息	如果要修改有关多个设备的信息，请针对每个设备运行独立的命令。
*path*	设备（针对 TAPE 设备）或目录（针对 FILE 设备）的全名和路径	路径的格式必须适合设备连接到的操作系统。设备的名称在池中必须唯一。您可以在多个池中包含相同的设备。如果要删除、列出、清除、扫描或更新信息，路径必须是现有设备的路径。
-b block_size	（仅限磁带设备）向设备写入数据前需要积累的数据的最小字节数	块大小对于磁带设备是必需的。
-d	从所有池中删除池并删除备份对象	块大小对于磁带设备是必需的。
-g pool_name	要将设备添加到的池，即 DBSPOOL、LOGPOOL 或 EXTPOOL	有关池的信息存储在 GBase 8s Primary Storage Manager 目录中。如果未提供池名称，命令将失败。指定：用于备份数据库空间、Blob 空间和智能大对象空间的 DBSPOOL 用于备份逻辑日志的 LOGPOOL 用作登台区域的 EXTPOOL，从中可以将特定备份或备份生成移至永久存储器或移至其他计算机上。
-l dev_def_file.txt	从设备定义文件装入有关设备的信息
-p priority	设备的优先级，即 HIGHEST、HIGH、LOW 或 READ-ONLY	存储管理器会先填满池中的高优先级设备，然后再将数据放入该池中的低优先级设备。当存储管理器准备填充池时，如果高优先级设备繁忙，那么存储管理器会使用低优先级设备。池中只能有一个设备的优先级可以为 HIGHEST。如果在同一池中多个设备具有相同的优先级，存储管理器将确定要首先使用的设备。设备变满时，存储管理器会将其优先级更改为 READ-ONLY。向设备添加更多空间后，可以更改优先级。
-s size	（仅限磁带设备）设备的最大存储容量（以千字节为单位）	该大小对于磁带设备是可选的。如果未指定大小，或指定为 `0`，那么存储管理器会将大小解释为无限制。当大小为无限制时，只有设备返回错误以指定设备已满时，才会将设备视为已满。要指定大小，请输入大小的数字值，后跟后缀 B、K、M、G、T 或 P（分别表示字节、千字节、兆字节、千兆字节、太字节或皮特字节）。后缀可以是大写，也可以是小写。
- t type	设备的类型，可以是 FILE 或 TAPE	有关设备的信息存储在 GBase 8s Primary Storage Manager 目录中。
-u	将有关设备的信息卸载到设备定义文件	设备定义文件是一个具有特定格式的文本文件。使用装入选项运行 onpsm 命令时，存储管理器会使用该文件重新创建信息。
-y	指定不要求确认完成请求的操作

表 3. onpsm 对象选项
元素	用途	重要注意事项
-O del	从池删除物理对象
-O detail	显示有关指定对象的详细信息。详细信息包括对象的位置。
-O dump	将对象数据抽取到当前目录中的某个文件
- o object_id	标识特定对象	可以使用单一命令来删除或转储一个或多个对象，如用途中所示。
-O list	显示池中的所有对象	对于每个对象，该列表包含创建对象的日期和时间、对象的大小和对象的路径名。
-y	指定不要求确认完成请求的操作。

表 4. onpsm 池选项
元素	用途	重要注意事项
-P add pool_name	添加新池
P del pool_name	删除指定的池
-P list	列出系统中的所有池
-y	指定不要求确认完成请求的操作。

表 5. onpsm 实用程序一般选项
元素	用途	重要注意事项
-h	显示帮助信息
-V	显示软件版本号和序列号	有关标准 GBase 8s -V 和 -version 选项的更多详细信息，请参阅 GBase 8s 管理员参考中的获取实用程序的版本信息。
-version	显示软件版本号、序列号和其他信息，例如主机、操作系统、构建日期和 Global Language Support (GLS) 版本	有关标准 GBase 8s -V 和 -version 选项的更多详细信息，请参阅 GBase 8s 管理员参考中的获取实用程序的版本信息。
-version all	显示 onpsm 版本信息和有关 PSM 共享库的信息

用途

当您运行 onpsm 命令来定义设备时，如果不存在存储管理器目录，那么存储管理器会自动创建这些目录。

存储管理器的缺省设备为 $GBASEDBTDIR/backups。此低优先级设备在创建目录时会自动创建。您可以除去缺省设备。

创建设备时，如果该设备的目录不存在，存储管理器将自动创建该目录。存储管理器将使用 onpsm -D add 命令中指定的目录路径。

可以使用单一命令来删除一个或多个对象，例如，通过运行以下格式的命令：

onpsm _O del -o obj_1 -o obj_2

还可以使用单一命令来转储一个或多个对象，例如，通过运行以下格式的命令：

onpsm _O dump -o obj_1 -o obj_2

如果不需要数据，请运行 onsmsync 实用程序来从 GBase 8s Primary Storage Manager 删除备份对象。

有些第三方存储管理器不允许 onsmsync 实用程序从存储管理器删除备份对象。如果您有第三方存储管理器，那么可能需要手动删除不再需要的备份对象。

示例

以下命令在 DBSPOOL 池中添加路径名为 $INFOMRIXDIR/backups 的文件设备：

onpsm -D add $GBASEDBTDIR/backups -g DBSPOOL -t FILE  -p HIGH

以下命令检查 GBase 8s Primary Storage Manager 目录表，并指示存储管理器不修正检查期间发现的任何错误：

onpsm -C check -n

以下命令列出池中的对象，包含创建对象的日期和时间、对象的大小和对象的路径名。

onpsm -O list