How to enable/collect logs on WEM Broker

How to enable/collect logs on WEM Broker

book

Article ID: CTX228742

calendar_today

Updated On:

Description

Enable logging on WEM Broker servers


Instructions

TYPES OF LOGS AVAILABLE:
FOR LOGGING INFORMATION RELATING TO WEM AGENTS, SEE CTX220635
There are a number of logs that can be collected from the WEM Broker to help with troubleshooting/diagnosing an issue

A:  WEM Infrastructure Broker Service issues:
#1:  WEM Infrastructure Broker Event logs
These logs are created be default in Event viewer.  This event viewer log is where the Infrastructure Broker Service will log all basic errors.

a:  Norskale Broker Service
This log can be found inside Event Viewer under the "Applications and Services logs" section.

#2:  WEM Infrastructure Debug Log
This log must be manually enabled for the WEM Infrastructure Broker Service. 

a:  Citrix WEM Infrastructure Service Debug.log
To enable Debug logging for the Infrastructure Broker Service, go to the "Advanced Settings" tab in the Infrastructure Broker Service Configuration console (a/k/a "WEM Infrastructure Service Configuration Utility"), tick the “Enable Debug Mode” checkbox & click "Save Configuration".

#3:  WCF Trace:
This WCF trace must be manually configured and is normally helpful when there is a communication issue which involves the WEM Broker. 

a:  Norskale Broker Service.exe
 

B:  WEM Console issues:
This is the main log for the WEM Administration Console; If the WEM Administration Console is erroring out, this log will likely contain the cause of the error.  This log is NOT enabled by default.

#1:  Citrix WEM Console Trace.Log:
To enable verbose logging (debug mode), open the WEM Administration Console, click on the "Options" tab in the top ribbon, tick the “Enable Debug Mode” checkbox & click "Apply".

#2:  WCF Trace
This WCF trace must be manually configured and is normally helpful when there is a communication issue between any WEM Console and the WEM site/database. 

a:  Norskale Administration Console.exe


C:  WEM Database issues:
This log is created whenever the Database Management Console/Utility attempts a database creation or upgrade & logs all errors pertaining to those operations.

#1:  Citrix WEM Database Management Utility Debug Log.log:
This log is created by default and is located in the following default location:  "C:\Program Files (x86)\Norskale\Norskale Infrastructure Services"





 

 HOW TO IMPLEMENT AND GATHER LOGS:

A:  WEM Infrastructure Broker Service issues:

#1:  WEM Infrastructure Broker Event logs
***Created by default during normal WEM Broker operations***

Filename:  Norskale Broker Service
Location:  Event Viewer >> "Applications and Services Logs"

#2:  WEM Infrastructure Debug Log
***Must be manually enabled***

            Filename:  Citrix WEM Agent Host Service Debug.log
            Location:  “%PROGRAMFILES(X86)%\Norskale\Norskale Agent Host”

#3:  WCF Traces:
***Must be manually enabled***

a:  Norskale Broker Service
Filename:  NorskaleInfrastructureBrokerService-Traces.svclog
Location:  "C:\Trace"          

#1:  Stop the "Norskale Infrastructure Service".

#2:  Make a backup copy of the “Norskale Broker Service.exe.config” file located in the default location of “%PROGRAMFILES(X86)%\Norskale\Norskale Infrastructure Services”.

#3:  Using Notepad or Wordpad, edit the original .config file adding the multiple lines of code from the attached document named "Norskale Infrastructure Broker Service.txt" to the file.  Paste the code into the file starting on the 2nd line just after the <configuration> marker, then save the file.

#4:  Create a directory on the root of the C: drive called “trace” if one does not already exist.

#5:  Start the "Norskale Infrastructure Service".

Here are contents of the attached file:

User-added image

 

B:  WEM Console issues:

#1:  WEM Console Debug Log
***Must be manually enabled***

            Filename:  Citrix WEM Console Trace.log
            Location:  “%userprofile%”

a:  Citrix WEM Console Trace.Log

#1:  To enable verbose logging (debug mode), open the WEM Administration Console, click on the "Options" tab in the top ribbon, tick the “Enable Debug Mode” checkbox & click "Apply".

#2:  Launch the WEM Administration Console

#2:  WCF Trace:
***Must be manually enabled***

a:  Norskale Broker Service
Filename:  WEMConsole-Traces.svclog
Location:  "C:\Trace"          

#1:  Close the WEM Administration Console if open.

#2:  Make a backup copy of the “Norskale Administration Console.exe.config” file located in the default location of “%PROGRAMFILES(X86)%\Norskale\Norskale Administration Console”.

#3:  Using Notepad or Wordpad, edit the original .config file adding the multiple lines of code from the attached document named "WEM Administration Console.txt" to the file.  Paste the code into the file starting on the 3rd line just after the <configuration> marker, then save the file.

Here are contents of the attached file:

User-added image

#4:  Create a directory on the root of the C: drive called “trace” if one does not already exist.

#5:  Launch the WEM Administration Console and connect to the WEM site, reproduce issue & close the console to write the logs.

C:  WEM Database issues:
#1:  Citrix WEM Database Management Utility Debug Log.log:
***Created by default when performing any database creation/upgrade from the WEM Broker server***

Filenames:  Citrix WEM Database Management Utility Debug Log.log
Location:  “%PROGRAMFILES(X86)%\Norskale\Norskale Infrastructure Services”

****REVERT ALL CHANGES AFTER COLLECTING THE APPROPRIATE LOGS****

FOR LOGGING INFORMATION RELATING TO WEM AGENTS, SEE CTX220635