Cisco IPICS Server Installation and
Upgrade Guide
Release 2.1(1)
Americas Headquarters
Cisco 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
Text Part Number: OL-12985-01
TTHE 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 SUPPLIERS 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, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT OR ARISING FROM 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.
CCVP, the Cisco logo, and the Cisco Square Bridge logo are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn
is a service mark of Cisco Systems, Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco,
the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity,
Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient,
IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream, Linksys, MeetingPlace, MGX, Networking
Academy, Network Registrar, Packet, PIX, ProConnect, ScriptShare, SMARTnet, StackWise, The Fastest Way to Increase Your Internet Quotient,
and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply
a partnership relationship between Cisco and any other company. (0705R)
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.
Cisco IPICS Server Installation and Upgrade Guide, Release 2.1(1)
Copyright © 2007 Cisco Systems, Inc. All rights reserved.
C O N T E N T S
Preface vii
Introduction vii
Audience vii
Organization viii
Related Documentation viii
Cisco Unified Communications Manager (CallManager) Documentation x
Cisco Unified Communications Manager Express Documentation x
Cisco 7800 Series Media Convergence Servers Documentation xi
Cisco Unified IP Phones 7900 Series Documentation xi
Session Initiation Protocol Documentation xi
Cisco Land Mobile Radio over IP/Solution Reference Network Design xi
Cisco Security Agent xii
Cisco IOS Documentation xii
Document Notes and Conventions xii
Obtaining Documentation, Obtaining Support, and Security Guidelines xiii
CHAPTER
1
Overview 1-1
Installation Overview 1-1
Installed Components 1-3
System Requirements 1-4
CHAPTER
2
Installing Cisco IPICS 2-1
Before You Begin 2-1
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
iii
Contents
Obtaining the IP Addresses for Your Cisco IPICS System 2-2
Preinstallation Checklist 2-3
Installing the Cisco IPICS Operating System 2-6
Installation Caveats for Cisco MCS 7825 Servers 2-7
Installing the Cisco IPICS Operating System Software 2-7
Installing the Cisco IPICS Server Software 2-16
Performing a Direct Cisco IPICS Server Software Installation 2-17
Performing a Remote Cisco IPICS Server Software Installation 2-21
Restarting or Shutting Down the Server 2-25
Preparing to Use Cisco IPICS 2-27
Checking the Installation 2-28
Managing Your Licenses and Certificates 2-29
Obtaining Your License File 2-30
Uploading the Cisco IPICS License Files 2-32
Viewing the License Summary Information 2-34
Tracking Your License Usage 2-35
Managing Time-Bound Licenses 2-37
Installing Third Party Certificates On the Cisco IPICS Server 2-40
Requesting a Third Party Certificate 2-40
Installing a Third Party Certificate 2-43
Generating the Cisco IPICS PMC Application Installer 2-45
CHAPTER
3
Upgrading Cisco IPICS 3-1
Before You Begin 3-1
Performing a Direct Cisco IPICS Server Software Upgrade 3-2
Performing a Remote Cisco IPICS Server Software Upgrade 3-5
CHAPTER
4
Uninstalling Cisco IPICS 4-1
Uninstalling the Cisco IPICS Server Software from the Server 4-2
Cisco IPICS Server Installation and Upgrade Guide
iv
OL-12985-01
Contents
Uninstalling the Cisco IPICS Server Software Remotely 4-3
CHAPTER
5
Troubleshooting Cisco IPICS Installation Issues 5-1
Cisco IPICS Cannot Detect the NIC During Installation 5-2
No Network Connectivity After Connecting the Ethernet Cable to Interface 1 on
the Server 5-6
The Cisco IPICS Operating System Detects Unsupported Hardware 5-7
The Server Cannot Allocate Partitions 5-7
Troubleshooting “Bad Interpreter: Permission Denied” Errors 5-8
Troubleshooting “Permission Denied” Errors 5-8
SSH Loses Connectivity While You Perform a Remote Server Software
Installation 5-9
You Cannot Connect to the Server By Using Your Browser 5-10
Cisco IPICS Displays an Authorization Error 5-15
GLOSSARY
INDEX
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
v
Contents
Cisco IPICS Server Installation and Upgrade Guide
vi
OL-12985-01
Preface
Introduction
The Cisco IPICS Server Installation and Upgrade Guide, Release 2.1(1) provides
you with the information that you need to install the Cisco IP Interoperability and
Collaboration System (hereafter referred to as Cisco IPICS) release 2.1(1)
software. System administrators should review the information in this document
to learn how to prepare for the Cisco IPICS server software installation and
recover from any errors that might occur during or after the installation.
Audience
The Cisco IPICS Server Installation and Upgrade Guide, Release 2.1(1) targets
system administrators who install, configure, operate, and upgrade the
Cisco IPICS operating system and the Cisco IPICS server software.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
vii
Preface
Organization
Organization
This document is organized as follows:
Chapter 1, “Overview”
The introduction provides an overview of
the Cisco IPICS software installation.
This chapter also includes information
about the system requirements for
Cisco IPICS.
Chapter 2, “Installing Cisco IPICS” This chapter describes the steps that you
need to follow to install the Cisco IPICS
operating system and the Cisco IPICS
server software and its components.
Chapter 3, “Upgrading
Cisco IPICS”
This chapter describes the steps that you
need to follow to upgrade the
Cisco IPICS server software.
Chapter 4, “Uninstalling
Cisco IPICS”
This chapter describes the steps that you
follow to uninstall the Cisco IPICS server
software.
Chapter 5, “Troubleshooting
Cisco IPICS Installation Issues”
This chapter includes troubleshooting
tips for server installation issues that you
may encounter.
Related Documentation
For more information about Cisco IPICS and the PMC application, refer to the
following documentation:
•
Cisco IPICS PMC Installation and User Guide, Release 2.1(1)—This
document describes how to install, configure, manage, and operate the
Cisco IPICS PMC application.
•
Cisco IPICS PMC Quick Start Reference Card, Release 2.1(1)—This
document provides tips and quick references for the most frequently used
procedures that a user can perform on the Cisco IPICS PMC.
Cisco IPICS Server Installation and Upgrade Guide
viii
OL-12985-01
Preface
Related Documentation
•
Cisco IPICS PMC Debug Reference Quick Start Card, Release 2.1(1)—This
document provides a quick reference for troubleshooting and debugging the
Cisco IPICS PMC.
•
Cisco IPICS PMC Command Line Interface, Release 2.1(1)—This document
describes the commands that you can use from the command line interface
(CLI) to obtain information or to change settings for the Cisco IPICS PMC.
•
Cisco IPICS Server Administration Guide, Release 2.1(1)—This document
contains information about the key configuration, operation, and
management tasks for the Cisco IPICS server.
•
Cisco IPICS Server Quick Start Guide, Release 2.1(1)—This document is a
condensed version of the Cisco IPICS Server Administration Guide to help
the administrator to quickly get started with Cisco IPICS.
•
Cisco IPICS Server Quick Start Reference Card, Release 2.1(1)—This
document provides tips, quick references, and usage guidelines for the
Cisco IPICS server.
•
Using Cisco IPICS on Your IP Phone Quick Start Reference Card, Release
2.1(1)—This document contains information about accessing Cisco IPICS
from your IP phone and tips and guidelines for using this service.
•
Using the Cisco IPICS TUI Quick Start Reference Card, Release
2.1(1)—This document describes the steps that you follow to dial in to, or
receive a call from, the policy engine telephony user interface (TUI) and
guidelines for using the system.
•
Cisco IPICS Radio and Tone Descriptor File Examples Reference Card,
Release 2.1(1)—This document contains examples of valid and invalid radio
control and signaling descriptor file entries and guidelines for creating these
entries.
•
Cisco IPICS Server Quick Start Installation Reference Card, Release
2.1(1)—This document provides tips and quick references for installing and
upgrading the Cisco IPICS server.
•
Cisco IPICS Troubleshooting Guide, Release 2.1(1)—This document
contains reference material about how to maintain and troubleshoot the
Cisco IPICS system.
•
Release Notes for Cisco IPICS Release 2.1(1)—This document contains a
description of the new and changed features, important notes, caveats, and
documentation updates for this release of Cisco IPICS.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
ix
Preface
Related Documentation
•
Solution Reference Network Design (SRND) for Cisco IPICS Release
2.1(1)— This document provides information about design considerations
and guidelines for deploying the Cisco IPICS solution.
•
Cisco IPICS Compatibility Matrix—This document contains information
about compatible hardware and software that is supported for use with
Cisco IPICS.
•
Cisco IPICS 2.1(1) Resources Card (Documentation Locator)—This
document provides a summary of the documentation that is available for this
release of Cisco IPICS.
To access the documentation suite for Cisco IPICS, refer to the following URL:
http://www.cisco.com/en/US/products/ ps7026/
tsd_products_support_series_home.html
Cisco Unified Communications Manager (CallManager)
Documentation
For information about Cisco Unified Communications Manager (CallManager),
refer to the documentation at this URL:
http://cisco.com/en/US/products/sw/voicesw/ps556/
tsd_products_support_series_home.html
Cisco Unified Communications Manager Express Documentation
For information about Cisco Unified Communications Manager Express, refer to
the documentation at this URL:
http://cisco.com/en/US/products/sw/voicesw/ps4625/
tsd_products_support_series_home.html
Cisco IPICS Server Installation and Upgrade Guide
x
OL-12985-01
Preface
Related Documentation
Cisco 7800 Series Media Convergence Servers Documentation
For information about Cisco 7800 Series Media Convergence Servers, refer to the
MCS data sheets at this URL:
http://www.cisco.com/en/US/products/hw/voiceapp/ps378/
products_data_sheets_list.html
Cisco Unified IP Phones 7900 Series Documentation
For information about Cisco Unified IP Phones, refer to the documentation at this
URL:
http://cisco.com/en/US/products/hw/phones/ps379
tsd_products_support_series_home.html
Session Initiation Protocol Documentation
The dial engine, which controls the dial-in and dial-out functionality of the policy
engine, uses the Session Initiation Protocol (SIP). For information about SIP, refer
to the documentation at this URL:
http://cisco.com/en/US/tech/tk652/tk701/tk587/
tsd_technology_support_sub-protocol_home.html
Cisco Land Mobile Radio over IP/Solution Reference Network
Design
For information about Cisco Land Mobile Radio (LMR) over IP, refer to the
documentation at the following URLs:
•
http://www.cisco.com/en/US/products/ps6441/
products_feature_guide09186a00801f092c.html
•
http://www.cisco.com/en/US/products/sw/iosswrel/ps5207/
products_implementation_design_guide_book09186a0080347c1b.html
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
xi
Preface
Document Notes and Conventions
Cisco Security Agent
For information about Cisco Security Agent, refer to the documentation at this
URL:
http://www.cisco.com/en/US/products/sw/secursw/ps5057/index.html
Cisco IOS Documentation
The Cisco IOS software documentation set describes the tasks and commands
necessary to configure certain system components and other Cisco products, such
as access servers, routers, and switches. Each configuration guide can be used in
conjunction with its corresponding command reference.
For information about Cisco IOS software configuration, refer to the
documentation at this URL:
http://www.cisco.com/en/US/products/sw/iosswrel/
products_ios_cisco_ios_software_category_home.html
Document Notes and Conventions
This document uses the following conventions for instructions and information:
Note
Caution
Means reader take note. Notes contain helpful suggestions or references to
materials not contained in this manual.
This caution symbol means reader be careful. In this situation, you might do
something that could result in equipment damage or loss of data.
Cisco IPICS Server Installation and Upgrade Guide
xii
OL-12985-01
Preface
Obtaining Documentation, Obtaining Support, and Security Guidelines
Table 1
Conventions
Convention
Description
boldface font
Commands and keywords appear in boldface.
italic font
Command input for which you supply the values
appear in italics.
[
]
Optional keywords and default responses to system
prompts appear within square brackets.
{x | x | x}
A choice of keywords (represented by x) appears in
braces separated by vertical bars. You must select
one.
string
A nonquoted set of characters. Do not use quotation
marks around the string or the string will include the
quotation marks.
^ or Ctrl
Represent the key labeled Control. For example,
when you read ^D or Ctrl-D, you should hold down
the Control key while you press the D key.
screen
font
boldface screen
font
italic screen font
Examples of information displayed on the screen.
Information that you must enter is in boldface
screen font.
Arguments for which you supply values are in italic
screen font.
Obtaining Documentation, Obtaining Support, and
Security Guidelines
For information on obtaining documentation, obtaining support, providing
documentation feedback, security guidelines, and also recommended aliases and
general Cisco documents, see 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
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
xiii
Preface
Obtaining Documentation, Obtaining Support, and Security Guidelines
Cisco IPICS Server Installation and Upgrade Guide
xiv
OL-12985-01
CH A P T E R
1
Overview
This chapter provides an overview of the Cisco IPICS software installation. It also
contains information about system requirements for the Cisco IPICS server
software and the Push-to-Talk Management Center (hereafter referred to as PMC)
application.
This chapter includes the following sections:
•
Installation Overview, page 1-1
•
Installed Components, page 1-3
•
System Requirements, page 1-4
Installation Overview
The Cisco IPICS software is installed on supported Cisco Media Convergence
Servers (MCS). The installation process includes the installation of the
Cisco IPICS operating system and then the Cisco IPICS server software. All of
the software that you need for Cisco IPICS is included in the installation package.
You can perform the Cisco IPICS operating system software and Cisco IPICS
server software installations in the same session, or you can install the operating
system software in one session and then install the server software at a later time.
The software that installs the Cisco IPICS operating system and Cisco IPICS
server software is mostly automated, but it does require some user interaction to
complete.
Table 1-1 describes the steps that you need to perform to set up the installation of
the Cisco IPICS operating system software.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
1-1
Chapter 1
Overview
Installation Overview
Table 1-1
Cisco IPICS Operating System Setup
Step
Description
1.
Cisco IPICS operating system setup
utility
This procedure allows you to disable default features
that may be incompatible with the Cisco IPICS
operating system.
2.
Cisco IPICS operating system
installation
This procedure overwrites the hard drive and installs
files on the server. A progress window displays as the
files are being installed.
3.
GRUB bootloader
This procedure loads the operating system image in a
process that is called firstboot. The Cisco IPICS
operating system runs firstboot only once, just after the
operating system is installed for the first time. You do
not interact with the GRUB bootloader.
4.
Kudzu hardware detection utility
This procedure configures the Intel Serial ATA (SATA)
controller. Depending on the server hardware that you
use, the Kudzu utility also performs initial hardware
detection of the Ethernet interfaces so that you can
configure them later for IP connectivity.
5.
Password creation for the root user
This procedure allows you to set the password for the
root user, who has access to all the commands and files
in the Cisco IPICS server.
6.
IP connectivity setup
This procedure allows you to set the IP addresses for the
Ethernet interfaces, the Domain Name System (DNS)
information, and the system date and time.
7.
Root user login
This procedure allows you to log in to the Cisco IPICS
server as the root user and check network connectivity.
For more information about the steps that you need to follow to install the
Cisco IPICS operating system software, see the “Installing the Cisco IPICS
Operating System” section on page 2-6.
Table 1-2 describes the steps that you need to perform to set up the installation of
the Cisco IPICS server software.
Cisco IPICS Server Installation and Upgrade Guide
1-2
OL-12985-01
Chapter 1
Overview
Installed Components
Table 1-2
Cisco IPICS Server Software Setup
Step
Description
1.
End user license agreement
This window displays the end user license agreement for
the Cisco IPICS server software. You must accept this
agreement to continue with the installation.
2.
Password creation for the ipics user
This procedure permits you to create a password for the
ipics user, who performs all administrative tasks in the
Cisco IPICS Administration Console.
3.
Password creation for the ipicsadmin
user
This procedure enables you to create a password for the
ipicsadmin user, who has the Cisco IPICS operating
system privileges that are related to the database server
files and folders.
4.
Package installation
This window displays the progress of the installation and
the Cisco IPICS files that the installer writes to the
server. This installation also installs the Cisco IPICS
policy engine (hereafter referred to as policy engine).
5.
Uninstaller creation
This procedure creates a utility to uninstall the
Cisco IPICS software.
6.
Option to restart the server
This procedure allows you to choose between restarting
the server immediately or at a later time.
For more information about the steps that you need to follow to install the
Cisco IPICS server software, see the “Installing the Cisco IPICS Server
Software” section on page 2-16.
Installed Components
The Cisco IPICS installation includes the Cisco IPICS server software, version
2.1(1), with the following components:
•
Cisco IPICS Administration Console (Cisco IPICS version 2.1(1))
•
Cisco IPICS Data Store (IBM Informix Dynamic Server)
•
Cisco IPICS Web Application Server (tomcat service)
•
Cisco Security Agent (CSA)
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
1-3
Chapter 1
Overview
System Requirements
System Requirements
Refer to the Cisco IPICS Compatibility Matrix for the list of hardware and
software components that Cisco supports for use with Cisco IPICS.
Cisco IPICS Server Installation and Upgrade Guide
1-4
OL-12985-01
CH A P T E R
2
Installing Cisco IPICS
This chapter describes the procedures that you need to follow to install the
Cisco IPICS operating system and the Cisco IPICS server software.
This chapter includes the following sections:
•
Before You Begin, page 2-1
•
Installing the Cisco IPICS Operating System, page 2-6
•
Installing the Cisco IPICS Server Software, page 2-16
•
Restarting or Shutting Down the Server, page 2-25
•
Preparing to Use Cisco IPICS, page 2-27
Before You Begin
This section describes the activities that you must follow to prepare for the
Cisco IPICS operating system and server installations and includes the following
topics:
•
Obtaining the IP Addresses for Your Cisco IPICS System, page 2-2
•
Preinstallation Checklist, page 2-3
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-1
Chapter 2
Installing Cisco IPICS
Before You Begin
Obtaining the IP Addresses for Your Cisco IPICS System
To facilitate communications between your users, your Cisco IPICS system
requires a pool of IP addresses that can be reached by all users in your network
domain.
The Cisco IPICS server requires a static, local IP address that is advertised on the
network. Cisco IPICS end points, such as the PMC or Cisco Unified IP Phone,
must have the static address of the Cisco IPICS server to maintain
communications.
Because Cisco IPICS converts analog push-to-talk (PTT) radio traffic to IP traffic,
each radio channel gets mapped to an IP multicast address. Similarly, in
hoot’n’holler systems, each talk group gets mapped to an IP multicast address.
Users on IP-connected devices, such as the PMC, can participate in these channels
by connecting via a multicast IP address or by using a unicast remote connection
through the Session Initiation Protocol (SIP).
Cisco IPICS requires a multicast address for each of the following activities:
•
Creating a PTT channel
•
Creating a talk group in a hoot’n’holler system
•
Activating a virtual talk group (VTG)
•
Connecting a dial user into a channel or VTG
For ease of allocating IP addresses, it is helpful to obtain a subnet of IP addresses
from which you can configure the devices that are part of that subnet.
Cisco IPICS also requires an IP address for the loopback interface for the router
media service (RMS). A loopback interface consists of two T1/E1 interfaces on
the RMS that are connected by a short cable called a loopback cable. A loopback
interface is used for voice signaling and media for any SIP-based connections
with Cisco IPICS.
Note
Cisco recommends that you specifically configure the Loopback0 interface when
there is more than one IP path to the RMS. However, you may configure an
interface other than Loopback0 if specific criteria are met. For details about this
criteria, refer to the “Configuring the Cisco IPICS RMS Component” appendix in
the Cisco IPICS Server Administration Guide, Release 2.1(1).
Cisco IPICS Server Installation and Upgrade Guide
2-2
OL-12985-01
Chapter 2
Installing Cisco IPICS
Before You Begin
Consult your network administrator to obtain IP addresses for the Cisco IPICS
system, channels, VTGs, and the RMS.
For information about configuring and using IP addresses with Cisco IPICS, and
for more information about the RMS, refer to the “Configuring the Cisco IPICS
RMS Component” appendix in the Cisco IPICS Server Administration Guide,
Release 2.1(1).
Preinstallation Checklist
Before you begin the installation, make sure that you perform the following tasks:
Preinstallation Tasks
Checkoff
Check that you have both CDs from the Cisco IPICS installation
package.
Check that the power cords on your server and monitor are securely
attached and plugged in to a power source.
Attach an Ethernet network cable to the Ethernet 0 (eth0) port on
your server.
Note
You must connect your network cable to the eth0 interface on
your server. Generally, for servers that label their Ethernet
interfaces as NIC 1 and NIC 2, connect the Ethernet cable to
the NIC 1 interface; this interface is usually the eth0
interface. For servers that label their Ethernet interfaces as 1
and 2, consult the product documentation that you received
with your server to determine how the server labels its
interfaces. In all cases, it is a good practice to verify the
location of the eth0 interface on your specific server before
you proceed.
Make sure that you have at least 160 GB of hard disk space available
in your Cisco IPICS server.
Cisco strongly recommends that you attach an uninterruptible power
supply (UPS) to your system and ensure that the UPS is operating
correctly.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-3
Chapter 2
Installing Cisco IPICS
Before You Begin
Preinstallation Tasks (continued)
Checkoff
Check that your monitor cable connector is appropriate for the
connector on the server. Video Graphics Array (VGA) analog and
VGA digital are common connector types, but are not compatible
with each other without the proper adapter.
Before you begin the installation process, check the power settings
on your monitor to make sure that the display is not configured with
any timeout values.
Note
If your display times out while you are performing the
installation and you can no longer see the progress on your
monitor, move your mouse to restore the display. Make sure
that you do not press any keys on the keyboard in an effort to
restore your display. Pressing keys without being able to
view the information that displays on your monitor can cause
undesirable results.
Ensure that you have obtained the IP address, subnet mask, default
gateway, and DNS server (optional) information for the Cisco IPICS
server from your network administrator.
Check that you have obtained the Media Access Control (MAC)
address for the eth0 interface of the Cisco IPICS server. Cisco IPICS
uses the MAC address of the server to validate the Cisco IPICS
license. For information about how to obtain the MAC address, see
Step 30 in the “Installing the Cisco IPICS Operating System
Software” section on page 2-7.
Note
In a system with multiple network interface cards (NICs),
Cisco IPICS always uses the eth0 MAC address to validate
the license, even if eth0 is disabled.
Cisco IPICS Server Installation and Upgrade Guide
2-4
OL-12985-01
Chapter 2
Installing Cisco IPICS
Before You Begin
Preinstallation Tasks (continued)
Checkoff
If your network uses the Network Time Protocol (NTP), obtain the
IP address or DNS name of the NTP server.
Note
You can configure NTP when you install the Cisco IPICS
operating system software, or you can configure NTP after
you install the Cisco IPICS software by using the ntpsetup
command. For information about the ntpsetup command,
refer to the “Configuring NTP on the Cisco IPICS Server
with the ntpsetup Tool” section in the “Using the
Cisco IPICS CLI Tools and Service Commands” chapter in
the Cisco IPICS Troubleshooting Guide, Release 2.1(1).
You can install a third party certificate to replace the Cisco IPICS
self-signed certificate. For more information about installing third
party certificates, see the “Installing Third Party Certificates On the
Cisco IPICS Server” section on page 2-40. A third-party certificate
is not required for use with Cisco IPICS.
To ensure the functionality of Cisco IPICS, you should also perform the following
tasks either before or after you install Cisco IPICS:
Tasks
Checkoff
Ensure that you have obtained multicast IP addresses for channels
and VTGs. (If you do not have access to this information, contact
your system administrator.)
Check to make sure that the T1/E1 interfaces on the RMS are
connected via a loopback cable. This cable is a short-length
crossover cable with the following pinouts: 1-4, 2-5, 4-1, 5-2. One
end of the cable is attached to each of the RJ-45 connectors on the
T1/E1 interfaces for the RMS device. The connected interfaces are
used for voice signaling and media for any SIP-based connections
with Cisco IPICS. If you do not have a crossover cable, contact your
authorized Cisco support representative for assistance to obtain one.
Ensure that you have obtained an address for the RMS interfaces that
are connected by a loopback cable. (If you do not have access to this
information, contact your system administrator.)
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-5
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
If you use the Cisco IPICS dial engine, which controls dial-in and dial-out
functionality, ensure that you complete the following tasks before you use the dial
engine:
Tasks
Checkoff
Ensure that you have the IP address, SIP listening port, and preferred
transport type of your SIP provider. Support for SIP-based dial
functionality is provided via Cisco Unified Communications
Manager or a Cisco router that runs a supported version of Cisco IOS
and Cisco Unified Communications Manager Express as the SIP
provider. The policy engine requires that a SIP provider be
configured in the customer network.
For information about configuring a SIP provider, refer to the
Cisco IPICS Server Administration Guide, Release 2.1(1).
If your SIP provider is Cisco Unified Communications Manager,
determine the authentication credentials that Cisco IPICS uses when
it initiates a call into Cisco Unified Communications Manager.
Authentication is not required with Cisco Unified Communications
Manager Express.
Be sure that your SIP provider uses a supported version of
Cisco Unified Communications Manager, Cisco IOS, and/or
Cisco Unified Communications Manager Express. Refer to the
Cisco IPICS Compatibility Matrix for the most updated list of
supported hardware and software for use with Cisco IPICS.
Determine how your Cisco IPICS system fits into the dial plan of
your SIP provider. For example, determine the range of directory
numbers (DNs) that must be routed from the SIP provider to the
Cisco IPICS system.
Installing the Cisco IPICS Operating System
This section describes the steps that you need to follow to install the Cisco IPICS
operating system. This section includes the following topics:
•
Installation Caveats for Cisco MCS 7825 Servers, page 2-7
•
Installing the Cisco IPICS Operating System Software, page 2-7
Cisco IPICS Server Installation and Upgrade Guide
2-6
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
Installation Caveats for Cisco MCS 7825 Servers
Be aware of the following caveats when you install the Cisco IPICS operating
system on Cisco MCS 7825 servers:
•
Cisco IPICS does not support a Redundant Array of Disks (RAID) on
Cisco MCS 7825 servers. If RAID is enabled on your Cisco MCS 7825
server, make sure that you disable it before you install the operating system.
•
When you install the Cisco IPICS operating system on Cisco MCS 7825-H1
and Cisco MCS 7825-H2 servers, you must disable both the Serial ATA
(SATA) controller option and the Virtual Install Disk option to disable RAID.
You do not need to take this action when you install the operating system on
Cisco MCS 7845 servers because Cisco IPICS supports RAID on these
servers.
To disable RAID, the Serial ATA controller option and the Virtual Install Disk
option, follow Step 3 in the procedure that is documented in the “Installing the
Cisco IPICS Operating System Software” section on page 2-7.
Installing the Cisco IPICS Operating System Software
To install the Cisco IPICS operating system software, perform the following
procedure.
Procedure
Step 1
Turn the server on by pushing the power button that is located on the front panel
of the server.
Step 2
Place the Cisco IPICS operating system installation CD into the server disk drive.
The system begins to boot.
If you are installing the Cisco IPICS operating system on a Cisco MCS 7825-H1
or Cisco MCS 7825-H2 server, you must disable the embedded SATA software
RAID and the Virtual Install Disk option.
Continue to Step 3 for the steps to disable these features on these model servers.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-7
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
Note
If you are installing Cisco IPICS on another Cisco MCS 7825 server,
consult the product documentation that you received with your server to
determine if RAID is enabled and the steps that you perform to disable it.
If you are installing the Cisco IPICS operating system on a Cisco MCS 7845
server, you do not have to disable these features and can proceed to Step 5.
Step 3
Enter the System Maintenance menu by following these steps:
a.
Listen closely to the sounds that you hear from the server and watch your
monitor as the server boots.
b.
When you hear the server beep and see the message, “Press F10 key to enter
System Maintenance Menu,” press F10.
The System Maintenance menu displays with the following choices:
– Setup Utility—This menu provides access to configuration utilities from
which you can change settings for server components, such as the
embedded SATA software RAID and the Virtual Install Disk.
– Inspect Utility—This menu provides access to statistical information
about the server and its components, such as PCI Device Info and a
System Memory Map.
– Diagnostic Utility—This menu includes utilities that you can use to
perform diagnostic tests on the server, such as a memory test or a CPU
test.
Step 4
Enter the Setup Utility by choosing Setup Utility from the System Maintenance
menu; then, press Enter.
The Setup Utility displays.
a.
From the Setup Utility menu, press the Down Arrow key to highlight
Advanced Options; then, press Enter.
The Advanced Options menu displays.
b.
Press the Down Arrow key to highlight Virtual Install Disk.
When you highlight Virtual Install Disk, the current status displays below the
menu.
Cisco IPICS Server Installation and Upgrade Guide
2-8
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
c.
Perform one of the following actions, depending on the status of the Virtual
Install Disk:
– If the status displays as Disabled, go to Step e.
– If the status displays as Enabled, change the Configuration Selection. To
change the selection, press Enter to open the menu; then, press the Down
Arrow key to select and highlight Disabled.
d.
Press Enter to confirm your choice.
The Virtual Install Disk setting displays as Disabled.
e.
From the Advanced Options Menu, press the Down Arrow key to select and
highlight either Embedded SATA RAID or Sata Software Raid (the
wording of the SATA RAID option differs depending on your server
hardware).
The current status displays below the menu.
f.
If the status displays as Disabled, go to Step h.
If the Embedded SATA RAID or Sata Software Raid status displays as
Enabled, press Enter to open the menu; then, press the Down Arrow key to
select and highlight Disabled.
g.
Press Enter to confirm your choice.
h.
Press Esc twice to close the menus and exit the utility.
i.
Press the F10 key to confirm that you want to exit and save your changes.
Note
If you press any other key besides F10, the system returns to the Setup
Utility Main menu. In this case, you must repeat the Setup Utility steps
that begin with Step 4.
The server begins to boot from the CD. This time, when the system beeps, let
it continue to boot from the CD.
The Cisco IPICS operating system installation displays the CD version of the
Cisco IPICS operating system and the option to overwrite the hard drive.
Step 5
To overwrite the hard drive and install the Cisco IPICS operating system files,
perform these steps:
a.
When the system prompts you to overwrite the hard drive, enter Y; then, press
Enter.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-9
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
Note
Do not press any keys, including the SysRq key, during the installation.
Pressing the SysRq key causes a kernel panic condition on your server,
which requires a hard reboot to fix.
The Cisco IPICS operating system Installation Progress window displays the
progress of the installation. The operating system installer formats the file
system and installs the software packages.
Note
After the package installation completes, the window may appear
unresponsive or the screen may become blank. Wait while the system
completes the background security processes.
The server ejects the installation CD and the Installation Complete window
displays.
b.
Note
c.
Note
Remove the CD from the drive.
Keep your installation CD in a safe location in the event that you need to
reinstall the operating system.
To view the technical information that relates to this release of the
Cisco IPICS operating system, click Release Notes or press Alt+R.
If your mouse begins to move erratically across your display, it may be
due to the operating system loading an incorrect driver for your mouse. If
you encounter this situation and it affects your ability to navigate with
your mouse, use the keyboard shortcuts to perform Step c through Step e.
Although the status window indicates that the installation is complete, you
must complete several more tasks before you can install the Cisco IPICS
server software. Make sure that you perform the remaining steps in this
procedure to complete the Cisco IPICS operating system configuration.
d.
To close the window for the Release Notes, click X or press Alt+C.
The Release Notes window closes.
e.
To close the window and reboot the server, click Exit or press Alt+E.
Cisco IPICS Server Installation and Upgrade Guide
2-10
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
The server reboots.
During the bootup process, a GRUB window displays with the Cisco IPICS
software installation highlighted.
Step 6
After the GRUB window displays, press Enter to continue with the boot process.
Alternatively, you can take no action and let the window time out.
One of the following windows displays:
Step 7
•
The system displays the window for the Kudzu hardware detection utility.
This utility detects, and allows you to configure, new hardware during the
Cisco IPICS operating system installation.
•
The system displays the Welcome window. You enter network configuration
information for Cisco IPICS in the series of windows that follow the
Welcome window.
If the Kudzu hardware detection utility window displays, press any key.
Note
Step 8
You must press a key within 3,600 seconds (one hour) or the Kudzu
window times out. If the Kudzu window times out, you must rerun the
Kudzu hardware detection utility after you complete the initial
installation process. See the “Cisco IPICS Cannot Detect the NIC During
Installation” section on page 5-2 for more information about how to rerun
the Kudzu hardware detection utility.
Perform the following steps, depending on the window that the system displays:
Note
•
The installer may display different windows depending on the hardware
platform that you use. The first time that the installer prompts you to
configure the eth0 interface, you must choose the Dynamic Host
Configuration Protocol (DHCP), as described in Step 10. This step is
required to ensure that the appropriate driver is installed. Then, you must
overwrite the DHCP configuration with a static IP address for the eth0
interface, as described in Step 19. If the installer prompts you to configure
the eth1 interface, make sure that you choose the Ignore the device
option. Cisco IPICS does not support the use of the eth1 interface.
If a window displays to indicate that the system added a NIC, continue with
Step 9 to configure the eth0 interface.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-11
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
Note
Step 9
You must configure the eth0 interface to enable network connectivity to
the server.
•
If a window displays to indicate that the system detected either an Intel SATA
controller or an Intel IDE controller, proceed to Step 14.
•
If the Welcome window displays, proceed to Step 15.
Press Enter to choose the Configure option from the following list of options:
•
Configure— Choose this option to configure the NIC that controls the eth0
interface. This option specifies the default.
•
Ignore the device—Choose this option if you do not have hardware that
needs to be added to the server.
•
Do nothing—Choose this option if you do not want to configure the
hardware. If you reboot the server, the hardware configuration utility detects
the hardware as being newly installed, and the server prompts you to
configure it.
The Cisco IPICS operating system configuration program displays the interface
configuration window.
Step 10
Press the Spacebar to choose Use dynamic IP/configuration (BOOTP/DHCP).
An asterisk displays in the check box area to indicate that you have chosen to use
DHCP.
Note
This step allows the Cisco IPICS operating system to detect the NIC that
controls the eth0 interface on your server and install the appropriate driver
for the interface. Cisco IPICS does not use DHCP. You must use a static
IP address to configure your Cisco IPICS server for network connectivity.
You perform the static IP configuration steps in the Network Setup
window as described in Step 19.
Step 11
Press Tab or use the left and right arrows to choose OK.
Step 12
To accept your choice, press Enter.
Step 13
If the operating system configuration program displays a second window that
indicates that the Cisco IPICS operating system detected another NIC, perform
the following actions to ignore the configuration for the eth1 interface:
Cisco IPICS Server Installation and Upgrade Guide
2-12
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
a. Press Tab to choose Ignore.
b. Press Enter to confirm.
Note
Make sure that you do not configure the eth1 interface. Cisco IPICS
does not support the configuration of the eth1 interface.
The Cisco IPICS operating system configuration program continues
without configuring the eth1 interface, and displays a window indicating
that it detected an Intel controller.
Step 14
If the system displays a window to indicate that it detected either an Intel SATA
controller or an Intel IDE controller, press Enter to accept the Configure option
and configure the controller.
The system automatically configures the controller.
A Cisco IPICS operating system Welcome window displays.
Step 15
At the Welcome window, click Next.
The Root Password window displays.
Step 16
Enter a password for the root user.
The root user has access to all the files in the Cisco IPICS server. Cisco IPICS
requires that you use strong passwords that contain at least eight characters and
include the following elements:
•
At least one lower case letter
•
At least one upper case letter
•
At least one number
•
At least one of the following special characters:
@[]^_`!"#$%&'()*+,-./:;{<|=}>~?
Note
If you need to change the root password at a later date, you can log in to
the Cisco IPICS server as the root user and change it by using the
reset_pw command. For more information, refer to the “Resetting,
Changing, or Creating a Password With the reset_pw Tool” section of the
“Using the Cisco IPICS CLI Tools and Service Commands” chapter in the
Cisco IPICS Troubleshooting Guide, Release 2.1(1).
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-13
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
Step 17
Reenter the password and click Next.
The Network Setup window displays.
Cisco IPICS prompts you to enter the DNS server information.
Step 18
In the DNS Information area in the Network Setup window, enter the Primary and
Secondary DNS (if any) and the domain name of your server in the specified
fields.
Step 19
In the Ethernet Port 1 (device eth0) area, enter the host name, IP address, subnet
mask, and default gateway for your server in the specified fields.
Step 20
Click Next.
The Timezone window displays.
Step 21
Choose the correct time zone for your area from the choices in the selection list.
If your system clock uses Universal Coordinated Time (UTC), make sure that you
check the System Clock uses UTC check box.
Step 22
Click Next.
The Date and Time window displays.
Step 23
Perform one of the following actions to set the system date and time:
•
Note
If your network uses the Network Time Protocol (NTP), check the Enable
Network Time Protocol check box; then, enter the name or IP address of
your NTP server in the Server field.
If you configure NTP on the server, the system administrator should
provide instructions to the PMC users to also configure the Windows
Time Service on their PMC client machines to enable synchronization
between the PMC and the server logs. For detailed information about how
to configure the Windows Time Service, refer to the Microsoft support
site at http://support.microsoft.com/ and search for Article ID 307897.
If you install a time-bound license for your system, use caution when
enabling NTP. Adjustments to the system date can cause Cisco IPICS to
invalidate your license. For more information, see the “Managing
Time-Bound Licenses” section on page 2-37.
•
If your network does not use NTP, enter the current date and time in the
appropriate fields.
Cisco IPICS Server Installation and Upgrade Guide
2-14
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Operating System
Step 24
Click Next.
The Finish Setup window displays.
Step 25
Click Next.
The system processes an internal check list as it boots up. After the system has
booted up, Cisco IPICS displays the following text:
Cisco IPICS
hostname login:
where:
hostname represents the host name that you specified in Step 19.
Step 26
Enter root in the hostname login: field; then, press Enter.
Cisco IPICS prompts you for the password for the root user.
Step 27
Enter the password that you created for the root user in Step 16; then, press Enter.
Step 28
To verify network connectivity, enter the following command:
[root]# ping <destination-ip-address>
where:
<destination-ip-address> represents the default gateway address or an IP address
of another host on the network.
Step 29
Press Ctrl+C to stop the ping.
If the ping is not successful, troubleshoot the network connectivity with your
network administrator.
Step 30
Locate the hardware MAC address for the eth0 interface by following these steps:
a.
To display the MAC address of the eth0 interface, enter the following
command:
[root]# ifconfig eth0
b.
Note the HWaddr field in the command output.
The HWaddr field contains the MAC address for the eth0 interface.
c.
Make a note of the MAC address information for the eth0 interface so that you
can use it to obtain your license for Cisco IPICS.
d.
To log out of the server, enter the following command:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-15
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
[root]# exit
The Cisco IPICS operating system installation is now complete. You can continue
with the installation of the Cisco IPICS server software. If you do not want to
install Cisco IPICS immediately, you can resume the installation at a later time.
To install the Cisco IPICS server software, see the “Installing the Cisco IPICS
Server Software” section.
Installing the Cisco IPICS Server Software
After you have successfully installed the Cisco IPICS operating system, you can
install the Cisco IPICS server software by using one of the following methods:
•
Directly by using the installation CD at the Cisco IPICS server.
•
Remotely by copying the installer file to the server and entering remote
commands.
The Cisco IPICS server installation program uses a text-based interface and does
not provide support for a graphical user interface (GUI). This installation
procedure allows you to choose from the following install options:
Note
•
Install—This option installs the Cisco IPICS server software, including
Cisco Security Agent (CSA).
•
Upgrade—This option upgrades your server from a previous version of
Cisco IPICS. For information about performing an upgrade of the
Cisco IPICS server software, see Chapter 3, “Upgrading Cisco IPICS.”
Be aware that the options that the installer displays may differ depending on the
current software version that is running on your system.
This section includes the following topics:
•
Performing a Direct Cisco IPICS Server Software Installation, page 2-17
•
Performing a Remote Cisco IPICS Server Software Installation, page 2-21
Cisco IPICS Server Installation and Upgrade Guide
2-16
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
Performing a Direct Cisco IPICS Server Software Installation
If you have physical access to the Cisco IPICS server, you can install the server
software directly from the server. To do so, you must have the Cisco IPICS
installation CD that is included with your product package.
Note
Be aware that you must log in as the root user to perform the Cisco IPICS
installation. If you attempt to run the installation from any other user ID, the
installation returns an error and exits.
Tip
To terminate the installation process at any point in time, press Ctrl+C.
To install the Cisco IPICS server software directly from the server location,
perform the following procedure:
Procedure
Step 1
Enter root in the hostname login: field in the terminal console; then, press Enter.
Cisco IPICS prompts you for the password for the root user.
Step 2
Enter the password that you created for the root user in Step 16 in the “Installing
the Cisco IPICS Operating System Software” section on page 2-7; then, press
Enter.
The Cisco IPICS operating system logs you in as the root user.
Step 3
Enter the free command and read the information that displays in the total column
to check the total amount of installed memory.
The Cisco IPICS installation requires a minimum of 2 GB of memory.
The following example shows that there is a minimum of 2 GB of total memory
in the server:
[root]# free
total
used
free
shared
Mem: 2055340
881152
1174188
0
-/+ buffers/cache:
466604
1588736
Swap:
2048248
0
2048248
buffers
25520
cached
389028
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-17
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
If your server does not have sufficient memory, contact your Cisco representative
to find out how you can purchase additional memory. Refer to the Cisco IPICS
Compatibility Matrix for specific memory requirements.
Step 4
Insert the Cisco IPICS installation CD into the CD drive of the Cisco IPICS
server.
Step 5
Mount the contents of the CD onto the server by entering the following command:
[root]# mount /mnt/cdrom
Step 6
To navigate to the CD location, enter the following command:
[root]# cd /mnt/cdrom
Step 7
To view the installer file, enter the following command:
[root]# ls -l
The directory of the CD displays.
Step 8
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
Step 9
To start the installation, enter the following command:
[root]# bash <installerfilename>.run
where:
<installerfilename>.run specifies the name of the installer file that you located in
Step 7.
Cisco IPICS begins the installation process.
Text displays to inform you that you must read and accept the terms of the End
User License Agreement (EULA) before you can proceed.
Step 10
Press Enter to display the EULA.
The Cisco IPICS installer displays the EULA.
Step 11
Press the Spacebar to scroll through and view the EULA. To accept the terms of
the EULA, enter y or yes to continue with the installation.
You must accept the terms of the EULA to proceed.
Cisco IPICS Server Installation and Upgrade Guide
2-18
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
Note
To terminate the installation while the EULA is being displayed, press
Ctrl+C. The installation terminates after the installation program
displays the entire EULA. Press q to bypass the EULA and terminate the
installation process.
The installation program prompts you to enter a password for the ipics user. The
ipics user has the capability to perform all administration-related tasks via the
Cisco IPICS Administration Console.
Step 12
Enter a password for the ipics user in the password field.
To ensure a strong password, use a password that is at least eight characters long
and contains at least one of each of the following characters:
•
One lower case letter
•
One upper case letter
•
One number
•
One of the following special characters:
@[]^_`!"#$%&'()*+,-./:;{<|=}>~?
Note
Step 13
The installation program also creates a password for the informix Linux
user by using a random algorithm. The informix user has full
administrative permission to the Informix database instance and belongs
to the ipics and informix linux groups. The ipics linux group includes
permission to Cisco IPICS application-related folders, files, and scripts.
The informix linux group includes full permission to the Cisco IPICS
database server folders, files, and scripts. The password for this user ID
never expires.
Reenter the password; then, press Enter.
The installation program prompts you to enter a password for the Cisco IPICS
ipicsadmin (administrative) Linux user. That ipicsadmin user belongs to the ipics
linux group. In addition, the ipicsadmin user has permission to read and write data
from and/or to the Informix database.
Step 14
Enter a password in the password field to create the ipicsadmin user password.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-19
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
To ensure a strong password, use a password that is at least eight characters long
and contains at least one of each of the following characters:
•
One lower case letter
•
One upper case letter
•
One number
•
One of the following special characters:
@[]^_`!"#$%&'()*+,-./:;{<|=}>~?
Note
Step 15
The password for the ipicsadmin user never expires.
To begin the installation process, enter y or yes.
The Cisco IPICS software begins the installation process.
A progress bar displays to indicate the percentage of the installation that has
completed.
Step 16
After the file installation completes, a message displays to inform you of the
status.
The following text is an example of the message that you might see when the
installation has successfully completed.
"The installation has completed successfully."
You can view the installation log file by navigating
to the following directory:
"/var/opt/CSCOipics/run/20061018092707/ipics-install-log.txt"
To complete the installation, you must reboot your server.
Do you want to reboot now? (YES/NO): [YES]
Step 17
Enter YES to reboot your server.
The server reboots and your Cisco IPICS server becomes available.
Cisco IPICS Server Installation and Upgrade Guide
2-20
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
Note
If you enter NO, complete the restart before you attempt to log in to
Cisco IPICS. Cisco IPICS processes, such as the tomcat service and
database server, do not start until you reboot the server.
To reboot your server at a later time, follow the procedure in the
“Restarting or Shutting Down the Server” section on page 2-25.
Performing a Remote Cisco IPICS Server Software Installation
This section describes the procedure that you can follow to install Cisco IPICS
from a PC that is remotely connected to the network.
To install the Cisco IPICS server software from a remote location, perform the
following procedure:
Procedure
Step 1
Step 2
Transfer the installer file from the Cisco IPICS installation CD to the Cisco IPICS
server. To do so, perform one of the following tasks:
•
Place the CD (or have someone place it for you) in the Cisco IPICS server and
copy the installer file to the server. Follow the steps that are documented in
Step 2 to perform this procedure.
•
Place the CD in a PC and transfer the installer file to the Cisco IPICS server
by using a File Transfer Protocol (FTP) client software program, such as
Secure Shell (SSH) Client software (or similar software). Follow the steps
that are documented in Step 3 to perform this procedure.
To copy the installer file from the CD, perform the following steps:
a.
Insert the Cisco IPICS installation CD in the server disk drive.
b.
Choose Start > Programs > SSH Secure Shell > Secure Shell Client to
remotely connect to the Cisco IPICS server.
Note
The SSH idle timeout value is 120 minutes (two hours). Therefore, make
sure that you do not leave an SSH remotely-connected session inactive for
more than two hours; otherwise, the session times out.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-21
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
Tip
If you do not have Secure Shell Client installed on your PC, use another secure
client program.
c.
Click Quick Connect to connect to the Cisco IPICS server.
The Connect to Remote Host window displays.
d.
In the Host field, enter the DNS host name or the IP address for your
Cisco IPICS server; then, press the Tab key.
e.
In the User Name field, enter root.
f.
Click Connect.
The Enter Password window displays.
g.
Enter the password for the root user and click OK.
The SSH Secure Shell Client software window displays.
h.
Mount the contents of the CD onto the server by entering the following
command:
[root]# mount /mnt/cdrom
Note
i.
During the installation process, error messages, such as
cdrom_decode_error, may display when you access the CD. You can
ignore these messages, as they do not affect the installation or operation
of the Cisco IPICS server.
Navigate to the cdrom subfolder in the CD location by entering the following
command:
[root]# cd /mnt/cdrom
j.
To view the installer file, enter the following command:
[root]# ls -l
The directory of the CD displays.
k.
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
l.
Copy the installer file to the /root directory by entering the following
command:
Cisco IPICS Server Installation and Upgrade Guide
2-22
OL-12985-01
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
[root]# cp /mnt/cdrom/<installerfilename>.run /root
where:
<installerfilename>.run represents the name of the .run file that was
displayed in Step j.
The installer file copies from the CD to the /root directory.
m.
Navigate from the /mnt/cdrom directory to an internal directory on your
server by entering the following command:
[root]# cd <serverdirectory>
where:
<serverdirectory> is any internal directory or subdirectory on your server.
n.
To unmount the installation CD and eject it from the disk drive, enter the
following command:
[root]# eject
Note
Step 3
Be aware that you must navigate away from the /mnt/cdrom directory
and enter the eject command to unmount the contents of the CD and eject
the CD from the server. If you try to eject the CD by pushing the eject
button on the server, the CD will not eject.
To transfer the file to the server from a remote location, follow these steps:
a.
Insert the Cisco IPICS installation CD in the CD drive of your PC.
b.
Choose Start > Programs > SSH Secure Shell > Secure File Transfer
Client to open the Secure File Transfer Client.
Note
If you do not have Secure File Transfer Client installed on your PC, use
another program that permits a secure file transfer session between your
PC and the server.
The SSH Secure Shell File Transfer Client window displays. The desktop of
your PC displays in the left pane.
c.
Click Quick Connect to connect to the Cisco IPICS server.
The Connect to Remote Host window displays.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-23
Chapter 2
Installing Cisco IPICS
Installing the Cisco IPICS Server Software
d.
In the Host field, enter the DNS host name or the IP address for your
Cisco IPICS server. Then, press the Tab key.
e.
In the User Name field, enter root.
f.
Click Connect.
The Enter Password window displays.
g.
Enter the password for the root user and click OK.
The SSH Secure Shell File Transfer Client connects to the Cisco IPICS server
and displays the contents of the /root directory in the right pane of the
window.
h.
In the left pane of the window, navigate to the folder on your PC that
corresponds to the location of the Cisco IPICS installation CD (for example,
My Computer\Compact Disk Z:).
i.
Double-click the CD folder to browse the contents of the CD.
The contents of the CD displays.
j.
Double-click the cdrom subfolder to browse its contents.
k.
Locate the installer file in the cdrom subfolder on the CD.
The installer file has an extension of .run.
l.
Drag the installer file from the left pane of the window to the right pane to
initiate the copy procedure.
A progress window displays while the file copies to the /root directory of the
server. After the copy procedure completes, the installer file displays in the
right pane.
m.
Close the SSH Secure Shell File Transfer Client.
Step 4
Open a terminal window to the Cisco IPICS server by using SSH Secure Shell
Client software or similar software.
Step 5
In the User Name field, enter root.
Step 6
Click Connect.
The Enter Password window displays.
Step 7
Enter the password for the root user and click OK.
The SSH Secure Shell Client software window displays.
Step 8
To view the installer file, enter the following command:
Cisco IPICS Server Installation and Upgrade Guide
2-24
OL-12985-01
Chapter 2
Installing Cisco IPICS
Restarting or Shutting Down the Server
[root]# ls -l
The contents of the /root directory display.
Step 9
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
Step 10
Change the access mode of the installer file by entering the following command:
[root]# chmod 550 <installerfilename>.run
where:
<installerfilename>.run represents the name of the installer file.
Note
Step 11
Entering this command allows the root user ID to read and run the
installer file.
To run the installer from a SSH Secure Shell Client software (or similar software)
window, follow the procedure as described in the “Performing a Direct
Cisco IPICS Server Software Installation” section, starting with Step 9 on
page 2-18.
Restarting or Shutting Down the Server
To restart the server, perform the following procedure:
Caution
Be aware that when you shut down or restart your server, all user communications
terminate. In addition, Cisco IPICS logs out all users who are logged in to the
Administration Console. Therefore, make sure that you only shut down or restart
your server during a maintenance window or other period of system non-use.
Procedure
Step 1
Log in to the Cisco IPICS server with the root user ID by taking one of the
following actions:
•
To log in to the server from the server console, follow these steps:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-25
Chapter 2
Installing Cisco IPICS
Restarting or Shutting Down the Server
a. Log in to the server by entering root for the user name.
b. When you are prompted, enter the root user password.
•
To log in to the server remotely, follow these steps:
a. Open a terminal window by using SSH Secure Shell Client software or
similar software.
b. Log in to the server by entering the IP address or host name of the server.
c. Log in by using the root user ID by entering root for the user name.
d. When you are prompted, enter the root user password.
A terminal window displays.
Step 2
To reboot the server, enter the following command:
[root]# reboot
The server reboots.
To shut down the server, perform the following procedure.
Note
Cisco recommends that you gracefully shut down the server by performing the
following procedure in lieu of pressing the power button to shut down the server.
Procedure
Step 1
Log in to the Cisco IPICS server with the root user ID.
A terminal window displays.
Step 2
To shut down the running processes in the server, enter the following command:
[root]# shutdown -h <time>
where:
<time> is the time, in seconds, that the shutdown script delays before it begins.
Cisco IPICS Server Installation and Upgrade Guide
2-26
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Tip
To immediately shut down the running processes, enter the following
command:
[root]# shutdown -h now
The server terminates its running processes. If you are directly connected to the
server, the console displays messages as each process terminates.
Step 3
Wait until the shutdown script completes; then, turn the server off by pushing the
power button that is located on the front panel of the server.
Before you turn off the server, verify that the shutdown script has completed by
performing one of the following actions:
•
If you are directly connected to the server by a console connection, wait until
the following text displays:
Power down.
•
Note
If you are remotely connected to the server, wait approximately five minutes
to allow all processes to safely terminate.
You must manually turn off the server at the server location. You cannot
turn off the server by entering CLI commands.
The server shuts down.
Preparing to Use Cisco IPICS
After you complete the software installation, you must complete the following
tasks before you can use Cisco IPICS:
•
Checking the Installation, page 2-28
•
Managing Your Licenses and Certificates, page 2-29
•
Viewing the License Summary Information, page 2-34
•
Installing Third Party Certificates On the Cisco IPICS Server, page 2-40
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-27
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
•
Generating the Cisco IPICS PMC Application Installer, page 2-45
For more information about Cisco IPICS administration and configuration tasks,
refer to the Cisco IPICS Server Administration Guide, Release 2.1(1).
Checking the Installation
Upon completion of the Cisco IPICS server software installation, you should be
able to access the Cisco IPICS Administration Console by logging in via a
supported browser. You can access the Administration Console from any
computer that meets these requirements:
•
Has IP connectivity to the Cisco IPICS server
•
Running either of these operating systems:
– Windows 2000 SP4 or higher
– Windows XP SP2 or higher
•
Note
Running Internet Explorer version 6.0.2
There may be a delay of a few minutes before users can access the Administration
Console after the Cisco IPICS server restarts.
To access the Cisco IPICS Administration Console and check the installation,
perform the following procedure:
Procedure
Step 1
Open a supported Internet browser window on your PC.
Step 2
In the Address field, enter an HTTP over Secure Socket Layer (HTTPS) URL that
contains either the static IP address or the DNS name that you established for your
Cisco IPICS server in the “Installing the Cisco IPICS Operating System” section
on page 2-6.
Enter the URL in the following format:
https://<ipaddress> | <dnsname>
where:
Cisco IPICS Server Installation and Upgrade Guide
2-28
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
<ipaddress> is the IP address of the server and <dnsname> is the host name that
you configured for the server.
A Security Alert window displays.
Note
The Security Alert window displays because Cisco IPICS ships with a
self-signed certificate that is not issued by a Certificate Authority (CA).
If you prefer to replace the self-signed certificate with a third party
certificate that has been issued by a CA, follow the procedure in the
“Installing Third Party Certificates On the Cisco IPICS Server” section
on page 2-40.
Step 3
Click Yes to close the window and access the login screen.
Step 4
Log in by using the ipics user ID and password.
Note
The ipics user ID is the application-level user ID that can perform all
administration-related tasks by using the Administration Console.
The Administration > License Management window displays with a message
that informs you to upload a license file before you can use the system.
To obtain your license file, see the “Obtaining Your License File” section on
page 2-30.
If you are not able to access Cisco IPICS from your browser, see the “You Cannot
Connect to the Server By Using Your Browser” section on page 5-10.
Managing Your Licenses and Certificates
After you install Cisco IPICS, you can log in to the Administration Console, but
you will not be able to use any features until you upload the license file. You use
the Product Authorization Key (PAK) that was included in your Cisco IPICS
product package to obtain a license file.
The license that you purchased is based on the total number of the following
licensable features:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-29
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Note
•
The concurrent number of land mobile radio (LMR) ports
•
The concurrent number of multicast ports
•
The concurrent number of PMC users
•
The concurrent number of IP phone users
•
The concurrent number of dial users
•
The total number of ops views
To enable the policy engine for use, you are required to obtain a separate license.
The total number of LMR and multicast ports, PMC, IP phone, and dial users, and
ops views cannot exceed the number that is specified in the license or licenses that
you purchased. If you require additional licenses, contact your
Cisco representative.
This section includes the following topics:
•
Obtaining Your License File, page 2-30
•
Uploading the Cisco IPICS License Files, page 2-32
Obtaining Your License File
Your Cisco IPICS product package includes a Software License Claim Certificate
that contains a PAK, which is uniquely created from your sales order. You use this
key to obtain licenses for your Cisco IPICS installation.
You can order your initial licenses any time after you begin the installation
process.
Caution
If you are upgrading from Cisco IPICS release 1.0, your current license is not
compatible with Cisco IPICS release 2.1(1). Contact your authorized Cisco
representative to obtain new licenses for Cisco IPICS release 2.1(1). If you are
upgrading from release 2.0(2), you may use your current license(s), which are
valid for use with Cisco IPICS release 2.1(1).
To use your PAK to obtain your Cisco IPICS licenses, perform the following
procedure:
Cisco IPICS Server Installation and Upgrade Guide
2-30
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Procedure
Step 1
Locate your Software License Claim Certificate that was included in your
Cisco IPICS product package. Look for the PAK at the bottom of this certificate.
Note
Step 2
If you ordered your Cisco IPICS server software directly from Cisco,
your package may include only one PAK. However, if you purchased
Cisco IPICS through a distributor or reseller, you should have several
individual packages, each with its own PAK. In this case, you must
process all of your PAKs individually. Cisco sends you a license file for
each one.
Retrieve the MAC address that you noted during the Cisco IPICS operating
system installation.
If you misplaced the MAC address, complete Step 30 in the “Installing the
Cisco IPICS Operating System Software” section on page 2-7 to obtain it.
Step 3
Order a license by accessing Cisco.com at the following URL:
http://www.cisco.com/go/license
You must have a valid Cisco.com user ID and password before you can access this
URL.
After you process your license order, Cisco.com sends you an e-mail with the
license file as an attachment. If you processed several separate PAKs, Cisco.com
sends you several e-mail responses with a license file attached to each one. When
you upload these files, Cisco IPICS adds the licenses from each file and monitors
your system activity based on the aggregated license files.
Step 4
Save the license file to your PC by performing the following steps:
a.
Open the e-mail that contains the license file attachment.
b.
Right-click the license file attachment in the e-mail.
c.
Click Save As.
The Save Attachment window displays.
d.
Select the folder on your PC where you would like to download the license
file.
e.
Ensure that the following values appear in the fields of the Save Attachment
window:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-31
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
– The file name of the license appears with a .lic file type in the File name
field.
– All Files (*.*) appears in the Save as type field.
f.
Click Save.
The e-mail program downloads the license file to your PC.
Note
Step 5
Cisco IPICS does not support the editing or modification of the license
file name or file type. If you change the license file name or use an
extension other than .lic, you may invalidate your license and cause the
system to become inoperable.
Upload the Cisco IPICS license.
See the “Uploading the Cisco IPICS License Files” section on page 2-32 for
instructions about uploading the Cisco IPICS license file.
After you upload your license file, the license manager processes the new licenses
and updates the total number of licenses.
Step 6
If you require additional licenses, contact your distributor or reseller to purchase
the licenses.
Uploading the Cisco IPICS License Files
After you receive your license file(s), you can upload them by accessing the
Administration > License Management window in the Cisco IPICS
Administration Console.
Note
When you upload a license file, Cisco IPICS places the file in the following
directory:
/root/tomcat/current/webapps/license
To upload license file(s), perform the following procedure:
Cisco IPICS Server Installation and Upgrade Guide
2-32
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Procedure
Step 1
Open a supported browser window on your PC.
Step 2
In the Address field in the browser, enter an HTTPS URL that contains either the
IP address or the DNS name of your Cisco IPICS server in the following format:
https://<ipaddress> | <dnsname>
where:
<ipaddress> is the IP address of the server and <dnsname> is the host name that
you configured for the server.
A Security Alert window displays.
Step 3
Click Yes to close the window and access the login screen.
The Cisco IPICS Login window displays.
Step 4
Log in to the Cisco IPICS server by using the ipics user ID and password.
The system prompts you to upload the license file.
Note
The system does not prompt you to upload a license file if you have
previously uploaded a license file. If you are not prompted to upload the
license file, navigate to Administration > License Management from
the Server tab in the Administration Console.
The License Management window displays.
Step 5
Click Browse, then navigate to the license file that you downloaded to your PC.
Step 6
Select the license file and click Open.
Step 7
Click Upload to upload the license file to the server.
The license manager processes the new license.
Step 8
Click Apply.
Cisco IPICS associates the license file with the server and restarts the license
manager. The updated license information displays in the License Summary pane
in the License Management window.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-33
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Note
Step 9
After you click Apply, there may be a delay of a few minutes before you
can access the Administration Console.
If you have more than one license file, repeat Step 5 through Step 8 until you have
uploaded all license files.
Tip
Cisco recommends that you click Apply after you upload each license
file, so that you can more easily track the progress of the upload process.
Note
Cisco IPICS does not overwrite older license files with newer license
files. You can purchase additional features by obtaining a new license;
when you upload and apply the new license, Cisco IPICS adds the new
license features to the existing license features.
As a best practice, Cisco recommends that you remove old license file(s)
whenever license changes occur (such as when you replace a time-bound
license with a permanent license). For information about deleting
time-bound licenses, see the “Deleting Older Time-Bound Licenses from
the Server” section on page 2-38.
Viewing the License Summary Information
From the Administration > License Management > Summary tab in the
Administration Console, you can access the License Summary pane to view the
licensed features for your system. This pane also displays license information for
the Cisco IPICS Base Server License and the Policy Engine Base License.
To understand how Cisco IPICS features use the available licensed features, see
the “Tracking Your License Usage” section on page 2-35.
Cisco IPICS Server Installation and Upgrade Guide
2-34
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Note
The data that displays in the License browser window shows the usage at the time
that the license window was last accessed. To view the most current license
information, refresh your browser window. Make sure to refresh your browser
window often and before you perform any server administration functions to
ensure that you are working with the most current information. If you attempt to
perform an administration update in a window that does not display the most
current data, the update does not succeed, and Cisco IPICS displays an error. If
you receive an error, refresh your browser window and retry the operation.
This section includes the following topics:
•
Tracking Your License Usage, page 2-35
•
Managing Time-Bound Licenses, page 2-37
Tracking Your License Usage
Table 2-1 describes the criteria that Cisco IPICS uses to determine license usage
for ports, PMCs, IP phones, the policy engine, and ops views.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-35
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Table 2-1
Cisco IPICS License Usage Criteria
Field
Description
Concurrent
LMR Ports
An enabled channel or radio uses an LMR port license. After
an administrator disables a channel or radio, the server
releases the LMR license and makes it available for use.
Associating a radio and channel selector combination with a
channel does not affect license usage.
Cisco IPICS bases license usage for channels on the unique
combination of a multicast address and a location. If a
channel uses two multicast addresses, the single channel uses
two licenses. If an administrator removes one of the multicast
addresses, the system releases one of the licenses so that the
port now uses one license.
Concurrent
Multicast Ports
An activated VTG uses a multicast port license. After an
administrator deactivates a VTG, the server releases the
multicast license and makes it available for use.
Note
Concurrent
PMC Users
Be aware that an inactive VTG uses a license when a
policy triggers (activates) that VTG. Therefore, if the
number of licenses has been exceeded, the policy is
not able to activate the VTG. Make sure that the
server has a sufficient number of licenses available
for the configuration of policies.
A PMC user uses a license each time that the user logs in to
a PMC session.
If the same PMC user logs in to multiple PMC sessions from
different PMC client machines, that user uses multiple
licenses (one for each PMC session).
Note
If you use all of the available PMC licenses,
Cisco IPICS interrupts PMC user access to the
system. Make sure that you are aware of the current
status of PMC licenses, and purchase and install
additional licenses immediately if you use all of the
available PMC licenses.
Cisco IPICS Server Installation and Upgrade Guide
2-36
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Table 2-1
Cisco IPICS License Usage Criteria (continued)
Field
Description
Concurrent
Cisco Unified
IP Phone Users
An IP phone user uses a license each time that a user logs in
to Cisco IPICS from an IP phone. If you use all IP phone
licenses, additional IP phone users cannot dial into a channel
or VTG.
Concurrent Dial The policy engine uses a license each time the dial engine
Users
performs a dial-in or dial-out action. If you use all dial user
licenses, the dial engine cannot perform additional dial-in or
dial-out actions.
Cisco IPICS
Ops View
If you have purchased a license that includes additional ops
view functionality, each ops view that you create uses one
license.
Cisco IPICS
Base Server
License
License usage does not apply to this field. This field displays
whether you have a base license for Cisco IPICS.
Policy Engine
Base License
License usage does not apply to this field. This field indicates
whether you have a base license for the policy engine.
Managing Time-Bound Licenses
Cisco IPICS also includes support for time-bound licenses. Time-bound licenses,
such as evaluation or demonstration licenses, differ from purchased
(non-time-bound) licenses in that they include a preconfigured license expiration
date.
When a time-bound license is about to expire (about 30 days before expiration),
Cisco IPICS displays a warning message to alert you of the upcoming expiration.
Note
If you install a more recent time-bound license on your server, you may see this
warning message if additional unexpired time-bound licenses are installed and
you have not dismissed this warning. To suppress this warning message, delete the
older, unexpired licenses that are installed on your server. For more information,
see the “Deleting Older Time-Bound Licenses from the Server” section on
page 2-38.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-37
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
•
When a license feature expires, the relevant functionality of that license
becomes disabled.
•
After your license expires, it remains valid for a maximum of 24 hours after
the expiration date. (The server checks for expired licenses every 24 hours.)
•
After you install the Cisco IPICS server software, Cisco IPICS invalidates
time-bound licenses when you change the system date to a date that is before
the license start date. Invalid licenses cause the Cisco IPICS system to
become inoperable.
Note
You must restart the license manager, or reboot the server, for system date
changes to become effective.
To restart the license manager and revalidate the license(s), perform the following
procedure:
Procedure
Step 1
Open a terminal window and log in using the root user ID.
Step 2
Restart the license manager by entering the following command:
[root]# service ipics_lm restart
Step 3
To revalidate the license(s), navigate to Administration > License
Management; then, click Apply to restart the license server.
Deleting Older Time-Bound Licenses from the Server
If you receive license expiration warning messages, and you have more than one
unexpired time-bound license installed, you must delete the older time-bound
licenses to suppress this warning message. To delete time-bound licenses, perform
the following procedure:
Procedure
Step 1
Open a terminal window and log in by using the root user ID.
Cisco IPICS Server Installation and Upgrade Guide
2-38
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Step 2
Navigate to the directory where Cisco IPICS stores the license files by entering
the following command:
[root]# cd tomcat/current/webapps/license
Step 3
View the license files by entering the following command:
[root]# ls -l *.lic
The license files display with the time and date that the license was last modified.
Step 4
Make a note of the licenses that you no longer need.
The time and date that displays with the file information might assist you with
determining which files you need to delete.
Step 5
Delete the unnecessary license files by entering the following command:
[root]# rm <licensefilename>.lic
where:
<licensefilename>.lic is the name of the license file that you want to delete.
Caution
Make sure that you do not delete the cisco.opt file. This file is required for the
correct operation of Cisco IPICS.
Step 6
Repeat Step 5 for each license file that you need to delete.
Step 7
Restart the server by entering the following command:
Step 8
[root]# service ipics restart
Step 9
Log in to the Administration Console by using the ipics user ID and navigate to
the Administration > License Management window.
Step 10
To apply the license deletions to the system configuration, click Apply.
Step 11
If a message displays that indicates that a license is about to expire, click Dismiss
Warnings.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-39
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Installing Third Party Certificates On the Cisco IPICS Server
The Cisco IPICS server ships with a self-signed certificate. However, you may
replace this certificate with a customer-specific, third party certificate that has
been issued by a CA. A CA, as a trusted third party, issues and manages digital
certificates that provide enhanced security by verifying the credentials of the user,
organization, server, or other entity as specified in the certificate. VeriSign,
Thawte, and Entrust are examples of CAs.
The following topics include information about requesting a third party certificate
and installing the certificate on the Cisco IPICS server:
•
Requesting a Third Party Certificate, page 2-40
•
Installing a Third Party Certificate, page 2-43
Requesting a Third Party Certificate
To request a third party certificate, perform the following procedure:
Procedure
Step 1
Log in to the Cisco IPICS server by using the root user ID.
The Cisco IPICS operating system logs you in as the root user.
Step 2
Copy the tomcat.keystore file to the /root directory by entering the following
command:
[root]# cp /root/tomcat/current/conf/tomcat.keystore /root
The tomcat.keystore file maintains all of the certificates for the server.
Step 3
Change to the /root/tomcat/current/conf/ directory by entering the following
command:
[root]# cd /root/tomcat/current/conf/
Step 4
Run the following command to delete the existing entry:
[root@ipics-server]# keytool -delete -alias tomcat -keystore tomcat.keystore
Step 5
When the system prompts you to enter the keystore password, enter the default
password, changeit.
Cisco IPICS Server Installation and Upgrade Guide
2-40
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Step 6
Run the following command to generate the new key that will be used for the
Certificate Signing Request (CSR):
[root@ipics-server]# keytool -genkey -alias tomcat -keyalg RSA -keystore
tomcat.keystore -validity 360
The validity may vary based on the number of days that the certificate needs to be
valid.
Note
Step 7
Make sure that you enter the correct information so that the CA generates
a valid certificate for your system.
Enter your responses to the following system prompts:
Enter keystore password:
What is your first and last name?
What is the name of your organizational unit?
What is the name of your organization?
What is the name of your City or Locality?
What is the name of your State or Province?
What is the two-letter country code for this unit?
Note
The information that you enter may vary depending on the CA that you
use. For example, for the first and last name response, VeriSign requires
that you enter the fully-qualified hostname of your Cisco IPICS server in
the format of server.domain.com. For the name of your state or province,
VeriSign requires that you spell out the complete name in lieu of using the
abbreviated form.
Tip
The default keystore password is changeit.
The following is an example of the information that the system displays:
Is CN=username, OU=user company name, O=user company name, L=user
city, ST=user state, C=user country correct? [no]:
Step 8
Enter y or yes if the information is correct.
Step 9
When the system displays the following message, press Enter to accept the
default password:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-41
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Enter key password for <tomcat>
(RETURN if same as keystore password):
where <tomcat> is the default alias for the certificate
Note
Step 10
The system requires that you use the same value for the key password and
the keystore password. If you enter different passwords, the Tomcat
server will not be able to successfully restart. (When these passwords are
the same, the system does not prompt you again for the key password.)
Run the following command to create the CSR file:
[root@ipics-server]# keytool -certreq -alias tomcat -keyalg RSA -file
certrequest.csr -keystore tomcat.keystore
Step 11
When the system prompts you to enter the keystore password, enter the default
value of changeit:
Enter keystore password:
Upon entry of the correct password, the system creates the CSR. (If you enter an
incorrect password, the system displays an error.)
Note
Step 12
You need to use the text from this CSR file when you request the
certificate. See Step 12.
Copy the certrequest.csr file to your local workstation.
Depending on the CA that you use, you may need to copy and paste the contents
of the certrequest.csr file into your browser or you may need to upload the CSR
file to request the certificate.
Note
If the CA does not accept your certificate request, repeat this procedure
from Step 3 to regenerate your certificate request with the necessary
modifications.
Cisco IPICS Server Installation and Upgrade Guide
2-42
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Step 13
After you receive the certificate from the CA, continue with the procedure in the
“Installing a Third Party Certificate” section on page 2-43 to install the third party
certificate.
Installing a Third Party Certificate
To install a third party certificate on the server, perform the following procedure:
Procedure
Step 1
Depending on the format in which you receive the certificate, take one of the
following actions:
•
If you receive the certificate file directly from the CA, rename the file to
thirdparty.cer
•
If you receive the certificate enclosed in an email, create a new file named
thirdparty.cer (this file must contain only the certificate contents of the
email)
CAs may use different procedures to send root CA certificates. Some CAs embed
the root CA certificate into the certificate that they provide to you; other CAs
provide the root CA certificate separately. (The root CA certificate allows you to
establish a chain of trust from the CA to the third party certificate on your server.)
Step 2
Depending on the format in which the CA provides the root CA certificate, take
one of the following optional actions:
•
If you download the root CA certificate file directly from the CA website,
rename the file to thirdpartyca.cer
•
If the CA provides the root CA certificate enclosed in a web page, create a
new file named thirdpartyca.cer (this file must contain only the root CA
certificate contents of the web page)
Step 3
Copy the thirdparty.cer file (and the optional thirdpartyca.cer file) from the
local workstation to the /root/tomcat/current/conf/ directory on the server by
using Secure FTP.
Step 4
To verify that you are still in the /root/tomcat/current/conf/ directory, enter the
following command:
[root]# cd /root/tomcat/current/conf/
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-43
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Step 5
If you received a separate root CA certificate, install it first by executing the
following command:
[root@ipics-server]# keytool -import -alias thirdpartyca -keystore
tomcat.keystore -trustcacerts -file thirdpartyca.cer
Step 6
When the system prompts you to enter the keystore password, enter changeit.
Step 7
Enter yes to trust the certificate when the system displays the following prompt:
Trust this certificate? [no]:
The certificate installs and the following message displays:
Certificate was added to keystore
Step 8
To install the certificate, run the following command:
[root@ipics-server]# keytool -import -alias tomcat -keystore tomcat.keystore
-trustcacerts -file thirdparty.cer
Step 9
When the system prompts you to enter the keystore password, enter changeit.
The following error message displays if you did not install the root CA certificate
(and it was required):
keytool error: java.lang.Exception: Failed to establish chain from
reply
If you encounter this error, contact the CA to locate the root CA certificate; then,
repeat this procedure from Step 5.
Step 10
Enter yes to trust the certificate when the system displays the following prompt:
Trust this certificate? [no]:
The certificate installs and the following message displays:
Certificate reply was installed in keystore
Step 11
From root, enter the following command to restart the Tomcat web server:
[root]# service ipics_tomcat restart
Step 12
Verify that the certificate has been installed by executing the following command.
[root@ipics-server]# keytool -list -keystore tomcat.keystore
Step 13
When the system prompts you to enter the keystore password, enter the default
value of changeit.
Cisco IPICS Server Installation and Upgrade Guide
2-44
OL-12985-01
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
The system displays the certificate information, as shown in the following
example:
Keystore type: jks
Keystore provider: SUN
Your keystore contains 1 entries
Tomcat, May 12, 2006, keyEntry,
Certificate fingerprint (MD5):
88:88:1A:34:38:0A:27:6F:B9:87:CA:8F:36:66:C4:73
If you installed the root CA certificate, the system display indicates that the
keystore contains two entries, as shown in the following example:
Your keystore contains 2 entries
thirdpartyca, May 20, 2006, trustedCertEntry,
Certificate fingerprint (MD5):
B6:9D:A4:40:52:02:50:0D:D5:9C:E1:B8:4B:66:C4:AC
...
Note
The fingerprint may vary based on your system.
Generating the Cisco IPICS PMC Application Installer
PMC users download the PMC installer from the Cisco IPICS Administration
Console. Before a user can download the PMC installer from the server, you must
first generate the PMC installer.
For more information about generating the PMC installer and managing PMC
updates, refer to the “Generating the PMC Installer” and “Managing PMC
Versions” sections in the “Performing Cisco IPICS System Administrator Tasks”
chapter in the Cisco IPICS Server Administration Guide, Release 2.1(1).
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
2-45
Chapter 2
Installing Cisco IPICS
Preparing to Use Cisco IPICS
Cisco IPICS Server Installation and Upgrade Guide
2-46
OL-12985-01
CH A P T E R
3
Upgrading Cisco IPICS
If your Cisco IPICS server is running release 2.0(2) or 2.0(2) SR1, you can
upgrade your server to release 2.1(1) by using a Cisco-provided CD-ROM. If you
are not sure about how to obtain the software for Cisco IPICS release 2.1(1),
contact your Cisco representative for information.
Tip
To verify which versions of Cisco IPICS are compatible for upgrade, refer to the
most recent version of the Cisco IPICS Compatibility Matrix at
http://www.cisco.com/en/US/products/ps7026/
tsd_products_support_series_home.html
This chapter contains information about upgrading your software to Cisco IPICS
release 2.1(1) and other actions that you must take to fully complete this upgrade
process and includes the following sections:
•
Before You Begin, page 3-1
•
Performing a Direct Cisco IPICS Server Software Upgrade, page 3-2
•
Performing a Remote Cisco IPICS Server Software Upgrade, page 3-5
Before You Begin
Be aware of the following caveats, and perform one or more of the following
suggested actions, before you upgrade your server software:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-1
Chapter 3
Upgrading Cisco IPICS
Performing a Direct Cisco IPICS Server Software Upgrade
•
Cisco recommends that you back up the database to a remote host. If you
encounter problems during the upgrade, you can reinstall the Cisco IPICS
release 2.0(2) server software and restore your database from the remote
backup to return your system to its previous state. For information about
backing up and restoring the Cisco IPICS database, refer to the “Performing
Cisco IPICS Backup and Restore Operations” chapter of the Cisco IPICS
Server Administration Guide, Release 2.1(1).
•
You can set up a new version of the latest, supported PMC so that the PMC
download process is staged. Staging the PMC download alleviates the burden
of long PMC downloads to all users at one time. For more information about
this feature, refer to the “Installing a New PMC Version Before You Upgrade
Your Cisco IPICS Server” section in the “Performing Cisco IPICS System
Administrator Tasks” chapter in the Cisco IPICS Server Administration
Guide, Release 2.1(1).
•
Cisco IPICS retains existing attributes for channels, VTGs, and users during
an upgrade. Note, however, that the default setting for the Allow Latch
attribute is set to disabled (unchecked) when you create new channels or
VTGs in release 2.1(1). For more information about the Allow Latch
attribute, refer to the “Performing Cisco IPICS System Administrator Tasks”
chapter in the Cisco IPICS Server Administration Guide, Release 2.1(1).
Performing a Direct Cisco IPICS Server Software
Upgrade
If you have physical access to the Cisco IPICS server, you can upgrade the server
software directly from the server. To do so, you must have the Cisco IPICS release
2.1(1) installation CD that is included with your product package.
Be aware that you must log in as the root user to perform the Cisco IPICS upgrade.
If you attempt to run the upgrade from any other user ID, the upgrade program
returns an error and exits.
Note
To terminate the upgrade process at any point in time, press Ctrl+C.
To upgrade the Cisco IPICS server software directly, perform the following
procedure:
Cisco IPICS Server Installation and Upgrade Guide
3-2
OL-12985-01
Chapter 3
Upgrading Cisco IPICS
Performing a Direct Cisco IPICS Server Software Upgrade
Procedure
Step 1
Enter root in the hostname login: field in the terminal console; then, press Enter.
Cisco IPICS prompts you for the password for the root user.
Step 2
Enter the password that you created for the root user in Step 16 in the “Installing
the Cisco IPICS Operating System” section on page 2-6; then, press Enter.
The Cisco IPICS operating system logs you in as the root user.
Step 3
Mount the contents of the CD onto the server by entering the following command:
[root]# mount /mnt/cdrom
Note
Step 4
During the installation process, error messages, such as
cdrom_decode_error, may display when you access the CD. You can
ignore these messages, as they do not affect the installation or operation
of the Cisco IPICS server.
To navigate to the CD location, enter the following command:
[root]# cd /mnt/cdrom
Step 5
To view the installer file, enter the following command:
[root]# ls -l
The directory of the CD displays.
Step 6
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
Step 7
To start the upgrade, enter the following command:
[root]# bash <upgradefilename>.run
where:
<upgradefilename>.run specifies the name of the installer file that you located in
Step 6.
Cisco IPICS begins the installation program and prompts you to overwrite or
upgrade the current server software.
Step 8
Enter 2 to upgrade the server software from the following choices:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-3
Chapter 3
Upgrading Cisco IPICS
Performing a Direct Cisco IPICS Server Software Upgrade
•
1) Install—This option overwrites your previous version of Cisco IPICS;
therefore, you will lose all your configuration and user data from the current
version that is installed on your server.
•
2) Upgrade—This option allows you to upgrade your current version to
release 2.1(1).
•
3) Quit—This option cancels the installation program.
Note
Be aware that the options that the installer displays may differ depending
on the current software version that is running on your system.
The Cisco IPICS installer displays the End User License Agreement.
Step 9
Press the Spacebar to scroll through and view the entire agreement. If you accept
the terms of the license agreement, enter y or yes to continue with the upgrade.
You must accept the terms of the agreement to proceed with the upgrade.
The upgrade program prompts you to enter a password for the ipics user. The ipics
user is the application-level user ID that can perform all administration-related
tasks by using the Cisco IPICS Administration Console.
Step 10
Enter a password for the ipics user in the password field.
To ensure a strong password, use a password that is at least eight characters long
and contains at least one of each of the following characters:
•
One lower case letter
•
One upper case letter
•
One number
•
One of the following special characters:
@[]^_`!"#$%&'()*+,-./:;{<|=}>~?
Step 11
Reenter the password.
The upgrade program prompts you to change the password for the Cisco IPICS
ipicsadmin (administrative) user. The ipicsadmin user has permissions to
Cisco IPICS system-level folders, files, and scripts that are related to database
backup and restore operations.
Step 12
Enter a strong password in the password field to change the ipicsadmin user
password.
Cisco IPICS Server Installation and Upgrade Guide
3-4
OL-12985-01
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
Follow the password guidelines that are documented in Step 10.
Step 13
To continue with the upgrade, enter y or yes.
The Cisco IPICS software begins the upgrade process.
A progress bar displays and shows you the percentage of the upgrade that has been
completed.
After the upgrade completes, a message displays to inform you that the upgrade
has successfully completed.
Step 14
Enter y or yes to reboot your computer.
The system reboots and your Cisco IPICS server becomes available for your use.
Note
If you choose the Restart Later option, complete the restart before you
attempt to log in to Cisco IPICS. Cisco IPICS processes, such as the
tomcat service and database server, do not start until you reboot the
server.
Performing a Remote Cisco IPICS Server Software
Upgrade
This section describes the procedure that you follow to upgrade the Cisco IPICS
server software from a PC or other device that is remotely connected to the
network.
To upgrade the Cisco IPICS server software from a remote location, perform the
following procedure:
Procedure
Step 1
Transfer the installer file from the Cisco IPICS installation CD to the Cisco IPICS
server by performing one of the following tasks:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-5
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
Step 2
•
Place the CD (or have someone place it for you) in the Cisco IPICS server and
copy the installer file to the server. Follow the steps that are documented in
Step 2 to perform this procedure.
•
Place the CD in a PC and transfer the installer file to the Cisco IPICS server
by using an FTP client software program, such as SSH Secure Shell Client
software (or similar software). Follow the steps that are documented in Step 3
to perform this procedure.
To copy the installer file from the CD, perform the following steps:
a.
Insert the Cisco IPICS installation CD in the server disk drive.
b.
Choose Start > Programs > SSH Secure Shell > Secure Shell Client to
remotely connect to the Cisco IPICS server.
Note
The SSH idle timeout value is 120 minutes (two hours). Therefore, make
sure that you do not leave an SSH remotely-connected session inactive for
more than two hours; otherwise, the session times out.
Tip
If you do not have Secure Shell Client installed on your PC, use another
secure client program.
c.
Click Quick Connect to connect to the Cisco IPICS server.
The Connect to Remote Host window displays.
d.
In the Host field, enter the DNS host name or the IP address for your
Cisco IPICS server; then, press the Tab key.
e.
In the User Name field, enter root.
f.
Click Connect.
The Enter Password window displays.
g.
Enter the password for the root user and click OK.
The SSH Secure Shell Client software window displays.
h.
Mount the contents of the CD onto the server by entering the following
command:
[root]# mount /mnt/cdrom
Cisco IPICS Server Installation and Upgrade Guide
3-6
OL-12985-01
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
i.
Navigate to the cdrom subfolder in the CD location by entering the following
command:
[root]# cd /mnt/cdrom
j.
To view the installer file, enter the following command:
[root]# ls -l
The directory of the CD displays.
k.
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
l.
Copy the installer file to the /root directory by entering the following
command:
[root]# cp /mnt/cdrom/<installerfilename>.run /root
where:
<installerfilename>.run represents the name of the .run file that was
displayed in Step j.
The installer file copies from the CD to the /root directory.
m.
Navigate from the /mnt/cdrom directory to an internal directory on your
server by entering the following command:
[root]# cd <serverdirectory>
where:
<serverdirectory> is an internal directory or subdirectory on your server.
n.
To unmount the installation CD and eject it from the disk drive, enter the
following command:
[root]# eject
Note
o.
You must navigate away from the /mnt/cdrom directory and enter the
eject command to unmount the contents of the CD and eject the CD from
the server. If you try to eject the CD by pushing the eject button on the
server, the CD will not eject.
To continue with the upgrade, proceed to Step 4.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-7
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
Step 3
To transfer the file to the server from a remote location, follow these steps:
a.
Insert the Cisco IPICS installation CD in the CD drive of your PC.
b.
Choose Start > Programs > SSH Secure Shell > Secure File Transfer
Client to open the Secure File Transfer Client.
Note
If you do not have Secure File Transfer Client installed on your PC, use
another program that permits a secure file transfer session between your
PC and the server.
The SSH Secure Shell File Transfer Client window displays. The desktop of
your PC displays in the left pane.
c.
Click Quick Connect to connect to the Cisco IPICS server.
The Connect to Remote Host window displays.
d.
In the Host field, enter the DNS host name or the IP address for your
Cisco IPICS server. Then, press the Tab key.
e.
In the User Name field, enter root.
f.
Click Connect.
The Enter Password window displays.
g.
Enter the password for the root user and click OK.
The SSH Secure Shell File Transfer Client connects to the Cisco IPICS server
and displays the contents of the /root directory in the right pane of the
window.
h.
In the left pane of the window, navigate to the folder on your PC that
corresponds to the location of the Cisco IPICS installation CD (for example,
My Computer\Compact Disk Z:).
i.
Double-click the CD folder to browse the contents of the CD.
The contents of the CD displays.
j.
Double-click the cdrom subfolder to browse its contents.
k.
Locate the installer file in the cdrom subfolder on the CD.
The installer file has an extension of .run.
l.
Drag the installer file from the left pane of the window to the right pane to
initiate the copy procedure.
Cisco IPICS Server Installation and Upgrade Guide
3-8
OL-12985-01
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
A progress window displays while the file copies to the /root directory of the
server. After the copy procedure completes, the installer file displays in the
right pane.
m.
Close the SSH Secure Shell File Transfer Client.
Step 4
Open a terminal window to the Cisco IPICS server by using SSH Secure Shell
Client software or similar software.
Step 5
In the User Name field, enter root.
Step 6
Click Connect.
The Enter Password window displays.
Step 7
Enter the password for the root user and click OK.
The SSH Secure Shell Client software window displays.
Step 8
To view the installer file, enter the following command:
[root]# ls -l
The contents of the /root directory display.
Step 9
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
Step 10
Change the access mode of the installer file by entering the following command:
[root]# chmod 550 <installerfilename>.run
where:
<installerfilename>.run represents the name of the installer file.
Note
Step 11
Entering this command allows the root user ID to read and run the
installer file.
Run the installer from a SSH Secure Shell Client software (or similar software)
window by following the procedure as described in the “Performing a Direct
Cisco IPICS Server Software Upgrade” section, starting with Step 7.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-9
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
Cisco IPICS Server Installation and Upgrade Guide
3-10
OL-12985-01
CH A P T E R
4
Uninstalling Cisco IPICS
This chapter provides information about the procedures that you need to follow to
uninstall the Cisco IPICS server software. You can perform the uninstallation
procedure in one of the following ways:
•
From the Cisco IPICS server by using a terminal console
•
From a remote PC on the network by using SSH Secure Shell Client software
(or similar software)
This chapter includes the following sections:
Note
•
Uninstalling the Cisco IPICS Server Software from the Server, page 4-2
•
Uninstalling the Cisco IPICS Server Software Remotely, page 4-3
The Cisco IPICS uninstallation procedure removes all of the components and
directories that were created during the Cisco IPICS installation. If you intend to
reinstall Cisco IPICS at a later time, Cisco recommends that you back up your
database and log files before you begin the uninstallation process.
For information about backing up files, refer to the “Performing Cisco IPICS
Backup and Restore Operations” chapter of the Cisco IPICS Server
Administration Guide, Release 2.1(1).
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
4-1
Chapter 4
Uninstalling Cisco IPICS
Uninstalling the Cisco IPICS Server Software from the Server
Note
Be aware that when you uninstall and reinstall the Cisco IPICS software,
communications are temporarily disrupted. Upon reinstallation, Cisco IPICS
disconnects VTGs and SIP-based PMC clients that were using RMS resources so
that the voice ports become available for use.
Uninstalling the Cisco IPICS Server Software from
the Server
To uninstall the Cisco IPICS software directly from the Cisco IPICS server,
perform the following procedure:
Procedure
Step 1
Access the Cisco IPICS server by using a terminal console.
Cisco IPICS displays the following text:
Cisco IPICS
hostname login:
where:
hostname specifies the host name of the Cisco IPICS server.
Step 2
Enter root in the hostname login: field; then, press Enter.
Cisco IPICS prompts you for the password for the root user.
Step 3
Enter the password for the root user; then, press Enter.
Step 4
To navigate to the directory where the uninstaller file is located, enter the
following command:
[root]# cd _uninstall_IPICS
Step 5
To begin the uninstallation process, enter the following command:
[root]# bash uninstall-ipics
Cisco IPICS Server Installation and Upgrade Guide
4-2
OL-12985-01
Chapter 4
Uninstalling Cisco IPICS
Uninstalling the Cisco IPICS Server Software Remotely
The uninstallation program prompts you to confirm the uninstallation process by
displaying the following text:
Do you want to remove Cisco IPICS software? (YES/NO):
Step 6
To confirm the uninstallation process, enter y or yes.
Cisco IPICS begins the uninstallation process.
Note
Be aware that the Cisco IPICS uninstallation process permanently
removes the Cisco IPICS software and deletes any Cisco IPICS
configuration data that you have stored in the server. If you need to save
your data, Cisco recommends that you first back up your data to a remote
host before you uninstall the software. For more information about
backing up your data, refer to the “Performing Cisco IPICS Backup and
Restore Operations” chapter of the Cisco IPICS Server Administration
Guide, Release 2.1(1).
After you have preserved a copy of your data, you can restart the
uninstallation process.
The uninstaller begins to uninstall the Cisco IPICS components.
After the uninstaller has finished removing the files, a message displays to prompt
you to reboot the server.
Step 7
To reboot the system, enter y or yes.
After the system reboots, the Cisco IPICS server software is removed.
Uninstalling the Cisco IPICS Server Software
Remotely
To uninstall the Cisco IPICS server software from a PC on the network, perform
the following procedure:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
4-3
Chapter 4
Uninstalling Cisco IPICS
Uninstalling the Cisco IPICS Server Software Remotely
Procedure
Step 1
Use SSH Secure Shell Client software (or similar software) to connect to the
server from your local workstation by choosing Start > Programs > SSH Secure
Shell > Secure Shell Client.
The SSH Secure Shell Client software window displays. The desktop of your PC
displays in the left pane.
Step 2
To open a window to enter the server IP address, click Quick Connect on the
button menu.
The Connect to Remote Host window displays.
Step 3
In the Host field, enter the IP address or the DNS name for your Cisco IPICS
server. Then, press Tab.
Step 4
In the User Name field, enter root. Then, click Connect.
The Enter Password window displays.
Step 5
Enter the root password; then, click OK.
The SSH Secure Shell Client connects to the Cisco IPICS server and displays a
command prompt for the root user.
Step 6
To change directories, enter the following command:
[root]# cd _uninstall_IPICS
Step 7
To begin the uninstallation process, enter the following command:
[root]# bash uninstall-ipics
The uninstallation program prompts you to confirm the uninstallation process by
displaying the following text:
Do you want to remove Cisco IPICS software? (YES/NO):
Step 8
To continue the uninstallation program, enter y or yes.
Cisco IPICS begins the uninstallation process.
Caution
Be aware that the Cisco IPICS uninstallation process permanently removes the
Cisco IPICS software and deletes any Cisco IPICS configuration data that you
have stored in the server. If you need to save your data, Cisco recommends that
you first back up your data to a remote host before you uninstall the software. For
more information about backing up your data, refer to the “Performing
Cisco IPICS Server Installation and Upgrade Guide
4-4
OL-12985-01
Chapter 4
Uninstalling Cisco IPICS
Uninstalling the Cisco IPICS Server Software Remotely
Cisco IPICS Backup and Restore Operations” chapter of the Cisco IPICS Server
Administration Guide, Release 2.1(1).
After you have preserved a copy of your data, you can restart the uninstallation
process.
The uninstaller begins to uninstall the Cisco IPICS components.
After the uninstaller has finished removing the files, a message displays to prompt
you to reboot the server.
Step 9
Enter y or yes to reboot the system.
After the system reboots, the Cisco IPICS server software is removed.
Step 10
To close the SSH Secure Shell Client window, click X.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
4-5
Chapter 4
Uninstalling Cisco IPICS
Uninstalling the Cisco IPICS Server Software Remotely
Cisco IPICS Server Installation and Upgrade Guide
4-6
OL-12985-01
CH A P T E R
5
Troubleshooting Cisco IPICS
Installation Issues
The issues that are described in this section may occur during, or as a result of,
installing the Cisco IPICS operating system or the Cisco IPICS server software.
Refer to the following sections in the Cisco IPICS Troubleshooting Guide,
Release 2.1(1) for information about the following components of Cisco IPICS:
•
For information about troubleshooting the PMC application, refer to the
“Troubleshooting Tips for the PMC Application” chapter in the Cisco IPICS
Troubleshooting Guide, Release 2.1(1).
•
For information about troubleshooting license issues, refer to the
“Troubleshooting License Issues” section of the “Troubleshooting the
Cisco IPICS Server” chapter in the Cisco IPICS Troubleshooting Guide,
Release 2.1(1).
This chapter includes the following sections:
•
Cisco IPICS Cannot Detect the NIC During Installation, page 5-2
•
No Network Connectivity After Connecting the Ethernet Cable to Interface 1
on the Server, page 5-6
•
The Cisco IPICS Operating System Detects Unsupported Hardware, page 5-7
•
The Server Cannot Allocate Partitions, page 5-7
•
Troubleshooting “Bad Interpreter: Permission Denied” Errors, page 5-8
•
Troubleshooting “Permission Denied” Errors, page 5-8
•
SSH Loses Connectivity While You Perform a Remote Server Software
Installation, page 5-9
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
5-1
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
Cisco IPICS Cannot Detect the NIC During Installation
•
You Cannot Connect to the Server By Using Your Browser, page 5-10
•
Cisco IPICS Displays an Authorization Error, page 5-15
Cisco IPICS Cannot Detect the NIC During
Installation
Problem During the installation of the Cisco IPICS operating system on the
Cisco MCS 7825-H2 server, the Kudzu hardware detection utility window timed
out, or you chose Ignore the device. The Cisco IPICS operating system cannot
detect any of the NICs in your server. You have no network connectivity.
Solution You have to rerun the Kudzu hardware detection utility so that the
Cisco IPICS operating system can detect the NICs. Then, you need to configure
the eth0 interface for IP connectivity.
Perform the following steps to configure the hardware by using the Kudzu
hardware detection utility and configure the eth0 interface for IP connectivity:
Procedure
Step 1
Log in to the Cisco IPICS server with the root user ID.
You must be directly connected to the terminal by a console connection.
Step 2
To confirm that the Kudzu hardware detection utility did not configure the
eth0 interface, enter the following command:
[root]# ifconfig -a
If the interface has not been configured, output that is similar to the following
example displays:
[root]# ifconfig -a
lo
Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:316510 errors:0 dropped:0 overruns:0 frame:0
TX packets:316510 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:149449273 (142.5 Mb) TX bytes:149449273 (142.5 Mb)
Cisco IPICS Server Installation and Upgrade Guide
5-2
OL-12985-01
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
Cisco IPICS Cannot Detect the NIC During Installation
The preceding example shows that the Cisco IPICS operating system configured
the loopback (lo) interface, and did not configure the eth0 interface.
Step 3
Enter the following command to start the Kudzu hardware detection utility:
[root]# service kudzu start
The system displays the Kudzu hardware detection utility window.
Step 4
To configure the system hardware, press any key before the Kudzu window times
out.
Step 5
Perform the following steps, depending on the window that the system displays:
•
Note
•
Step 6
If you see a window that indicates that the system added or removed a NIC,
continue with Step 6.
A window indicating that a NIC was added indicates that the Kudzu
hardware detection utility detected the NIC for the eth0 interface, and you
configure the NIC in Step 6. A window indicating that a NIC was
removed indicates that the utility removed an existing NIC configuration,
and you reconfigure the NIC in Step 6.
If you see a window that indicates that the system detected the Intel SATA
controller, proceed to Step 11.
Perform one of the following actions, depending on the window that the system
displays:
•
If a window displays to indicate that the system added a NIC, press Enter to
choose the Configure option from the following choices.
– Configure—Choose this option to configure the NIC. This option
specifies the default.
– Ignore the device—Choose this option if you do not have hardware that
needs to be added to the system.
– Do nothing—Choose this option if you do not want to configure the
hardware. If you reboot the server, the hardware configuration utility will
detect the hardware as being newly installed, and the system prompts you
to configure it.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
5-3
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
Cisco IPICS Cannot Detect the NIC During Installation
•
If you already configured the eth0 interface, a window displays to indicate
that the system removed a NIC. If this window displays, press the Tab key,
select Keep configuration, and press Enter to select the Keep configuration
option from the following choices:
– Remove configuration—Choose this option to remove the configuration
for the NIC.
– Keep configuration—Choose this option to keep the configuration for
the NIC.
– Do nothing—Choose this option to do nothing to the NIC configuration.
Note
Be careful not to remove the Remove configuration option, as this option
removes all of the NIC configuration.
The Cisco IPICS operating system configuration program displays the interface
configuration window.
Step 7
If you configured the NIC in Step 6, press the space bar to choose Use dynamic
IP/configuration (BOOTP/DHCP).
An asterisk displays in the check box area to indicate that you have chosen to use
the Dynamic Host Configuration Protocol (DHCP).
Note
This step allows the Cisco IPICS operating system to detect the NIC that
controls the interface on your server. Cisco IPICS does not use DHCP.
You must use a static IP address to configure your Cisco IPICS server for
network connectivity. You perform the IP configuration steps as described
in Step 12.
Step 8
Press Tab or use the left and right arrows to choose OK.
Step 9
To accept your choice, press Enter.
Step 10
If the operating system configuration program displays a second window that
indicates that the Cisco IPICS operating system detected another NIC, perform
the following actions to ignore the configuration for the eth1 interface:
a. Press Tab to choose Ignore.
b. Press Enter to confirm.
Cisco IPICS Server Installation and Upgrade Guide
5-4
OL-12985-01
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
Cisco IPICS Cannot Detect the NIC During Installation
Note
Make sure that you do not configure the eth1 interface. Cisco IPICS
does not support the configuration of the eth1 interface.
The Cisco IPICS operating system configuration program continues
without configuring the eth1 interface, and displays a window to indicate
that it detected the Intel SATA Controller.
Step 11
Press Enter to accept the Configure option and configure the Intel SATA
controller.
The system automatically configures the Intel SATA controller.
Step 12
To configure your network for use with Cisco IPICS, enter the following
command:
[root] modify_ip
The system displays text that is similar to the following example:
Use this tool to facilitate changing the Cisco IPICS server network
settings,
such as IP address or host name.
To change the current settings, enter the new values below.
To accept the existing values without making any changes, press Enter.
ip address for interface eth0[10.1.1.1]:
Step 13
Enter the IP address for your server; then, press Enter.
The system displays the following text:
Subnet mask for interface eth0[]:
Step 14
Enter the subnet mask for your IP address; then, press Enter.
The system displays the following text:
default gateway[]:
Step 15
Enter the default gateway for your network and press Enter.
The system displays the other fields that you configure to ensure network
connectivity.
Step 16
Enter the host name, domain name, primary DNS server and (optional) any
secondary DNS servers when you are prompted. Press Enter after each entry.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
5-5
Chapter 5 Troubleshooting Cisco IPICS Installation Issues
No Network Connectivity After Connecting the Ethernet Cable to Interface 1 on the Server
Note
Step 17
Make sure that you also update your DNS servers if you want to access
Cisco IPICS by using the host name.
Press Y; then, press Enter to confirm the entries.
The system displays text that it similar to the following example:
The tool is now ready to modify your system configuration.
After changing the configuration files, the tool will initiate a
system shutdown and restart the server.
If you are using a network connection, your session will be
interrupted and you will need to
reconnect by using the new settings:
IP Address: 10.1.1.1
Hostname: myhostname
Enter Y to proceed with these values or N to cancel[N]:
Step 18
Press Y; then, press Enter to confirm your choices and reboot the server.
The server reboots and displays the Login screen.
No Network Connectivity After Connecting the
Ethernet Cable to Interface 1 on the Server
Problem After you install the Cisco IPICS operating system software, you cannot
connect your server to the network. The Ethernet cable is connected to Ethernet
interface 1 on the server. The connection uses DHCP.
Solution If your interfaces are labeled 1 and 2, the server might map the eth0 port
to interface 2. Connect the Ethernet cable to interface 2 on your server and try to
reestablish connectivity, or consult your server documentation to determine the
mapping scheme for the eth0 port.
Note
If your interfaces are labeled NIC 1 and NIC 2, connect the Ethernet cable to the
NIC 1 interface.
Cisco IPICS Server Installation and Upgrade Guide
5-6
OL-12985-01
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
The Cisco IPICS Operating System Detects Unsupported Hardware
The Cisco IPICS Operating System Detects
Unsupported Hardware
Problem When you install the Cisco IPICS operating system software, a message
displays to inform you that the hardware platform is not supported.
Solution The installation program includes hardware detection logic that checks
for supported parameters on the server. If any of the parameters do not match with
the information that is contained in the installation program, an unsupported
hardware message displays. For instance, if you install the Cisco IPICS operating
system on a supported server model that does not have the required amount of
memory installed, the installation program detects an unsupported parameter. In
this case, the server model is actually supported, but because there is insufficient
memory to support Cisco IPICS, the message displays.
Make sure that you check the Cisco IPICS Compatibility Matrix at the following
URL for the most current versions of compatible hardware components, including
memory requirements, and software versions for use with Cisco IPICS:
http://www.cisco.com/en/US/products/ps7026/
tsd_products_support_series_home.html
The Server Cannot Allocate Partitions
Problem When you attempt to install the Cisco IPICS operating system software,
the server displays the following error message:
Could not allocate requested partitions:
Partitioning Failed: Could not allocate partitions
Press OK to reboot system.
Solution You may encounter this error if the server does not have sufficient hard
disk space. Make sure that no hard disks have been removed from your server;
your server must have 160 GB of hard disk space to function properly with the
Cisco IPICS operating system.
For more information, refer to the Cisco IPICS Compatibility Matrix.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
5-7
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
Troubleshooting “Bad Interpreter: Permission Denied” Errors
Troubleshooting “Bad Interpreter: Permission
Denied” Errors
Problem You attempt to install the Cisco IPICS server software by using the
following command, and the installer displays a bad interpreter error that is
similar to the following example:
[root]# ./ipics-installer.run
./ipics-installer.run
-bash: ./ipics-installer.run: /bin/bash: bad interpreter: Permission
denied
where:
ipics-installer.run represents the name of the Cisco IPICS installer file that you
are attempting to run.
Solution The shell interpreter script for the Cisco IPICS operating system
misinterprets the ./ command. To fix this problem, replace ./ with the bash
command, as shown in the following example:
[root]# bash <name-of-installer-file>.run
where:
<name-of-installer-file>.run represents the name of the Cisco IPICS installer file
that you are attempting to run.
Troubleshooting “Permission Denied” Errors
Problem When you start the Cisco IPICS server software installation, the installer
displays a permission denied error message that is similar to the following
example:
[root]# bash ipics-installer.run
-bash: bash ipics-installer.run: Permission denied
where:
ipics-installer.run represents the name of the Cisco IPICS installer file that you
are attempting to run.
Cisco IPICS Server Installation and Upgrade Guide
5-8
OL-12985-01
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
SSH Loses Connectivity While You Perform a Remote Server Software Installation
Solution The secure copy or FTP program saved the .run file as a read-only file
and the system cannot run the file. Modify the file to so that the system can run it,
as shown in the following example:
[root] # chmod 550 <name-of-installer-file>.run
where:
<name-of-installer-file>.run is the name of the Cisco IPICS installer file.
Note
Entering this command allows the root user ID to read and run the installer file.
SSH Loses Connectivity While You Perform a
Remote Server Software Installation
Problem When you perform a remote installation of the Cisco IPICS server
software, the SSH program loses connectivity with the server and the installation
does not complete.
Solution Reconnect to the server by using SSH; then, retry the remote server
software installation by performing the procedure in the “Performing a Remote
Cisco IPICS Server Software Installation” section on page 2-21.
Note
Make sure that the SSH program has uninterrupted connectivity to the server
while the installation program runs; even a momentary loss of connectivity can
terminate the program.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
5-9
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
You Cannot Connect to the Server By Using Your Browser
You Cannot Connect to the Server By Using Your
Browser
Problem After you install Cisco IPICS, you enter the IP address or the host name
for the Cisco IPICS server into a supported browser but you cannot contact the
server.
Solution If you cannot connect to the Cisco IPICS server through a browser, one
of the following situations may have occurred:
•
You entered the incorrect IP address or DNS name for the Cisco IPICS server
•
The tomcat service is not running
•
The database server is not running
•
A security setting on your computer has caused a required JavaScript add-on
to become disabled
To diagnose the problem, perform the following procedure:
Procedure
Step 1
Step 2
Make sure that the URL that you entered is correct by performing the following
actions:
•
Ensure that you are using the secure HTTP URL, https:// in the URL address
field.
•
Check that you entered in to the browser the correct IP address for the
Cisco IPICS server.
•
If you entered the DNS name for the server, ensure that the DNS name is
correct and that your network is able to resolve the DNS name. If you
conclude that your network is not resolving the server DNS name correctly,
enter the IP address in the URL address field.
If you still cannot access the Administration Console, Log in to the Cisco IPICS
server with the root user ID by performing one of the following actions:
Cisco IPICS Server Installation and Upgrade Guide
5-10
OL-12985-01
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
You Cannot Connect to the Server By Using Your Browser
•
Use a terminal console to log in to the server by following these steps:
a. Connect to the server by using a terminal console.
a. Log in to the server by entering root for the user name.
b. When you are prompted, enter the root user password.
•
Log in to the server remotely by following these steps:
a. Open a terminal window by using SSH Secure Shell Client software or
similar software.
b. Log in to the server by entering the IP address or host name of the server.
c. Log in by using the root user ID by entering root for the user name.
d. When you are prompted, enter the root user password.
Note
You might not be able to connect to the server remotely if your server
is experiencing network connectivity problems; in this case, connect
to the server by using a terminal console.
A terminal window displays.
Step 3
Ensure that the tomcat service is running by entering the following command:
[root]# service ipics_tomcat status
Step 4
Perform one of the following actions, depending on the output that you receive:
•
If the tomcat service is running, you receive output that is similar to the
following example:
[root]# service ipics_tomcat status
Tomcat process (pid: 24025) is running on the system
If you receive output that indicates that the tomcat service is running,
continue to Step 8.
•
If the tomcat service is not running, you receive output that is similar to the
following example:
[root]# service ipics_tomcat status
PID_SEARCH_RESULT=
Tomcat is not running on the system.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
5-11
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
You Cannot Connect to the Server By Using Your Browser
If you receive output that indicates that the tomcat service is not running,
restart the tomcat service and the policy engine by entering the following
command:
[root]# service ipics restart
Note
Step 5
Be aware that Cisco IPICS cancels any active dial-in or dial-out calls
when you enter the service ipics restart command.
If the tomcat service does not run after you restart it manually, perform the
following actions:
a.
Check whether Cisco IPICS already installed the crontab file by entering the
following command:
[root]# crontab -l -u ipicsadmin
Note
b.
The crontab file runs a process that checks if the tomcat service and
database are running, and starts them if they are not running.
If the crontab command returns a message that is similar to the following
message, the tomcatcron file already exists. Continue to Step 8.
[root]# crontab -l -u ipicsadmin
#-------------------------------------------------------------#
# Module: ipicsadmin.cron - Cisco IPICS cron file for user
'ipicsadmin'
#
# Usage: crontab < ipicsadmin.cron
#
# Environment Variables:
#
#--------------------------------------------------------------SHELL=/bin/sh
MAILTO=root
HOME=/opt/cisco/ipics/tomcat
* * * * * /opt/cisco/ipics/bin/check_tomcat >>
/opt/cisco/ipics/tomcat/current/logs/ipicsadmin_cron.log 2>&1
c.
If the crontab command returned a message such as no crontab for
ipicsadmin, install the crontab file by entering the following command:
Cisco IPICS Server Installation and Upgrade Guide
5-12
OL-12985-01
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
You Cannot Connect to the Server By Using Your Browser
[root]# crontab /opt/cisco/ipics/cron/ipicsadmin.cron
Cisco IPICS installs the crontab file.
Almost immediately, Cisco IPICS starts the tomcat service. You can then log
in to the Administration Console by using your browser.
For information about starting and restarting the Cisco IPICS tomcat service,
see the “Performing Tomcat Service Procedures” section in the
“Troubleshooting Cisco IPICS Network Processes” chapter in the
Cisco IPICS Troubleshooting Guide, Release 2.1(1).
Step 6
To check the status of the database, enter the following command:
[root]# onstat If the database is online and running, the command returns output that is similar
to the following example.
IBM Informix Dynamic Server Version 10.00.UC1
00:16:14 -- 124036 Kbytes
-- On-Line -- Up
If the database is not running, the command returns output that is similar to the
following example.
shared memory not initialized for INFORMIXSERVER 'IPICSDBServer'
If the command output indicates that the database is not running, continue to
Step 7.
Step 7
If the database is not running, manually start the database server by entering the
following command:
[root]# service ipics_db start
Step 8
To verify that the static IP address, subnet mask, and default gateway are properly
configured, check your IP connectivity by entering the following command:
ping <default gateway IP address>
where:
<default gateway IP address> represents the default gateway address for your
network.
Step 9
If the ping command is not successful, unplug the network cable from interface 1
on the server and connect it to interface 2.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
5-13
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
You Cannot Connect to the Server By Using Your Browser
Note
Generally, for servers that label their Ethernet interfaces as NIC 1 and
NIC 2, you connect the Ethernet cable to the NIC 1 interface; this
interface is usually the eth0 interface. For servers that label their Ethernet
interfaces as 1 and 2, it is possible that the eth0 interface is mapped to
interface 2. Consult your server product documentation to confirm the
interface mapping.
Step 10
Retry Step 8 to verify server network connectivity.
Step 11
If the ping command is successful, log in to another server on the network and
attempt to ping the Cisco IPICS server.
If the ping command is not successful, troubleshoot the network connectivity with
your network administrator.
Step 12
Check the security settings for the computer from which you are attempting to
access the Administration Console.
Note
For enhanced security, Cisco recommends that you review and follow the
recommendations that are included in the Windows XP Security Guide.
To find this document, refer to the Microsoft support site at
http://support.microsoft.com/ and search for “Windows XP Security
Guide.”
When you follow the recommendations that are included in the Windows XP
Security Guide and deny all add-ons, except those that are specifically allowed in
the add-on list, you may encounter a problem where you cannot access the
Cisco IPICS server Administration Console. This issue occurs when you use
Internet Explorer from a PC that runs Microsoft Windows XP SP2 and have not
enabled the JavaScript GUID in the add-on list.
To resolve this issue and ensure proper operation from Internet Explorer, you must
explicitly enable the following JavaScript GUID add-on on your PMC client
machine:
GUID: {F414C260-6AC0-11CF-B6D1-00AA00BBBB58} - JavaScript
For detailed information about how to enable this add-on, refer to the Microsoft
support site at http://support.microsoft.com/ and search for Article ID 555235.
Step 13
Retry accessing the server by entering the following URL in the supported
browser:
Cisco IPICS Server Installation and Upgrade Guide
5-14
OL-12985-01
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
Cisco IPICS Displays an Authorization Error
https://<ipaddress> | <dnsname>
where:
<ipaddress> or <dnsname> represents the IP address or DNS name of the server.
If you still cannot access the server, contact your Cisco technical support
representative for assistance.
Cisco IPICS Displays an Authorization Error
Problem After installing Cisco IPICS, you log in to the Administration Console
and receive an authorization error.
Solution An authorization error may occur in one of the following circumstances:
•
You may have entered an incorrect user name or password
•
The database server may not have started.
To resolve this problem, perform the following procedure:
Procedure
Step 1
Before you check the status of the database server, verify that you entered the
correct user name and password, and that the Caps Lock setting is not on.
If you confirm that you entered the correct login information for the Cisco IPICS
Administration Console and still receive an authorization error, you must check
the status of the database. Continue to Step 3.
Step 2
Access the Cisco IPICS server by using a terminal console.
Cisco IPICS displays the following text:
Cisco IPICS
hostname login:
with hostname being the host name of the Cisco IPICS server.
Step 3
Enter root in the hostname login: field and press Enter.
Cisco IPICS prompts you for the password for the root user.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
5-15
Chapter 5
Troubleshooting Cisco IPICS Installation Issues
Cisco IPICS Displays an Authorization Error
Step 4
Enter the password for the root user and press Enter.
Step 5
To check the status of the database, enter the following command:
[root] #onstat If the database is online and running, the command returns a response that is
similar to the following example:
IBM Informix Dynamic Server Version 10.00.UC1
00:16:14 -- 124036 Kbytes
-- On-Line -- Up
If the database is not running, the command returns a response that is similar to
the following example:
shared memory not initialized for INFORMIXSERVER 'IPICSDBServer'
Step 6
If the database is not running, manually start the database by entering the
following command:
[root] #service ipics_db start
Cisco IPICS Server Installation and Upgrade Guide
5-16
OL-12985-01
G L O S S A RY
A
activated
A VTG state that indicates that the SIP (unicast) line or multicast line is fully
operational. The PTT and volume indicators appear highlighted.
activating
A VTG state that becomes effective when the Activate button is clicked. The
Activate button appears highlighted while the other PMC buttons remain in an
inactive state as the system attempts to activate and connect.
activation button
This button toggles activate and deactivate functionality on the PMC. Click this
button on the PMC to activate a channel (to call out); click it again to deactivate
the channel.
active virtual talk
group
A virtual talk group (VTG) becomes active when Cisco IPICS commits global
resources, such as a multicast address and any necessary dial-in peers, so that the
participants in the VTG can communicate with each other.
Administration
Console
The graphical user interface (GUI) in the Cisco IPICS server software through
which authorized Cisco IPICS users can manage and configure Cisco IPICS
resources, events and VTGs.
autonomous
system
A radio system under one administrative control; also known as a management
domain. This system is usually mapped to an agency.
B
backward
compatibility
The ability of newer radio equipment to operate within an older system
infrastructure or to directly intercommunicate with an older radio unit. The term
usually applies to digital radios that are also capable of analog signal
transmission.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-1
Glossary
bandwidth
The difference between the highest and lowest frequencies that are available for
network signals. The term also describes the rated throughput capacity of a
specific network medium or protocol. Bandwidth specifies the frequency range
that is necessary to convey a signal measured in units of hertz (Hz). For example,
voice signals typically require approximately 7 kHz of bandwidth and data
traffic typically requires approximately 50 kHz of bandwidth.
base station
A land station in the land mobile radio service. In the personal communication
service, the common name for all the radio equipment that is located at one fixed
location and used for serving one or several calls.
C
CAI
common air interface. The standard for the digital wireless communications
medium that is employed for P25-compliant radio systems and equipment. The
standard for P25 Phase I incorporates Frequency Division Multiple Access
(FDMA) technology.
call
Radio terminology that defines a call as beginning at the moment that you press
the transmit key and concluding when you release the transmit key. The term
“per call” implies that some form of control causes the radio to select a specific
frequency before it transmits audio. Some radios may be configured to
automatically return to a predefined RF channel when the call ends.
call delay
The delay that occurs when there is no idle channel or facility available to
immediately process a call that arrives at an automatic switching device.
call setup time
The time that is required to establish a circuit-switched call between users or
terminals.
carrier
A wave that is suitable for modulation by an information-bearing signal.
CAS
channel associated signaling. The transmission of signaling information within
the voice channel. CAS signaling often is referred to as robbed-bit signaling
because user bandwidth is being robbed by the network for other purposes.
Cisco IPICS Server Installation and Upgrade Guide
GL-2
OL-12985-01
Glossary
channel
A communication path that is wide enough to permit a single RF transmission.
Multiple channels can be multiplexed over a single cable in certain
environments. There are many different types of channels in Cisco IPICS,
including direct dial, 2-way, VTGs, and radio channels. Channels can be
dynamically or statically allocated. Channels may have one or more channel
connections that define the source for the channel. See PTT channel.
channel capacity
The maximum possible information transfer rate through a channel, subject to
specified constraints.
channel connection
One or more methods by which a content stream can be obtained. For instance,
a particular channel may be found on several different multicast addresses in
different locations and also on several different radios at different locations.
channel folder
A logical grouping of channels
channel select check Provides the ability to select or deselect the specified channel on the PMC for
box
audio transmission.
channel spacing
The distance from the center of one channel to the center of the
next-adjacent-channel. Typically measured in kilohertz.
Cisco Unified
Communications
Manager
(CallManager)
The software-based call-processing component of the Cisco IP telephony
solution. Cisco Unified Communications Manager (CallManager) extends
enterprise telephony features and functions to packet telephony network devices,
such as Cisco Unified IP Phones, media processing devices, VoIP gateways, and
multimedia applications.
Cisco IPICS
Cisco IP Interoperability and Collaboration System. The Cisco IPICS system
provides an IP standards-based solution for voice interoperability by
interconnecting voice channels, talk groups, and VTGs to bridge
communications amongst disparate systems.
Cisco IPICS policy
engine
Integrated with the Cisco IPICS server, this component enables telephony dial
functionality and is responsible for the management and execution of policies
and user notifications.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-3
Glossary
Cisco IPICS server
Provides the core functionality of the Cisco IPICS system. The Cisco IPICS
server software runs on the Linux operating system on selected Cisco Media
Convergence Server (MCS) platforms. The server software includes an incident
management framework administration GUI that enables dynamic resource
management for users, channels, and VTGs. The server also includes the
Cisco IPICS policy engine, which enables telephony dial functionality and is
responsible for the management and execution of policies and user notifications.
Cisco Unified
IP Phone
A full-featured telephone that provides voice communication over an IP
network. A user can participate in a PTT channel or VTG by using a
Cisco Unified IP Phone as a PTT device.
Cisco Security
Agent
Provides threat protection for server and desktop computing systems (endpoints)
by identifying, preventing, and eliminating known and unknown security threats.
CLI
command-line interface. An interface that allows the user to interact with the
operating system by entering commands and optional arguments.
codec
coder-decoder.
1. Integrated circuit device that typically uses pulse code modulation to
transform analog signals into a digital bit stream and digital signals back into
analog signals.
2. In Voice over IP, Voice over Frame Relay, and Voice over ATM, a DSP
software algorithm that is used to compress/decompress speech or audio signals.
conference of
conferences
A conference that consists of two or more VTGs.
conventional radio
system
A non-trunked system that is similar to telephone party-line in that the user
determines availability by listening for an open channel.
COR
carrier operated relay. An electrical signal that is used to signal when a radio is
receiving traffic.
coverage
In radio communications, the geographical area that is within the range of, or
that is covered by, a wireless radio system to enable service for radio
communications. Also referred to as service delivery area.
Cisco IPICS Server Installation and Upgrade Guide
GL-4
OL-12985-01
Glossary
D
delay time
The sum of waiting time and service time in a queue.
decrypt
Cryptographically restore ciphertext to the plaintext form it had before
encryption.
decryption
Reverse application of an encryption algorithm to encrypted data, thereby
restoring that data to its original, unencrypted state.
dial engine scripts
Scripts that the Cisco IPICS dial engine executes to provide the telephony user
interface (TUI) for interaction with incoming and outgoing phone calls.
dial-in
A phone call that is dialed in to the policy engine.
dial-in floor control
A feature that allows one dial-in user, at a time, to talk in a VTG or a channel.
The telephony user interface provides this dial-in floor control feature to support
dial-in users. It does not provide support for floor control for other PTT users.
dial number
The phone number that is used by the policy engine and the SIP provider and
configured in the Dial Information pane in the Ops Views window. Dialing this
number provides user access to the telephony user interface.
dial out invite
An action that invites selected user(s) to the selected VTG.
A phone call that is dialed out by the policy engine to a phone user to invite the
user in to a talk group.
dial peer
Addressable call endpoint. In Voice over IP, there are two kinds of dial peers:
POTS and VoIP.
digit ID
A numeric identifier that is chosen by a Cisco IPICS user and stored in the user
profile. Cisco IPICS uses this ID and a numeric password to authenticate a
Cisco Unified IP Phone user.
digital modulation
technique
A technique for placing a digital data sequence on a carrier signal for subsequent
transmission through a channel.
discrete tone
Any tone that is sent without any summed or added tone. For example, adding a
function tone with a low level guard tone may impact the recognition of the
function tone. Contrast with mixed tones.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-5
Glossary
dispatcher
The Cisco IPICS dispatcher is responsible for setting up the VTGs, activating the
VTGs to begin conferences, and adding and/or removing participants in inactive
VTG and active VTGs. The dispatcher also monitors the active VTGs and
events, can mute and unmute PMC users, as necessary, and manages policies,
which activate/deactivate VTGs based on specific criteria and designated
intervals. Policy management activities include create/modify/delete policies,
view policies, execute policies, and activate privileges.
DS0
digital service zero (0). Single timeslot on a DS1 (also known as T1) digital
interface—that is, a 64-kbps, synchronous, full-duplex data channel, typically
used for a single voice connection on a PBX.
DTMF
dual tone multi-frequency. The signal to the phone company that you generate
when you press keys on a telephone keypad. With DTMF, each key that you
press on your phone (0 through 9, ‘*’ and ‘#’) generates two tones of specific
frequencies; one tone is generated from a high frequency group of tones and the
other from a low frequency group. Voice gateways often strip these inband tones
and present them out-of-band in SIP, H.323, or other messages.
dynamic radio
channel (dynamic
control)
The controls that are used to preset radio characteristics so that channels are
available to clients.
dynamic regrouping A trunking system feature that allows multiple radios to be placed upon a
specific talk group without manual manipulation of the programming of the
radios. Dynamic regrouping is initiated through a system control console and
transmitted to the radio via the trunking systems control channel.
Cisco IPICS Server Installation and Upgrade Guide
GL-6
OL-12985-01
Glossary
E
E&M
recEive and transMit (or ear and mouth). As the analog interface between a radio
and the LMR gateway, the E&M interface provides voice signals from radio
channels, which are then mapped to IP multicast or unicast. The E&M interface
provides the most common form of analog trunking.
1. Trunking arrangement that is generally used for two-way switch-to-switch or
switch-to-network connections. Cisco's analog E&M interface is an RJ-48
connector that allows connections to PBX trunk lines (tie lines). E&M also is
available on E1 and T1 digital interfaces.
2. A type of signaling that is traditionally used in the telecommunications
industry. Indicates the use of a handset that corresponds to the ear (receiving)
and mouth (transmitting) component of a telephone.
e-lead
The ear portion of the E & M interface. The e-lead is the receive path of the
LMR gateway.
encipher
To convert plain text into an unintelligible form by using a cipher.
encode
To modify information into the required transmission format.
encryption
Application of a specific algorithm so as to alter the appearance of data and make
it incomprehensible to unauthorized users.
event
An active VTG in the Cisco IPICS solution.
F
FDM
frequency-division multiplexing. Technique whereby information from multiple
channels can be allocated bandwidth on a single wire based on frequency.
FDMA
frequency-division multiple access. A a channel access method in which
different conversations are separated onto different frequencies. FDMA is
employed in narrowest bandwidth and multiple-licensed channel operations.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-7
Glossary
FLEXlm
Cisco software that enforces licensing on certain systems; FLEXlm ensures that
Cisco IPICS software will work only on the supported and licensed hardware.
floor control
The standard mechanism for Push-to-Talk speaker arbitration.
frame
A logical grouping of information sent as a data link layer unit over a
transmission medium. Often refers to the header and the trailer, used for
synchronization and error control, that surround the user data contained in the
unit. The terms cell, datagram, message, packet, and segment also describe
logical information groupings at various layers of the OSI reference model.
frequency
For a periodic function, frequency represents the number of cycles or events per
unit of time. Frequency is used in several different contexts. For example,
transmission frequency (the band on which the radio sends signals) or the
frequency of an audible signal measured in hertz (Hz). All tone control
operations require audible tones that fall within a narrow band of a specific
frequency and at a specific volume (amplitude).
frequency
assignment
Assignment that is given to a radio station to use a radio frequency or radio
frequency channel under specified conditions.
frequency hopping
The repeated switching of frequencies during radio transmission according to a
specified algorithm, intended to minimize unauthorized interception or jamming
of telecommunications.
frequency
modulation
Modulation technique in which signals of different frequencies represent
different data values.
frequency sharing
The assignment to or use of the same radio frequency by two or more stations
that are separated geographically or that use the frequency at different times.
function tone
A tone that follows the high level guard tone and causes the radio to perform a
specific function, such as selecting a new transmit frequency. Function tones are
often referred to as F1, F2, F3, and so on. See preamble and high level guard
tone.
Cisco IPICS Server Installation and Upgrade Guide
GL-8
OL-12985-01
Glossary
G
gateway
Device that performs an application-layer conversion of information from one
protocol stack to another. In Cisco IPICS, the gateway component includes LMR
gateways, which functionality is usually installed as an additional feature in a
supported Cisco router. LMR gateways provide voice interoperability between
radio and non-radio networks by bridging radio frequencies to IP multicast
streams.
GRE
generic routing encapsulation. Tunneling protocol that can encapsulate a wide
variety of protocol packet types inside IP tunnels, creating a virtual
point-to-point link to Cisco routers at remote points over an IP internetwork. By
connecting multiprotocol subnetworks in a single-protocol backbone
environment, IP tunneling that uses GRE allows network expansion across a
single-protocol backbone environment. GRE is generally used to route multicast
traffic between routers.
guard tone
The most common guard tones are the high level guard tone (HLGT) and the low
level guard tone (LLGT). The HLGT is used to alert the radio that a function tone
follows. The LLGT is used as a hold tone or keying tone. See tone keyed.
H
H.323
Defines a common set of codecs, call setup and negotiating procedures, and
basic data transport methods to allow dissimilar communication devices to
communicate with each other by using a standardized communication protocol.
high-band
frequency
Refers to the higher frequency levels in the VHF band, typically 138-222 MHz.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-9
Glossary
HLGT
high level guard done. Also known as awake tone. This tone is set at high volume
and is usually the first tone in a preamble. It is used to alert the radio that another
tone, usually a function tone, will follow. See guard tone.
Hoot ‘n’ Holler
(Hootie)
A communications system where the loudest and most recent talker or talkers are
mixed into one multicast output stream. Also known as hootie, these networks
provide “always on” multiuser conferences without requiring that users dial in
to a conference.
Cisco enables the Cisco Hoot 'n' Holler feature in specific Cisco IOS versions.
I
idle tone
The tone that a radio may deliver on the m-lead to signal the LMR gateway that
there is no incoming traffic. When the idle tone is removed, the LMR gateway
deems all signals to be valid voice traffic.
inactive VTG
A VTG that is stored for use. The Cisco IPICS server stores inactive VTGs with
the information that you enter so that they can be automatically activated by a
policy or manually activated by a dispatcher.
inband
Traffic that is sent inband is included in the same stream as the real-time traffic
protocol (RTP). Inband signals can be encoded signals and RFC 2833 signals.
incident
management
framework
A software framework that includes an adaptable GUI to facilitate resources,
such as users, radio channels, cameras, and sensor information, for delivery that
is based upon policy or incident needs.
informix linux group Members of this group have full permission to Cisco IPICS server folders, files,
and scripts that are related to the Informix database application. Members of this
group include the informix and ipicsdba users.
Cisco IPICS Server Installation and Upgrade Guide
GL-10
OL-12985-01
Glossary
informix user ID
The Cisco IPICS Linux user that belongs to both the informix linux group,
which includes full permission to the Cisco IPICS database server folders, files,
and scripts, and the ipics linux group, which includes permission to Cisco IPICS
application-related folders, files, and scripts. In addition, this user has full
administrative permission to the Informix database instance. Cisco IPICS
creates this Linux system user ID and generates the password during the
software installation process. The password for this user ID never expires.
To access the informix user, log in to the Cisco IPICS server by using the root
user ID; then, enter su - informix (superuser from root).
interference
The effect of unwanted energy due to one or a combination of emissions,
radiation, or inductions upon reception in a radio communication system,
manifested by any performance degradation, misinterpretation, or loss of
information, which could be extracted in the absence of such unwanted energy.
interoperability
The capability of equipment manufactured by different vendors to communicate
with each other successfully over a network.
invitation policy
A policy that can be invoked only through the telephony user interface and can
include only the invite to VTG action. After joining a talk group, a user can
access the breakout menu and invoke invitation policies. The talk group that this
user has joined is the talk group that the invited users join.
invite to VTG
A version of the dial out invite action where users to be invited are preconfigured
but the VTG that they are invited to depends on which VTG the invoker of the
policy is dialed into.
ipicsadmin user ID
The Cisco IPICS Linux user that, as part of the ipics linux group, has full
permission to the Cisco IPICS server folders, files, and scripts that are related to
the Cisco IPICS application and database backup and restore operations. In
addition, the ipicsadmin user has permission to read and write data from and/or
to the Informix database. Cisco IPICS creates this Linux system user ID during
the software installation process. The password for this user ID never expires.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-11
Glossary
ipicsdba user ID
The Cisco IPICS Linux user that belongs to both the informix linux group,
which includes full permission to the Cisco IPICS database server folders, files,
and scripts, and the ipics linux group, which includes permission to Cisco IPICS
application-related folders, files, and scripts. In addition, the ipicsdba user has
permission to read data, write data, create tables, and create databases in the
Informix database instance. Cisco IPICS creates this Linux system user ID and
generates the password during the software installation process. The password
for this user ID never expires.
To access the ipicsdba user, log in to the Cisco IPICS server by using the root
user ID; then, enter su - ipicsdba (superuser from root).
ipics linux group
Members of this group have full permission to Cisco IPICS server folders, files,
and scripts that are related to the Cisco IPICS application and database backup
and restore operations. Members of this group include the ipicsadmin, ipicsdba,
and informix users.
ipics user ID
The Cisco IPICS application-level user ID that can perform all
administration-related tasks via the Cisco IPICS Administration Console.
Cisco IPICS creates this web-based user ID during the software installation
process.
IPSec
IP Security. A framework of open standards that provides data confidentiality,
data integrity, and data authentication between participating peers. IPSec
provides these security services at the IP layer. IPSec uses IKE to handle the
negotiation of protocols and algorithms based on local policy and to generate the
encryption and authentication keys to be used by IPSec. IPSec can protect one
or more data flows between a pair of hosts, between a pair of security gateways,
or between a security gateway and a host.
K
keepalive
A message that is sent by one network device to inform another network device
that the virtual circuit between the two devices is still active.
Cisco IPICS Server Installation and Upgrade Guide
GL-12
OL-12985-01
Glossary
key
The parameter that defines an encryption code or method.
Key (a radio) causes the radio to transmit. See tone keyed.
kilohertz (kHz)
A unit of frequency that denotes one thousand Hz.
L
latch
The PMC functionality that allows a Cisco IPICS user to lock in a PTT channel.
linear modulation
A radio frequency transmission technique that provides the physical transport
layer of a radio system. This technology is compatible in digital and analog
system environments and supports channel bandwidths of 5 kHz to 50 kHz.
LLGT
low level guard tone. This tone is used as a hold tone or keying tone. See guard
tone.
LMR
Land Mobile Radio. A Land Mobile Radio (LMR) system is a collection of
portable and stationary radio units that are designed to communicate with each
other over predefined frequencies. They are deployed wherever organizations
need to have instant communication between geographically dispersed and
mobile personnel.
This term is often used interchangeably between a handheld or vehicle-mounted
device and a stationary transmitter. Stationary devices are typically referred to
as base stations.
Cisco IPICS leverages the Cisco Hoot 'n' Holler feature, which is enabled in
specific Cisco IOS versions, to provide radio integration into the Cisco IPICS
solution. LMR is integrated by providing an ear and mouth (E&M) interface to
a radio or other PTT devices, such as Nextel phones. Configured as a voice port,
this interface provides the appropriate electrical interface to the radio. You
configure this voice port with a connection trunk entry that corresponds to a voip
dial peer, which in turn associates the connection to a multicast address. This
configuration allows you to configure a corresponding channel in Cisco IPICS,
using the same multicast address, which enables Cisco IPICS to provide
communication paths between the desired endpoints.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-13
Glossary
LMR gateway
Land Mobile Radio gateway. Refers to the router E&M interface that converts
IP traffic from digital to analog for use by radios.
location
In Cisco IPICS, location signifies reachability; meaning, channels or users who
are associated with the same location can communicate with each other without
additional network configuration. Location may refer to a physical or virtual
location, as defined in the server.
low-band frequency Lower frequency levels in the VHF band, typically 25–50 MHz.
M
megahertz (MHz)
A unit of frequency denoting one million Hz.
mixed tone
Two tones that are mixed together. DTMF is an example of a mixed tone. To be
transmitted properly, tone signals must be mixed with the LLGT. See DTMF.
m-lead
The mouth portion of the E&M interface. The m-lead is the transmit path of the
LMR gateway.
modulation
The process, or result of the process, of varying a characteristic of a carrier in
accordance with an information-bearing signal.
multicast
Single packets that are copied by the network and sent to a specific subset of
network addresses. Multicast refers to communications that are sent between a
single sender and multiple recipients on a network.
multicast address
A single address that may refer to multiple network devices.
multicast
address/port
Cisco IPICS uses this type of connection to enable the PMC to directly tune in
to the multicast channel. Multicast address/port combinations are also used by
gateways and RMS components.
multicast pool
Multicast IP addresses that are defined as part of a multicast pool. Cisco IPICS
allocates a multicast address from this pool of resources when a dispatcher
activates a VTG.
Cisco IPICS Server Installation and Upgrade Guide
GL-14
OL-12985-01
Glossary
multiplexing
The combination of two or more information channels on to a common
transmission medium. In electrical communications, the two basic forms of
multiplexing are time-division multiplexing (TDM) and frequency-division
multiplexing (FDM).
multipurpose policy A policy that can include any of the supported actions; may be invoked through
the telephony user interface or the Cisco IPICS administration console.
multiselect buttons
Provides the ability to select or deselect all channels on the PMC for audio
transmission.
mute
The functionality that enables a dispatcher to mute a PMC user from talking or
transmitting voice on one or more channels. The dispatcher can mute the
microphone of the user or both the microphone and the speaker.
mutual aid channel
A national or regional channel that has been set aside for use only in mutual aid
interoperability situations. Restrictions and guidelines governing usage usually
apply.
N
narrowband
channels
Channels that occupy less than 20 kHz.
National Public
Safety Planning
Advisory
Committee
The committee that was established to conduct nationwide planning and
allocation for the 821–824 MHz and 866–869 MHz bands.
The United States executive branch agency that serves as the principal advisor
National
Telecommunication to the president on telecommunications and information policies and that is
and Information
responsible for managing the federal government’s use of the radio spectrum.
Administration
near end
The device or devices that are physically connected to the Ethernet or an RS-232
link. Compare with far end, which refers to devices on the other side of the
broadcast. A base station that is connected to an LMR gateway is a near end
device while a handheld radio that receives over-the-air signals from the base
station is a far end device.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-15
Glossary
network
An interconnection of communications entities.
NAT
Network Address Translation. Provides a mechanism for translating addresses
that are not globally unique into globally routable addresses for connection to
the Internet.
not activated
A VTG state that becomes effective when the Activate button is clicked a second
time (to deactivate the channel) or if the connection terminates. No PMC buttons
appear highlighted.
notification
An action that notifies selected user(s) via email, SMS, pager, or phone. The
necessary IDs and phone numbers are configured in the communication
preferences for each user. Notifications that are sent via the phone require user
authentication before the notification prompt is heard.
An email, SMS, pager, or phone call that is placed to a user for the purpose of
sending a notification message.
O
offline mode
When the connection to the server goes offline, the PMC enters offline mode.
Offline mode enables continuous communication during periods of server
downtime. Using offline mode requires at least one successful login to the
server.
operator
The Cisco IPICS operator is responsible for setting up and managing users,
configuring access privileges, and assigning user roles and ops views.
ops view
operational view. A Cisco IPICS feature that provides the ability to organize
users, user groups, channels, channel groups, VTGs, and policies into different
user-definable views across multiple organizations or agencies that normally
would not share resources. While ops views are maintained separately by the
Cisco IPICS system administrator and/or ops view administrator, this
functionality also allows multiple entities to use one Cisco IPICS server to
enable resource sharing across multiple ops views, according to business need.
Cisco IPICS Server Installation and Upgrade Guide
GL-16
OL-12985-01
Glossary
ops view
administrator
The ops view administrator capabilities include managing and monitoring the
activity logs that are filtered by ops views and accessible in the Administration
Console (Administration > Activity Log Management) window.
OTAR
over-the-air re-keying. Provides the ability to update or modify over radio
frequency the encryption keys that are programmed in a mobile or portable
radio.
P
packet
A logical grouping of information that includes a header that contains control
information. Usually also includes user data.
packet switching
The process of routing and transferring data by using addressed packets so that
a channel is occupied during the transmission of the packet only. Upon
completion of the transmission, the channel is made available for the transfer of
other traffic.
PIM
Protocol Independent Multicast. Multicast routing architecture that allows the
addition of IP multicast routing on existing IP networks. PIM is unicast routing
protocol independent and can be operated in two modes: PIM dense mode and
PIM sparse mode.
PIM dense mode
One of the two PIM operational modes. PIM dense mode is data-driven and
resembles typical multicast routing protocols. Packets are forwarded on all
outgoing interfaces until pruning and truncation occurs. In dense mode,
receivers are densely populated, and it is assumed that the downstream networks
want to receive and will probably use the datagrams that are forwarded to them.
The cost of using dense mode is its default flooding behavior. Sometimes called
dense mode PIM or PIM DM.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-17
Glossary
PIM sparse mode
One of the two PIM operational modes. PIM sparse mode tries to constrain data
distribution so that a minimal number of routers in the network receive it.
Packets are sent only if they are explicitly requested at the RP (rendezvous
point). In sparse mode, receivers are widely distributed, and the assumption is
that downstream networks will not necessarily use the datagrams that are sent to
them. The cost of using sparse mode is its reliance on the periodic refreshing of
explicit join messages and its need for RPs. Sometimes called sparse mode PIM
or PIM SM.
PMC
Push-to-Talk Management Center. A standalone PC-based software application
that simulates a handheld radio to enable PTT functionality for PC users. This
application enables Cisco IPICS PMC end-users, dispatch personnel, and
administrators to participate in one or more channels/VTGs at the same time.
PMC ID
The unique ID that the Cisco IPICS server generates for each PMC to track
requests between the PMC and the server and to verify and manage concurrent
PMC usage for licensing requirements.
policy
Policies include one or more actions that execute sequentially and can be
manually activated via the Cisco IPICS administration console or the telephony
user interface. Cisco IPICS provides support for multiple policy types.
policy channel
A channel that can be set up by the dispatcher and configured as a designated
channel; that is, a channel that is always open to enable your interaction with the
dispatcher.
policy execution
status
An indicator of policy execution success or failure. The Cisco IPICS
administration console provides a status for each action under a policy,
portalization
A web programming paradigm for customizing the interface and functionality of
a client application.
preamble
The sequence of tones that precede a transmission. The preamble generally
includes the HLGT and the function tone.
protocol
A set of unique rules that specify a sequence of actions that are necessary to
perform a communications function.
Cisco IPICS Server Installation and Upgrade Guide
GL-18
OL-12985-01
Glossary
PTT
Push-to-talk. A signal to a radio transmitter that causes the transmission of radio
frequency energy.
The action that keys a radio or causes the radio to transmit. On the Cisco router,
the e-lead, or key tone, is used to signal the radio to transmit.
PTT channel
A channel consists of a single unidirectional or bidirectional path for sending
and/or receiving signals. In the Cisco IPICS solution, a channel represents one
LMR gateway port that maps to a conventional radio physical radio frequency
(RF) channel.
PTT channel button
The button on the PMC that you click with your mouse, or push, and hold to talk.
You can use the latch functionality on this button to talk on one or more channels
at the same time.
PTT channel group
A logical grouping of available PTT channels that can be used for categorization.
Q
QoS
quality of service. A measurement of performance for a transmission system,
including transmission quality and service availability.
queue
Represents a set of items that are arranged in sequence. Queues are used to store
events occurring at random times and to service them according to a prescribed
discipline that may be fixed or adaptive.
queuing delay
In a radio communication system, the queuing delay specifies the time between
the completion of signaling by the call originator and the arrival of a permission
to transmit to the call originator.
R
radio channel
Represents an assigned band of frequencies sufficient for radio communication.
The bandwidth of a radio channel depends upon the type of transmission and its
frequency tolerance.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-19
Glossary
radio control service The logical element in the Cisco IPICS system that can tune a radio to the
desired channel without manual intervention. Refers to a serial control entity.
radio equipment
Any equipment or interconnected system or subsystem of equipment (both
transmission and reception) that is used to communicate over a distance by
modulating and radiating electromagnetic waves in space without artificial
guide. This equipment does not include microwave, satellite, or cellular
telephone equipment.
receive indicator
The indicator on the PMC that blinks green when traffic is being received.
remote connection
Cisco IPICS uses this type of connection to provide SIP-based trunking into the
RMS component, which is directly tuned into the multicast channel.
RF
radio frequency. Any frequency within the electromagnetic spectrum that is
normally associated with radio wave propagation. RF generally refers to
wireless communications with frequencies below 300 GHz.
RFC 2833
The Internet Engineering Task Force (IETF) specification that describes how to
carry DTMF signaling, other tone signals, and telephony events in RTP packets.
Using RFC 2833 a packet can be compactly composed to play a series of tones,
including DTMF, in a specific sequence that includes specified durations and
volume levels.
RF repeater
An analog device that amplifies an input signal regardless of its nature (analog
or digital). Also, a digital device that amplifies, reshapes, retimes, or performs a
combination of any of these functions on a digital input signal for
retransmission.
RMS
router media service. Component that enables the Cisco IPICS PMC to remotely
attach to a VTG. It also provides support for remotely attaching (combining) two
or more VTGs through its loopback functionality.
The RMS mixes multicast channels in support of VTGs and it also mixes PMC
SIP-based (unicast) connections to a multicast channel or VTG. The RMS can
be installed as a stand-alone component (RMS router) or as an additional feature
that is installed in the LMR gateway.
Cisco IPICS Server Installation and Upgrade Guide
GL-20
OL-12985-01
Glossary
root user ID
The Cisco IPICS Linux user that has access to all files in the Cisco IPICS server.
Strong passwords are enforced and Linux operating system password expiration
rules apply to this user ID.
RTP
Real-Time Transport Procotol. Commonly used with IP networks to provide
end-to-end network transport functions for applications that transmit real-time
data, such as audio, video, or simulation data, over multicast or unicast network
services.
RTCP
Real-time Transport Control Protocol. The standard for notifying senders and
receivers of important events or transmission statistics. The most common forms
of RTCP are the sender report and the receiver report.
S
scanning
A subscriber unit feature that automatically allows a radio to change channels or
talk groups to enable a user to listen to conversations that are occurring on
different channels or talk groups.
script prompts
The audio prompts that the dial engine scripts play out during execution and
which callers hear when they are interacting with the telephony user interface.
secure channel
A channel that is connected to a radio that provides secure (encrypted or
scrambled) communications on the Common Air Interface (CAI) side of the
radio. (The level of security that is configured in the data network determines the
security of the communications between the LMR gateway and a network
attached device, such as a PMC or Cisco Unified IP Phone.)
An attribute that is set in the server to indicate that a channel is secure. A PTT
channel that is configured as secure cannot be combined with unsecure channels
in a VTG.
serial controlled
radio
A type of control for a radio that uses out-of-band signaling (usually RS-232).
See radio control service.
service delivery area See coverage.
signal
The detectable transmitted energy that carries information from a transmitter to
a receiver.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-21
Glossary
skin
Skins form the appearance of the PMC. In Cisco IPICS, skins are customizable
and available in various options, including 4-channel and 8-channel mouse and
touch screen formats.
speaker arbitration
The procedure that is used to determine the active audio stream in a Push-to-Talk
system.
spectrum
The usable radio frequencies in the electromagnetic distribution. The following
frequencies have been allocated to the public safety community:
High HF 25–29.99 MHz
Low VHF 30–50 MHz
High VHF 150–174 MHz
Low UHF 406.1–420/450–470 MHz
UHF TV Sharing 470–512 MHz
700 MHz 764–776/794–806 MHz
800 MHz 806–824/851–869 MHz.
spoken names
The recorded names that are used for entities, such as channels, channel groups,
VTGs, users, user groups, ops views, and policies. The names can be recorded
through the policy engine or externally-recorded .wav files that can be uploaded
into the system.
squelch
An electric circuit that stops input to a radio receiver when the signal being
received is too weak to be anything but noise.
statically configured Every stream of data that flows to the LMR gateway can be applied with a
tone control
preamble and/or guard tone by using a static configuration in the LMR gateway.
When traffic is sent on a multicast address, the radio automatically switches
(because of the preamble) to the specific radio channel that is requested by the
tone control sequence.
stored VTG
Also referred to as inactive VTG.
subchannel
A channel that shares the same multicast address as another channel or channels.
These multiple source streams (channels) may be present on a single radio
channel. On the PMC, you access these channels by pressing the channel
selector buttons on the radio channel.
subscriber unit
A mobile or portable radio unit that is used in a radio system.
Cisco IPICS Server Installation and Upgrade Guide
GL-22
OL-12985-01
Glossary
system
administrator
The Cisco IPICS system administrator is responsible for installing and setting up
Cisco IPICS resources, such as servers, routers, multicast addresses, locations,
and PTT channels. The system administrator also creates ops views, manages the
Cisco IPICS licenses and PMC versions, and monitors the status of the system
and its users via the activity log files.
system architecture The design principles, physical structure, and functional organization of a land
mobile radio system. Architectures may include single site, multi-site,
simulcast, multicast, or voting receiver systems.
T
T1
Digital WAN carrier facility. T1 transmits DS-1-formatted data at 1.544 Mbps
through the telephone-switching network, using alternate mark inversion (AMI)
or binary 8 zero suppression (B8ZS) coding.
T1 loopback
Allows mapping from multicast to unicast so that unicast phone calls can be
patched into an LMR or into other multicast audio streams. A loopback is
composed of two of the available T1 interfaces.
talk group
A VTG or a channel.
A subgroup of radio users who share a common functional responsibility and,
under normal circumstances, only coordinate actions among themselves and do
not require radio interface with other subgroups.
TCP
Transmission Control Protocol. A connection-oriented transport layer protocol
that provides reliable full-duplex data transmission. TCP is part of the TCP/IP
protocol stack.
TDMA
time division multiple access. Type of multiplexing where two or more channels
of information are transmitted over the same link by allocating a different time
interval (“slot” or “slice”) for the transmission of each channel; that is, the
channels take turns to use the link.
terminal
A device capable of sending, receiving, or sending and receiving information
over a communications channel.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-23
Glossary
throughput
The number of bits, characters, or blocks passing through a data
communications system, or a portion of that system.
TIA/EIA-102
standards
A joint effort between government and industry to develop voice and data
technical standards for the next generation of public safety radios.
tone control
The process of using inband tone sequences to change the behavior of a radio
end point. An inband tone can be used to control functions, such as modifying
(retuning) the radio frequency (RF channel), changing the transmit power level,
and monitoring a channel. The most basic form of tone control (tone keyed) is
used to key the radio. With the Cisco IPICS solution, the radio that is being
controlled is directly connected to the LMR gateway E&M leads.
tone frequency
A specific form of a function tone. The tone that is used to signal the radio to
select a frequency. These audible tone frequencies are generated in the router
and combined in a specific sequence to perform a tone control function.
tone keyed
A tone keyed radio requires the presence of a specific tone on the incoming
analog (e-lead) port. Without this tone, the radio cannot transmit. The tone is
generally used to prevent spurious transmission that may occur because of
injected noise.
tone signaling
Any form of over-the-air audible signals that are intended to terminate at the far
end. Examples include alerting tones, DTMF tones, and paging tones.
transmit indicator
On some of the PMC skins, this indicator blinks red when traffic is being
transmitted.
trigger
A time-based event that invokes a policy on a scheduled basis, without manual
intervention.
trunk
A physical and logical connection between two switches across which network
traffic travels. In telephony, a trunk is a phone line between two central offices
(COs) or between a CO and a PBX.
trunked (system)
Systems with full feature sets in which all aspects of radio operation, including
RF channel selection and access, are centrally managed.
Cisco IPICS Server Installation and Upgrade Guide
GL-24
OL-12985-01
Glossary
trunked radio
system
Integrates multiple channel pairs into a single system. When a user wants to
transmit a message, the trunked system automatically selects a currently unused
channel pair and assigns it to the user, decreasing the probability of having to
wait for a free channel.
TUI
telephony user interface. The telephony interface that the dial engine provides to
enable callers to perform tasks, such as joining talk groups and invoking
policies.
tune (a radio)
To change the current send and receive frequencies on a radio. This task is
usually accomplished via a preset with some form of radio control.
U
user
The Cisco IPICS user may set up personal login information, download the PMC
application, customize the PMC skin, and specify communication preferences
that are used to configure audio devices. By using a predefined user ID and
profile, the user can participate in PTT channels and VTGs by using the PMC,
supported models of Cisco Unified IP Phones, and the Public Switched
Telephone Network (PSTN) via the telephony dial functionality of the
Cisco IPICS IP policy engine. Users may have one or more Cisco IPICS roles,
such as system administrator, ops view administrator, operator or dispatcher.
unicast
Specifies point-to-point transmission, or a message sent to a single network
destination.
V
VAD
Voice Activity Detection. When VAD is enabled on a voice port or on a dial peer,
only audible speech is transmitted over the network. When VAD is enabled on
Cisco IPICS, the PMC only sends voice traffic when it detects your voice.
virtual channel
A virtual channel is similar to a channel but a radio system may not be attached.
By creating a virtual channel, participants who do not use physical handheld
radios to call into a VTG become enabled by using the PMC application or a
supported Cisco Unified IP Phone model.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
GL-25
Glossary
voice
interoperability
Voice interoperability enables disparate equipment and networks to successfully
communicate with each other.
voice replay
A feature that allows the PMC user to replay buffered audio on a per channel
basis.
VoIP
Voice over Internet Protocol. By digitalizing and packetizing voice streams,
VoIP provides the capability to carry voice calls over an IP network with
POTS-like functionality, reliability, and voice quality.
volume indicator
The volume indicator on the PMC that shows the current volume level on the
channel in a graphical format.
volume up/down
buttons
The buttons on the PMC that let you control the volume level.
VOX
Voice-operated transmit. A keying relay that is actuated by sound or voice
energy above a certain threshold and sensed by a connected acousto-electric
transducer. VOX uses voice energy to key a transmitter, eliminating the need for
push-to-talk operation.
VTG
virtual talk group. A VTG can contain any combination of channels, channel
groups, users, and user groups. A VTG can also contain other VTGs.
VTG add participant An action that adds selected participant(s) to the selected VTG.
W
wavelength
The representation of a signal as a plot of amplitude versus time.
wideband channel
Channels that occupy more than 20 kHz.
Cisco IPICS Server Installation and Upgrade Guide
GL-26
OL-12985-01
I N D EX
A
Cisco.com, accessing to obtain license file 2-31
Cisco IOS
address, obtaining for Cisco IPICS 2-2
administration console, troubleshooting access
problems 5-10
documentation xii
Cisco IPICS installation, checking 2-28
Cisco IPICS installer
copying file from CD to server root 2-21,
3-6
B
End User License Agreement (EULA) 2-18
bash command, using with Cisco IPICS
installer file 2-18, 3-3
browser, troubleshooting access to the server
from 5-10
running from a remote location 2-21, 3-5
running from the server location 2-17, 3-2
Cisco IPICS license
See license
Cisco IPICS operating system
C
installing 2-6
cable, connecting to server 2-3
message indicating incompatible or
unsupported hardware during
installation 5-7
caution, described xii
changing root password with reset_pw
command 2-13
Setup Utility 1-2
changing system date and time 2-37
upgrading 3-1
changing system date and time, problems with
time-bound licenses 2-37
checking Cisco IPICS installation 2-28
checklist, preinstallation 2-3
chmod command 5-9
uninstalling 4-1
Cisco IPICS server software
installing 2-16
uninstalling 4-1
upgrading 3-1
Cisco IP Phones
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
IN-1
Index
documentation xi
Cisco Security Agent xii
Cisco Land Mobile Radio (LMR)
Cisco Unified Communications Manager
(CallManager) x
documentation xi
Cisco Unified Communications Manager
Express x
Cisco Security Agent
documentation xii
conventions xii
Cisco Unified Communications Manager
(CallManager)
MCS servers xi
documentation x
Cisco Unified Communications Manager
Express
documentation x
commands
E
End User License Agreement (EULA), Cisco
IPICS 2-18
chmod 5-9
Ethernet cable, connecting to server 2-3
onstat 5-16
Ethernet network connectivity problems 5-6
service ipics_db 5-16
components, Cisco IPICS installed 1-3
configuring interfaces, using Kudzu hardware
detection utility 2-11
H
hardware, locating MAC address for 2-15
connecting Ethernet cable to server 2-3
conventions, document xii
I
D
ifconfig command, using to obtain MAC
address 2-15
database server
incompatible hardware error message during
operating system installation 5-7
checking 5-15
manually starting 5-13, 5-16
documentation
Cisco IOS xii
Cisco IP Phones xi
Cisco Land Mobile Radio (LMR) xi
installation, troubleshooting 5-1
installer, generating the PMC 2-45
installing
Cisco IPICS operating system 2-6
Cisco IPICS server software 2-16
Cisco IPICS Server Installation and Upgrade Guide
IN-2
OL-12985-01
Index
SSH loses connectivity during remote
server software installation 5-9
M
interface mapping for interfaces labeled 1 and
2 5-6
MAC address, obtaining 2-15, 2-31
interface not detected after installing operating
system software 5-2
MCS servers
Internet browser, troubleshooting access to the
server from 5-10
IP address
mapping, for interfaces labeled 1 and 2 5-6
documentation xi
multicast addresses, obtaining for Cisco
IPICS 2-2
obtaining for Cisco IPICS 2-2
setting in Welcome window during
installation 2-14
N
verifying Cisco IPICS 5-13
network cable, connecting to server 2-3
network connectivity problems 5-6
note, described xii
K
Kudzu hardware detection utility, using to
configure interfaces 2-11
O
onstat command 5-16
L
license
locating MAC address 2-15, 2-31
troubleshooting installation 2-37
troubleshooting time-bound 2-37
uploading file to server 2-32
License Agreement, accepting the Cisco
IPICS 2-18
P
Package installation window, for Cisco IPICS
operating system 1-3
partitions, troubleshooting after failing to
allocate 5-7
password
changing for root after installation 2-13
ping command
using to verify network connectivity 2-15
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
IN-3
Index
ping command, using to verify Cisco IPICS IP
address 5-13
PMC
generating application installer 2-45
manually starting 5-13, 5-16
service ipics_db command 5-16
Setup Utility, Cisco IPICS operating
system 1-2, 2-8
SSH secure shell
idle timeout value 2-21, 3-6
R
using to connect to Cisco IPICS
server 2-21, 3-6
RAID, SATA Software 2-7
remote location, installing Cisco IPICS
from 2-21, 3-5
reset_pw command 2-13
Restart Computer window, Cisco IPICS
installer 1-3
root
T
time-bound license
information 2-37
troubleshooting 2-37
changing password after installation 2-13
logging in as, GNOME login window 2-15,
2-17, 3-3, 4-2, 5-15
logging in as before Cisco IPICS
installation 2-17, 3-2
tomcat service
checking status 5-10
restarting 5-12
troubleshooting
authorization error on login 5-15
cannot reach server from browser 5-10
S
Cisco IPICS software installation 5-8
SATA Software RAID
about 2-7
disabling 2-9
server
connecting remotely by using SSH secure
shell 2-21, 3-6
shutting down manually 2-26
server, database
checking 5-15
database not running 5-15
Ethernet network connectivity
problems 5-6
hard drive partition errors 5-7
incompatible hardware error message 5-7
incorrect username or password 5-15
installation issues 5-1
interface not detected 5-2
license installation 2-37
Cisco IPICS Server Installation and Upgrade Guide
IN-4
OL-12985-01
Index
login problems from browser 5-10
SSH loses connectivity during remote
server software installation 5-9
time-bound licenses 2-37
tomcat service not running 5-10
unsupported hardware error message 5-7
ts 5-7
U
uninstalling
Cisco IPICS operating system software 4-1
Cisco IPICS server software 4-1
unsupported hardware error message during
operating system installation 5-7
upgrading
Cisco IPICS operating system software 3-1
Cisco IPICS server software 3-1
uploading Cisco IPICS license file 2-32
V
verifying Cisco IPICS installation 2-28
verifying network connectivity 2-15
VTG
interrupting during uninstallation 4-2
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
IN-5
Index
Cisco IPICS Server Installation and Upgrade Guide
IN-6
OL-12985-01