This document describes how to obtain system configurations in order for TAC to understand your current deployment, using the xconfiguration and xstatus commands as specified in the product API guides.
Contributed by Matt Limbrick, Cisco TAC Engineer.
Cisco recommends that you have knowledge of these topics:
SSH and/or Telnet clients
Basic PC functions
This document is not restricted to specific software and hardware versions.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.
Obtaining system product configurations with xconfig
Basically, you will need to SSH or Telnet into the unit to access the Command Line Interface (CLI) as an "admin" user. With whatever SSH/ Telnet client you use, you want to make sure you increase the "lines of scroll-back" or "output all to file" to ensure all output is captured. Once logged into the CLI as an "admin" user, you will issue the "xconfiguration" command, then the "xstatus" command. Below is the process more in-depth.
The “xconfiguration” and “xstatus” commands provide the current configurations of a supported device as well as current dynamic settings at a particular point in time. These commands can be entered in short form by typing only the 1st couple of letters that distinguish them from another command. These configurations are also stored on supported devices as XML files but are difficult to read. This process will output the configurations in a readable text format.
When looking at the xml file, you’ll see everything written in XML format. It will take longer to parse through to find what you are looking for.
In contrast, when you capture the data as outlined in the provided procedures, the same output is in simple format and is easier to review.
Xconfiguration: Configurations are system settings, such as system name and network settings. These are persistent across boots.
Xstatus: A status contains the current state of the codec, such as connected calls, the status of the gatekeeper registration, connected inputs and output sources.
To provide the "xconfig" and "xstatus" of the VCS, you will need to Telnet or SSH into the unit to access the Command Line Interface (CLI) using a program such as Putty.exe. You can download free at the link below:
Once installed and running, first change the buffer size to allow more lines of scroll-back. In the left windowpane, click on “Window”.
On the right side, change “Lines of scrollback” from 200 to 20000.
In the left windowpane, click on “Session”.
Select SSH or Telnet depending on which protocol you have enabled on your VCS. Enter you IP address of your VCS in the “Host Name” field, then click “Open”
If prompted with the following message, click “YES”
Login as “admin” and enter your password for this account.
Once logged in, type xconfig and press enter. You should see a bunch of lines populate as output with an “OK” at the end.
Next type xstatus and press enter.
You should see a bunch of lines populate as output with an “OK” at the end.
Next, right-click the title-bar (IP xxx.xxx.xxx.xxx – PuTTY) and select “Copy All to Clipboard”
Open a new text file (Notepad) and name it “<device type/name> config.txt” I.E., if a VCS Control “VCSc config” or “VCSe xconfig.txt” if a VCS Expressway. Next go to Edit > Paste and verify all output from your PuTTY session is entered into the text file.
Save the output and send the text file to TAC for further review.
Note: Please do not provide the format below unless specifically requested as these are difficult to work with.
Hey there, Looking for some assistance with CUCM. I am trying to make the Calling ID for redirected calls show the 10 digital local number of the IP sets In the gateway (setup for MGCP) under "Call Routing Information - Outbound Calls"If I...
Hello there, I was lurking the Webex API and noticed that Events (classic) has very poor functionalities via API... but now we have Events NEW! So my hope is that Events New will have more stuff available... has anyone any news on this? Is there a site in...
Hello, I am trying to register a new VG450 to CUCM as a SIP Gateway. This is working as expected, but I also need to be able to register the same VG450 as SCCP and MGCP. MGCP is fine, since it uses hostname.domain, SCCP is NOT working as it uses...
How to get Agent details who handled the call after "call Place step" from Script (callback script)? Im struggling to get agent details who handled the call after having a call place step in call back script. It shows NULL value.. &nb...
i've been testing UCCX 11.6 SSO with Azure as IDP, there is no real document available which gives the steps to perform on Azure side, i found a document for CuCM, which worked with CuCM at the first attempt, i thought to replicate it for UCCX , taking be...