The Microsoft System Center Virtual Machine Manager (SCVMM) integration with OpsRamp enables seamless management, monitoring, and optimization of virtualized data centers. By integrating SCVMM into OpsRamp, organizations gain enhanced visibility into their virtual infrastructure, allowing administrators to efficiently manage resources, troubleshoot issues, and maintain optimal performance.

Prerequisites

On Gateway

Before configuring the integration, ensure that your environment meets the following requirements related to gateway versions, credentials, and connectivity.

  • OpsRamp Classic Gateway (Linux) version 14.0.0 or later.
  • OpsRamp NextGen Gateway version 14.0.0 or later.
  • OpsRamp recommends using the latest Gateway version for full coverage of recent bug fixes and enhancements.
  • Ensure that the provided IP address/host name, port, and credentials are valid and accessible for successful integration.
    • Verify network connectivity from the gateway using:
      ping <IP Address/Host Name>
    • Check port accessibility using:
      telnet <IP Address/Host Name> <Port>

On Target Device

  • Customer need to provide SCVMM lab remote PowerShell user credentials with minimum operator level to fetch data from end device.
  • Windows domain user should be added to Performance monitor users group:
    net localgroup "Performance monitor users" /add <user>

Starting from Microsoft SCVMM version 1.3.0, the option to select the connectionMode is available. The supported options are:

  • PowerShell (existing)
  • OpenSSH (new)

If PowerShell is selected as Connection Mode

  • Windows domain user should be added to Remote Management users group:
    net localgroup "Remote Management Users" /add <user>

  • Enable PS Remoting and WMI Remoting on the end device. If the configured user is a non-administrator, ensure that the user has the necessary privileges for WMI remoting and Windows Services.

  • Add the OpsRamp Gateway IP to the TrustedHosts list on the target machine. This allows the PowerShell connection from the gateway to the target machine. To add TrustedHosts, use the following commands:

    • Allow any host:
      Set-Item WSMan:\localhost\Client\TrustedHosts -Force -Value *

    • Allow specific hosts:
      Set-Item WSMan:\localhost\Client\TrustedHosts -Force -Concatenate -Value <OpsRampGatewayIp>

  • Set up and restart the WinRM service for the changes to take effect.

    • To set up:
      Set-Service WinRM -StartMode Automatic

    • To restart the service:
      Restart-Service -Force WinRM

  • Ensure that ports 5985 (HTTP) and 5986 (HTTPS) are open for cluster and all nodes.

Use this command on the gateway to quickly check connectivity:

telnet <cluster or node ip> 5985/5986

  • Ensure that the provided IP address/host name and credentials are valid and accessible for successful integration. To verify connectivity from the gateway, follow these steps:

    1. Launch PowerShell using the pwsh command.
    2. Run the following commands to establish a remote session to your end device:
$pw = convertto-securestring -AsPlainText -Force -String "<password>"
$cred = new-object -typename System.Management.Automation.PSCredential -argumentlist "<username>", $pw
$session = new-pssession -computername "<ipAddress>" -credential $cred -Authentication Negotiate -ErrorAction Stop
$session.state

If OpenSSH is selected as Connection Mode

  • OpenSSH must be installed and configured on the target Windows machine.

  • Non-admin credentials with read-only administrator privileges is required.

  • Password authentication must be enabled in SSH config: PasswordAuthentication yes.

    • Edit sshd_config (run PowerShell as Administrator).
    • notepad C:\ProgramData\ssh\sshd_config
      Note: If sshd_config is not in this location, locate the correct path and perform the same steps.
      1. Find the line #PasswordAuthentication yes (or PasswordAuthentication no), uncomment it, and set it to yes.
      2. Find the line AllowUsers (or add it if missing) and set it to AllowUsers <ssh-username>.
      3. Save the file.
    • Restart-Service sshd
  • Ensure the sshd service startup type is Automatic:

    • Set-Service -Name sshd -StartupType Automatic
  • Set the OpenSSH default shell to powershell.exe on all nodes:

    • Set-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value "$PSHOME\powershell.exe"; Restart-Service sshd
  • Open default SSH port 22 on all nodes and cluster.

Configure Microsoft SCVMM

  1. To select your client, navigate to All Clients, and click the Client/Partner dropdown menu.
    Note: You may either type your client’s name in the search bar or select your client from the list.
  2. Navigate to Setup > Account. The Account Details screen is displayed.
  3. Click Integrations. The Installed Integrations screen is displayed with all the installed applications.
    Note: If you do not have any installed applications, you will be navigated to the Available Integrations and Apps page with all the available applications along with the newly created application with the version.
  4. Click + ADD on the Installed Integrations page.
    Note: Search for the integration either by entering the name of the integration in the search bar or by selecting the category of the integration from the All Categories dropdown list.
  5. Click ADD in the Microsoft SCVMM application.
  6. In the Configuration screen, click +ADD. The Add Configuration screen appears.
  7. Enter the following BASIC INFORMATION:


Field NameDescriptionField Type
NameA user-defined display name for the integration instance.String
Host Name / IP AddressEnter the Host Name / IP Address of the Microsoft SCVMM. It should be accessible from Gateway.String
CredentialsSelect the credential associated with your Microsoft SCVMM account. If you want to use the existing credentials, select them from the Select Credentials dropdown. Else, click +ADD to create credentials. The ADD CREDENTIAL window is displayed. Enter the following information.
  • Name: Enter the credential name.
  • Description: Enter the brief description of the credential.
  • User Name: Enter the Username.
  • Password: Enter the password.
  • Confirm Password: Confirm your password
  • Port:Select the port number from the dropdown.
  • Connection Timeout (ms):Specify the connection timeout in milliseconds.
Dropdown
Connection ModeChoose PowerShell or Open SSH based on the connection type with target device.
Note: PowerShell-based communication is planned for removal in upcoming releases due to security vulnerabilities. Migration to OpenSSH is recommended for continued support and improved security.
For more information, see Deprecation notice for PowerShell Communication.
Dropdown
App Failure NotificationsWhen selected, you will be notified in case of an application failure such as Connectivity Exception, Authentication Exception.Checkbox
Request TimeoutsSelecting this checkbox enables you to configure the timeout settings for NativeBridge connections and script execution requests made by the integration to the end device.Checkbox
Connection Timeout In MinsSelect the maximum time, in minutes, that the integration should wait while establishing a connection with the nativeBridge.
Default value: 10 minutes.
Dropdown
Connection Request Timeout In MinsSelect the maximum time, in minutes, required to process a NativeBridge HTTP call, from sending the request to receiving the response.
Default value: 10 minutes.
Dropdown
Socket Timeout In MinsSelect the maximum allowable time of inactivity between two data packets during data exchange with the server.
Default value: 10 minutes.
Dropdown
Script Execution TimeOut In MinsSelect the maximum execution time, in minutes, to be considered by the script. The default option is 5 minutes, with other available options being 10, 15, 20, 25, and 30 minutes.Dropdown
  1. Click ADD
  2. CUSTOM ATTRIBUTES: Custom attributes are the user-defined data fields or properties that can be added to the preexisting attributes to configure the integration.
Field NameDescriptionField Type
Custom AttributeSelect the custom attribute from the dropdown. You can add attributes by clicking the Add icon (+).Dropdown
ValueSelect the value from the dropdown.Dropdown

Note: The custom attribute that you add here will be assigned to all the resources that are created by the integration. You can add a maximum of five custom attributes (key and value pair).

  1. In the Native Types section, select the native types to be discovered.
  2. In the DISCOVERY SCHEDULE section, select recurrence pattern to add one of the following patterns:
    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
  3. Click ADD.

The configuration is saved and displayed on the configurations page after you save it.
Note: From the same page, you may Edit and Remove the created configuration.
12. Under the ADVANCED SETTINGS, Select the Bypass Resource Reconciliation option, if you wish to bypass resource reconciliation when encountering the same resources discovered by multiple applications.
Note: If two different applications provide identical discovery attributes, two separate resources will be generated with those respective attributes from the individual discoveries.
13. Click NEXT.
14. (Optional) Click +ADD to create a new collector. You can either use the pre-populated name or give the name to your collector.
15. Select an existing registered profile.

  1. Click FINISH.
    The integration is installed and displayed on the INSTALLED INTEGRATION page. Use the search field to find the installed integration.

Modify Microsoft SCVMM

Discover Resources in Microsoft SCVMM

  1. Navigate to Infrastructure > Search > Virtualization Management > Microsoft SCVMM. The Microsoft SCVMM page is displayed.
  2. Select the application on the Microsoft SCVMM page
  3. The RESOURCE page appears from the right.
  4. Click the ellipsis () on the top right and select View Details.
  5. Navigate to the Attributes tab to view the discovery details.

View resource metrics

To confirm Microsoft SCVMM monitoring, review the following:

  • Metric graphs: A graph is plotted for each metric that is enabled in the configuration.
  • Alerts: Alerts are generated for metrics that are configured as defined for integration.
  1. Click the Metrics tab to view the metric details for Microsoft SCVMM.