StifleR
2.10
2.10
  • Start Here - StifleR 2.10
  • Introduction
    • StifleR Overview
      • The StifleR Solution
      • Managing Microsoft Data Transfer Services
    • Technical Overview
      • 2Pint BranchCache Administrator Guide
    • Features Overview
      • Control
      • Monitor
      • Automate
      • Other Features
      • StifleR Feature Details
    • Release Notes
  • Proof of Concept
    • Objectives and Prerequisites
    • Configure Microsoft Peer-to-Peer Components
    • Install and Configure StifleR
    • Testing and Validation
    • StifleR POC Quick Checklist
  • Planning
    • StifleR Server Considerations
    • StifleR Client Considerations
    • Firewall Ports
    • Permissions
    • Antivirus Exclusions
    • Network Topology
    • StifleR Generic Concepts
      • Client Leader Roles
        • Red Leader
        • Blue Leader
        • Green Leader
        • Examples of Leader Selection
      • Templates
      • Beacons
  • Installation
    • Overview
    • Server
      • StifleR Server Installation
      • StifleR Dashboard Installation
      • StifleR Beacon Installation
    • Client
      • StifleR Client Installation
      • Post Installation Checks
  • Configuration
    • Configuration Files
      • StifleR Server Configuration File
        • Using the AppSettings Override File
      • StifleR Client Configuration File
      • StifleR Dashboard Configuration File
    • Configuring BranchCache on Windows Server
    • Configuring Delivery Optimization
    • Configuring LEDBAT on CM DPs
    • Configuring a Beacon Server
    • Configuring StifleR SQL History
    • StifleR Network Locations
      • Automatic linking of Location, Network Groups and Networks
      • Network Topology Automation
      • Location Fields
        • Network Group Fields
          • Network Fields
    • StifleRulez.xml Configuration Guide
      • The Match – TypeData
        • When the Job Title Isn’t Suitable
        • ConfigMgr Specific Rules
      • The Setting - DownloadTypes
        • Delivery Optimization Jobs
      • Sample StifleRulez.xml
    • Securing StifleR Operations with SSL
      • Prerequisites
      • Using a Web Server Certificate
        • Requesting a Web Server Certificate
      • Using a Self-Signed Certificate
      • Preparing the StifleR Dashboard Web Site for SSL
      • Configuring StifleR to Use SSL
      • Finding the Certificate Thumbprint
    • StifleR Client Access Control Options
  • Operations
    • Dashboard
      • Overview & Navigation
        • Home Page
        • Traffic & Downloads
          • Transfers & Downloads
            • How to use query hosts search?
          • Running Sequences
          • Weekly Downloads Activity
          • History
        • Devices
          • Clients
            • Client Details
              • How to use an extended search?
          • Servers
          • StifleR Server
            • Templates Detail
        • Cache Management
        • System Resource Usage
        • Network Topology
          • Maps
          • Countries
          • Locations
            • Bandwidth Allocations and Locations
          • Network Groups
          • Networks
        • Reporting & Diagrams
    • Client Management & Remote Tools
      • Remote PowerShell Session
      • Remote Performance Counter
      • Remote WMI Browsing
      • Remote Event Log Viewer
      • Remote Netmon Session
    • Monitoring
      • StifleR server health
      • StifleR client health
      • BranchCache Testing and Monitoring
    • Maintenance tasks
    • Bandwidth Management and Allocation
      • Bandwidth Tuning Monitoring and Control
    • Backup and Recovery
      • Moving the StifleR Server Databases to a New Drive on the Same Server
    • Troubleshooting
      • StifleR Client Command Line Options
      • BranchCache across Subnets
    • StifleR WMI Provider
Powered by GitBook
On this page
  • Prerequisites
  • Optional Components
  • Installation
  • Manual Installation
  • Configuring the StifleR Rules XML Site
  • Post Installation Checks
  • Checking the StifleR Service State
  • Checking the StifleR Installation Directory
  • Checking the Event Logs
  • Checking WMI Configuration
  • Checking API Permissions
  • Checking StiflerRules Web Site Availability
  1. Installation
  2. Server

StifleR Server Installation

PreviousServerNextStifleR Dashboard Installation

Last updated 3 months ago

Prerequisites

  • Microsoft .NET 4.8

  • Installation account must have Administrator rights

  • Create and populate the

  • Open the required

  • License.cab or license key (optional at this point)

  • Review page for server specs, etc.

  • Decide on whether the StifleR Service will be using SSL (optional at this point, but recommended). For more information on using SSL, see .

Optional Components

Internet Information Services (IIS):

The StifleR Server API runs its own web service, so IIS is NOT required unless:

  • You will also be installing the StifleR Dashboard on the same server.

  • You will be hosting the site on the same server.

Installation

Manual Installation

From an Elevated Command prompt launch StifleR.Installer64.msi.

At the "Welcome" screen, feel welcomed, and then click Next.


At the "End-User License Agreement" screen, once you have reviewed the EULA, check the box: I accept the terms in the License Agreement, and then click Next.


At the "Select License Type" screen, choose the license type, and then click Next.

NOTE: The installer does not check whether the license information is valid. If you select an incorrect license file or enter an invalid key, the installer will continue but the StifleR service may stop soon after starting.


At the "Service Logon Credentials" screen, choose the Logon Type, and then click Next.

Note: If using a local or domain account, the account must have "Logon as a Service" rights.


At the "Port Selection" screen, enter a Port Number, or accept the default port 1414, and then click the Test Port button. If the port is open, a green check mark will appear. If the port is not open, validate that the port is available. Once complete, click Next.


At the "Select Certificate" screen, you can choose whether you want to use Http or Https for StifleR Client to Server communications. If you choose Https, also enter the certificate thumbprint for the self-signed certificate which is installed when StifleR is installed or from another installed certificate. If this is a fresh installation of StifleR, choose Http and switch to Https (recommended) at a later time. Once complete, click Next.


At the "Destination Folder" screen, enter the path in which the StifleR server program files should be installed and then click Next.


At the "Select Firewall Configuration" screen, choose whether you would like the installer to create firewall exceptions for the SignalR port and the Web Service API ports. Click Next to continue.

Note: If a port number other than the default (port 1414) was defined earlier in this wizard, that port will be opened and not the default.


At the "Select Administrators Group" screen, continue with the default groups, or enter custom groups and then click Next.


At the "Ready to install..." screen, click Install to begin the installation.


At the "Completed" screen, the installation wizard is complete. Click Finish and enjoy a nice cup of tea, you’ve earned it.

Configuring the StifleR Rules XML Site

The StifleR client will check through its queue of active downloads (both BITS and DO) and will prioritize them according to a locally held XML configuration file referred to as the StifleR Rules XML file. The Stifler Rules XML contains a list of content download jobs types and priorities which can centrally managed by an administrator from any web server. When deploying the StifleR Client, one of the installation options is to include the URL hosting the rules file. Clients will download the rules definition XML at a configurable interval. In order to use the StifleR Rules XML file, a website must be created and the StifleRulez.xml file should be copied to the root directory of the website.

IIS Installation Requirement

The minimum IIS role and features required can be installed by using the following PowerShell command:

Install-WindowsFeature -Name Web-Server, Web-Windows-Auth -IncludeManagementTools

File location

Place the StifleRulez.xml in the following folder on the StifleR server:

C:\ProgramData\2Pint Software\StifleR\Rules

Create a Virtual folder in IIS

From an elevated PowerShell prompt, execute the following command:

New-WebVirtualDirectory -Site "Default Web Site" -Name StiflerRules -PhysicalPath "C:\ProgramData\2Pint Software\StifleR\Rules"

The above command will create a website which you will reference during the StifleR client installation.

​Ex: http://yourserverfqdn/StiflerRules/stiflerulez.xml

Note: If you do not configure your own internal rules definition URL, the clients will use a default version of the XML which is included within each client build.

Post Installation Checks

Checking the StifleR Service State

Open services.msc to validate that the 2Pint Software Stifler Server service is installed and running, or run the following PowerShell command and validate that the service is present and running:

Get-Service -Name StifleRServer | Select Status

Checking the StifleR Installation Directory

  • If using a licensing file for licensing, check for the License.nfo files. If this is missing the service may not be licensed properly.

  • are present.

Checking the Event Logs

To validate that the StifleR Server Event Logging structure has been created, execute the following PowerShell command:

Get-WinEvent -ListLog TwoPintSoftware-StifleR.Service-* | Where-Object { $_.RecordCount }

Validate the following output:

Checking WMI Configuration

Execute the following PowerShell command to verify that the WMI Class Root\StifleR and methods were created successfully:

Get-CimClass -Namespace Root\StifleR -ClassName StifleREngine | where {$_.CimClassMethods} | Select CimClassName, CimClassMethods

Validate the following output:

Execute the following PowerShell command to get the StifleR License information:

Get-CimInstance -NameSpace Root\StifleR -ClassName StifleREngine

Validate the following output:

Checking API Permissions

To test access to the StifleR Server API, open a web browser, and enter the StifleR Server URL such as:

http(s)://servername:9000/api/test

The page should display the results of your permissions such as the example below:

Checking StiflerRules Web Site Availability

To test access to the StifleR Rules Web Site, open a web browser, and enter the StiflerRules URL such as:

http://yourserverfqdn/StiflerRules/stiflerulez.xml

The page should display the contents of the XML file such as the example below:

Note: The administrators groups are not created automatically. They must be created in advance. Please refer to the section.

The latest version of the StifleRulez.xml file can always be found here:

For detailed information regarding the StifleRulez.xml file, see the following page:

Open up the configuration file, , and check that the expected values

https://github.com/2pintsoftware/StifleRRules/blob/master/StifleRulez.xml
StifleRulez.xml Configuration Guide
StifleR.Service.exe.config
firewall ports
StifleR Server Considerations
this page
StiflerRulez
StifleR Administrative Security Groups
StifleR Administrative Security Groups