chexport

Use the chexport command to change the protocol configuration for an export.

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

Read syntax diagramSkip visual syntax diagramtpctoolchexport-user user_name -pwd password -url url -exportexport_id -active-inactive
Read syntax diagramSkip visual syntax diagramtpctoolchexport-user user_name -pwd password -url url -exportexport_id -cifs-cifsoff-cifsoptionscifs_options-ftp-ftpoff-http-httpoff-nfs-nfsoff-nfsoptionsnfs_options-nfsaddnfs_add -nfschangenfs_change-nfsaddpositionnfs_add_position-nfschangepositionnfs_change_position-nfsremovenfs_remove-scp-scpoff-fs character-header -help-qs character?-silent

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.
-export export_id
Specifies the name of the export. This name is the export key that is listed in the ID column of the lsexport command output.
-active | -inactive
Marks the export as temporarily active or inactive. You can access the data only in an active export.
-cifs | -cifsoff
Adds or removes the CIFS protocol for the export.
-cifsoptions cifs_options
Defines the CIFS protocol options for the export. If the cifsoptions value contains spaces, the entire option must be enclosed in matching single quotation marks and the quotation marks must be preceded by an escape character.
-ftp | -ftpoff
Adds or removes FTP for the export.
-http | -httpoff
Adds or removes HTTP for the export.
-nfs | -nfsoff
Adds or removes the NFS protocol for the export.
-nfsoptions nfs_options
Defines the NFS clients and their options for the export.
-nfsadd nfs_add
Adds the NFS clients and their options to the export.
-nfschange nfs_change
Modifies the NFS clients and their options for the export.
-nfsaddposition nfs_add_position
Specifies the position of a new NFS entry that was specified by the nfsadd parameter.
-nfschangeposition nfs_change_position
Specifies the position of a modified NFS entry that was specified by the nfschange parameter.
-nfsremove nfs_remove
Removes one or more NFS clients from the export.
-scp | -scpoff
Adds or removes SCP for the export.
-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: Changing the FTP and HTTP options for an export

The following command adds FTP and removes HTTP from the export.
tpctool> chexport 
-export cindyexport+storage1.storage.tucson.ibm.com+storage1.storage.tucson.
 ibm.com+0 -user admin -pwd password -url localhost:9550 -ftp -httpoff

The following output is returned:

ExportId          																																												
===============================================================================
cindyexport+storage1.storage.tucson.ibm.com+storage1.storage.tucson.ibm.
 com+0	

Status
===============================================================================
SUCCESS



Example: Defining the CIFS options for an export

The following command defines the CIFS protocol options for the export.
chexport -export eexp10+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 g0vmware -url localhost:9550

The following output is returned:

ExportId                              Status   																																												
===============================================================================
eexp10+kq98n5d.ibm+00000200A22045DC+0 SUCCESS

Example: Changing the NFS options for an export

The following command adds, modifies, and removes NFS entries for the export.
tpctool> unlinkfset -fileset eefset01+eefs+kq458mv.ibm+00000200A2A0153C+0
-user admin -pwd password -url localhost:9550

The following output is returned:

ExportId          																																												
===============================================================================
eexp600+kq98n5d.ibm+00000200A22045DC+0 

Status
===============================================================================
SUCCESS



Example: Changing the NFS options and their positions for an export

The following command adds and modifies NFS entries and their positions for the export.
tpctool> chexport -export eexp700+kq98n5d.ibm+00000200A22045DC+0 
-nfsadd "host4(ro)" -nfsaddposition host2 -nfschange "host2(ro)" 
-nfschangeposition 3 -active -user db2admin -pwd g0vmware 
-url localhost:9550

The following output is returned:

ExportId          																																												
===============================================================================
eexp700+kq98n5d.ibm+00000200A22045DC+0 

Status
===============================================================================
SUCCESS