Man Pages Reference Guide StorNext 4.3.2 6-67661-03 Rev A StorNext 4.3.2 Man Pages Reference Guide 6-67661-03 Rev A January 2013 Made in the USA. Quantum Corporation provides this publication “as is” without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose. Quantum Corporation may revise this publication from time to time without notice. COPYRIGHT STATEMENT © 2013 Quantum Corporation. All rights reserved. Your right to copy this manual is limited by copyright law. Making copies or adaptations without prior written authorization of Quantum Corporation is prohibited by law and constitutes a punishable violation of the law. TRADEMARK STATEMENT Quantum, the Quantum logo, DLT, DLTtape, the DLTtape logo, Scalar, StorNext, the DLT logo, DXi, GoVault, SDLT, StorageCare, Super DLTtape, and SuperLoader are registered trademarks of Quantum Corporation in the U.S. and other countries. Protected by Pending and Issued U.S. and Foreign Patents, including U.S. Patent No. 5,990,810. LTO and Ultrium are trademarks of HP, IBM, and Quantum in the U.S. and other countries. All other trademarks are the property of their respective companies. Specifications are subject to change without notice. ii Contents StorNext 4.3.2 Man Pages Reference Guide 6-67661-03 Rev A January 2013 Introduction Quantum recommends using the GUI to complete most StorNext tasks, but there might be situations where you prefer or need to use the command line interface (CLI) instead. This document is a printed version of the man pages as they currently exist in StorNext. For each command, information similar to the following is provided: • name • synopsis • description • options • examples • see also On a Windows Vista system, when you run applications from the command line that require administrative privileges, you can start the CLI application either from an elevated shell environment or a DOS shell. Note: For Windows Vista users only : If the CLI application is started from an alternative shell (such as those provided by cygwin ,) you must start that shell in an elevated mode. If you do not, CLI commands requiring administrative privileges will fail and you will receive an error message indicating that you do not have sufficient privileges to run the command. To start the shell in elevated mode, right-click the icon for Command Prompt or Cygwin and select Administrative Mode. Using Commands or Viewing man Pages The man pages are contained within this document, and can also be accessed via the command line. Use the following procedure to view the man page for a command. 1 Source the StorNext profile. Do one of the following: • If using the bash shell, at the command prompt, type: source /usr/adic/.profile • If using the csh or tcsh shell, at the command prompt, type: source /usr/adic/.cshrc 2 View the man page for a command. At the command prompt, type: man <command> where <command> is the command for which you want to view the man page. 3 Press <Spacebar> to page through the man page. 4 When you are finished, type q and press <Enter> to exit the man page. Paging through man pages may work differently depending on the viewer specified by the $PAGER environmental variable. Introduction iii StorNext 4.3.2 Man Pages Reference Guide 6-67661-03 Rev A January 2013 Contacting Quantum More information about this product is available on the Quantum Service and Support website at www.quantum.com/ServiceandSupport . The Quantum Service and Support website contains a collection of information, including answers to frequently asked questions (FAQs). You can also access software, firmware, and drivers through this site. To request a software upgrade, visit www.quantum.com/ServiceandSupport/Upgrade/Index.aspx . For further assistance, or if training is desired, contact the Quantum Technical Assistance Center: United States 800-284-5101 Option 5 (toll free) EMEA 00800 7826 8888 (toll free) 49 6131 3241 1164 APAC 800 7826 8887 (toll free) 603 7953 3010 Online Service and Support www.quantum.com/OSR Worldwide Web www.quantum.com/ServiceandSupport (Local numbers for specific countries are listed on the Quantum Service and Support Website.) iv Contacting Quantum Table of Contents cnvt2ha.sh (1) 1 cvadmin (1) 3 cvaffinity (1) 11 cvcp (1) 13 cvdb (1) 16 cvdbset (1) 22 cvfs (1) 27 cvfsck (1) 28 cvfs_config (4) 31 cvfsd (8) 32 cvfs_failover(1) 33 cvfsid (1) 35 cvgather (1) 36 cvlabel (1) 38 cvmkdir (1) 43 cvmkfile (1) 44 cvmkfs (1) 45 cvpaths (4) 46 cvupdatefs (1) 50 cvversions (1) 54 dbdropfs (1) 55 deviceparams (4) 56 dm_foreign (1) 57 dm_info (1) 58 dm_master (1) 59 dm_session (1) 60 dm_trunc (1) 61 dm_util (1) 62 dpserver (4) 64 exclusions (4) 66 fhpath (1) 70 filesystems (4) 71 fsactivevault (1) 74 fsaddclass (1) 78 fsaddrelation (1) 83 fsaffinity (1) 85 fsaltnode (1) 86 fsautoconfig (1) 88 fsbulkcreate (1) 89 fscancel (1) 93 fschdiat (1) 94 fschfiat (1) 95 fschmedstate (1) 97 fschstate (1) 99 fsclassinfo (1) 100 fsclassrnm (1) 103 fsclean (1) 104 fsconfig (1) 107 fsddmconfig (1) 110 fsdefrag (1) 115 fsdevice (1) 118 fsdirclass (1) 120 -2- fsdiskcfg (1) 121 fsdismount (1) 123 fsdrvclean (1) 124 fsdumpnamespace (1) 125 fsexclusioncheck (1) 126 fsextlog (1) 127 fsfilecopy(1) 128 fsfileinfo (1) 130 fsfiletapeloc (1) 132 fs_fmoverc (1) 134 fsforeignservers (4) 136 fsforeignstatus (1) 137 fsformat (1) 138 fsgetclasses (1) 139 fshistrpt (1) 140 fsimportnamespace (1) 141 fslocate (1) 142 fsloglevel(1) 143 fsm (8) 144 fs_mapper (1) 145 fsmedcopy(1) 147 fsmedin (1) 150 fsmedinfo (1) 152 fsmedlist (1) 154 fsmedloc (1) 156 fsmedout (1) 157 fsmedread (1) 159 fsmedscan (1) 160 fsmlist (4) 162 fsmodclass (1) 163 fsmount (1) 167 fsmoverpt (1) 168 fsmpm (8) 169 fsnameservers (4) 171 fspolicy(1) 172 fsports (4) 175 fspostrestore (1) 178 fsqueue (1) 180 fsrecover(1) 184 fsrelocate (1) 188 fsretrieve (1) 189 fsrmclass (1) 191 fsrmcopy(1) 192 fsrmdiskcopy(1) 194 fsrminfo (1) 195 fsrmrelation (1) 196 fsroutes (4) 197 fsschedlock (1) 198 fsschedule (1) 201 fs_scsi (1) 206 fsstate (1) 208 fsstore (1) 211 fsusedspace (1) 213 -3- fsversion (1) 214 fsxsd (1) 215 ha_peer (4) 216 has_snfs_label (1) 217 health_check (l) 218 maptst (1) 223 mmportinfo (l) 224 mount_cvfs (1) 226 nss_cctl (4) 238 pr_util (1) 241 qos_config (1) 242 qustat (1) 243 showc (1) 247 snbackup (1) 248 snbkpreport (1) 249 sncfgconvert (1) 250 sncfgedit (1) 252 sncfginstall (1) 253 sncfgquery (1) 254 sncfgremove (1) 256 sncfgtemplate (1) 257 sncfgvalidate (1) 258 sncompare (1) 259 sndiskmove (1) 271 sndpscfg (1) 272 snfs.cfg (5) 273 snfs.cfgx (5) 285 snfs_config (5) 292 snfsdefrag (1) 305 snfs_ras (4) 310 snhamgr (1) 316 snhamgr_daemon (8) 320 snlatency(1) 322 snlicense (1) 323 snmetadump (1) 326 snmsm (l) 330 snpolicy(1) 332 snpolicyd.conf (5) 345 snpolicy_gather (1) 349 snquota (1) 350 snrestore (1) 354 sntsm (1) 356 takeover_ip (1) 360 vidio (1) 361 vidiomap (1) 363 vip_control (1) 365 vsarchiveeject (l) 366 vsarchiveenter (l) 370 vsarchiveqry (l) 374 vsarchivevary (l) 378 vsaudit (l) 381 vscheckin (l) 384 vscheckout (l) 388 -4- vscleareject (l) 392 vsconnectqry (l) 396 vsdismount (l) 399 vsdriveqry (l) 402 vsdrivevary (l) 407 vsexport (l) 411 vsimport (l) 415 vslock (l) 420 vsmedclassqry (l) 424 vsmedqry (l) 432 vsmedstateqry (l) 439 vsmedtypeqry (l) 442 vsmount (l) 446 vsmove (l) 453 vsping (l) 458 vspoolqry (l) 460 vsqrymount (l) 467 vsreclassify (l) 470 vsrequestqry (l) 475 vsunlock (l) 478 vsxsd (l) 481 xdi_Test (l) 482 CNVT2HA.SH(1M) CNVT2HA.SH(1M) NAME /usr/adic/util/cnvt2ha.sh − Conversion script for StorNext High Availability Servers (Linux only) SYNOPSIS cnvt2ha.sh primary cnvt2ha.sh secondary shared_FS peer_IP_addr DESCRIPTION StorNext High Availability (HA) Server configurations that include Storage Manager (SNSM) software must have their operational data movedtoashared location. The cnvt2ha.sh script performs this function. It runs in different modes for the first server to be converted (Primary) versus all subsequent server conver- sions (Secondary). All file systems should be configured before starting the Primary conversion. The Sec- ondary conversion is done on a fresh installation of SNSM with no file systems configured. Before starting conversion of the Primary server,the following steps must be completed: /usr/cvfs/config/*.cfgx Every file-system configuration must contain one of the HaFsType configuration items (see snfs_config(5)). One and only one of them must be HaShared type. SNSM Features Storage Manager elements should be configured including policies, libraries etc. /usr/cvfs/config/fsmlist Lists all the configured CVFS file systems to be started. See fsmlist(4). /usr/cvfs/config/fsnameservers It is recommended, but not required, that the HA Cluster Servers be the nameservers. The only requirement is that at least one nameserver is available when either of the clus- ter servers is powered down. See fsnameservers(4). /usr/cvfs/config/ha_peer Contains the IPv4 or IPv6 numerical address of the peer server.See ha_peer(4). /usr/cvfs/config/license.dat Licenses for both servers must be in this file. User and Group IDs The users tdlm and www,and the group adic must exist on both servers with the same ID numbers. Synchronized System Clocks This recommendation is to aid in log-file analysis. No Processes in File Systems The CVFS file systems will be unmounted during conversion. Before starting conversion of the Secondary server,the following steps must be completed: /usr/cvfs/config/fsnameservers Configure the /usr/cvfs/config/fsnameservers file identical to the Primary server.This will allowthe Secondary server to mount the shared file system and copyinall the other configuration data. OPTIONS primary Perform Primary server conversion. secondary Perform Secondary server conversion.