mkexport
Use the mkexport command to create an export to access data through a data transfer protocol.
An export is a shared disk space that is accessible through the protocols that you specify when you run the mkexport command. You can create exports and enable them for HTTP, FTP, Secure Copy Protocol (SCP), Network File System (NFS), and Common Internet File System (CIFS) protocols. You must have Administrator authority to use this command.
Syntax
Parameters and arguments
- -user user_name
- Specifies an IBM Spectrum Control user ID.
- -pwd password
- Specifies the password for the IBM Spectrum Control user ID.
- -url url
- Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
- -name name
- Specifies the name of the export.
- -cluster cluster_id
- Specifies the name of the IBM Spectrum Control cluster key. The cluster key is listed in the ID column of the lscluster command output. This value is different from the Cluster ID output from the lscluster command.
- -path path
- Specifies the path for the export.
- -cifs
- Configures the CIFS protocol for the export.
- -cifsoptions cifs_options
- Defines the CIFS protocol options for the export. If the cifsoptions name or value contains spaces, the entire option must be enclosed in matching single quotation marks. The quotation marks must be preceded by an escape character.
- -ftp
- Configures FTP for the export.
- -http
- Configures HTTP for the export.
- -nfs
- Configures the NFS protocol for the export.
- -nfsoptions nfs_options
- Defines the NFS clients and their options for the export.
- -scp
- Configures SCP for the export.
- -inactive
- Marks the export as inactive. An inactive export is added to the list of exports, however you cannot access the data. You can use this parameter to modify the access control lists (ACLs) before you later activate the export with the chexport -active command.
- -owner | -reference
- Where owner owner:group sets the owner or owner group for the directory or reference reference sets the directory owner to the owner of the reference file. The reference file name must be an existing file or directory.
- -fs character
- Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
- -header
- Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
- -help | -h | -?
- Lists help information for the command.
- -qs character
- Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
- -silent
- Suppresses all output for the command. If you omit this parameter, output is included.
Example: Creating an export that is enabled for HTTP, SCP, and NFS protocols
The following command creates an export to access data through HTTP, SCP, and the NFS
protocol:
tpctool> mkexport -name cindyexport
-cluster storage1.storage.tucson.ibm.com+storage1.storage.tucson.ibm.com+0
-path /ibm/gpfs0/cindy -user admin -pwd password -url localhost:9550
-http -scp -nfs
The following output is returned:
ExportId
===============================================================================
cindyexport+storage1.storage.tucson.ibm.com+storage1.storage.tucson.ibm.com+0
Status
===============================================================================
SUCCESS
You are not required to enter credentials if you have already run the tpctool command with credentials.
Example: Creating an export that is enabled for CIFS protocol
The following command creates an export to access
data through the CIFS protocol:
tpctool mkexport -name eexp10 -path /ibm/gpfs0/eexp10
-cluster kq98n5d.ibm+00000200A22045DC+0 -cifs
-cifsoptions "browseable=no,\'comment=comment for eexp10\',leases=no,
sharemodes=no,syncio=yes,hideunreadable=yes,cifsacl=no,oplocks=no,
locking=no,\'read only\',synconclose=no,\'access control=Everyone:ALLOWED:FULL;
Administrator:ALLOWED:FULL\'" -user db2admin -pwd g0vmw are -url localhost:9550
The following output is returned:
ExportId
===============================================================================
eexp10+kq98n5d.ibm+00000200A22045DC+0
Status
===============================================================================
SUCCESS