3.3 Installing the Windows Agent

Change Guardian agents allow the modules to monitor computers for changes. You can choose from the following Windows agent installation options:

The following table lists the requirements and recommendations for computers where you plan to install the agent:

Category

Requirement

Operating System

One of the following:

  • Windows 10 (32- and 64-bit)

  • Windows 8 (32- and 64-bit)

  • Windows 7 (32- and 64-bit)

  • Windows Vista (32- and 64-bit)

  • Windows Server 2012 R2

  • Windows Server 2012

  • Windows Server 2008 R2

  • Windows Server 2008 (32- and 64-bit)

  • Windows Server 2003 R2 (32- and 64-bit)

Additional Software

  • Microsoft .NET Framework 4.0 Extended or later

  • Microsoft .NET Framework 3.5 Service Pack 1

3.3.1 Remotely Install the Windows Agent

Remote installation using the NetIQ Agent Manager provides a convenient and uniform method for installing one or more Windows agents.

To remotely install agents, you must first add the assets (computers) where you want to install agents. You can import assets from Active Directory or a text file, or manually add assets. After you add assets, select the assets to which you want to deploy agents and then install the agents.

To add assets to Agent Manager:

  1. In a web browser, access the Change Guardian web console at https://server:8443, where server is the IP address of the Change Guardian server.

  2. When prompted, provide your Change Guardian user name and password.

  3. Click Integration, and then click Agent Manager.

  4. Do one of the following:

    • (Conditional) If you have not previously added assets, in Agent Manager, under Asset Groups, click All Assets and then click Add Assets.

    • (Conditional) If you previously added assets, in Agent Manager, click All Assets, then Manage Assets, and then Add.

  5. (Conditional) If you want to import assets from Active Directory, complete the following:

    1. Click Active Directory.

    2. Provide the domain name or IP address of the Active Directory server and credentials for connecting to the server, and then click Authenticate.

    3. Navigate the Active Directory tree to locate the assets you want to add, select the assets, and then click Add Assets.

  6. (Conditional) If you want to import assets from a text file, complete the following:

    1. Create a text file with a header line containing the columns Hostname, MajorType, and Addresses. Use a tab to separate the columns. In the Hostname column, type the fully-qualified domain names of the computers where you want to deploy agents. Optionally, you can specify the IP addresses in the Addresses column. In the Major Type column, specify whether the operating system is UNIX or Windows. For example:

      Hostname

      MajorType

      Addresses

      houidam101.us.netiq.corp

      Windows

       

      houidam102.us.netiq.corp

      Windows

      10.204.102.5

    2. In the Agent Manager, click Hosts List.

    3. Click Browse, navigate to the location where you saved the text file, and then click Open.

  7. (Conditional) If you want to manually add an asset, do the following:

    1. Click Host.

    2. Specify the host name or IP address of the computer. To specify multiple IP addresses, use a comma to separate the addresses.

    3. Select the appropriate operating system type.

    4. Click Add Assets.

You can now select the assets where you want to deploy agents and install the agents.

To deploy Windows agents to assets:

  1. From the assets list, select the computer where you want to deploy an agent. You can select multiple computers if Agent Manager can use the same credentials to connect to the computers.

  2. Click Manage Installation, and then click Install or Upgrade Agents.

  3. Provide credentials for an account that can connect to the computer and then click Next.

    The account must be the local administrator account or a domain account in the Local Administrators group.

  4. For the agent revision, select NetIQ Change Guardian Agent for Windows Agent Version, where Agent Version is the version of the agent you want to deploy.

  5. Select the configuration to use for the deployment, or click Add to specify a new configuration.

  6. Click Start Installation.

Agent Manager initiates the installation. Use the In progress Tasks, Completed Tasks, and Failed Tasks tabs to monitor the progress.

NOTE:When you use Agent Manager to install Windows agents, Agent Manager also installs the NetIQ Client Agent Manager component on the selected assets.

3.3.2 Performing a Silent Agent Installation

You can use the Agent Manager to download a silent installation package that contains the files necessary to install the Windows agent without having to interact with the setup program.

To silently install the Windows agent:

  1. In a web browser, access the Change Guardian web console at https://server:8443, where server is the IP address of the Change Guardian server.

  2. When prompted, provide your Change Guardian user name and password.

  3. Click Integration, and then click Agent Manager.

  4. Click All Assets, and then click Manage Installation and select Download.

  5. Select the package you want to download and the configuration you want to use, and then click Start Download.

    Agent Manager downloads ChangeGuardianAgentforWindows.zip to your computer.

  6. Copy ChangeGuardianAgentforWindows.zip to the computer where you want to install the Windows agent and extract the files.

    The silent installation package includes NetIQCGAgentSilentInstaller.exe and NetIQCGAgentSilentInstaller.config. Both files must be in the same directory. The configuration file contains the configuration you chose when you downloaded the silent installation package.

  7. From a command prompt with the Run as administrator option, change directory to the location where you extracted the files and run NetIQCGAgentSilentInstaller.exe.