stuc tool training

© 2010 Cisco Systems, Inc. All rights reserved. 1Cisco PublicSTUC 1

STUC Tool Training

Show Technical-Support Tool for Unity Connection

By: Michael Hollowell (CCIE 4114)

UCBU Escalation Team

Cisco PublicSTUC 2© 2010 Cisco Systems, Inc. All rights reserved. 2

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).

Cisco PublicSTUC 3© 2010 Cisco Systems, Inc. All rights reserved. 3

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/libroot@hostname : source ./connection.profileroot@hostname : python –u show-cuc-sysinfo

Cisco PublicSTUC 4© 2010 Cisco Systems, Inc. All rights reserved. 4

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

…

Cisco PublicSTUC 5© 2010 Cisco Systems, Inc. All rights reserved. 5

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

…

Cisco PublicSTUC 6© 2010 Cisco Systems, Inc. All rights reserved. 6

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.…

Cisco PublicSTUC 7© 2010 Cisco Systems, Inc. All rights reserved. 7

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…

Cisco PublicSTUC 8© 2010 Cisco Systems, Inc. All rights reserved. 8

Output Break Down (5 of 11)

… Memory Total : 2074820K Free : 25064K Used : 2049756K Cached : 821404K Shared : 0K Buffers : 9296K Total Free Used Disk/Active 18421552K 10273220K 7961176K (44%) Disk/Common 64089320K 36462108K 24371644K (41%) Disk/InActive 18421584K 17407512K 78288K (1%)…

Cisco PublicSTUC 9© 2010 Cisco Systems, Inc. All rights reserved. 9

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…

Cisco PublicSTUC 10© 2010 Cisco Systems, Inc. All rights reserved. 10

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…

Cisco PublicSTUC 11© 2010 Cisco Systems, Inc. All rights reserved. 11

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…

Cisco PublicSTUC 12© 2010 Cisco Systems, Inc. All rights reserved. 12

Output Break Down (9 of 11)

… IP Network Information:

Ethernet adapter Local Area Connection:

Adapter - eth0 DHCP : disabled Status : UP IP Address : 172.18.138.18 IP Mask : 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…

Cisco PublicSTUC 13© 2010 Cisco Systems, Inc. All rights reserved. 13

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 …

Cisco PublicSTUC 14© 2010 Cisco Systems, Inc. All rights reserved. 14

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 #########################

Cisco PublicSTUC 15© 2010 Cisco Systems, Inc. All rights reserved. 15

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

Cisco PublicSTUC 16© 2010 Cisco Systems, Inc. All rights reserved. 16

Additional Information

External to Cisco -

mihollow@cisco.com Contact TAC Internal to Cisco -

See Cisco Internal Unity-Wiki -> Cisco Unity Connection -> Tools -> STUC

Email UCTAC alias

Cisco PublicSTUC 17© 2010 Cisco Systems, Inc. All rights reserved. 17

Demo

Invoking/Gathering STUC output via Putty SSH Client

Using remote access account to invoke STUC

Enable Debugging option within STUC