How to Dump Install Logs to the Serial Port of the Virtual Machine

From DocWiki

(Difference between revisions)
Jump to: navigation, search
m (1 revision)
 
(3 intermediate revisions not shown)
Line 7: Line 7:
----
----
-
== Procedure<br> ==
+
== Dumping Install Logs ==
 +
In order to dump install logs on a virtual UC installation, it is necessary to use a virtual serial port on the virtual machine. By default, a serial port is not present when deploying from the Cisco provided OVA. Thus it will often be the case that the first time you hit an installation problem and need to dump the logs, the serial port will not be available. Use this procedure to add a serial port to the virtual machine and dump the logs.
 +
 +
=== Procedure<br>  ===
Follow this procedure to dump install logs to the serial port on the VM.  
Follow this procedure to dump install logs to the serial port on the VM.  
-
#Configure a Serial Port on the VM.
+
#When the VM is '''powered off''', edit settings and add a serial port to the VM.<br> {{Note}} You cannot add one while the VM is running.<br>  
-
#When the VM is powered off, edit settings and add a serial port to the VM.<br> {{Caution}} You cannot add one while the VM is running.<br>  
+
#You will be required at this time to attach the serial port to a file. Just attach to any temp/junk file, as this file will NOT be used to dump the logs.<br>  
-
#Attach the serial port to a TMP file (see the TMP File section below).<br>  
+
#Power on the VM and start your installation. ''At boot up, linux will dump some garbage characters (escape sequence characters) into the temp file you attached to the serial port.''<br>  
-
#Power on the VM and start your installation.<br>  
+
#When you're ready to actually dump the log files, attach a '''new''', '''empty''' file to the serial port by editing settings of the VM while the machine is running. You do not have to power down the VM to change the file attached to the serial port. <br>  
-
#When you're ready to actually dump the log files, attach a new, empty file to the serial port.<br>  
+
#After the file is saved, you can open it using 7-zip (http://www.7-zip.org/download.html)  
-
#After the file is saved, open it using 7-zip (http://www.7-zip.org/download.html)  
+
#After you have a successful install in the VM, power off the VM, edit settings and remove the serial port from the VM. <br>{{note| Leaving the serial port (or any other unnecessary virtual hardware) can negatively impact performance of the VM. There is no other use of the serial port in a Unified CM VM other than dumping the install logs, so you will not need it again unless you do a fresh install.}} <br>
-
#After a successful dump, power off the VM, edit settings and remove the serial port from the VM. <br>{{note| Leaving the serial port (or any other unnecessary virtual hardware) can negatively impact performance of the VM. There is no other use of the serial port in a Unified CM VM other than dumping the install logs, so you will not need it again unless you do a fresh install.}} <br>
+
-
 
+
-
== TMP File<br>  ==
+
-
 
+
-
You need attach a TMP file to the serial port for the folowing reason: When you boot-up a linux server, a few garbage characters (terminal escape sequences) are output to that port. These characters corrupt the TAR format of the file--when you dump logs into that file. To obtain a valid TAR&nbsp;file, you must connect the serial port to a new and empty file just before you dump log to it. <br>
+
-
 
+
-
Once you prevent this data corruption, go back to the VM console and proceed to dump the logs to the serial port. <br>
+
-
 
+
-
<br>
+
-
 
+
-
== Failure Scenarios  ==
+
-
 
+
-
If the systems halts due to an install failure, a window pops up to verify if you want to dump the logs. <br> {{Caution}} BEFORE you click '''Yes''', edit settings on the VM and attach the actual file name where you want to dump the logs. Then click '''Yes'''.
+
-
 
+
-
 
+
-
 
+
-
{| border="1" class="wikitable"
+
-
|-
+
-
! style="background-color: rgb(255, 215, 0);" | '''Back to:''' [[Unified Communications in a Virtualized Environment|Unified Communications in a Virtualized Environment]]
+
-
|}
+

Latest revision as of 06:45, 29 July 2011

Go to: Implementing Virtualization Deployments

Go to: Ongoing Virtualization Operations and Maintenance



Dumping Install Logs

In order to dump install logs on a virtual UC installation, it is necessary to use a virtual serial port on the virtual machine. By default, a serial port is not present when deploying from the Cisco provided OVA. Thus it will often be the case that the first time you hit an installation problem and need to dump the logs, the serial port will not be available. Use this procedure to add a serial port to the virtual machine and dump the logs.

Procedure

Follow this procedure to dump install logs to the serial port on the VM.

  1. When the VM is powered off, edit settings and add a serial port to the VM.
    Note Note: You cannot add one while the VM is running.
  2. You will be required at this time to attach the serial port to a file. Just attach to any temp/junk file, as this file will NOT be used to dump the logs.
  3. Power on the VM and start your installation. At boot up, linux will dump some garbage characters (escape sequence characters) into the temp file you attached to the serial port.
  4. When you're ready to actually dump the log files, attach a new, empty file to the serial port by editing settings of the VM while the machine is running. You do not have to power down the VM to change the file attached to the serial port.
  5. After the file is saved, you can open it using 7-zip (http://www.7-zip.org/download.html)
  6. After you have a successful install in the VM, power off the VM, edit settings and remove the serial port from the VM.
    Note Note: Leaving the serial port (or any other unnecessary virtual hardware) can negatively impact performance of the VM. There is no other use of the serial port in a Unified CM VM other than dumping the install logs, so you will not need it again unless you do a fresh install.

Rating: 4.0/5 (8 votes cast)

Personal tools