Installing and registering CCS Agent on Windows in silent mode
When you install a CCS Agent, the installer prompts for necessary information such as the type of installation or the name of a directory. If you use the same settings to install the CCS Agent on a large number of computers, you can avoid the prompts by performing silent installations. The silent installation feature lets you install CCS Agents and register them to CCS Managers.
To install an agent with the latest updates, use the setup files for Agent installation available with the installation package.
If the silent installation fails, check the SymantecESMAgentInstall.log file at the Temp folder for the error logs. If the silent registration fails, check the SymantecESMAgentReg.log file at the following location for the error logs:
#\Symantec\CCS\Reporting and Analytics\ESM\system\<name of the computer where you have installed the agent>
See the following sections before installing the CCS Agent:
You cannot install a standalone CCS Agent on a computer that contains a CCS Manager, because the CCS Manager installation also contains the installation of CCS Agent.
Perform the following procedure before installing the CCS Agent:
Install the CCS Manager. You require a CCS Manager for the CCS Agent to register to. However, you cannot install a CCS Agent on a computer that contains a CCS Manager.
Do one of the following:
- Install the CCS Manager along with the CCS Application Server on a single computer, Installing CCS 12.0 suite
- Add a CCS Manager to an existing installation of the CCS Application Server.
- Install a standalone CCS Manager. Installing a standalone CCS Manager for a scale out deployment of CCS
- To install agent in silent mode, log on as an administrator to the computer on which you want to install the CCS Agent. Alternatively, use a role that is equivalent to an administrator.
- Copy the CCS_Agent\win folder from the product media to a network installation folder or to a local folder.
- Copy theAgentSilentInstallSample.batfile from the CCS_Agent\win\examples folder of the product media. Save theAgentSilentInstallSample.batfile in the CCS_Agent\win folder that you copied to a local folder. You must save theAgentSilentInstallSample.batfile at the location where the Setup.exe file is present for installing the agent.For security purpose, you can use an encrypted password to install the CCS Agent. For information on creating an encrypted password see To create an encrypted password.
- Right-click theAgentSilentInstallSample.batfile, and selectEdit.
- Specify the parameters of command line silent installation options. For information on the parameters, see the table at the end of this topic.
- To silently register an agent, log on as an administrator to the computer on which you want to install the CCS Agent. Alternatively, use a role that is equivalent to an administrator.
- Copy the CCS_Agent\win folder from the Installset to a network installation folder or to a local folder.
- Copy theAgentRegSilentInstallSample.batfile from the CCS_Agent\win\examples folder of the product media. Save theAgentRegSilentInstallSample.batfile in the CCS_Agent\win folder that you copied to a local folder. You must save theAgentRegSilentInstallSample.batfile at the location where theSetup.exeis present for installing the agent.For security purpose, you can use an encrypted password to register the CCS Agent. For information on creating an encrypted password see To create an encrypted password.
- Right-click theAgentRegSilentInstallSample.batfile, and then clickEdit.
- Specify the parameters of command line silent installation options. For information on the parameters, see the table at the end of this topic.
- To create an encrypted password, you can install and register an agent using an encrypted password for security purpose. Perform the following steps to create an encrypted password.
- Copy the CCS_Agent\win folder from the Installset to a network installation folder or to a local folder.
- On the command line, go to the CCS_Agent\win\util folder and run theEncryptionTool.batfile. Provide the password as an argument followed by ane.For example,EncryptionTool.bat <Password> eWhere, <Password> is your password that you want to encrypt.
- The encrypted password is displayed in a text file.For example,encrypted password is : <%%C%%1D%%F%%F%%3C%%4D%%4E%%4F>
- Copy the encrypted password including the opening and closing brackets and paste it in quotes "" into theAgentSilentInstallSample.batandAgentRegSilentInstallSample.batfiles in place ofesm4now.For example, in theAgentSilentInstallSample.batfile you must copy the password at the following location:AGENTCONFIG=\"-m [{dev-imr50-2,esm,esm4now,1,default,5600,1}]Replaceesm4nowwith the following encrypted passwordAGENTCONFIG=\"-m [{dev-imr50-2,esm,"<%%C%%1D%%F%%F%%3C%%4D%%4E%%4F>",1,default,5600,1}]
The following Command-line options table contains the information on the silent installation options and their descriptions.
Example command to install and register a CCS Agent on Windows in silent mode:
setup.exe /s /v"/qn /l*v \"%TEMP%\SymantecCCSAgentInstall.log\" INSTALLDIR=\"C:\Program Files\Symantec\Enterprise Security Manager\" AGENTCONFIG=\"-m [{dev-imr50-2,esm,esm4now,1,default,5600,1}] -i enable -e [dev-imr50-2]\" "
Option | Description |
|---|---|
/s | Install CCS agent in silent mode. |
/v "<COMMAND LINE>" | Parameters to pass to the CCS Agent installer. |
/qn | Run the CCS Agent installer without the GUI (Graphical User Interface). |
/l*v<LOGFILE> | Use a verbose log and write the output to the specified log file. Log on to www.microsoft.com for more log options. |
INSTALLDIR=<DIRECTORY> | Specify the directory where you need to install the agent |
AGENTCONFIG | Specify the attributes of managers to whom the agent needs to be registered. Each manager specification includes the following information:
For security purpose, you can use an encrypted password to install the CCS Agent. For information on creating an encrypted password see To create an encrypted password. The agent name type can be a 1 (long), a 2 (short), or a 3 (user-defined). The agent name is ignored during installation unless you specify the agent name type as a 3. REGAGENTLIST is ignored if you specify the SELECTION as a 2. |
-e | Enable LiveUpdate on the agent from all managers on which the agent is registered. |
-e [m1,m2,m3..] | Enable LiveUpdate on the agent from specific managers. |
-d | Disable LiveUpdate on the agent from all managers on which the agent is registered. |
-d [m1,m2,m3..] | Disable LiveUpdate on the agent from specific managers. |
-i enable | Enable the ICE scripts. This option lets you copy the ICE scripts from a manager to an agent. |
-i disable | Disable the ICE scripts. |
SULOCATION=<SU package folder> | Lets you specify the custom location of the SU package. The installer installs the su package from the default location, if custom location is not specified. |