This document describes how to set up a secure FTP (SFTP) server as a Cisco Finesse server. It also describes back up, upgrade, and troubleshooting procedures.
Cisco recommends that you have knowledge of these topics:
- SFTP server
- Command-line interface (CLI) for the Cisco Unified Voice Operating System (VOS) platform
The information in this document is based on these software and hardware versions:
- Cisco Finesse Software, Version 9.1(1)
- freeFTPd SFTP server
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.
Set Up SFTP Server
This procedure describes how to use freeFTPd in order to create a user and how to set up, start, and confirm SFTP.
- Under freeFTPd Settings, navigate to User properties, create an SFTP user, and select Password Stored as SHA1 hash as the Authorization method.
- Under freeFTPd Settings, navigate to the SFTP section, and select the active network interface card (NIC) on the workstation where SFTP is installed.
- Ensure the SFTP root directory is set to default.
Once the SFTP process starts, it creates another folder with the name of the account under the path c:\Program Files\freeFTPd\sftproot. By default, that folder becomes the root folder for that specific account.
- Start SFTP, and confirm that the server is running.
As Finesse is installed on the VOS platform, it takes advantage of the Disaster Recovery System (DRS), a backup and resource tool provided by the Cisco Unified Communications Platform.
This procedure describes how to add a backup device, to start and monitor a backup, and to locate the backup data.
- Provide the IP address of the workstation where the SFTP server is running; the username and password are the ones defined during SFTP setup.
- Define the path name as '.' for the root folder. If you provide the full path, the SFTP does not connect to the DRS application.
- Start the backup from the backup page. You can check progress and collect logs from the GUI.
- When the backup is complete, the data is stored under the root folder.
This procedure describes how to upgrade Finesse.
- At the CLI command prompt, enter the utils system upgrade initiate command in order to upgrade Finesse, then complete the SFTP details. Make sure the path is only '.'
- After the upgrade and switch version are completed, disable the Cisco Security Agent (CSA) at the CLI command prompt.
There is currently no verification procedure available for this configuration.
This section provides information you can use to troubleshoot your configuration.
If the upgrade or switch version fails, you can run logs and gather information on the CLI in order to troubleshoot the issue:
admin: show version active
admin: show version inactive
admin: file get install desktop-install.log
admin: file get install install.log
On occasion, after an upgrade from Cisco Finesse Release 8.5(3) to 9.0(1), the switch version fails with the error:
0000000014: 10.168.148.18: Mar 23 2013 16:47:31.640 +0000: CCBU_main-3-EXCEPTION
%[exception_id=java.lang.IllegalStateException: DBState is not new or
migrated]: An exception occured ; If this problem persists, Cisco TAC should
This might be due to data corruption. The workaround is to install 9.x directly.