Installation

Installing or upgrading Windows proxies where anti-virus software is installed

Before installing Windows discovery proxies you should either disable the anti-virus software or configure it to exclude RemQuery from triggering a virus alert. You can enable the anti-virus software once the Windows proxy has been installed.

Windows proxies and firewalls

Windows proxies are no longer restricted to the default ports of previous releases. For a new installation or an upgrade the default ports are used. Installations of additional proxies use incremental ports. You must modify the proxy host firewall, and any other firewalls between the proxy host and the appliance to permit communication on the necessary ports.

Downloading a Windows proxy installer

When you download the proxy installer from the appliance user interface, you download a single installer file from which you install the Windows proxy manager, the Active Directory proxy, and the Credential Windows proxy.

To download a Windows proxy installer:

  1. From the Tools section of the Discovery page, click the Download installer for Windows Proxy version 8.3.2 link.
  2. Save the installation file to your file system.

Installing the Windows proxy manager and proxies

To install the Windows proxy manager and Windows proxies:

  1. Run the installer by double-clicking on the downloaded installer file.
    A welcome screen is displayed.
  2. Click Next.
  3. Click Browse to select an installation directory, or click Next to accept the default default installation directory (C:\Program Files\BMC Software\ADDM Proxy).
  4. To create the Windows proxy application's shortcuts, click Browse to select a different folder, or click Next to accept the default folder (BMC Software\ADDM Proxy).
    If you choose Don't create a Start Menu Folder here, ensure that you clear all the start menu option check boxes in the next step.
  5. On the Select Additional Tasks screen, choose options that will be available in the Start menu, and then click Next.
  6. To install an Active Directory Proxy, select the Install Active Directory Proxy checkbox.
    1. Enter the credentials for the user account that will run the Windows proxy.
      If you do not enter the credentials at this point you can do so later, see Specifying the Account Used to Run the Windows proxy. The Windows proxy will run as the Local System user if credentials are not entered. However, an Active Directory Proxy running as a Local System user will not have the necessary domain credentials to perform any discovery.
    2. Click Next.
  7. To install a Credential Proxy, select the Install Credential Proxy checkbox.
    1. Enter the credentials for the user account that will run the Windows proxy.
      If you do not enter the credentials at this point you can do so later, see Specifying the Account Used to Run the Windows proxy. The Windows proxy will run as the Local System user if credentials are not entered.
    2. Click Next.
  8. Review the details in the Ready to Install window. If the details are incorrect, click Back and navigate through the installer to correct the error. If they are correct, click Install to install the selected components.
  9. The Completing the BMC Atrium Discovery Proxy Setup Wizard is displayed.
    1. Check the Register Active Directory Proxy with ADDM Appliance (if installed) to register the proxy with the appliance.
    2. Check the Register Credential Proxy with ADDM Appliance (if installed) to register the proxy with the appliance.
    3. Check the Run Proxy Manager to run the Windows proxy manager immediately after installation.
  10. The BMC Atrium Discovery UI Create Windows proxy page, pre-populated with details of this Windows proxy is displayed when this part of the setup is complete. You may see a dialog box regarding File Download. Accept this to go to the pre-populated Create Windows proxy page.
  11. Click Finish to exit the installer.

Service startup failure

Sometimes Windows may refuse the installer permission to start the Windows proxy service, resulting in a dialog box along the lines of service installed but could not be started. This is remedied by manually supplying the credentials directly to the service using the Windows Services control panel. See Specifying the Account Used to Run the Windows proxy.

See Installing Windows proxies for information on post installation settings and modifications that may be required for Windows proxies.

Upgrading a Windows proxy

Before upgrading you must ensure that existing Windows proxies are not running. If you do not do this, the install will fail and you will need to reboot the computer.

The upgrade process installs a new proxy and configures it using information taken from the previous proxy. It then uninstalls the previous proxy. As a consequence of this sequence:

  • Upgrading from versions prior to 8.3 SP2: You should not use the same installation directory as the existing Windows proxy or the installation will fail. Accepting the upgrade default prevents this.
  • Upgrading a Workgroup proxy: The Windows Workgroup proxy is deprecated. If you upgrade a Workgroup proxy it is converted into an AD proxy. See Windows proxy compatibility matrix for more information.

Proxy username/password and upgrading

During the upgrade process you need to enter the Active Directory credentials. Usernames are preserved during the upgrade, but passwords are not.

Running the upgrade

To install the Windows proxy manager and upgrade all Windows proxies:

  1. Run the installer by double-clicking on the downloaded installer file.
    A welcome screen is displayed.
  2. Click Next.
  3. Click Browse to select the installation directory, or click Next to accept the default default installation directory (C:\Program Files\BMC Software\ADDM Proxy). See the upgrade notes above.
  4. To create the Windows proxy application's shortcuts, click Browse to select a different folder, or click Next to accept the default folder (BMC Software\ADDM Proxy).
    If you choose Don't create a Start Menu Folder here, ensure that you clear all the start menu option check boxes in the next step.
  5. On the Select Additional Tasks screen, choose options that will be available in the Start menu, and then click Next.
  6. If an existing Active Directory proxy is found, you are asked to enter credentials. The Account field is pre-populated with the username that the proxy is using. Enter the corresponding password in the Password field. If the proxy is currently running as the local system user, you are prompted for an Active Directory username and password. BMC recommend that Active Directory proxies are not run as local system users. Select Migrate existing configuration file to migrate any custom changes to the new proxy.
  7. Click Next to proceed.
  8. If an existing Workgroup proxy is found, it is converted to an Active Directory proxy. You are asked to enter credentials. The Account field is pre-populated with the username that the proxy is using. Enter the corresponding password in the Password field. If the proxy is currently running as the local system user, you are prompted for an Active Directory username and password. BMC recommend that Active Directory proxies are not run as local system users. Select Migrate existing configuration file to migrate any custom changes to the new proxy.
  9. Click Next to proceed.
  10. If an existing Credential proxy is found, the default is not to request credentials. BMC recommend that credential proxies are run as local system users. Select Migrate existing configuration file to migrate any custom changes to the new proxy.
  11. Click Next to proceed.
  12. Review the details in the Ready to Install window. If the details are incorrect, click Back and navigate through the installer to correct the error. If they are correct, click Install to install the selected components.
  13. You are asked whether you want to keep the existing configuration for each proxy. Click Yes to keep the configuration.
  14. Check the Run Proxy Manager checkbox to run the Windows proxy manager immediately after installation.
  15. Click Finish to exit the installer.

Silent installation

The Windows proxy manager and proxy installer uses Inno Setup which provides silent installation capabilities at the command line.

To invoke the installer at the command line:

  1. Using a command prompt, change directory to the directory into which you downloaded the installer file. Enter:
     C:\>cd "Documents and Settings\username\My Documents\Download\"
  2. Run the installer using the Inno Setup options and the additional Windows proxy manager installer options. Enter:
    addmproxy_installer_8.3.2_xxxxxx.exe

The Inno Setup options are described on their website.

Additional Windows proxy manager and proxy installer options are described in the following table:

Option

Description

/ADCREATE=Y|N

Create an AD proxy during the install. The default is Y, that is, create an AD proxy.

/CREDCREATE=Y|N

Create a Credential proxy during the install. The default is N, that is, do not create a Credential proxy.

/ADUSER="username"

The username with which to run an AD proxy. The default is "".

/ADPASSWORD="password"

The corresponding password. The default is "".

/CREDUSER="username"

The username to run a credential proxy. The default is "".

/CREDPASSWORD="password"

The corresponding password. The default is "".

These commands are entered as a space separated list.

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

Comments