Cisco IPICS Server Installation and Upgrade Guide, Release 2.1(1) - Upgrading Cisco IPICS [Cisco IP Interoperability and Collaboration System]

Table Of Contents

Upgrading Cisco IPICS

Before You Begin

Performing a Direct Cisco IPICS Server Software Upgrade

Performing a Remote Cisco IPICS Server Software Upgrade

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

•Performing a Direct Cisco IPICS Server Software Upgrade

•Performing a Remote Cisco IPICS Server Software Upgrade

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 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:

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 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.

Step 4 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:

•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.

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:

•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.

Step 2 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

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 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.

o. To continue with the upgrade, proceed to Step 4.

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.

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 Entering this command allows the root user ID to read and run the installer file.

Step 11 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, Release 2.1(1)
	Upgrading Cisco IPICS
Cisco IPICS Server Installation and Upgrade Guide, Release 2.1(1) Preface Overview Installing Cisco IPICS Upgrading Cisco IPICS Uninstalling Cisco IPICS Troubleshooting Cisco IPICS Installation Issues Glossary Index	Download this chapter Upgrading Cisco IPICS Download the complete book Cisco IPICS Server Installation and Upgrade Guide, Release 2.1(1) (PDF - 1 MB) Feedback Table Of Contents Upgrading Cisco IPICS Before You Begin Performing a Direct Cisco IPICS Server Software Upgrade Performing a Remote Cisco IPICS Server Software Upgrade 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 •Performing a Direct Cisco IPICS Server Software Upgrade •Performing a Remote Cisco IPICS Server Software Upgrade 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 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: 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 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. Step 4 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: •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. 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: •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. Step 2 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 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 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. o. To continue with the upgrade, proceed to Step 4. 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. 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 Entering this command allows the root user ID to read and run the installer file. Step 11 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.
	Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks