Starting with Release 8.0(3), you can install Unified IC on a virtual machine. You can also migrate from the previous releases of Unified IC Release 8.0(1) or 8.0(2) to a virtual machine running Unified IC Release 8.0(3).
Can my Cisco Support Provider log in to assist me?
Yes. There is a utility that allows Cisco technicians to troubleshoot your system, its configurations, and databases.
Set up and enable a time-limited access account to your system using the CLI commands under the utils remote_account command or run the utility from the Cisco Unified Operating System Administration Console (select Services > Remote Support).
The procedure to do this is documented in the online help for the Cisco Unified Operating System Administration Console.
How do I handle "No Such File or Directory" error?
During installation on some servers, you might see an error similar to this:
rmmod: ohci_hcd: no such file or directory
This is a benign message related to USB driver modules and can be safely ignored.
The installation attempts to delete all modules on the server before loading new ones. If a module does not exist on the server where the installation is running, a message indicates that there is no such file to be deleted. Messages differ slightly for different driver names.
How do I access log files?
If you encounter problems with the installation, you can obtain and examine the install log files by entering the following commands in Command Line Interface.
Enter the CLI command file list install * to obtain a list of all install log files from the command line.
Enter the CLI command file view install <log_file> to view the log file from the command line where log_file is the log file name.
Other ways to access log files are as follows:
Use the CLI file dump commands.
Use the Syslog Viewer in the Real-Time Monitoring Tool (RTMT). Download RTMT from the Administration console (Tools > RTMT Plugin Download).
How do I add or replace devices in the cluster?
To add a device (for example, to add an additional Member to the cluster):
Verify that the new or replacement device meets the hardware requirements outlined in the Hardware and System Software Specification (Bill of Materials).
Make sure that the other devices in the cluster are up and running.
Run a fresh (DVD) installation on the new or replacement device. It must be the same version of Unified IC that is currently installed on all other nodes.
Apply any upgrades and updates to the device so that it is running the same software as the other devices in the cluster.
There is a step to test network connectivity during the installation of the Controller and Member servers. You can also run a basic check that one server can connect to another using this CLI command: utils network ping. See Complete configuration for Member node.
How do I use the Recovery Disk?
The installation package includes a Recovery Disk on CD media to help you to recover from a catastrophic failure, such as an unbootable system.
To use the Recovery Disk, insert it into the tray and boot up into it.
The Recovery Disk has the following options:
[S] /[s]: Swaps the active and inactive partitions (that is, boots the system with the earlier active version, which is currently inactive). This option is displayed only if there is a valid inactive partition in the system.
[W]/[w]: Windows Pre-Installation Set-up. Reimages the system and prepares it for a Windows installation.
[F]/[f]: Checks the file system and automatically corrects it.
[M]/[m]: Checks the file system and manually corrects it.
[V]/[v]: Verifies the disk partitioning layout and displays the disk partitions on the screen.
[Q]/[q]: Quits the recovery disk program and asks you to reboot the system.
How do I uninstall?
There is no way to uninstall other than reinserting the installation DVD, which will reformat the hard disk.
Do not make configuration changes from the start of the upgrade process until you have activated the inactive partition and rebooted the system.
If you decide to downgrade and switch/restart the system to the inactive partition that contains the older version of the software, any configuration changes that you made since upgrading will be lost.
Is Unified IC supported in a hosted deployment?
Deployment in a hosted environment was not qualified and tested in this release. For testing, each Unified IC instance was dedicated to a single customer. Qualification for a hosted contact center is planned for a future release.
Which accounts and passwords are defined during the installation?
During the installation, you specify three passwords: the System Administrator user, the System Application user, and the database access security password. All three must start with an alphabetic character, must be at least six characters long, and can contain alphanumeric characters, hyphens, and underscores. Only the application user and password are passed to the online Administration console.
System Administrator account The System Administrator account User ID and password are configured at installation for each node. It is a best practice to enter the same user name and password for all nodes.
The System Administrator for the Controller can access:
The CLI for the Controller.
The Cisco Systems tools on the Navigation dropdown in the Administration console: Disaster Recovery System, Cisco Unified Serviceability, and Cisco Unified OS Administration interfaces.
The System Administrator has no access to functions in the Unified IC reporting application.
If you configure unique System Administrator credentials for Member nodes, you must use those credentials to access the CLI for those Member servers only.
System Application User account The System Application account User ID and password are configured at installation for each node. It is a best practice to enter the same user name and password for all nodes. The System Application user name and password that are configured for the Controller allow an initial login to the Administration console. This user becomes that initial Super User and, once the license is applied, can log in to the Unified IC Reporting application on all Member nodes. As the initial Super User, the System Application User can create additional Super Users in the User Management screen or by using the CLI command set account. This user can also sign in to the Unified IC Reporting interface with full access to all functions. The initial Super User (the System Application user) created in the installation does not need to be set up in Active Directory.
Any additional Super Users created through the Administration console are considered to be IMS users. They can sign into Unified IC Reporting and will be limited to the Login User role until they are given additional privileges.
If you configure unique System Application credentials for Member nodes, those users have no login rights.
Security Password The security password defined in the installation wizard is used by the system for the database security password to authorize communications between devices. This password is identical on all servers in the cluster. The security password is also used by the Disaster Recovery System (DRS) for encryption of the backup file. You can change the security password using the CLI command set password security.
What if the installation fails?
If the installation fails, you see a screen asking if you want to copy diagnostic information to a device.
If the installation fails over a virtual machine, you see a screen asking if you want to copy diagnostic information to a device.
How do I dump install logs to the serial port of the virtual machine?
Configure a serial port on the virtual machine. While the virtual machine is powered OFF, edit settings and add a serial port to the virtual machine. You cannot add a serial port while the virtual machine is running. Attach the serial port to a .tmp file, and then power on the virtual machine and start the install.
When you are ready to dump the log files, attach a new, empty file to the serial port. If the system halts due to an install failure and asks if you want to dump the logs, before you answer yes, you must edit settings on the virtual machine and attach the actual file name where you want to dump the logs. The reason for originally attaching the .tmp file to the serial port is that during the boot-up of Linux, a few garbage characters (terminal escape sequences) get output to that port. If you dump the logs into that file, these characters will corrupt the .tar format of the file. In order to create a valid .tar file, you must connect the serial port to a new and empty file just before you dump the logs to it.
Return to the virtual machine console and proceed to dump the logs to the serial port. After the file is complete, open it with 7-zip, which you can download from http://www.7-zip.org/download.html.
After a successful install, power off the virtual machine, edit settings, and remove the serial port from the virtual machine.
Important: Leaving the serial port (or any other virtual hardware) can negatively impact performance of the virtual machine. The serial port has no other use other than dumping the install logs and you will not need it again, unless you perform a fresh install.
What do I do if the upgrade stalls?
During the installation of upgrade software, the upgrade may appear to stall. The upgrade log stops displaying new log messages. When the upgrade stalls, you must cancel the upgrade, disable I/O throttling, and restart the upgrade procedure. When you successfully complete the upgrade, you do not need to reenable I/O throttling.
To disable I/O throttling, enter the CLI command utils iothrottle disable.
To display the status of I/O throttling, enter the CLI command utils iothrottle status.
To enable I/O throttling, enter the CLI command utils iothrottle enable. By default, iothrottle is enabled.
If the system does not respond to the cancellation, you must reboot the server, disable I/O throttling, and restart the upgrade process procedure.
Where is a fresh installation installed?
All Controller servers have an active bootable partition, an inactive bootable partition, and a common partition. The installation creates these partitions, and a fresh (first-time) installation places the new software and operating system on the active partition. The system boots up and operates on the active partition.
Where is an upgrade installation installed?
All Controller servers have an active bootable partition, an inactive bootable partition, and a common partition. Upgrade versions are installed on the inactive partition.
To complete the upgrade, you switch partitions using the CLI command utils system switch-version.
You can also do this from the Cisco Unified Communications Operating System Administration screen. Navigate to Settings > Version. This opens the Version Settings screen, which shows the software version on both the active and inactive partitions. To switch versions and restart, click Switch Versions. When the system restarts, it boots to the now-active (formerly inactive) partition with your migrated data in place. See Upgrades and migrations for more information.