STUC Tool Training
Download
Report
Transcript STUC Tool Training
STUC Tool Training
Show Technical-Support Tool
for Unity Connection
By: Michael Hollowell (CCIE 4114)
UCBU Escalation Team
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
1
Overview
The STUC tool is a script that will gather important information about the Cisco
Unity Connection Server that can assist in the trouble shooting process.
Can only be accessed through the CLI.
CLI first available in UCNX 8.0.
Is backwards compatible*, but requires manuals steps & remote support access.
Typically will be ran by a Cisco TAC or BU Escalation engineer.
Very similar to the Cisco Unity Gather Unity System Information Tool (GUSI).
Display output is to the console only (Cut/Paste or Buffer capture).
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
2
Invoking within UCNX 8.0 and later
VIA Admin CLI
admin : show cuc sysinfo
VIA Remote Access (Root) access
root@hostname : cd /opt/cisco/connection/lib
root@hostname : source ./connection.profile
root@hostname : python –u show-cuc-sysinfo
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
3
Output Break Down (1 of 11)
admin:show cuc sysinfo
######################### START ########################
Version: 1.1.8
Gather Date/Time: Fri Jan 8 16:33:25 EST 2010
Connection Install Information:
Host Name: UC-70-PRI
Version:
Active Version: 8.0.0EFT2.98000-3EFT2
Inactive Version: Not Found
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
4
Output Break Down (2 of 11)
…
High Availability (this server is): Pri_Active
Publisher:
uc-70-pri.rtp.ucbu.local - 172.18.138.18
Subscriber(s):
uc-70-sec.rtp.ucbu.local (Sec_Active) - 172.18.138.33
QOS Settings:
Call Signaling DSCP: CS3
Media Signaling DSCP: EF
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
5
Output Break Down (3 of 11)
…
Hardware:
HW Platform
: VMware
Processors
:1
Type
: Intel(R) Xeon(R) CPU
5140 @ 2.33GHz
CPU Speed
: 2330
Memory
: 2048
Object Id
: VMware
OS Version
: UCOS 4.0.0.0-31
Serial Number
: VMware-56 4d 9c 8e 34 8a 22 69-74 1c 39 0a fa 7f 35 6a
RAID Version
:
No RAID information found.
BIOS Information :
PhoenixTechnologiesLTD 6.00 07/22/2008
RAID Details
:
No RAID information found.
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
6
Output Break Down (4 of 11)
…
Environment Information:
Date
: Fri Jan 8 13:22:53 EST 2010
Locale
: en_US.UTF-8
Product Version
: 8.0.0.98000-46
OS Version
: 4.0.0.0-31
License MAC
: 368dcea2f3bb
Uptime:
13:22:56 up 28 days, 21:49, 2 users, load average: 1.44, 1.25, 1.06
CPU Idle: 98.99% System: 1.01%
User: 0.00%
IOWAIT: 0.00%
IRQ: 0.00%
Soft: 0.00%
Intr/sec: 533.33
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
7
Output Break Down (5 of 11)
…
Memory Total
Free
Used
Cached
Shared
Buffers
:
:
:
:
:
:
Disk/Active
Disk/Common
Disk/InActive
2074820K
25064K
2049756K
821404K
0K
9296K
Total
18421552K
64089320K
18421584K
Free
10273220K
36462108K
17407512K
Used
7961176K (44%)
24371644K (41%)
78288K (1%)
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
8
Output Break Down (6 of 11 )
…
Remote Support:
Status
: enabled
Account
: remoteaccess
Passphrase : CCMWMVSFE6
Expiry
: 1-14-2010:11:00:00 (MM-DD-YYYY:Hr:Min:Sec)
Directory Information:
Total Subscribers Local: 1
Total Subscribers in Network: 1
Total Contacts in Network: 0
Total Number of Call Handlers Local: 3
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
9
Output Break Down (7 of 11)
…
Total Number of Locations: 2
Local:
=======
Displayname
Systemversion
LastUSNsent
LastUSNreceived LastUSNack
---------------------------------------------------------------------------------------------------------------------------uc-70-pri
8.0.0.3EFT2
Remote:
=======
None
VPIM:
=====
Displayname
Dial Id
SMTP Domain
---------------------------------------------------------------------------------------------------------------remote
919
rtp.ucbu.local
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
10
Output Break Down (8 of 11)
…
License Information:
License
Value Used
Unused Cluster Limit
--------------------------------------------------------------------------------------------LicSubscribersMax
20000
1
39999 40000
LicIMAPSubscribersMax
20000 1
39999 40000
LicVMISubscribersMax
20000
0
40000 40000
LicAdvancedUserMax
20000
0
40000 40000
LicVoicePortsMax
250
0
250
LicRealspeakSessionsMax
250
0
250
LicUnityVoiceRecSessionsMax 250
0
250
LicSTTSubscribersMax
0
0
0
0
Voice message recordings longer than 30 seconds allowed (LicMaxMsgRecLenIsLicensed): Yes
US English usage and personal call routing rules allowed (LicRegionIsUnrestricted): Yes
VPIM Networking delivery locations allowed (LicVPIMIsLicensed): Yes
License files from previous releases allowed (LicUCxnUpgrades): No
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
11
Output Break Down (9 of 11)
…
IP Network Information:
Ethernet adapter Local Area Connection:
Adapter - eth0
DHCP
: disabled
IP Address : 172.18.138.18
Status
IP Mask
: UP
: 255.255.255.0
DNS
Primary : 172.18.138.17 Secondary : Not Configured
Options : timeout:5 attempts:2
Domain
: rtp.ucbu.local
Gateway : 172.18.138.1 dev eth0
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
12
Output Break Down (10 of 11)
…
Informix:
onstat -m:
IBM Informix Dynamic Server Version 11.50.UC5X3 -- On-Line -- Up 28 days
21:45:08 -- 680964 Kbytes
Message Log File: /var/opt/cisco/connection/log/informix.log
01/08/10 13:10:20 Checkpoint Statistics - Avg. Txn Block Time 0.000, # Txns
blocked 0, Plog used 2, Llog used 2
01/08/10 13:14:22 Checkpoint Completed: duration was 0 seconds.
01/08/10 13:14:22 Fri Jan 8 - loguniq 49, logpos 0x7255018, timestamp: 0x202b24b
Interval: 14488
…
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
13
Output Break Down (11 of 11 )
…
cdr list server:
SERVER
ID STATE STATUS QUEUE CONNECTION CHANGED
----------------------------------------------------------------------g_ciscounity_pub
100 Active Local
0
g_ciscounity_sub1 101 Active Connected
0 Jan 4 12:41:38
Foreign Key Constraint Check:
unitydirdb has one or more foreign key constraints disabled
unitymbxdb1 has one or more foreign key constraints disabled
########################## END #########################
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
14
Trouble Shooting
Command doesn’t execute
Gather "/var/log/active/platform/log/cli*.log"
Operational errors after executing
Attempt to run under Remote Access Account (root) CLI
- Gather console output
Enable debug output file by editing show-cuc-sysinfo file
- Gather /tmp/cuc-sysinfo file
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
15
Additional Information
External to Cisco [email protected]
Contact TAC
Internal to Cisco See Cisco Internal Unity-Wiki -> Cisco
Unity Connection -> Tools -> STUC
Email UCTAC alias
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
16
Demo
Invoking/Gathering STUC output via Putty
SSH Client
Using remote access account to invoke
STUC
Enable Debugging option within STUC
STUC
© 2010 Cisco Systems, Inc. All rights reserved.
Cisco Public
17