Note

This documentation is for a prior release of Kinetica. For the latest documentation, click here.

/admin/backup/begin

URL: http://<db.host>:<db.port>/admin/backup/begin

Prepares the system for a backup by closing all open file handles after allowing current active jobs to complete. When the database is in backup mode, queries that result in a disk write operation will be blocked until backup mode has been completed by using /admin/backup/end.

Input Parameter Description

NameTypeDescription
optionsmap of string to stringsOptional parameters. The default value is an empty map ( {} ).

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

NameTypeDescription
statusString'OK' or 'ERROR'
messageStringEmpty if success or an error message
data_typeString'admin_backup_begin_response' or 'none' in case of an error
dataStringEmpty string
data_strJSON or String

This embedded JSON represents the result of the /admin/backup/begin endpoint:

NameTypeDescription
infomap of string to stringsAdditional information.

Empty string in case of an error.