Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

PowerProtect Data Manager 19.15 Microsoft SQL Server User Guide

Install the Microsoft application agent with a silent installation

Learn how to install the Microsoft application agent (including the agent service) with the command prompt for a silent installation.

NOTE:Starting with Microsoft application agent 19.14, migration of the Microsoft application agent from an Application Direct configuration to a VM Direct configuration or vice versa is not supported. During installation, if you try to migrate from either type of configuration to the other, an error message is displayed about an invalid data path selection.

To silently install the Microsoft application agent (including the agent service), run the following command:

emcmsappagent-19.15.0.0.exe -silent -log "<log_file_path>" [ProductInstallPath="<installation_path>"] [EnableSSMS={0|1}] [EnableVMDirect={0|1}] [EnableProtectPoint={0|1}] [EnableSSMSProtectPoint={0|1}] [InstallPPDMAgentCheckBox={0|1}] [EnableFirewallRules={0|1}] [PPDMHostname="<hostname/IP>"] [EnableCLR={0|1}] [ClientPort=<port_number>] [PreferredAddress="<agent_hostname/IP>"]
NOTE:The ItemPoint software cannot be installed silently. To install ItemPoint for granular-level recovery, use the Microsoft application agent installation wizard.

The following table describes the required silent installation command options.

Table 1. Required silent installation command optionsTable of required silent installation command options
Command option Description
-silent Specifies a silent installation.
-log "<log_file_path>" Specifies the path where the log file is created or saved. The log file displays the status of the installation. For a silent installation, you must use the -log "<log_file_path>" option.

The following table describes the optional silent installation command options.

Table 2. Optional silent installation command optionsTable of optional silent installation command options
Command option Description
ProductInstallPath="<installation_path>" Specifies a modified path where the product and agent service must be installed. This option must be specified for an installation to a custom location. If you do not specify this option, the product and agent service are installed in the default location.
NOTE:The agent service is always installed, regardless of the InstallPPDMAgentCheckBox command option setting.
EnableSSMS={0|1} Specifies whether to install the SSMS plug-in. The default value is 1, which installs the SSMS plug-in.
EnableVMDirect={0|1} Installs VM Direct when you specify the value 1. The default value is 0, which does not install VM Direct.
InstallPPDMAgentCheckBox={0|1} Integrates the Microsoft application agent with the PowerProtect Data Manager server during installation when you specify the value 1. The default value is 0.
NOTE:Installation of the PowerProtect agent requires the port specified by ClientPort (port 7000 by default) to be open bidirectionally. Ensure that you use the EnableFirewallRules=1 command option setting to open the Windows firewall. The ClientPort port or default port 7000 is required to enable communication between the Microsoft application agent and the PowerProtect Data Manager server.
EnableFirewallRules={0|1} Specifies to configure the Windows firewall when you specify the value 1. The default value is 0. The Windows firewall enables the bidirectional inbound and outbound connections for the agent service over the port specified by ClientPort, which enables the communication between the Microsoft application agent and PowerProtect Data Manager.
PPDMHostname="<hostname/IP>" Specifies the hostname or IP address of the PowerProtect Data Manager server where the backup information is reported.
EnableCLR={0|1} Specifies whether to deploy CLR. By default, this option is enabled and has the value 1, which deploys CLR.
ClientPort=<port_number> Specifies the port on Microsoft SQL Server to be used for communication between the Microsoft application agent and PowerProtect Data Manager. The port number must be from the port ranges 7000 to 7009 and 7012 to 7020.
NOTE:If you do not specify a port number, the default port 7000 is used as the communications port. The ports 7010 and 7011 are used by the agent service message bus.

Setting the ClientPort option to a non-default port value is not supported for a VM Direct installation.

The ClientPort option is not supported for a silent update. A  silent update uses the previously configured port number and disregards any ClientPort option setting.

PreferredAddress="<agent_hostname/IP>" Specifies the address of the application agent host to be used for communication between the Microsoft application agent and PowerProtect Data Manager. The preferred host address can be an IPv4 address, an IPv6 address, or a fully qualified domain name (FQDN).
NOTE:If the preferred address is an FQDN, ensure that lookup is enabled in the PowerProtect Data Manager UI. If lookup is not enabled, the preferred address defaults to an IP address.

Example commands to silently install the Microsoft application agent

Consider the following example commands to silently install the Microsoft application agent (including the agent service):

  • The following command installs the Microsoft application agent with PowerProtect Data Manager by using the non-default communications port 7005 and preferred application agent host address:
    emcmsappagent-19.15.0.0.exe -silent -log "C:\Users\Administrator\Desktop\installLog.txt" InstallPPDMAgentCheckBox=1 PPDMHostname="<PowerProtect_Data_Manager_hostname_or_IP>" ClientPort=7005 PreferredAddress="<application_agent_hostname_or_IP>"
  • The following command installs the Microsoft application agent with VM Direct:
    emcmsappagent-19.15.0.0.exe -silent -log "C:\Users\Administrator\Desktop\installLog.txt" EnableVMDirect=1
  • The following command installs the Microsoft application agent with the Application Direct SSMS plug-in:
    emcmsappagent-19.15.0.0.exe -silent -log "C:\Users\Administrator\Desktop\installLog.txt" EnableSSMS=1 ProductInstallPath="C:\Users\Administrator\Desktop\msappagent"
  • The following command installs the Microsoft application agent without deploying CLR:
    emcmsappagent-19.15.0.0.exe -silent -log "C:\Users\Administrator\Desktop\installLog.txt" ProductInstallPath="C:\Users\Administrator\Desktop\msappagent" EnableCLR=0
  • The following command installs the Microsoft application agent with PowerProtect Data Manager:
    emcmsappagent-19.15.0.0.exe -silent -log "C:\Users\Administrator\Desktop\installLog.txt" InstallPPDMAgentCheckBox=1 PPDMHostname="<PowerProtect_Data_Manager_hostname_or_IP>"
  • The following command installs the Microsoft application agent (including the agent service) to a custom location that is not on the system drive:
    emcmsappagent-19.15.0.0.exe -silent -log "C:\Users\Administrator\Desktop\installLog.txt" ProductInstallPath="G:\Software\MSAPPAGENT" InstallPPDMAgentCheckBox=1 PPDMHostname="<PowerProtect_Data_Manager_hostname_or_IP>" EnableCLR=0
  • The following command installs the Microsoft application agent (including the agent service) to a custom location and enables the firewall for communication with PowerProtect Data Manager:
    emcmsappagent-19.15.0.0.exe -silent -log "C:\Temp\PPDM.log" EnableSSMS=1 ProductInstallPath="C:\custom\MSAPPAGENT" InstallPPDMAgentCheckBox=1 EnableFirewallRules=1 PPDMHostname="10.118.136.192" EnableCLR=0

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\