REVIEW DRAFT—CISCO CONFIDENTIAL
CH A P T E R
6
Uninstalling or Rolling Back the
Cisco IPICS Server Software
This chapter provides information about the procedures for uninstalling or
following back the Cisco IPICS server software.
You can perform the uninstallation procedure in one of the following ways:
Note
•
From the Cisco IPICS server by using a terminal console
•
From a remote PC on the network by using SSH software
•
The Cisco IPICS uninstallation procedure removes all of the components and
directories that were created during the Cisco IPICS installation. If you
intend to reinstall Cisco IPICS at a later time, Cisco recommends that you
back up your database and log files before you begin the uninstallation
process.
•
For information about backing up files, see the “Performing Cisco IPICS
Backup and Restore Operations” chapter in Cisco IPICS Server
Administration Guide.
•
Be aware that when you uninstall and reinstall the Cisco IPICS software,
communications are temporarily disrupted. Upon reinstallation, Cisco IPICS
disconnects VTGs and SIP-based IDC clients that were using RMS resources
so that the voice ports become available for use.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
6-1
Chapter 6 Uninstalling or Rolling Back the Cisco IPICS Server Software
Uninstalling the Cisco IPICS Server Software from the Server
REVIEW DRAFT—CISCO CONFIDENTIAL
This chapter includes the following sections:
•
Uninstalling the Cisco IPICS Server Software from the Server, page 6-2
•
Uninstalling the Cisco IPICS Server Software Remotely, page 6-3
•
Rolling Back the Cisco IPICS Software from Release 4.5(2) to 4.5(1),
page 6-5
Uninstalling the Cisco IPICS Server Software from
the Server
To uninstall the Cisco IPICS software directly from the Cisco IPICS server,
perform the following procedure:
Procedure
Step 1
Access the Cisco IPICS server by using a terminal console.
Cisco IPICS displays the following text:
Cisco IPICS
hostname login:
where:
hostname specifies the host name of the Cisco IPICS server.
Step 2
Enter root in the hostname login: field; then, press Enter.
Cisco IPICS prompts you for the password for the root user.
Step 3
Enter the password for the root user; then, press Enter.
Step 4
To navigate to the directory where the uninstaller file is located, enter the
following command:
[root]# cd /root/_uninstall_IPICS/
Step 5
To begin the uninstallation process, enter the following command:
[root]# bash uninstall-ipics
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
6-2
OL-28054-01
Chapter 6
Uninstalling or Rolling Back the Cisco IPICS Server Software
Uninstalling the Cisco IPICS Server Software Remotely
REVIEW DRAFT—CISCO CONFIDENTIAL
The uninstallation program prompts you to confirm the uninstallation process by
displaying the following text:
Do you want to remove Cisco IPICS software? (YES/NO):
Step 6
To confirm the uninstallation process, enter y or yes.
Cisco IPICS begins the uninstallation process.
Note
Be aware that the Cisco IPICS uninstallation process permanently
removes the Cisco IPICS software and deletes any Cisco IPICS
configuration data that you have stored in the server. If you need to save
your data, Cisco recommends that you first back up your data to a remote
host before you uninstall the software. For more information about
backing up your data, refer to the “Performing Cisco IPICS Backup and
Restore Operations” chapter in Cisco IPICS Server Administration
Guide.
After you have preserved a copy of your data, you can restart the
uninstallation process.
The uninstaller begins to uninstall the Cisco IPICS components.
After the uninstaller removes the files, a message prompts you to reboot the
server.
Step 7
To reboot the system, enter y or yes.
After the system reboots, the Cisco IPICS server software is removed.
Uninstalling the Cisco IPICS Server Software
Remotely
To uninstall the Cisco IPICS server software from a PC on the network, perform
the following procedure:
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
6-3
Chapter 6
Uninstalling the Cisco IPICS Server Software Remotely
Uninstalling or Rolling Back the Cisco IPICS Server Software
REVIEW DRAFT—CISCO CONFIDENTIAL
Procedure
Step 1
Access the Cisco IPICS server via an SSH client and log in as the Linux root user.
Step 2
To change directories, enter the following command:
[root]# cd /root/_uninstall_IPICS/
Step 3
To begin the uninstallation process, enter the following command:
[root]# bash uninstall-ipics
The uninstallation program prompts you to confirm the uninstallation process by
displaying the following text:
Do you want to remove Cisco IPICS software? (YES/NO):
Step 4
To continue the uninstallation program, enter y or yes.
Cisco IPICS begins the uninstallation process.
Caution
Be aware that the Cisco IPICS uninstallation process permanently removes the
Cisco IPICS software and deletes any Cisco IPICS configuration data that you
have stored in the server. If you need to save your data, Cisco recommends that
you first back up your data to a remote host before you uninstall the software. For
more information about backing up your data, refer to the “Performing
Cisco IPICS Backup and Restore Operations” chapter in Cisco IPICS Server
Administration Guide.
After you have preserved a copy of your data, you can restart the uninstallation
process.
The uninstaller begins to uninstall the Cisco IPICS components.
After the uninstaller removes the files, a message prompts you to reboot the
server.
Step 5
Enter y or yes to reboot the system.
After the system reboots, the Cisco IPICS server software is removed.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
6-4
OL-28054-01
Chapter 6
Uninstalling or Rolling Back the Cisco IPICS Server Software
Rolling Back the Cisco IPICS Software from Release 4.5(2) to 4.5(1)
REVIEW DRAFT—CISCO CONFIDENTIAL
Rolling Back the Cisco IPICS Software from Release
4.5(2) to 4.5(1)
This section explains how to roll back the Cisco IPICS Server software from
release 4.5(2) to release 4.5(1).
To rollback the UMS software from release 4.5(2) to release 4.5(1), install the
4.5(1) version of the UMS software as described in the “Installing the UMS
Software” section on page 4-5. This procedure automatically uninstalls the 4.5(2)
version of the software.
To rollback the ISSIG software from release 4.5(2) to release 4.5(1), install the
4.5(1) version of the UMS software as described in the “Installing the ISSIG
Software” section on page 5-5. This procedure automatically uninstalls the 4.5(2)
version of the software.
To roll back the Cisco IPICS Server software from release 4.5(2) to release 4.5(1),
perform the following procedure.
Before You Begin
Make sure that you have a current backup of your Cisco IPICS data.
Procedure
Step 1
Take either of these actions:
•
In a deployment without high availability, access the primary Cisco IPICS
server via an SSH client or the Console window and log in as the Linux root
user.
•
In a deployment with high availability, access the secondary Cisco IPICS
server via an SSH client or the Console window and log in as the Linux root
user.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
6-5
Chapter 6 Uninstalling or Rolling Back the Cisco IPICS Server Software
Rolling Back the Cisco IPICS Software from Release 4.5(2) to 4.5(1)
REVIEW DRAFT—CISCO CONFIDENTIAL
Step 2
Enter these commands:
[root]# cd /root/_uninstall_patch
[root]# cd ./rollback-4.5.2
Step 3
When you are prompted to begin the rollback process, type y then press Enter.
The rollback is complete when you see the following message:
Rollback completed date and time.
The Cisco IPICS server may take a few minutes to fully initialize.
Please allow some time before accessing the Cisco IPICS Administration
Console.
Step 4
In a deployment with high availability, take these actions:
a.
Log in to the Cisco IPICS Administration Console on the primary Cisco
IPICS server.
b.
From the Configuration drawer, click High Availability.
c.
Click the Failover Now button.
d.
Access the primary Cisco IPICS server via an SSH client or the Console
window and log in as the Linux root user.
e.
Enter these commands:
[root]# cd /root/_uninstall_patch
[root]# cd ./rollback-4.5.2
f.
When you are prompted to begin the rollback process, type y then press
Enter.
Step 5
(Optional) If you want to rollback the Cisco IPICS database to the state that it was
in at the time that you upgraded to release 4.5(2), restore the database using the
backup that was made when you upgraded.
Step 6
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(1).
c.
Click Save.
d.
From the IDC Management drawer, click IDC Versions.
e.
Check the check box for the row that contains 4.5(1) in the Version field.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
6-6
OL-28054-01
Chapter 6
Uninstalling or Rolling Back the Cisco IPICS Server Software
Rolling Back the Cisco IPICS Software from Release 4.5(2) to 4.5(1)
REVIEW DRAFT—CISCO CONFIDENTIAL
f.
From the drop-down list next to the Change State button, choose
Recommended.
g.
Click the Change State button.
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
OL-28054-01
6-7
Chapter 6 Uninstalling or Rolling Back the Cisco IPICS Server Software
Rolling Back the Cisco IPICS Software from Release 4.5(2) to 4.5(1)
REVIEW DRAFT—CISCO CONFIDENTIAL
Cisco IPICS Installation and Upgrade Guide, Release 4.5(1) and 4.5(2)
6-8
OL-28054-01