{"id":2113,"date":"2013-12-12T13:28:22","date_gmt":"2013-12-12T13:28:22","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudioalm\/2013\/12\/12\/how-to-debug-release-management-components\/"},"modified":"2019-02-14T17:54:05","modified_gmt":"2019-02-15T01:54:05","slug":"how-to-debug-release-management-components","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/how-to-debug-release-management-components\/","title":{"rendered":"How to debug Release Management components"},"content":{"rendered":"

 <\/font><\/span><\/b><\/p>\n

Enable logs on Microsoft Deployment Agent:<\/font> <\/font><\/b><\/p>\n

<\/strong><\/p>\n

<\/strong><\/p>\n

The first and most easy way to debug why an action\/component is failing is to open the logs available through the deployment step of your release within Release Management (RM) client. To do this, open your release, access the View Log<\/b> section, click on the Details<\/b> button of the deployment step that failed and requires debugging. <\/p>\n

If that step does not provide enough information about the error follow these steps: <\/p>\n


Option A:<\/strong><\/p>\n

If identity running the Deployment Agent service is a \u201cService User\u201d in RM: <\/p>\n

\n

1.   In Windows Services, stop the Microsoft Deployment Agent Service<\/p>\n

2.   Run the DeploymentAgent.exe located in %Program Files(x86)%\\ Microsoft Visual studio 12.0\\Release Management\\bin with \u201cdebug\u201d option from command line. (DeploymentAgent.exe debug start)<\/p>\n

Or<\/strong><\/p>\n<\/blockquote>\n

Option B:<\/strong><\/p>\n

\n

1.      Access the deployer machine. We first need to edit the configuration file in order to output more deployment information to log file. Find the configuration file under %Program Files(x86)%\\ Microsoft Visual studio 12.0\\Release Management\\bin. Backup the Deploymentagent.exe.config file.<\/p>\n

2.      Edit the following section of Deploymentagent.exe.config file. By default the tracing is enabled and logging is set to error. Change logging to filter=\u201dVerbose\u201d to get more detailed level logging.<\/p>\n<\/blockquote>\n

\n
\n
<<\/span>loggingConfiguration<\/span> name<\/span>="Logging Application Block"<\/span> tracingEnabled<\/span>="true"<\/span><\/font> defaultCategory<\/span>="General"<\/span> logWarningsWhenNoCategoriesMatch<\/span>="true"<\/span>><\/span>
...
    <<\/span>listeners<\/span>><\/span>
        <<\/span>add<\/span> name<\/span>="Rolling Flat File Trace Listener"<\/span>        
                   formatter<\/span>="Single Line Text Formatter"<\/span>        
                   traceOutputOptions<\/span>="None"<\/span>        
                   filter<\/span>="Error"<\/span><\/font>        
                   fileName<\/span>="%TEMP%\\Microsoft\\ReleaseManagement\\12.0\\Logs\\DeploymentAgent.log"<\/span><\/font>        
                   rollSizeKB<\/span>="5000"<\/span>        
                   rollFileExistsBehavior<\/span>="Increment"<\/span>        
                   timeStampPattern<\/span>="yyyy-MM-dd"<\/span>        
                   type<\/span>="Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.RollingFlatFileTraceListener, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"<\/span>
                   listenerDataType<\/span>="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.RollingFlatFileTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"<\/span> \/><\/span>
    <\/<\/span>listeners<\/span>><\/span>
...
<\/<\/span>loggingConfiguration<\/span>><\/span><\/pre>\n<\/p><\/div>\n<\/blockquote>\n
\n
3.      Save the Deploymentagent.exe.config file.<\/p>\n
5.      In Windows services. Restart the windows service \u201cMicrosoft Deployment Agent\u201d.<\/p>\n
6.      Reproduce the failing deployment, detailed logs will get generated under the TEMP directory of the user the \u201cDeployment Agent\u201d running as. For e.g.<\/p>\n