The Embotics® vCommander® Windows service logs a great deal of information, which is typically used when interacting with Embotics’ technical support. An easy way to submit logs to the technical support team is to run the Embotics vCommander diagnostics. 


Manually Managing Logging Level


You can also set DEBUG logging manually for individual components in the interest of keeping the log files current, and at a manageable size.

  1. On the Embotics vCommander application server, open the referenced file path (example: C:\Program Files\Embotics\vCommander\tomcat\common\classes\log4j.properties or C:\Program Files\Embotics\vCommander\authservice\common\classes\log4j.properties) using a text editor such as Notepad.
  2. Add the debug statement from those listed below to the end of the file, making sure that there are no spaces preceding or trailing. Use lines only as directed by support to avoid increasing logging beyond the scope of what is needed to investigate your issue. Also, add rem statements before the lines with your own details. 


Example: C:\Program Files\Embotics\vCommander\tomcat\common\classes

# silence apache cxf INFO messages (too verbose)

# safe to leave on

log4j.logger.org.apache.cxf=ERROR
 
# Troubleshooting mediator issues 

# Remove or comment out when done testing.

log4j.logger.observation=DEBUG
log4j.logger.com.embotics.vlm.service.request=DEBUG
log4j.logger.com.embotics.vlm.service.server.mediator=DEBUG
 

# logging for guest os commands like run program etc..

log4j.logger.osscanner=DEBUG


There’s no need to restart the vCommander Windows service when making these changes.

Feature
Line
Active Directory and LDAP
(vCommander 6.x)
File to modify:
\Embotics\vCommander\authservice\common\classes\log4j.properties
Line to add:  
log4j.logger.com.embotics.authservice.service.security.userdirectory=DEBUG
Active Directory and LDAP
(vCommander 5.x)


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.security.userdirectory=DEBUG
Capacity


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.capacity=DEBUG
Costing


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:  
log4j.logger.com.embotics.vlm.service.cost=DEBUG


Destinations


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.destination=DEBUG


Events Processing


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Lines to add:
log4j.logger.eventdistribution=DEBUG
log4j.logger.EventProducerExecutor=DEBUG
log4j.logger.EventStats=DEBUG
log4j.logger.com.embotics.vlm.service.event=DEBUG

Fencing


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.fencing=DEBUG
Guest OS Customizations


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.server.mediator=DEBUG


Guest OS Interaction


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.osscanner=DEBUG
IP Pooling


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.network=DEBUG
Login Session Security
(vCommander 6.x)


File to modify:
\Embotics\vCommander\authservice\common\classes\log4j.properties
Line to add:
log4j.logger.com.embotics.authservice.service.security=DEBUG
Login Session Security
(vCommander 5.x)


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.security=DEBUG
Method Timing


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.MethodTiming=DEBUG
Observation Processing


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.observation=DEBUG
Observation Timing


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.observation.timing=DEBUG
Organization Management


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.organization=DEBUG
Policies


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.policy=DEBUG
Policy Execution


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.ruleengine.timing=DEBUG
Policy Modification


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.ruleengine=DEBUG
Recommendations


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.ruleengine.timing=DEBUG
Report Generation


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.reports.type=DEBUG
Reporting Service


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.reports=DEBUG
Run Program / Scripting (Private Cloud)


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.task.a.e=DEBUG
log4j.logger.com.embotics.vlm.service.objectmodel=DEBUG
log4j.logger.com.embotics.vlm.service.request=DEBUG
log4j.logger.com.embotics.vlm.service.workflow=DEBUG

Run Program / Scripting (Public Cloud)


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.controller.task=DEBUG
log4j.logger.com.embotics.vlm.controller.task.gd=DEBUG

Service Requests


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.request=DEBUG
SMTP integration


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.smtp=DEBUG
Single Sign-on


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.org.springframework.security.web=DEBUG
log4j.logger.org.springframework.security.saml=DEBUG
log4j.logger.com.embotics.vlm.portal.saml=DEBUG

Tasks Detail
File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.task=DEBUG
Tasks Subsystem
File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.controller.task=DEBUG
VM Naming
File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.objectmodel=DEBUG
VMM Interactions
File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.server.mediator=DEBUG
Workflows


File to modify:
\Embotics\vCommander\tomcat\common\classes\log4j.properties 
Line to add:
log4j.logger.com.embotics.vlm.service.workflow=DEBUG





In Vcommander Version 7