| [16] | 1 | .TH mmdelnsd 02/16/06 |
|---|
| 2 | mmdelnsd Command |
|---|
| 3 | .SH "Name" |
|---|
| 4 | .PP |
|---|
| 5 | \fBmmdelnsd\fR - Deletes Network Shared Disks (NSDs) from the GPFS |
|---|
| 6 | cluster. |
|---|
| 7 | .SH "Synopsis" |
|---|
| 8 | .PP |
|---|
| 9 | \fBmmdelnsd\fR |
|---|
| 10 | {"\fIDiskName\fR[;\fIDiskName\fR...]" |
|---|
| 11 | | \fB-F\fR \fIDiskFile\fR} |
|---|
| 12 | .PP |
|---|
| 13 | Or, |
|---|
| 14 | .PP |
|---|
| 15 | \fBmmdelnsd\fR \fB-p\fR \fINSDId\fR [\fB-N\fR |
|---|
| 16 | {\fINode\fR[,\fINode\fR] }] |
|---|
| 17 | .SH "Description" |
|---|
| 18 | .PP |
|---|
| 19 | The \fBmmdelnsd\fR command serves two purposes: |
|---|
| 20 | .RS +3 |
|---|
| 21 | .HP 3 |
|---|
| 22 | 1. Delete NSDs from the GPFS cluster. |
|---|
| 23 | .HP 3 |
|---|
| 24 | 2. |
|---|
| 25 | Remove the unique NSD volume ID left on the disk after the failure of a |
|---|
| 26 | previous invocation of the \fBmmdelnsd\fR command. The NSD had been |
|---|
| 27 | successfully deleted from the GPFS cluster but there was a failure to clear |
|---|
| 28 | sector 2 of the disk. |
|---|
| 29 | .RE |
|---|
| 30 | .PP |
|---|
| 31 | The NSD being deleted cannot be part of any file system. Either the |
|---|
| 32 | \fBmmdeldisk\fR or \fBmmdelfs\fR command must be issued prior to deleting |
|---|
| 33 | the NSD from the GPFS cluster. |
|---|
| 34 | .PP |
|---|
| 35 | The NSD being deleted cannot be a tiebreaker disk. Use the \fBmmchconfig\fR command to assign new tiebreaker disks |
|---|
| 36 | prior to deleting the NSD from the cluster. |
|---|
| 37 | .PP |
|---|
| 38 | \fBResults\fR |
|---|
| 39 | .PP |
|---|
| 40 | Upon successful completion of the \fBmmdelnsd\fR command, these tasks |
|---|
| 41 | are completed: |
|---|
| 42 | .RS +3 |
|---|
| 43 | .HP 3 |
|---|
| 44 | \(bu All references to the disk are removed from the GPFS cluster data. |
|---|
| 45 | .HP 3 |
|---|
| 46 | \(bu Sector 2 of the disk is cleared of the unique NSD volume ID. |
|---|
| 47 | .RE |
|---|
| 48 | .SH "Parameters" |
|---|
| 49 | .PP |
|---|
| 50 | .RS +3 |
|---|
| 51 | \fB\fIDiskName\fR[;\fIDiskName\fR...] |
|---|
| 52 | \fR |
|---|
| 53 | .RE |
|---|
| 54 | .RS +9 |
|---|
| 55 | Specifies the names of the NSDs to be deleted from the GPFS |
|---|
| 56 | cluster. Specify the names generated when the NSDs were created. |
|---|
| 57 | Use the |
|---|
| 58 | \fBmmlsnsd -F\fR command to display disk |
|---|
| 59 | names. If there is more than one disk to be deleted, delimit each name |
|---|
| 60 | with a semicolon (;) and enclose the list of disk names in quotation |
|---|
| 61 | marks. |
|---|
| 62 | .RE |
|---|
| 63 | .PP |
|---|
| 64 | .RS +3 |
|---|
| 65 | \fB-F \fIDiskFile\fR |
|---|
| 66 | \fR |
|---|
| 67 | .RE |
|---|
| 68 | .RS +9 |
|---|
| 69 | Specifies a file containing the names of the NSDs, one per line, to be |
|---|
| 70 | deleted from the GPFS cluster. |
|---|
| 71 | .RE |
|---|
| 72 | .PP |
|---|
| 73 | .RS +3 |
|---|
| 74 | \fB-N \fINode\fR[,\fINode\fR] |
|---|
| 75 | \fR |
|---|
| 76 | .RE |
|---|
| 77 | .RS +9 |
|---|
| 78 | Specifies the nodes to which the disk is attached. If no nodes are |
|---|
| 79 | listed, the disk is assumed to be directly attached to the local node. |
|---|
| 80 | Only one or two nodes may be specified with the \fB-N\fR flag. |
|---|
| 81 | .PP |
|---|
| 82 | For information on how to specify node names, see \fISpecifying nodes as input to GPFS commands\fR |
|---|
| 83 | in \fIGPFS: Administration and Programming Reference\fR. |
|---|
| 84 | .RE |
|---|
| 85 | .PP |
|---|
| 86 | .RS +3 |
|---|
| 87 | \fB-p \fINSDId\fR |
|---|
| 88 | \fR |
|---|
| 89 | .RE |
|---|
| 90 | .RS +9 |
|---|
| 91 | Specifies the NSD volume ID of an NSD that needs to be cleared from the |
|---|
| 92 | disk as indicated by the failure of a previous invocation of the |
|---|
| 93 | \fBmmdelnsd\fR command. |
|---|
| 94 | .RE |
|---|
| 95 | .SH "Options" |
|---|
| 96 | .PP |
|---|
| 97 | NONE |
|---|
| 98 | .SH "Exit status" |
|---|
| 99 | .PP |
|---|
| 100 | .PP |
|---|
| 101 | .RS +3 |
|---|
| 102 | \fB0 |
|---|
| 103 | \fR |
|---|
| 104 | .RE |
|---|
| 105 | .RS +9 |
|---|
| 106 | Successful completion. |
|---|
| 107 | .RE |
|---|
| 108 | .PP |
|---|
| 109 | .RS +3 |
|---|
| 110 | \fBnonzero |
|---|
| 111 | \fR |
|---|
| 112 | .RE |
|---|
| 113 | .RS +9 |
|---|
| 114 | A failure has occurred. |
|---|
| 115 | .RE |
|---|
| 116 | .SH "Security" |
|---|
| 117 | .PP |
|---|
| 118 | You must have root authority to run the \fBmmdelnsd\fR command. |
|---|
| 119 | .PP |
|---|
| 120 | You may issue the \fBmmdelnsd\fR command from any node in the GPFS |
|---|
| 121 | cluster. |
|---|
| 122 | .PP |
|---|
| 123 | When using the \fBrcp\fR and \fBrsh\fR commands for remote |
|---|
| 124 | communication, a properly configured \fB.rhosts\fR file must exist |
|---|
| 125 | in the root user's home directory on each node in the GPFS |
|---|
| 126 | cluster. If you have designated the use of a different remote |
|---|
| 127 | communication program on either the |
|---|
| 128 | \fBmmcrcluster\fR |
|---|
| 129 | or the |
|---|
| 130 | \fBmmchcluster\fR command, you must |
|---|
| 131 | ensure: |
|---|
| 132 | .RS +3 |
|---|
| 133 | .HP 3 |
|---|
| 134 | 1. Proper authorization is granted to all nodes in the GPFS cluster. |
|---|
| 135 | .HP 3 |
|---|
| 136 | 2. The nodes in the GPFS cluster can communicate without the use of a |
|---|
| 137 | password, and without any extraneous messages. |
|---|
| 138 | .RE |
|---|
| 139 | .SH "Examples" |
|---|
| 140 | .PP |
|---|
| 141 | To delete \fBgpfs2nsd\fR and \fBgpfs3nsd\fR from the GPFS cluster, |
|---|
| 142 | issue this command: |
|---|
| 143 | .sp |
|---|
| 144 | .nf |
|---|
| 145 | mmdelnsd "gpfs2nsd;gpfs3nsd" |
|---|
| 146 | .fi |
|---|
| 147 | .sp |
|---|
| 148 | .PP |
|---|
| 149 | The system displays output similar to: |
|---|
| 150 | .sp |
|---|
| 151 | .nf |
|---|
| 152 | mmdelnsd: Processing disk gpfs2nsd |
|---|
| 153 | mmdelnsd: Processing disk gpfs3nsd |
|---|
| 154 | mmdelnsd: 6027-1371 Propagating the changes to all affected |
|---|
| 155 | nodes. This is an asynchronous process. |
|---|
| 156 | .fi |
|---|
| 157 | .sp |
|---|
| 158 | .PP |
|---|
| 159 | To confirm the deletion, issue this command: |
|---|
| 160 | .sp |
|---|
| 161 | .nf |
|---|
| 162 | mmlsnsd |
|---|
| 163 | .fi |
|---|
| 164 | .sp |
|---|
| 165 | .PP |
|---|
| 166 | The system displays information similar to: |
|---|
| 167 | .sp |
|---|
| 168 | .nf |
|---|
| 169 | File system Disk name Primary node Backup node |
|---|
| 170 | -------------------------------------------------------- |
|---|
| 171 | fs0 gpfs16nsd k145n06 k145n07 |
|---|
| 172 | fs0 gpfs17nsd k145n06 k145n07 |
|---|
| 173 | fs0 gpfs18nsd k145n06 k145n07 |
|---|
| 174 | fs0 gpfs19nsd k145n06 k145n07 |
|---|
| 175 | fs0 gpfs20nsd k145n06 k145n07 |
|---|
| 176 | fs1 gpfs1nsd (directly attached) |
|---|
| 177 | fs1 gpfs4nsd (directly attached)\ |
|---|
| 178 | \ |
|---|
| 179 | .fi |
|---|
| 180 | .sp |
|---|
| 181 | .SH "See also" |
|---|
| 182 | .PP |
|---|
| 183 | mmcrnsd Command |
|---|
| 184 | .PP |
|---|
| 185 | mmlsnsd Command |
|---|
| 186 | .SH "Location" |
|---|
| 187 | .PP |
|---|
| 188 | \fB/usr/lpp/mmfs/bin\fR |
|---|
| 189 | .PP |
|---|
