Installing the Densify Connector

Installing the Densify Connector

#380020

The user account that you use to install the connector requires permission to install and start services on the machine or VM, where the Densify Connector is installed.

To learn more watch the following video:

If you encounter issues installing the Densify Connector, it is likely that you do not have the correct privileges. Right-clicking the Densify Connector executable and selecting "Run as administrator" to install with elevated privileges.

  1. Double click the file to run the Densify Connector executable.
  2. The welcome page is displayed with details of the data collection process.
  3. Click Next to continue and follow the on-screen instructions.
  4. The Installation Directory screen is displayed for you to select the installation location (by default C:\Program Files\Densify Connector\). Click Next to confirm and start the installation.
  5. Click Finish to complete the install, start the Densify Connector service and to open the configuration screen.

Note: The scheduling component of the Densify Connector runs as a service.

Upgrading the Densify Connector

When you are upgrading, the process is the same as the installation with one exception. During an upgrade, the installer automatically uninstalls the previous version of the Densify Connector before installing the new version.

The upgrade process retains your connection settings and all audit files.

  • When upgrading, the installer will use the same directory as the current Connector installation.
  • Configuring the Densify Connector

    Before you can run the Densify data collection, you need to complete the following steps:

    • Create a connection for each vCenter—define the connection information along with, optionally its vROps manager connection information
    • Enable data transfer—define your settings and enable data transfer of the collected data to your Densify instance.

    Once the collected data is transferred, Densify analytics are run and you can review the Densify reports.

    Changing the vCenter Collection Configuration

    If you make changes in your vCenter Server, such as changing the sampling interval or statistics level, then you should verify these settings through the Densify Connector:

    1. Select your vCenter Connection from the list of Saved Connections and click Verify vCenter Connection.
    2. Verify that the Status is still OK for all vCenter settings.
    3. Click Save to save the changes.

    Configuring Action Automation

    When you are using action automation there are additional utilities that must be installed and configured on the same machine as the connector. In addition to Microsoft® PowerShell and .NET Framework, you need to install and configure the VMware vSphere PowerCLI.

    Reviewing Data Collection Files

    If you need to review your data collection files, they are located in the repository subfolder of your Densify Connector installation.

    During data collection (either scheduled or through the Collect Data Now button), the collected data is written to the repository folder. One file is created per vCenter Server, whether or not vROps is used.

    With Data Transfer Settings defined and enabled, these files are transferred immediately to your Densify platform and moved to the repository\sent folder.

    With Data Transfer Settings disabled, these files are moved to the repository\pending subfolder, pending to be transferred to your Densify platform. These files are transferred after you define and enable the Data Transfer Settings, on the next scheduled data collection. Once transferred, the files are moved to the repository\sent folder.

    Removing the Densify Connector

    If necessary, you can remove the Densify Connector from your local system. The uninstall utility will remove all files but not the collected data nor the configuration.

    1. From Windows Explorer, navigate to your install directory. For example, by default:
    2. C:\Program Files\Densify Connector\

    3. Double-click the uninstaller.
    4. C:\Program Files\Densify Connector\Uninstall Densify Connector

    5. The uninstall utility will indicate when it is complete.
    6. To remove the collected data and configuration, delete the entire install directory. For example, by default, remove the following directory:
    7. C:\Program Files\Densify Connector\

    SSL Certificate Management

    When using SSL-enabled connections for data transfer, the Densify Connector validates the certificate each time a connection is initiated to your Densify instance. The Connector loads the required certificate from your Densify instance.

    If the Densify Connector's certificate expires, it will re-load the certificate from Densify.

    This certificate validation only applies to your Densify instance, and not to vCenter data collection. Currently, the Connector automatically accepts certificates from the vCenter Servers that it is auditing.

    Troubleshooting Connector Issues

    Updating the Apache Log4j Files

    In December of 2021 a security issue was identified in the Apache Log4j libraries. The connector was patched and re-release, but several additional patches were released by Apache. You can use the following procedure to update v2.2.4.1 or v2.2.4.2 of the connector:

    1. Obtain the latest files from Densify or directly from Apache.
    2. Stop the Densify Connector service. See Restarting the Connector Service.
    3. Navigate to the installation location. By default C:\Program Files\Densify Connector\classes.
    4. Verify the version of the following 4 files:
      • log4j-1.2-api-2.17.1.jar
      • log4j-api-2.17.1.jar
      • log4j-core-2.17.1.jar
      • log4j-slf4j-impl-2.17.1.jar
    5. If they are not the latest (2.17.1 - as of January 2022) then delete them and replace them with the latest versions.
    6. Restart the Densify Connector service.