Installing ITM On-Prem (ObserveIT) Application Server

The ITM On-Prem (ObserveIT) Application Server is the data ingestion component. It receives and processes the raw data received from the ITM On-Prem (ObserveIT) Agents.

Depending on the sizing and architecture of the product deployment, you must install one or more ITM On-Prem (ObserveIT) Application Server(s).

This Application server is installed after you install the database and file server.

This topic describes how to install and verify the ITM On-Prem (ObserveIT) Application Server component on the first server. If you have multiple Application Servers, you need to repeat this procedure for each machine.

Do not attempt to install ITM On-Prem (ObserveIT) server-side components over the network. Always use a local copy of the installation files.

Installing the Application Server with PowerShell

You can use the following PowerShell commands to install the ITM On-Prem (ObserveIT) Application Server. (This is the recommended procedure.) 

Optionally, you can use the Application Server manually, see Installing ITM On-Prem (ObserveIT) Application Server (Manual).

Prerequisites:

  1. Connect (with RDP) to the server that will host the ITM On-Prem (ObserveIT) Application Server as the Active Directory Service Account.

  2. Download the ITM On-Prem (ObserveIT) Installer into c:\temp and extract the contents. (See Downloading the Latest Version.)

    (Assume the installer files are extracted to c:\temp\ObserveIT_Setup_vx.xx.y.yy path, where x.xx the major ITM On-Prem (ObserveIT) version, and y.yy is the minor version and build.)

  3. Run PowerShell as Administrator.

  4. From the table below, copy the rows from Command column, replacing the values as applicable. The Values to Replace column indicates which values you will need to replace.

    Paste the commands into the PowerShell window.

    Command Values to Replace
    $observeitInstallerPath = "c:\temp\ObserveIT_Setup_vx.xx.y.yy" Replace the generalized path with the correct path for your ITM On-Prem (ObserveIT) Installer . For example: C:\temp\ObserveIT_Setup_v7.11.0.25
    $SQLServer = '<# FQDN of the SQL Server #>' Replace the commented section with FQDN of your SQL Server
    $DNSForestName = "<# enter your DNS domain name here #>" Replace the commented section with the DNS domain name of your Active Directory. For example: domain.local.
    $Creds = Get-Credential  
    $WebSiteName = 'ObserveITApplicationServer'  
    $WebSitePort = "443"  
    $WebSiteProtocol = "https"  
    $ComputerName = (Get-WmiObject -Class Win32_ComputerSystem).PSComputerName  
    $MachineFQDN = $ComputerName + '.' + $DNSForestName  
    $ApplicationPool = "IIS:\AppPools\$WebSiteName"  
    $WebSiteBinding = ":" + $WebSitePort + ":"  
    $OutputDestination = 'C:\temp'  
    $gmsaUser="1" Optional for gMSA account
    $hotStorage= ‘\\unc-path\’ Replace the path with the correct path to your hot storage,
    $warmStorage= ‘\\unc-path\’ Replace the path with the correct path to your warm storage,
    $archiveStorage= ‘\\unc-path\’ Replace the path with the correct path to your archive storage,
  5. When PowerShell prompts, Enter your Active Directory Service Account credentials here, enter the username in the format DOMAIN\account.

  6. Install the required Windows features:

    Install-WindowsFeature Web-Server, Web-WebServer, Web-Common-Http, Web-Default-Doc, Web-Dir-Browsing, Web-Http-Errors, Web-Static-Content, Web-Stat-Compression, Web-Security, Web-Filtering, Web-App-Dev, Web-Net-Ext45, Web-Asp, Web-Asp-Net45, Web-ISAPI-Ext, Web-ISAPI-Filter, Web-Mgmt-Tools, Web-Mgmt-Compat, Web-Mgmt-Console, NET-WCF-Services45, NET-WCF-HTTP-Activation45 -IncludeManagementTools

  7. Create the directory and Microsoft IIS folder structures:

                        New-Item -Name ObserveIT -Path "C:\Program Files" -ItemType Directory
    New-Item -Name Web -Path "C:\Program Files\ObserveIT" -ItemType Directory
    Import-Module WebAdministration
    New-Item $ApplicationPool -Force
    New-Item IIS:\Sites\$WebSiteName -PhysicalPath 
    'C:\Program Files\ObserveIT\Web\' `
    -Bindings @{protocol = $WebSiteProtocol; bindingInformation = 
    $WebSiteBinding } -Force
    Set-ItemProperty IIS:\Sites\$WebSiteName\ -Name applicationpool -Value 
    $WebSiteName -Force
    
                    
  8. Require SSL for connections to the ITM On-Prem (ObserveIT) Application Server websites:

    Import-Module WebAdministration
    $ConfigSection = Get-IISConfigSection -SectionPath 
    "system.webServer/security/access" -Location "$WebSiteName"
    Set-IISConfigAttributeValue -AttributeName sslFlags -AttributeValue 
    Ssl -ConfigElement $ConfigSection
    Get-IISConfigAttributeValue -ConfigElement $ConfigSection 
    -AttributeName sslFlags
    
  9. Disable IIS logging:

    Set-ItemProperty -Path "IIS:\Sites\$WebSiteName" -Name Logfile.enabled -Value $false

  10. Configure the best-practice IIS Application Pool recycling settings:

    Import-Module WebAdministration
    $AppPoolPath = "IIS:\AppPools\$ApplicationPool"
    # Set the Application Pool to recycle every 8 hours
    Set-ItemProperty $AppPoolPath -Name Recycling.periodicRestart.time -
    Value 0.08:00:00
    Clear-ItemProperty $AppPoolPath -Name 
    Recycling.periodicRestart.schedule
    $RestartAt = @('12:00', '20:00', '07:00')
    # Set recycling to occur at 12pm, 8pm, and 7am, when there's less load on the system
    New-ItemProperty -Path $AppPoolPath -Name 
    Recycling.periodicRestart.schedule -Value $RestartAt
    
  11. Assign the provisioned TLS certificate to the ITM On-Prem (ObserveIT) Application Server website. (The TLS certificate was provisioned in Back-end Components Prerequisites.)

  12. Right-click the Start Menu and click Run.

  13. Type inetmgr and click OK.

  14. In the Microsoft Internet Information Services management console, select and expand your server and then expand Sites.

  15. Right-click the ObserveITApplicationServer website and click Bindings.

  16. Select the row starting with https in the Site Bindings window and click Edit.

  17. From the SSL certificate drop-down, at the bottom of the window, select your provisioned TLS certificate.

  18. Click OK to apply the settings.

  19. Click Close in the Site Bindings window.

  20. Install ITM On-Prem (ObserveIT) Application Server prerequisites:

    $NodeJSInstaller = $observeitInstallerPath + '\Web\PreRequisite_nodeServices.exe' $ComponentInstallArguments = "wconly=1", "sqlcli=1", "/install", "/quiet", "/norestart" ,"/log PreRequisite_nodeServices.log" Start-Process $NodeJSInstaller -ArgumentList $ComponentInstallArguments -Wait

  21. Assign Logon as Service Rights to the Active Directory Service Account::

    function Set-LogonRight ($accountToAdd) {
        if ( [string]::IsNullOrEmpty($accountToAdd) ) {
            Write-Output "no account specified"
            exit
    }
        $sidstr = $null
    try {
            $ntprincipal = new-object System.Security.Principal.NTAccount "$accountToAdd"
            $sid = $ntprincipal.Translate([System.Security.Principal.SecurityIdentifier])
            $sidstr = $sid.Value.ToString()
    } catch {
            $sidstr = $null
    }
        Write-Output "Account: $($accountToAdd)"
        if ( [string]::IsNullOrEmpty($sidstr) ) {
            Write-Output "Account not found!"
            exit -1
    }
        Write-Output "Account SID: $($sidstr)"
        $tmp = [System.IO.Path]::GetTempFileName()
        Write-Output "Export current Local Security Policy"
        secedit.exe /export /cfg "$($tmp)" 
        $c = Get-Content -Path $tmp 
        $currentSetting = ""
        foreach ($s in $c) {
            if ( $s -like "SeServiceLogonRight*") {
                $x = $s.split("=", [System.StringSplitOptions]::RemoveEmptyEntries)
                $currentSetting = $x[1].Trim()
        }
    }
        if ( $currentSetting -notlike "*$($sidstr)*" ) {
            Write-Output "Modify Setting ""Logon as a Service"""
            if ( [string]::IsNullOrEmpty($currentSetting) ) {
                $currentSetting = "*$($sidstr)"
        } else {
                $currentSetting = "*$($sidstr),$($currentSetting)"
        }
            Write-Output "$currentSetting"
    $outfile = @"
    [Unicode]
    Unicode=yes
    [Version]
    signature="`$CHICAGO`$"
    Revision=1
    [Privilege Rights]
    SeServiceLogonRight = $($currentSetting)
    "@
            $tmp2 = [System.IO.Path]::GetTempFileName()
            Write-Output "Import new settings to Local Security Policy"
            $outfile | Set-Content -Path $tmp2 -Encoding Unicode -Force
            Push-Location (Split-Path $tmp2)
        try {
                secedit.exe /configure /db "secedit.sdb" /cfg "$($tmp2)" /areas USER_RIGHTS 
        } finally { 
                Pop-Location
        }
    } else {
            Write-Output "NO ACTIONS REQUIRED! Account already in ""Logon as a Service"""
    }
        Write-Output "Done."
    }
    
    Set-LogonRight "$($Creds.GetNetworkCredential().UserName)"
    
  22. Install the ITM On-Prem (ObserveIT) Application Server:

    $ComponentInstallArguments = "/i", ($observeitInstallerPath + '\Web\AppServer\ObserveIT.AppServerSetup.msi'), "/qb", "/norestart", "DATABASE_SERVER=$SQLServer", "TARGETAPPPOOL=$WebSiteName", "TARGETSITE=$WebSiteName", "DATABASE_LOGON_TYPE=WindowsAccount", "SERVICE_USERNAME=$($Creds.GetNetworkCredential().Domain + '\' + $Creds.GetNetworkCredential().UserName)", "SERVICE_PASSWORD=$($Creds.GetNetworkCredential().Password)",HOT_STORAGE=$hotStorage",WARM_STORAGE=$warmStorage, ARCHIVE_STORAGE=$archiveStorage,"/leo", ".\AppServerMSI.log"

    For gMSA user (recommended): 

    $ComponentInstallArguments = "/i", ($observeitInstallerPath + '\Web\AppServer\ObserveIT.AppServerSetup.msi'), "/qb", "/norestart", "DATABASE_SERVER=$SQLServer", "TARGETAPPPOOL=$WebSiteName", "TARGETSITE=$WebSiteName", "DATABASE_LOGON_TYPE=WindowsAccount", "SERVICE_USERNAME=$($Creds.GetNetworkCredential().Domain + '\' + $Creds.GetNetworkCredential().UserName)", "GMSA_USER=$gmsaUser","/leo", ".\AppServerMSI.log"

    For details about gMSA, see ITM Windows Install using gMSA Account.

    Start-Process msiexec.exe -ArgumentList $ComponentInstallArguments -Wait -NoNewWindow

  23. Validate the ITM On-Prem (ObserveIT) Application Server is installed correctly:

    add-type @"
        using System.Net;
        using System.Security.Cryptography.X509Certificates;
        public class TrustAllCertsPolicy : ICertificatePolicy {
            public bool CheckValidationResult(
                ServicePoint srvPoint, X509Certificate certificate,
                WebRequest request, int certificateProblem) {
                return true;
            }
        }
    "@
    [System.Net.ServicePointManager]::CertificatePolicy = New-Object TrustAllCertsPolicy
    iisreset /start
    Import-Module WebAdministration
    Get-IISSite $WebSiteName | Start-IISSite
    $CurrentURL = $WebSiteProtocol + '://localhost:' + $WebSitePort + '/ObserveitApplicationServer/v2/apis/health/_health'
    Invoke-WebRequest $CurrentURL -UseBasicParsing
    

    If successful, the PowerShell prompt returns several values. One of the top values will be the code 200.

Installing ITM On-Prem (ObserveIT) Application Server (Manual)

  1. From the Command Prompt, select Run as administrator.

    If prompted, Do you want to allow this app to make changes to your device?, select Yes.

  2. Navigate to the folder with the extracted ITM On-Prem (ObserveIT) Installer. Navigate to the Web folder.

    For example:

    c:\Users\OITServiceAccount\Desktop\ObserveIT_Setup_vx.x.x.xx\Web

  3. Run PreRequisite_nodeServices.exe.

    Check the check box with the message I agree to install the following products and click Install.

    Wait for the installation to finish and then click Close.

  4. From the command line, as an administrator, navigate to the folder with the extracted ITM On-Prem (ObserveIT) Installer. Navigate to the Web folder.

    For example: cd c:\Users\OITServiceAccount\ObserveIT_Setup_vx.x.x.xx\Web\AppServer

  5. Open the Start menu and type Command Prompt.

  6. Right-click the Command Prompt shortcut icon and select Run as administrator.

    If prompted Do you want to allow this app to make changes to your device?, click Yes.

  7. From the command line, as an administrator, navigate to the folder with the extracted ITM On-Prem (ObserveIT) Installer . Navigate to the Web folder.

    For example: cd c:\Users\OITServiceAccount\ObserveIT_Setup_vx.x.x.xx\Web\AppServer

  8. Type ObserveIT.AppServerSetup.msi and Enter.

  9. In the ITM On-Prem (ObserveIT) Application Server window click Next.

  10. In the Site field, select ObserveITApplication.

  11. In the Application Pool field, select ObserveITApplication. Click Next.

  12. In the Server field, enter the details of the SQL server, in the following format:

    <ServerFQDN>\<InstanceName>,<Port>

    For example: SQLsrv.test.lab\ObserveIT,1433

  13. Select the Windows Authentication radio button and enter the password for the current account – the ITM On-Prem (ObserveIT) Service Account - in the Password field. Click Test Connection.

    If the test is successful, a success message displays.

  14. When prompted, add the path to HOT, WARM and ARCHIVE Storage. (If this is a new installation, these fields will be available. If this is an upgrade and you have already designated paths, the fields will be grayed-out.

  15. Click Next. The installation begins.

    After successful installation, click Close.

Related Topic:

Custom Installation Steps