Accessing Device's File System through SFTP for File Download

You can access certain files on the device's file system through Secure File Transfer Protocol (SFTP) and download (get) them to a folder on your local computer.

You can use any third-party SFTP clients such as WinSCP or FileZilla. SFTP uses the SSH protocol to authenticate and establish a secure connection. Therefore, before you can access the device's file system, your SFTP client needs to authenticate itself with the SFTP server (i.e., the device). The device performs standard user authentication, where you can set it up to check the user's credentials in the Local Users table (see Configuring Management User Accounts) or with a remote authentication server.

You can access the following folders under the root directory:

■ /cdr: Contains the locally stored CDRs. For more information, see Downloading CDRs through SFTP.
■ /cdr-gw: Contains SBC Test Call CDRs.
■ /configuration: Contains the CLI Script file, Configuration Package file, ini file, License file. For more information on downloading the Configuration Package file, see Downloading and Uploading the Configuration Package File
■ /debug: Contains the debug file and core dump file. For more information, see Downloading the Debug (and Core Dump) File
■ /debug-capture: Contains the stored network capture files (generated using the CLI command debug capture).
■ /debug-recording: Contains the locally stored debug recording files. For more information, see Storing Debug Recording Files Locally on Device.
■ /sdr: Contains the SDRs. For more information, see Downloading Locally Stored SDRs through SFTP.
➢ To access device's file system through SFTP:
1. Enable SSH on the device (see Configuring CLI over SSH using Public Key Authentication).
2. Start your SFTP client and connect to the device.
3. Open the file system folder in which the required file is stored, and then view or download the file.

The following shows an example of the device's file system accessed through SFTP. Note that some folders may not be relevant to your device type.

● Access privileges to the device's file system through SFTP depends on user level:
✔ Security Administrator users can access all folders.
✔ Administrator users can access only folders containing the CDRs and SDRs (i.e., /cdr, /cdr-gw, and /sdr).
✔ Monitor users can't access any folder.
● Only file viewing and downloading operations are supported through SFTP.
● The device may take a long time to prepare the debug file for SFTP transfer if it contains much information. Some SFTP clients (for example, WinSCP and FileZilla) have a short default connection timeout and if the file transfer is not started within this timeout, the transfer attempt is aborted. Therefore, it's recommended to configure a longer timeout for your SFTP client application.
● When the device is in HA mode, you can access from the active device the files stored on the redundant device's flash memory through SFTP. For more information, see Accessing Files on Redundant Device from Active through SSH.
● If you're using the SFTP Cyberduck client and downloading a file from the /configuration or /debug folder, the client may display a "Transfer incomplete" error message, even though the download is successful. Therefore, please disregard this error message.