CH A P T E R
3
Upgrading Cisco IPICS
If your Cisco IPICS server is running release 2.2(1)SR1 or release 4.0(1), you can
upgrade your server to release 4.0(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.0(2) 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-2
•
Extracting the IDC 4.0(2) Package and Setting it to the Download Version,
page 3-7
•
Upgrading the Radio Descriptor, page 3-8
Cisco IPICS Server Installation and Upgrade Guide
OL-23831-02
3-1
Chapter 3
Upgrading Cisco IPICS
Before You Begin
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, that the default setting for the Allow Latch attribute is
set to disabled (unchecked) when you create new channels or VTGs in release
4.0(2). For more information about the Allow Latch attribute, refer to the
“Performing Cisco IPICS System Administrator Tasks” chapter in
Cisco IPICS Server Administration Guide.
Performing a Cisco IPICS Server Software Upgrade
The following sections describe how to upgrade the Cisco IPICS server software
to release 4.0(2):
•
Upgrading from Cisco IPICS Release 2.2(1)SR1, page 3-3
•
Upgrading from Cisco IPICS Release 4.0(1), page 3-6
Cisco IPICS Server Installation and Upgrade Guide
3-2
OL-23831-02
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
Upgrading from Cisco IPICS Release 2.2(1)SR1
If you are upgrading from Cisco IPICS release 2.2(1)SR1, you must download the
the appropriate operating system and the Cisco IPICS software from Cisco.com
and create and create an operating system disk and an installation disk. You also
must download the upgrade script and copy it to a disk.
Be aware that you must log in as the root user to perform the Cisco IPICS upgrade.
If you attempt to run the upgrade from any other user ID, the upgrade program
returns an error and exits.
Note
To terminate the upgrade process at any point in time, press Ctrl+C.
To upgrade from Cisco IPICS release 2.2(1)SR1 to Cisco IPICS release 4.0(2),
perform the following procedure:
Procedure
Step 1
From a client PC, take these actions to obtain the upgrade script and create an
upgrade script disk (you must have a valid Cisco.com user ID and password
before you can access this URL.):
a.
Go to this URL:
http://www.cisco.com/cisco/software/release.html?mdfid=282977238&
flowid=7120&softwareid=282704403&release=4.0.1&rellifecycle=&
relind=AVAILABLE&reltype=all
b.
Click the 4.0.1 link under All Releases > 4.
c.
Click Download Now next to pre_ipics_db_upgrade_22_40.
Follow the onscreen instructions to download the upgrade script to your local
drive.
d.
Copy the file to a CD or DVD. This disk is your upgrade script disk.
Cisco IPICS Server Installation and Upgrade Guide
OL-23831-02
3-3
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
Step 2
On the Cisco IPICS server, 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
You can view the contents of the upgrade script disk by entering the following
command:
[root]# ls -ltr /mnt/cdrom
Step 3
Copy the script pre_ipics_db_upgrade_22_40 on the upgrade script disk to the
release 2.2(1)SR1 server under /root.
Step 4
Back up the release 2.2(1)SR1 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, and 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 has sufficient space for the database.
[root]# ./pre_ipics_db_upgrade_22_40 remotedirectory remote-host-IP
root ‘root-password’
For example, enter the following command, where rootpwd is the root password
of the server (make sure to include the single quotes [‘]):
[root]# ./pre_ipics_db_upgrade_22_40 /root 10.3.2.1 root ‘rootpwd’
The output is saved to the file dbspaces_ipics22.tgz.
Note
Step 5
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.0(2), the file from the special backup created in release
2.2(1)SR1 (dbspaces_ipics22.tgz) is required to replicate your database in
release 4.0(2).
Install the Cisco IPICS 4.0 operating system as described in the “Installing the
Cisco IPICS Operating System” section on page 2-6.
Cisco IPICS Server Installation and Upgrade Guide
3-4
OL-23831-02
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
Step 6
Install Cisco IPICS 4.0(2) software as described in the “Installing the Cisco IPICS
Server Software” section on page 2-16.
Step 7
Take these actions to restore the Cisco IPICS database that you backed up earlier
in this procedure:
Note
a.
This process may take up to 30 minutes. Make sure that you allow time
for the process to complete.
Enter this command:
[root]# cd /opt/cisco/ipics/database/bin
b.
Enter this command, where remote-directory is directory in which you
backed up the database in Step 4, remote-host-IP is the IP address of the
remote server to which you backed up the database, and root-password is the
root password of that server
[root]# ./ipics_db_upgrade_22_402 /remote-directory remote-host-IP root
‘root password’
Sample output:
[root]# ./ipics_db_upgrade_22_402 /root 10.3.2.1 root ‘rootpwd’
INFO
: IPICS database upgrade process started at Wed Oct 13
15:52:18 GMT 2010
INFO
: Progress log is saved in
/tmp/ipics_db_upgrade_22_402.log
INFO
: Remote copying IPICS 2.2 archive file from
[email protected]:/root/dbspaces_ipics22.tgz
INFO
:
...done
INFO
INFO
INFO
INFO
: Stopping IPICS application service
:
...done
: Stopping IPICS database service
:
...done
INFO
: Extracting IPICS 2.2 database files (may take 30 minutes
or longer)
INFO
: Restoring IPICS 2.2 licenses
INFO
:
IPICS 2.2 ipics license(s) copied to
/opt/cisco/ipics/tomcat/current/webapps/license
INFO
: Starting IPICS using v2.2 database files
Cisco IPICS Server Installation and Upgrade Guide
OL-23831-02
3-5
Chapter 3
Upgrading Cisco IPICS
Performing a Cisco IPICS Server Software Upgrade
INFO
:
...done
INFO
: Converting database server configuration to IPICS 4.0.2
format (may take a few minutes)
INFO
:
...done
INFO
: Converting database "db_cra" to IPICS 4.0.2 format (may
take a few minutes)
INFO
:
...done
INFO
: Converting database "ipics" to IPICS 4.0.2 format (may
take a few minutes)
INFO
:
...done
INFO
: Update IPICS database version number...
INFO
: Resetting trust settings...
INFO
:
...done
INFO
: Restarting IPICS services... (may take a few minutes)
INFO
: IPICS database upgrade process completed at Wed Oct 13
16:10:56 GMT 2010
Step 8
After the database has been restored and the server has initialized, log in to the
IPICS application as system administrator using a web browser:
http://serveripaddress
The license upgrade page opens.
Step 9
Browse, find, and upload the IPICS 4.0 Upgrade license provided by Cisco.
Upgrading from Cisco IPICS Release 4.0(1)
To upgrade from Cisco IPICS release 4.0(1) to Cisco IPICS release 4.0(2), install
Cisco IPICS 4.0(2) software as described in the “Installing the Cisco IPICS
Server Software” section on page 2-16.
After you perform that procedure, the upgrade process is complete and you can
launch Cisco IPICS.
Cisco IPICS Server Installation and Upgrade Guide
3-6
OL-23831-02
Chapter 3
Upgrading Cisco IPICS
Extracting the IDC 4.0(2) Package and Setting it to the Download Version
Extracting the IDC 4.0(2) Package and Setting it to the
Download Version
After you upgrade to Cisco IDC 4.0(2), you must extract the Cisco IDC 4.0(2)
package and set it to the download version by performing the following steps:
Procedure
Step 1
Enter the following command:
[root]# ./install-ipics-4.0.2.run -- -i idc
Sample output:
Disk space Ok.
Verifying package integrity... All good.
Uncompressing The Cisco IPICS
Installer.............................................................
......................................................................
.......................
Checking your server Operating System version...Ok.
This command uploads the new IDC version to the Cisco IPICS server.
The Cisco IPICS server must restart to complete this operation.
The installer will automatically restart the server if you
respond Yes, when prompted.
Note: Be aware that a restart automatically logs all users out of
Cisco IPICS.
Step 2
When you see the following prompt, type Yes and press Enter:
Do you want to upload the new IDC version now? (yes/no): [?]
Sample output:
The installer is extracting the idc.zip file...
The installer is verifying upgrade-idc-4.0(1.014).zip...
The upgrade-idc-4.0(1.014).zip file was extracted successfully.
restarting ipics_tomcat...
Cisco IPICS Server Installation and Upgrade Guide
OL-23831-02
3-7
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
The ipics_tomcat service was restarted successfully.
The Cisco IPICS installer completed successfully.
restarting ipics_tomcat...
The ipics_tomcat service was restarted successfully.
The Cisco IPICS installer completed successfully.
Step 3
Log in to the Cisco IPICS server and take these actions:
a.
From the Server drawer, choose IDC Management > IDC Versions.
b.
Check the check box on the line for the 4.0(2) IDC version.
c.
From the drop-down list at the bottom of the IDC Management page, choose
Recommended.
d.
Click the Change State button.
e.
Make sure that all other IDC versions in the IDC Management page are set to
Mandatory.
f.
Choose IDC Management > IDC Installer.
g.
From the IDC Version To Use For The IDC Installer drop-down list, choose
the 4.0(2) version.
h.
Click the Save button.
Upgrading the Radio Descriptor
After upgrading a 2.2(1)SR1 system to 4.0(2), 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>
Cisco IPICS Server Installation and Upgrade Guide
3-8
OL-23831-02
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
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>
<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" />
Cisco IPICS Server Installation and Upgrade Guide
OL-23831-02
3-9
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
</Command>
</Action>
</State>
<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>
Cisco IPICS Server Installation and Upgrade Guide
3-10
OL-23831-02
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
<Stateful shortName="UNKWN" longName="UNKNOWN" description="Scan i
s in an unknown state" user_selectable="false">
<Action type="pressed">
<Command>
<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">
Cisco IPICS Server Installation and Upgrade Guide
OL-23831-02
3-11
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
<Command>
<SetSecureTxMode value="NO_ENCRYPT" />
</Command>
</Action>
</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>
Cisco IPICS Server Installation and Upgrade Guide
3-12
OL-23831-02
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
</Action>
</State>
<Stateful shortName="UNKWN" longName="UNKNOWN" description="Transm
it power mode is in an unknown state" user_selectable="false">
<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>
Cisco IPICS Server Installation and Upgrade Guide
OL-23831-02
3-13
Chapter 3
Upgrading Cisco IPICS
Upgrading the Radio Descriptor
<Stateful shortName="UNSPRT" longName="UNSUPPORTED" description="E
mergency mode is not supported" user_selectable="false">
<Action type="pressed">
<Command>
<SetEmergencyMode value="UNSUPPORTED" />
</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, use SSH to access the IPICS server as root, and then enter
the following command:
[root]# service ipics_rcs restart
Wait a few minutes before attempting to control any radio.
Cisco IPICS Server Installation and Upgrade Guide
3-14
OL-23831-02