Generating Server-side Logs to Troubleshoot On-premise Connect Deployments
In order to diagnose unexpected behavior within Adobe Connect, it may be necessary for the Adobe Connect Support team to examine server-side logs from an on-premise Connect deployment. The logs directory is located in the Connect (or Breeze – it is not uncommon for Connect upgrades to reside in legacy Breeze directories) directory:
Within the logs directory there are sub-directories containing various logs:
The most commonly requested log by the support team, is the debug.log. It can be found in the logs>support directory. With the services running, the current debug log will appear without a date at the top of the debug.log file list. The default rollover is 12 hours generating AM and PM logs each day:
In order to make the debug.log file more useful for purposes of diagnosis, you can enable verbose logging by adding entries to the custom.ini file located in the Connect or Breeze version sub-directory. Here you see it located in a 9.3.1 directory under the Breeze root installation/upgrade directory:
Before editing the custom.ini file, be sure to create a backup copy of it. Add the following lines in order to enable verbose logging:
Note that for versions of Connect 9.2 and prior, use yes instead of true:
Save the custom.ini file (be careful not to accidentally change the file type to .txt) and during a scheduled maintenance window, cycle the Connect and AMS/FMS services in order to load the changes and begin verbose logging (note this will bring Connect down while the services cycle):
There are occasions when it may be prudent to provide more than one log for a more complete diagnosis. To provide a full sample of the various Connect logs without sending a massive historical sample of log files, you may simply stop the Connect services (during scheduled downtime as this will bring down Connect) and rename the entire log directory to log.old. Then upon starting the services back up, recreate the issue being diagnosed and then stop the services.
This activity will generate a new small log directory isolating the issue under scrutiny that you just reproduced in Connect: Zip/compress this new abbreviated log directory with all its fresh abbreviated sub-directories and provide it to the the Adobe Connect Support team to help expedite more exhaustive server-side log analysis. This option is particularly helpful when examining a cluster as each server will have a set of logs. When providing cluster logs, always label each compressed log folder to easily identify the server from which it came.
Note that often when diagnosing unexpected behavior in Adobe Connect Meetings, it may also be prudent to enable client-side Connect addin verbose logging as well. The relevant client-side logging tech-notes are here:
To diagnose issues with a specific Meeting, comparing the addin log with the server-side Meeting application logs is often helpful. The server-side logs for a specific Meeting are listed by the Meeting sco in the logs: logs\support\access\_default\Host_\meetingas3app\7\1234567(meeting-sco)
To identify the appropriate Meeting sco ID, simply append ?mode=xml to any Meeting URL and scroll down on the page to the xml output.
Other helpful logs may include: access.log, breeze.log, error.log and gc-123456.log. These are all found in the root log folder. Simply choose the appropriate date of the occurrence under scrutiny.
In logs\support\diagnostic, the appropriate admin.log, core.log, edge.log and master.log may be helpful.
In logs\support\access, there are additional access logs that may be helpful.