Restoring a deleted agent on a SaaS system

Products

• Automic SaaS

Issue/Introduction

If an agent is accidently deleted or after being deleted is determined to still be necessary, what are the options to re-install the agent?

Environment

AE: SaaS

Resolution

The following steps can be taken.  Please note these are for a 24.5 system and installation options may change in future version.

Check the Recycle Bin

1. Log into Client 0 as an administrative user
2. Go to the Process Assembly perspective and find the "Recycle Bin" on the left hand side - click on this
3. Look for an object with the agent's name plus some additional numbers after.  For example, if the agent was originally called AGENT_LNX_99532, it may now have a name like AGENT_LNX_99532_0000100873
4. Right-click this object and choose "Restore"
5. You should now be able to start the agent as normal

If the agent is not in the recycle bin, the following can be used - please note this is for a linux agent and the instructions may vary for other agents:

Create the agent in client 0

1. Log into client 0
2. Go to the administration perspective --> Agents & Groups --> Agents
3. Use the "Add Agent" button to add a UNIX agent
4. Give it the name that the agent originally had

Agent files still exist on the server

1. Assuming the agent files still exist on the server, right-click the agent, go to Authentication Options and "Download Key" - this will download a file called "package"
2. Transfer this file to the agent server and put it into the agent's /bin directory
3. Change the name of the package file to package.txt
4. Confirm the following line is in the agent ini file, if it is not, update it to this:
   
   initialPackage=package.txt
   
   
5. Start the agent on the server
6. In client 0, go to the administration perspective --> Agents & Groups --> Agents
7. Right-click the agent, chose "Authentication Options" and then "Authenticate Agent"
   
   You should see the agent in the agent list now.
   
   
8. Open the agent definition from the list by double-clicking or right-clicking and choosing "Open"
9. Assign Authorization rights as needed to the clients

Agent files do not exist on server

1. If the agent files no longer exist on the agent server, you'll need to re-install as you would a new agent.  Right-click on the the agent agent and choose "Download Agent" - choose the settings you would like if you need the service manager and/or jre included.
2. Click Download - this will download the agent as a .zip file
3. Transfer this file to the agent server and unzip the files into the directory you'd like to
4. Update the binary owner and permissions
5. Start the agent on the server
6. In client 0, go to the administration perspective --> Agents & Groups --> Agents
7. Right-click the agent, chose "Authentication Options" and then "Authenticate Agent"
   
   You should see the agent in the agent list now.
8. Open the agent definition from the list by double-clicking or right-clicking and choosing "Open"
9. Assign Authorization rights as needed to the clients