CH A P T E R
3
Upgrading Cisco IPICS
If your Cisco IPICS server is running release 2.0(2) or 2.0(2) SR1, you can
upgrade your server to release 2.1(1) by using a Cisco-provided CD-ROM. If you
are not sure about how to obtain the software for Cisco IPICS release 2.1(1),
contact your Cisco representative for information.
Tip
To verify which versions of Cisco IPICS are compatible for upgrade, refer to the
most recent version of the Cisco IPICS Compatibility Matrix at
http://www.cisco.com/en/US/products/ps7026/
tsd_products_support_series_home.html
This chapter contains information about upgrading your software to Cisco IPICS
release 2.1(1) and other actions that you must take to fully complete this upgrade
process and includes the following sections:
•
Before You Begin, page 3-1
•
Performing a Direct Cisco IPICS Server Software Upgrade, page 3-2
•
Performing a Remote Cisco IPICS Server Software Upgrade, page 3-5
Before You Begin
Be aware of the following caveats, and perform one or more of the following
suggested actions, before you upgrade your server software:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-1
Chapter 3
Upgrading Cisco IPICS
Performing a Direct Cisco IPICS Server Software Upgrade
•
Cisco recommends that you back up the database to a remote host. If you
encounter problems during the upgrade, you can reinstall the Cisco IPICS
release 2.0(2) server software and restore your database from the remote
backup to return your system to its previous state. For information about
backing up and restoring the Cisco IPICS database, refer to the “Performing
Cisco IPICS Backup and Restore Operations” chapter of the Cisco IPICS
Server Administration Guide, Release 2.1(1).
•
You can set up a new version of the latest, supported PMC so that the PMC
download process is staged. Staging the PMC download alleviates the burden
of long PMC downloads to all users at one time. For more information about
this feature, refer to the “Installing a New PMC Version Before You Upgrade
Your Cisco IPICS Server” section in the “Performing Cisco IPICS System
Administrator Tasks” chapter in the Cisco IPICS Server Administration
Guide, Release 2.1(1).
•
Cisco IPICS retains existing attributes for channels, VTGs, and users during
an upgrade. Note, however, that the default setting for the Allow Latch
attribute is set to disabled (unchecked) when you create new channels or
VTGs in release 2.1(1). For more information about the Allow Latch
attribute, refer to the “Performing Cisco IPICS System Administrator Tasks”
chapter in the Cisco IPICS Server Administration Guide, Release 2.1(1).
Performing a Direct Cisco IPICS Server Software
Upgrade
If you have physical access to the Cisco IPICS server, you can upgrade the server
software directly from the server. To do so, you must have the Cisco IPICS release
2.1(1) installation CD that is included with your product package.
Be aware that you must log in as the root user to perform the Cisco IPICS upgrade.
If you attempt to run the upgrade from any other user ID, the upgrade program
returns an error and exits.
Note
To terminate the upgrade process at any point in time, press Ctrl+C.
To upgrade the Cisco IPICS server software directly, perform the following
procedure:
Cisco IPICS Server Installation and Upgrade Guide
3-2
OL-12985-01
Chapter 3
Upgrading Cisco IPICS
Performing a Direct Cisco IPICS Server Software Upgrade
Procedure
Step 1
Enter root in the hostname login: field in the terminal console; then, press Enter.
Cisco IPICS prompts you for the password for the root user.
Step 2
Enter the password that you created for the root user in Step 16 in the “Installing
the Cisco IPICS Operating System” section on page 2-6; then, press Enter.
The Cisco IPICS operating system logs you in as the root user.
Step 3
Mount the contents of the CD onto the server by entering the following command:
[root]# mount /mnt/cdrom
Note
Step 4
During the installation process, error messages, such as
cdrom_decode_error, may display when you access the CD. You can
ignore these messages, as they do not affect the installation or operation
of the Cisco IPICS server.
To navigate to the CD location, enter the following command:
[root]# cd /mnt/cdrom
Step 5
To view the installer file, enter the following command:
[root]# ls -l
The directory of the CD displays.
Step 6
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
Step 7
To start the upgrade, enter the following command:
[root]# bash <upgradefilename>.run
where:
<upgradefilename>.run specifies the name of the installer file that you located in
Step 6.
Cisco IPICS begins the installation program and prompts you to overwrite or
upgrade the current server software.
Step 8
Enter 2 to upgrade the server software from the following choices:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-3
Chapter 3
Upgrading Cisco IPICS
Performing a Direct Cisco IPICS Server Software Upgrade
•
1) Install—This option overwrites your previous version of Cisco IPICS;
therefore, you will lose all your configuration and user data from the current
version that is installed on your server.
•
2) Upgrade—This option allows you to upgrade your current version to
release 2.1(1).
•
3) Quit—This option cancels the installation program.
Note
Be aware that the options that the installer displays may differ depending
on the current software version that is running on your system.
The Cisco IPICS installer displays the End User License Agreement.
Step 9
Press the Spacebar to scroll through and view the entire agreement. If you accept
the terms of the license agreement, enter y or yes to continue with the upgrade.
You must accept the terms of the agreement to proceed with the upgrade.
The upgrade program prompts you to enter a password for the ipics user. The ipics
user is the application-level user ID that can perform all administration-related
tasks by using the Cisco IPICS Administration Console.
Step 10
Enter a password for the ipics user in the password field.
To ensure a strong password, use a password that is at least eight characters long
and contains at least one of each of the following characters:
•
One lower case letter
•
One upper case letter
•
One number
•
One of the following special characters:
@[]^_`!"#$%&'()*+,-./:;{<|=}>~?
Step 11
Reenter the password.
The upgrade program prompts you to change the password for the Cisco IPICS
ipicsadmin (administrative) user. The ipicsadmin user has permissions to
Cisco IPICS system-level folders, files, and scripts that are related to database
backup and restore operations.
Step 12
Enter a strong password in the password field to change the ipicsadmin user
password.
Cisco IPICS Server Installation and Upgrade Guide
3-4
OL-12985-01
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
Follow the password guidelines that are documented in Step 10.
Step 13
To continue with the upgrade, enter y or yes.
The Cisco IPICS software begins the upgrade process.
A progress bar displays and shows you the percentage of the upgrade that has been
completed.
After the upgrade completes, a message displays to inform you that the upgrade
has successfully completed.
Step 14
Enter y or yes to reboot your computer.
The system reboots and your Cisco IPICS server becomes available for your use.
Note
If you choose the Restart Later option, complete the restart before you
attempt to log in to Cisco IPICS. Cisco IPICS processes, such as the
tomcat service and database server, do not start until you reboot the
server.
Performing a Remote Cisco IPICS Server Software
Upgrade
This section describes the procedure that you follow to upgrade the Cisco IPICS
server software from a PC or other device that is remotely connected to the
network.
To upgrade the Cisco IPICS server software from a remote location, perform the
following procedure:
Procedure
Step 1
Transfer the installer file from the Cisco IPICS installation CD to the Cisco IPICS
server by performing one of the following tasks:
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-5
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
Step 2
•
Place the CD (or have someone place it for you) in the Cisco IPICS server and
copy the installer file to the server. Follow the steps that are documented in
Step 2 to perform this procedure.
•
Place the CD in a PC and transfer the installer file to the Cisco IPICS server
by using an FTP client software program, such as SSH Secure Shell Client
software (or similar software). Follow the steps that are documented in Step 3
to perform this procedure.
To copy the installer file from the CD, perform the following steps:
a.
Insert the Cisco IPICS installation CD in the server disk drive.
b.
Choose Start > Programs > SSH Secure Shell > Secure Shell Client to
remotely connect to the Cisco IPICS server.
Note
The SSH idle timeout value is 120 minutes (two hours). Therefore, make
sure that you do not leave an SSH remotely-connected session inactive for
more than two hours; otherwise, the session times out.
Tip
If you do not have Secure Shell Client installed on your PC, use another
secure client program.
c.
Click Quick Connect to connect to the Cisco IPICS server.
The Connect to Remote Host window displays.
d.
In the Host field, enter the DNS host name or the IP address for your
Cisco IPICS server; then, press the Tab key.
e.
In the User Name field, enter root.
f.
Click Connect.
The Enter Password window displays.
g.
Enter the password for the root user and click OK.
The SSH Secure Shell Client software window displays.
h.
Mount the contents of the CD onto the server by entering the following
command:
[root]# mount /mnt/cdrom
Cisco IPICS Server Installation and Upgrade Guide
3-6
OL-12985-01
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
i.
Navigate to the cdrom subfolder in the CD location by entering the following
command:
[root]# cd /mnt/cdrom
j.
To view the installer file, enter the following command:
[root]# ls -l
The directory of the CD displays.
k.
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
l.
Copy the installer file to the /root directory by entering the following
command:
[root]# cp /mnt/cdrom/<installerfilename>.run /root
where:
<installerfilename>.run represents the name of the .run file that was
displayed in Step j.
The installer file copies from the CD to the /root directory.
m.
Navigate from the /mnt/cdrom directory to an internal directory on your
server by entering the following command:
[root]# cd <serverdirectory>
where:
<serverdirectory> is an internal directory or subdirectory on your server.
n.
To unmount the installation CD and eject it from the disk drive, enter the
following command:
[root]# eject
Note
o.
You must navigate away from the /mnt/cdrom directory and enter the
eject command to unmount the contents of the CD and eject the CD from
the server. If you try to eject the CD by pushing the eject button on the
server, the CD will not eject.
To continue with the upgrade, proceed to Step 4.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-7
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
Step 3
To transfer the file to the server from a remote location, follow these steps:
a.
Insert the Cisco IPICS installation CD in the CD drive of your PC.
b.
Choose Start > Programs > SSH Secure Shell > Secure File Transfer
Client to open the Secure File Transfer Client.
Note
If you do not have Secure File Transfer Client installed on your PC, use
another program that permits a secure file transfer session between your
PC and the server.
The SSH Secure Shell File Transfer Client window displays. The desktop of
your PC displays in the left pane.
c.
Click Quick Connect to connect to the Cisco IPICS server.
The Connect to Remote Host window displays.
d.
In the Host field, enter the DNS host name or the IP address for your
Cisco IPICS server. Then, press the Tab key.
e.
In the User Name field, enter root.
f.
Click Connect.
The Enter Password window displays.
g.
Enter the password for the root user and click OK.
The SSH Secure Shell File Transfer Client connects to the Cisco IPICS server
and displays the contents of the /root directory in the right pane of the
window.
h.
In the left pane of the window, navigate to the folder on your PC that
corresponds to the location of the Cisco IPICS installation CD (for example,
My Computer\Compact Disk Z:).
i.
Double-click the CD folder to browse the contents of the CD.
The contents of the CD displays.
j.
Double-click the cdrom subfolder to browse its contents.
k.
Locate the installer file in the cdrom subfolder on the CD.
The installer file has an extension of .run.
l.
Drag the installer file from the left pane of the window to the right pane to
initiate the copy procedure.
Cisco IPICS Server Installation and Upgrade Guide
3-8
OL-12985-01
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
A progress window displays while the file copies to the /root directory of the
server. After the copy procedure completes, the installer file displays in the
right pane.
m.
Close the SSH Secure Shell File Transfer Client.
Step 4
Open a terminal window to the Cisco IPICS server by using SSH Secure Shell
Client software or similar software.
Step 5
In the User Name field, enter root.
Step 6
Click Connect.
The Enter Password window displays.
Step 7
Enter the password for the root user and click OK.
The SSH Secure Shell Client software window displays.
Step 8
To view the installer file, enter the following command:
[root]# ls -l
The contents of the /root directory display.
Step 9
Locate the installer file in the directory listing.
The Cisco IPICS installer file has a .run file extension.
Step 10
Change the access mode of the installer file by entering the following command:
[root]# chmod 550 <installerfilename>.run
where:
<installerfilename>.run represents the name of the installer file.
Note
Step 11
Entering this command allows the root user ID to read and run the
installer file.
Run the installer from a SSH Secure Shell Client software (or similar software)
window by following the procedure as described in the “Performing a Direct
Cisco IPICS Server Software Upgrade” section, starting with Step 7.
Cisco IPICS Server Installation and Upgrade Guide
OL-12985-01
3-9
Chapter 3
Upgrading Cisco IPICS
Performing a Remote Cisco IPICS Server Software Upgrade
Cisco IPICS Server Installation and Upgrade Guide
3-10
OL-12985-01