本附录介绍管理员用户可以使用的命令行界面 (Command Line Interface, CLI) 命令。由于 CLI 以固件为基础,因此可能并非所有命令都适用于您的磁带库。
管理员可访问的 CLI 命令包括:
此命令对整个磁带库或部分磁带库执行物理审计。
显示 audit 命令的帮助,与 "help audit" 相同。
启动整个磁带库的物理审计。此命令立即返回且不显示任何结果。
示例:
SL8500> audit * requestId requestId 9 Done Failure Count 0 Success Count 1 COMPLETED
执行单个地址的物理审计并显示结果。
<device address>-指定要使用的机械手,格式为:磁带库、滑轨、列、侧面、行。
<address>-指定要审计的插槽位置,格式为:磁带库、滑轨、列、侧面、行。
示例:
SL8500> audit 1,4,0,1,0 1,4,-45,1,1 requestId requestId 9 Attributes Media Label #EMPTY.. Object Location 1,4,-45,1,1 Done Failure Count 0 Success Count 1 COMPLETED
执行一系列地址的物理审计并显示结果。
<device address>-指定要使用的机械手,格式为:磁带库、滑轨、列、侧面、行。
<start address> <end address>-指定要审计的开始和结束插槽位置,格式为:磁带库、滑轨、列、侧面、行。开始和结束地址之间只有行是变量。
示例:
SL8500> audit 1,4,0,1,0 1,4,-45,1,1 1,4,-45,1,2 requestId requestId 10 Attributes Media Label #EMPTY.. Object Location 1,4,-45,1,1 Attributes Media Label EN34410R Object Location 1,4,-45,1,2 ... Done Failure Count 0 Success Count 5 COMPLETED
启用或禁用能够缩短审计时间的多行扫描审计功能。
print-打印多行扫描审计状态。
<device address>-指定要使用的机械手,格式为:磁带库、滑轨、列、侧面、行。
示例:
SL8500> audit multiRowScan print 1,1,0,1,0 requestId requestId 8401 Attributes Multi Row Scan enabled Object Robot 1,1,0,1,0 Done Failure Count 0 Success Count 1 COMPLETED
此命令用于管理 CAP。
显示 capCommand 命令的帮助,与 "help capCommand" 相同。
在滑轨上启用或禁用 CAP(仅适用于批量 CAP)。某些情况可能会阻止 CAP 被禁用,例如由主机保留。
<device address>-指定要释放的 CAP,格式为:磁带库、滑轨、列、侧面、行。
强制释放 CAP。如果 CAP 中有磁带,保留将更改为 "default"。如果 CAP 中没有磁带,保留将更改为 "none"。
<device address>-指定要释放的 CAP,格式为:磁带库、滑轨、列、侧面、行。
锁定或解锁设备地址所指定的 CAP。
<device address>-指定要锁定/解锁的 CAP,格式为:磁带库、滑轨、列、侧面、行。
这一系列命令显示并控制与磁带库内的清洗和诊断磁带相关的功能。只有具有介质验证功能的客户才能使用这些命令。
显示 cleaning 命令的帮助,与 "help cleaning" 相同。
列出系统插槽中的所有清洗磁带。
示例:
SL8500> cleaning list cleaning requestId requestId 9001 Attributes Expired false Label CLN0080U Location 1,1,-52,1,13 Max Usage Count 100 Media Type 9840_Cleaning Status ok Usage Count 0 Object Cartridge cleaning
将清洗和诊断磁带导入到系统插槽。一次只能执行一个导入/导出操作。对于 SL8500 磁带库,必须至少有 9 个空系统插槽才能进行导入。
<cap device address>-指定要用于导入操作的 CAP,格式为:磁带库、滑轨、列、侧面、行。
to { 1 | 2 | 3 | 4 | * }-指定可能的情况下磁带要导入到的滑轨(可选)
示例:
SL8500> cleaning import 1,2,55,1,0 to 1 requestId requestId 10101 Message CAP open(ing). Place cartridges to import in CAP, then close CAP.Use CONTINUE cmd to proceed... Done Failure Count 0 Success Count 0 COMPLETED
导出选定的清洗磁带。一次只能执行一个导入/导出操作。
<cap device address>-指定要用于导出操作的 CAP,格式为:磁带库、滑轨、列、侧面、行。
select { 1 | 2 | 3 | 4 | expired }-指定从中导出清洗磁带的滑轨编号。
示例:
SL8500> cleaning export 1,2,55,2,0 cleaning select expired requestId requestId 9601 Address 1.4.-52.1.12 Success Cartridge Exported Volume Label CLN002CU Message CAP open(ing). Remove cartridges, then close CAP.Use CONTINUE cmd to proceed... Done Failure Count 0 Success Count 1 COMPLETED
将特定的清洗或诊断磁带导出到指定 cap。一次只能执行一个导入/导出操作。
<cap device address>-指定要用于导出操作的 CAP,格式为:磁带库、滑轨、列、侧面、行。
<cartridge address>-指定要导出的磁带的位置,格式为:磁带库、滑轨、列、侧面、行。指定的磁带必须位于系统插槽中,而且必须是清洗磁带或诊断磁带。
示例:
SL8500> cleaning export 1,2,55,2,0 1,4,-52,1,12 requestId requestId 9601 Address 1.4.-52.1.12 Success Cartridge Exported Volume Label CLN002CU Message CAP open(ing). Remove cartridges, then close CAP.Use CONTINUE cmd to proceed... Done Failure Count 0 Success Count 1 COMPLETED
显示清洗磁带类型及其警告阈值的列表。每个清洗磁带类型都有 4 个属性:
Index
-"cleaning threshold set" 命令所使用的清洗磁带类型
Media type
-所用清洗磁带的类型
Maximum usage coun
t-磁带制造商推荐的最大使用次数
Warning threshold value
-用户定义的阈值,用于确定清洗磁带的使用计数一旦达到此阈值何时为其设置警告状况。
示例:
SL8500> cleaning threshold list requestId requestId 15001 Attributes Object Index 1 Media Type SgtUltrium1_Cleaning Recommend Max Usage 100 Warning Threshold 0 Attributes Object Index 3 Media Type T10000_Cleaning Recommend Max Usage 50 Warning Threshold 0
为特定的清洗磁带类型设置警告阈值。
<warning threshold value>-可以是 1000 及以内的任何正整数。值为 0 表示无警告阈值。
<list index number>-在 "cleaning threshold list" 命令的列表中,索引编号指定的清洗磁带类型。
示例:
SL8500> cleaning threshold set 55 11 requestId requestId 15101 Attributes Object Success true Done COMPLETED
将磁带机清洗警告标志设置为 on 或 off。
on-如果磁带机需要清洗,则将其运行状况设置为警告
off-即使磁带机需要清洗,其运行状况也不会受到影响
此命令将显示当前的物理磁带库配置或设置磁带库配置参数。
显示 config 命令的帮助,与 "help config" 相同。
仅针对在其中执行了该命令的磁带库设置 SDP 所使用的 complexId。如果复合磁带库中存在多个磁带库,则必须为其中的每个磁带库单独设置 complexId。
为远程磁带库所使用的 SDP 设置 complexId。如果复合磁带库中存在多个磁带库,则必须为其中的每个磁带库单独设置 complexId。
<library address>-指定磁带库,格式为:磁带库、滑轨、列、侧面、行。例如:2, 0, 0, 0, 0。
清除磁带库的 complexId 编号。此命令将重新启动网络堆栈并导致 SDP ILC IP 地址停止响应。
清除远程磁带库的 complexId 编号。此命令将重新启动网络堆栈并导致 SDP ILC IP 地址停止响应。
<library address>-指定磁带库,格式为:磁带库、滑轨、列、侧面、行。例如:2, 0, 0, 0, 0。
显示在其中执行了该命令的磁带库的当前 complexId。
显示 ilc 状态。
启用或禁用磁带库间通信 (Inter-Library Communications, ILC) LAN。如果已请求禁用,则必须首先使用 "accessState offline <device address>" 命令使磁带库脱机。
显示此磁带库的当前磁带库标识符。
设置 libraryId,值从 1 到 32。磁带库必须脱机才能使用此命令。
显示当前的物理磁带库配置。
显示磁带库服务信息。
设置服务信息:contact 'contactName' phone 'phoneNumber' streetAddr 'streetAddress' city 'city' state 'state' country 'country' zip 'zipCode' description 'description data'。
目前,最大字符串长度为 31 个字符。每个字符串都必须由 ' '(单引号)分隔,以便能够使用空格和其他字符。
示例:
SL8500> config serviceInfo set city 'Denver' contact 'Andy' country 'USA' description 'Manager' phone '303 222-4444' state 'C0' streetAddr '1 tape drive' zip '80027' requestId requestId 1512402 Device serviceInfo Success true Done Failure Count 0 Success Count 1 COMPLETED
此命令以格林尼治标准时间 (Greenwich Mean Time, GMT) 设置磁带库日期。
显示 date 命令的帮助,与 "help date" 相同。
显示当前的系统日期。
设置系统日期。在复合磁带库中,libraryId = 1 的磁带库为主磁带库。更改主磁带库上的日期。
<MM>-月(两位数)
<DD>-日(两位数)
<YYYY>-年(四位数)
此命令显示磁带机的相关信息或执行 adiEnable、fastLoad、power 和 rewindUnload 等磁带机实用程序。
显示 drive 命令的帮助,与 "help drive" 相同。
打开、关闭或者打印 ADI 磁带机搜索状况。一旦启用,所有后续添加的磁带机都将尝试 ADI 磁带机搜索。要为磁带库中具有 ADI 功能的所有磁带机启用 ADI,必须重新引导磁带库。
打开、关闭或者打印 fastLoad 功能的状况。FastLoad 会更改磁带机挂载(move 命令)的行为。fastLoad 开启时,机械手并不等待 PUT 完全装入到磁带机,而是立即进行下一操作。此外,还会更改 rewindUnload 命令的行为,不等待磁带机卸载而是立即返回。fastLoad 的状态适用于所有磁带机。
注:
此命令仅影响发出它的同一 CLI 会话中所发出的命令。显示磁带机摘要信息:位置、状态、状况、类型、固件版本、接口类型、使用中、序列号、状态(联机/脱机)、状况(正常、警告或错误)和磁带机供应商。
<drive address>-指定磁带库中的磁带机,格式为:磁带库、滑轨、列、侧面、行。
*-显示磁带库中所有磁带机的磁带机信息
导致磁带机托盘上的绿色 LED 指示灯闪烁。闪烁将一直持续,直到发出 search off 命令。用于在磁带库中找到磁带机。
<drive address>-指定磁带库中的磁带机,格式为:磁带库、滑轨、列、侧面、行。
购买硬件激活许可后,此命令可激活某些磁带库功能。
注:
禁用 openVolser、dualRobot、分区设置或冗余电子设备时,必须重新引导磁带库。显示 hwActivation 命令的帮助,与 "help hwActivation" 相同。
添加许可文件。许可文件必须命名为 SL8500_license_config.dsf。全路径名为 /usr/local/SL8500_license_config.dsf。
删除指定的已安装功能文件。
<index>-指定要删除的文件编号,如磁带库控制器 hwActivation 模块数据库中所指定。请参见 "hwActivation listFiles"。
列出磁带库控制器 hwActivation 模块数据库中已安装功能的文件。
列出磁带库控制器 hwActivation 模块数据库中所有已启用的功能。
此命令管理介质验证功能。
显示 mediaValidation 命令的帮助,与 "help mediaValidation" 相同
显示介质验证池的磁带机位置。
all-列出所有磁带机插槽
poolOnly-仅列出介质验证池中的磁带机插槽
*-仅显示目标磁带库的信息
@-显示整个复合磁带库的信息
清除指定磁带机的介质验证保留。
<drive address>-指定磁带库中的磁带机,格式为:磁带库、滑轨、列、侧面、行。
停止目前正在进行的验证。磁带返回到源存储插槽。
<drive address>-指定磁带库中的磁带机,格式为:磁带库、滑轨、列、侧面、行。
此命令用于配置和显示控制器卡的网络配置。有关其他信息,请参见 OTN 上的《SL8500 主机连接指南》。
用于冗余电子设备配置。将所有端口、路由和 IP 策略配置复制到 B 侧 HBC。IP 地址替换为针对 B 侧的命令中指定的 IP 地址。如果未指定任何端口 IP 地址,则不在 B 侧设置它们。
显示为 network 命令所设置的目录磁带库侧面(A 或 B)。
设置网络命令的目标磁带库侧面。
清除网络配置。此命令停止网络连接。重新配置需要访问 HBC 卡上的串行端口。
导出磁带库网络配置文件 (.lnc) 并生成网络配置脚本 (.scr)。仅在之前未设置任何网络配置的情况下使用。
设置外部网络默认网关。
清除外部网络默认网关。
导入磁带库网络配置文件 (.lnc)。
设置 2B 端口的 IP 地址。
设置特定端口的 IP 地址。
删除端口的 IP 地址。
显示特定端口或两个端口(如果未指定 dev)的当前地址信息。
设置端口的运行状况,从而控制端口能否发送和接收以太网通信流量。
up-将端口设置为联机
down-将端口设置为脱机
对设备 2A 或 2B 启用或禁用策略路由。
显示设备 2A 和 2B 的策略路由状况。
为设备 2A 或 2B 的策略添加或删除静态路由。
为设备 2A 或 2B 的策略添加或删除通过网关的静态路由。
显示设备 2A 或 2B 的策略路由信息。
设置默认网关路由 IP 地址。
删除默认网关路由 IP 地址。
为指定主机添加或删除静态 IP(Internet Protocol,Internet 协议)路由地址。此命令还使用户可以为特定端口设置网络掩码。
示例:
SL8500>network ip route add 129.80.81.59/24 dev 1B COMPLETED
添加或删除到目标网络 IP 网关地址的静态路由。
显示当前的路由表信息或特定端口的路由表信息。
设置主机名。
以 xxx.xxx.xxx.xxx 形式设置外部网络的网络掩码。
显示外部以太网端口(2A 和 2B)的当前网络配置。
此命令显示当前状况或禁用分区功能。
显示 partition 命令的帮助,与 "help partition" 相同。
设置指定分区内的自动清洗(0,适用于未分区的磁带库)。
显示单个指定分区或所有分区的状态属性。
在磁带库中禁用分区。
显示磁带库或任何已定义分区的容量值。
显示当前分区状态。
设置指定分区的容量。命令中未列出的现有分区的容量将设置为零。
示例:
SL8500> partition setCapacity 1,200 2,50 3,600 requestId 7601 Done Failure Count 0 Success Count 1 COMPLETED
将分区设置为 hli0。如果有任何磁带机存在于介质验证池中,则必须事先将其删除。如果在复合磁带库中,则会将所有磁带库都设置为 hli0。
设置指定分区的当前状态 (offline/online)。
此命令控制/切换冗余电子设备并检索磁带库控制器冗余电子设备状态。
显示 reControl 命令的帮助,与 "help reControl" 相同。
检索冗余电子设备状况。
<library address>-指定磁带库,格式为:磁带库、滑轨、列、侧面、行。例如:2, 0, 0, 0, 0。
*-检索复合磁带库中所有磁带库的状况
此命令配置简单网络管理协议 (Simple Network Management Protocol, SNMP)。有关更多信息,请参见 OTN 上的 SNMP 参考指南。
此命令控制驻留在 HBC 上的 ssh 守护进程/服务器的配置。这是 SLC 和其他各种应用程序连接到磁带库控制器所使用的协议实用程序。
打印当前的 ssh 守护进程协议设置。
将 ssh 守护进程协议限制设置为 v1 和 v2。(此为默认设置)。ssh 服务器会重新启动。
将 ssh 守护进程协议限制仅设置为 v2。
此命令以军用时间表示法设置磁带库日期。
显示 time 命令的帮助,与 "help time" 相同。
显示当前的系统时间。
设置系统时间。在一分钟之内完成解析。在复合磁带库中,libraryId = 1 的磁带库为主磁带库。更改主磁带库上的时间。
<HH>-小时(两位数)
<MM>-分钟(两位数)
设置系统时间。在一秒钟之内完成解析。在复合磁带库中,libraryId = 1 的磁带库为主磁带库。更改主磁带库上的时间。
<HH>-小时(两位数)
<MM>-分钟(两位数)
<SS>-秒(两位数)
此命令跟踪到指定 IP 地址的网络路由。
执行到指定 IP 地址的 traceRoute。
此命令显示客户版本以及适用于所请求设备的软件的版本。
显示某个设备或所有设备的代码的软件版本。
<device address>-指定磁带库中的设备,格式为:磁带库、滑轨、列、侧面、行。
此命令显示与正在执行的冗余电子设备命令相关的磁带库和卡的相关系统及逻辑卡信息。
显示在何处发出该命令的相关信息。
示例:
SL8500> whereAmI Host Name: gulibtst02b Port 2B IP Address: 172.20.151.24 Library Type: SL8500 HBC side: B Active side: B COMPLETED