B 命令行界面参考

本附录介绍管理员用户可以使用的命令行界面 (Command Line Interface, CLI) 命令。由于 CLI 以固件为基础,因此可能并非所有命令都适用于您的磁带库。

管理员可访问的 CLI 命令包括:

audit

此命令对整个磁带库或部分磁带库执行物理审计。

audit

显示 audit 命令的帮助,与 "help audit" 相同。

audit *

启动整个磁带库的物理审计。此命令立即返回且不显示任何结果。

示例:

SL8500> audit *
   requestId
   requestId 9
   Done
   Failure Count 0
   Success Count 1
COMPLETED
audit <device address> <address>

执行单个地址的物理审计并显示结果。

  • <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
audit <device address> <start address> <end address>

执行一系列地址的物理审计并显示结果。

  • <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
audit multiRowScan {enable | disable | print} <device address>

启用或禁用能够缩短审计时间的多行扫描审计功能。

  • 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

capCommand

此命令用于管理 CAP。

capCommand

显示 capCommand 命令的帮助,与 "help capCommand" 相同。

capCommand <enable|disable> <device_address>

在滑轨上启用或禁用 CAP(仅适用于批量 CAP)。某些情况可能会阻止 CAP 被禁用,例如由主机保留。

  • <device address>-指定要释放的 CAP,格式为:磁带库、滑轨、列、侧面、行。

capCommand forceUnreserve <device address>

强制释放 CAP。如果 CAP 中有磁带,保留将更改为 "default"。如果 CAP 中没有磁带,保留将更改为 "none"。

  • <device address>-指定要释放的 CAP,格式为:磁带库、滑轨、列、侧面、行。

capCommand {lock | unlock} <device address>

锁定或解锁设备地址所指定的 CAP。

  • <device address>-指定要锁定/解锁的 CAP,格式为:磁带库、滑轨、列、侧面、行。

cleaning

这一系列命令显示并控制与磁带库内的清洗和诊断磁带相关的功能。只有具有介质验证功能的客户才能使用这些命令。

cleaning

显示 cleaning 命令的帮助,与 "help cleaning" 相同。

cleaning list 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
cleaning import <cap device address> [ to { 1 | 2 | 3 | 4 | * } ]

将清洗和诊断磁带导入到系统插槽。一次只能执行一个导入/导出操作。对于 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
cleaning export <cap device address> cleaning select { 1 | 2 | 3 | 4 | expired }

导出选定的清洗磁带。一次只能执行一个导入/导出操作。

  • <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
cleaning export <cap device address> <cartridge address>

将特定的清洗或诊断磁带导出到指定 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
cleaning threshold list

显示清洗磁带类型及其警告阈值的列表。每个清洗磁带类型都有 4 个属性:

  • Index-"cleaning threshold set" 命令所使用的清洗磁带类型

  • Media type-所用清洗磁带的类型

  • Maximum usage count-磁带制造商推荐的最大使用次数

  • 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
cleaning threshold set <warning threshold value> <list index number>

为特定的清洗磁带类型设置警告阈值。

  • <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
cleaning driveWarning set { on | off }

将磁带机清洗警告标志设置为 on 或 off。

  • on-如果磁带机需要清洗,则将其运行状况设置为警告

  • off-即使磁带机需要清洗,其运行状况也不会受到影响

config

此命令将显示当前的物理磁带库配置或设置磁带库配置参数。

config

显示 config 命令的帮助,与 "help config" 相同。

config complexId set {1 - 127}

仅针对在其中执行了该命令的磁带库设置 SDP 所使用的 complexId。如果复合磁带库中存在多个磁带库,则必须为其中的每个磁带库单独设置 complexId。

config complexId set {1 - 127} <library address>

为远程磁带库所使用的 SDP 设置 complexId。如果复合磁带库中存在多个磁带库,则必须为其中的每个磁带库单独设置 complexId。

  • <library address>-指定磁带库,格式为:磁带库、滑轨、列、侧面、行。例如:2, 0, 0, 0, 0。

config complexId clear

清除磁带库的 complexId 编号。此命令将重新启动网络堆栈并导致 SDP ILC IP 地址停止响应。

config complexId clear <library address>

清除远程磁带库的 complexId 编号。此命令将重新启动网络堆栈并导致 SDP ILC IP 地址停止响应。

  • <library address>-指定磁带库,格式为:磁带库、滑轨、列、侧面、行。例如:2, 0, 0, 0, 0。

config complexId print

显示在其中执行了该命令的磁带库的当前 complexId。

config ilc print

显示 ilc 状态。

config ilc {enable | disable}

启用或禁用磁带库间通信 (Inter-Library Communications, ILC) LAN。如果已请求禁用,则必须首先使用 "accessState offline <device address>" 命令使磁带库脱机。

config libraryId print

显示此磁带库的当前磁带库标识符。

config libraryId set {1 - 32}

设置 libraryId,值从 1 到 32。磁带库必须脱机才能使用此命令。

config print

显示当前的物理磁带库配置。

config serviceInfo print

显示磁带库服务信息。

config serviceInfo set

设置服务信息: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

date

此命令以格林尼治标准时间 (Greenwich Mean Time, GMT) 设置磁带库日期。

date

显示 date 命令的帮助,与 "help date" 相同。

date print

显示当前的系统日期。

date <MM> / <DD> / <YYYY>

设置系统日期。在复合磁带库中,libraryId = 1 的磁带库为主磁带库。更改主磁带库上的日期。

  • <MM>-月(两位数)

  • <DD>-日(两位数)

  • <YYYY>-年(四位数)

drive

此命令显示磁带机的相关信息或执行 adiEnable、fastLoad、power 和 rewindUnload 等磁带机实用程序。

drive

显示 drive 命令的帮助,与 "help drive" 相同。

drive adiEnable {on | off | print}

打开、关闭或者打印 ADI 磁带机搜索状况。一旦启用,所有后续添加的磁带机都将尝试 ADI 磁带机搜索。要为磁带库中具有 ADI 功能的所有磁带机启用 ADI,必须重新引导磁带库。

drive fastLoad {on | off | print}

打开、关闭或者打印 fastLoad 功能的状况。FastLoad 会更改磁带机挂载(move 命令)的行为。fastLoad 开启时,机械手并不等待 PUT 完全装入到磁带机,而是立即进行下一操作。此外,还会更改 rewindUnload 命令的行为,不等待磁带机卸载而是立即返回。fastLoad 的状态适用于所有磁带机。

注:

此命令仅影响发出它的同一 CLI 会话中所发出的命令。
drive print { <drive address> | * }

显示磁带机摘要信息:位置、状态、状况、类型、固件版本、接口类型、使用中、序列号、状态(联机/脱机)、状况(正常、警告或错误)和磁带机供应商。

  • <drive address>-指定磁带库中的磁带机,格式为:磁带库、滑轨、列、侧面、行。

  • *-显示磁带库中所有磁带机的磁带机信息

drive search {on | off} <drive address>

导致磁带机托盘上的绿色 LED 指示灯闪烁。闪烁将一直持续,直到发出 search off 命令。用于在磁带库中找到磁带机。

  • <drive address>-指定磁带库中的磁带机,格式为:磁带库、滑轨、列、侧面、行。

hwActivation

购买硬件激活许可后,此命令可激活某些磁带库功能。

注:

禁用 openVolser、dualRobot、分区设置或冗余电子设备时,必须重新引导磁带库。
hwActivation

显示 hwActivation 命令的帮助,与 "help hwActivation" 相同。

hwActivation addLicenseFile

添加许可文件。许可文件必须命名为 SL8500_license_config.dsf。全路径名为 /usr/local/SL8500_license_config.dsf。

hwActivation deleteFile <index>

删除指定的已安装功能文件。

  • <index>-指定要删除的文件编号,如磁带库控制器 hwActivation 模块数据库中所指定。请参见 "hwActivation listFiles"。

hwActivation listFiles

列出磁带库控制器 hwActivation 模块数据库中已安装功能的文件。

hwActivation print

列出磁带库控制器 hwActivation 模块数据库中所有已启用的功能。

mediaValidation

此命令管理介质验证功能。

mediaValidation

显示 mediaValidation 命令的帮助,与 "help mediaValidation" 相同

mediaValidation print { all | poolOnly } { * | @ }

显示介质验证池的磁带机位置。

  • all-列出所有磁带机插槽

  • poolOnly-仅列出介质验证池中的磁带机插槽

  • *-仅显示目标磁带库的信息

  • @-显示整个复合磁带库的信息

mediaValidation reservation clear <drive address>

清除指定磁带机的介质验证保留。

  • <drive address>-指定磁带库中的磁带机,格式为:磁带库、滑轨、列、侧面、行。

mediaValidation stopValidation <drive address>

停止目前正在进行的验证。磁带返回到源存储插槽。

  • <drive address>-指定磁带库中的磁带机,格式为:磁带库、滑轨、列、侧面、行。

network

此命令用于配置和显示控制器卡的网络配置。有关其他信息,请参见 OTN 上的《SL8500 主机连接指南》。

network clone [Port 2B IP address] [Port 2A IP address]

用于冗余电子设备配置。将所有端口、路由和 IP 策略配置复制到 B 侧 HBC。IP 地址替换为针对 B 侧的命令中指定的 IP 地址。如果未指定任何端口 IP 地址,则不在 B 侧设置它们。

network config print

显示为 network 命令所设置的目录磁带库侧面(A 或 B)。

network config side {a | b}

设置网络命令的目标磁带库侧面。

network config clear

清除网络配置。此命令停止网络连接。重新配置需要访问 HBC 卡上的串行端口。

network export

导出磁带库网络配置文件 (.lnc) 并生成网络配置脚本 (.scr)。仅在之前未设置任何网络配置的情况下使用。

network gateway <IP address>

设置外部网络默认网关。

network gateway clear

清除外部网络默认网关。

network import

导入磁带库网络配置文件 (.lnc)。

network ip <IP address>

设置 2B 端口的 IP 地址。

network ip address add <IP address> dev {2A | 2B}

设置特定端口的 IP 地址。

network ip address del <IP address> dev {2A | 2B}

删除端口的 IP 地址。

network ip address show [dev {2A | 2B}]

显示特定端口或两个端口(如果未指定 dev)的当前地址信息。

network ip link set dev {2A | 2B} {up | down}

设置端口的运行状况,从而控制端口能否发送和接收以太网通信流量。

  • up-将端口设置为联机

  • down-将端口设置为脱机

network ip policy {enable | disable} dev {2A | 2B}

对设备 2A 或 2B 启用或禁用策略路由。

network ip policy status

显示设备 2A 和 2B 的策略路由状况。

network ip policy route {add | del} <IP address> dev {2A | 2B}

为设备 2A 或 2B 的策略添加或删除静态路由。

network ip policy route {add | del} <IP address> via <Gateway IP address> dev {2A | 2B}

为设备 2A 或 2B 的策略添加或删除通过网关的静态路由。

network ip policy route show [ dev {2A | 2B} ]

显示设备 2A 或 2B 的策略路由信息。

network ip route add default via <IP address>

设置默认网关路由 IP 地址。

network ip route delete default

删除默认网关路由 IP 地址。

network ip route {add | del} <IP address [/netmask] > dev {1A | 1B | 2A | 2B}

为指定主机添加或删除静态 IP(Internet Protocol,Internet 协议)路由地址。此命令还使用户可以为特定端口设置网络掩码。

示例:

SL8500>network ip route add 129.80.81.59/24 dev 1B
COMPLETED
network ip route {add | del} <IP address [/netmask] > via <Gateway IP address>

添加或删除到目标网络 IP 网关地址的静态路由。

network ip route show [dev {2A | 2B}]

显示当前的路由表信息或特定端口的路由表信息。

network name <host name string>

设置主机名。

network netmask <netmask>

以 xxx.xxx.xxx.xxx 形式设置外部网络的网络掩码。

network print

显示外部以太网端口(2A 和 2B)的当前网络配置。

partition

此命令显示当前状况或禁用分区功能。

partition

显示 partition 命令的帮助,与 "help partition" 相同。

partition autoClean set { * | <Partition Id> }

设置指定分区内的自动清洗(0,适用于未分区的磁带库)。

partition attribute status { * | <Partition Id> }

显示单个指定分区或所有分区的状态属性。

partition disable

在磁带库中禁用分区。

partition getCapacity

显示磁带库或任何已定义分区的容量值。

partition status

显示当前分区状态。

partition setCapacity { <Partition Id> , <Capacity> }

设置指定分区的容量。命令中未列出的现有分区的容量将设置为零。

示例:

SL8500> partition setCapacity 1,200 2,50 3,600
   requestId 7601
   Done
   Failure Count 0
   Success Count 1
COMPLETED
partition setNonPartitionedHLI

将分区设置为 hli0。如果有任何磁带机存在于介质验证池中,则必须事先将其删除。如果在复合磁带库中,则会将所有磁带库都设置为 hli0。

partition set state {online | offline} <Partition Id>

设置指定分区的当前状态 (offline/online)。

reControl

此命令控制/切换冗余电子设备并检索磁带库控制器冗余电子设备状态。

reControl

显示 reControl 命令的帮助,与 "help reControl" 相同。

reControl status [ <library address> | * ]

检索冗余电子设备状况。

  • <library address>-指定磁带库,格式为:磁带库、滑轨、列、侧面、行。例如:2, 0, 0, 0, 0。

  • *-检索复合磁带库中所有磁带库的状况

snmp

此命令配置简单网络管理协议 (Simple Network Management Protocol, SNMP)。有关更多信息,请参见 OTN 上的 SNMP 参考指南。

ssh

此命令控制驻留在 HBC 上的 ssh 守护进程/服务器的配置。这是 SLC 和其他各种应用程序连接到磁带库控制器所使用的协议实用程序。

ssh print

打印当前的 ssh 守护进程协议设置。

ssh set version1and2

将 ssh 守护进程协议限制设置为 v1 和 v2。(此为默认设置)。ssh 服务器会重新启动。

ssh set version2

将 ssh 守护进程协议限制仅设置为 v2。

time

此命令以军用时间表示法设置磁带库日期。

time

显示 time 命令的帮助,与 "help time" 相同。

time print

显示当前的系统时间。

time <HH> : <MM>

设置系统时间。在一分钟之内完成解析。在复合磁带库中,libraryId = 1 的磁带库为主磁带库。更改主磁带库上的时间。

  • <HH>-小时(两位数)

  • <MM>-分钟(两位数)

time <HH> : <MM> : <SS>

设置系统时间。在一秒钟之内完成解析。在复合磁带库中,libraryId = 1 的磁带库为主磁带库。更改主磁带库上的时间。

  • <HH>-小时(两位数)

  • <MM>-分钟(两位数)

  • <SS>-秒(两位数)

traceRoute

此命令跟踪到指定 IP 地址的网络路由。

traceRoute <IP Address>

执行到指定 IP 地址的 traceRoute。

version

此命令显示客户版本以及适用于所请求设备的软件的版本。

version print [ <device address> | *]

显示某个设备或所有设备的代码的软件版本。

  • <device address>-指定磁带库中的设备,格式为:磁带库、滑轨、列、侧面、行。

whereAmi

此命令显示与正在执行的冗余电子设备命令相关的磁带库和卡的相关系统及逻辑卡信息。

whereAmi

显示在何处发出该命令的相关信息。

示例:

SL8500> whereAmI
   Host Name: gulibtst02b
   Port 2B IP Address: 172.20.151.24
   Library Type: SL8500
   HBC side: B
   Active side: B
COMPLETED