Skip to main content

How To Run JetBackup Destination Validations From The Command Line?

Ehsan Dowlatshah
  • Updated

Introduction:

In order to be able to run the validation process from the command line, you need to ensure that there is already at least one destination configured through Jetbackup. You can create new remote destinations from both the command line and also from the WHM > Plugin > JetBackup > Destination interface. It's easier to use the WHM interface for this purpose. (Please make sure that you are logged in as root, otherwise, you will not be able to see the destination tab on the JetBackup plugin page). 

Please refer to this link for more information:

https://docs.jetbackup.com/manual/whm/Destinations/createNewDestination.html


After adding a destination to JetBackup's configuration you need to run this command to see the unique ID associated with the destination:

 

/usr/bin/jetapi backup -F listDestinations


The output looks similar to this:

 

success: 1
message:
system:
version: 4.0.22
tier: STABLE
 type: cPanel
drMode:
agreement:
licenseIssue:
data:
destinations:
0:
_id: 5f2c046ba9213421421aa637dd02
type: SFTP
 name: remote box
engine_name: JetBackup
rating:
rating: 0
issues:
jobs_count: 2

owner: root
disabled:
dr:
 hidden:
backup_destination: 1
clone_destination:
incremental_ability:
schedules:
time: 0
time_parsed: 12:00 AM
engine: 1
path: ./
host: remote-box.tld
port: 22
username: root
password: ****************
timeout: 30
retries: 5
connections: 2

 

The only line we are interested in is the _id line which has been highlighted. 

Procedure: 

Now you need to grab that id for the destination you want to validate and run the following command with the ID value that you just saved replaced inside the single quote section at the end of the command: 


/usr/bin/jetapi backup --func validateDestination -D '_id=5f2c046ba9213421421aa637dd02'

 

Running the validation processes from the command line is particularly valuable since it would allow you to troubleshoot potential validation issues more efficiently by tracing the validation process using tools like strace:

 

/usr/bin/strace -T -f -vvv -s 1024 -o /tmp/jet-validtion.strace /usr/bin/jetapi backup --func validateDestination -D '_id=5f2c046ba9213421421aa637dd02'

Related articles