How do you reconnect a previously failed machine to Emsada?

If for example a PC or server fails due to Windows or Linux being corrupt, you may want to reinstall the OS on the PC or server. When you install the Emsada agent on the newly installed OS it will not connect as the Emsada server will detect that it is a duplicate machine attempting to impersonate a new agent.

If this occurs and you want to connect the agent back up to its account you need to do the following:

1. Open the Agent List tab from the Main Menu
2. Find the original agent in the list
3. Right-click the agent and then click Generate Agent Config File
4. This will download the agent configuration file from the server ready for you to upload it to the newly installed OS
5. Stop the Emsada agent service on the newly installed OS
   • Use command net stop "Emsada Agent" for Windows or sudo systemctl stop EmsadaAgent for Linux
6. Save the config file on the newly installed agent in C:\Program Files\Emsada\Agent\appSettings.config for Windows or /opt/Emsada/Agent for Linux
7. Start the Emsada agent
   • Use command net start "Emsada Agent" for Windows or sudo systemctl start EmsadaAgent for Linux
8. Check the Emsada console. The agent should now be connected back to its original account.

If instead you would rather this agent started as new you need to do the following:

1. Navigate to the Agents tab in the left-hand pane
2. Find the original agent in the list
3. Right-click the agent and then click Delete Agent
   • NOTE: This will delete any history this agent had with Emsada
4. Now restart the agent on the newly installed OS
   1. Use command net stop "Emsada Agent" for Windows or sudo systemctl stop EmsadaAgent for Linux
   2. Use command net start "Emsada Agent" for Windows or sudo systemctl start EmsadaAgent for Linux
5. Check the Emsada console. The agent should now appear as a new agent.