Previous Topic: Install an Agent InteractivelyNext Topic: Post-installation Tasks for Agents


Perform an Unattended Agent Installation

CA Process Automation supports unattended agent installation to allow administrators to install agents remotely on a host computer. You can use an unattended installation to include the agent in the initial configuration routine for setting up new host computers. You can also use the unattended installation to support installation through software delivery solutions.

When you enter the domain URL with the -VdomainUrl=domain_url, the domain_url is http(s):<FQDN_of_Domain_Orchestrator>:<port_number>.

Important! The domain_url must be entered without /itpam/.

You can perform an unattended agent installation.

Follow these steps:

  1. Log in as Administrator to the server where the Domain Orchestrator is installed.
  2. Verify that the Domain Orchestrator is running.

    Note: An unattended agent installer must still have connectivity to the Domain Orchestrator to install an agent successfully.

  3. Navigate to the following directory:
    install_dir/server/c2o/.c2orepository/media
    

    The media folder includes the following files:

  4. Locate two files for your operating system:
  5. Copy both files for your operating system into a directory on the host where you want to install the agent.
  6. Log on to the host where you want to install the agent and you navigate to the directory where you copied the agent installer and wrapper files.
  7. (Optional) Run the agent installer without arguments to display help.
  8. Use the following command line arguments with the agent installer:
    AgentInstaller.bat -VdomainUrl=domain_url -VacceptLicense=true [-option1 -option2 ...]
    AgentInstaller.sh -VdomainUrl=domain_url -VacceptLicense=true[-option1 -option2 ...]
    

    For example:

    -VdomainURL=https://domainserver.company.com:8443-VacceptLicense=true
    
    -VdomainURL=http://domainserver.company.com:8080
    

    The agent installer accepts the following command line options:

    –VlisteningAddress=hostname

    Specifies the fully qualified domain name or IP address of the host machine on which you are installing the agent. This is required if your host machine has multiple network interfaces.

    -VdisplayName=display_name

    Specifies the name that is displayed for this agent.

    -VnodePort=port_number

    Specifies the port to use on the host.

    -VwinService=boolean

    Set the value to true to install the agent as a Windows Service.

    -Vsys.installationDir=path

    Specifies the full path for installation on the host.

    -VstartAgent=boolean

    Set the value to true to start the agent after the installation is complete.

    -VjavaHome=value

    Specifies the Java Home Location.

    -Vscripts.tmpDir=value

    Specifies the temporary directory to execute the scripts.

    VcertPassword=value              

    Specifies the certificate password as configured in the Domain Orchestrator. This value is required when you are using SSL and/or are working in Secure mode.

    VisLookUpDNSForIP=boolean    

    Set the value to true to look up the agent host name from DNS.

    jetty.ssl.ciphers=value      

    The list of comma-separated ciphers that must be used during Domain Orchestrator-agent communication.

    -VsetPowerShellExecPolicy=value

    The execution of PowerShell scripts on windows platform requires execution policy setting to "Remote Signed". To run PowerShell scripts through CA Process Automation, set the value of this variable as true.

    -VpowerShellPath=value

    Specifies the PowerShell path on host machine.

    -VdeprecatedComms=boolean

    Specifies the communication mode. Set the value to true to support the deprecated mode of communication. Set the value to false to support the new mode of communication.