The view_transfer Script

Valid for versions 82 through the latest version

Last modified: August 15, 2022

Overview

The /usr/local/cpanel/bin/view_transfer script lets you view the logs for a transfer or restore session. These logs include the sessions for transfers and restored backups run via WHMs Transfer Tool interface (WHM » Home » Transfers » Transfer Tool). You can also restore backups with WHMs Backup Restoration interface (WHM » Home » Backup » Backup Restoration) or by running the restorepkg script.

 

Important:

You must run this script as the root user.

Note:
  • To view the previous sessions, use the view_transfer script with those sessions session IDs. You can also use WHMs Review Transfers and Restores interface (WHM » Home » Transfers » Review Transfers and Restores).
  • The WHM API 1 fetch_transfer_session_log function produces a similar output.

Run the script

To run this script on the command line, use the following format:

/usr/local/cpanel/bin/view_transfer sessionID [options]
Note:

In this example, sessionID is a transfer sessions ID.

Options

Use the following options with this script:

Options
 Description Example
sessionID Required.
The transfer sessions ID.		 10138174noroo20210208141143HpwEjUkwe
logfile A transfer sessions log file. When you use this option, the script prints the log files contents in a human-readable format. This option accepts the following log file formats:
  • The transfer sessions log file name.
  • master.log  The transfer sessions master log file.
  • master.error_log  The transfer sessions the error log file.
 item-TRANSFER_AccountRemoteUser_username
--overview Only return an overview of the transfers progress. The script will not output the transfers progress status details.
Note:
This option does not change the scripts output if you run the script with a log file.
 --overview

 

Example
To view a transfer session ID and its log files contents, use the following format:

/usr/local/cpanel/bin/view_transfer 19j1DPyTgo6GdRN9CFzeJntkSmJwJshPH6 item-TRANSFER_AccountRemoteUser_username

The scripts output will resemble the following example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

The transfer for session ID 10138174noroo20210208141143HpwEjUkwe is complete.
Progress: 0% (2021-02-08 08:11:45 -0600)
Starting TRANSFER for Account username.
Attempting to copy username from 10.1.38.174.
Trying to fetch cpmove file via cPanel API!
Fetching current backups from remote server ¦    0 backups found.
 done.
Starting the backup 
Invalid log entry: [debug: Established cpanel session
]
Remote backup started (PID 15272)
Progress: 20% (2021-02-08 08:11:46 -0600)
 done.
Checking remote server for backups ¦    1 backup found.
The remote server is creating the backup file backup-2.8.2021_08-11-46_username.tar.gz.
Progress: 25% (2021-02-08 08:11:51 -0600)
Progress: 35% (2021-02-08 08:11:51 -0600)
Downloading backup-2.8.2021_08-11-46_username.tar.gz¦
 ¦ done.
extract dir name is: backup-2.8.2021_08-11-46_username
Progress: 80% (2021-02-08 08:11:52 -0600)
Progress: 100% (2021-02-08 08:11:52 -0600)
Success.
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

The servers_queue Script

Valid for versions 82 through the latest version Last modified: June 21, 2021...

The auto-adjust-mysql-limits Script

Valid for versions 82 through the latest version Last modified: June 21, 2021...

The autossl_check Script

Valid for versions 82 through the latest version Last modified: May 13, 2020 Overview...

The backup Script

Valid for versions 82 through the latest version Last modified: May 13, 2020 Overview...

The backup_restore_manager Script

Valid for versions 82 through the latest version Last modified: July 28, 2022...