Manual Agent Deployment
  • 20 Nov 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Manual Agent Deployment

  • Dark
    Light
  • PDF

You can manually deploy the SysAid Agent to any machine you choose. This includes Windows, Linux, and Mac computers. Go to Settings > Network Discovery > Downloads, and select Download SysAid agent for the operating system of your choice.

Manually Install the SysAid Agent for Windows

There may be some cases where none of the other deployment methods are suitable for deploying the agent to a particular computer. In these cases, you may install the agent manually. 

To manually install the SysAid agent to a Windows computer

  1. Open SysAid and go to Settings > Network Discovery > Downloads.
  2. Choose Download SysAid Agent for Windows. This allows you to save the installer file locally on the computer you would like to install to.
  3. Run the SysAidAgent.exe on the computer you are installing to. This opens the installer.
  4. The installer will prompt you for your server details. Enter these as they are found under Settings > Network Discovery > Downloads. If this computer is behind a proxy server, choose Yes for "Use Proxy Server:" and fill out the proxy server details. Then click Next.
    Note

    If the "Allow only SSL connections to SysAid (https)" check box is checked in Account Defaults, make sure your URL includes the relevant https prefix.

  5. Enter the account information for your SysAid server
    GuideDeploymentfilesAgentaccountinfoAgentaccountinfo.jpg
  6. Choose the installation directory for the SysAid agent, and click Next. It's recommended to use the default directory.
  7. You now see the install confirmation page. Verify the information you've entered, and then click Next to install the agent.
  8. The Agent is now installed. Click Finish to close the installer.

Manually Install the SysAid Agent for Linux

This SysAid agent supports Linux systems that use rpm (Red Hat, CentOS, Fedora, etc) or dpkg (Debian, Ubuntu, etc) package managers. If your distribution doesn’t support either, please contact SysAid support.
To run the agent, simply extract the sysaid-agent-linux.tar.gz into a directory where it should stay. 

The script needs to get three parameters in the following order: 

  • ServerURL 
  • AccountID 
  • Serial
    Run the script with the full path with the mentioned parameters. E.g.:
/var/lib/sysaid-agent-linux/sysaid-linux.sh http://192.168.1.10:8080 Acme A1B2C3D4E5F6G7H8

Prerequisites for installing the Linux agent

  • Root permissions - script should be run as root
  • Ishw B.02.16 & wget packages are required on the Linux machines
Start the script daily for updates
The script is not installed as a service. Updates from SysAid server are received upon restarting it. We recommend adding the script as a cron job, running on a daily basis.

Manually Install the SysAid Agent for Mac

There may be some cases where none of the other deployment methods are suitable for deploying the agent to a particular computer. In these cases, you may install the agent manually. 

To manually install the SysAid Agent to a Mac computer:

  1. Open SysAid and go to Settings > Network Discovery > Downloads.
  2. Choose Download SysAid Agent for Mac. This allows you to save the installer file locally on the computer you would like to install to.
  3. Locate the .pkg file that you just downloaded and double-click it to deploy the agent.
    1. If you see the following error message "'SysAidAgentInstaller.pkg' can't be opened because Apple cannot check it for malicious software", navigate to Preferences > Security & Privacy, and click Open Anyway.
      GuideDeploymentfilesOpenAnywayOpenAnyway.png
    2. When the app opens, click Continue.
      GuideDeploymentfilesErrorMessage3.png
  4. To configure the agent and complete the installation, in Applications, select SysAid Settings.
  5. Enter the Server Details as they are displayed in Settings > Network Discovery > Downloads. If you are using a proxy or an RDS, enter the proxy or RDS information.
  6. Select a log level.
  7. Click Save.
    GuideDeploymentfilesMacAgentConfiguration.jpg

Was this article helpful?