REVIEW DRAFT—CISCO CONFIDENTIAL
CH A P T E R
3
Upgrading Cisco IPICS
If your Cisco IPICS server is running release 2.2(1)SR1, release 4.0(1), or release
4.0(2), you can upgrade your server to release 4.5(1).
If your Cisco IPICS server is running release 4.5(1), you can upgrade your server
to release 4.5(2).
Tip
To verify which versions of Cisco IPICS are compatible for upgrade, see
Cisco IPICS Compatibility Matrix at http://www.cisco.com/en/US/products/
ps6718/products_device_support_tables_list.html.
This chapter contains information about upgrading your software to Cisco IPICS
release 4.5(1) and other actions that you must take to fully complete this upgrade
process and includes the following sections:
•
Before You Begin, page 3-2
•
Performing a Cisco IPICS Server Software Upgrade, page 3-3
•
Using the Cisco Incident Dispatch Console with Cisco IPICS 4.5, page 3-22
•
Upgrading the Radio Descriptor, page 3-22
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-1
Chapter 3
Upgrading Cisco IPICS
Before You Begin
REVIEW DRAFT—CISCO CONFIDENTIAL
Before You Begin
Be aware of the following guidelines, and perform one or more of the following
suggested actions, before you upgrade your server software:
•
Cisco recommends that you back up the database to a remote host. If you
encounter problems during the upgrade, you can reinstall your current version
of the Cisco IPICS software and restore your database from the remote
backup to return your system to its previous state. For information about
backing up and restoring the Cisco IPICS database, refer to the “Performing
Cisco IPICS Backup and Restore Operations” chapter in Cisco IPICS Server
Administration Guide.
•
You can set up a new version of the latest supported IDC so that the IDC
download process is staged. Staging the IDC download alleviates the burden
of long IDC downloads to all users at one time. For more information about
this feature, refer to the “Installing a New IDC Version Before You Upgrade
Your Cisco IPICS Server” section in the “Performing Cisco IPICS System
Administrator Tasks” chapter in Cisco IPICS Server Administration Guide.
•
Cisco IPICS retains existing attributes for channels, VTGs, and users during
an upgrade. However, the default setting for the Allow Latch attribute is set
to disabled (unchecked) when you create new channels or VTGs in this
release. For more information about the Allow Latch attribute, refer to the
“Performing Cisco IPICS System Administrator Tasks” chapter in
Cisco IPICS Server Administration Guide.
•
If you are upgrading from Cisco IPICS release 2.2(1)SR1, you will need a
Cisco IPICS 4.5 license file. If you are upgrading Cisco IPICS 4.0(1) or
4.0(2), you will need a Cisco IPICS 4.5 license file if you upgrade to a
different server or will implement new Cisco IPICS 4.5 features. Make sure
to obtain the license file from Cisco or your Cisco partner.
•
If you are upgrading from Cisco IPICS release 4.5(1) take these actions in the
Cisco IPICS Administration Console:
– Disable the ISSIG (from the Configuration drawer in the Server tab,
choose Radios , choose the desired ISSIG, and then click Disable).
– Deactivate each RMS component in your deployment (from the
Configuration drawer in the Server tab, choose RMS, and for each RMS,
check its checkbox and then click Deactivate).
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-2
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
– If you are using high availability for the UMS component, unpair each
UMS pair then delete each one. (To unpair, go to from the Configuration
drawer in the Server tab, choose UMS, choose either UMS in a pair,
choose the Advanced Configuration tab, uncheck the HA Enabled
check box, and then click Save. To delete, from the Configuration
drawer, choose UMS, and for each UMS, check its checkbox and then
click Delete.)
Performing a Cisco IPICS Server Software Upgrade
The following sections provide instructions for upgrading your Cisco IPICS
software to release 4.5(1):
•
Upgrading from Cisco IPICS Release 2.2(1)SR1, 4.0(1), or 4.0(2) to Cisco
IPICS Release 4.5(1) in a Deployment without High Availability, page 3-3
•
Upgrading from Cisco IPICS Release 4.0(1) or 4.0(2) to Cisco IPICS Release
4.5(1) on existing Servers in a Deployment with High Availability, page 3-7
•
Upgrading from Cisco IPICS Release 4.0(1) or 4.0(2) to Cisco IPICS Release
4.5(1) and Migrating to New Servers in a Deployment with High Availability,
page 3-13
•
Upgrading from Cisco IPICS Release 4.5(1) to Cisco IPICS Release 4.5(2) in
a Deployment without High Availability, page 3-17
•
Upgrading from Cisco IPICS Release 4.5(1) to Cisco IPICS Release 4.5(2) in
a Deployment with High Availability, page 3-18
Upgrading from Cisco IPICS Release 2.2(1)SR1, 4.0(1), or 4.0(2) to
Cisco IPICS Release 4.5(1) in a Deployment without High
Availability
To upgrade from Cisco IPICS release 2.2(1)SR1, 4.0(1), or 4.0(2) to Cisco IPICS
release 4.5(1) in a deployment without high availability, perform the following
procedure.
If your existing Cisco IPICS software is installed on a Cisco Multiservices
Platform Series server, you can perform this upgrade on that server or migrate to
a new Cisco Multiservices Platform Series server. If your existing Cisco IPICS
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-3
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
software is installed on a MCS device, you must migrate to a supported Cisco
Multiservices Platform Series server when you perform this upgrade. The
following procedure provides instructions for each of these options.
Procedure
Step 1
From a client PC, take these actions to obtain the upgrade scripts and create an
upgrade script disk:
a.
Go to this URL (you must have a valid Cisco.com user ID and password
before you can access this URL):
http://www.cisco.com/cisco/software/navigator.html?mdfid=
280723930&flowid=7120
b.
Click the Cisco IPICS Release 4.5 link.
c.
Click the Download button for ipics_upgrade_45_script.zip.
d.
Follow the onscreen instructions to download the upgrade script to your local
drive.
e.
Unzip the zip file that you downloaded.
The zip file contains three scripts.
f.
Copy each script to a CD or DVD. This disk is your upgrade script disk.
Step 2
Access the Cisco IPICS server via an SSH client or the Console window and log
in as the Linux root user.
Step 3
Put the upgrade script disk in the disk drive and enter this command to mount it:
[root]# mount /mnt/cdrom
mount: block device /dev/hda is write-protected, mounting
Step 4
Copy the script pre_ipics_db_upgrade_22_45 or
pre_ipics_db_upgrade_40_45 on the upgrade script disk to the existing Cisco
IPICS server under /root.
Step 5
Back up the existing Cisco IPICS database to a remote server by using the
following command, where:
•
backup_script_name is pre_ipics_db_upgrade_22_45 if you are upgrading
from release 2.2(1)SR1, or pre_ipics_db_upgrade_40_45 if you are
upgrading from release 4.0(1) or 4.0(2)
•
remote_directory is the directory in which to save the database
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-4
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
•
remote_host_IP is the IP address of the remote server
•
root_password is the root password of that server
Note
You must save the file to a remote location because the file is deleted as
part of the new operating system installation. Make sure that the directory
in which to save the database exists and that it has sufficient space for the
database. Do not save the file in the /tmp directory or in any directory
under that directory.
[root]# ./backup_script_name remote_directory remote_host_IP root
‘root_password’
The command saves the database backup to either of these files:
•
dbspaces_ipics22.tgz—If you are upgrading from release 2.2(1)SR1
•
dbspaces_ipics40.tgz—If you are upgrading from release 4.0(1) or 4.0(2)
For example, enter the following command, where rootpwd is the root password
of the server (make sure to include the single quotes [‘]). In this example, the
output is saved to the file dbspaces_ipics22.tgz.
[root]# ./pre_ipics_db_upgrade_22_45 /root 10.3.2.1 root ‘rootpwd’
Note
The database backup process is different from the normal database
backup that is available in the Cisco IPICS server. After you install Cisco
IPICS release 4.5(1), the database backup file that you created is required
to replicate your database in release 4.5(1).
Step 6
If your existing Cisco IPICS server is storing audio, image, and video files for use
with the Cisco IPICS Dispatch Console, manually copy these files from the
/documents folder on the Cisco IPICS server to a remote server.
Step 7
If the server that will run Cisco IPICS 4.5 is not running release 4.5 of the IPICS
operating system, install that operating system as described in the “Installing the
IPICS Operating System on a Multiservices Platform Series Server” section on
page 2-7.
Step 8
If you installed release 4.5 of the IPICS operating system in Step 7, configure the
server that you will use with IPICS 4.5(1) as described in the “Configuring Server
Parameters on the Multiservices Platform Series Server” section on page 2-10.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-5
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Step 9
Install Cisco IPICS 4.5(1) software as described in the “Installing the Cisco IPICS
Server Software” section on page 2-13.
Step 10
Take these actions to restore the Cisco IPICS database that you backed up earlier
in this procedure:
Note
This process may take up to 30 minutes. Make sure that you allow time
for the process to complete.
a.
Access the Cisco IPICS server on which you installed Cisco IPICS 4.5(1) via
an SSH client or the Console window and log in as the Linux root user.
b.
Enter this command:
[root]# cd /opt/cisco/ipics/database/bin
c.
Enter the following command, where:
– restore_script_name is ipics_db_upgrade_22_45 if you are upgrading
from release 2.2(1)SR1, or ipics_db_upgrade_40_45 if you are
upgrading from release 4.0(1) or 4.0(2)
– remote_directory is directory in which you backed up the database in
Step 5
– remote_host_IP is the IP address of the remote server to which you
backed up the database
– root_password is the root password of remote server to which you backed
up the database
[root]# ./restore_script_name remote_directory remote_host_IP root
‘root password’
As the restore operation executes, the system displays information about the
process. When the restore operation completes, the Cisco IPICS server
initializes.
Step 11
If you manually backed up audio, image, and video files in Step 6, take these
actions:
a.
Manually copy these backed up files from the remote server to the /documents
folder on the Cisco IPICS server.
b.
On the Cisco IPICS server, enter these commands to set required ownership
and permissions for each audio, image, and video file:
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-6
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
[root]# /bin/chown -R ipicsadmin:ipicsadmin /documents/*
[root]# /bin/chmod -R 660 /documents/*
Step 12
Take these actions to upload the Cisco IPICS License file to the Cisco IPIC server:
a.
Use a Web browser to access the Cisco IPICS application and log in as the
system administrator.
The License Management page opens.
b.
From the License Management page, use the Browse button to locate the
IPICS 4.5 Upgrade license file provided by Cisco, and choose that license
file.
The license file name appears in the License File field.
c.
Click the Upload button to copy the license file to the Cisco IPICS server.
d.
Click the Apply button to apply the license.
Upgrading from Cisco IPICS Release 4.0(1) or 4.0(2) to Cisco IPICS
Release 4.5(1) on existing Servers in a Deployment with High
Availability
To upgrade from Cisco IPICS release 4.0(1) or 4.0(2) to Cisco IPICS release
4.5(1) on existing servers in a deployment with high availability, perform the
following procedure.
Procedure
Step 1
Take these actions to transfer the Cisco IPICS active state to the standby Cisco
IPICS server:
a.
Log in to the Cisco IPICS Administration Console.
b.
Navigate to the Configuration > High Availability window.
c.
Click the HA Configuration tab.
d.
Click the Failover Now button.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-7
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
The standby server becomes the new active server and the active server
becomes the standby server.
Step 2
From a client PC, take these actions to obtain the upgrade scripts and create an
upgrade script disk:
a.
Go to this URL (you must have a valid Cisco.com user ID and password
before you can access this URL):
http://www.cisco.com/cisco/software/navigator.html?mdfid=
280723930&flowid=7120
b.
Click the Cisco IPICS Release 4.5 link.
c.
Click the Download button for ipics_upgrade_45_script.zip.
d.
Follow the onscreen instructions to download the upgrade script to your local
drive.
e.
Unzip the zip file that you downloaded.
The zip file contains three scripts.
f.
Step 3
Access the primary (now standby) Cisco IPICS server via an SSH client or the
Console window and log in as the Linux root user.
Note
Step 4
Copy each script to a CD or DVD. This disk is your upgrade script disk.
The primary server is now the standby server because you performed a
failover earlier in this procedure.
Put the upgrade script disk in the disk drive on the primary (standby) server and
take these actions
a.
Enter this command to mount the disc:
[root]# mount /mnt/cdrom
mount: block device /dev/hda is write-protected, mounting
b.
Copy the pre_ipics_upgrade_40_45_disable_HA and the
pre_ipics_db_upgrade_40_45 files on the upgrade script disk to the server
under /root.
c.
Enter this command, which prevents the primary (standby) server from
becoming active during the upgrade process:
[root]# ./pre_ipics_upgrade_40_45_disable_HA
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-8
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Step 5
Back up the existing Cisco IPICS database to a remote server by entering the
following command primary (standby) server, where:
•
remote_directory is the directory in which to save the database
•
remote_host_IP is the IP address of the remote server
•
root_password is the root password of that server
Note
You must save the file to a remote location because the file is deleted as
part of the new operating system installation. Make sure that the directory
in which to save the database exists and that it has sufficient space for the
database. Do not save the file in the /tmp directory or in any directory
under that directory.
[root]# ./pre_ipics_db_upgrade_40_45 remote_directory remote_host_IP
root ‘root_password’
The command saves the database backup to the file dbspaces_ipics40.tgz.
For example, enter the following command, where rootpwd is the root password
of the server (make sure to include the single quotes [‘]). In this example, the
output is saved to the file dbspaces_ipics40.tgz.
[root]# ./pre_ipics_db_upgrade_40_45 /root 10.3.2.1 root ‘rootpwd’
Note
Step 6
The database backup process is different from the normal database
backup that is available in the Cisco IPICS server. After you install Cisco
IPICS release 4.5(1), the database backup file that you created is required
to replicate your database in release 4.5(1).
Take these actions on the primary (standby) server:
a.
If the server is storing audio, image, and video files for use with the Cisco
IPICS Dispatch Console, manually copy these files from the /documents
folder on the Cisco IPICS server to a remote server.
b.
If the server is not running release 4.5 of the IPICS operating system, install
that operating system as described in the “Installing the IPICS Operating
System on a Multiservices Platform Series Server” section on page 2-7.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-9
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
c.
If you installed release 4.5 of the IPICS operating system, configure the
server as described in the “Configuring Server Parameters on the
Multiservices Platform Series Server” section on page 2-10.
Set the IP address of this server to the same address that was used before you
installed the operating system.
d.
Step 7
Install Cisco IPICS 4.5(1) software on the server described in the “Installing
the Cisco IPICS Server Software” section on page 2-13.
Take these actions to restore the Cisco IPICS database that you backed up earlier:
Note
This process may take up to 30 minutes. Make sure that you allow time
for the process to complete.
a.
Access the server on which you installed the Cisco IPICS 4.5(1) software via
an SSH client or the Console window and log in as the Linux root user.
b.
Enter this command:
[root]# cd /opt/cisco/ipics/database/bin
c.
Enter the following command, where:
– remote_directory is directory in which you backed up the database in
Step 5.
– remote_host_IP is the IP address of the remote server to which you
backed up the database
– root_password is the root password of remote server to which you backed
up the database
[root]# ./ipics_db_upgrade_40_45 remote_directory remote_host_IP
root ‘root password’
As the restore operation executes, the system displays information about the
process. When the restore operation completes, the Cisco IPICS server
initializes.
Step 8
If you manually backed up audio, image, and video files in Step 6, take these
actions:
a.
Manually copy these backed up files from the remote server to the /documents
folder on the server on which you installed the Cisco IPICS 4.5(1) software.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-10
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
b.
On the server on which you installed the Cisco IPICS 4.5(1) software, enter
these commands to set required ownership and permissions for each audio,
image, and video file:
[root]# /bin/chown -R ipicsadmin:ipicsadmin /documents/*
[root]# /bin/chmod -R 660 /documents/*
Step 9
(Optional) If you will implement new Cisco IPICS 4.5 features, take the following
actions to upload the Cisco IPICS License file to the server on which you installed
the Cisco IPICS 4.5(1) software (this server will be the primary server when you
reestablish HA):
a.
Use a Web browser to access the Cisco IPICS application and log in as the
system administrator.
The License Management page opens.
b.
From the License Management page, use the Browse button to locate the
IPICS 4.5 Upgrade license file provided by Cisco, and choose that license
file. Make sure to choose the appropriate license file for the primary server.
The license file name appears in the License File field.
Step 10
c.
Click the Upload button to copy the license file to the Cisco IPICS server.
d.
Click the Apply button to apply the license.
Take these actions on the secondary (active) server:
a.
If the server is not running release 4.5 of the IPICS operating system, install
that operating system as described in the “Installing the IPICS Operating
System on a Multiservices Platform Series Server” section on page 2-7.
b.
If you installed release 4.5 of the IPICS operating system, configure the
server as described in the “Configuring Server Parameters on the
Multiservices Platform Series Server” section on page 2-10.
Set the IP address of this server to the same address that was used before you
installed the operating system.
c.
Install Cisco IPICS 4.5(1) software on the server described in the “Installing
the Cisco IPICS Server Software” section on page 2-13.
d.
Use a Web browser to access the Cisco IPICS application and log in as the
system administrator.
The License Management page opens.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-11
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
e.
From the License Management page, use the Browse button to locate the
IPICS 4.5 Upgrade license file provided by Cisco, and choose that license
file. Make sure to choose the appropriate license file for the secondary server.
The license file name appears in the License File field.
Step 11
f.
Click the Upload button to copy the license file to the Cisco IPICS server.
g.
Click the Apply button to apply the license.
Take these actions to configure the two servers on which you installed Cisco
IPICS 4.5(1) as an HA pair.
a.
Use a Web browser to access the Cisco IPICS application on the server that
is to be the primary Cisco IPICS server and log in as the system administrator
b.
Navigate to the Configuration > High Availability window.
c.
In the IP Address field, enter the IP address of the server that is to be the
secondary Cisco IPICS server.
d.
In the User Password password field, enter the password of the Cisco IPICS
administrator.
e.
Click Save.
Do not configure options in the HA Configuration tab. You will perform
additional configuration by using a script.
f.
Access the server that is to be the primary Cisco IPICS server via an SSH
client or the Console window and log in as the Linux root user.
g.
Enter this command:
[root]# cd /opt/cisco/ipics/database/bin
h.
Enter this command:
[root]# ./post_ipics_upgrade_40_45_enable_HA
For related information about high availability, see the “Configuring and
Managing Cisco IPICS High Availability” section in Cisco IPICS Server
Administration Guide.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-12
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Upgrading from Cisco IPICS Release 4.0(1) or 4.0(2) to Cisco IPICS
Release 4.5(1) and Migrating to New Servers in a Deployment
with High Availability
To upgrade from Cisco IPICS release 4.0(1) or 4.0(2) to Cisco IPICS release
4.5(1) and to migrate to new servers in a deployment with high availability,
perform the following procedure:
Procedure
Step 1
From a client PC, take these actions to obtain the upgrade scripts and create an
upgrade script disk:
a.
Go to this URL (you must have a valid Cisco.com user ID and password
before you can access this URL):
http://www.cisco.com/cisco/software/navigator.html?mdfid=
280723930&flowid=7120
b.
Click the Cisco IPICS Release 4.5 link.
c.
Click the Download button for ipics_upgrade_45_script.zip.
d.
Follow the onscreen instructions to download the upgrade script to your local
drive.
e.
Copy each script to a CD or DVD. This disk is your upgrade script disk.
Step 2
Access the Cisco IPICS server via an SSH client or the Console window and log
in as the Linux root user.
Step 3
Put the upgrade script disk in the disk drive and enter this command to mount it:
[root]# mount /mnt/cdrom
mount: block device /dev/hda is write-protected, mounting
Step 4
Copy the script pre_ipics_db_upgrade_22_45 or
pre_ipics_db_upgrade_40_45 on the upgrade script disk to the existing Cisco
IPICS server under /root.
Step 5
Back up the existing Cisco IPICS database to a remote server by using the
following command, where:
•
remote_directory is the directory in which to save the database
•
remote_host_IP is the IP address of the remote server
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-13
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
•
Note
root_password is the root password of that server
You must save the file to a remote location because the file is deleted as
part of the new operating system installation. Make sure that the directory
in which to save the database exists and that it has sufficient space for the
database. Do not save the file in the /tmp directory or in any directory
under that directory.
[root]# ./pre_ipics_db_upgrade_40_45 remote_directory remote_host_IP
root ‘root_password’
The command saves the database backup to the file dbspaces_ipics40.tgz.
For example, enter the following command, where rootpwd is the root password
of the server (make sure to include the single quotes [‘]). In this example, the
output is saved to the file dbspaces_ipics40.tgz.
[root]# ./pre_ipics_db_upgrade_40_45 /root 10.3.2.1 root ‘rootpwd’
Note
The database backup process is different from the normal database
backup that is available in the Cisco IPICS server. After you install Cisco
IPICS release 4.5(1), the database backup file that you created is required
to replicate your database in release 4.5(1).
Step 6
If your existing primary Cisco IPICS server is storing audio, image, and video
files for use with the Cisco IPICS Dispatch Console, manually copy these files
from the /documents folder on the Cisco IPICS server to a remote server.
Step 7
Configure each new server that you will use with IPICS 4.5(1) as described in the
“Configuring Server Parameters on the Multiservices Platform Series Server”
section on page 2-10.
To minimize Cisco IPICS downtime, Cisco recommends that you configure the
new servers with IP addresses that are different from those that are configured for
the existing servers. If you want to configure the new servers with the same IP
addresses as those that are configured for the existing servers, power off the
existing servers or remove them from the network before you configure the new
servers.
Step 8
Install Cisco IPICS 4.5(1) software on each new server as described in the
“Installing the Cisco IPICS Server Software” section on page 2-13.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-14
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Step 9
Take these actions to restore the Cisco IPICS database that you backed up earlier
in this procedure to the new server that will be the primary Cisco IPICS server:
Note
This process may take up to 30 minutes. Make sure that you allow time
for the process to complete.
a.
Access the new Primary Cisco IPICS server via an SSH client or the Console
window and log in as the Linux root user.
b.
Enter this command:
[root]# cd /opt/cisco/ipics/database/bin
c.
Enter the following command, where:
– remote_directory is directory in which you backed up the database in
Step 5
– remote_host_IP is the IP address of the remote server to which you
backed up the database
– root_password is the root password of remote server to which you backed
up the database
[root]# ./ipics_db_upgrade_40_45 remote_directory remote_host_IP
root ‘root password’
As the restore operation executes, the system displays information about the
process. When the restore operation completes, the Cisco IPICS server
initializes.
Step 10
If you manually backed up audio, image, and video files in Step 6, take these
actions:
a.
Manually copy these backed up files from the remote server to the /documents
folder on the primary Cisco IPICS server.
b.
On the primary Cisco IPICS server, enter these commands to set required
ownership and permissions for each audio, image, and video file:
[root]# /bin/chown -R ipicsadmin:ipicsadmin /documents/*
[root]# /bin/chmod -R 660 /documents/*
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-15
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Step 11
Take these actions to upload the Cisco IPICS License file to the primary
Cisco IPICS server:
a.
Use a Web browser to access the Cisco IPICS application on the primary
Cisco IPICS server and log in as the system administrator.
The License Management page opens.
b.
From the License Management page, use the Browse button to locate the
IPICS 4.5 Upgrade license file provided by Cisco, and choose that license
file. Make sure to choose the appropriate license file for the primary server.
The license file name appears in the License File field.
Step 12
c.
Click the Upload button to copy the license file to the Cisco IPICS server.
d.
Click the Apply button to apply the license.
Take these actions to upload the Cisco IPICS License file to the secondary
Cisco IPICS server:
a.
Use a Web browser to access the Cisco IPICS application on the secondary
Cisco IPICS server and log in as the system administrator.
The License Management page opens.
b.
From the License Management page, use the Browse button to locate the
IPICS 4.5 Upgrade license file provided by Cisco, and choose that license
file. Make sure to choose the appropriate license file for the secondary server.
The license file name appears in the License File field.
Step 13
c.
Click the Upload button to copy the license file to the Cisco IPICS server.
d.
Click the Apply button to apply the license.
Configure the two new servers as an HA pair.
For instructions, see the “Configuring and Managing Cisco IPICS High
Availability” section in Cisco IPICS Server Administration Guide.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-16
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Upgrading from Cisco IPICS Release 4.5(1) to Cisco IPICS Release
4.5(2) in a Deployment without High Availability
To upgrade from Cisco IPICS release 4.5(1) to Cisco IPICS release 4.5(2) in a
deployment without high availability, perform the following procedure:
Procedure
Step 1
From a client PC, take these actions to obtain the upgrade scripts and create an
upgrade script disk:
a.
Go to this URL (you must have a valid Cisco.com user ID and password
before you can access this URL):
http://www.cisco.com/cisco/software/navigator.html?mdfid=
280723930&flowid=7120
b.
Click the Cisco IPICS Release 4.5 link.
c.
Click the Download button for upgrade-ipics-4.5.2.bin.
d.
Follow the onscreen instructions to download the upgrade file to your local
drive.
e.
Copy each script to a CD or DVD. This disk is your upgrade disk.
Step 2
Access the primary Cisco IPICS server via an SSH client or the Console window
and log in as the Linux root user.
Step 3
Put the upgrade disk in the disk drive and enter these commands to copy the
upgrade file to the Cisco IPICS server and start the upgrade program:
[root]#
[root]#
[root]#
[root]#
[root]#
[root]#
mount /dev/cdrom /mnt/cdrom
cd /mnt/cdrom
cp upgrade-ipics-4.5.2.bin /root
cd /root
chmod 750 upgrade-ipics-4.5.2.bin
./upgrade-ipics-4.5.2.bin
The upgrade process begins.
Cisco IPICS begins the installation process. After a short time, you see a
Welcome message.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-17
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Step 4
When you see a Welcome message, press Enter.
Text displays to inform you that you must read and accept the terms of the End
User License Agreement (EULA) before you can proceed.
Step 5
Take these actions
a.
Press Enter to display the EULA.
The Cisco IPICS installer displays the EULA.
b.
Press the Spacebar to scroll through and view the EULA, then type y and
press Enter to continue with the installation.
You must accept the terms of the EULA to proceed.
Note
Step 6
To terminate the installation while the EULA is being displayed,
press Ctrl+C. The installation terminates after the installation
program displays the entire EULA.
When you are prompted to begin the installation process, type y then press Enter.
The Cisco IPICS software begins the installation process. A progress bar
indicates the percentage of the installation that has completed.
After the file installation completes, a message informs you of the status.
Step 7
If you are using the UMS or the ISSIG, install the 4.5(2) version of these
components as described in the following sections:
•
Installing the UMS Software, page 4-5
•
Installing the ISSIG Software, page 5-5
Upgrading from Cisco IPICS Release 4.5(1) to Cisco IPICS Release
4.5(2) in a Deployment with High Availability
To upgrade from Cisco IPICS release 4.5(1) to Cisco IPICS release 4.5(2) in a
deployment with high availability, perform the following procedure.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-18
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Procedure
Step 1
From a client PC, take these actions to obtain the upgrade scripts and create an
upgrade script disk:
a.
Go to this URL (you must have a valid Cisco.com user ID and password to
access this URL):
http://www.cisco.com/cisco/software/navigator.html?mdfid=
280723930&flowid=7120
b.
Click the Cisco IPICS Release 4.5 link.
c.
Click the Download button for upgrade-ipics-4.5.2.bin.
d.
Follow the onscreen instructions to download the upgrade file to your local
drive.
e.
Copy each script to a CD or DVD. This disk is your upgrade disk.
Step 2
Access the secondary Cisco IPICS server via an SSH client or the Console
window and log in as the Linux root user.
Step 3
Put the upgrade disk in the disk drive on the secondary Cisco IPICS server and
enter these commands to copy the upgrade file to the secondary Cisco IPICS
server:
[root]#
[root]#
[root]#
[root]#
[root]#
Step 4
mount /dev/cdrom /mnt/cdrom
cd /mnt/cdrom
cp upgrade-ipics-4.5.2.bin /root
cd /root
chmod 750 upgrade-ipics-4.5.2.bin
Enter these commands on the secondary Cisco IPICS server to stop Cisco IPICS
on this server and start the upgrade program:
[root]# service ipics stop-all
[root]# ./upgrade-ipics-4.5.2.bin
Step 5
When you see a Welcome message, press Enter.
Text displays to inform you that you must read and accept the terms of the End
User License Agreement (EULA) before you can proceed.
Step 6
Take these actions
a.
Press Enter to display the EULA.
The Cisco IPICS installer displays the EULA.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-19
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
b.
Press the Spacebar to scroll through and view the EULA, then type y and
press Enter to continue with the installation.
You must accept the terms of the EULA to proceed.
Note
Step 7
To terminate the installation while the EULA is being displayed,
press Ctrl+C. The installation terminates after the installation
program displays the entire EULA.
When you are prompted to begin the installation process, type y then press Enter.
The Cisco IPICS software begins the installation process. A progress bar
indicates the percentage of the installation that has completed.
After the file installation completes, a message informs you of the status.
Step 8
(Optional) Instruct any users who are logged in to the Cisco IPICS Administration
Console, an Incident Dispatch Console, or a Cisco IPICS Mobile Client to log out
and then log in to the secondary Cisco IPICS server.
This step is required if you want these users to have continuous access while you
complete this upgrade procedure.
Step 9
Access the primary Cisco IPICS server via an SSH client or the Console window
and log in as the Linux root user.
Step 10
Enter these commands on the primary Cisco IPICS server to stop Cisco IPICS on
this server and start the upgrade program:
[root]# service ipics stop
[root]# ./upgrade-ipics-4.5.2.bin
Step 11
When you see a Welcome message, press Enter.
Text displays to inform you that you must read and accept the terms of the End
User License Agreement (EULA) before you can proceed.
Step 12
Take these actions
a.
Press Enter to display the EULA.
The Cisco IPICS installer displays the EULA.
b.
Press the Spacebar to scroll through and view the EULA, then type y and
press Enter to continue with the installation.
You must accept the terms of the EULA to proceed.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-20
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
REVIEW DRAFT—CISCO CONFIDENTIAL
Note
Step 13
To terminate the installation while the EULA is being displayed,
press Ctrl+C. The installation terminates after the installation
program displays the entire EULA.
When you are prompted to begin the installation process, type y then press Enter.
The Cisco IPICS software begins the installation process. A progress bar
indicates the percentage of the installation that has completed.
After the file installation completes, a message informs you of the status.
Step 14
Step 15
Log in to the Cisco IPICS Administration Console on the primary Cisco IPICS
server and take these actions to generate the new IDC installer:
a.
From the IDC Management drawer, click IDC Installer.
b.
From the IDC Version to Use For The IDC Installer, choose 4.5(2).
c.
Click Save.
d.
From the IDC Management drawer, click IDC Versions.
e.
Check the check box for the row that contains 4.5(2) in the Version field.
f.
From the drop-down list next to the Change State button, choose
Recommended.
g.
Click the Change State button.
If you are using the UMS or the ISSIG, install the 4.5(2) version of these
components as described in the following sections:
•
Installing the UMS Software, page 4-5
•
Installing the ISSIG Software, page 5-5
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-21
Chapter 3
Upgrading Cisco IPICS
Using the Cisco Incident Dispatch Console with Cisco IPICS 4.5
REVIEW DRAFT—CISCO CONFIDENTIAL
Using the Cisco Incident Dispatch Console with
Cisco IPICS 4.5
After you upgrade to Cisco IPICS 4.5(1), take these actions to enable Cisco IPICS
Dispatch Console users to access Cisco IPICS from their client PCs:
1.
Generate a new IDC installer as described in the “Generating the IDC
Installer” section in Cisco IPICS Server Administration Guide.
2.
(Recommended) Instruct Cisco IPICS Dispatch Console users to install the
current version of the Cisco IPICS Dispatch Console on their client PCs.
For instructions, see the “Cisco IPICS Dispatch Console Installation,
Configuration, and Maintenance” chapter in Cisco IPICS Dispatch Console
User Guide.
3.
Instruct Cisco IPICS Dispatch Console users to install the current version of
the Cisco IPICS Dispatch Console on their client PCs.
For instructions, see the “Cisco IPICS Dispatch Console Installation,
Configuration, and Maintenance” chapter in Cisco IPICS Dispatch Console
User Guide.
Upgrading the Radio Descriptor
After upgrading a 2.2(1)SR1 system to 4.5(1), you must upgrade all existing EF
Johnson radio descriptors that have control functions defined by performing the
following steps:
Procedure
Step 1
Open the EF Johnson descriptor in an editor and locate the block for control
functions. The block is bounded by the following tags:
<ControlFunctions>…</ControlFunctions>
Step 2
Make a note of the control functions that are in the list and then delete the block.
Step 3
Copy and paste the following control functions block into the descriptor.
<ControlFunctions>
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-22
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
REVIEW DRAFT—CISCO CONFIDENTIAL
<Stateful shortName="MON" longName="Monitor" description="Set Monito
r Mode" presentation="multiple">
<State shortName="ON" longName="ON" description="Monitor mode is o
n" user_selectable="true">
<Action type="pressed">
<Command>
<SetMonitorMode value="ON" />
</Command>
</Action>
</State>
<State shortName="OFF" longName="OFF" description="Monitor mode is
off" user_selectable="true">
<Action type="pressed">
<Command>
<SetMonitorMode value="OFF" />
</Command>
</Action>
</State>
<State shortName="UNKWN" longName="UNKNOWN" description="Monitor m
ode is in an unknown state" user_selectable="false">
<Action type="pressed">
<Command>
<SetMonitorMode value="UNKNOWN" />
</Command>
</Action>
</State>
<State shortName="UNSPRT" longName="UNSUPPORTED" description="Moni
tor mode is not supported" user_selectable="false">
<Action type="pressed">
<Command>
<SetMonitorMode value="UNSUPPORTED" />
</Command>
</Action>
</State>
</Stateful>
<Stateful shortName="RTA" longName="Repeater/Talkaround" description
="Select Between Repeater and Talkaround Transmit Modes" presentation=
"multiple">
<State shortName="RPTR" longName="REPEATER" description="Transmit
mode is set to REPEATER" user_selectable="true">
<Action type="pressed">
<Command>
<SetRepeaterTaMode value="REPEATER" />
</Command>
</Action>
</State>
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-23
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
REVIEW DRAFT—CISCO CONFIDENTIAL
<State shortName="TA" longName="TALKAROUND" description="Transmit
mode is set to TALKAROUND" user_selectable="true">
<Action type="pressed">
<Command>
<SetRepeaterTaMode value="TALKAROUND" />
</Command>
</Action>
</State>
<State shortName="UNKWN" longName="UNKNOWN" description="Repeater/
Talkaround mode is in an unknown state" user_selectable="false">
<Action type="pressed">
<Command>
<SetRepeaterTaMode value="UNKNOWN" />
</Command>
</Action>
</State>
<State shortName="UNSPRT" longName="UNSUPPORTED" description="Repe
ater/TA mode selection is not supported" user_selectable="false">
<Action type="pressed">
<Command>
<SetRepeaterTaMode value="UNSUPPORTED" />
</Command>
</Action>
</State>
</Stateful>
<Stateful shortName="SCN" longName="Scan" description="Set Scan Mode
" presentation="multiple">
<Stateful shortName="ON" longName="ON" description="Scan is on" us
er_selectable="true">
<Action type="pressed">
<Command>
<SetScanMode value="ON" />
</Command>
</Action>
</State>
<Stateful shortName="OFF" longName="OFF" description="Scan is off"
user_selectable="true">
<Action type="pressed">
<Command>
<SetScanMode value="OFF" />
</Command>
</Action>
</State>
<Stateful shortName="UNKWN" longName="UNKNOWN" description="Scan i
s in an unknown state" user_selectable="false">
<Action type="pressed">
<Command>
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-24
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
REVIEW DRAFT—CISCO CONFIDENTIAL
<SetScanMode value="UNKNOWN" />
</Command>
</Action>
</State>
<Stateful shortName="UNSPRT" longName="UNSUPPORTED" description="S
can is not supported" user_selectable="false">
<Action type="pressed">
<Command>
<SetScanMode value="UNSUPPORTED" />
</Command>
</Action>
</State>
</Stateful>
<Stateful shortName="SEC" longName="Secure Tx Mode" description="Sel
ect Between Secure and Clear Transmit Modes" presentation="multiple">
<Stateful shortName="SEC" longName="SECURE" description="Secure tr
ansmit mode is set to SECURE" user_selectable="true">
<Action type="pressed">
<Command>
<SetSecureTxMode value="SECURE" />
</Command>
</Action>
</State>
<Stateful shortName="CLR" longName="CLEAR" description="Secure tra
nsmit mode is set to CLEAR" user_selectable="true">
<Action type="pressed">
<Command>
<SetSecureTxMode value="CLEAR" />
</Command>
</Action>
</State>
<Stateful shortName="KEYFL" longName="KEYFAIL" description="Keyfai
l. Key required for encryption is not present" user_selectable="false"
>
<Action type="pressed">
<Command>
<SetSecureTxMode value="KEYFAIL" />
</Command>
</Action>
</State>
<Stateful shortName="NOENC" longName="NO_ENCRYPT" description="No
encryption module present" user_selectable="false">
<Action type="pressed">
<Command>
<SetSecureTxMode value="NO_ENCRYPT" />
</Command>
</Action>
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-25
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
REVIEW DRAFT—CISCO CONFIDENTIAL
</State>
<Stateful shortName="MSMTCH" longName="MISMATCH" description="Mism
atch between user selected secure transmit mode and actual fixed/strap
ped tx mode" user_selectable="false">
<Action type="pressed">
<Command>
<SetSecureTxMode value="MISMATCH" />
</Command>
</Action>
</State>
<Stateful shortName="UNKWN" longName="UNKNOWN" description="Secure
/Clear Transmit mode is in an unknown state" user_selectable="false">
<Action type="pressed">
<Command>
<SetSecureTxMode value="UNKNOWN" />
</Command>
</Action>
</State>
<Stateful shortName="UNSPRT" longName="UNSUPPORTED" description="E
ncryption is not supported" user_selectable="false">
<Action type="pressed">
<Command>
<SetSecureTxMode value="UNSUPPORTED" />
</Command>
</Action>
</State>
</Stateful>
<Stateful shortName="PWR" longName="Transmit Power Mode" description
="Change the transmit power level" presentation="multiple">
<Stateful shortName="HIGH" longName="HIGH" description="Transmit p
ower mode is set to HIGH" user_selectable="true">
<Action type="pressed">
<Command>
<SetTxPowerMode value="HIGH" />
</Command>
</Action>
</State>
<Stateful shortName="LOW" longName="LOW" description="Transmit pow
er mode is set to LOW" user_selectable="true">
<Action type="pressed">
<Command>
<SetTxPowerMode value="LOW" />
</Command>
</Action>
</State>
<Stateful shortName="UNKWN" longName="UNKNOWN" description="Transm
it power mode is in an unknown state" user_selectable="false">
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-26
OL-28054-01
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
REVIEW DRAFT—CISCO CONFIDENTIAL
<Action type="pressed">
<Command>
<SetTxPowerMode value="UNKNOWN" />
</Command>
</Action>
</State>
<Stateful shortName="UNSPRT" longName="UNSUPPORTED" description="T
ransmit power mode selection is not supported" user_selectable="false"
>
<Action type="pressed">
<Command>
<SetTxPowerMode value="UNSUPPORTED" />
</Command>
</Action>
</State>
</Stateful>
<Stateful shortName="EMG" longName="Emergency" description="Enable/D
isable Emergency Mode" presentation="multiple">
<Stateful shortName="ON" longName="ON" description="Emergency mode
is on" user_selectable="true">
<Action type="pressed">
<Command>
<SetEmergencyMode value="ON" />
</Command>
</Action>
</State>
<Stateful shortName="OFF" longName="OFF" description="Emergency mo
de is off" user_selectable="true">
<Action type="pressed">
<Command>
<SetEmergencyMode value="OFF" />
</Command>
</Action>
</State>
<Stateful shortName="UNKWN" longName="UNKNOWN" description="Emerge
ncy mode is in an unknown state" user_selectable="false">
<Action type="pressed">
<Command>
<SetEmergencyMode value="UNKNOWN" />
</Command>
</Action>
</State>
<Stateful shortName="UNSPRT" longName="UNSUPPORTED" description="E
mergency mode is not supported" user_selectable="false">
<Action type="pressed">
<Command>
<SetEmergencyMode value="UNSUPPORTED" />
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
3-27
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
REVIEW DRAFT—CISCO CONFIDENTIAL
</Command>
</Action>
</State>
</Stateful>
</ControlFunctions>
Step 4
Each control function is bounded by a <Stateful>…</Stateful> block. Refer to
the original list of control functions to determine which functions are not needed,
and then remove them from the newly pasted control functions block.
Step 5
Save the descriptor file.
Step 6
In the IPICS Server console, choose Configuration > Descriptors.
Step 7
Choose the modified descriptor and click Update.
Step 8
Choose the descriptor type and click Browse to locate and upload the file.
Step 9
Click Save.
Step 10
To ensure that all affected radios are updated with the new descriptor information,
disable and then enable each radio, or restart the RCS service on the server.
To restart the service, Access the Cisco IPICS server via an SSH client and log in
as the Linux root user, then enter the following command:
[root]# service ipics_rcs restart
Wait a few minutes before attempting to control any radio.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
3-28
OL-28054-01