Upload
rosita-yuniar
View
218
Download
0
Embed Size (px)
Citation preview
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
1/40
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)First Published: June 28, 2012
Americas HeadquartersCisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
2/40
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIE RS ARE PROVIDED AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESSFOR A PARTICULARPURPOSE ANDNONINFRINGEMENT OR ARISINGFROM A COURSE OF DEALING, USAGE,OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks . Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnershiprelationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown
for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
2012 Cisco Systems, Inc. All rights reserved.
http://www.cisco.com/go/trademarkshttp://www.cisco.com/go/trademarkshttp://www.cisco.com/go/trademarkshttp://www.cisco.com/go/trademarks7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
3/40
C O N T E N T S
P r e f a c e Preface v
Conventions vi
Documentation and service requests vii
Documentation feedback vii
C H A P T E R 1 Before you install 1
About Cisco Finesse installation 1
Prerequisites and recommendations 1
Configuration worksheet 2
C H A P T E R 2 Installation 5
Installation files 5
Install Cisco Finesse on primary node 5
Install Cisco Finesse on secondary node 9
C H A P T E R 3 Upgrade 13
Perform upgrade 13
Perform rollback 15
C H A P T E R 4 Getting started after installation 17
Disable Cisco Security Agent 17
Configure CTI Server and Administration & Data Server settings 18
Restart Cisco Tomcat 19
Ensure agents have passwords 19
Agents sign in to Desktop 20
Configure DNS on clients 20
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) iii
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
4/40
C H A P T E R 5 Frequently asked questions 23
Can I install Cisco Finesse on something other than a virtual machine? 23
How do I access log files? 23How do I access the CLI? 23
Commands supported for Cisco Finesse 24
Log collection 24
Cisco Security Agent 25
Finesse services 25
Upgrade 26
Remote account management 26
Replication status 26
How do I uninstall? 27
How do I upgrade? 28
Ports used for Cisco Finesse 28
What accounts and passwords are defined during installation? 29
What if the installation fails? 29
What Unified CCE Peripheral Gateway Type is supported for Finesse? 30
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)iv
Contents
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
5/40
Preface
This guide explains how to install Cisco Finesse Release 9.0(1), and how to perform initial tasks so that
agents can sign in to the Finesse desktop.
This guide is prepared for system engineers and administrators who are responsible for the installation
ofand initial access toCisco Finesse.
A printed copy of this document might not represent the latest Cisco product information available. To
find out whether this guide has been updated for Release 9.0(1), you can locate the document and check
the cover date on Cisco.com at this URL: http://www.cisco.com/web/psa/products/index.html.
Note
ClickVoice and Unified Communications, then clickCustomer Collaboration, then clickCisco Unified
Contact Center Products, and then clickCisco Finesse.
In addition to this preface, this guide is arranged as follows:
CoversThis Chapter
An overview of Cisco Finesse
A configuration worksheet for gathering information needed for the
installation
Before you install
Obtaining the installation files
Completing the Installation Wizard configuration screens
A list of the processes that occur during the installation
Installing Cisco Finesse on a secondary node
Installation
Performing an upgrade
Performing a rollback
Upgrade
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) v
http://www.cisco.com/web/psa/products/index.htmlhttp://www.cisco.com/web/psa/products/index.html7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
6/40
CoversThis Chapter
Disabling Cisco Security Agent
Configuring system and database settings in the Administration Console
Restarting Cisco TomcatVerifying that agents have passwords in Cisco Unified Contact Center
Enterprise Configuration Manager
Signing in to the Finesse Agent Desktop
Getting started after installation
Tips and frequently asked questionsFrequently asked questions
Cisco Finesse User Guides are available on Cisco.com and include this installation guide, Release
Notes for Cisco Finesse Release 9.0(1), and the User Guide for the Cisco Finesse Administration and
Serviceability Consoles.
Direct your browser to http://www.cisco.com/web/psa/products/index.html .
ClickVoice and Unified Communications, then clickCustomer Collaboration, then click
Cisco Unified Contact Center Products, and then clickCisco Finesse.
Finesse Troubleshooting tips are at this location: http://docwiki.cisco.com/wiki/Troubleshooting_
Cisco_Finesse.
Conventions, page vi
Documentation and service requests, page vii
Documentation feedback, page vii
ConventionsThis manual uses the following conventions:
DescriptionConvention
Boldface font is used to indicate commands, such as user entries, keys,
buttons, and folder and submenu names. For example:
Choose Edit > Find.
ClickFinish.
boldface font
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)vi
Preface
Conventions
http://www.cisco.com/web/psa/products/index.htmlhttp://docwiki.cisco.com/wiki/Troubleshooting_Cisco_Finessehttp://docwiki.cisco.com/wiki/Troubleshooting_Cisco_Finessehttp://docwiki.cisco.com/wiki/Troubleshooting_Cisco_Finessehttp://docwiki.cisco.com/wiki/Troubleshooting_Cisco_Finessehttp://www.cisco.com/web/psa/products/index.html7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
7/40
DescriptionConvention
Italic font is used to indicate the following:
To introduce a new term. Example: A skill group is a collection
of agents who share similar skills.
For emphasis. Example: Do notuse the numerical naming
convention.
A syntax value that the user must replace. Example: IF (condition,
true-value, false-value)
A book title. Example: See the Cisco CRS Installation Guide.
italic font
Window font, such as Courier, is used for the following:
Text as it appears in code or that the window displays. Example:
Cisco Systems,Inc.
window font
Angle brackets are used to indicate the following:
For arguments where the context does not allow italic, such as
ASCII output.
A character string that the user enters but that does not appear on
the window such as a password.
< >
Documentation and service requestsFor information on obtaining documentation, submitting a service request, and gathering additional informationsee the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco
technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed
and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free
service and Cisco currently supports RSS version 2.0.
Documentation feedbackYou can provide comments about this document by sending email to the following address:
mailto:[email protected]
We appreciate your comments.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) vii
Preface
Documentation and service requests
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.htmlmailto:[email protected]:[email protected]://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
8/40
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)viii
Preface
Documentation feedback
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
9/40
C H A P T E R 1
Before you install
About Cisco Finesse installation, page 1
Prerequisites and recommendations, page 1
Configuration worksheet, page 2
About Cisco Finesse installationCisco Finesse is installed on a virtual machine as a primary or secondary node. The installation screens refer
to the primary node as the first node.
Finesse is installed on the Linux-based Unified Communications Operating System (OS). This system is an
appliance model or closed box developed by Cisco, which does not support navigation into, or manipulation
of, the file system.
Prerequisites and recommendationsBefore you proceed with the installation, note the following requirements and recommendations:
You must have access to a server on which you can install a virtual machine (VM) and you must be
familiar with VM installation. See http://cisco.com/go/uc-virtualizedfor information about supported
virtual machines and VMware requirements.
You must download the Finesse Open Virtual Appliance (OVA) template and its README.txt. You
deploy this template for the installation.
You must have access to a Network Time Protocol (NTP) server.
You must have a valid hostname and domain.
You must have a preconfigured default router.
You must have a preconfigured Domain Name Server (DNS) and have set up forward and reverse DNS
The Administration & Data Server database (AWDB) must be configured to use Windows authentication
The AWDB must be configured to use a Domain user.
You must ensure that the port is the same for the primary and backup Administration & Data Servers.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 1
http://cisco.com/go/uc-virtualizedhttp://cisco.com/go/uc-virtualized7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
10/40
If Cisco Unified Customer Voice Portal (Unified CVP) is used for queuing, configure Unified CVP to
support warm transfer and conference, as described in the section "Using the Warm Transfer feature
with SIP calls" in the Configuration and Administration Guide for Cisco Unified Customer Voice Portal
(http://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_installation_and_configuration_
guides_list.html) and the section "Network Transfer" in the Cisco Unified Customer Voice Portal Solution
Reference Network Design (http://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_implementation_design_guides_list.html).
The installation takes about an hour. For most of that time, it can run unattended.
On the installation configuration screens, note that many valuessuch as hostnames, user IDs, and
passwordsare case-sensitive.
Much of the installation requires no action on the part of the person who runs it. When user input is
required, use the following keyboard navigation and selection actions. (The installation wizard screens
do not recognize a mouse or a touchpad.)
Table 1: Installation Wizard Navigation
Press This KeyTo Do This
TabMove to the next field
Alt-TabMove to the previous field
SpacebarSelect an option
Up or Down Arrow keysScroll up or down a list
Tab to Back and press the SpacebarGo to the previous screen
Tab to Help and press the SpacebarGet information about a screen
Configuration worksheetUse this configuration worksheet to record network and password information that the basic installation
configuration wizard requires. Store this worksheet information for future reference.
Table 2: Configuration Worksheet
Your EntryConfiguration Data
__________________________
Hostname
The hostname cannot be
local host. The
hostname must be the
hostname of the server as
registered in the DNS.
Note
__________________________IP Address and Mask
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)2
Before you install
Configuration worksheet
http://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_installation_and_configuration_guides_list.htmlhttp://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_installation_and_configuration_guides_list.htmlhttp://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_implementation_design_guides_list.htmlhttp://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_implementation_design_guides_list.htmlhttp://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_implementation_design_guides_list.htmlhttp://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_implementation_design_guides_list.htmlhttp://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_installation_and_configuration_guides_list.htmlhttp://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_installation_and_configuration_guides_list.html7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
11/40
Your EntryConfiguration Data
__________________________Gateway (GW) Address
__________________________Primary DNS IP Address
__________________________Secondary DNS IP Address
(optional)
_________________________Domain
Administrator User ID: ________________________
Administrator User Password: _____________________
Administrator User credentials
(for more information, see What
accounts and passwords are
defined during installation?, on
page 29)
__________________________Timezone
Organization:__________________________
Unit:__________________________
Location:__________________________
State:__________________________
Country:__________________________
Certificate Information
NTP Server 1: __________________________
NTP Server 2: __________________________
NTP Server Host Name or IP
Address
Security Password: __________________________Database Access Security
Password
Application User ID: ________________________
Application User Password: _____________________
Application User credentials (for
more information, see What
accounts and passwords are
defined during installation?, on
page 29)
__________________________A Side CTI Server Hostname or
IP Address
__________________________A Side CTI Server Port
__________________________B Side CTI Server Hostname or
IP Address
__________________________B Side CTI Server Port
__________________________Peripheral ID (ID of the
CallManager PG)
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 3
Before you install
Configuration worksheet
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
12/40
Your EntryConfiguration Data
__________________________Primary Administration & Data
Server Hostname or IP Address
__________________________Backup Administration & DataServer Hostname or IP Address
__________________________Administration& Data Server Port
__________________________AWDB Domain
__________________________AWDB Name
__________________________Username to access the AWDB
This user must be a
Domain user.
Note
__________________________Password to access the AWDB
__________________________
__________________________
Hostname or IP address of the
secondary Finesse server
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)4
Before you install
Configuration worksheet
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
13/40
C H A P T E R 2
Installation
The installation for Cisco Finesse runs from an ISO image and uses an OVA template.
We strongly recommend that you install Finesse by configuring a DataStore ISO file on the virtual CD/DVD
drive of the target VM.
Note
Installation files, page 5
Install Cisco Finesse on primary node, page 5
Install Cisco Finesse on secondary node, page 9
Installation filesTo install Finesse, you must first obtain the following files:
Finesse_2000_agents_v9.0.1_vmv8.ova file
This file is the VM template file that you must deploy in your installation.
Finesse_2000_agents_v9.0.1_vmv8.ova.README.txtfile
This file contains the format that is supported by the OVA file, as well as the instructions for importing
it and for editing the virtual machine settings.
You must purchase the Finesse media kit to obtain the installer. For more information, see the Ordering Guide
(http://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/CCBU_
ordering_guide.pdf).
You can obtain the Cisco Virtual Server (OVA) files needed to create a virtual machine from Cisco.com.Direct your browser to the following URL: http://www.cisco.com/cisco/software/
type.html?mdfid=283613135&flowid=30701.
Install Cisco Finesse on primary nodePerform the following steps to install Cisco Finesse on a primary node:
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 5
http://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/CCBU_ordering_guide.pdfhttp://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/CCBU_ordering_guide.pdfhttp://www.cisco.com/cisco/software/type.html?mdfid=283613135&flowid=30701http://www.cisco.com/cisco/software/type.html?mdfid=283613135&flowid=30701http://www.cisco.com/cisco/software/type.html?mdfid=283613135&flowid=30701http://www.cisco.com/cisco/software/type.html?mdfid=283613135&flowid=30701http://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/CCBU_ordering_guide.pdfhttp://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/CCBU_ordering_guide.pdf7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
14/40
Procedure
Step 1 Follow the instructions in the OVA README.txt file to import and deploy the OVA, to edit VM settings,and to power on the VM and edit the BIOS settings in the Console.
Do not use Thin Provisioning or a VM snapshot when creating a VM to host Cisco Finesse. The use
of Thin Provisioning or snapshots can negatively impact the performance of Cisco Finesse operation.
Note
Messages appear while the preinstallation script runs. When the preinstallation script ends, the DVD Found
screen opens.
Step 2 Select Yes on the DVD Found screen to begin the verification of the media integrity and a brief hardwarecheck.
If the media check passes, select OKto open the Product Deployment Selection screen. Continue to Step 3.
If the media check fails, the installation terminates.
Step 3 The Product Deployment Selection screen states that the Cisco Finesse product suite will be installed. Thisscreen has only one choiceOK.
Select OKto open the Proceed with Install screen.
Step 4 The Proceed with Install screen shows the version of the product that is currently installed (if any) and theversion of the product for this ISO. For the initial installation, the version currently installed shows NONE.
Select Yes on the Proceed with Install screen to open the Platform Installation Wizard screen.
Step 5 On the Platform Installation Wizard screen, select Proceed to open the Basic Install screen.
Step 6 Select Continue at the Basic Install screen to launch the installation wizard.The Basic Install wizard launches a series of screens that present questions and options pertinent to the platform
and the setup configuration. Help is available for each wizard screen.
The first Basic Install wizard screen is Timezone Configuration.
Step 7 On the Timezone Configuration screen:
a) Use the up and down arrows to locate the local time zone that most closely matches your server location.You can also type the initial character of the time zone to move to that item in the list. The Timezone field
is based on country and city and is mandatory. Setting it incorrectly can affect system operation.
b) Select OKto open the Auto Negotiation Configuration screen.
Step 8 On the Auto Negotiation Configuration screen, select whether you want to use automatic negotiation for thesettings of the Ethernet network interface card (NIC).
ThenIf
Select Yes to open the MTU Configuration
screen.
Proceed to Step 9.
The Ethernet NIC attached to your hub or Ethernet switch
supports automatic negotiation.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)6
Installation
Install Cisco Finesse on primary node
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
15/40
ThenIf
Select No to open the NIC Speed and Duplex
Configuration screen, where you can manually
configure the settings as required for your
network.
Specify the speed of the NIC in megabits per
second. Speed options are 10 or100.
Specify the duplex setting of the server NIC.
Options are Full orHalf.
Select OKto proceed to Step 9.
You want to disable autonegotiation and specify NIC
speed and duplex settings.
Step 9 In the MTU Configuration screen, select No to keep the default setting for Maximum Transmission Units(1500).
Your selection of No opens the Static Network Configuration screen.
Step 10 On the Static Network Configuration screen, enter static network configuration values as follows, referringto the Configuration worksheet if necessary:
a) Enter the Host Name.
b) Enter the IP Address.
c) Enter the IP Mask.
d) Enter the GW Address.
e) Select OKto open the Domain Name System (DNS) Client Configuration screen.
Step 11 On the DNS Client Configuration screen, select Yes to specify the DNS client information.IMPORTANT: DNS client configuration is mandatory for Cisco Finesse. You must select Yes on this screen
If you select No, after the installation is complete, agents will notbe able to sign in to the desktop and you
will have to reinstall Finesse.
Step 12 Specify your DNS client information as follows, referring to the Configuration worksheet if necessary:
a) Enter the Primary DNS (mandatory).
b) Enter the Secondary DNS (optional).
c) Enter the Domain (mandatory).
d) Select OKto open the Administrator Login Configuration screen.
Step 13 On the Administrator Login Configuration screen:
a) Enter the credentials for the administrator. See What accounts and passwords are defined during installation?
for the permissions and responsibilities of this administrator.
b) Select OKto open the Certificate Information screen.
Step 14 On the Certificate Information screen:a) Enter data to create your Certificate Signing RequestOrganization, Unit, Location, State, and Country
b) Select OKto open the First Node Configuration screen.
Step 15 On the First Node Configuration screen, select Yes to indicate that you are configuring the first node.Your selection of Yes opens the Network Time Protocol Client Configuration screen.
Step 16 On the Network Time Protocol Client Configuration screen, enter the IP address, NTP server name, or NTPServer Pool name for at least one external NTP server.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 7
Installation
Install Cisco Finesse on primary node
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
16/40
You can add up to five external NTP servers. We recommend that you use a minimum of
two.
Note
Step 17 After you complete the NTP configuration, select OK. This action opens the Security Configuration screen.
Step 18 On the Security Configuration screen, enter the Database Access Security password, and then select OK.
Step 19 On the Application User Configuration screen, enter the credentials for the application username.See What accounts and passwords are defined during installation? for the permissions and responsibilities of
the application user.
Select OKto open the Platform Configuration Confirmation screen. This screen states that the platform
configuration is complete.
Step 20 On the Platform Configuration Confirmation screen, select OK.The installation begins.
The installation can take up to an hour to complete and can run unattended for most of that time.
During the installation, the monitor shows a series of processes, as follows:
Formatting progress bars
Copying File progress bar
Package Installation progress bars
Post Install progress bar
Populate RPM Archive progress bar
Application Installation progress bars (multiple Component Install screens, security checks)
An informational screen saying the system will reboot momentarily to continue the installation
If you see the following virtual machine question, select Yes, and then clickOK:
Figure 1: Virtual Machine message
A system reboot
Messages stream down your monitor during the reboot. Some of them prompt you to press a key. Do
notrespond to these prompts to press a key.
Application Pre Install progress bars
Configure and Setup Network progress bars
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)8
Installation
Install Cisco Finesse on primary node
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
17/40
If a Network Connectivity Failure screen appears during the Configure and Setup Network
process, clickReview, and then clickOKat the Errors screen. Follow the prompts to reenter
the information that caused the failure. The installation continues when the connection
information is complete.
Note
Security configuration
The installation ends at a login prompt.
The installation of Cisco Finesse has completed successfully.
Cisco Finesse login: _
What to Do Next
You must now complete the postinstallation tasks as described in Getting started after installation.
Your first postinstallation task is to Disable Cisco Security Agent.
Install Cisco Finesse on secondary nodeThe following procedure describes how to install Cisco Finesse on a secondary node.
You must install the version of Finesse on the secondary node that is installed on the primary node. Both
nodes must be running the same version.
We strongly recommend that you install Finesse by configuring a Datastore ISO file on the virtual CD/DVD
drive of the target VM.
Note
Before you perform this procedure, you must complete the following prerequisites:
Install the primary Finesse server, as described in the procedure Install Cisco Finesse on primary node
and complete the postinstallation tasks.
Use the Finesse Administration application on the primary Finesse server to configure the secondary
Finesse host in the Cluster Settings gadget. For more information, see the section Cluster settings of
the User Guide for the Cisco Finesse Administration and Serviceability Consoles.
Ensure that the DNS server has forward and reverse DNS set up for both the primary and secondary
node.
Finesse administration can only be performed on the primary Finesse server. After you install the secondaryserver, to perform configuration tasks (such as configuring reason codes or call variable layout), you must
sign in to the Administration Console on the primary server.
Note
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 9
Installation
Install Cisco Finesse on secondary node
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
18/40
Procedure
Step 1 Follow the instructions in the OVA README.txt file to import and deploy the OVA, to edit VM settings,and to power on the VM and edit the BIOS settings in the Console.
Messages appear while the preinstallation script runs. When the preinstallation script ends, the DVD Found
screen opens.
Step 2 Select Yes on the DVD Found screen to begin the verification of the media integrity and a brief hardwarecheck.
If the media check passes, select OKto open the Product Deployment Selection screen. Continue to Step 3.
If the media check fails, the installation terminates.
Step 3 The Product Deployment Selection screen states that the Cisco Finesse product suite will be installed. Thisscreen has only one choiceOK.
Select OKto open the Proceed with Install screen.
Step 4 The Proceed with Install screen shows the version of the product that is currently installed (if any) and the
version of the product for this ISO. For the initial installation, the version currently installed shows NONE.Select Yes on the Proceed with Install screen to open the Platform Installation Wizard screen.
Step 5 On the Platform Installation Wizard screen, select Proceed to open the Basic Install screen.
Step 6 Select Continue on the Basic Install screen to launch the installation wizard.The Basic Install wizard launches a series of screens that present questions and options pertinent to the platform
and the setup configuration. Help is available for each wizard screen.
The first Basic Install wizard screen is Timezone Configuration.
Step 7 In the Timezone Configuration screen:
a) Use the up and down arrows to locate the local time zone that most closely matches your server location.
You can also type the initial character of the time zone to move to that item in the list. The Timezone field
is based on country and city and is mandatory. Setting it incorrectly can affect system operation.b) Select OKto open the Auto Negotiation Configuration screen.
Step 8 On the Auto Negotiation Configuration screen, select whether you want to use automatic negotiation for thesettings of the Ethernet network interface card (NIC).
ThenIf
Select Yes to open the MTU Configuration
screen.
Proceed to Step 9.
The Ethernet NIC attached to your hub or Ethernet switch
supports automatic negotiation.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)10
Installation
Install Cisco Finesse on secondary node
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
19/40
ThenIf
Select No to open the NIC Speed and Duplex
Configuration screen, where you can manually
configure the settings as required for your
network.
Specify the speed of the NIC in megabits per
second. Speed options are 10 or100.
Specify the duplex setting of the server NIC.
Options are Full orHalf.
Select OKto proceed to Step 9.
You want to disable autonegotiation and specify NIC
speed and duplex settings
Step 9 On the MTU Configuration screen, select No to keep the default setting for Maximum Transmission Units(1500).
Your selection of No opens the Static Network Configuration screen.
Step 10 On the Static Network Configuration screen, enter static network configuration values as follows, referringto the Configuration worksheet if necessary:
a) Enter the Host Name.
b) Enter the IP Address.
c) Enter the IP Mask.
d) Enter the GW Address.
e) Select OKto open the Domain Name System (DNS) Client Configuration screen.
Step 11 On the DNS Client Configuration screen, select Yes to specify the DNS client information.IMPORTANT: DNS client configuration is mandatory for Cisco Finesse. You must select Yes on this screen
If you select No, after the installation is complete, agents will notbe able to sign in to the desktop and you
will have to reinstall Finesse.
Step 12 Specify your DNS client information as follows, referring to the Configuration worksheet if necessary:
a) Enter the Primary DNS (mandatory).
b) Enter the Secondary DNS (optional).
c) Enter the Domain (mandatory).
d) Select OKto open the Administrator Login Configuration screen.
Step 13 On the Administrator Login Configuration screen:
a) Enter the credentials for the administrator. See What accounts and passwords are defined during installation?
for the permissions and responsibilities of this administrator.
b) Select OKto open the Certificate Information screen.
Step 14 On the Certificate Information screen:a) Enter data to create your Certificate Signing RequestOrganization, Unit, Location, State, and Country
b) Select OKto open the First Node Configuration screen.
Step 15 On the First Node Configuration screen, select No to indicate that you are configuring the second node.A warning message appears indicating that you must first configure the server on the first node before you
can proceed. If you already configured the first node, select OK.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 11
Installation
Install Cisco Finesse on secondary node
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
20/40
Step 16 On the Network Connectivity Test Configuration screen, select No to proceed with the installation afterconnectivity is verified.
Step 17 On the First Node Configuration screen, specify the information about the first node as follows:
a) Enter the Host Name of the primary Finesse server.
b) Enter the IP Address of the primary Finesse server.c) Enter the Security Password of the primary Finesse server.
d) Confirm the Security Password.
Step 18 Select OKto open the Platform Configuration Confirmation screen.
Step 19 On the Platform Configuration Confirmation screen, select OK.The installation begins.
The installation can take up to an hour to complete and can run unattended for most of that time.
After the installation is complete, check the replication status to ensure it is functioning correctly. For more
information, see Replication status.
It can take 10 to 20 minutes to fully establish replication between the two nodes.Note
Next, you must disable Cisco Security Agent. For more information, see Disable Cisco Security Agent.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)12
Installation
Install Cisco Finesse on secondary node
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
21/40
C H A P T E R 3
Upgrade
If you have Cisco Finesse Release 8.5(3) installed, you can upgrade to Cisco Finesse Release 9.0(1).
Cisco Finesse Release 9.0(1) supports Unified Contact Center Enterprise (Unified CCE) 9.0(1) only. If you
upgrade Finesse to Release 9.0(1), you must also upgrade Unified CCE to Release 9.0(1).
You must perform a DRS backup before you perform this upgrade. If a problem occurs with the upgrade
and you need to roll back to the previous version, you need the DRS backup to restore your system. If
you do not use the backup to restore your system, replication to the second Finesse node breaks and cannot
be repaired.
Note
Perform upgrade, page 13
Perform rollback, page 15
Perform upgradeYou must perform these steps on the primary Finesse node first, and then on the secondary Finesse node.
Before You Begin
Perform a DRS backup. For more information, see the User Guide for the Cisco Finesse Administration
and Serviceability Consoles
(http://www.cisco.com/en/US/products/ps11324/products_user_guide_list.html).
You only need to perform DRS backup on the primary node.Note
Place the Cisco Finesse ISO file on an FTP or SFTP server that you can access from your Finesse system
or burn the ISO file to DVD.
Save your current layout configuration. Sign in to the Administration Console on the primary Finesse
node (http://IP address or hostname of primary Finesse server/cfadmin. Copy the layout XML file from
the Layout Settings gadget and save it as a text file on your local system.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 13
http://www.cisco.com/en/US/products/ps11324/products_user_guide_list.htmlhttp://www.cisco.com/en/US/products/ps11324/products_user_guide_list.html7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
22/40
If you are currently running the default layout, the layout is automatically upgraded to
the new layout. If you decide you would rather use the layout from the previous version,
you can upload the copy to the Layout Settings gadget after the upgrade is complete.
Note
Procedure
Step 1 SSH to your Finesse system and log in with the platform administration account.
Step 2 From the CLI, run the command utils system upgrade initiate.
Step 3 Follow the instructions provided by the utils system upgrade initiate command.If you choose to install from a remote source (FTP or SFTP server), provide the location and credentials for
the remote file system.
If you choose to install from the local CD/DVD drive, ensure the drive is connected to the Finesse virtual
machine (VM) as follows:
a) Right-click the VM and choose Edit Settings.
b) Click the Hardware tab.
c) In the left pane, select CD/DVD Drive.
d) In the right pane, under Device Status, check the Connected and Connect at power on check boxes.
e) Under Device Type, select Datastore ISO File.
f) ClickBrowse and navigate to the Finesse ISO file.
g) ClickOK.
h) In the left pane, select Network Adaptor.
i) In the right pane, under Device Status, check the Connect at power on check box.
j) Under Network Connection, select Public (orPrivate for a private connection).
k) Click the Options tab.
l) In the left pane, select Boot Options.
m) In the right pane, under Force BIOS Setup, check the The next time the virtual machine boots, force
entry into the BIOS setup screen check box.
n) ClickOK.
Step 4 At the Automatically switch versions if the upgrade is successful prompt, type yes to upgrade and switchversion, or type no to upgrade only without switching version.
The upgrade is not active until a switch version is
performed.
Note
Step 5 If you are installing from the local CD/DVD drive, when the upgrade enters the BIOS screen, on the Boottab, move CD-ROM Drive to the top, save your settings, and exit.
Step 6 After the upgrade is complete, disconnect the CD/DVD drive.
a) Right-click the VM and choose Edit Settings.
b) Click the Hardware tab.
c) Select CD/DVD Drive 1.
d) Uncheck the Connected and Connect at power on check boxes.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)14
Upgrade
Perform upgrade
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
23/40
e) ClickOK.
Step 7 Disable Cisco Security Agent (CSA). For more information, see Disable Cisco Security Agent.
Step 8 Sign in to the Finesse Agent Desktop to verify that the upgrade was successful (http://IP address or hostnameof Finesse server).
After Finesse restarts, wait approximately 20 minutes before you attempt to sign in to the desktop.Finesse services may take a few minutes to reach the STARTED state.
Note
Cisco Finesse Release 9.0(1) supports Unified CCE Release 9.0(1) only. If you upgrade Finesse to
Release 9.0(1), you must also upgrade Unified CCE to Release 9.0(1).
Note
What to Do Next
Upgrade the VMware on the primary and secondary Finesse nodes from version 7 to version 8. For more
information, see your VMware documentation.
Upgrade the VMware tools on both the primary and secondary Finesse nodes. For more information,
see your VMware documentation.
If you want to add the Queue Statistics gadget to the Finesse layout XML file, sign in to the AdministrationConsole on the primary Finesse node. On the Layout Settings gadget, add the following gadget tag to
the layout XML file where you want it to appear, and then click Submit:
http://localhost/desktop/gadgets/QueueStatistics.jsp
Restart Cisco Tomcat.
Perform rollbackIf a problem occurs with the upgrade, you can roll back to the earlier release.
Procedure
Step 1 Perform a switch-version on the primary node.
a) Access the CLI and enter the command utils system switch-version.
b) Enteryes to confirm.
The system attempts to switch back to the original version and reboots if the switch is successful.
Step 2 Perform a switch-version on the secondary node.
Step 3 Perform a DRS restore.Do not attempt to reset replication after you perform the switch-version. You must perform a DRS
restore. If you attempt to repair replication before you perform a DRS restore, the DRS restore will
not work correctly.
Note
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 15
Upgrade
Perform rollback
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
24/40
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)16
Upgrade
Perform rollback
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
25/40
C H A P T E R 4
Getting started after installation
You must complete the tasks in this chapter in the order in which they appear.Note
Disable Cisco Security Agent, page 17
Configure CTI Server and Administration & Data Server settings, page 18
Restart Cisco Tomcat, page 19
Ensure agents have passwords, page 19
Agents sign in to Desktop, page 20
Configure DNS on clients, page 20
Disable Cisco Security AgentYour first task after a successful installation is to run the command to disable Cisco Security Agent (CSA).
CSA prevents certain Finesse operations.
Procedure
Step 1 After the installation, you can access the CLI directly by signing in using the Administrator User credentialsdefined during the installation (for more information, see What accounts and passwords are defined during
installation? and How do I access the CLI?).
Step 2 Enter the following command: utils csa disable.
You see a message that the system needs to restart, and you are prompted to enter Yes.
Step 3 EnterYes to reboot.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 17
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
26/40
What to Do Next
Configure the CTI Server and Administration & Data Server settings.
Configure CTI Server and Administration & Data Server settingsYour second task after a successful installation is to configure CTI Server and Administration & Data Server
settings in the Administration Console. For more information about these settings, see the User Guide for the
Cisco Finesse Administration and Serviceability Consoles
(http://www.cisco.com/en/US/products/ps11324/products_user_guide_list.html).
After you restart Finesse, it can take approximately 6 minutes for all server-related services to restart.
Therefore, you should wait 6 minutes before you attempt to access the Administration Console on the
primary Finesse server.
Note
Procedure
Step 1 Direct your browser to the URL http://IP address or hostname of primary Finesse server/cfadmin.
Step 2 Sign in, using the Application User credentials (for more information, see What accounts and passwords aredefined during installation?).
Step 3 In the Contact Center Enterprise CTI Server Settings area, configure the following settings for the CTI server,referring to the Configuration worksheet if necessary:
a) A Side Host/IP Address
b) A Side Port (You can find this value on the title bar of the CG ctisvr process window.)c) Peripheral ID (This value is the ID of the CallManager PG.)
d) B Side Host/IP Address
e) B Side Port
Step 4 ClickSubmit.
Step 5 In the Contact Center Enterprise Administration & Data Server Settings area, configure the following settingsfor the Administration & Data Server and AWDB, referring to the Configuration worksheet if necessary:
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)18
Getting started after installation
Configure CTI Server and Administration & Data Server settings
http://www.cisco.com/en/US/products/ps11324/products_user_guide_list.htmlhttp://www.cisco.com/en/US/products/ps11324/products_user_guide_list.html7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
27/40
a) Primary Host/IP Address
b) Backup Host/IP Address (optional)
c) Database Port
d) AW Database Name (This value is the name of the AWDB, typically named _awdb.)
e) Domainf) Username
g) Password
Step 6 ClickSubmit.
Step 7 Sign out of the Administration Console.
Finesse does not support SQL authentication for connecting to the AWDB. Finesse requires that the
AWDB is configured to use Windows authentication.
Note
What to Do Next
Restart Cisco Tomcat.
Restart Cisco TomcatYour third task is to restart Cisco Tomcat.
Procedure
Step 1 Access the CLI and sign in using the Administrator User credentials defined during the installation (for moreinformation, see What accounts and passwords are defined during installation? and How do I access the CLI?)
Step 2 Enter the following command: utils service restart Cisco Tomcat.
Step 3 You can enter the command utils service list to monitor the Cisco Tomcat Service. After Cisco Tomcatchanges to STARTED, agents who have passwords can sign in to the desktop.
For more information about stopping and starting services, see Commands supported for Cisco Finesse.
Ensure agents have passwords
Agents who do not have a password defined in Unified CCE Configuration Manager cannot sign in to FinesseAgent password is an optional field in Unified CCE, but it is mandatory for Cisco Finesse.
For agents who do not have passwords, you must perform the following steps:
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 19
Getting started after installation
Restart Cisco Tomcat
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
28/40
Procedure
Step 1 Launch Unified CCE Configuration Manager.
Step 2 Locate the record for the agent (Agent Explorer > Agent tab).Step 3 Enter a password, and save the record.
Agents sign in to DesktopAfter the system administrator defines configuration settings, disables CSA, and restarts services, agents who
have passwords and operational handsets can sign in to the Finesse Agent Desktop by entering the following
URL in their browser:
http://hostname or IP address
where hostname or IP address is the hostname or IP address of their Finesse server.
After you restart Finesse, it can take approximately 6 minutes for all server-related services to restart.
Therefore, you should wait 6 minutes before you attempt to sign in to the Agent Desktop.
Note
Agents must enter their agent ID, password, and extension, and then click Sign In.
Figure 2: Desktop sign-in
Configure DNS on clients
This procedure is required for uncommon environments where non-hierarchical DNS configuration exists.
If your environment has hierarchical DNS configuration, you do not need to perform this procedure.
Note
Configuring DNS on client computers allows the clients to resolve the fully-qualified domain name (FQDN)
of the active Finesse server during a failover.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)20
Getting started after installation
Agents sign in to Desktop
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
29/40
Procedure
Step 1 Go to Control Panel > Network and Internet > Network Connections. (Open the Control Panel, enterNetwork Connections in the search bar, and then clickView network connections.)
On Windows XP clients, open Control Panel > Network Connections.
Step 2 Right-click the appropriate network connection and choose Properties.
Step 3 On the Networking tab, select Internet protocol version 4 (TCP/IPv4), and then clickProperties.On Windows XP clients, on the General tab, select Internet Protocol (TCP/IP), and then clickProperties
Step 4 ClickAdvanced.
Step 5 On the DNS tab, under DNS server addresses, in order of use, click Add.
Step 6 Enter the IP address of the DNS server that was entered during installation and click Add.
Step 7 If a secondary DNS was entered during installation, repeat Step 5 and Step 6 to add its IP address.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 21
Getting started after installation
Configure DNS on clients
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
30/40
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)22
Getting started after installation
Configure DNS on clients
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
31/40
C H A P T E R 5
Frequently asked questions
Can I install Cisco Finesse on something other than a virtual machine?, page 23
How do I access log files?, page 23
How do I access the CLI?, page 23
How do I uninstall?, page 27
How do I upgrade?, page 28
Ports used for Cisco Finesse, page 28
What accounts and passwords are defined during installation?, page 29
What if the installation fails?, page 29
What Unified CCE Peripheral Gateway Type is supported for Finesse?, page 30
Can I install Cisco Finesse on something other than a virtualmachine?
Although it is possible to install Cisco Finesse directly on a server, this type of installation is not a supported
deployment.
How do I access log files?
Finesse supports CLI commands for collecting log files. See Commands supported for Cisco Finesse.
How do I access the CLI?
The CLI provides a set of commands applicable to the operating system and to Cisco Finesse.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 23
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
32/40
These commands allow basic maintenance and failure recovery and also enable some system administration.
Although Finesse provides access to allCisco Unified Communications Manager CLIs, many commands are
not applicable to Finesse and most have not been validated for Finesse.
You can access the CLI directly, using the monitor and keyboard at the server console or by using SSH:
1 Enter the ID for the Administrator User account (the one created during installation).
2 When prompted, enter the password for the administrator user.
Commands supported for Cisco Finesse
Finesse supports the following CLI commands and has qualified their use. These commands prompt the user
to specify a secure FTP server location to which the files will be downloaded.
Log collection
To obtain logs:
Install log: file get install desktop-install.log
Use this command to see the installation log after the system is installed.
This log is written to the SFTP server and stored as a text file written to this path: \\install\desktop-install.log
Desktop logs: file get activelog desktop recurs compress
Use this command to obtain logs for the Finesse web applications. This command uploads a zip file that
contains the following directories:
webservices: This directory contains the logs for the Finesse backend that serves the Finesse APIs.
The maximum size of an uncompressed desktop log file is 100 MB. This directory holds a maximum
of 300 log files. After a log file reaches 100 MB, that file is compressed and a new log file is
generated. Output to the last compressed desktop log file wraps to the log file created next. The
log file wrap-up duration can vary, based on the number of users on the system. Timestamps are
placed in the file name of each desktop log.
finesseconfig: This directory contains the logs for the Finesse Config backend that serves the
Finesse Administration REST APIs. The maximum size of an uncompressed desktop log file is
100 MB. This directory holds a maximum of 300 log files. After a log file reaches 100 MB, that
file is compressed and a new log file is generated. Output to the last compressed desktop log file
wraps to the log file created next. The log file wrap-up duration can vary, based on the number of
users on the system. Timestamps are placed in the file name of each desktop log.
desktop: This directory contains logs from the Finesse gadget container that holds the Finesse
desktop gadgets. Any container-level errors with Finesse will appear in these log files.
admin: This directory contains logs from the Finesse Administration gadget container that holds
the administration gadgets. Any container-level errors with the Finesse Administration Console
will appear in these log files.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)24
Frequently asked questions
Commands supported for Cisco Finesse
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
33/40
clientlogs: This directory contains the client-side logs submitted from the Finesse Agent Desktop
to the Finesse server. Each log file is no larger than 1.5 MB and contains a timestamp and the agen
ID of the agent who submitted the file. A new log file is created each time an agent submits
client-side logs (the data is not appended to an existing log file). The maximum size of this directory
is 100 MB. When the directory reaches 100 MB, the oldest files are deleted to keep the size below
100 MB.
openfireservice: This directory contains startup and shutdown-related information logs for the
Cisco Finesse Notification Service.
openfire: This directory contains limited error and information logs for the Cisco Finesse
Notification Service.
Servm log: file get activelog platform/log/servm*.* compress
Use this command to obtain logs generated by the platform service manager that manages the starting
and stopping of the various Finesse services.
Note that the desktop and servm logs are compressed to one set of files.
Compressed logs are stored to the following path on the SFTP server: \\active_nnn.tgz, where nnn is timestamp in long format.
Platform Tomcat logs: file get activelog tomcat/logs recurs compress
VOS install log: file get install install.log
Log collection may fail when using the compress flag if there are a lot of log files. If collection fails, run
the command again without the compress flag.
Note
Cisco Security Agent
Run the following command to disable Cisco Security Agent (mandatory): utils csa disable
You must run this command after installation is complete to disable Cisco Security Agent (CSA). CSA prevent
some Finesse operations.
Finesse services
To view, start, or stop services:
To retrieve the status of services: utils service list
This command retrieves a list of all services and their status.
Services are shown in one of the following states: STOPPED, STARTING, or STARTED.
STOPPED means the service is not running. STARTING means the service is starting operation and
performing any necessary initialization. STARTED means the service has successfully initialized and
is operational.
To start a service: utils service start service name
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 25
Frequently asked questions
Commands supported for Cisco Finesse
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
34/40
This command starts the named service.
To stop a service: utils service stop service name
This command stops the named service.
To start Cisco Tomcat: utils service start Cisco Tomcat
To stop Cisco Tomcat: utils service stop Cisco Tomcat
To restart Cisco Tomcat: utils service restart Cisco Tomcat
If a Cisco Finesse service-related problem exists, we recommend a restart of a Finesse
service as a last resort. Most service-related problems cannot be corrected by restarting
a service. Restarting A Cisco DB is never recommended.
Note
Upgrade
Run the following command to install upgrades: utils system upgrade
This command allows you to install upgrades and Cisco Option Package (COP) files from both local and
remote directories.
Remote account management
Run the following command to enable, disable, create, and check the status of a remote access account: utils
remote_account
A remote account generates a pass phrase that allows Cisco support personnel to get access to the system forthe specified life of the account.
utils remote_account create account life
accountis the account name. life indicates the life of the account in days.
utils remote_account disable
utils remote_account enable
utils remote_account status
Replication status
To check replication status, run the following commands on the primary Finesse server:
utils dbreplication status
This command runs the replication status check in the background.
utils dbreplication runtimestate
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)26
Frequently asked questions
Commands supported for Cisco Finesse
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
35/40
This command returns the replication status on both the primary and secondary Finesse servers.
Check the RTMT counter value for replication. If all nodes in the cluster show a replication status of 2,
replication is functioning correctly.
Figure 3: Replication status
If the RTMT counter value for replication status is 3 or 4 for all nodes in the cluster, replication is set
up but an error occurred and replication is not functioning properly.
Run the command utils dbreplication status and check the output.
If mismatched rows appear in the output file, run the command utils dbreplication repair allfrom
the primary Finesse server.
If any node shows any replication value other than 1 or 2, replication is not set up correctly and you
must reset replication for that node.
If the majority of the nodes show a replication value of 0 or 1, run the command utils dbreplication
reset all from the primary Finesse server.
How do I uninstall?
You cannot uninstall software in a virtual environment. You can delete the VM and re-add it.
You do not need to uninstall a previous version of Finesse before you perform a fresh installation. The Finesse
server has two partitions: Active and Inactive. When you perform a fresh installation of Finesse, it installs on
the Active partition. If a previous version is already installed, the new version overwrites it.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 27
Frequently asked questions
How do I uninstall?
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
36/40
How do I upgrade?
Run the command utils system upgrade initiate. For more information, see Upgrade, on page 13.
Ports used for Cisco FinessePurposeRemote DeviceRemote
Protocol/PortServerProtocol/Port
Server orApplicationProtocol
Secure Port used by
Finesse Serviceability
Console
Secure Port used by
Finesse Administration
Console
for example, browserANYTCP 443, 8443Cisco Platform
Tomcat
Finesse Web Services
Finesse Administration
Console
Finesse Desktop
Modules (gadgets)
for example, browserANYTCP 80, 8080Cisco Platform
Tomcat
Finesse API and
Administration
Openfire
Foundation used to
make JDBC
connections with
Informix
SQL client (for example,
SQuirreL)
ANYTCP 1545Finesse database
(JDBC)
XMPP portANYTCP 5222Notification
Service XMPP
BOSH nonsecureANYTCP 7071Notification
Service BOSH
BOSH secureANYTCP 7443NotificationService BOSH
secure
SFTP and SSH accessANYTCP 22System Service
Network time syncANYUDP 123System Service
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)28
Frequently asked questions
How do I upgrade?
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
37/40
What accounts and passwords are defined during installation?
During the installation, you specify three passwords: the Administrator User, the Application User, and the
database access security password. All three must start with an alphabetic character, must be at least six
characters long, and can contain alphanumeric characters, hyphens, and underscores.
The Administrator User account
These are the credentials you enter to access the CLI.
The Application User account
These are the credentials you enter to access the Cisco Finesse Administration Console.
Database access security password
Keep a record of this password; you will need to use it if you replace or add a server in the future or if
you want to replace the old security password with a new one.
What if the installation fails?
If the installation fails, a screen appears that asks if you want to copy diagnostic information to a device.
Figure 4: Installation Failed screen
In this situation, you must reinstall from the beginning, but not until you attach a serial port to the VM. You
dump the install logs into the serial port of the VM.
For information about how to attach a serial port and dump the install logs, see the DocWiki page How to
Dump Install Logs to the Serial Port of the Virtual Machine .
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) 29
Frequently asked questions
What accounts and passwords are defined during installation?
http://docwiki.cisco.com/wiki/How_to_Dump_Install_Logs_to_the_Serial_Port_of_the_Virtual_Machinehttp://docwiki.cisco.com/wiki/How_to_Dump_Install_Logs_to_the_Serial_Port_of_the_Virtual_Machinehttp://docwiki.cisco.com/wiki/How_to_Dump_Install_Logs_to_the_Serial_Port_of_the_Virtual_Machinehttp://docwiki.cisco.com/wiki/How_to_Dump_Install_Logs_to_the_Serial_Port_of_the_Virtual_Machine7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
38/40
What Unified CCE Peripheral Gateway Type is supported forFinesse?
Cisco Finesse is supported on, and has been tested on, a Call Manager Peripheral Gateway (PG) and a Generic
PG.
Finesse is not supported on a System PG.
Finesse has not been tested on a System PG. On a System PG, assuming that a Voice Response Unit (VRU)
is also set up for queuing, Finesse would receive queuing events meant for the VRU.
With a Call Manager PG, the VRU is on a different peripheral. Finesse does not receive VRU queuing events.
Cisco Finesse Installation and Getting Started Guide Release 9.0(1)30
Frequently asked questions
What Unified CCE Peripheral Gateway Type is supported for Finesse?
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
39/40
I N D E X
A
administrator user 2, 5, 9, 23, 29
and Command Line Interface 23
configuring at installation 29
agent passwords 19
application user 2, 5, 18, 29and Finesse Administration Console 18
configuring at installation 29
auto-negotiation 5
autonegotiation 9
B
basic install wizard 1, 2, 5, 9
administrator user credentials 5, 9
application user credentials 5
auto-negotiation settings 5
autonegotiation settings 9case sensitivity 1
certificate information 5,9
configuration worksheet 2
DNS settings 5, 9
MTU setting 5, 9
network connectivity test configuration 9
network settings 5, 9
NIC speed and duplex settings 5, 9
NTP Client configuration 5
security configuration 5
timezone check 5, 9
user interface 1
C
case sensitivity 1
certificate information 2,5, 9
Cisco Finesse 1, 27
operating system 1
uninstalling 27
Cisco Finesse User Guides v
Cisco Security Agent 17, 25
CLI 17, 23, 24, 25
access to log files 23
administration user 23
command to disable Cisco Security Agent 25
command to obtain log files 24
commands supported for Finesse 23commands to start, stop, restart services 25
disable CSA 17
D
database settings 18
DNS servers 5,9
configuring at installation 5, 9
domain 5, 9
F
failure 29
of installation 29
Finesse Administration Console 18
Finesse Serviceability 19
G
gateway 5, 9
H
hostname 5, 9
I
installation 1, 5, 9, 23, 27, 29
downloading files 5
Cisco Finesse Installation and Getting Started Guide Release 9.0(1) IN-1
7/30/2019 CFIN BK I24DE3B4 00 Installation-And-getting-started-guide 2
40/40
installation (continued)
failure 29
length of 1, 5, 9
on virtual machine 23
processes 5
reboot during 5secondary node 9
uninstall 27
user accounts 29
user interface 1
VM Template 1
IP address and mask 5, 9
L
log files 23, 24
M
MTU 5, 9
N
navigation 23
in Command Line Interface 23
network settings 5, 9
NTP server 2
O
OVA file 1, 5
P
passwords 5, 29
application user 5
passwords (continued)
configured at installation 29
security 5, 29
peripheral gateway 30
PG supported 30
ports 28primary node 1
S
security password 2, 5, 29
server settings 18
servers 5, 9
DNS 5, 9
hostname 5, 9
IP address and mask 5, 9
services 19,25
CLI commands for 25
sign in 18, 20, 23
Finesse Agent Desktop 20
to Command Line Interface 23
to Finesse Administration Console 18
T
timezone 5, 9
U
uninstall 27
user accounts 29
V
virtual machines 1, 23
VM Template 1, 5
Index