{"id":237,"date":"2021-07-23T12:26:12","date_gmt":"2021-07-23T12:26:12","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/how-to-troubleshoot-a-remote-transport-pruning-failure\/"},"modified":"2021-07-23T12:26:12","modified_gmt":"2021-07-23T12:26:12","slug":"how-to-troubleshoot-a-remote-transport-pruning-failure","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/how-to-troubleshoot-a-remote-transport-pruning-failure\/","title":{"rendered":"How to Troubleshoot a Remote Transport Pruning Failure"},"content":{"rendered":"<\/p>\n
\n
<\/div>\n
\n

Overview<\/h2>\n

Users who store remote backups may encounter an issue where the remote pruning process (deletion) does not complete within the system-allotted time limit. The maximum time limit is 300 seconds per transport process. This document offers solutions to troubleshoot the timeout problem.<\/p>\n

\n
Warning:<\/div>\n
\n
    \n
  • \n

    Make certain<\/strong> that your FTP server supports the MLSD (Machine List Directory) or LIST commands. If the FTP server does not<\/strong> support these commands, the backup system cannot<\/strong> use the FTP server as a remote FTP server.<\/p>\n

      \n
    • Unix-supported FTP servers, such as ProFTP and Pure-FTPd, support these commands.<\/li>\n
    • For more information about these commands, read Wikipedia\u2019s List of FTP commands documentation and itef.org\u2019s RCF 3659 documentation.<\/li>\n<\/ul>\n<\/li>\n
    • \n

      Make certain that any hidden files (files that begin with a period (.<\/code>)) on the FTP server have write permissions. The backup system can only<\/strong> prune data from files with these permissions.<\/p>\n<\/li>\n

    • \n

      We strongly<\/strong> recommend that you use Pure-FTPd or ProFTPD on remote FTP servers. Unexpected results may occur with some FTP server software.<\/p>\n

        \n
      • If you use Pure-FTPd, ensure that the DisplayDotFiles yes<\/code> statement resides in the \/etc\/pure-ftpd.conf<\/code> file.<\/li>\n
      • If you use ProFTPD, ensure that the ListOptions -a<\/code> statement resides in the \/etc\/proftpd.conf<\/code> file<\/li>\n<\/ul>\n<\/li>\n
      • \n

        If you use the Very Secure FTP daemon (vsftpd<\/code>), ensure that you set the force_dot_files<\/code> setting to yes<\/code> in the \/etc\/vsftpd.conf<\/code> file. For more information about vsftpd<\/code>, read the vsftpd documentation.<\/p>\n<\/li>\n<\/ul><\/div>\n<\/div>\n

        Transport error<\/h2>\n

        Based on your iNotify settings, the system will send an email notification when it encounters a transport error. The email notification shows a preview of the transport error log and includes an attached copy of the transport error log.<\/p>\n

        The following examples represent transport error code messages in the transport error log, where the directory name \/home\/username\/backups\/2018-05-24<\/code> represents the directory name:<\/p>\n

        cPanel & WHM version 76 and later<\/h4>\n
        \n
        The<\/span> system<\/span> could<\/span> not<\/span> prune<\/span> the<\/span> \"home\/username\/backups\/2018-05-24\"<\/span> directory<\/span> due<\/span> to<\/span> an<\/span> error<\/span>. Read<\/span> the<\/span> go<\/span>.cpanel<\/span>.net<\/span>\/<\/span>directorypruning<\/span> documentation<\/span> for<\/span> solutions<\/span> to<\/span> successfully<\/span> prune<\/span> the<\/span> directory<\/span>.<\/code><\/pre>\n<\/div>\n
        cPanel & WHM version 74 and earlier<\/h4>\n
        \n
        If<\/span> the<\/span> directory<\/span> to<\/span> be<\/span> pruned<\/span> \"home\/username\/backups\/2018-0524\"<\/span> contains<\/span> incremental<\/span> backups<\/span> with<\/span> large<\/span> numbers<\/span> of<\/span> files<\/span>, you<\/span> may<\/span> need<\/span> to<\/span> remove<\/span> it<\/span> manually<\/span>.<\/code><\/pre>\n<\/div>\n
        The solutions shown in the next section will help you troubleshoot and fix these issues.<\/p>\n
        Troubleshooting<\/h2>\n
        Several different situations may cause a transport error. You will have to diagnose your configuration to determine the appropriate solution.<\/p>\n
        The directory size is too large<\/h3>\n
        The remote transport process may time out if it tries to prune a very large directory. The following options can help you to solve this issue:<\/p>\n
        Manually delete the directory from the remote destination<\/h3>\n
        The transport may produce an error if it is unable to prune the directory due to its size. You can manually delete the directory from the remote backup location to troubleshoot this error.<\/p>\n
        Use the rm<\/code> command to delete the directory from the remote destination. For example, if you wanted to delete the \/home\/username\/backups\/2018-05-24<\/code> directory run the following command:<\/p>\n
        \n
        rm<\/span> -<\/span>rf<\/span> home<\/span>\/<\/span>username<\/span>\/<\/span>backups<\/span>\/<\/span>2018<\/span>-<\/span>05<\/span>-<\/span>24<\/span><\/code><\/pre>\n<\/div>\n
        Disable the account\u2019s backup<\/h3>\n
        Some accounts may be too large to back up to a remote backup location. You can disable an account\u2019s backup in WHM\u2019s Backup User Selection<\/em> interface (WHM<\/em> >> Home<\/em> >> Backup<\/em> >> Backup User Selection<\/em>). You can also use the WHM API 1 toggle_user_backup_state<\/code> function to disable the account\u2019s backup.<\/p>\n
        Change the backup type from incremental to compressed<\/h3>\n
        If you are saving the backups for the large-sized account as an incremental backup type, you can change the backup type to compressed to use less disk space.<\/p>\n
        \n
        Note:<\/div>\n
        \n
        The rsync backup transport does not<\/strong> accept compressed backup files. If you enable backup compression, you must<\/strong> also change the destination type in your backup configuration to a destination that accepts compressed backup files.<\/p>\n<\/p><\/div>\n<\/div>\n
        You can change the backup type and the destination type in WHM\u2019s Backup User Selection<\/em> interface (WHM<\/em> >> Home<\/em> >> Backup<\/em> >> Backup User Selection<\/em>). You can also use the following WHM API 1 functions to update your backup configuration:<\/p>\n
          \n
        • \n
          backup_config_set<\/code> \u2014 Sets the backup configuration options (use this to update the backup type).<\/p>\n<\/li>\n
        • \n
          backup_destination_add<\/code> \u2014 Adds a backup destination.<\/p>\n<\/li>\n
        • \n
          backup_destination_delete<\/code> \u2014 Removes a backup destination.<\/p>\n<\/li>\n<\/ul>\n
          The backup drive is too slow<\/h3>\n
          The transport may produce an error if your remote backup location is too slow to process the transport pruning within the system-allotted time of 300 seconds. We recommend that you replace the existing remote backup location with a faster-processing remote backup location.<\/p>\n
          Network error<\/h3>\n
          The transport may produce an error if network issues occur. If this was the case, you can run the backup transport process again manually when the network works properly.<\/p>\n
          To manually run a backup, run the following command as the root<\/code> user:<\/p>\n
          \n
          \/<\/span>usr<\/span>\/<\/span>local<\/span>\/<\/span>cpanel<\/span>\/<\/span>bin<\/span>\/<\/span>backup<\/span><\/code><\/pre>\n<\/div>\n
          Permission denied error<\/h3>\n
          The transport may produce an error if the following conditions exist on the server:<\/p>\n
            \n
          • A non-root<\/code> user authenticates to an rsync backup destination.<\/li>\n
          • Files that the user does not possess write privileges to resides in a cPanel user\u2019s directory.<\/li>\n<\/ul>\n
            We recommend that you manually delete the files that the system could not remove from the remote destination\u2019s backup.<\/p>\n
            \n
            Note:<\/div>\n
            \n
            You may need to allow write privileges to a file before you delete it. To do this, run the chmod +w<\/code> file command, where file<\/code> represents the file for which to update permissions.<\/p>\n<\/p><\/div>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"
            Overview Users who store remote backups may encounter an issue where the remote pruning process (deletion) does not complete within the system-allotted time limit. The maximum time limit is 300 seconds per transport process. This document offers solutions to troubleshoot the timeout problem. Warning: Make certain that your FTP server supports the MLSD (Machine List …<\/p>\n","protected":false},"author":1,"featured_media":238,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/237"}],"collection":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/comments?post=237"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/237\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/238"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=237"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=237"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=237"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}