Retrieving File System Information

This operation makes sense only if performing migration in Plesk for Unix.

Before starting a migration, you may want to get information on the source or destination file system, in order to specify the most suitable directory for storing migration dump. To get a server file system information, send request packet containing the get_fs operation node structured as follows:

<packet>
 <migration>
   <get_fs/>
 </migration>
</packet>  

Response Packet Structure

The get_fs node in the response packet received from server is structured as follows:

• The result node is required. It wraps the result of the get_fs operation. Data type: MigrationOutputGetFsResultType.
• The status node is required. It returns the execution status of the get_fs operation. Data type: string. Allowed values: ok | error.
• The errcode node is optional. It returns the error code when the get_fs operation fails. Data type: unsignedInt.
• The errtext node is optional. It returns the error message if the get_fs operation fails. Data type: string.
• The fs node is required. It holds the collection of data describing a file system on the host. The number of the fs nodes in the response packet is equal to number of partitions on the host (ignoring swap partition). Data type: FS.
• The mountpoint node is required. It returns the partition mount point. Data type: string.
• The device node is required. It returns the device on which the file system exists. Data type: string.
• The mode node is required. It returns mount options of the file system. Data type: FsReadWriteStatus. Allowed values: rw | r.
• The size node is required. It returns total size of the file system (in bytes). Data type: string.
• The free node is required. It returns the amount of free space on the file system (in bytes). Data type: string.
• The type node is required. It returns the file system type. Data type: string. 

Response Samples

A positive response received from server can look as follows:

<packet>
<migration>
<get_fs>
   <result>
      <status>ok</status>
      <fs>
         <mountpoint>/</mountpoint>
         <device>/dev/sda1</device>
         <mode>rw</mode>
         <size>4015644672</size>
         <free>1549070336</free>
         <type>ext3</type>
      </fs>
   </result>
</get_fs>
</migration>
</packet>

A negative response received from Plesk for Windows server looks as follows:

<packet>
  <migration>
    <get_fs>
      <result>
        <status>error</status>
        <errcode>1017</errcode>
        <errtext>operator get_fs is  not supported</errtext>
      </result>
    </get_fs>
  </migration>
</packet>