Add a Computer by Installing the DSUA Agent

Install the DSUA agent on the computer to connect and to monitor the system.

Before you begin, check the following prerequisites:
  • ensure that the user credential is available in the server as it will be authenticated using SSH to the server IP address used at the time of installation
  • ensure that the port 32443 is open and available for all the communication from DSUA portal and the system
  • installation must be done as root or as a user with sudo permission
  • ensure Powershell command line tool is installed on the computer with administrator privileges
  1. Click Computers tab.
  2. Click Add New Computer
    Figure 1. Add New Computer


    The Add New Computer screen is displayed.
    Figure 2. Add New Computer - Instructions


    The Add New Computer screen provides the following options to install the agent:
    • Mass deploy the DSUA Agent across the Organization.
    • Download and install the DSUA Agent on a Machine.
  3. Follow the instructions to install the agent as per your requirement.

Deploy the DSUA Agent across the Organization

Deploy the DSUA agent across the organization to monitor the system and the packages.

Before you begin, check the following prerequisites:
  • ensure that the user credential is available in the server as it will be authenticated using SSH to the server IP address used at the time of installation
  • ensure that the port 32443 is open and available for all the communication from DSUA portal and the system
  • installation must be done as root or as a user with sudo permission
  • ensure Powershell command line tool is installed on the computer with administrator privileges

Get the Mass Desployment Artifacts (For example, mass_deploy_windows_dsua_agent.zip) from the DSUA portal.

The zip file contains the following:
  • mass_deploy_windows_dsua_agent.zip - configuration file required to be installed on each of the system.
  • credentials.txt - add the administrator user name and password in this file who is going to install the agent.
  • mahines.txt - add the individual machine IP address one below the other where the DSUA agent is going to be installed.
  • mass_dsua_agents_installer.ps1 - powershell script to be run on the server.

Copy the mass deployment artifacts zip file to the server where it has to be installed.

  1. Login to the server as a root or as a user with sudo permission where DSUA agent is to be installed.
  2. Navigate to the location where the mass deployment artifacts zip file is copied.
  3. Unzip the mass deployment artifacts zip file.
  4. Add the administrator user name and password in credentials.txt file.
    For example, 
    username=ENTER_USERNAME
password=ENTER_PASSWORD
  5. Add the machine IP address in machines.txt file where the DSUA agent must be installed.
    For example,
    MACHINE_IP_ADDRESS
MACHINE_IP_ADDRESS
MACHINE_IP_ADDRESS
MACHINE_IP_ADDRESS
  6. Open Powershell at the extracted location of the artifacts.
  7. Run mass_dsua_agents_installer.ps1 script using the command: 
    powershell.exe -ep RemoteSigned .\mass_dsua_agents_installer.ps1
    The DSUA agent will be installed on all the machines which is specified in the machines.txt file.
    The DSUA portal will display the machines where the DSUA agent is installed.
    Figure 3. DSUA Agent Installed Computers


Install the DSUA Agent on a Machine

Download and install the DSUA agent on a machine to monitor the packages.

Before you begin, check the following prerequisites:
  • ensure that the user credential is available in the server as it will be authenticated using SSH to the server IP address used at the time of installation
  • ensure that the port 32443 is open and available for all the communication from DSUA portal and the system
  • installation must be done as root or as a user with sudo permission
  • ensure Powershell command line tool is installed on the computer with administrator privileges

Get the DSUA Agent (For example, windows_dsua_agent.zip) from the DSUA portal.

The zip file contains the following:
  • windows_dsua_agent_artifacts - configuration file required to be installed on the system.
  • dsua_agent_installer.ps1 - powershell script to be run on the machine.

Copy the DSUA agent zip file to the machine where it has to be installed.

  1. Login to the machine as a root or as a user with sudo permission where DSUA agent is to be installed.
  2. Navigate to the location where the mass deployment artifacts zip file is copied.
  3. Unzip the DSUA agent zip file.
  4. Open Powershell at the extracted location of the artifacts.
  5. Run dsua_agent_installer.ps1 script using the command: 
    powershell.exe -ep RemoteSigned .\dsua_agent_installer.ps1
    The DSUA agent will be installed on the machine.
    The DSUA portal will display the machine where the DSUA agent is installed.