Cisco WebEx Social Troubleshooting Guide, Release 3.3 and 3.3 SR1
FAQs and Troubleshooting
Downloads: This chapterpdf (PDF - 447.0KB) The complete bookPDF (PDF - 4.06MB) | Feedback

FAQs and Troubleshooting

Table Of Contents

FAQs and Troubleshooting

Installation and Upgrade FAQs and Troubleshooting

Installation and Upgrade Troubleshooting

Core Functionality FAQs and Troubleshooting

Core Functionality Troubleshooting

Email Integration FAQs and Troubleshooting

Email Integration FAQs

Email Integration Troubleshooting

Email Plug-in FAQs and Troubleshooting

Email Plug-in FAQs

Calendar FAQs and Troubleshooting

Calendar FAQs

Calendar Troubleshooting

Video Calls FAQs and Troubleshooting

Video Calls FAQs

Video Calls Troubleshooting

Search FAQs and Troubleshooting

Search Troubleshooting

Health and Performance Monitoring FAQs and Troubleshooting

Health and Performance Monitoring FAQs

Health and Performance Monitoring Troubleshooting

Logs FAQs and Troubleshooting

Logs FAQs

Director FAQs and Troubleshooting

Director FAQs

Director Troubleshooting

Worker FAQs and Troubleshooting

Worker FAQs

Message Queue FAQs and Troubleshooting

Message Queue Troubleshooting

Analytics FAQs and Troubleshooting

Analytics FAQs

My Library FAQs and Troubleshooting

My Library Troubleshooting

Framework FAQs and Troubleshooting

Framework FAQs

Streams FAQs and Troubleshooting

Streams FAQs

UC Integrations FAQs and Troubleshooting

UC Integrations Troubleshooting

WebEx Social for Office FAQs and Troubleshooting

WebEx Social for Office FAQs

Open API FAQs and Troubleshooting

Open API FAQs

OpenSocial FAQs and Troubleshooting

OpenSocial FAQs

OpenSocial Troubleshooting

Synthetic Monitoring FAQs and Troubleshooting

Synthetic Monitoring Troubleshooting

Using Jabber with Cisco WebEx Social FAQs and Troubleshooting

Using Jabber with Cisco WebEx Social FAQs

Chat FAQs and Troubleshooting

Chat Troubleshooting


FAQs and Troubleshooting


This chapter provides FAQs and troubleshooting hints for various Cisco WebEx Social components.

This chapter is organized as follows:

Installation and Upgrade FAQs and Troubleshooting

Core Functionality FAQs and Troubleshooting

Email Integration FAQs and Troubleshooting

Email Plug-in FAQs and Troubleshooting

Calendar FAQs and Troubleshooting

Video Calls FAQs and Troubleshooting

Search FAQs and Troubleshooting

Health and Performance Monitoring FAQs and Troubleshooting

Logs FAQs and Troubleshooting

Director FAQs and Troubleshooting

Worker FAQs and Troubleshooting

Message Queue FAQs and Troubleshooting

Analytics FAQs and Troubleshooting

My Library FAQs and Troubleshooting

Framework FAQs and Troubleshooting

Streams FAQs and Troubleshooting

UC Integrations FAQs and Troubleshooting

WebEx Social for Office FAQs and Troubleshooting

Open API FAQs and Troubleshooting

OpenSocial FAQs and Troubleshooting

Synthetic Monitoring FAQs and Troubleshooting

Using Jabber with Cisco WebEx Social FAQs and Troubleshooting

Chat FAQs and Troubleshooting

Installation and Upgrade FAQs and Troubleshooting

Installation and Upgrade Troubleshooting

Installation and Upgrade Troubleshooting

This section provides the following troubleshooting information:

The Topology page on the Director is empty after upgrade.

After an upgrade, the Director's Health page displays Integrity check alerts.

Symptom    The Topology page on the Director is empty after upgrade.

Possible Cause    After upgrading Cisco WebEx Social to a newer version, the System > Topology page on the Director displays an empty server list.

Recommended Action    Refresh your web browser using F5 or Ctrl-F5 (for hard refresh).

Symptom    After an upgrade, the Director's Health page displays Integrity check alerts.

Possible Cause    This issue may arise if the scheduled run of the Integrity service coincides with the upgrade process in which case the integrity check expectably fails because files are changing.

Recommended Action    Manually rerun the integrity check on the affected nodes. Take these steps:


Step 1 Find the affected nodes' hostnames by looking at the Health page and taking note of the Host column of each occurrence of the alert.

Step 2 Log in to each of the affected nodes using user admin and execute this command:

sudo /opt/cisco/bin/integrity.sh --run-check

Step 3 After running this command, verify the messages log for this particular node in the Director logs to check for any errors resulting from the integrity check script. The alerts from the Director's Health page should disappear in a few minutes.


Core Functionality FAQs and Troubleshooting

Core Functionality Troubleshooting

Core Functionality Troubleshooting

This section provides the following troubleshooting information:

File attached to an update is not visible in full page view.

Community creation pauses indefinitely.

Symptom    File attached to an update is not visible in full page view.

Possible Cause    This issue can appear when you have your browser idle in Cisco WebEx Social for a long period (for example: > 8 hours). More specifically, these conditions must have all been true:

The Cisco Social session timeout has been increased in Web.xml to more than the default 8 hours.

The attachment clean-up interval parameter (com.cisco.ecp.vdl.attachment.cleanup.job.interval) has not been changed.

The update has been posted after waiting on the compose screen for a significant amount of time (more than com.cisco.ecp.vdl.attachment.cleanup.job.interval).

Recommended Action    To prevent this issue from appearing again, sign in to the Director, go to Application > Portal > Advanced Portal Properties and search for com.cisco.ecp.vdl.attachment.cleanup.job.interval. Set its value to be one hour longer than the session timeout. (Note that the com.cisco.ecp.vdl.attachment.cleanup.job.interval is in minutes while the session timeout is in hours.)

Symptom    Community creation pauses indefinitely.

Possible Cause    This issue may be due to you NFS storage being unreachable.

Recommended Action    Check to see if your NFS storage is running and responding and that it is reachable from the network segment Cisco WebEx Social is in.

Email Integration FAQs and Troubleshooting

Email Integration FAQs

Email Integration Troubleshooting

Email Integration FAQs

How do I set the log trace levels for Outbound Email?

How do I set the log trace levels for Inbound Email?

How do I set the log trace levels for Digest Scheduler?

How do I set the log trace levels for Postfix?

What is the size of an email notification and can I control it?

Why are some images from the post displayed as thumbnails in the email notification?

How do I verify that Inbound Email is functioning properly?

How do I set the log trace levels for Email Notifications for Alerts and Announcements?

Q. How do I set the log trace levels for Outbound Email?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties, select a Worker node and then set the Outbound Email category to:

ERROR for normal operation.

DEBUG to gather detailed information.

In additional you may want to enable DEBUG level for the QUAD_EVENTING category on Worker nodes.

Q. How do I set the log trace levels for Inbound Email?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties and set the Inbound Email category for both the App Server and Worker nodes:

ERROR for normal operation.

DEBUG to gather detailed information.

Q. How do I set the log trace levels for Digest Scheduler?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties, select a Worker node and then set the Digest Scheduler category to:

ERROR for normal operation.

DEBUG to gather detailed information.

Q. How do I set the log trace levels for Postfix?

A. If you suspect an issue between Postfix and the SMTP server Postfix is talking to, you can enable verbose logging of all SMTP messaging in the maillog file. Take these steps:


Step 1 Log in to each Worker node as admin and run this command: sudo vi /etc/postfix/main.cf

Step 2 In the vi editor, add the following line (assuming it is not already present in the file):

debug_peer_list = example.com
 
   

where example.com is the domain of the SMTP server that Postfix is sending to.

Step 3 Save the changes.

Step 4 Run this command to restart Postfix: sudo service postfix restart

It is recommenced to undo the changes after you are finished troubleshooting. To undo the changes:


Step 1 Log in to each Worker node as admin and run this command: sudo vi /etc/postfix/main.cf

Step 2 In the vi editor, remove the line that you added.

Step 3 Save the changes.

Step 4 Run this command to restart Postfix: sudo service postfix restart

Q. What is the size of an email notification and can I control it?

A. Mail notifications vary in size depending on the content (how much text and how many images are included) but cannot exceed 5MB. The summary size of all text inside an email notification cannot exceed 1MB and the summary size of all images cannot exceed 4MB. In case the former limitation is exceeded, a Read More link is displayed. In case the later limitation is exceeded, a generic thumbnail is displayed instead of images. These limits are not configurable.

Q. Why are some images from the post displayed as thumbnails in the email notification?

A. When the cumulative size of the post images exceeds a certain limit or another size limit is reached (see What is the size of an email notification and can I control it?) images (starting from the bottom) are replaced in the email notification for that post by generic file type thumbnails to minimize size. How many images are replaced depends on how much size needs to be saved. As a side effect, bottom images that need to be replaced but have also been inserted one or more times up the post, are all displayed as thumbnails, even if the size restrictions do not require this.

Q. How do I verify that Inbound Email is functioning properly?

A. Take these general steps:

SMTP server

Verify that the SMTP server is configured properly and that a forward zone and an MX record are in place for the domain of the email recipients, otherwise undeliverable mail notifications might be received.

Postfix MTA

Ensure that the postfix service is running on the Worker node behind the port specified in the configuration (the default is 25)

Ensure that the firewall is not blocking the postfix service

Verify that messages are properly deferred from the postfix queues. If not, there might be some problem communicating with SubethaSMTP—either the server is not running or postfix is not configured properly.

SubethaSMTP MDA

Ensure that the SubethaSMTP server is running on the Worker node behind the port specified in the configuration (the default is 2025)

ActiveMQ

Verify that there is a queue named: com.cisco.ecp.inbound.queue and that there are active consumers of this queue. If not there are problem in Quad web node connecting to the ActiveMQ.

Verify that messages are de-queued. The number of incoming and outgoing messages are equal.

NFS

Verify that the specified folder has bean created (the default is data\inboundmail) on the NFS storage and that the owner of the folder is quad:quad. Otherwise there might be problems storing new messages.

OracleDB

Verify that the sender email address belongs to a WebEx Social user and that the user is active and has accepted the license agreement.

Verify that the user has permission to create content (in the corresponding community). Not having permission should result in respective log messages being written to the App Server log.

MongoDB

Verify that the recipients and messageThread collections exist

Verify that there is a recipient whose _emailAddress matches the local part of the email address of the email recipient

Verify that the recipient's classNameId value is proper (Group in case of writing to a community, PostMapping in case of writing to a post, MBCategory in case of writing to a discussion category) and that the classPK points to an existing object of the determined type

In the case of an email reply, verify that the parent massage can be looked up by its in-reply-to, references or threadindex headers

Q. How do I set the log trace levels for Email Notifications for Alerts and Announcements?

A. Set the Outbound Email category as described in How do I set the log trace levels for Outbound Email?. Set the Digest Scheduler category as described in How do I set the log trace levels for Digest Scheduler? If you suspect an issue between Postfix and the SMTP server Postfix is talking to, enable verbose logging of all SMTP messaging as described in How do I set the log trace levels for Postfix?

Email Integration Troubleshooting

This section provides the following troubleshooting information:

A reply created using Outlook/OWA is added as first level comment in WebEx Social instead of as a reply.

Out of the Office auto replies to WebEx Social email notifications are added as content in WebEx Social.

A number of (or all) users did not receive their email digests (summary of important updates).

Users receive multiple daily digests.

Users receive multiple weekly digests.

Inbound email does not appear as content in Cisco WebEx Social.

Some replies are saved as new posts containing the entire email thread as opposed to comments to the original content.

Users are not receiving any emails generated by Cisco WebEx Social.

Video thumbnails do not display in email notifications.

Email notifications about alerts and announcements stop sending out.

Symptom    A reply created using Outlook/OWA is added as first level comment in WebEx Social instead of as a reply.

Possible Cause    Your organization is using Microsoft Exchange Server 2003 without the KB908027 fix applied.

Recommended Action    Apply the fix or upgrade to the latest version of Microsoft Exchange Server 2003. For more information, see http://support.microsoft.com/kb/908027.

Symptom    Out of the Office auto replies to WebEx Social email notifications are added as content in WebEx Social.

Possible Cause    The user account sending the Out of Office message is hosted on Microsoft Exchange Server 2003.

Recommended Action    Mail accounts running on later versions of Microsoft Exchange Server or IBM Lotus Domino should not run into this issue.

Symptom    A number of (or all) users did not receive their email digests (summary of important updates).

Possible Cause    You have recently increased or decreased worker.digestscheduler.mainJobRepeatInterval. After the value has been modified and saved, the Digest Scheduler waits for that interval before it runs again. Depending on a number of related factors some users may be skipped when creating digests.

Recommended Action    Wait for worker.digestscheduler.mainJobRepeatInterval to run out (30 min. if left at its default), then the digests should start arriving on schedule.

Possible Cause    The user has requested a daily digest and you have set worker.digestscheduler.mainJobRepeatInterval to a large value that makes the next run of the Digest Scheduler to fall into the next day.

Recommended Action    When you are setting the worker.digestscheduler.mainJobRepeatInterval parameter, take the "Daily Digest Notification Time" value (Director > Application > Portal > Email Digest) in consideration. Set worker.digestscheduler.mainJobRepeatInterval to a value that allows the Digest Scheduler to run at least once in the time frame between "Daily Digest Notification Time" and the end of the day.

For example if you have set "Daily Digest Notification Time" to 23:00 (11 pm), that leaves the Digest Scheduler only 1 hour to start and complete its run; ensure this by setting worker.digestscheduler.mainJobRepeatInterval to less than an hour.

Possible Cause    The user has recently changed their time zone. If the new time zone has already been notified, the affected user does not receive their daily report.

Recommended Action    Keeping the time zone setting should allow the user to receive future daily reports on schedule.

Symptom    Users receive multiple daily digests.

Possible Cause    The Administrator has changed the Daily Digest Notification Time after the daily digest has been sent out for the day.

Recommended Action    If you want to avoid duplicate daily digests when changing Daily Digest Notification Time to an earlier time, ensure you make the change before the original time comes for the day.

Possible Cause    The user has recently changed their time zone. If the new time zone has not been notified yet, the affected user receives a second report.

Recommended Action    Keeping the time zone setting should allow the user to receive future daily reports on schedule.

Symptom    Users receive multiple weekly digests.

Possible Cause    The Administrator has changed the Weekly Digest Notification Date forward after the weekly digest has been sent out for the week.

Recommended Action    If you want to avoid duplicate weekly digests, ensure you make the change to Weekly Digest Notification Date before the original time comes for the week.

Symptom    Inbound email does not appear as content in Cisco WebEx Social.

Possible Cause    The Worker node is restarting or has just been restarted.

Recommended Action    Wait for about 10 minutes. After that, the emails that have been sent should appear as content.

Symptom    Some replies are saved as new posts containing the entire email thread as opposed to comments to the original content.

Possible Cause    This issue can arise if the original email has not yet been processed by Cisco WebEx Social.

Recommended Action    If you experience this issue often, check the Dashboard for the Worker nodes (Director GUI > Stats). If the App Server/Worker nodes are under heavy load—as indicated by the CPU and Load charts—then consider adding more App Server or Worker nodes, or both.

Symptom    Users are not receiving any emails generated by Cisco WebEx Social.

Possible Cause    Your email relay is not relaying messages coming from Cisco WebEx Social.

Recommended Action    Configure your email relay host to properly relay messages coming from Worker nodes.

Symptom    Video thumbnails do not display in email notifications.

Possible Cause    Worker nodes do not have the Show and Share (SNS) security certificates installed. Because email notifications are generated on the Worker role, all Worker nodes should have access to the Show and Share server to be able to access video thumbnail and URL data.

Recommended Action    Ensure that you have installed the SNS security certificates on all App Server and Worker nodes. For installing the certificates on App Server nodes, see "Cisco Show And Share" in the Cisco WebEx Social Administration Guide. To install the certificates on Worker nodes, complete the following steps on each Worker node:


Step 1 Using your preferred method, copy the SNS certificate PEM file to the /home/admin directory on the Worker node.

Step 2 Log in to the Worker node as admin and select Drop to shell.

Step 3 Run this command:

cd /usr/java/default/lib/security/

Step 4 Import the PEM certificate file into the Java keystore by typing the following command:

sudo ../../bin/keytool -import -keystore cacerts -alias <certificate alias> -file /home/admin/<certificate filename>

where certificate alias is an arbitrary name such as the SNS server hostname; certificate filename is the name of the PEM file containing the certificate.

Step 5 When prompted, enter the keystore password: changeit

Step 6 Restart the Worker service:

service worker restart

Symptom    Email notifications about alerts and announcements stop sending out.

Possible Cause    This issue may appear after the Worker node is restarted. Alerts and announcements are then held in pending state because the main alerts/announcements job has entered an ERROR state.

Recommended Action    Take the following steps to restore the notifications:


Note The following steps are only to be taken by or under the supervision of Cisco Advanced Services.



Step 1 Log in to Oracle.

Step 2 Check in what state the triggers are by executing this Oracle statement:

select count(*) 
from worker_triggers wt
where wt.trigger_state = 'ERROR';
 
   

Step 3 If you receive more that "0" out of this step then execute the following statement to bring the triggers back to operational state:

update worker_triggers wt

set wt.trigger_state = 'WAITING'

where wt.strigger_state = 'ERROR';

Email Plug-in FAQs and Troubleshooting

Email Plug-in FAQs

Email Plug-in FAQs

Does the Cisco WebEx Social Email Plug-in log information on the user computer?

Q. Does the Cisco WebEx Social Email Plug-in log information on the user computer?

A. Yes. These are the log file locations depending on the email client:

Microsoft Outlook on Windows 7: %USERPROFILE%\AppData\Local\Cisco\WebEx Social Email Plugin\WebexSocialPluginLog.txt

Microsoft Outlook on Windows XP: %USERPROFILE%\Local Settings\Application Data\Cisco\WebEx Social Email Plugin\WebExSocialPluginLog.txt

IBM Lotus Notes: %USERPROFILE%\AppData\Local\Lotus\Notes\Data\quadlogs

Calendar FAQs and Troubleshooting

Calendar FAQs

Calendar Troubleshooting

Calendar FAQs

How do I set the log trace levels for the Calendar?

Can I switch a user from Microsoft Exchange to Lotus Domino (or vice versa)?

In what time zone are the calendar events displayed?

Q. How do I set the log trace levels for the Calendar?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties and set the Calendar category to:

ERROR for normal operation.

INFO to track cache misses. This level should be relatively safe to use for long periods of time.

DEBUG to track all calls to the cache. Avoid using this level for long periods on production environments.

TRACE if you want to see the responses from the different servers and should be used for troubleshooting purposes on a case by case basis.

When viewing logs, look for the AGGREGATED_CALENDAR log key.

Q. Can I switch a user from Microsoft Exchange to Lotus Domino (or vice versa)?

A. The described is not possible in the current release. After the user account has been configured to connect to a certain type of calendar server, it cannot be changed. In Account Settings, the user continues to see the same type of calendar server even if the administrator changes the type for the organization in Control Panel.

Q. In what time zone are the calendar events displayed?

A. The Calendar application displays events in the time zone of the browser. Server-side, all dates are accepted and returned in UTC. Date transformation to user time is performed in the browser.

Calendar Troubleshooting

This section provides the following troubleshooting information:

LDAP user cannot connect to Microsoft Exchange Server through WebDAV.

Domino users who connect through SSL cannot connect after upgrading WebEx Social.

Symptom    LDAP user cannot connect to Microsoft Exchange Server through WebDAV.

Possible Cause    (Only if "Use LDAP Directory Synchronization" is checked in the Calendar Configuration under Server > Common Configurations.) The user email address has been changed. Because WebEx Social uses the prefix of the email address to construct the WebDAV URL, the user can be prevented from connecting to Microsoft Exchange.

Recommended Action    Ask the user to complete these steps:


Step 1 Open your profile menu and click Account Settings.

Step 2 Click Calendar and WebEx login.

Step 3 Under Microsoft Exchange, change the Server URL as follows:

1. Identify your email prefix in the URL. It is the ending part starting right after the last forward slash (/). For example if your URL is http://dev.example.com/Exchange/emma.jones, "emma.jones" is your email prefix.

2. Replace your previous email prefix with your new email prefix. For example if your email prefix has been changed from emma.jones to ejones, your URL should look like this: http://dev.example.com/Exchange/ejones

Step 4 Click Test.

The connection should succeed.


Symptom    Domino users who connect through SSL cannot connect after upgrading WebEx Social.

Possible Cause    The IBM Lotus Domino SSL security certificate has been invalidated by WebEx Social.

Recommended Action    Reimport the SSL security certificate. See the Administration Guide for detailed instructions.

Symptom    I added a new attendee to a recurring meeting using Microsoft Outlook but the new name does not appear in the Calendar application in Cisco WebEx Social.

Possible Cause    There is a know issue with some versions of Microsoft Exchange Server when calendaring information is fetched over WebDAV.

Recommended Action    Use Microsoft Outlook Web Access to edit the recurring meeting instead of Microsoft Outlook.

Video Calls FAQs and Troubleshooting

Video Calls FAQs

Video Calls Troubleshooting

Video Calls FAQs

How do I check what Call Plug-in version is available on WebEx Social?

Is there a direct URL to download the Call Plug-in?

Why does the video always appear on top hiding other WebEx Social elements?

Does the WebEx Social Call Plug-in log information during installation?

Does the WebEx Social Call Plug-in log information during operation?

How do I enable JavaScript logging for the Call Pug-in?

What is the device configuration file and how do I download it?

What are the dial rules files and how do I download them?

Q. How do I check what Call Plug-in version is available on WebEx Social?

A. Open the following URL:

http://<WS base url>/plugin/cwc/CWICPluginVersion

where <WS base url> is the URL you use to access WebEx Social.

Q. Is there a direct URL to download the Call Plug-in?

A. Yes. Use this URL:

For the Windows plug-in: http://<WS base url>/plugin/cwc/CiscoWebCommunicator.exe

For the Mac plug-in: http://<WS base url>/plugin/cwc/CiscoWebCommunicator.dmg

where <WS base url> is the URL you use to access WebEx Social.

Q. Why does the video always appear on top hiding other WebEx Social elements?

A. With the intention to provide the best possible video experience to users, WebEx Social tries to use hardware acceleration when available. Because of that most other HTML elements cannot be placed on top of the video frame. Some web browsers may behave differently than others.

Q. Does the WebEx Social Call Plug-in log information during installation?

A. If you face problems when installing or uninstalling the WebEx Social Call Plug-in, locate the installation log under:

Windows 7: %USERPROFILE%\AppData\Local\Temp\WebCommunicator.LOG

Windows XP: %USERPROFILE%\Local Settings\Temp\WebCommunicator.LOG

Mac OSX: /private/var/log/install.log

Q. Does the WebEx Social Call Plug-in log information during operation?

A. If you suspect the WebEx Social Call Plug-in is not operating correctly, locate the operation log under:

Windows 7: %USERPROFILE%\AppData\Local\softphone.log

Windows XP: %USERPROFILE%\Local Settings\Application Data\softphone.log

Mac OSX: /Users/{$USER}/Library/Application Support/softphone.log

Q. How do I enable JavaScript logging for the Call Pug-in?

A. Appending "?isDebug=true" at the end of the URL in your browser allows you to view detailed operational information about the WebEx Social Call Plug-in in tools such as FireBug.

Q. What is the device configuration file and how do I download it?

A. The device configuration file is an XML file that is downloaded from the Cisco Unified Communications Manager (CUCM) by the Cisco WebEx Social Call Plug-in over TFTP. You can download is for troubleshooting purposes by pointing your browser to this URL: http://<CUCM_ Server>:6970/ecp<user screen name>.cnf.xml where CUCM server is the IP address of FQDN of your CUCM.

Q. What are the dial rules files and how do I download them?

A. The Cisco WebEx Social Call Plug-in downloads two additional files from the CUCM server that contain dialing rules. These are:

AppDialRules—Contains the rules that the plug-in applies to any phone number before making a call so that the outgoing call could have a correct and complete phone number. You can download the file by going to this URL: http://<CUCM_Server>:6970/CUPC/AppDialRules.xml

Example:

<DialRule BeginsWith="408902" NumDigits="10" DigitsToRemove="2" PrefixWith=""/>
<DialRule BeginsWith="1408902" NumDigits="11" DigitsToRemove="3" PrefixWith=""/>
<DialRule BeginsWith="408525" NumDigits="10" DigitsToRemove="3" PrefixWith="8"/>
<DialRule BeginsWith="408526" NumDigits="10" DigitsToRemove="3" PrefixWith="8"/>
 
   

DirLookupDialRules—Contains rules that are applied to a number in case of directory look-ups such as reverse look ups during an incoming call. You can download the file by going to this URL: http://<CUCM_Server>:6970/CUPC/DirLookupDialRules.xml

Example:

<DialRule BeginsWith="22101" NumDigits="10" DigitsToRemove="1" PrefixWith="2"/>
<DialRule BeginsWith="902" NumDigits="7" DigitsToRemove="0" PrefixWith="+1408"/>
<DialRule BeginsWith="8256" NumDigits="8" DigitsToRemove="1" PrefixWith="+1206"/>
<DialRule BeginsWith="8525" NumDigits="8" DigitsToRemove="1" PrefixWith="+1408"/>

Q. The dial device configuration file is an XML file that is downloaded from the Cisco Unified Communications Manager (CUCM) by the Cisco WebEx Social Call Plug-in over TFTP. You can download is for troubleshooting purposes by pointing your browser to this URL: http://<CUCM_ Server>:6970/ecp<user screen name>.cnf.xml where CUCM server is the IP address of FQDN of your CUCM.

Video Calls Troubleshooting

This section provides the following troubleshooting information:

I choose to send my video but the remote device does not display it.

Video originating from WebEx Social does not utilize the entire screen on some hardware communication devices.

Error appears when the WebEx Social Call Plug-in is trying to load: "The Call Plug-in loaded successfully but there was a problem registering your phone."

Call cannot be placed with the Cisco WebEx Social Call Plug-in.

Symptom    I choose to send my video but the remote device does not display it.

Possible Cause    A network/Internet security software on your computer is blocking the outbound connection.

Recommended Action    The security software may or may not notify you of blocked connections. In both cases the solution is to whitelist the WebEx Social Call Plug-in in your security software.

Symptom    Video originating from WebEx Social does not utilize the entire screen on some hardware communication devices.

Possible Cause    The device does not have RTCP enabled. RTCP allows devices connected to CUCM to negotiate the best possible video resolution between endpoints. The option is enabled on the WebEx Social Call Plug-in by default.

Recommended Action    In your Cisco Unified Communications Manager, ensure RTC is enabled for any devices that receives video from WebEx Social.

Symptom    Error appears when the WebEx Social Call Plug-in is trying to load: "The Call Plug-in loaded successfully but there was a problem registering your phone."

Possible Cause    Another device of the same type (Client Services Framework/ECP) has already registered onto the Cisco Unified Communications Manager (CUCM).

Recommended Action    To see if another device has registered, go to the CUCM > Device > Phone and search for ECP<username> where <username> is the screen name of the user.

The IP Address column shows the IP address from which the ECP device is currently registered. If the Status column displays "Unregistered", IP Address is the last address that have been registered with that device. If the status is Registered or the IP Address does not correspond to the last location from where you used your Cisco WebEx phone, then some other application is using the ECP device. Unregister the device and reload the Cisco WebEx Social Call Plug-in before retrying a call.

Symptom    Call cannot be placed with the Cisco WebEx Social Call Plug-in.

Possible Cause    The Cisco WebEx Social Call Plug-in cannot download the device configuration file from the CUCM. The Call Plug-in reports the following:

0x107dd0000] csf.ecc: libXML2 msg: "Namespace prefix xsi for type on device is not 
defined"
22-Jun-2012 16:12:55,207 -0700 ERROR [0x107dd0000] csf.ecc: insecureRetrieveConfig() 
file tftp://example.com/ecpapkshirs.cnf.xml requires security
22-Jun-2012 16:12:55,207 -0700 ERROR [0x107dd0000] csf.ecc.api: fetchDeviceConfig() 
could not obtain config for ecpapkshirs
22-Jun-2012 16:12:55,207 -0700 INFO  [0x107dd0000] csf.ecc.api: 
getLastTFTPServerUsed() =
22-Jun-2012 16:12:55,207 -0700 INFO  [0x107dd0000] csf.ecc.api: 
getLastCCMCIPServerUsed() =
22-Jun-2012 16:12:55,207 -0700 INFO  [0x107dd0000] csf.ecc.api: connect(eSoftPhone, 
ecpapkshirs, )
22-Jun-2012 16:12:55,207 -0700 ERROR [0x107dd0000] csf.ecc: doConnect() failed - No 
local IP address set! : eNoLocalIpConfigured

The Call Plug-in only supports unsecured devices. If the CUCM device is configured otherwise, this may prevent the Call Plug-in from downloading the device configuration file.

Recommended Action    Check if there is network connectivity between the Call Plug-in and the CUCM. Also check if the device configuration file contains this line: <capfAuthMode>0</capfAuthMode>. If the value is different than 0, then the device in CUCM has been set up as secured, which is not supported by the Call Plug-in. To remedy this, change Device > Phone > <username> > Certification Authority Proxy Function (CAPF) Information > Certificate Operation to No Pending Operation.

Search FAQs and Troubleshooting

Search Troubleshooting

Search Troubleshooting

This section provides the following troubleshooting information:

When I do a global or local search I get the "Internal Server 500" error.

When I open My Library I get the "An unexpected error occurred" message.

Symptom    When I do a global or local search I get the "Internal Server 500" error.

Possible Cause    The service is not operational.

Recommended Action    Check if the master Search Store, all slave Search Store nodes and the Index Store (if enabled) are operational. These are actions you can take:

On Search Store nodes, run this command as admin:

sudo service search status

On the Index Store node, run this command as admin:

sudo service searchcache status

Check if the Java process is running by running this command on all nodes, as admin:

sudo ps -ef | grep start.jar

Log in to the solr administrator portal page to check if solr/searchcache is up.

Possible Cause    Misconfiguration.

Recommended Action    Check if the master Search Store, all slave Search Store nodes and the Index Store (if enabled) are properly configured in portal-ext.properties on the App Server. These parameters must be set in accordance with your specific deployment:

solr.masters

solr.slave.region.1 (and other slaves if solr.slave.regions > 1)

search.cache.url

search.cache.post.url

search.cache.video.url

search.cache.social.url

search.cache.follower.url

Possible Cause    Not enough disk space.

Recommended Action    Check disk space on each Search Store machine using the "df -h" command and if the machine has run out of disk space, stop Search ("service search stop"), clean up disk space and then restart Search ("service search start").

Possible Cause    Server errors (500 Internal Server Error).

Recommended Action    If you are getting "500 Internal Server Error" in the logs (the App Server logs, the master/slave Search Store logs, or the Index Store request logs) instead of 200 status codes for each request, then the machine may be out of disk space or the indexes may be corrupt.

If the machine is out of disk space, see the "Out of disk space" Possible Cause above.

Otherwise the indexes may be corrupt. Take these corrective steps:


Step 1 First verify that the indexes are indeed corrupted. Check solr-out.log in solr\bin\logs. Indexes are most probably corrupt if the log file contains either of the following:

"lucene" error messages

Non-200 statuses of HTTP requests

Lock-related error messages such as "org.apache.solr.common.SolrException: Lock obtain timed out: SimpleFSLock"

Another symptom is to see a core or more missing in the Index Store administrator portal. There should be a total of 5 cores linked as "Admin post", "Admin video", "Admin social", "Admin follower", and "Admin autocomplete". If any of those cores is missing, chances are that it is corrupt and you should see 404 error messages in the Index Store logs for the missing core.

Step 2 After you have identified the machine that stores the corrupt indexes, log in to it as admin and stop solr:

For Search Store machines:

sudo service search stop

For Index Store machines:

sudo service searchcache stop

Step 3 Delete data directories for all cores. See Checking Where solr Indexes Reside to understand how to identify the data directories.

Step 4 Restart solr:

For Search Store machines, run this command as admin:

sudo service search start

For Index Store machines, run this command as admin:

sudo service searchcache start


Symptom    When I open My Library I get the "An unexpected error occurred" message.

Possible Cause    For possible causes and recommended actions, see When I do a global or local search I get the "Internal Server 500" error..

Health and Performance Monitoring FAQs and Troubleshooting

Health and Performance Monitoring FAQs

Health and Performance Monitoring Troubleshooting

Health and Performance Monitoring FAQs

How do I set the log trace levels for health and performance monitoring?

Q. How do I set the log trace levels for health and performance monitoring?

A. See the respective FAQ in the Analytics FAQs section.

Health and Performance Monitoring Troubleshooting

This section provides the following troubleshooting information:

I restarted monit but monitoring does not seem to be working for that node.

I do not receive health data for a node.

This error appears for some nodes "CRITICAL: STATUS integrity: status failed (1) for /var/monit/check_integrity.sh"

Symptom    I restarted monit but monitoring does not seem to be working for that node.

Possible Cause    The initialization of monit has not completed.

Recommended Action    Wait for the initialization delay of monit (about 2 minutes).

Symptom    I do not receive health data for a node.

Possible Cause    If a node is marked as "Disabled" in the Topology page on the Director, monit does not perform checks on that node.

Recommended Action    Enable the node.

Symptom    This error appears for some nodes "CRITICAL: STATUS integrity: status failed (1) for /var/monit/check_integrity.sh"

Possible Cause    This error is known to sometimes appear on new deployments on the Director's Health page. It may appear multiple times for multiple hosts and is caused by a pair of missing directories (/misc and /net), part from the autofs package, as evidenced by these log messages in the messages log:

Mar 21 12:49:26 ce2app1 integrity.sh: S.5....T.    
/opt/cisco/quad_synthetic/MonitorTest.py
Mar 21 12:49:26 ce2app1 integrity.sh: missing     /misc
Mar 21 12:49:26 ce2app1 integrity.sh: missing     /net
Mar 21 12:49:26 ce2app1 integrity.sh: (FAIL) 69.52s Verifying RPM packages -> 3 
package verification errors
Mar 21 12:49:26 ce2app1 integrity.sh: Total time elapsed: 82.72s
Mar 21 12:49:26 ce2app1 integrity.sh: Total Tests Performed: 18
Mar 21 12:49:26 ce2app1 integrity.sh: Tests Passed: 17
Mar 21 12:49:26 ce2app1 integrity.sh: Tests Failed: 1
Mar 21 12:49:26 ce2app1 integrity.sh: Compliance Rating: 94%

Recommended Action    Reinstall the autofs package on the affected nodes. Take these steps:


Step 1 Find the affected nodes' hostnames by looking at the Health page and taking note of the Host column of each occurrence of the error.

Step 2 Log in to each of the affected nodes using user admin and execute this command:

sudo yum reinstall autofs


Logs FAQs and Troubleshooting

Logs FAQs

Logs FAQs

How do I access Cisco WebEx Social logs?

What is security logging?

What message categories are defined in the security and auditing log?

What is the message format used in the security and auditing log?

I see a particular log for one day, but not another. Why is this?

I want to check a log file for a past date but the directory for that date seems to have disappeared.

Q. How do I access Cisco WebEx Social logs?

A. All logs are accessible through HTTP from the Director. Visit this URL to see them:

http://<director>/logs

Where <director> is the URL you use to access the Director web UI.

Alternatively, if you need to perform advanced actions with logs such as tracing logs in real time, log in to the Director node, go to /opt/logs and then enter the directory for the date you need.

Q. What is security logging?

A. Starting from this release, security and auditing logs have been grouped into high level security categories and consolidated into one audit.log per App Server node. In addition, the log message format has been improved to make it easier to process and aggregate.

Note, however, that you can enable debugging in the App Server logs to cause the same logging to show in the normal App Server application logs.

Q. What message categories are defined in the security and auditing log?

A. The following categories are defined:

security.auth—Authentication events related to signing in, signing out, and so on.

security.authentication—Authentication events related to signing in, signing out, and so on.

security.authorization—Authorization events, such as creating a Post, sharing a Post with a user, editing a Post, and so on.

security.admin—Changes to administrative screens, such as those on the control panel, as well as configuration changes to control panels of applications (for example: External Document Repository, Community Calendar, and so on).

security.threat—Log messages from AntiSamy (post security HTML sanitizer), CSRF mismatch token violations, and so on.

security.policy—Reserved for future use.

Q. What is the message format used in the security and auditing log?

A. The basic security event logging format is shown below. Some of the fields may be empty if they are not applicable to that event.

Date/time Date and time the message was logged.

Host Originating host.

Process Name: quad

Log Level: Is always INFO.

Category: What type of security event this is. See What message categories are defined in the security and auditing log?

Thread Name: What thread within Tomcat did the event originate in.

Principal: User account this message pertains to.

Source: Where the message comes from, for example the IP address of the system performing the action.

Component: What area is affected.

Action: What type of action is taking place on the resource.

Resource: What is being affected (for example: Post, Message Boards).

Status: Success or Failure.

Reason: Additional information.

Q. I see a particular log for one day, but not another. Why is this?

A. Logs does not show up unless that log was written to.

Q. I want to check a log file for a past date but the directory for that date seems to have disappeared.

A. To prevent the disk space from filling up, the oldest log directories are deleted when the /opt partition on the Director exceeds 85% disk usage.

Director FAQs and Troubleshooting

Director FAQs

Director Troubleshooting

Director FAQs

Enable/Disable buttons are missing for some roles on the Topology page.

What is Certificate Management?

Q. Enable/Disable buttons are missing for some roles on the Topology page.

A. Starting from this release, you do not have the option to Enable/Disable most roles. Only the App Server, Worker, and Cache roles have Enable/Disable buttons.

Q. What is Certificate Management?

A. Certificate Management is a new feature of the Director UI. Its main function is to help streamline the management and deployment of various certificates and keys used throughout Cisco WebEx Social from one centralized UI. Additionally, because the uploaded keystores/certificates are persisted as part of the Director DB, they are preserved during backup and restores.

In the current version the following functional areas are managed by Certificate Management:

WebEx Meetings SSO keystore management

WebEx Instant Messaging keystore management

Certificate Authority/Trust Certificate management, including LDAPS (LDAP over SSL), Visual Voicemail (replaces the existing Visual Voicemail keystore UI), OpenSocial, Show and Share integration (when connecting over SSL), and SharePoint integration (when connecting over SSL).

Director Troubleshooting

This section provides the following troubleshooting information:

I have uploaded a new security certificate using Application > Security but it does not seem to be taking effect.

After adding a node to the Topology page and deploying that node the node displays ERROR under Version Info ("Last config update: ERROR").

Symptom    I have uploaded a new security certificate using Application > Security but it does not seem to be taking effect.

Possible Cause    Puppet did not restart the nodes that the certificates were pushed to.

Recommended Action    Manually restart all App Server and Worker nodes.

Symptom    After adding a node to the Topology page and deploying that node the node displays ERROR under Version Info ("Last config update: ERROR").

Possible Cause    The last Puppet run has failed.

Recommended Action    Log in to the node in question as admin and run the following command before you refresh the note statuses by clicking Refresh All on the Topology page:

sudo service puppet debug

If this command doesn't bring the status to normal, try the remaining Recommended Actions.

Possible Cause    There is a significant time difference between the Director's clock and other nodes' clocks.

Recommended Action    Synchronize the clocks on all nodes (preferably to a central NTP server). Do the following:

If you have an NTP server and would like to synchronize date and time to it, configure the NTP server IP address using the Director UI. See the Cisco WebEx Social Administration Guide for details. If you have done that and the clocks are not yet synchronized, the reason might be that the time difference was too great for NTP to equalize which will be reflected in the logs in the following fashion:

Aug 21 13:49:31 ds-director ntpd[17795]: time correction of 25374 seconds exceeds 
sanity limit (1000); set clock manually to the correct UTC time.
 
   

To correct significant time differences, set the clocks manually using the date command (see next bullet).

If you don't want to use an NTP server, set the clocks manually using the date command. Take these steps:


Step 1 Log in as admin to the node whose clock you want to set.

Step 2 Run date to check the current time. This command will print both the date and the time.

Step 3 After you have verified that the clock is indeed ahead or behind, run this command to set it:

sudo date -s "DD MMM YYYY HH:MM:SS"

where DD MMM YYYY HH:MM:SS is the date followed by the time in 24-hour format. FOr example if you want to set the clock to Apr 19th 2012, 11:14:00 pm, type "19 APR 2012 11:14:00"

Or if you need to only set the time:

sudo date +%T -s "HH:MM:SS"

where HH:MM:SS is the time in 24-hour format.

After you have synchronized the clocks on all nodes, run sudo service puppet debug on all nodes that are showing ERROR on the Topology page.

Worker FAQs and Troubleshooting

Worker FAQs

Worker FAQs

What tasks are processed by the Worker role?

Q. What tasks are processed by the Worker role?

A. In the current release the following features leverage the worker framework.

Email digest generation

Outbound email processing

Metrics and reports generation

Activity feed processing

Data migration

Message Queue FAQs and Troubleshooting

Message Queue Troubleshooting

Message Queue Troubleshooting

This section provides the following troubleshooting information:

Executing "service rabbitmq-server stop" doesn't seem to stop RabbitMQ.

I removed a node from a cluster and now rabbitmq is not functioning correctly.

RabbitMQ fails to start and shows this error "ERROR: failed to load application amqp_client: {"no such file or directory","amqp_client.app"}"

On a fresh install, RabbitMQ fails to start with the following error the RabbitMQ logs: "Can't set short node name!\nPlease check your configuration\n"

Both ActiveMQ nodes appear to be running as Master.

Symptom    Executing "service rabbitmq-server stop" doesn't seem to stop RabbitMQ.

Possible Cause    The described case is a known defect.

Recommended Action    Try executing sudo killall -u rabbitmq as admin.

Symptom    I removed a node from a cluster and now rabbitmq is not functioning correctly.

Possible Cause    The described case is a known defect.

Recommended Action    As admin, stop rabbitmq on the remaining cluster nodes, then execute "rm -rf /opt/cisco/rabbitmq/data" and finally restart rabbitmq on all nodes.

Symptom    RabbitMQ fails to start and shows this error "ERROR: failed to load application amqp_client: {"no such file or directory","amqp_client.app"}"

Possible Cause    A RabbitMQ plug-in has frozen.

Recommended Action    Run the following commands as admin to reset the amqp_client plug-in:

sudo rabbitmq-plugins disable rabbitmq_management

sudo service rabbitmq-server stop

sudo service rabbitmq-server start

sudo rabbitmq-plugins enable rabbitmq_management

Symptom    On a fresh install, RabbitMQ fails to start with the following error the RabbitMQ logs: "Can't set short node name!\nPlease check your configuration\n"

Full log message:

/var/log/rabbitmq/startup_log
Activating RabbitMQ plugins ...
0 plugins activated:
 
   
{error_logger,{{2012,12,1},{0,56,34}},"Can't set short node name!\nPlease check your 
configuration\n",[]}
{error_logger,{{2012,12,1},{0,56,34}},crash_report,[[{initial_call,{net_kernel,init,['Argu
ment__1']}},{pid,<0.20.0>},{registered_name,[]},{error_info,{exit,{error,badarg},[{gen_ser
ver,init_it,6},{proc_lib,init_p_do_apply,3}]}},{ancestors,[net_sup,kernel_sup,<0.10.0>]},{
messages,[]},{links,[<0.17.0>]},{dictionary,[{longnames,false}]},{trap_exit,true},{status,
running},{heap_size,377},{stack_size,24},{reductions,180}],[]]}

Possible Cause    The RabbitMQ rpm package was upgraded and RabbitMQ was stopped or restarted before puppet could replace the configuration.

Recommended Action    Log in to the Message Queue node and then run the following commands as user admin:

sudo sed -i 's/sname/name/g' /usr/lib/rabbitmq/lib/*/sbin/*

sudo service puppet debug

This should start RabbitMQ without errors.

Symptom    Both ActiveMQ nodes appear to be running as Master.

Possible Cause    After NFS issues, the file locking required for the Master/Slave mechanism to function may not work properly, resulting in both ActiveMQ nodes running as Master at the same time. To be sure that you are experiencing this scenario, run the following command on both AMQ nodes:

netstat -an | grep 8161

You should see one of the nodes have output like this:

tcp        0      0 :::8161                     :::*                        LISTEN
 
   

If you see this on both nodes, you are running into this scenario.

Recommended Action    Take this steps:


Step 1 Ensure that access to NFS is restored and NFS is healthy.

Step 2 Stop both ActiveMQ services:

a. Log in to one of the ActiveMQ nodes and run:

sudo service monit stop

sudo service puppet stop

sudo service activemq stop

b. Log in to the other ActiveMQ node and run:

sudo service monit stop

sudo service puppet stop

sudo service activemq stop

Step 3 Having stopped both ActiveMQ services, log in to any ActiveMQ node and ensure that you do not see the following file: /mnt/auto/jms/data/kahadb/lock

If you do not see the lock file, proceed to the next step.

If you see the lock file, verify that ActiveMQ is truly stopped by taking these steps on each ActiveMQ node:

a. Run ps -ef | grep activemq

b. Take note of the PID (5441 in the example below):

activemq  5441     1  0 Nov30 ?        00:00:15 
/opt/cisco/activemq/bin/linux-x86-64/wrapper 
/opt/cisco/activemq/bin/linux-x86-64/wrapper.conf wrapper.syslog.ident=ActiveMQ 
wrapper.pidfile=/opt/cisco/activemq/bin/linux-x86-64/./ActiveMQ.pid 
wrapper.daemonize=TRUE wrapper.lockfile=/var/lock/subsys/ActiveMQ
...
 
   
...
org.tanukisoftware.wrapper.WrapperSimpleApp org.apache.activemq.console.Main start
root     26063 10937  0 00:25 pts/0    00:00:00 grep activemq
 
   

c. Run sudo kill PID where PID is the number you took note of in the previous step.

d. Run ps -ef | grep activemq again. The output should be similar to the following:

root 26063 10937 0 00:25 pts/0 00:00:00 grep activemq

Step 4 Start ActiveMQ on just one of the nodes by running the following command on that node:

sudo service activemq start

Step 5 Wait 2-5 minutes, then rerun the netstat command:

netstat -an | grep 8161

If you see the same output as above, continue with the next step.

tcp        0      0 :::8161                     :::*                        LISTEN
 
   

If not, then periodically check if the ActiveMQ process has started by running: ps -ef | grep activemq

The expected output should be similar to the following:

activemq  5441     1  0 Nov30 ?        00:00:15 
/opt/cisco/activemq/bin/linux-x86-64/wrapper 
/opt/cisco/activemq/bin/linux-x86-64/wrapper.conf wrapper.syslog.ident=ActiveMQ 
wrapper.pidfile=/opt/cisco/activemq/bin/linux-x86-64/./ActiveMQ.pid 
wrapper.daemonize=TRUE wrapper.lockfile=/var/lock/subsys/ActiveMQ
activemq  5443  5441  0 Nov30 ?        00:29:01 java -Dactivemq.home=../.. 
-Dactivemq.base=../.. -Djavax.net.ssl.keyStorePassword=password 
-Djavax.net.ssl.trustStorePassword=password 
-Djavax.net.ssl.keyStore=../../conf/broker.ks 
-Djavax.net.ssl.trustStore=../../conf/broker.ts -Dcom.sun.management.jmxremote 
-Dorg.apache.activemq.UseDedicatedTaskRunner=true 
-Dderby.storage.fileSyncTransactionLog=true -Dcom.sun.management.jmxremote.port=8002 
-Dcom.sun.management.jmxremote.authenticate=false 
-Dcom.sun.management.jmxremote.ssl=false -Dcom.cisco.ecp.Role=Messaging 
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/cisco/activemq 
-XX:ErrorFile=/opt/cisco/activemq/diagnostic-info.quadjms-crash.txt 
-XX:OnOutOfMemoryError=../../bin/quadjms_diagnostics.sh 
-XX:OnError=../../bin/quadjms_diagnostics.sh -Xms128m -Xmx4096m 
-Djava.library.path=../../bin/linux-x86-64/ -classpath 
../../bin/wrapper.jar:../../bin/run.jar -Dwrapper.key=apcwlYMEtZ4ACu7S 
-Dwrapper.port=32000 -Dwrapper.jvm.port.min=31000 -Dwrapper.jvm.port.max=31999 
-Dwrapper.pid=5441 -Dwrapper.version=3.2.3 -Dwrapper.native_library=wrapper 
-Dwrapper.service=TRUE -Dwrapper.cpu.timeout=10 -Dwrapper.jvmid=1 
org.tanukisoftware.wrapper.WrapperSimpleApp org.apache.activemq.console.Main start
root     26063 10937  0 00:25 pts/0    00:00:00 grep activemq
 
   

Step 6 After you see the above output from netstat, go to the other ActiveMQ node and start ActiveMQ:

sudo service activemq start

Step 7 Wait 2-5 minutes, then rerun the netstat command:

netstat -an | grep 8161

You should not get a return from this command. If you do, then you have run back into the issue again and you need to troubleshoot NFS to find the root cause.

Step 8 Run the following commands on both ActiveMQ nodes to restart the services stopped at the beginning of this procedure:

sudo service monit start

sudo service puppet start

Analytics FAQs and Troubleshooting

Analytics FAQs

Analytics FAQs

How do I set the log trace levels for analytics?

Q. How do I set the log trace levels for analytics?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties and set the Analytics category for the App Server and Worker roles:

ERROR for normal operation.

DEBUG to get more information.

To log events such as sending or receiving to/from Message Queue, also set the QUAD_EVENT category to DEBUG.

When viewing logs, look for the AGGREGATED_CALENDAR log key.

Be sure to restart the Worker nodes for the log level to go into effect on that role.

Analytics log messages can appear in *_appserver.log, *_worker.log, or *_analyticsmrscheduler.log.

My Library FAQs and Troubleshooting

My Library Troubleshooting

My Library Troubleshooting

This section provides the following troubleshooting information:

The My Library page does not seem to be responding to user actions: dialogs are not opening up, the Delete button does nothing, and so on.

Symptom    The My Library page does not seem to be responding to user actions: dialogs are not opening up, the Delete button does nothing, and so on.

Possible Cause    A Javascript error has occurred on the page. Possible Javascript errors include:

File not found/loaded. This type of error is displayed in red color and contains the missing file name.

Inline Javascript failure. This error occurs if Javascript code inside a .jsp file has failed and any processing of the rest of the code in the .jsp file has been halted. Example follows:

$LAB.wait() error caught:
SyntaxError: missing ; before statement

Recommended Action    Try reloading the page; if the problem persists, try loading the page with another web browser.

Framework FAQs and Troubleshooting

Framework FAQs

Framework FAQs

How do I set the log trace levels for the framework?

Q. How do I set the log trace levels for the framework?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties and set the Portal UI Framework category:

ERROR for normal operation.

DEBUG to get more information.

Streams FAQs and Troubleshooting

Streams FAQs

Streams FAQs

How do I set the log trace levels for Streams?

Q. How do I set the log trace levels for Streams?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties and set these categories:

SocialActivity Application—For general logging. Set ERROR for normal operation and DEBUG to get more information. Note that leaving the DEBUG level on significantly affects the performance of the system.

Notification—If you want to check logs for dynamic (XMPP) updates. Set ERROR for normal operation and DEBUG to get more information. Note that leaving the DEBUG level on significantly affects the performance of the system.

QUAD_EVENTING—If you still need further information (because activity creation depends on rabbitmq events). Note that turning this category to DEBUG will log every event that is occurring in WebEx Social.

UC Integrations FAQs and Troubleshooting

UC Integrations Troubleshooting

UC Integrations Troubleshooting

This section provides the following troubleshooting information:

These errors appear when the user tries to switch the Cisco Call Plug-in from computer audio to desktop phone mode: [cwic] eUnknownFailure, [cwic] Login Error, and [cwic] unregisterPhone

Symptom    These errors appear when the user tries to switch the Cisco Call Plug-in from computer audio to desktop phone mode: [cwic] eUnknownFailure, [cwic] Login Error, and [cwic] unregisterPhone

Possible Cause    The list of Unified Communications Manager (UCM) servers contains an IP address that does not correspond to a UCM server.

Recommended Action    Sign in to Cisco WebEx Social as Administrator, go to Account Settings > Server > Common Configurations > WebDialer, find the offending entry in the list of Registered UCM Clusters and correct or remove it. Use the Cisco Call Plug-in log on the user computer to identify the offending UCM entry.

WebEx Social for Office FAQs and Troubleshooting

WebEx Social for Office FAQs

WebEx Social for Office FAQs

How do I enable logging on the client machine?

How do I set the server log trace levels for WebEx Social for Office?

Q. How do I enable logging on the client machine?

A. Right-click the WebEx Social for Office icon in the Windows notification area and select Settings. Then, on the Logs tab, check Logging Enabled. These are the log file locations per OS version:

For Windows 7: %USERPROFILE%\AppData\Local\WebEx Social\Log\

For Windows XP: %USERPROFILE%\Local Settings\Application Data\Cisco\Quad for Office\Log\

Q. How do I set the server log trace levels for WebEx Social for Office?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties and set the Office API & Attachment category:

INFO for normal operation.

DEBUG or TRACE to get more information.

In addition, if Docx4j appears in any stack traces, then increase the Log4J logging level for org.docx4j.

Open API FAQs and Troubleshooting

Open API FAQs

Open API FAQs

How do I set the server log trace levels for WebEx Social for Office?

Q. How do I set the log trace levels for Open API?

A. As system administrator, go to Account Settings > Server > Server Administration > Log Properties and set the Open API category:

ERROR for normal operation.

TRACE to get more information.

OpenSocial FAQs and Troubleshooting

OpenSocial FAQs

OpenSocial Troubleshooting

OpenSocial FAQs

Are external OAuth applications supported?

Q. Are external OAuth applications supported?

A. No. OAuth applications that fetch data from external service providers (such as Twitter, Google, and Yahoo) are not yet supported.

OpenSocial Troubleshooting

This section provides the following troubleshooting information:

When adding a OpenSocial application, the application title is displayed but the application content is not visible.

Symptom    When adding a OpenSocial application, the application title is displayed but the application content is not visible.

Possible Cause    Unknown.

Recommended Action    Refresh the browser window and the contents should appear.

Synthetic Monitoring FAQs and Troubleshooting

Synthetic Monitoring Troubleshooting

Synthetic Monitoring Troubleshooting

This section provides the following troubleshooting information:

Posts created during synthetic testing are not removed.

Posts created manually using the ciscosyntheticmonitoruser are not removed.

Synthetic monitoring reports "Search Created Post Not Found" or similar search related failure.

Symptom    Posts created during synthetic testing are not removed.

Possible Cause    This issue can arise when you manually run the MonitorTest.py script with parameters "-l INFO" and then interrupt the script.

Recommended Action    Sign in to Cisco WebEx Social using the ciscosyntheticmonitoruser user, go to My Library and delete the posts manually. Another options is to rebuild the Cisco WebEx Social indexes using these steps:


Step 1 Sign in to Cisco WebEx Social using the ciscosyntheticmonitoruser username.

Step 2 Click your profile menu and select Account Settings.

Step 3 Go to Server > Server Administration.

Step 4 Click the Partial Re-indexing tab.

Step 5 Check the Post box under Information.

Step 6 Check the Use Faster Multi-Threaded approach box.

Step 7 Click the Execute button and wait for the operation to finish.

Step 8 The next run of the script should then delete the left-over posts.

Symptom    Posts created manually using the ciscosyntheticmonitoruser are not removed.

Possible Cause    The Cisco WebEx Social indexes were not updated properly.

Recommended Action    See the recommended action for Posts created during synthetic testing are not removed.

Symptom    Synthetic monitoring reports "Search Created Post Not Found" or similar search related failure.

Possible Cause    The value of the batch.manager.fetch.interval.secs advanced portal property exceeds 600 (10 min).

Recommended Action    Lower the value of batch.manager.fetch.interval.secs to below 600. The recommended value is 300 (5 min).

Using Jabber with Cisco WebEx Social FAQs and Troubleshooting

Using Jabber with Cisco WebEx Social FAQs

Using Jabber with Cisco WebEx Social FAQs

What do I need to know before I start troubleshooting Using Jabber with Cisco WebEx Social?

How do I turn on debug logging for Using Jabber with Cisco WebEx Social?

Q. What do I need to know before I start troubleshooting Using Jabber with Cisco WebEx Social?

A. Have the following in mind:

All Cisco WebEx Social does is call URLs for user-initiated outgoing chat and phone requests; the rest is handled by Cisco Jabber

Incoming chat and call request are handled entirely by Cisco Jabber

If the outgoing request reaches Cisco Jabber but it can't process it, the issue may be among the following:

The XMPP userID is invalid

The phone number is not routable in the CUCM dial plan

In either case, the issue will need to be investigated between Cisco Jabber and the chat or unified communications server.

To replicate an issue, type the URL that was used into a new browser tab and observe the outcome:

Use a tool like Firebug to find the URL (example: xmpp:user@example.com)

If Cisco Jabber doesn't launch, there is likely an issue with the default programs configuration in the OS

If the correct URL is being sent but another application launches instead of Cisco Jabber, check if your default programs configuration

Q. How do I turn on debug logging for Using Jabber with Cisco WebEx Social?

A. This feature is entirely browser-based. To enable logging, append a string to the page URL:

add ?isDebug=true if there are no other parameters in the URL

add &isDebug=true if there are other parameters in the URL

After you do that, open the browser's console and start monitoring the output.

If you want to enable Dojo logging, execute the following in the browser's console: dojo.config.isDebug=true

Chat FAQs and Troubleshooting

Chat Troubleshooting

Chat Troubleshooting

This section provides the following troubleshooting information:

A user cannot change their availability using Cisco Jabber after setting it in Cisco WebEx Social.

Symptom    A user cannot change their availability using Cisco Jabber after setting it in Cisco WebEx Social.

Possible Cause    This may happen if the session priority in the Cisco WebEx Social chat server settings has been set higher than or equal to Cisco Jabber's default session priority value (127 as of this writing).

Recommended Action    As administrator, go to Account Settings > Server > Common Configurations > Chat and lower Session Priority to below 127.