Cisco OL-8155-01 User Manual

Download

Cisco IP Interoperability and

Collaboration System

Server Installation Guide

Release 1.0(1)

Corporate 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 526-4100

Text Part Number: OL-8155-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE 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.

CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StrataView Plus, TeleRouter, 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. (0502R)

Introduction vii

Audience vii

Organization viii

Introduction

Audience

Preface

The Cisco IPICS Server Installation Guide provides you with the information that you need to install the Cisco IP Interoperability and Collaboration System (IPICS) 1.0(1) server 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.

The Cisco IPICS Server Installation Guide targets system administrators who install, configure, and operate the Cisco IPICS server software and the Cisco Linux operating system.

OL-8155-01

Cisco IPICS Server Installation Guide

vii

Organization

This document is organized as follows:

Chapter 1, “Overview” The introduction provides an overview of

Chapter 2, “Installing the Cisco IPICS Server Software”

Chapter 3, “Upgrading Cisco IPICS”

Chapter 4, “Uninstalling Cisco IPICS”

Chapter 5, “Troubleshooting the Installation”

Preface

the Cisco IPICS server software installation. This chapter also includes information about the system requirements for Cisco IPICS.

This chapter describes the steps involved in installing the Cisco Linux operating system, and the Cisco IPICS server software and its components.

This chapter describes the steps that you need to follow to upgrade the Cisco IPICS server software.

This chapter describes the steps that you follow to uninstall the Cisco IPICS server software.

This chapter includes troubleshooting tips for server installation issues.

Document Notes and Conventions

This document uses the following conventions for instructions and information:

Note Means reader take note. Notes contain helpful suggestions or references to

materials not contained in this document.

Caution This caution symbol means reader be careful. In this situation, you might do

something that could result in equipment damage or loss of data.

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

Examples of information displayed on the screen.

Document Notes and Conventions

OL-8155-01

Cisco IPICS Server Installation Guide

Obtaining Documentation

Table 1 Conventions (continued)

Convention Description

boldface screen

font

italic screen font Arguments for which you supply values are in italic

Information that you must enter is in

screen

screen font.

Obtaining Documentation

Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.

Cisco.com

Preface

boldface

font.

You can access the most current Cisco documentation at this URL:

http://www.cisco.com/techsupport

You can access the Cisco website at this URL:

http://www.cisco.com

You can access international Cisco websites at this URL:

http://www.cisco.com/public/countries_languages.shtml

Product Documentation DVD

Cisco documentation and additional literature are available in the Product Documentation DVD package, which may have shipped with your product. The Product Documentation DVD is updated regularly and may be more current than printed documentation.

The Product Documentation DVD is a comprehensive library of technical product documentation on portable media. The DVD enables you to access multiple versions of hardware and software installation, configuration, and command

Cisco IPICS Server Installation Guide

xii

OL-8155-01

Preface

guides for Cisco products and to view technical documentation in HTML. With the DVD, you have access to the same documentation that is found on the Cisco website without being connected to the Internet. Certain products also have .pdf versions of the documentation available.

The Product Documentation DVD is available as a single unit or as a subscription. Registered Cisco.com users (Cisco direct customers) can order a Product Documentation DVD (product number DOC-DOCDVD=) from the Ordering tool or Cisco Marketplace.

Cisco Ordering tool:

http://www.cisco.com/en/US/partner/ordering/

Cisco Marketplace:

http://www.cisco.com/go/marketplace/

Ordering Documentation

Beginning June 30, 2005, registered Cisco.com users may order Cisco documentation at the Product Documentation Store in the Cisco Marketplace at this URL:

Obtaining Documentation

OL-8155-01

http://www.cisco.com/go/marketplace/

Cisco will continue to support documentation orders using the Ordering tool:

• Registered Cisco.com users (Cisco direct customers) can order

documentation from the Ordering tool:

http://www.cisco.com/en/US/partner/ordering/

• Instructions for ordering documentation using the Ordering tool are at

this URL:

http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm

• Nonregistered Cisco.com users can order documentation through a local

account representative by calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208 or, elsewhere in North America, by calling 1 800 553-NETS (6387).

Cisco IPICS Server Installation Guide

xiii

Documentation Feedback

You can rate and provide feedback about Cisco technical documents by completing the online feedback form that appears with the technical documents on Cisco.com.

You can send comments about Cisco documentation to bug-doc@cisco.com.

You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:

Cisco Systems Attn: Customer Document Ordering 170 West Tasman Drive San Jose, CA 95134-9883

We appreciate your comments.

Cisco Product Security Overview

Preface

xiv

Cisco provides a free online Security Vulnerability Policy portal at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.ht ml

From this site, you can perform these tasks:

• Report security vulnerabilities in Cisco products.

• Obtain assistance with security incidents that involve Cisco products.

• Register to receive security information from Cisco.

A current list of security advisories and notices for Cisco products is available at this URL:

http://www.cisco.com/go/psirt

If you prefer to see advisories and notices as they are updated in real time, you can access a Product Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed from this URL:

http://www.cisco.com/en/US/products/products_psirt_rss_feed.html

Cisco IPICS Server Installation Guide

OL-8155-01

Preface

Obtaining Technical Assistance

Reporting Security Problems in Cisco Products

Cisco is committed to delivering secure products. We test our products internally before we release them, and we strive to correct all vulnerabilities quickly. If you think that you might have identified a vulnerability in a Cisco product, contact PSIRT:

• Emergencies— security-alert@cisco.com

An emergency is either a condition in which a system is under active attack or a condition for which a severe and urgent security vulnerability should be reported. All other conditions are considered nonemergencies.

• Nonemergencies— psirt@cisco.com

In an emergency, you can also reach PSIRT by telephone:

• 1 877 228-7302

• 1 408 525-6532

Tip We encourage you to use Pretty Good Privacy (PGP) or a compatible product to

encrypt any sensitive information that you send to Cisco. PSIRT can work from encrypted information that is compatible with PGP versions 2.x through 8.x.

Never use a revoked or an expired encryption key. The correct public key to use in your correspondence with PSIRT is the one linked in the Contact Summary section of the Security Vulnerability Policy page at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.ht ml

The link on this page has the current PGP key ID in use.

Obtaining Technical Assistance

Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The Cisco Technical Support & Documentation website on Cisco.com features extensive online support resources. In addition, if you have a valid Cisco

Cisco IPICS Server Installation Guide

OL-8155-01

Obtaining Technical Assistance

service contract, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not have a valid Cisco service contract, contact your reseller.

Cisco Technical Support & Documentation Website

The Cisco Technical Support & Documentation website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, at this URL:

http://www.cisco.com/techsupport

Access to all tools on the Cisco Technical Support & Documentation website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL:

http://tools.cisco.com/RPF/register/register.do

Note Use the Cisco Product Identification (CPI) tool to locate your product serial

number before submitting a web or phone request for service. You can access the CPI tool from the Cisco Technical Support & Documentation website by clicking the Tools & Resources link under Documentation & Tools. Choose Cisco Product Identification Tool from the Alphabetical Index drop-down list, or click the Cisco Product Identification Tool link under Alerts & RMAs. The CPI tool offers three search options: by product ID or model name; by tree view; or for certain products, by copying and pasting show command output. Search results show an illustration of your product with the serial number label location highlighted. Locate the serial number label on your product and record the information before placing a service call.

Preface

Submitting a Service Request

Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool provides recommended

Cisco IPICS Server Installation Guide

xvi

OL-8155-01

Preface

Obtaining Technical Assistance

solutions. If your issue is not resolved using the recommended resources, your service request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL:

http://www.cisco.com/techsupport/servicerequest

For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.

To open a service request by telephone, use one of the following numbers:

Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227) EMEA: +32 2 704 55 55 USA: 1 800 553-2447

For a complete list of Cisco TAC contacts, go to this URL:

http://www.cisco.com/techsupport/contacts

Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.

Severity 1 (S1)—Your network is “down,” or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.

Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.

Severity 3 (S3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.

Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.

OL-8155-01

Cisco IPICS Server Installation Guide

xvii

Preface

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources.

• Cisco Marketplace provides a variety of Cisco books, reference guides,

documentation, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL:

http://www.cisco.com/go/marketplace/

• Cisco Press publishes a wide range of general networking, training and

certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL:

http://www.ciscopress.com

• Packet magazine is the Cisco Systems technical user magazine for

maximizing Internet and networking investments. Each quarter, Packet delivers coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions, as well as network deployment and troubleshooting tips, configuration examples, customer case studies, certification and training information, and links to scores of in-depth online resources. You can access Packet magazine at this URL:

xviii

http://www.cisco.com/packet

• iQ Magazine is the quarterly publication from Cisco Systems designed to

help growing companies learn how they can use technology to increase revenue, streamline their business, and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, using real-world case studies and business strategies to help readers make sound technology investment decisions. You can access iQ Magazine at this URL:

http://www.cisco.com/go/iqmagazine

or view the digital edition at this URL:

http://ciscoiq.texterity.com/ciscoiq/sample/

Cisco IPICS Server Installation Guide

OL-8155-01

Preface

Obtaining Additional Publications and Information

• Internet Protocol Journal is a quarterly journal published by Cisco Systems

for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:

http://www.cisco.com/ipj

• Networking products offered by Cisco Systems, as well as customer support

services, can be obtained at this URL:

http://www.cisco.com/en/US/products/index.html

• Networking Professionals Connection is an interactive website for

networking professionals to share questions, suggestions, and information about networking products and technologies with Cisco experts and other networking professionals. Join a discussion at this URL:

http://www.cisco.com/discuss/networking

• World-class networking training is available from Cisco. You can view

current offerings at this URL:

http://www.cisco.com/en/US/learning/index.html

OL-8155-01

Cisco IPICS Server Installation Guide

xix

Obtaining Additional Publications and Information

Preface

Cisco IPICS Server Installation Guide

OL-8155-01

Overview

This chapter provides an overview of the Cisco IPICS server software installation. It also contains information about system requirements for the Cisco IPICS server software and the PMC application.

This chapter includes the following sections:

• Installation Overview, page 1-1

• Installed Components, page 1-4

• System Requirements, page 1-4

Installation Overview

The Cisco IPICS server software is installed on supported Cisco Media Convergence Systems (MCS) servers. The installation process involves first installing the Cisco Linux operating system and then installing the Cisco IPICS server software. All of the software that you need for Cisco IPICS is contained on two CDs that are packaged with the product.

CHAPTER

OL-8155-01

You would typically perform the Cisco Linux and Cisco IPICS installations in the same session, although you can choose to install the operating system and then install the Cisco IPICS server software at a later time.

The software that installs the Cisco Linux operating system and Cisco IPICS server software is mostly automated, but it does require some user interaction to complete. The installation procedures include the following steps:

Cisco IPICS Server Installation Guide

1-1

Installation Overview

Installation CD Step Description

Cisco Linux operating system

Cisco Linux Setup Utility This procedure disables default

features on the server that may be incompatible with Cisco Linux.

Cisco Linux Package Installation

In this phase, the installer overwrites the hard drive and installs files on the server. A progress window displays as the files are installed.

GRUB bootloader This process loads the operating system

image as the first step in a process called firstboot. Cisco Linux runs firstboot only once, just after the operating system is installed for the first time.

Cisco Linux Configuration and Setup

Entering the GNOME username/password

In these steps, you set the date and time and create an administrative user.

These windows allow you to log in as root using the password supplied by Cisco.

Ethernet port configuration In this procedure, you assign the IP

address for the server, create a DNS name (optional), and reactivate the Ethernet port.

Chapter 1 Overview

1-2

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 1 Overview

Installation CD Step Description

Cisco IPICS server software

Introduction This window provides introductory

information about the installation.

End User License Agreement This window allows you to review the

license agreement for the Cisco IPICS server software.

Choice of the install set This step describes the three

installation options on the Cisco IPICS installation CD and allows you to choose one of the types.

Password change for the root user

Password creation for the ipicsadmin user

This step allows you to change the default Cisco Linux password.

This step allows you to create a password for the ipicsadmin user, who has limited Cisco Linux privileges.

Password creation for the informix user

This step allows you to create a password for the informix user, who has limited Cisco Linux privileges, which are related to the Informix database files and folders.

Preinstallation summary In this step, a window displays

information such as the version of Cisco IPICS that you are installing, the installation directory, and the disk space requirement for the installation.

Package installation In this step, a window displays that

shows the progress of the installation and what Cisco IPICS files the installer is writing to the server.

Option to restart the server This step allows you to choose between

restarting the server immediately or at a later time.

Installation Overview

OL-8155-01

Cisco IPICS Server Installation Guide

1-3

Installed Components

The Cisco IPICS installation includes the following components:

• Cisco IPICS Administration Console (Cisco IPICS version 1.0(1))

• Cisco IPICS Data Store (IBM Informix Database Server version 10.0)

• Cisco Security Agent version 4.5

• Tomcat service

System Requirements

This section describes the hardware and software requirements for the Cisco IPICS server. This section includes the following topics:

• Hardware Requirements, page 1-4

• Software Requirements, page 1-6

Chapter 1 Overview

Hardware Requirements

The hardware components required to deploy Cisco IPICS include a server on which you install the Cisco IPICS server software. For users of land mobile radio (LMR) systems to communicate in Cisco IPICS conferences, you must deploy one or more routers that are equipped with T1 network modules.

Table 1-1 lists hardware components that Cisco supports for use with the

Cisco IPICS server software:

Table 1-1 Hardware Requirement

Hardware Component Supported Models

Cisco servers Cisco Media Convergence Server (MCS), model

Cisco IPICS Server Installation Guide

1-4

MCS-7825-H1-S31, with 2GB memory

Cisco Media Convergence Server (MCS), model MCS-7845-H1-S31 with 4 GB memory

OL-8155-01

Chapter 1 Overview

Table 1-1 Hardware Requirement (continued)

PMC Requirements

System Requirements

Hardware Component Supported Models

Cisco Integrated Service Routers

Cisco 2811

Cisco 3725

Cisco 3845

T1 network modules VWIC-MFT1-2T1 in a 2811 or 3845 VIC/WIC slot,

with internal digital signal processor (PVDM2-64)

NM-HDV2/NM-HDV2-2T1 in a 2811, 3725, or 3845 with digital signal processor (PVDM2-64)

Analog ports VIC2-2E/M in a 2811 or 3845 VIC/WIC slot, with

internal digital signal processor (PVDM2-64)

NM-HD-2V (or 2VE) with VIC2-2E/M 3725 and NM slots in 2811, 3725, or 3845

The minimum PMC requirements includes the following items:

• 300 MHz Pentium III class PC, including Mobile Pentium

• 256 MB RAM

• 16 MB free space

• Network interface card

Cisco IP Phone Requirements

Cisco IPICS allows virtual talk group (VTG) participation of the following models of Cisco IP Phones by enabling these phones to work with Cisco IPICS as IP phone multicast client devices:

• Cisco IP Phone 7960

• Cisco IP Phone 7970

OL-8155-01

Cisco IPICS Server Installation Guide

1-5

System Requirements

Software Requirements

This section lists the software requirements for using Cisco IPICS.

Internet Browser

The Cisco IPICS Administration Console, the graphical user interface (GUI) for the server software , requ ire s tha t y ou use Mi crosof t I nt erne t E xplor er v ersi on

6.0.2 or later.

Router Software

You must install Cisco IOS 12.4T software on any gateway router you use with Cisco IPICS.

PMC Software

Minimum requirements are Windows 2000 Professional SP4 or Windows XP Professional SP2.

Cisco IP Phone Firmware

This release of Cisco IPICS requi res the fo llowin g minimum ver sions of Cisc o CallManager and Cisco IP Phone firm ware:

Chapter 1 Overview

1-6

• Cisco CallManager, version 4.1(2)

• Cisco IP Phone 7960, version 7.2(3)

• Cisco IP Phone 7970, version 7.0(1)

Cisco IPICS Server Installation Guide

OL-8155-01

CHAPTER

Installing the Cisco IPICS Server Software

This chapter describes the procedures you need to follow to install the Cisco Linux operating system and the Cisco IPICS server software. There are also tasks you must complete before you begin the installation. After you complete the installation procedures for Cisco Linux and Cisco IPICS, there are additional tasks you must accomplish before you can use the Cisco IPICS software.

This chapter includes the following sections:

• Before You Begin, page 2-1

• Installing the Cisco Linux Operating System, page 2-3

• Installing Cisco IPICS Server Software, page 2-24

• Preparing to Use Cisco IPICS, page 2-47

Before You Begin

This section describes the tasks that are necessary to prepare for the Cisco Linux operating system and Cisco IPICS installations. This section includes the following topics:

• Obtaining the IP Addresses for Your Cisco IPICS System, page 2-2

• Preinstallation Checklist, page 2-2

OL-8155-01

Cisco IPICS Server Installation Guide

2-1

Chapter 2 Installing the Cisco IPICS Server Software

Before You Begin

Obtaining the IP Addresses for Your Cisco IPICS System

To facilitate communications between your users, your Cisco IPICS system requires a supply of IP addresses that can be reached by all users in your network domain.

Cisco IPICS requires a multicast address for each of the following purposes:

• When you create a PTT channel. You can use a channel to bring an LMR

signal into Cisco IPICS or to provide a meeting place for a group of PMC or Cisco IP Phone users.

• When you activate a VTG.

Consult your network administrator to obtain IP addresses for the following Cisco IPICS purposes:

• Multicast addresses for your channels and VTGs.

• For your routers, obtain a small subnet and then take addresses from it.

• The address for the Cisco IPICS server must be a static, local IP address that

is advertised on the network. Cisco IPICS clients such as PMCs and Cisco IP Phones must have the static address of the Cisco IPICS server to maintain communication.

For information on how to use the IP addresses to configure Cisco IPICS, refer to the Cisco IPICS Server Administration Guide.

Preinstallation Checklist

Before you begin the installation, ensure that you have performed the following tasks:

Preinstallation Tasks Checkoff

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 NIC1 port on your 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 Guide

2-2

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Preinstallation Tasks (continued) Checkoff

Check that your monitor cable connector is appropriate for the connector on the server. VGA analog and VGA digital are common connector types, but are not compatible with each other without the proper adapter.

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.

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 on the display can cause undesirable results.

Installing the Cisco Linux Operating System

Check that you have both CDs from the Cisco IPICS installation package.

Installing the Cisco Linux Operating System

Cisco IPICS runs on Cisco Linux, which is based on the Red Hat Enterprise Linux AS 3 operating system (OS). This section describes the steps to install the Cisco Linux operating system. You may install the Cisco IPICS server software any time after you finish the Cisco Linux installation.

To perform this installation, you must have the Cisco Linux installation CD that was included with your product package. The Cisco Linux installation should take approximately 15-20 minutes.

Note The Cisco Linux installation includes a procedure to disable the Intel SATA RAID

controller option and the virtual install disk, which are default features of the Cisco MCS 7825 and Cisco MCS 7845. The Redundant Array of Disks (RAID) is a combination of multiple small, independent disk drives that create an array. This

Cisco IPICS Server Installation Guide

OL-8155-01

2-3

Installing the Cisco Linux Operating System

array of drives appears to the server as a single logical storage unit or drive.

The virtual install disk is a holding place within the system ROM that contains embedded boot drivers. These boot drivers assist in completing the operating system installation.

The Cisco Linux operating system that is provided with Cisco IPICS does not support RAID or the virtual install disk. Because RAID and virtual install disk are enabled by default as part of the factory settings, you must disable these features.

To install Cisco Linux, perform the following procedure:

Procedure

Step 1 Turn the server on by pushing the power button that is located on the front of the

server.

Step 2 Insert the Cisco Linux installation CD into the Cisco MCS disk drive.

Step 3 If you are installing the Cisco Linux operating system on the Cisco MCS

7825-H1-S31, you must disable SATA software RAID and the Virtual Install Disk. If you have the Cisco MCS 7845, you do not have to disable these features and can proceed to Step k.

To enter the System Maintenance menu, follow these steps:

Chapter 2 Installing the Cisco IPICS Server Software

2-4

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 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 with which you can change settings for server components, such as the 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 you can use to perform diagnostic tests on the server, such as a memory test or a CPU test.

c. To cho o s e Setup Utility from the System Maintenance menu, press Enter.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

The ROM-Based Setup Utility displays. The Utility provides information about the server in the right pane, such as the model number, serial number (S/N), and other product information.

The left pane displays a menu of settings, which you can access by pressing the Up Arrow and Down Arrow keys.

d. From the Setup Utility menu, press the Down Arrow key to highlight

Advanced Options and then press Enter.

The Advanced Options menu displays.

e. Press the Down Arrow key to highlight Virtual Install Disk

When you highlight Virtual Install Disk, the current status displays below the menu.

f. If the status displays as Disabled, proceed to Step h.

If the Virtual Install Disk displays as Enabled, change the Configuration Selection. To change the selection, press Enter to open the menu and then press the Down Arrow key to highlight Disabled.

g. To confirm your choice, press Enter again.

Installing the Cisco Linux Operating System

OL-8155-01

The Virtual Install Disk setting displays as Disabled.

h. From the Advanced Options Menu, press the Down Arrow key to highlight

SATA Software Raid.

The current status displays below the menu.

i. If the status displays as Disabled, proceed to Step k.

If the SATA Software Raid status displays as Enabled, press Enter to open the menu and press the Down Arrow key to highlight Disabled.

j. To confirm your choice, press Enter again.

k. To close the menus and exit the utility, press Esc twice.

l. To confirm the exit and save your changes, press F10.

If you press any other key, you will be returned to the Main Menu of the Setup Utility.

The server begins to boot from the CD. This time, when the system beeps, let it continue to boot from the CD.

The Cisco Linux installation displays the CD version and the option to overwrite the hard drive. See Figure 2-1 for an example of this message.

Cisco IPICS Server Installation Guide

2-5

Installing the Cisco Linux Operating System

Note The CD version that displays reflects the version of Cisco Linux, not the

Cisco IPICS server software.

Figure 2-1 Overwrite Hard Drive Message

Step 4 To overwrite the hard drive and install Cisco Linux files, follow these steps:

a. When the system prompts you to overwrite the hard drive, enter Y and then

press Enter.

The Cisco Linux Installation Progress window displays information about the version of Cisco Linux that you are installing. A table displays the progress of the installation and the number of software packages that remain to be installed. See Figure 2-2 for an example of this window.

Chapter 2 Installing the Cisco IPICS Server Software

2-6

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-2 Cisco Linux Installing Packages Window

Installing the Cisco Linux Operating System

OL-8155-01

The Cisco Linux installer first formats the file system and then proceeds with installing the software packages.

Note The file system formatting and package installation takes

approximately 12 minutes. However, the screen may be appear unresponsive for a few minutes after the package installation completes. This period of inactivity occurs because the system must complete background security processes.

The MCS server ejects the installation CD and the Installation Complete window displays (see Figure 2-3 for an example of the Installation Complete window).

b. Remove the CD from the drive.

Cisco IPICS Server Installation Guide

2-7

Installing the Cisco Linux Operating System

Note Keep your installation CD in a safe location, so that you can reinstall

the operating system, if necessary.

Figure 2-3 Installation Complete Window

Chapter 2 Installing the Cisco IPICS Server Software

2-8

c. (Optional) Click Release Notes or press Alt-R to view the technical

information related to this release of Cisco Linux.

Note Although the window indicates that the installation is complete (see

Figure 2-3 for an example of this window), you still must complete

several more tasks before you can proceed to the Cisco IPICS server software installation. The remaining steps in this section describe the process of configuring the Cisco Linux operating system.

d. To close the window and reboot the server, click Exit or press Alt-E.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

The server reboots.

Note During the bootup process a GRUB version window displays. The

window times out in a few seconds. Let the time expire and boot process continue.

The Linux hardware detection utility window displays with a message that it has detected the Intel SATA Controller in your server. The utility allows you to configure controller.

Step 5 Press any key to configure the controller before the window times out.

A Hardware Added window displays and states that the Intel SATA Controller was added to your system. The window displays the following options:

• Configure the device—This option specifies the default.

• Ignore the device—No configuration is added to the system, but you would

not be prompted if the system detected the controller again when you restart the server in the future.

• Do nothing—No configuration is added to the system and you would be

notified again if the system detects the controller the next time you restart the server.

Installing the Cisco Linux Operating System

OL-8155-01

Step 6 To configure the hardware detection utility, press Enter to accept the default and

configure the controller.

A Cisco Linux Welcome window displays. See Figure 2-4 for an example of this window.

Cisco IPICS Server Installation Guide

2-9

Installing the Cisco Linux Operating System

Figure 2-4 Cisco Linux Welcome Window

Chapter 2 Installing the Cisco IPICS Server Software

2-10

Step 7 To proceed with the setup of Cisco Linux, follow these steps:

a. At the Welcome window, click Next.

The Date and Time Window displays. See Figure 2-5 for an example of this window.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-5 Date and Time Window

Installing the Cisco Linux Operating System

OL-8155-01

b. In the Date pane, use the arrows to navigate to the correct month and year and

then click the current day of the month. Then, in the Time pane, use the arrows to set the Hour, Minute, and Second to the current time.

Caution Make sure that you only perform system date changes before you install the

Cisco IPICS server software. Cisco IPICS does not support any modification of the system date in the operating system after the Cisco IPICS server software has been installed. Therefore, it is very important that you check your system date to ensure that it properly reflects your local date and time. If the system date is not properly set to your local date and time, you must adjust it before you install the Cisco IPICS server software. If you try to change the system date and time after you install the software, you will invalidate your license and cause the system to become inoperable.

Cisco IPICS Server Installation Guide

2-11

Installing the Cisco Linux Operating System

Note Cisco IPICS does not support the Network Time Protocol (NTP)

feature.

c. To continue with the installation, click Next.

The System User window displays.

Note The system user you create in Step d is a non-administrative user that

has limited capabilities in Cisco Linux. For example, this user can browse the directories on the server, including the Cisco IPICS directories, and open configuration files to view them. However, the system user, by default, cannot modify configuration files.

See Figure 2-6 for an example of the window.

Chapter 2 Installing the Cisco IPICS Server Software

2-12

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-6 System User Window

Installing the Cisco Linux Operating System

OL-8155-01

d. To create a non-administrator user for the Cisco Linux system, enter the name

for the user into the Username field.

e. Press Tab to move to the other fields:

• The Full Name field is optional.

• The Password and Confirm Password fields are required. The password must

contain at least six characters.

Note Be aware that Cisco IPICS does not support the use of network

authentication functionality.

f. To continue with the setup, click Next.

The Additional CDs window displays. See Figure 2-7 for an example.

Cisco IPICS Server Installation Guide

2-13

Installing the Cisco Linux Operating System

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-7 Additional CDs Window

2-14

Note Because Cisco IPICS does not support the use of third-party plug-ins

and applications, documentation CDs, or add-ons, do not click any of the Install buttons in the Additional CDs window.

g. To continue with the setup, click Next.

The Finish Setup window displays. See Figure 2-8 for an example of this window.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-8 Finish Setup Window

Installing the Cisco Linux Operating System

OL-8155-01

h. To continue, click Next.

The GNOME login window displays with a Username field. See Figure 2-9 for an example.

Cisco IPICS Server Installation Guide

2-15

Installing the Cisco Linux Operating System

Figure 2-9 GNOME Username Field

Chapter 2 Installing the Cisco IPICS Server Software

2-16

Note In Step 8, ensure that you log in as the root user and not the system user

that you created earlier in the installation. If you do not log in as root, you cannot configure the Ethernet port.

Step 8 Enter root in the Username field and press Enter.

The GNOME login window displays with a password field.

Step 9 Enter cisco in the Password field and press Enter.

The Cisco Linux desktop displays.

Note While Cisco supplies the root password to use in this part of the

installation, the Cisco IPICS installation provides an opportunity to change this password to ensure system security.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Step 10 You must now configure the Ethernet port in your server that you will use for

Cisco IPICS. To configure the port, follow these steps:

a. Open a terminal window to enter commands. To do so, open the Red Hat

menu on the Cisco Linux desktop by clicking the Red Hat icon.

b. Choose System Tools > Network Device Control. See Figure 2-10 for an

example of the menu.

Figure 2-10 Using the Red Hat Menu

Installing the Cisco Linux Operating System

OL-8155-01

The Network Device Control window displays at least one active port. See

Figure 2-11 for an example of the window.

Note Your server may have more than one Ethernet port. If so, choose eth0.

Also, ensure that your Ethernet cable is plugged into NIC1 and not NIC2.

Cisco IPICS Server Installation Guide

2-17

Installing the Cisco Linux Operating System

Figure 2-11 Network Device Control Window

c. To configure the port, click the eth0 device from the list and then click

Configure.

The Network Configuration window displays. See Figure 2-12 for an example of the window.

Chapter 2 Installing the Cisco IPICS Server Software

2-18

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Installing the Cisco Linux Operating System

d. To continue with the configuration, click eth0 again and then click Edit.

The Ethernet Device window displays. See Figure 2-13 for an example of the window.

Figure 2-12 Network Configuration Window

OL-8155-01

Cisco IPICS Server Installation Guide

2-19

Installing the Cisco Linux Operating System

Figure 2-13 Ethernet Device Window

Chapter 2 Installing the Cisco IPICS Server Software

2-20

e. To enter a static IP address for eth0, click the Statically set IP addresses

option.

The Statically set IP addresses fields become active.

Note For Cisco IPICS to function properly, the Cisco IPICS server must

have a static IP address.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-14 Entering the Static IP Address

f. In the Address field, enter the static IP address.

Installing the Cisco Linux Operating System

OL-8155-01

g. Press Tab to enter information into the Subnet Mask and Default Gateway

Address fields. See Figure 2-14 for an example and the “Obtaining the IP

Addresses for Your Cisco IPICS System” section on page 2-2 for more

information.

h. To continue with the configuration, click OK.

Note Creating a Domain Name Service (DNS) name for the server is

optional. If you want to enter DNS information for eth0, continue to Step i.

If you do not want to enter DNS information, proceed to Step m.

i. To enter DNS information for this port, click the DNS tab.

Cisco IPICS Server Installation Guide

2-21

Installing the Cisco Linux Operating System

Figure 2-15 Entering DNS Information

Chapter 2 Installing the Cisco IPICS Server Software

2-22

j. In the Hostname field, enter a name for the system. Then, press Tab.

k. In the Primary DNS field, enter the IP addresses for primary DNS server for

your network. Then press Ta b.

l. If your network has secondary and tertiary DNS servers, enter those IP

address, using the Ta b key to move between fields. If you do not have secondary and tertiary DNS servers, continue to Step m.

m. To close the Ethernet Device window, click X.

A window displays and allows you to save your changes.

n. Click Yes to save your changes.

The system displays a message that indicates that you may want to restart network services or restart the system.

o. To close the message window, click OK.

The Network Device Control window displays that eth0 is inactive (see

Figure 2-15 for an example of the window).

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-16 Network Device Control Window

p. To activate eth0, click Activate.

The status for eth0 changes to active.

Installing the Cisco Linux Operating System

OL-8155-01

Note If this is not a fresh install of Cisco Linux, eth0 should already be

active. If the port is active, proceed to Step q.

q. Click Close.

Cisco Linux activates eth0 and closes the window. The Cisco Linux desktop displays.

Step 11 To restart the server so that the installation completes successfully, follow these

steps:

a. To open the Log Out window, click the Red Hat menu and choose Log Out.

The Log Out window displays.

b. Choose Restart the Computer. Then, click OK or press Enter.

The server reboots and returns you to GNOME Login window.

Step 12 To log in, enter the username as root and press Enter.

Step 13 Enter the password as cisco and press Enter.

The Cisco Linux desktop displays.

Cisco IPICS Server Installation Guide

2-23

Installing Cisco IPICS Server Software

Step 14 To verify network connectivity, follow these steps:

a. To open a terminal window, click the Red Hat menu and choose System

Tools > Terminal

b. To ping another server on the network, enter the following command:

ping <destination IP address>

where destination IP address represents the default gateway address, or an IP address of another server on the network.

If the ping is not successful, troubleshoot the network connectivity with your network administrator.

Step 15 To locate the hardware MAC address so that you can obtain your Cisco IPICS

license, follow these steps:

a. To view the MAC address for your hardware, enter the following command:

[root] #ifconfig -a

Information displays about the network interface cards.

b. Locate the eth0 heading and note the HWaddr field. This is the MAC address

for the server. Note this information so that you can use it to obtain your license for Cisco IPICS. For more information, see the “Obtaining Your

License File” section on page 2-49.

Chapter 2 Installing the Cisco IPICS Server Software

c. To close the terminal window, click X.

The Cisco Linux 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 Cisco IPICS Server

Software” section on page 2-24.

Installing Cisco IPICS Server Software

To install the Cisco IPICS server, you must have successfully completed the Cisco Linux operating system installation. For more information on installing Cisco Linux, see the “Installing the Cisco Linux Operating System” section on

page 2-3.

Cisco IPICS Server Installation Guide

2-24

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

You can install the Cisco IPICS server software by using the installation CD at the Cisco IPICS server or you may install it remotely by copying the installer file to the server.

This installation procedure includes a choice of the following install options:

• Typical—This option installs the Cisco IPICS server software, including

CSA

• Custom—This option allows you to install the Cisco IPICS server software

without CSA

• Upgrade—For information on performing an upgrade of the Cisco IPICS

server software, see Chapter 3, “Upgrading Cisco IPICS”

If you choose not to install CSA during the Cisco IPICS server software installation, you can install CSA any time after the Cisco IPICS installation is complete.

This section includes the following topics:

• Installing the Cisco IPICS Server Software at the Server, page 2-25

• Installing Cisco IPICS from a Remote Location, page 2-38

Installing Cisco IPICS Server Software

• Manually Installing CSA, page 2-46

Installing the Cisco IPICS Server Software at the Server

To perform the Cisco IPICS server software installation, you must have the Cisco IPICS installation CD that was included with your product package.

Caution Make sure that you only perform system date changes before you install the

Cisco IPICS software. Cisco IPICS does not support any modification of the system date in the operating system after the Cisco IPICS software has been installed. Therefore, it is very important that you check your system date to ensure that it properly reflects your local date and time. If the system date is not properly set to your local date and time, you must adjust it before you install the Cisco IPICS software. If you try to change the system date and time after you install the software, you will invalidate your license and cause the system to become inoperable.

Cisco IPICS Server Installation Guide

OL-8155-01

2-25

Installing Cisco IPICS Server Software

For information about setting the date and time as part of the operating system installation, see the “Installing Cisco IPICS Server Software” section on

page 2-24.

Note You must log in with root privileges 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.

To install the Cisco IPICS server software, perform the following procedure:

Procedure

Step 1 To log in to the Cisco Linux operating system, enter root in the username field of

the Login window and press Enter.

Cisco Linux displays a window with a password field.

Step 2 Enter your root password and press Enter. The default password is cisco.

Chapter 2 Installing the Cisco IPICS Server Software

2-26

The Cisco Linux desktop displays.

Step 3 Insert the Cisco IPICS installation CD into the Cisco MCS disk drive.

The Cisco IPICS CD icon displays on the desktop. See Figure 2-17 for an example.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-17 Cisco IPICS CD Icon

Installing Cisco IPICS Server Software

OL-8155-01

Step 4 To open the CD contents, double-click the CD icon.

Cisco Linux displays a window that shows the Cisco IPICS installer file. See

Figure 2-18 for an example.

Cisco IPICS Server Installation Guide

2-27

Installing Cisco IPICS Server Software

Figure 2-18 Installer File on the Cisco IPICS CD

Chapter 2 Installing the Cisco IPICS Server Software

2-28

Step 5 To start the installation, double-click the installer icon.

Cisco Linux displays a message window that offers options to display or run the installer file. See Figure 2-19 for an example of the window.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-19 Run or Display Message Window

Installing Cisco IPICS Server Software

OL-8155-01

Step 6 When you are prompted to run or display the file contents, click Run in Terminal.

The Cisco IPICS installer window displays with an introduction to the process. See Figure 2-20 for an example of the window.

Note If you click Run, rather than Run in Terminal, there is a delay of

approximately 3 minutes while the installer completes background security processes, such as extracting the necessary files for the installation. During this delay, the screen may be appear unresponsive. Do not click Run or Run in Terminal again or you will start an additional instance of the installer.

Cisco IPICS Server Installation Guide

2-29

Installing Cisco IPICS Server Software

Figure 2-20 Introduction in the Installer Window

Chapter 2 Installing the Cisco IPICS Server Software

2-30

Step 7 To continue with the installation, click Next.

The Cisco IPICS installer displays the End User License Agreement.

Step 8 Use the scroll bar in the License Agreement pane to view the entire agreement.

Read and review the license agreement; then, click the I accept the terms of the License Agreement radio button. Then, click Next.

Note You can only continue with the installation if you accept the End User

License Agreement.

The Choose Install Set window displays with the following installation option (see Figure 2-21 for an example of the window):

• Typical—This option installs Cisco IPICS server software with CSA

• Customize—This option allows you to choose whether to install Cisco IPICS

server software with or without CSA

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

• Upgrade—This option installs an upgrade to a previously installed version of

Cisco IPICS server software

Figure 2-21 Install Set Window

Installing Cisco IPICS Server Software

OL-8155-01

Step 9 To install Cisco IPICS with the CSA, choose Typ ical. Then, click Next.

Note If you decide not to install CSA with the installation of this server

software, you can manually install CSA at a later time. For more information, see the “Manually Installing CSA” section on page 2-46. For information about manually uninstalling CSA, see the “Uninstalling

CSA” section on page 5-7.

The Cisco IPICS installer displays the Password Change Panel for the root user. See Figure 2-22 for an example. The root user has complete privileges in the Cisco Linux environment.

Cisco IPICS Server Installation Guide

2-31

Installing Cisco IPICS Server Software

Caution For security reasons, Cisco strongly recommends that you change the root

password from the default password that was supplied in your product package.

Figure 2-22 Password Panel for root User

Chapter 2 Installing the Cisco IPICS Server Software

2-32

Step 10 To change the root user password, enter a new password in the first password

field.

Caution When you enter your new root user password, make sure that you only use

passwords that begin with a-z, A-Z or 0-9. Cisco IPICS does not support the use of special characters as the first character in the root password. If you enter a special character as the first character in the root password, your root login will become inoperable and you will need to boot the system in the single user mode to change the root password and reinstall Cisco IPICS to resolve the problem.

For information about single user mode and changing the root password, see

Appendix A, “Changing the Cisco Linux Root Password.”

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Step 11 To confirm the new password, press Ta b and type the password again. Then, click

Next.

The Cisco IPICS installer displays the Password Change Panel for the ipicsadmin user.

Note After you complete the installation, you can change the password for the

Cisco Linux root user at any time. For more information about changing the root user password, see Appendix A, “Changing the Cisco Linux Root

Password.”.

Step 12 Repeat Step 10 and Step 11 for the ipicsadmin user and then for the informix user.

These users have the following capabilities:

• The ipicsadmin user has limited capability in the Cisco Linux environment.

This user can start, stop and restart the Tomcat service and browse the Cisco IPICS directories on the server machine.

• The informix user can perform all database-related activities, such as backup

and restore. The informix user cannot, however, cannot perform activities related to the Tomcat service, such as starting or stopping the Tomcat service.

Installing Cisco IPICS Server Software

OL-8155-01

Caution Never change the password for the informix user outside of the Cisco IPICS

installer. If you need to change the informix password, you should only do so when performing a Cisco IPICS installation or upgrade. When you manually change the informix password, the Cisco IPICS Administration Console becomes unusable.

The Cisco IPICS installer displays the Preinstallation Summary. See Figure 2-23 for an example.

The Preinstallation Summary displays the following information:

• The product name and version

• The destination folder for the installation

• Disk space information, including:

–

The amount of space required for the installation

–

The available space on the disk

Cisco IPICS Server Installation Guide

2-33

Installing Cisco IPICS Server Software

Figure 2-23 Preinstallation Summery

Chapter 2 Installing the Cisco IPICS Server Software

2-34

Step 13 To begin installing Cisco IPICS files, click Next.

The Installation Progress window displays, showing the files and folders being written to the disk. See Figure 2-24 for an example.

Note The Cisco IPICS server software installation typically takes about 20

minutes to complete.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-24 Cisco IPICS Installation Progress Window

Installing Cisco IPICS Server Software

OL-8155-01

Step 14 When the file installation completes, the Cisco IPICS Install Complete window

displays. See Figure 2-25 for an example of the window. This window lists the directory in which Cisco IPICS was installed, along with the URL where you may access the Cisco IPICS Administration Console.

Cisco IPICS Server Installation Guide

2-35

Installing Cisco IPICS Server Software

Figure 2-25 Install Complete Window

Chapter 2 Installing the Cisco IPICS Server Software

2-36

Step 15 To continue, click Next.

The Restart Computer window displays to provide you the option of restarting the computer now or at a later time. See Figure 2-26 for an example.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-26 Restart Computer Window

Installing Cisco IPICS Server Software

OL-8155-01

Step 16 At the Restart Computer window, choose from the following options:

• If you want to reboot the computer immediately, click the Restart Now radio

button and then click Done. The computer reboots after you click Done.

• If you want to reboot the computer later, click the Restart Later radio button

and then click Done. The installer closes this window and returns you to the Cisco Linux desktop.

Note If you choose the Restart Later option, be sure to complete the restart

before you attempt to log in to Cisco IPICS. Cisco IPICS processes, such as the Tomcat service and Informix database, will not start without rebooting the server.

Cisco IPICS Server Installation Guide

2-37

Chapter 2 Installing the Cisco IPICS Server Software

Installing Cisco IPICS Server Software

Installing Cisco IPICS from a Remote Location

You may find it necessary or desirable to perform the Cisco IPICS server software installation from a remote location on your network. This section describes the method for installing Cisco IPICS from a PC that is connected to the network.

Before you start the remote installation, you must transfer the installer file from the Cisco IPICS installation CD to the Cisco IPICS server. You use the one of the following methods to transfer the file:

• Place the CD (or have someone place it for you) in the Cisco IPICS server and

copy the installer file to the server

• 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 Tectia File Transfer Client

After you transfer the file to the Cisco IPICS server, you can execute the installer from an SSH Tectia Client window with the -i console option.

To install the Cisco IPICS server software from a remote location, perform the following procedure:

2-38

Procedure

Step 1 Perform one of the following procedures to transfer the Cisco IPICS installer file

to the Cisco IPICS server:

Copying the File from the CD Drive in the Server

a. Place the Cisco IPICS installation CD in the disk drive of the Cisco IPICS

server or have someone place the CD in the drive for you.

b. To connect remotely to the Cisco IPICS server from your PC, open the SSH

Tectia Client by choosing Start > All Programs > SSH Tectia Client > SSH Tectia Client.

c. To open a window for entering the server IP address, click Quick Connect.

The Connect to Remote Host window displays.

d. In the Host field, enter the DNS name or the IP address for your Cisco IPICS

server. Then, press Tab.

e. In the User Name field, enter root. Then, click Connect.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

The Enter Password window displays.

f. Enter the root password and then click OK.

An SSH Tectia Client window displays.

g. To see the contents of the CD, enter the following commands:

[root] #cd /mnt/cdrom

[root] #ls -l

The name of the Cisco IPICS installer file displays with a .bin extension.

h. To copy the file to your root directory, enter the following command:

[root] #cp /mnt/cdrom/<name of Cisco IPICS installer file>.bin .

where name of Cisco IPICS installer file represents the name of the .bin file that was displayed in Step g.

The file copies from the CD to your root directory.

Transferring the File from the your PC to the Server

a. Place the Cisco IPICS installation CD in the CD drive of your PC.

Installing Cisco IPICS Server Software

OL-8155-01

b. Open the SSH Tectia File Transfer Client by choosing Start >

All Programs > SSH Tectia Client > SSH Tectia Client - File Transfer.

The SSH Tectia File Transfer window displays. The desktop of your PC displays in the left pane.

c. To open a window for entering the server IP address, click Quick Connect.

The Connect to Remote Host window displays.

d. In the Host field, enter the DNS name or the IP address for your Cisco IPICS

server. Then, press Tab.

e. In the User Name field, enter root. Then, click Connect.

The Enter Password window displays.

f. Enter the root password and then click OK.

The SSH Tectia File Transfer Client connects to the Cisco IPICS server and displays the contents of the root directory in the right pane of the window.

g. In the left pane of the window, navigate to the directory on your PC to which

you saved the upgrade file.

Cisco IPICS Server Installation Guide

2-39

Installing Cisco IPICS Server Software

h. To initiate the copy procedure, drag the upgrade file from the left pane of the

window to the right pane.

A progress window displays while the file copies to the server. When the copy completes, the upgrade file displays in the right pane.

i. To close the SSH Tectia File Transfer Client, click X.

Step 2 To connect to the Cisco IPICS server, open an SSH Tectia Client window on your

PC by performing the following procedure:

a. To open the SSH Tectia Client, click Start and choose All Programs >

SSH Tectia Client > SSH Tectia Client.

The SSH Tectia Client displays.

b. To open a connection to the Cisco IPICS server, click Quick Connect.

The Connect to Remote Host window displays.

c. In the Host field, enter the DNS name or the IP address for your Cisco IPICS

server. Then, press Tab.

d. In the User Name field, enter root. Then, click Connect.

The Enter Password window displays.

Chapter 2 Installing the Cisco IPICS Server Software

2-40

e. Enter the root password and then click OK.

After the login completes, the SSH Tectia Client displays a root prompt for the Cisco IPICS server.

Step 3 To view the files in the root directory, enter the following command and press

Enter:

[root] #ls -l

Step 4 Locate the installer file, install_ipics_x_x.bin, where the x_x variable represents

the version of Cisco IPICS you are installing.

Step 5 To begin the installation, type the following command and then press Enter:

[root] #./<name of installer file>.bin -i console

where name of upgrade file represents the name of the .bin file you transferred to the server.

The window displays a message that informs you that the installer is extracting. See Figure 2-27 for an example of the message. Please wait while the server extracts the files.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-27 Starting the Remote Installation

After the files are extracted, the installer displays an introduction. See Figure 2-28 for an example.

Figure 2-28 Introduction to the Remote Installation

Installing Cisco IPICS Server Software

OL-8155-01

Step 6 To continue, press Enter.

The first page of the End User License Agreement displays. There are approximately eight pages to the agreement.

Step 7 Read each page and press Enter when you finish.

At the end of the final page of the End User License Agreement, the installer prompts you to accept the terms of the license agreement.

Step 8 If you accept the terms, press Y and Enter.

The Choose Install Set menu displays. You can choose from the following options:

• Typical—This option installs Cisco IPICS server software with CSA

• Customize—This option allows you to choose whether to install Cisco IPICS

server software with or without CSA

Cisco IPICS Server Installation Guide

2-41

Installing Cisco IPICS Server Software

• Upgrade—This option installs an upgrade to a previously installed version of

Cisco IPICS server software

Figure 2-29 Install Set Options

Step 9 To choose the Typical option, press Enter.

Note If you decide not to install CSA with this installation of Cisco IPICS

server software, you can manually install CSA at a later time. For more information, see the “Manually Installing CSA” section on page 2-46. For information about manually uninstalling CSA, “Uninstalling CSA”

section on page 5-7.

Chapter 2 Installing the Cisco IPICS Server Software

2-42

The installer prompts you to enter a new password for the root user.

Step 10 Enter a root password that is at least six characters in length. Then, press Enter.

Caution When you enter your new root user password, make sure that you only use

For information about single user mode and changing the root password, see

Appendix A, “Changing the Cisco Linux Root Password.”

The installer prompts you to re-enter the root password.

Step 11 Enter the root password again and press Enter.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

The installer prompts you to enter a password for the ipicsadmin user.

Step 12 Repeat Step 10 and Step 11 for the ipicsadmin user and the informix user. These

users have the following capabilities:

• The ipicsadmin user has limited capability in the Cisco Linux environment.

This user can start, stop and restart the Tomcat service and browse the Cisco IPICS directories on the server machine.

• The informix user can perform all database-related activities, such as backup

and restore. The informix user cannot, however, cannot perform activities related to the Tomcat service, such as starting or stopping the Tomcat service.

Caution Never change the password for the informix user outside of the Cisco IPICS

The Cisco IPICS installer displays the Preinstallation Summary. See Figure 2-30 for an example.

Installing Cisco IPICS Server Software

OL-8155-01

The Preinstallation Summary displays the following information:

• The product name and version

• The destination folder for the installation

• Disk space information, including:

–

The amount of space required for the installation

–

The available space on the disk

Cisco IPICS Server Installation Guide

2-43

Installing Cisco IPICS Server Software

Figure 2-30 Preinstallation Summary

Step 13 To continue, press Enter.

The installation process begins. Figure 2-31 shows an example of the installation progress indicator.

Chapter 2 Installing the Cisco IPICS Server Software

2-44

Figure 2-31 Installation Progress Indicator

The Cisco IPICS Install Complete message displays. See Figure 2-32 for an example of the window. This window lists the directory in which Cisco IPICS was installed, along with the URL where you may access the Cisco IPICS Administration Console.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Figure 2-32 Install Complete Message

To continue, press Enter.

The Restart Computer page displays an option for you to restart the server now or later. See Figure 2-33 for an example.

Figure 2-33 Restart Computer Option

Installing Cisco IPICS Server Software

OL-8155-01

Step 14 To restart the computer now, press Enter.

A broadcast message from root displays an announcement that the system will reboot in one minute. See Figure 2-34 for an example. After one minute, another broadcast message displays another announcement that the system is rebooting.

Cisco IPICS Server Installation Guide

2-45

Installing Cisco IPICS Server Software

Figure 2-34 Cisco Linux Reboot Broadcast Messages

When the system reboots, the connection to the server is disrupted.

Step 15 To close the SSH Tectia Client window, click X.

Manually Installing CSA

If you did not install CSA at the time of the Cisco IPICS server software installation, you can perform the CSA installation manually at any time. To install CSA manually, perform the following procedure:

Chapter 2 Installing the Cisco IPICS Server Software

2-46

Procedure

Step 1 Log in to the Cisco IPICS server with root privileges.

The Cisco Linux desktop displays.

Step 2 To open a terminal window, click the Red Hat menu and choose System Tools >

Terminal

A terminal window displays.

Step 3 Install the Linux kernel source package by entering the following command:

[root] #rpm -Uv kernel-source-2.4.21-32.0.1.EL.i386.rpm

Step 4 Change directory to the /tmp directory by entering the following command:

[root] #cd /tmp

Step 5 Enter the following command to untar the CSAStandAlone.tar file and place the

extracted copy in the /tmp/CSCOcsa directory:

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

[root tmp] #tar xvf /root/CSAStandAlone.tar

Step 6 Navigate to the /CSCOcsa directory by entering the following command:

[root tmp] #cd CSCOcsa

Step 7 To install the CSA software, enter the following command:

[root CSCOcsa] #sh install_rpm.sh

Step 8 Enter the following command to restart the server and complete the installation:

[root] #reboot

For information about manually uninstalling CSA, see the “Uninstalling CSA”

section on page 5-7.

Preparing to Use Cisco IPICS

Now that you have completed the Cisco IPICS installation, complete the following tasks, so that you can begin using the software:

Preparing to Use Cisco IPICS

• Checking the Installation, page 2-47

• Managing Your Licenses, page 2-49

• Generating the Cisco IPICS PMC Application Installer, page 2-58

For information on other Cisco IPICS setup and configuration tasks, refer to the

Cisco IPICS Server Administration Guide.

Checking the Installation

When you complete the Cisco IPICS server software installation, you should be able to access the Cisco IPICS Administration Console by using a browser. You can test the installation by opening a browser and logging in to the Administration Console.

Note There may be a delay of a few minutes before users can access the

Administration Console after the Cisco IPICS server restarts.

OL-8155-01

Cisco IPICS Server Installation Guide

2-47

Preparing to Use Cisco IPICS

To access the Cisco IPICS Administration Console from a browser and check the installation, perform the following procedure:

Procedure

Step 1 Open a browser window on your PC.

Step 2 In the Address field, enter either the static IP address or the DNS name that you

established for your Cisco IPCIS server in the “Installing the Cisco Linux

Operating System” section on page 2-3:

http://<

The Cisco IPICS Login window displays.

Step 3 Log in by using the Username, ipics, and the password, cisco123.

Note The ipics user has all privileges in Cisco IPICS and can perform any of

The Manage License window of the Cisco IPICS Administration Console displays with a message that you must upload a license file before you can use the software. See Figure 2-35 for an example.

Chapter 2 Installing the Cisco IPICS Server Software

static IP address or DNS name

the setup and configuration tasks.

2-48

Figure 2-35 Cisco IPICS Manage License Window

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

To obtain your license file, see the “Obtaining Your License File” section on

page 2-49.

Managing Your Licenses

Cisco IPICS manages the number of concurrent PMC and Cisco IP Phone users and the number of active voice ports with the license manager. As you use Cisco IPICS, the license manager tracks the number of PMC users and Cisco IP Phone users who are logged in at one time and the number of voice ports that are currently active. The number of users or voice ports cannot exceed the number of licenses that you have.

When you finish the Cisco IPICS installation, you can use the Product Authorization Key that was included in your Cisco IPICS product package to obtain a license file. You can then upload the license file to the Cisco IPICS server and begin using the system.

After you begin using Cisco IPICS, you may find that you require more user or voice port licenses. You can increase the number of licenses by purchasing more from Cisco. Cisco IPICS does not support removal or reduction of the number of licenses.

Preparing to Use Cisco IPICS

This section includes the following topics:

• Obtaining Your License File, page 2-49

• Purchasing Additional Licenses, page 2-54

• Uploading the Cisco IPICS Licenses, page 2-55

• Managing Licenses with the Ops Views Feature, page 2-57

• Tracking Your License Consumption, page 2-57

When you install Cisco IPICS, you may log in the Administration Console, but you cannot operate any features, such as configuring channels or creating VTGs, until you upload the licenses.

Obtaining Your License File

Your Cisco IPICS product package includes a Software License Claim Certificate that contains a Product Authorization Key (PAK), which is uniquely created from your sales order. You use this key to obtain licenses for your Cisco IPICS installation.

OL-8155-01

Cisco IPICS Server Installation Guide

2-49

Preparing to Use Cisco IPICS

After you upload your licenses and begin using Cisco IPICS, the license manager component monitors the concurrent usage of PMC users, Cisco IP Phone users, and active ports. If you find that you need additional licenses, you can purchase them from Cisco. For information on purchasing additional licenses, see the

“Purchasing Additional Licenses” section on page 2-54.

You can order your initial licenses any time after you begin the installation process.

To use your PAK to obtain your Cisco IPICS licenses, perform the following procedure:

Procedure

Step 1 Locate your Software License Claim Certificate that was included in your

Cisco IPICS product package. Look for the Product Authorization Key at the bottom of this certificate.

Note If you ordered your Cisco IPICS server software directly from Cisco,

Chapter 2 Installing the Cisco IPICS Server Software

your package may include only one Product Authorization Key. However, if you purchased Cisco IPICS through a distributor or reseller, you should have several individual packages, each with its own Product Authorization Key. In this case, you must process all of your Product Authorization Keys individually. Cisco sends you a license file for each one.

2-50

Step 2 Retrieve the MAC address that you noted during the Cisco Linux operating

system installation. If you misplaced the information, you can use one of the following methods to obtain it:

Obtain the MAC address using the Network Device Control window

To gather the MAC address information from the Network Device Control window, follow these steps:

a. Log in to the Cisco IPICS server with root privileges.

b. Open Network Device Control window to view information about the server

hardware. To do so, open the Red Hat menu on the Cisco Linux desktop and click the Red Hat icon.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

c. Choose System Tools > Network Device Control. See Figure 2-10 for an

example of the menu.

Figure 2-36 Using the Red Hat Menu

The Network Device Control window displays at least one active port. See

Figure 2-11 for an example of the window.

Preparing to Use Cisco IPICS

OL-8155-01

Note Your server may have more than one Ethernet port. If so, choose eth0.

Figure 2-37 Network Device Control Window

Cisco IPICS Server Installation Guide

2-51

Preparing to Use Cisco IPICS

d. To open the Network Configuration window, click the eth0 device from the

Chapter 2 Installing the Cisco IPICS Server Software

list and then click Configure.

The Network Configuration window displays. See Figure 2-12 for an example of the window.

e. To open the Ethernet Device Window, click eth0 again and then click Edit.

The Ethernet Device window displays.

Figure 2-38 Network Configuration Window

f. To view the MAC address for eth0, click the Hardware Device tab.

The MAC displays in the Bind to MAC Address field.

2-52

g. Click X in each of the windows to close them.

Obtain the MAC address with a Cisco Linux command:

To gather the information using a Cisco Linux command, perform the following procedure:

a. Log in to the Cisco IPICS server with root privileges.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

b. Open a terminal window to enter commands. To do so, open the Red Hat

menu on the Cisco Linux desktop by clicking the Red Hat icon and choosing System Tools > Terminal.

A terminal window displays.

c. To view the MAC address for your hardware, enter the following command:

[root] #ifconfig -a

Information displays about the network interface cards.

d. Locate the eth0 heading and note the HWaddr field. This is the MAC address

for the server.

e. To log out of the server, enter Exit at the command line and press Enter.

f. To close the terminal window, click X.

Step 3 Access Cisco.com using one of the following URLs:

• If you are a registered user of Cisco.com, use this URL:

http://www.cisco.com/go/license

• If you are not a registered user of Cisco.com, use this URL:

Preparing to Use Cisco IPICS

OL-8155-01

http://www.cisco.com/go/license/public

After you process your license order at Cisco.com, Cisco sends you an e-mail with the license file as an attachment.

Note Cisco IPICS does not support the edit or modification of the license file

name or file contents in any capacity. If you change or overwrite the license file name, you may invalidate your license and cause the system to operate incorrectly.

Step 4 Use the attached license file to upload licenses to Cisco IPICS after you finish the

installation.

If you processed several separate Product Authorization Keys, then you would receive several e-mail responses with a license file attached to each. When you upload these files, Cisco IPICS adds the licenses from each file and monitors your system activity according to the total number.

Cisco IPICS Server Installation Guide

2-53

Preparing to Use Cisco IPICS

For information about uploading the license files, see the “Uploading the

Cisco IPICS Licenses” section on page 2-55.

Purchasing Additional Licenses

After you begin using Cisco IPICS, you may find that you need additional licenses, so that you can provide access to more PMC or Cisco IP Phone users or accommodate more voice ports. You can purchase additional licenses from Cisco and then process them in the same way as the licenses that came with your original Cisco IPICS purchase.

When you need to purchase additional licenses, perform the following procedure:

Procedure

Step 1 Visit http://www.cisco.com or contact your reseller to purchase the additional

licenses.

Chapter 2 Installing the Cisco IPICS Server Software

2-54

Cisco processes your order and mails you a package that contains a license certificate with a new Product Authorization Key.

Note This Product Authorization Key is different than the one that you used to

process your original Cisco IPICS licenses.

Step 2 Locate the MAC address information for your hardware. If you have misplaced it

or you have new hardware, follow the procedure in Step 2 of the “Obtaining Your

License File” section on page 2-49 to retrieve the MAC address.

Step 3 To process your license file, follow the procedure in Step 3 of the “Obtaining Your

License File” section on page 2-49

Step 4 To upload the license file to Cisco IPICS, see the “Uploading the Cisco IPICS

Licenses” section on page 2-55.

After you upload your license file, the license manager processes the new licenses and updates your total number of licences.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Uploading the Cisco IPICS Licenses

When you receive your license file(s), you can upload them by accessing the Manage License window of the Cisco IPICS Administration Console.

Note When you upload the license file, Cisco IPICS places the file in the following

directory:

/opt/cisco/ipics/tomcat/current/webapps/ipics_server/license

To upload a license file, perform the following procedure:

Procedure

Step 1 Open a browser window on your PC.

Step 2 In the Address field, enter either the static IP address or the DNS name that you

established for your Cisco IPCIS server in the “Installing the Cisco Linux

Operating System” section on page 2-3:

http://<

static IP address or DNS name

Preparing to Use Cisco IPICS

OL-8155-01

The Cisco IPICS Login window displays.

Step 3 Log in by using the Username, ipics, and the password, cisco123.

The Manage License window displays.

Step 4 In the Add a License area, click Browse.

A navigation window displays files and folders on your PC.

Step 5 Navigate to the location where you saved the .LIC license file that you received

as an attachment from Cisco. Then, select the file and click Open.

The file name displays in the License File field.

Step 6 Click Upload to upload the file into the Cisco IPICS database. If you choose not

to upload this file, click Cancel.

A message displays with the status of the license file upload.

Step 7 To refresh the Cisco IPICS License Manager so that it recognizes the new

licenses, click Apply.

Cisco IPICS Server Installation Guide

2-55

Preparing to Use Cisco IPICS

Figure 2-39 Refreshing the License Window

The license manager processes the new licenses and updates your total number of licences in the Configured Licenses area of the Manage License window.

Step 8 If you uploaded a license for the ops views feature, you must restart the Tomcat

service before you can use ops views. To restart the Tomcat service, follow these steps:

a. Log in to the Cisco IPICS server with root user privileges.

b. To enter a CLI command, open a Cisco Linux terminal window by clicking

Chapter 2 Installing the Cisco IPICS Server Software

The Cisco Linux desktop displays.

the Red Hat menu and choosing System Tools > Terminal.

2-56

A terminal window displays.

c. Enter the following command at the prompt:

[root] #/etc/init.d/ipics_tomcat restart

After stopping, and then again after starting, the Tomcat service, Cisco Linux displays the message, [OK].

Note There may be a delay of a few minutes before users can access the

Administration Console after the Tomcat service restarts.

For more information on Cisco IPICS licenses and the ops views feature, refer to the Cisco IPICS Server Administration Guide.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Managing Licenses with the Ops Views Feature

When the ops views feature is enabled on the server, the system displays a Cisco Ops View entry under the Configured License area in the Administration Console License window, along with the word “Licensed” to indicate that the ops views functionality has been enabled. (When ops views is not enabled, this entry displays “Not Licensed.”)

Note When ops views is not enabled, Cisco IPICS displays the number of available

licenses and concurrent usage information in the License browser window, which does not reflect real-time data. The data that displays in this window shows the usage at the time that the license window was last accessed. To view the most current license information, make sure that you refresh your browser window often.

Tracking Your License Consumption

Cisco IPICS uses the following criteria to determine license consumption for ports and PMC usage:

Preparing to Use Cisco IPICS

OL-8155-01

• Cisco IPICS Ports Usage—A configured channel or activated VTG consumes

a port license. After the channel is deleted or the VTG is deactivated, the server releases the license and makes it available for use.

Cisco IPICS bases license usage for ports on the unique combination of a multicast address and a location; that is, if a channel has two multicast addresses that are assigned to the channel, two licenses are used. If one of the multicast addresses is removed, the system releases one of the licenses so that the port now consumes one license.

Note Be aware that an inactive VTG (VTG template) consumes a license

when a policy triggers (activates) that VTG. Therefore, if the number of licenses has been exceeded, the policy will not be able to activate the VTG. Make sure that the server has a sufficient number of licenses available for the configuration of policies.

• Cisco IPICS PMC Usage—A PMC user consumes a license each time that the

user logs in to a PMC session.

Cisco IPICS Server Installation Guide

2-57

Chapter 2 Installing the Cisco IPICS Server Software

Preparing to Use Cisco IPICS

If the same PMC user logs in to multiple PMC sessions from different PMC client machines, that user will consume multiple licenses (one for each PMC session).

Note If all Cisco IPICS licenses have been used, PMC user access to the

system will be interrupted. Make sure that you are aware of the current status of PMC licenses and that additional user licenses are purchased and installed immediately if this situation occurs.

Generating the Cisco IPICS PMC Application Installer

Cisco IPICS allows a user to download the PMC application installer from the Administration Console to a PMC client machine. After the user installs the PMC software, Cisco IPICS manages the automatic download of updates to the application. The Manage PMC window of the Administration Console allows a Cisco IPICS system administrator to upload version updates to the Cisco IPICS server and manage the distribution of the current and previous PMC versions to PMC users.

Before a user can access the installer from the Cisco IPICS server, you must first use the Administration Console to generate the installer. This procedure places the application onto the server, so that the PMC users can easily download the PMC application. When you generate the PMC installer, the Cisco IPICS server also writes the IP address of the server into the installer. Then, after the user downloads and installs the software, the PMC application can locate the server to log in.

2-58

To generate a new PMC installer for your system, perform the following procedure:

Procedure

Step 1 Open a browser window on your PC.

Step 2 In the Address field, enter either the static IP address or the DNS name that you

established for your Cisco IPCIS server in the “Installing the Cisco Linux

Operating System” section on page 2-3:

http://<

static IP address or DNS name

The Cisco IPICS Login window displays.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 2 Installing the Cisco IPICS Server Software

Step 3 Log in with system administrator privileges. You may also log in with the

Username, ipics, and the password, cisco123.

The User tab displays of the Administration Console displays.

Step 4 From the System Administrator tab, click the PMC Installer link.

The Manage PMC Installer window displays with information about the last time and date that the installer was generated.

Figure 2-40 Manage PMC Installer Window

Step 5 Choose the server IP address from the drop-down list box.

Preparing to Use Cisco IPICS

OL-8155-01

Step 6 Click Generate PMC Installer.

A message displays to inform you whether the PMC installer was successfully generated.

For more information on managing PMCs, refer to the Cisco IPICS Server

Administration Guide.

Cisco IPICS Server Installation Guide

2-59

Preparing to Use Cisco IPICS

Chapter 2 Installing the Cisco IPICS Server Software

2-60

Cisco IPICS Server Installation Guide

OL-8155-01

CHAPTER

Upgrading Cisco IPICS

When Cisco releases a new version of Cisco IPICS, you receive the upgrade in one of two ways:

• Downloading an installer by following the link that Cisco provides you when

an upgrade becomes available. You would then use a Secure File Transfer Protocol (SFTP) utility program to transfer the file to the Cisco IPICS server. This section includes a procedure that describes how to use the SSH Tectia File Transfer Client to accomplish this task.

• Using an installation CD, so that you can upgrade in the same way as you

would install Cisco IPICS.

The Cisco IPICS upgrade procedure installs new application software files, but preserves your database and log files. Cisco recommends that you back up your files before you begin the upgrade procedure. For information on backing up files, refer to the Cisco IPICS Backup and Restore Guide.

OL-8155-01

This chapter provides information about the procedures that you need to follow to upgrade Cisco IPICS after you have initially installed the system. This chapter includes the following sections:

• Performing the Upgrade from a CD, page 3-2

• Performing the Upgrade from a Downloaded File, page 3-10

Cisco IPICS Server Installation Guide

3-1

Performing the Upgrade from a CD

When Cisco provides an upgrade to Cisco IPICS, you may receive a CD so that you can perform the upgrade in a similar manner to the way that you performed the original Cisco IPICS installation.

Note Before you begin the upgrade procedure, back up your data and log files. For more

information, refer to the Cisco IPICS Backup and Restore Guide.

To upgrade Cisco IPICS from a CD, perform the following procedure:

Procedure

Step 1 To log in to the Cisco Linux operating system on the Cisco IPICS server, enter

root in the Username field of the Login window and press Enter.

Cisco Linux displays a window with a password field.

Step 2 Enter your root password and press Enter.

The Cisco Linux desktop displays.

Chapter 3 Upgrading Cisco IPICS

3-2

Step 3 Back up your data and log files. For more information, refer to the

Cisco IPICS Backup and Restore Guide.

Step 4 Insert the Cisco IPICS installation CD into the Cisco MCS disk drive.

If you did not install CSA, or if CSA is not running on the Cisco IPICS server, continue to Step 6.

If you installed CSA, a window displays a message about the removable media you placed in the disk drive and allows you to continue or terminate the mounting of the CD.

Step 5 To continue with the upgrade, click the Yes radio button and then click Apply.

Note You must click Ye s and Apply before the time limit of the window expires

or CSA will terminate the application by default.

The Cisco IPICS CD icon displays on the desktop. See Figure 3-1 for an example.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 3 Upgrading Cisco IPICS

Figure 3-1 Cisco IPICS CD Icon

Performing the Upgrade from a CD

OL-8155-01

Step 6 To open the CD contents, double-click the CD icon.

Cisco Linux displays a window that shows the Cisco IPICS installer file. See

Figure 3-2 for an example.

Note Please wait while the server is processing your request.

Cisco IPICS Server Installation Guide

3-3

Performing the Upgrade from a CD

Figure 3-2 Installer File on the Cisco IPICS CD

Chapter 3 Upgrading Cisco IPICS

3-4

Step 7 To start the installation, double-click the installer icon.

Cisco Linux displays a message window that offers options to display or run the installer file. See Figure 3-3 for an example.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 3 Upgrading Cisco IPICS

Figure 3-3 Run or Display Message Window

Performing the Upgrade from a CD

OL-8155-01

Step 8 When you are prompted to run or display the file contents, click Run in Terminal.

Note If you click Run, rather than Run in Terminal, there is a delay of

A message window displays and indicates that the installer has detected a previous version of Cisco IPICS exists on your server. See Figure 3-4 for an example of the window. You can choose from the following options:

• Continue—Proceeds with a full installation and overwrites your current

installation, including the contents of your database and any files that were backed up to the default backup directory, /devices

• Exit—Exits from the installation

Cisco IPICS Server Installation Guide

3-5

Performing the Upgrade from a CD

• Upgrade—Upgrades your Cisco IPICS server software to the new version,

but leaves your database and the data in the /devices directory intact

Figure 3-4 Upgrade Available Message

Chapter 3 Upgrading Cisco IPICS

3-6

Step 9 To continue with the upgrade, click Upgrade.

The Cisco IPICS installer window displays with an introduction to the process. See Figure 3-5 for an example of the window.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 3 Upgrading Cisco IPICS

Figure 3-5 Introduction in the Installer Window

Performing the Upgrade from a CD

OL-8155-01

Step 10 To continue with the installation, click Next.

The Cisco IPICS installer displays the End User License Agreement.

Step 11 Use the scroll bar in the License Agreement pane to view the entire agreement.

After you read the entire agreement text, click the I accept the terms of the License Agreement option. Then, click Next.

Note You can only continue with the installation if you accept the End User

License Agreement.

The Choose Install Set window displays with the following installation options:

• Typical—This option installs Cisco IPICS server software with CSA

• Customize—This option allows you to choose whether to install Cisco IPICS

server software with or without CSA

• Upgrade—This option installs an upgrade to a previously installed version of

Cisco IPICS server software

Cisco IPICS Server Installation Guide

3-7

Performing the Upgrade from a CD

Step 12 To upgrade Cisco IPICS, choose Upgrade. Then, click Next.

The Cisco IPICS installer displays the Preinstallation Summary. See Figure 3-6 for an example.

The Preinstallation Summary displays the following information:

• The product name and version

• The destination folder for the installation

• Disk space information, including:

–

Figure 3-6 Preinstallation Summery

Chapter 3 Upgrading Cisco IPICS

The amount of space required for the installation

The available space on the disk

3-8

Step 13 To continue, click Next.

The installer prompts you to enter a new password for the informix user.

Step 14 Enter an informix password that is at least six characters in length. Then, press

Enter.

The installer prompts you to re-enter the informix password.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 3 Upgrading Cisco IPICS

Step 15 Enter the informix password again and press Enter.

Caution Never change the password for the informix user outside of the Cisco IPICS

The Installation Progress window displays, showing the files and folders being written to the disk.

When the upgrade completes, the Cisco IPICS Install Complete window displays. See Figure 3-7 for an example.

Figure 3-7 Install Complete Window

Performing the Upgrade from a CD

OL-8155-01

Step 16 To close the installer and complete the upgrade, press Enter.

The installer closes this window and returns you to the Cisco Linux desktop.

Cisco IPICS Server Installation Guide

3-9

Chapter 3 Upgrading Cisco IPICS

Performing the Upgrade from a Downloaded File

If Cisco makes an upgrade file available on a Cisco website, you must download the upgrade file to your PC and then transfer it to the Cisco IPICS server.

After you place the upgrade file on the server, you can choose to use the graphical installer utility to perform the upgrade or you can perform the upgrade remotely, using the console option.

This section includes the following topics:

• Transferring the Upgrade File to the Server, page 3-10

• Performing the Upgrade at the Server, page 3-12

• Performing the Upgrade from a Remote Location, page 3-17

Transferring the Upgrade File to the Server

When you transfer the upgrade file to the Cisco IPICS server, you place the file in the root directory, where you can access it from the server or from a remote location on the network.

3-10

To download the file from a website and transfer it to the server, perform the following procedure:

Procedure

Step 1 From your PC, open a browser and enter in the Address field the URL Cisco

provides to access the download link that Cisco provides to you.

Step 2 Click the download link.

Step 3 When you are prompted to open or save the file, click Save.

A Save As window displays, that shows files and folders on your computer.

Step 4 Navigate to the C:\temp directory. See Figure 3-8 for an example.

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 3 Upgrading Cisco IPICS

Figure 3-8 Saving the Upgrade File to Your Computer

Performing the Upgrade from a Downloaded File

OL-8155-01

Step 5 Click Save.

The file downloads to the directory that you specified.

Step 6 Open the SSH Tectia File Transfer Client by choosing Start > All Programs >

SSH Tectia Client > SSH Tectia Client - File Transfer.

The SSH Tectia File Transfer window displays. The desktop of your PC displays in the left pane.

Step 7 To open a window for entering the server IP address, click Quick Connect.

The Connect to Remote Host window displays.

Step 8 In the Host field, enter the DNS name or the IP address for your Cisco IPICS

server. Then, press Tab.

Step 9 In the User Name field, enter root. Then, click Connect.

The Enter Password window displays.

Step 10 Enter the root password and then click OK.

Cisco IPICS Server Installation Guide

3-11

Performing the Upgrade from a Downloaded File

The SSH Tectia File Transfer Client connects to the Cisco IPICS server and displays the contents of the root directory in the right pane of the window.

Step 11 In the left pane of the window, navigate to the directory on your PC to which you

saved the upgrade file.

Step 12 To initiate the copy procedure, drag the upgrade file from the left pane of the

window to the right pane.

A progress window displays while the file copies to the server. When the copy completes, the upgrade file displays in the right pane.

Step 13 To close the SSH Tectia File Transfer Client, click X.

Performing the Upgrade at the Server

When you perform the upgrade directly from the server, you use a Cisco Linux terminal window. The procedure in this section assumes that you have transferred the upgrade file to the root directory of the Cisco IPICS server. If you have not already performed this step, see the “Transferring the Upgrade File to the Server”

section on page 3-10.

Chapter 3 Upgrading Cisco IPICS

3-12

Note Before you begin the upgrade procedure, back up your data and log files. For more

information, refer to the Cisco IPICS Backup and Restore Guide.

To perform the upgrade at the Cisco IPICS server, perform the following procedure:

Procedure

Step 1 Log in to the Cisco IPICS server with root privileges.

The Cisco Linux desktop displays.

Step 2 To open a terminal window, click the Red Hat menu and choose System Tools >

Terminal

A terminal window displays.

Step 3 To view the upgrade file, type the following command and then press Enter:

Cisco IPICS Server Installation Guide

OL-8155-01

Chapter 3 Upgrading Cisco IPICS

[root] #ls -al

The contents of the root directory display in the window.

Step 4 To begin the upgrade, enter the following command:

[root] #./<name of upgrade file>.bin

where name of upgrade file represents the name of the .bin file that you downloaded and transferred to the server.

A message window displays and indicates that the installer has detected a previous version of Cisco IPICS exists on your server. See Figure 3-9 for an example of the window. You can choose from the following options:

• Continue—Proceeds with a full installation and overwrites your current

installation, including the contents of your database and any files that were backed up to the default backup directory, /devices

• Exit—Exits from the installation

• Upgrade—Upgrades your Cisco IPICS server software to the new version,

but leaves your database and the data in the /devices directory intact

Performing the Upgrade from a Downloaded File

OL-8155-01

Figure 3-9 Upgrade Available Message

Step 5 To continue with the upgrade, click Upgrade.

Cisco IPICS Server Installation Guide

3-13

Performing the Upgrade from a Downloaded File

The Cisco IPICS installer window displays with an introduction to the process. See Figure 3-10 for an example.

Figure 3-10 Introduction in the Installer Window

Chapter 3 Upgrading Cisco IPICS

3-14

Step 6 To continue with the upgrade, click Next.

The Cisco IPICS installer displays the End User License Agreement.

Step 7 Use the scroll bar in the License Agreement pane to view the entire agreement.

After you read the entire agreement text, click the I accept the terms of the License Agreement option. Then, click Next.

Note You can only continue with the installation if you accept the End User

License Agreement.

The Choose Install Set window displays with the following installation options:

• Typical—This option installs Cisco IPICS server software with CSA

• Customize—This option allows you to choose whether to install Cisco IPICS

server software with or without CSA

Cisco IPICS Server Installation Guide

OL-8155-01

Cisco OL-8155-01 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

CONTENTS

Introduction

Audience

Preface

Organization

Related Documentation

Cisco 7800 Series Media Convergence Servers Documentation

Cisco IP Phone Documentation

Cisco Land Mobile Radio over IP

Cisco Security Agent

Cisco IOS Documentation

Document Notes and Conventions

Obtaining Documentation

Cisco.com

Product Documentation DVD

Ordering Documentation

Documentation Feedback

Cisco Product Security Overview

Obtaining Technical Assistance

Reporting Security Problems in Cisco Products

Cisco Technical Support & Documentation Website

Submitting a Service Request

Definitions of Service Request Severity

Obtaining Additional Publications and Information

Overview

Installation Overview

Installed Components

System Requirements

Hardware Requirements

PMC Requirements

Cisco IP Phone Requirements

Software Requirements

Installing the Cisco IPICS Server Software

Before You Begin

Preinstallation Checklist

Installing the Cisco Linux Operating System

Installing Cisco IPICS Server Software

Manually Installing CSA

Checking the Installation

Managing Your Licenses

Obtaining Your License File

Purchasing Additional Licenses

Managing Licenses with the Ops Views Feature

Tracking Your License Consumption

Generating the Cisco IPICS PMC Application Installer

Upgrading Cisco IPICS

Performing the Upgrade from a CD

Performing the Upgrade from a Downloaded File

Transferring the Upgrade File to the Server

Performing the Upgrade at the Server