Pre-requisite for uDeploy agents

• Ensure that each computer where you are installing an agent has a supported version of the Java™ Runtime Environment (JRE) or Java developer kit. All Java versions that support the SE 1.6, SE 7.0 or SE 8.0
• Set the JAVA_HOME system variable to the location of the JRE or JDK that you are using.
• Agents that do not use a relay must be able to initiate connections to the server through HTTP or HTTPS. The default ports are 8080 for HTTP and 8443 for HTTPS.
• Installing agents remotely on Linux or UNIX systems requires the server to initiate connections to the SSH port of the agent computer. The default port for SSH is 22.
• Remote discovery of agents requires the server to initiate connections to port 22 for Linux agents and port 135 for Windows agents.
• Ensure that there is no limit on the maximum memory size and virtual memory size. For example, on most Linux systems, you can run the ulimit -m and ulimit -v commands and ensure that both return the value unlimited.
• For more information about System Requirements for IBM UrbanCode Deploy, please refer this url
  http://www-01.ibm.com/support/docview.wss?uid=swg27038801
• For more infomation about Udeploy Server/Agent/Relay Firewall/Ports/Networks configuration, please refer this url
  

Process to install uDeploy Agents

1. Specifying its target location or
   
2. Install an agent that was previously discovered with the agent discovery feature.

There are following broadly three methods available to install and configure uDeploy agents.

Method 1 - Using uDeploy Server

1. SSH Mode - Installing agents remotely on Linux through SSH.
   
2. WinRS Mode - Installing agents remotely on Windows through WinRS. CLICK HERE

1. From the server, click Resources > Agents.
2. Complete one of the following steps to install an agent:
   • If you know the target host, click Install New Agent.
   • To install an agent that was discovered with the agent discovery feature, click the Install Agent action for the agent. Discovered agents have the Installable status.
3. In the Install New Agent window, select SSH.
   Note:If you are installing a discovered agent, this step is skipped because the system type is automatically determined during discovery.
4. Enter the host name or IP address of the system where you want to install the agent in the Target Hosts field. To specify multiple entries, type each one on a separate line.
   Note:If you are installing a discovered agent, this step is skipped because the host or IP address is automatically determined during discovery.
5. Specify the following parameters:
   1. Enter the SSH port address of the target system in the SSH Port field.
   2. Select the Use Public Key Authentication check box to use public key authentication instead of a password.
   3. Enter a name for the agent in the Agent Name field.
      Note:If you enter multiple hosts in the Target Hosts field, the agent name is appended with a number. The number is incremented for each host after the first one.
6. Enter the name of the target host user with appropriate permissions in the Username field. This user must have permission to edit the agent directory on the target host.
7. Enter the password that is associated with the user in the Password field.
8. Select an agent installation property sheet from the Agent Installation Properties list, or use New to create a property sheet.Agent installation property sheets are templates that can be saved and used to install agents. You can create any number of agent installation property sheets. 

Method 2 - Plugins Way

1. Install Linux agents remotely is to add the Install Agent with "SSH" step using IBM UrbanCode Deploy Resources plug-in
   
2. Install Windows agents remotely is to add the Install Agent with the "WinRS Agent Install" step using WinRS Agent Install

Method 3 - Manual/Command Line Method

Step 1 - Download and extract the agent installer
Download and extract the agent installer to the computer to install the agent on. To download the installer, log in to the server and click the Help icon at the upper right of any page on the server, and click Tools. Then, click IBM UrbanCode Deploy Agent, and download and extract the file

Step 2 - Go to the installer directory
Go to the installer directory where you extracted the ibm-ucd-agent.zip.

Step 3 - Run the install-agent script.
From this directory, run the install-agent.bat command (Windows) or install-agent.sh (UNIX, Linux, Mac OS, or IBM z/OS).

Step 4 - provide the prompted info
The IBM UrbanCode Deploy agent installer is displayed and prompts you to provide the following information.

• Enter the directory where agent should be installed.
  
• Please enter the home directory of the JRE/JDK used to run this agent.
  
• Will the agent connect to an agent relay instead of directly to the server? - The default value is N.
  
• Enter the hostname or address of the server the agent will connect to.
  
• Enter the agent communication port for the server
  
• Do you want to configure another failover server connection? - The default value is N.
  
• Enable mutual (two-way) authentication with SSL for server/agent JMS communication? - The default value is N.
  
• Disable end-to-end encryption for server/agent JMS communication? - The default value is N.
  
• Enable the agent to verify the server HTTPS certificate? - The default value is N.
  
• Enter the full web URL for the central IBM UrbanCode Deploy server. - https://server.example.com:8443
  
• Enter the name for this agent.
  
• Enter teams (and types) to add this agent to, separated by commas.
  
• Do you want to install the Agent as Windows service?

Method 4 - Auto Discovering Method

Ensure that the Nmap utility is installed on the system where IBM UrbanCode Deploy server is installed, and that the Nmap utility is on the path environment variable.

This feature uses Nmap utility to search for locations where agents might be installed. The Nmap utility searches ports 22 and 135. A location with port 22 that is open is assumed to be computer that is running UNIX. A location with port 135 that is open is assumed to be a computer that is running Windows.

• Step 1 - Click Resources > Agents.
  
• Step 2 - Click Discover Available Network Hosts.
  
• Step 3 - Enter the subnets to search in the Subnet field. The format is xxx.xxx.xxx.xxx/nn where xxx.xxx.xxx.xxx is the IP address and nn is the network prefix
  
• Step 4 - Click Save to start the search. Search times depend on the size and number of subnets that are searched. A discovered agent is automatically given the same name as
• the discovered host. If the host name is unavailable, the discovered IP address is used instead.
  
• Step 5 - You can install a discovered agent by using the Install Agent action that is associated with the agent on the Agents pane
  

Remote agent installation properties