Starting version 8.9.03, BMC Network Automation is renamed to TrueSight Network Automation. This space contains information about BMC Network Automation 8.9.02 and previous versions. For TrueSight Network Automation 8.9.03 and later releases, see the TrueSight Network Automation documentation.

Installing the remote device agent on Windows

The topics in this section describe how to install an optional BMC Network Automation remote device agent.

A local device agent is automatically installed when you install the BMC Network Automation application server. You cannot install a remote device agent on the application server host computer.


If you are installing multiple remote device agents, and prefer to use a repeatable procedure that is not wizard-based, and is non-iterative, see Running the installer in silent mode.

Remote device agent deployment considerations

Installing the remote device agent is optional. When you install the application server, by default it installs a local device agent.

The local device agent is always active on the server. All devices by default are assigned to the local device agent. However, installing a remote device agent offers these operational benefits:

  • The remote device agent uses a single secure port (default 1099) to communicate with the application server and uses standard protocols to communicate with devices. This enables you to manage devices that are behind firewalls or in a demilitarized zone (DMZ) where you cannot open Telnet/SSH and TFTP/FTP/SCP ports, but can open an SSL port.
  • The remote device agent enables you to manage multiple networks that have duplicate IP address ranges. This improves performance and reduces WAN bandwidth when loading software images to devices in a region site/region. The OS image is transferred once to the remote device agent for distribution locally to the devices.
  • Managed service providers can securely manage customer networks through a dedicated remote device agent co-located at the customer premises. The customer remote device agents are managed over a single SSL connection.

Before you begin

BMC recommends that before you install the remote device agent, perform the following tasks:

  • Print out and enter in the worksheet the selections and parameter values you plan to use when you run the installer. (see Remote device agent installation worksheet.)
  • Refer to the worksheet when you run the installation.

To install the remote device agent on Microsoft Windows

  1. Log on as an administrator to the host computer where you are installing the remote device agent.
  2. Start the installation by executing the setup.cmd file that you obtained by extracting the installation files.
    The installer might take a minute or more to start.
  3. Start panel: Select the language to be used for installation.

    BMC Network Automation supports the English, French, and Chinese languages.


    Starting from version 8.9.02, BMC Network Automation does not support French.

  4. Click OK.
  5. Welcome panel: Click Next.
  6. End User License Agreement panel: Review the BMC Network Automation Software License. You must accept the terms of this license agreement to continue installation, and click Next.
  7. (Optional): Microsoft .Net version validation warning panel: Install Microsoft .NET Framework 3.5.x if you see the following warning, and then click Next.
    See for details.

    It is detected that the host on which you are installing BMC Network Automation does not have Microsoft .Net framework 3.5.x which is prerequisite for packaged TFTP Server. Please install it before you proceed if you are planning to use packaged TFTP Server. If you proceed without installing Microsoft .Net framework 3.5.x then packaged TFTP Server will not work.
  8. Component Selection panel: Select the Remote Device Agent option, and click Next.


    The installer prevents the installation of the remote device agent, if it detects that the application server has been installed on this computer.

  9. Installation directory panel: Specify the directory in which you want to install the product in the Destination Directory field, and click Next. Default: C:\Program Files\BMC Software\BCA-Networks-Agent


    • Do not use the pound ($), hash (#) or at (@) sign in the directory path.
    • The directory path cannot contain any non-Latin characters (Chinese, Japanese, Korean, or similar characters). These characters cause the installation to fail.
    • You must install the software on a local drive. Do not install the software on a network drive.
    • BMC recommends using the default for continuity with uninstallation and future upgrades.
  10. TFTP Server Selection panel: Select the Install and configure TFTP Server option if you want to install and configure the TFTP server, and click Next.
  11. RMI Port Number panel: Specify the Java Remote Method Invocation (RMI) port to use for communication between the application server and the remote device agent, and click Next.
    This port must be available on the system, and any local firewall might have to be configured to allow communication on this port between the application server and the remote device agent. The default port is 1099.
  12. Certificate Information panel: Enter the information required for the SSL certificate as described in the following table, and click Next. The certificate is used for secure communications between the application server and the remote device agent.



    Common Name (CN)

    Enter the host name or IPv4 or IPv6 address of the server.

    Note: This field must match the host name in the URL that is used to access the BMC Network Automation web server.

    Organization Unit (OU)

    Enter the name of your organization unit.

    Organization Name (O)

    Enter your city or other locality.

    State Name (S)

    Enter the name of your state, province, or other political subdivision.

    Country (C)

    Enter the name of your country.

    Create Keystore Password

    Enter a minimum six-character password to secure the certificate keystore.

    Note: Record this password in a secure location.

    Confirm Keystore Password

    Enter the keystore password again.

  13. Memory and System Options panel: Change memory settings or enter additional startup options if required, and click Next.



    Initial Memory Allocation

    The amount of memory that the software allocates and holds upon startup. Additional memory is allocated, as needed, up to the Maximum Memory Allocation value (see next item).

    Maximum Memory Allocation

    The maximum amount of memory that the software process can use. Use the guidelines in the Memory guidelines table below to estimate of the setting for initial and maximum memory based on number of devices. The actual values depend on how your BMC Network Automation system is used. If required, these values can be adjusted later.

    Cache Successful DNS Lookups for

    The number of seconds to cache successful DNS lookups. A value of 0 caches the lookups forever. This value controls how many seconds it takes for the software to detect an IP Address change in your BMC Network Automation system when performing DNS lookups (for example, for syslog processing). Typically this value need not be changed.

    Additional Startup Options

    Additional startup options for the application. For a specific recommendation, see the note following this table. The FAQ and Knowledge Base articles might recommend additional startup options to solve issues unique to your environment.

    Memory guidelines

    Number of devices

    Recommended initial memory

    Recommended maximum memory

    < 1000 (default )

    128 MB

    256 MB


    256 MB

    512 MB


    512 MB

    1024 MB


    In an environment where the BMC Network Automation agent is installed on a host computer that is behind a Network Address Translation (NAT) firewall, perform the following actions:

    • Specify -Djava.rmi.server.hostname=VALUE, an additional startup parameter during installation. Replace VALUE with the host name of the BMC Network Automation agent.
    • Ensure that the host name of the BMC Network Automation agent that you specify resolves to a public IP address from the BMC Network Automation server and resolves to a private IP address from the BMC Network Automation agent itself, by modifying hosts file accordingly.

  14. Installation Preview panel: Review the summary information, and then click Install.
    A panel appears indicating that the installation completed successfully.
  15. Finish and log file panel: Review the summary information. To view the installation log file, click View Log. The name of the log file is bcan_install_log.txt. The location of the file is determined by the %TEMP%environment variable in Windows.


    When the installation completes, you are reminded of the RMI port (Default: 1099) that is used to communicate between the application server and the remote device agent. Ensure that this port is not blocked by any firewall.

  16. When you are finished, click Done.
    As part of a successful remote device agent installation, the following services are installed: 
    • BMC Network Automation Agent Service
    • (Optional) BCA-Networks TFTP server 

Where to go next

Was this page helpful? Yes No Submitting... Thank you