HYPER-UNIFIED STORAGE nxadmin Command Line Interface Reference Guide NEXSAN | 325 E. Hillcrest Drive, Suite #150 | Thousand Oaks, CA 91360 USA Printed Thursday, July 26, 2018 | www.nexsan.com Copyright © 2010—2018 Nexsan Technologies, Inc. All rights reserved. Trademarks Nexsan® is a trademark or registered trademark of Nexsan Technologies, Inc. The Nexsan logo is a registered trademark of Nexsan Technologies, Inc. All other trademarks and registered trademarks are the property of their respective owners. Patents This product is protected by one or more of the following patents, and other pending patent applications worldwide: United States patents US8,191,841, US8,120,922; United Kingdom patents GB2466535B, GB2467622B, GB2467404B, GB2296798B, GB2297636B About this document Unauthorized use, duplication, or modification of this document in whole or in part without the written consent of Nexsan Corporation is strictly prohibited. Nexsan Technologies, Inc. reserves the right to make changes to this manual, as well as the equipment and software described in this manual, at any time without notice. This manual may contain links to web sites that were current at the time of publication, but have since been moved or become inactive. It may also contain links to sites owned and operated by third parties. Nexsan is not responsible for the content of any such third-party site. Contents Contents Contents iii Chapter 1: Accessing the nxadmin and nxcmd CLIs 15 Connecting to the Unity Storage System using SSH 15 Prerequisite 15 Connecting to the Unity Storage System from the IPMI Web-based interface 16 Prerequisite 16 Connecting to the Unity Storage System via remote console 18 Chapter 2: Using the nxadmin CLI’s command-based shell 19 aclpropagate 19 De s c ription 19 Co n troller 20 Syntax 20 Op tion s 20 Ex ample1 20 Ex ample2 21 arp 21 De s c ription 21 Co n troller 21 Syntax 21 Op tion s 21 Ex ample 22 audit 23 De s c ription 23 Co n troller 23 Syntax 23 Op tion s 23 Ex ample 23 autolog 24 De s c ription 24 Co n troller 24 Syntax 24 Op tion s 24 Ex ample 25 bedit 25 De s c ription 25 Co n troller 25 Syntax 25 Op tion s 25 callhome 26 De s c ription 26 Co n troller 26 Syntax 26 Op tion s 26 Ex ample1 27 Ex ample2 27 Ex ample3 28 cat 28 De s c ription 28 Co n troller 28 Syntax 28 Op tion s 28 cd 28 De s c ription 28 Co n troller 29 Syntax 29 Op tion s 29 Ex ample 29 changeenclosureid 29 De s c ription 29 Co n troller 29 Syntax 29 Op tion s 29 Ex ample 29 changenameservices 30 De s c ription 30 Co n troller 30 Syntax 30 Op tion s 30 Ex ample 31 chmod 31 De s c ription 31 Co n troller 31 Syntax 31 Op tion s 31 Abs oluteMode 32 Sy mb o licMode 32 ACLOp e ration 33 Attribu teOp e ration 35 Ex ample 36 cleandev 36 De s c ription 37 Co n troller 37 Syntax 37 Op tion s 37 Ex ample 38 clustering 38 De s c ription 38 Co n troller 38 Syntax 38 Op tion s 39 Ex ample 39 createlogpackage 39 De s c ription 39 Co n troller 39 Syntax 40 Op tion s 40 Ex ample 40 dataproperty 40 De s c ription 40 Co n troller 40 Syntax 40 Op tion s 41 Ex ample1 42 Nexsan Unity www.nexsan.com iii Contents Ex ample2 42 Ex ample3 42 Ex ample4 42 date 43 De s c ription 43 Co n troller 43 Syntax 43 Op tion s 43 Ex ample1 44 Ex ample2 44 diskhbcfg 44 De s c ription 44 Co n troller 44 Syntax 44 Op tion s 44 Ex ample 45 domain name 45 De s c ription 45 Co n troller 45 Syntax 45 Op tion s 45 Ex ample 45 drives 46 De s c ription 46 Co n troller 46 Syntax 46 Op tion s 46 Ex ample 46 echo 47 De s c ription 47 Co n troller 47 Syntax 47 Op tion s 47 Ex ample 47 edit 48 De s c ription 48 Co n troller 48 Syntax 48 Op tion s 48 enforcessl 48 De s c ription 48 Co n troller 48 Syntax 48 Op tion s 48 errorlog 48 De s c ription 49 Co n troller 49 Syntax 49 Op tion s 49 Ex ample 49 eventflag 49 De s c ription 49 Co n troller 49 Syntax 49 Op tion s 50 exit 50 De s c ription 50 Co n troller 50 Syntax 50 Op tion s 50 fcstat 50 De s c ription 50 Co n troller 50 Syntax 50 Op tion s 50 Ex ample 51 firewall 51 De s c ription 51 Co n troller 51 Syntax 51 Op tion s 51 Ex ample 52 format 53 De s c ription 53 Co n troller 53 Syntax 53 Op tion s 53 Ex ample 53 ftpconfig 53 De s c ription 54 Co n troller 54 Syntax 54 Op tion s 54 Ex ample 55 groupadd 55 De s c ription 55 Co n troller 55 Syntax 56 Op tion s 56 Ex ample 56 groupdel 56 De s c ription 56 Co n troller 56 Syntax 56 Ex ample 56 help 56 De s c ription 57 Co n troller 57 Syntax 57 Op tion s 57 Ex ample 57 hostname 57 De s c ription 57 Co n troller 57 Syntax 57 Op tion s 57 Ex ample1 57 Ex ample2 57 ifconfig 58 De s c ription 58 Co n troller 58 Syntax 58 Op tion s 58 Ex ample 58 info 58 De s c ription 58 Co n troller 58 Syntax 58 Op tion s 58 Ex ample 58 iostat 59 De s c ription 59 Co n troller 59 Syntax 59 Op tion s 59 Ex ample 61 intmonitoring 61 De s c ription 61 Co n troller 61 Syntax 62 Op tion s 62 Ex ample 62 ipmi 62 De s c ription 62 Co n troller 62 Syntax 62 Op tion s 62 ipmitool 63 De s c ription 63 Co n troller 63 Syntax 63 Op tion s 63 Su b -Commands 64 Ex ample1 66 Ex ample2 66 isainfo 66 De s c ription 66 Co n troller 66 Syntax 66 Op tion s 66 Ex ample 67 kill 67 De s c ription 67 Co n troller 67 Syntax 67 Op tion s 67 Ex ample 67 led 67 De s c ription 68 Co n troller 68 Syntax 68 Op tion s 68 Ex ample1 69 Ex ample2 70 Ex ample3 70 Ex ample4 70 listfcclients 70 De s c ription 70 Co n troller 70 Syntax 70 Op tion s 70 Ex ample 70 listug 71 De s c ription 71 Co n troller 71 Syntax 71 Op tion s 71 Ex ample 71 logrotate 71 De s c ription 71 Co n troller 71 Syntax 71 Ge n e raloptions 72 Op tion s c o n trolling whenalog fileisrotated 73 Op tion s c o n trolling howalog fileisrotated 74 Op tion s c o n trolling the e x p iration o fo ldlog files 75 Ex ample 76 ls 76 De s c ription 76 Co n troller 76 Syntax 77 Op tion s 77 Pe rmiss ion s a rgu me n t 79 Inh e ritan c e a rgu me n t 80 Ex ample1 81 Ex ample2 81 Ex ample3 81 lun 82 Nexsan Unity nxadmin CLI Reference Guide Unity iv Contents De s c ription 82 Co n troller 82 Syntax 82 Op tion s 82 Ex ample 83 maintenance 83 De s c ription 83 Co n troller 83 Syntax 83 Op tion s 83 Ex ample 83 man 84 De s c ription 84 Co n troller 84 Syntax 84 Op tion s 84 Ex ample 84 md5sum 84 De s c ription 84 Co n troller 84 Syntax 84 Op tion s 84 Ex ample 84 menu 84 De s c ription 85 Co n troller 85 Syntax 85 Op tion s 85 modgid 85 De s c ription 85 Co n troller 85 Syntax 85 Op tion s 85 Ex ample1 85 Ex ample2 85 moduid 85 De s c ription 86 Co n troller 86 Syntax 86 Op tion s 86 Ex ample 86 mpstat 86 De s c ription 86 Co n troller 87 Syntax 87 Op tion s 87 Ex ample 87 netstat 88 De s c ription 88 Co n troller 88 Syntax 88 Op tion s 88 Ex ample 91 ndmpsnap 92 De s c ription 92 Co n troller 92 Syntax 92 Op tion s 92 Ex ample 92 network 92 De s c ription 93 Co n troller 93 Syntax 93 Op tion s 93 Ex ample 93 nfs 94 De s c ription 94 Co n troller 94 Syntax 94 Op tion s 94 Ex ample 94 nfsstat 95 De s c ription 95 Co n troller 95 Syntax 95 Op tion s 95 Ex ample 96 nic 96 De s c ription 96 Co n troller 96 Syntax 96 Op tion s 97 Ex ample1 104 Ex ample2 104 Ex ample3 104 Ex ample4 104 nics 105 De s c ription 105 Co n troller 105 Syntax 105 Op tion s 105 Ex ample 105 nicstat 105 De s c ription 106 Co n troller 106 Syntax 106 Op tion s 106 Ex ample 107 nmp 107 De s c ription 107 Co n troller 107 Syntax 107 Op tion s 107 Ex ample 107 nscacherestart 107 De s c ription 108 Co n troller 108 Syntax 108 Op tion s 108 nstds 108 De s c ription 108 Co n troller 108 Syntax 108 Op tion s 108 Ex ample 108 nstfcdata 108 De s c ription 109 Co n troller 109 Syntax 109 Op tion s 109 Ex ample 110 nstndmp 110 Recommended settings 110 NAS name 110 User name and password 110 Backup level 110 De s c ription 110 Co n troller 110 Syntax 110 Op tion s 111 Ex ample 114 nstpool 114 De s c ription 114 Co n troller 115 Syntax 115 Op tion s 115 Ex ample 115 nstsasdata 116 De s c ription 116 Co n troller 116 Syntax 116 Op tion s 117 Ex ample1 118 Ex ample2 118 Ex ample3 118 Ex ample4 119 Ex ample5 119 nstsharectl 119 De s c ription 119 Syntax 120 Co n troller 120 Op tion s 120 Ex ample1 120 Ex ample2 120 Ex ample3 121 Ex ample4 121 Ex ample5 121 nstusermaps 122 De s c ription 122 Co n troller 122 Syntax 122 Op tion s 122 Ex ample1 124 Ex ample2 124 Ex ample3 124 Ex ample4 124 nstvault 125 De s c ription 125 Co n troller 125 Syntax 125 Op tion s 125 Ex ample 125 ntpdate 126 De s c ription 126 Co n troller 126 Syntax 126 Op tion s 126 Ex ample 126 nvram 127 De s c ription 127 Co n troller 127 Syntax 127 Op tion s 127 Ex ample1 127 Ex ample2 127 Ex ample3 128 nxcmd 128 De s c ription 128 Co n troller 128 Syntax 128 Op tion s 128 Nexsan Unity www.nexsan.com v Contents nxservices 129 De s c ription 129 Co n troller 129 Syntax 129 Op tion s 129 Su b -commands 130 Ex ample 130 passwd 130 De s c ription 130 Co n troller 130 Syntax 131 Op tion s 131 peer 131 De s c ription 131 Co n troller 131 Syntax 131 Op tion s 131 Ex ample 131 perfmon 131 De s c ription 131 Co n troller 132 Syntax 132 Op tion s 132 Ex ample1 132 Ex ample2 132 Ex ample3 133 performance 133 De s c ription 133 Co n troller 133 Syntax 133 Op tion s 133 Ex ample 133 ping 134 De s c ription 134 Co n troller 134 Syntax 134 Op tion s 134 Ex ample 136 prompt 137 De s c ription 137 Co n troller 137 Syntax 137 Op tion s 137 Ex ample 137 ps 138 De s c ription 138 Co n troller 138 Syntax 138 Op tion s 139 Ex ample 140 ptree 140 De s c ription 140 Co n troller 140 Syntax 141 Op tion s 141 Ex ample 141 pwd 142 De s c ription 142 Co n troller 142 Syntax 142 Op tion s 142 Ex ample 142 reboot 142