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.
- 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.
- 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=DEBUGThere’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 |