How to manage backup files via FTP (4298838)

The KACE appliance automatically performs a nightly backup by default. It is recommended to utilize the automated backup and off-board backup utility .

It may be useful at times to manually connect via FTP to upload or download appliance backups for purposes such as upgrades, professional services, support, or server migration projects. Below are the steps to connect to the FTP service to perform these actions. 

NOTE: Before it will be possible to complete any of the steps below, it will be necessary to verify that "Enable backup via FTP" and "Make FTP writable" are checked in Settings > Security Settings. The password listed in this article is the default password. If this default password does not work, a password can be set for the FTP service account, and then click Save and Restart Services. This action will restart services on the KACE SMA and may interrupt all appliance users and in-progress tasks.

FTP can also be enabled from the console for initial setup, by logging into konfig/konfig (for Username/password), and the command "startftpd -w". This will enable it with the default username/password (kbftp/getbxf) As of version 12.0, there's an option to upload backups right after the initial setup, so that they can be restored from, and optionally to Override Network Configuration. More info available on this Video on Timestamp 15:10.

To retrieve (download) files from the KACE Appliance via FTP:

1. Open a cmd prompt and change to a directory this user has permissions to access (eg: c:\Users\USERNAME\Desktop - where USERNAME is the actual name of the user OR another example could be c:\Users\USERNAME\Downloads)
2. Once in an accessible directory, type:  ftp SMA (where SMA is the hostname or IP of this SMA)
3. Type "kbftp" for the username and hit enter
4. Type "getbxf" for the password and hit enter
5. Type "type binary" and hit enter
6. Type "ls" and hit enter (Click Allow on the pop-up, if necessary) - This should list the available backups locate the most recent "base" and most recent "incr" (using dates in titles), as both will be necessary.
7. Type "get k1_base.tgz" (where k1_base.tgz is actually the full name of the base backup in the format yyyymmdd_k1_base_version.tgz)
8. Type "get k1_incr.tgz" (where k1_incr.tgz is actually the full name of the incr backup in the format yyyymmdd_k1_incr_version_yyyymmdd.tgz)
9. Note that both files above were successfully transferred to the directory used in step 1 of these instructions
10. Type "quit"

Option 2 - Using an FTP Client (recommended):

1. Using your FTP Client of choice, connect with the following details:
   1. Hostname:  IP or Hostname of the K1000
   2. Username:  kbftp
   3. Password:  getbxf
   4. Port: 21
2. Locate the files k1_base.tgz and k1_incr.tgz with the most recent dates (both the base and incremental are necessary) and transfer them to a local or network location. 

To restore (upload) or remove files to the KACE Appliance via FTP:

1. Open a cmd prompt and change to the directory that the saved backups currently exist
2. Once the appropriate directory, type:  ftp SMA (where SMA is the hostname or IP of the KACE SMA)
3. Type "kbftp" for the username and hit enter
4. Type "getbxf" for the password and hit enter
5. Type "type binary" and hit enter
6. Type "ls" and hit enter (Click Allow on the pop-up, if necessary) - This should list the available backups currently on the SMA.
7. Type "put k1_base.tgz" (where k1_base.tgz is actually the full name of the base backup in the format yyyymmdd_k1_base_version.tgz) - This should be the file downloaded and necessary for the restore.
8. Type "put k1_incr.tgz" (where k1_incr.tgz is actually the full name of the incr backup in the format yyyymmdd_k1_incr_version_yyyymmdd.tgz) - This should be the file downloaded and necessary for the restore.
9. Type "quit"
10. Note that in the Appliance webui (Settings | Backup Settings), the files uploaded via FTP should be available to restore from.

To remove backup files from the KACE Appliance via FTP using a command prompt:

NOTE: If backups need to be removed before adding more, locate the "base" and "incr" (using dates in titles) that you wish to remove, as both will be necessary. KACE recommends copying the backups to a network location prior to deleting them as a precautionary measure. (USE WITH CAUTION AS THIS CANNOT BE REVERSED):

1. Open a cmd prompt and change to the directory that the saved backups currently exist
2. Once the appropriate directory, type:  ftp SMA (where SMA is the hostname or IP of the KACE SMA)
3. Type "kbftp" for the username and hit enter
4. Type "getbxf" for the password and hit enter
5. Type "type binary" and hit enter
6. Type "ls" and hit enter (Click Allow on the pop-up, if necessary) - This should list the available backups currently on the SMA.
7. Type "del k1_base.tgz" (where k1_base.tgz is actually the full name of the base back up in the format yyyymmdd_k1_base_version.tgz)
8. Type "del k1_incr.tgz" (where k1_incr.tgz is actually the full name of the incr back up in the format yyyymmdd_k1_incr_version_yyyymmdd.tgz)
9. Type "quit"
10. Note that in the Appliance webui (Settings | Backup Settings), the files you just removed via FTP should be absent from the restore options list.