Prerequisites

2 minute read

General Prerequisites

  • You must have an artifact repository server installed.

  • At least one version of each agent installer must be published to the artifact repository for any required OS.

  • The user that you specify in the Authentication Options dialog box must have administrator privileges on the target machines.

  • The agent service user of the driving agent must have administrator rights on the target machine.

Linux and UNIX Prerequisites

  • The target machines must be running the SSH daemon.

  • For SSH, the user account on the target machine must have passwordless sudo configured for running the installer with root privileges.

    For example, in the /etc/sudoers file, you must add “ <username> ALL=(ALL) NOPASSWD:ALL ”.

  • For each target machine that you want to upgrade, ensure that PasswordAuthentication=yes in the /etc/ssh/sshd_config file. For example:

    # To disable tunneled clear text passwords, change to no here!
    
    PasswordAuthentication yes

On SUSE platforms, PasswordAuthentication=no is the default.

Windows Prerequisites

Windows Driving Resources

  • They must be in the same Windows domain as the remote windows hosts where you will install the agents.

  • They must be in the same zone as the zone where you will install the agents.

  • Powershell 3.0 or newer must be installed on older versions of Windows. To check the Powershell version:

    1. Open Powershell on the host by selecting Start > All Programs > Accessories > Windows PowerShell > Windows PowerShell.

    2. Enter the Get-Host | Select-Object Version command.

  • Windows Remote Management (WinRM) must be installed and configured.

  • WinRM is installed automatically with all currently-supported versions of Windows.

  • The WinRM service starts automatically on Windows Server. On Windows Vista, the service must be started manually.

  • Before using a domain user to install agents on remote hosts, you must enable multi-hop support for WinRM on the driving resource system and on each remote host. For details, see the How to get server status information from multiple machines within your environment Knowledge Base article.

  • You can enable the WS-Management protocol on the local system and set up the default configuration for remote management by using the Winrm quickconfig command.

  • Maximum Powershell memory must be set to at least 1024 MB. To set the memory setting to 1024 MB:

    1. Open a Windows command prompt as Administrator.

    2. Enter the winrm set winrm/config/winrs @{MaxMemoryPerShellMB="1024"} command.

Remote Windows Hosts

  • Maximum Powershell memory (MaxMemoryPerShellMB) must be set to at least 1024 MB.

  • WinRM must be installed and configured.

  • WinRM is installed automatically with all currently-supported versions of Windows.

  • The WinRM service starts automatically on Windows Server. On Windows Vista, the service must be started manually.

You can enable the WS-Management protocol on the local computer and set up the default configuration for remote management by using the winrm quickconfig command.