Troubleshooting - Agent deployment
You may encounter problems with ERA Agent deployment. If deployment fails, there are a number of things that might be the cause. This section will help you:
oFind out what caused ERA Agent deployment to fail
oCheck for possible causes according to the table below
oResolve the issue and perform a successful deployment
1. To find out why Agent deployment failed, navigate to Reports > Automation, select Agent Deployment task information in last 30 days and click Generate now.
If you need even more details, you can change the verbosity of the ERA Server trace log. Navigate to Admin > Server Settings > Advanced Settings > Logging and select Error from the drop-down menu. Run the Agent deployment again and when it fails check the ERA Server trace log file for the latest log entries at the bottom of the file. The report will include suggestions about how to resolve the issue.
The latest file can be found here:
To enable full logging, create a dummy file named traceAll without an extension in the same folder as a trace.log. Restart the ESET Remote Administrator Server service, this will enable full logging into trace.log file.
2. The table below contains several reasons Agent deployment can fail:
3. Follow the appropriate troubleshooting steps according to the possible cause:
•Client is not reachable on the network - ping the client from the ERA Server, if you get a response, try to log on to the client machine remotely (for example, via remote desktop).
•Client's host name could not be resolved - possible solutions to DNS issues can include but are not limited to:
oUsing the nslookup command of the IP address and hostname of the server and/or the clients having Agent deployment issues. The results should match the information from the machine. For instance, an nslookup of a hostname should resolve to the IP address an ipconfig command shows on the host in question. The nslookup command will need to be run on the clients and the server.
oManually examining DNS records for duplicates.
•Firewall blocks communication - check the firewall settings on both the server and the client, as well as any other firewall that exists between these two machines (if applicable).
•Ports 2222 and 2223 are not open in firewall - same as above, make sure that these ports are open on all firewalls between the two machines (client and server).
•No password set for administrator account - set a proper password for the administrator account (do not use a blank password)
•Insufficient access rights - try using the Domain Administrator's credentials when creating an Agent deployment task. If the client machine is in a Workgroup, use the local Administrator account on that particular machine.
•To activate the Administrator user account:
1.Open an administrative command prompt
2.Enter the following command:
net user administrator /active:yes
•ADMIN$ administrative share is not available - The client machine must have the shared resource ADMIN$ activated, make sure it is present among the other shares (Start > Control Panel > Administrative Tools > Computer Management > Shared Folders > Shares).
•IPC$ administrative share is not available - verify that the server can access IPC$ by issuing the following from a command prompt on the server:
net use \\clientname\IPC$ where clientname is the name of the target computer
•Use simple file sharing is enabled - if you are getting the Access denied error message and your environment is mixed (contains both a Domain and Workgroup), disable Use simple file sharing or Use Sharing Wizard on all machines that are having problems with Agent deployment. For example, in Windows 7 do the following:
oClick Start, type folder into the Search box, and then click Folder Options. Click the View tab and in the Advanced settings box, scroll down the list and deselect the check box next to Use Sharing Wizard.
•Link to the repository is incorrect - In ERA Web Console, navigate to Admin > Server Settings, click Advanced settings > Repository and make sure the URL of the repository is correct.
•Package not found in repository - this error message usually appears when there is no connection to the ERA repository. Check your Internet connection.
Linux and Mac OS
If Agent deployment does not work on Linux or Mac OS, the issue is usually related to SSH. Check the client computer and make sure SSH daemon is running. Once fixed, run Agent deployment again.