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>