CH A P T E R 3 Upgrading Cisco IPICS If your Cisco IPICS server is running release 2.0(2), 2.0(2), or 2.1(1) SR1, you can upgrade your server to release 4.0(1) by using a Cisco-provided CD-ROM. If you are not sure about how to obtain the software for Cisco IPICS release 4.0(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 4.0(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 Direct Cisco IPICS Server Software Upgrade, page 3-2 • Performing a Remote Cisco IPICS Server Software Upgrade, page 3-7 • Upgrading the Radio Descriptor, page 3-12 Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-1 Chapter 3 Upgrading Cisco IPICS Before You Begin 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. • 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 the Cisco IPICS Server Administration Guide. • 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 4.0(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. 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 4.0(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. Cisco IPICS Server Installation and Upgrade Guide 3-2 OL-21842-01 Chapter 3 Upgrading Cisco IPICS Performing a Direct Cisco IPICS Server Software Upgrade 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 Insert and mount the 4.0 IPICS software application installation CD. [root]# mount /mnt/cdrom mount: block device /dev/hda is write-protected, mounting [root]# ls -ltr /mnt/cdrom total 563500 -r-xr-xr-x 1 -r-xr-xr-x 1 -r-xr-xr-x 1 -r-xr-xr-x 1 root root root root root 47322321 Feb 24 root 529616588 Feb 24 root 7661 Feb 24 root 76279 Feb 24 01:03 01:04 20:49 20:49 upgrade-idc-4.0(0.xxx).zip install-ipics-4.0.0.xxx.run pre_ipics_db_upgrade_22_40 ipics_db_upgrade_22_40 [root]# Step 2 Copy the script pre_ipics_db_upgrade_22_40 on the installation CD to the Release 2.2 server under /root. Step 3 Back up the Release 2.2 database using the following command. [root]# pre_ipics_db_upgrade_22_40 <remote directory> <remote host IP> <User name> <password> For example: [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 4 The database backup process is different from the normal database backup that is available in the IPICS server. After you install Cisco IPICS Release 4.0, the file from the special backup created in Release 2.2 (dbspaces_ipics22.tgz) is required to replicate your database in Release 4.0. Save the dbspaces_ipics22.tgz file to a remote location under the same name. Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-3 Chapter 3 Upgrading Cisco IPICS Performing a Direct Cisco IPICS Server Software Upgrade Note You must save the file to a remote location because the file is deleted as part of the new operating system installation. Step 5 Install the IPICS 4.0 operating system as described in the “Installing the Cisco IPICS Operating System” section on page 2-7. Step 6 Install IPICS 4.0 application software as described in the “Installing the Cisco IPICS Server Software” section on page 2-16. Step 7 Create a temp directory in the root directory on the IPICS 4.0 server, set the owner and permissions, and then verify the settings: [root]# cd /root [root]# mkdir /temp [root]# chown informix:ipics /root/temp [root]# chmod 0770 /root/temp [root]# ls -ltr temp .... drwxrwx--2 informix ipics 4096 Mar .... [root]# 2 22:32 temp Step 8 Use SFTP to copy the database file dbspaces_ipics22.tgz to the /root/temp directory on the IPICS server. Step 9 Use the following command to run the IPICS database upgrade script, where serverip is the server IP address and rootpwd is the root password. Note This process may take up to 30 minutes. Make sure that you allow time for the process to complete. [root]# ipics_db_upgrade_22_40 /root/temp serverip root rootpwd Sample output: [root]# pre_ipics_db_upgrade_22_40 /dbupgradebackup ipics-standby root Very_R00ty INFO : Archive process for database upgrade started at Wed Dec 16 06:41:30 PST 2009 INFO : Stopping IPICS services INFO : IPICS services stopped successfully INFO : Generating archive control files (may take a few minutes) Cisco IPICS Server Installation and Upgrade Guide 3-4 OL-21842-01 Chapter 3 Upgrading Cisco IPICS Performing a Direct Cisco IPICS Server Software Upgrade INFO : Archive control files created INFO INFO INFO : Backing up IPICS database files (may take a few minutes) : Verifying archive file... : Archive of IPICS database files created successfully -----------------------------------------------------compressed uncompressed ratio uncompressed_name 11054629 475449344 97.7% /tmp/dbspaces_ipics22.tar INFO : Remote copying archive file to root@ipics-standby:/dbupgradebackup/dbspaces_ipics22.tgz INFO : Remote copy completed INFO : Archive process for database upgrade completed successfully at Wed Dec 16 06:45:22 PST 200 9 INFO : Restarting IPICS services… Starting Ipics Database: [ OK ] [root]# service ipics restart Stopping tomcat: [ OK ] ipics_tomcat: Removing ipicsadmin cron entry to disable 'check_tomcat' daemon RCS is stopped Stopping ippe_dial_engine: Starting ippe_dial_engine: Starting CVD: Starting RCS: Starting tomcat: Step 10 [ OK ] [ OK ] 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 11 Browse, find, and upload the IPICS 4.0 Upgrade license provided by Cisco. Step 12 Choose IDC Management > IDC Installer. Step 13 Click Save. Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-5 Chapter 3 Upgrading Cisco IPICS Performing a Direct Cisco IPICS Server Software Upgrade If the IDC 4.0 IDC upgrade installer package has been overwritten by restoration of the 2.2 database, you must reload the new R4.0 IDC upgrade package on the IPICS server by performing the following steps: Procedure Step 1 Copy the upgrade-idc-4.0(x.x).zip file from the IPICS server to the PC that you are using to access the IPICS server. Step 2 Install the upgrade package, responding yes to the upload prompt, as shown: [root]# sh install-ipics-4.x.run -- -i idc 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. Do you want to upload the new IDC version now? (yes/no): [?] yes The installer is extracting the idc.zip file... The installer is verifying upgrade-idc-4.0(0.033).zip... The upgrade-idc-4.0(0.033).zip file was extracted successfully. restarting ipics_tomcat.. The ipics_tomcat service was restarted successfully. The Cisco IPICS installer completed successfully. Step 3 Verify that the IPICS service is now running: [root]# service ipics status IPPE Dial Engine status: CVD process (pid 11847) is running... Engine process (pid 13377) is running... DMS (pid 11979) is running... Radio Control Service status: Cisco IPICS Server Installation and Upgrade Guide 3-6 OL-21842-01 Chapter 3 Upgrading Cisco IPICS Performing a Remote Cisco IPICS Server Software Upgrade RCS (pid 12266) is running... Node Manager status: Node Manager (pid 13524) is running... Tomcat status: Tomcat process (PID = 21028) is running... [root]# Step 4 Log in to the IDC and choose IDC Management > IDC Installer. Step 5 Click Save. The package is now ready for download from the IDC Home page. 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 Step 2 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 SFTP 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. Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-7 Chapter 3 Upgrading Cisco IPICS Performing a Remote Cisco IPICS Server Software Upgrade 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. Cisco IPICS Server Installation and Upgrade Guide 3-8 OL-21842-01 Chapter 3 Upgrading Cisco IPICS Performing a Remote Cisco IPICS Server Software Upgrade 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. Step 3 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. 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. Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-9 Chapter 3 Upgrading Cisco IPICS Performing a Remote Cisco IPICS Server Software Upgrade 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. Cisco IPICS Server Installation and Upgrade Guide 3-10 OL-21842-01 Chapter 3 Upgrading Cisco IPICS Performing a Remote Cisco IPICS Server Software Upgrade 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 9. Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-11 Chapter 3 Upgrading Cisco IPICS Upgrading the Radio Descriptor Upgrading the Radio Descriptor After upgrading a 2.2 system to 4.0, 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> <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"> Cisco IPICS Server Installation and Upgrade Guide 3-12 OL-21842-01 Chapter 3 Upgrading Cisco IPICS Upgrading the Radio Descriptor <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> <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"> Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-13 Chapter 3 Upgrading Cisco IPICS Upgrading the Radio Descriptor <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> <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> Cisco IPICS Server Installation and Upgrade Guide 3-14 OL-21842-01 Chapter 3 Upgrading Cisco IPICS Upgrading the Radio Descriptor <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> </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> Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-15 Chapter 3 Upgrading Cisco IPICS Upgrading the Radio Descriptor <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"> <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> Cisco IPICS Server Installation and Upgrade Guide 3-16 OL-21842-01 Chapter 3 Upgrading Cisco IPICS Upgrading the Radio Descriptor <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" /> </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 Select 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 insure 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 Cisco IPICS Server Installation and Upgrade Guide OL-21842-01 3-17 Chapter 3 Upgrading Cisco IPICS Upgrading the Radio Descriptor Wait a few minutes before attempting to control any radio. Cisco IPICS Server Installation and Upgrade Guide 3-18 OL-21842-01
© Copyright 2026 Paperzz