| 1 | .TH mmcrfileset 04/06/06 |
|---|
| 2 | mmcrfileset Command |
|---|
| 3 | .SH "Name" |
|---|
| 4 | .PP |
|---|
| 5 | \fBmmcrfileset\fR - Creates a GPFS fileset. |
|---|
| 6 | .SH "Synopsis" |
|---|
| 7 | .PP |
|---|
| 8 | \fBmmcrfileset\fR \fIDevice\fR \fIFilesetName\fR |
|---|
| 9 | \fB[-t\fR \fIComment\fR\fB]\fR |
|---|
| 10 | .SH "Description" |
|---|
| 11 | .PP |
|---|
| 12 | The \fBmmcrfileset\fR command constructs a new fileset with the |
|---|
| 13 | specified name. The new fileset is empty except for a root directory, |
|---|
| 14 | and does not appear in the directory name space until the |
|---|
| 15 | \fBmmlinkfileset\fR command is |
|---|
| 16 | issued. The \fBmmcrfileset\fR command is separate from the |
|---|
| 17 | \fBmmlinkfileset\fR command to allow |
|---|
| 18 | the administrator to establish policies and quotas on the fileset before it is |
|---|
| 19 | linked into the name space. |
|---|
| 20 | .PP |
|---|
| 21 | For information on GPFS filesets, see the chapter |
|---|
| 22 | \fIPolicy-based data management for |
|---|
| 23 | GPFS\fR in |
|---|
| 24 | \fIGeneral Parallel File |
|---|
| 25 | System: Advanced Administration Guide\fR. |
|---|
| 26 | .PP |
|---|
| 27 | The maximum number of filesets that GPFS supports is 1000 filesets |
|---|
| 28 | per file system. |
|---|
| 29 | .SH "Parameters" |
|---|
| 30 | .PP |
|---|
| 31 | .RS +3 |
|---|
| 32 | \fB\fIDevice\fR |
|---|
| 33 | \fR |
|---|
| 34 | .RE |
|---|
| 35 | .RS +9 |
|---|
| 36 | The device name of the file system to contain the new fileset. |
|---|
| 37 | .PP |
|---|
| 38 | File system names need not be fully-qualified. \fBfs0\fR is as |
|---|
| 39 | acceptable as \fB/dev/fs0\fR. |
|---|
| 40 | .RE |
|---|
| 41 | .PP |
|---|
| 42 | .RS +3 |
|---|
| 43 | \fB\fIFilesetName\fR |
|---|
| 44 | \fR |
|---|
| 45 | .RE |
|---|
| 46 | .RS +9 |
|---|
| 47 | Specifies the name of the newly created fileset. |
|---|
| 48 | .RE |
|---|
| 49 | .PP |
|---|
| 50 | .RS +3 |
|---|
| 51 | \fB-t \fIComment\fR |
|---|
| 52 | \fR |
|---|
| 53 | .RE |
|---|
| 54 | .RS +9 |
|---|
| 55 | Specifies an optional comment that appears in the output of the |
|---|
| 56 | \fBmmlsfileset\fR command. |
|---|
| 57 | This comment must be less than 256 characters in length. |
|---|
| 58 | .RE |
|---|
| 59 | .SH "Exit status" |
|---|
| 60 | .PP |
|---|
| 61 | .PP |
|---|
| 62 | .RS +3 |
|---|
| 63 | \fB0 |
|---|
| 64 | \fR |
|---|
| 65 | .RE |
|---|
| 66 | .RS +9 |
|---|
| 67 | Successful completion. |
|---|
| 68 | .RE |
|---|
| 69 | .PP |
|---|
| 70 | .RS +3 |
|---|
| 71 | \fBnonzero |
|---|
| 72 | \fR |
|---|
| 73 | .RE |
|---|
| 74 | .RS +9 |
|---|
| 75 | A failure has occurred. |
|---|
| 76 | .RE |
|---|
| 77 | .SH "Security" |
|---|
| 78 | .PP |
|---|
| 79 | You must have root authority to run the \fBmmcrfileset\fR |
|---|
| 80 | command. |
|---|
| 81 | .PP |
|---|
| 82 | You may issue the \fBmmcrfileset\fR command from any node in the GPFS |
|---|
| 83 | cluster. |
|---|
| 84 | .PP |
|---|
| 85 | When using the \fBrcp\fR and \fBrsh\fR commands for remote |
|---|
| 86 | communication, a properly configured \fB.rhosts\fR file must exist |
|---|
| 87 | in the root user's home directory on each node in the GPFS |
|---|
| 88 | cluster. If you have designated the use of a different remote |
|---|
| 89 | communication program on either the |
|---|
| 90 | \fBmmcrcluster\fR |
|---|
| 91 | or the |
|---|
| 92 | \fBmmchcluster\fR command, you must |
|---|
| 93 | ensure: |
|---|
| 94 | .RS +3 |
|---|
| 95 | .HP 3 |
|---|
| 96 | 1. Proper authorization is granted to all nodes in the GPFS cluster. |
|---|
| 97 | .HP 3 |
|---|
| 98 | 2. The nodes in the GPFS cluster can communicate without the use of a |
|---|
| 99 | password, and without any extraneous messages. |
|---|
| 100 | .RE |
|---|
| 101 | .SH "Examples" |
|---|
| 102 | .PP |
|---|
| 103 | This example creates two filesets in file system \fBgpfs1\fR: |
|---|
| 104 | .sp |
|---|
| 105 | .nf |
|---|
| 106 | mmcrfileset gpfs1 fset1 |
|---|
| 107 | .fi |
|---|
| 108 | .sp |
|---|
| 109 | .PP |
|---|
| 110 | The system displays output similar to: |
|---|
| 111 | .sp |
|---|
| 112 | .nf |
|---|
| 113 | Fileset 'fset1' created. |
|---|
| 114 | .fi |
|---|
| 115 | .sp |
|---|
| 116 | .sp |
|---|
| 117 | .nf |
|---|
| 118 | mmcrfileset gpfs1 fset2 -t "another fileset" |
|---|
| 119 | .fi |
|---|
| 120 | .sp |
|---|
| 121 | .PP |
|---|
| 122 | The system displays output similar to: |
|---|
| 123 | .sp |
|---|
| 124 | .nf |
|---|
| 125 | Fileset 'fset2' created. |
|---|
| 126 | .fi |
|---|
| 127 | .sp |
|---|
| 128 | .PP |
|---|
| 129 | To confirm the change, issue this command: |
|---|
| 130 | .sp |
|---|
| 131 | .nf |
|---|
| 132 | mmlsfileset gpfs1 -L |
|---|
| 133 | .fi |
|---|
| 134 | .sp |
|---|
| 135 | .PP |
|---|
| 136 | The system displays output similar to: |
|---|
| 137 | .sp |
|---|
| 138 | .nf |
|---|
| 139 | Name Id RootInode ParentId Created Comment |
|---|
| 140 | root 0 3 -- Thu Dec 12 15:59:18 2005 root fileset |
|---|
| 141 | fset1 1 261633 0 Mon Dec 13 13:55:28 2005\ |
|---|
| 142 | fset2 2 261634 1 Mon Dec 13 13:56:12 2005 another fileset |
|---|
| 143 | .fi |
|---|
| 144 | .sp |
|---|
| 145 | .SH "See also" |
|---|
| 146 | .PP |
|---|
| 147 | mmchfileset Command |
|---|
| 148 | .PP |
|---|
| 149 | mmdelfileset Command |
|---|
| 150 | .PP |
|---|
| 151 | mmlinkfileset Command |
|---|
| 152 | .PP |
|---|
| 153 | mmlsfileset Command |
|---|
| 154 | .PP |
|---|
| 155 | mmunlinkfileset Command |
|---|
| 156 | .SH "Location" |
|---|
| 157 | .PP |
|---|
| 158 | \fB/usr/lpp/mmfs/bin\fR |
|---|
