README.md

Linux Agent Push Installation Tool

Description

Tool for installing Linux agents under a Remote Office.

Requirements

A Windows machine that has SSH access to the systems in which the agent needs to be installed.

Installation Modes

  • Mode 1 - Install agents on the computers listed in computers.csv using a common Username and Password
  • Mode 2 - Install agents on the computers listed in computers.csv using SSH Keys
  • Mode 3 -Install agents on the computers in an IP Range using a common Username and Password
  • Mode 4 - Install agents on the computers in an IP Range using SSH Keys

computers.csv format

The hostname of the agent machine is required.

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

Example:

hostname,agent_installation_dir
test-machine-1
test-machine-2,/opt

Note: There should be an empty line at the end-of-file.

SSH Keys

The following details apply to Modes 2 and 4.

  • SSH keys should have been configured in the agent machines (i.e) the Public Key of the Windows machine from which Push Installation is to be done, should be present in the authorized_keys file in the agent machines.
  • By default, the Private Key present in the current User's home directory will be used. If a different key is to be used, the full path to the Private Key can be provided when it is prompted.
  • In case the Private Key is encrypted, the passphrase should be entered. If not, it can be left empty.
  • If the user is a sudo user, NOPASSWD option should be enabled for this user in sudoers. This is not necessary in case of installation using the root user.

IP Range

The following details apply to Modes 3 and 4.

  • Only IPv4 is supported.
  • End IP is inclusive.

SSH Port

By default, the SSH port 22 will be used. To use a custom SSH port, provide it as an argument to the tool.

Example:

LinuxAgentPushInstaller_32bit.exe -port=8888

Force Installation

If the agent is already installed in a target machine, then this Installation Tool will not force installation by override existing installation.

In order to uninstall the existing agent and install the new agent, give 'force' as an argument to the tool as shown in the example.

Note: Force installation is supported from Linux agent version 10.0.600.L

Example:

LinuxAgentPushInstaller_32bit.exe -force

File transfer path

To use a custom path for file transfer instead of the default /tmp path transfer via SSH, provide the custom path as an argument to the tool.

Note: The SSH user must have proper permissions for the specified path

Example:

LinuxAgentPushInstaller_32bit.exe -path=/opt

Timeout Period

The tool has a default timeout period of 15 minutes for agent installation.

To change the timeout period, provide it as an argument to the tool, as shown in the example

Example:

LinuxAgentPushInstaller_32bit.exe -timeout=10