How to install or upgrade an Agent or Scalability Server using Deploywrapper (Deploywrapper.exe)?

Document ID : KB000011224
Last Modified Date : 06/03/2018
Show Technical Document Details
Introduction:

This document provides instructions and examples on how to use Deploywrapper (Deploywrapper.exe) to install a new agent or scalability server, as well as upgrade an existing agent or scalability server.

Question:

How to install or upgrade an Agent or Scalability Server using Deploywrapper (Deploywrapper.exe)?

Environment:
Client Automation (ITCM) -- Any version.
Answer:
1- Acquire the Agent or Scalability Server setup files from one of the following sources:
 
a) The Deployment Wizard Package Library (..\CA\DSM\Packages\Public\CAUnicenterDSM)
 
Here are some examples--
 
Software Delivery Agent:
..\CA\DSM\Packages\Public\CAUnicenterDSM\AgentSD\12.0\NLS(ENU,DEU,FRA,JPN)\Windows_x86
 
AM+SD+RC Agent:
..\CA\DSM\Packages\Public\CAUnicenterDSM\AgentAM+RC+SD\12.0\NLS(ENU,DEU,FRA,JPN)\Windows_x86
 
Scalability Server:
..\CA\DSM\Packages\Public\CAUnicenterDSM\Server\12.0\NLS(ENU,DEU,FRA,JPN)\Windows_x86
 
Note: There are TWO editions of the Agent packages:
a) English only Edition
b) Non-Language Specific (NLS) Edition
 
Note: Existing NLS-edition agents cannot be upgraded by the English-only-edition of the agent packages!
 
b) The Software Delivery Library (..\CA\DSM\SD\ASM\LIBRARY)
Use the library.dct file to find the path to the desired agent or scalability server image you wish to install/upgrade.
 
c) The ITCM DVD Media (Note: The ITCM DVD Media does not contain the *combined* agent installation packages)
 
Software Delivery Agent: 
..\WindowsProductFiles_x86\AgentSD
 
Scalability Server: 
..\WindowsProductFiles_x86\Server
 
2- Choose the appropriate DeployWrapper.exe command for install or upgrade:
 
Agent [New Install]:
.\DeployWrapper.exe /DPINST CopiedAgents /qn AGENT_SERVER=MyScalabilityServer.ca.com ALLUSERS=1 /l*v %temp%\ITRMAgentSetup.log

Agent [Upgrade]:
.\DeployWrapper.exe /DPINST CopiedAgents /qn ALLUSERS=1 /l*v %temp%\ITRMAgentSetup.log

Scalability Server [New Install]:
.\Deploywrapper.exe /DPINST Server SERVER_MANAGER=MyDomainManager.ca.com ALLUSERS=1 /qn /l*v+ %temp%\ITRMServerSetup.log

Scalability Server [Upgrade]:
.\Deploywrapper.exe /DPINST Server ALLUSERS=1 /qn /l*v+ %temp%\ITRMServerSetup.log
Additional Information:
The following are CASE SENSITIVE:
/DPINST CopiedAgents
/DPINST Server
 
Some popular installation parameters you might add:
 
- Change drive letter or path to CA folder:
CA="D:\CA"
 
- Change drive letter or path to SC (Shared Components) folder:
CASHCOMP="D:\CA\SC"
 
- Example of installing a new scalability server to the D:\CA folder:
Deploywrapper.exe /DPINST Server SERVER_MANAGER=MyDomainManager.ca.com CA="D:\CA" CASHCOMP="D:\CA\SC" ALLUSERS=1 /qn /l*v+ %temp%\ITRMServerSetup.log
 
For a complete listing of MSI properties:
 
For more information on Deploywrapper.exe, refer to kb000029446: