Install Linux Agent Manually

The SSH port (port 22) should be open on the computers where the agent needs to be installed.  

1. Download the Endpoint Central Agent from Admin > Discovery > Agent Configuration > Download Linux Agent.
   
2. Go to the terminal as a root user.
   
1. If you are not logged in as a root user, open the terminal and use the sudo command to perform the operations. Enter the password whenever prompted. This provides you with the root privilege.
   
3. Navigate to the location where the agent is downloaded and unzip the folder DCLinuxAgent.zip by using the command unzip -e DCLinuxAgent.zip.
   
4. Ensure that the files DesktopCentral_LinuxAgent.bin and serverinfo.json are located in the same path.
   
5. Execute the command, chmod +x DesktopCentral_LinuxAgent.bin as a root user. This prepares the file for execution.
   
6. Run the Installer using the command ./DesktopCentral_LinuxAgent.bin. The agent will be installed by default in the /usr/local/desktopcentralagent directory.
   
7. If you want to change the installation location of the agent, use this command: ./DesktopCentral_LinuxAgent.bin -d
   

 
Install Linux Agent using Linux Agent Installation Tool

This method deploys agents on multiple computers

1. In  AssetExplorer, go to Admin > Discovery > Agent Configuration > Download Linux Agent.
   
2. Download and extract the Linux Agent Push Installation tool.
   
3. Extract the Linux agent installer file which was downloaded in step 1 and copy the Linux Agent binary and serverinfo.json files to the Linux_Agent_Push_Installation_tool folder.
   
4. Execute LinuxAgentPushInstaller_32bit.exe and choose the preferred installation mode from the options displayed.
   

1. To install agents using computers.csv, enter the hostname and optionally, the agent installation directory in the sample computers.csv file that has been provided in the Linux_Agent_Push_Installation_tool folder. For example:

A comma (,) is needed after the hostname and there should be an empty line at the end.

When the agent installation directory is left empty, the agent will be installed in the default agent installation directory under /usr/local/. 

1. To install agents using SSH Keys,
   
1. Configure SSH Keys on the client machines.
   
2. For push installation from a Windows machine, make sure the public key is added to the authorized_keys file on the agent machines. By default, the private key in the current user's home directory will be used. If you want to use a different key, provide the full path to the private key when prompted. If the private key is encrypted, enter the password; otherwise, leave it empty.
   
3. If the user is a Linux sudo user,  enable the NOPASSWD option for in sudoers. However, this is not necessary if you are installing using the root user.
   
2. To install agents using the IP range, use only the supported IPv4 ranges. The end IP should be included in the range.
   
3. To install the agent using the SSH port, the default port used is 22. If you want to use a different SSH port, you can specify it as an argument when using the tool.
   

Image a Linux Computer with an Endpoint Central Agent

1. Install the Endpoint Central agent on the computer.
   
2. Download LinuxOSImager on the machine.
   
3. Open the terminal as a sudo user and run the following command to stop the Endpoint Central agent service: dcservice -p 
4. Navigate to the location where LinuxOSimager is stored using the command chmod +x LinuxOSImager. This prepares the file for execution.
   
5. Run the following command to mark the machine as Imaged: ./LinuxOSImager set 
6. Run the following command in order for the agent to establish contact with the Endpoint Central Server: ./LinuxOSImager reset 
7. Restart the Endpoint Central agent service by running the following command: dcservice -t & 

1. Deploy the OS image on the new machine.
   
2. Rename the new machine.
   
3. Restart the machine or open the terminal and run the command dcconfig refresh as the root user.
   

Stopping Endpoint Central Agent Service on Client Machines

1. Navigate to Tools on the Endpoint Central server.
   
2. Choose System Manager.
   
3. Select the computer on which you want to stop the service and click Manage.
   
4. Under the Services tab, select ManageEngine Endpoint Central > Agent.
   
5. Go to Actions and click Stop to halt the Endpoint Central agent service. 

Uninstall Endpoint Central Agents from Linux

1. Go to the terminal as a root user.
   
2. If you do not log in as a root user, open the terminal and use the sudo command to perform each operation mentioned below. Enter the password whenever prompted. This provides you with the root privilege.
   
3. Execute this command ./RemoveDCAgent.sh to uninstall the agent
   
4. Navigate to the location where the agent is installed on the terminal and execute the following command: chmod +x RemoveDCAgent.sh 

You need to have root privilege to uninstall the agent.