# StifleR Client Installation

## Prerequisites

* Windows 10 or later
* Supported are x86 or x64 versions of the operating systems
  * Professional, Enterprise or Ultimate versions
  * Newer Educational SKU is also supported
  * Microsoft .NET 4.8 must be installed on the client

## Installation

### **Automated Installation**

You can install the StifleR Client interactively, via the MSI wizard based install. This is described in the StifleR Planning and Deployment guide. For the purposes of expediency and testing however, we will install the client using the MSI command line.

For example:

To install the StifleR Client with default settings, in Windows Service Based Mode with a single StifleR server defined , and the URL for the StifleR rules XML download, run the following command line from an elevated command prompt:

```
msiexec /i StifleR.ClientApp.Installer64.msi INSTALLTYPE=2 STIFLERSERVERS=http://yourserverfqdn:1414 STIFLERULEZURL="http://yourserverfqdn/StiflerRules/StifleRulez.xml" UPDATERULESTIMERINSEC="3600" /qn
```

The full table showing the available MSI properties, switches, options and defaults can be found in the Planning and Deployment guide.

<table><thead><tr><th width="195">MSI Parameter</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>STIFLERSERVERS</td><td>The URL and port hosting the StifleR service.</td><td>http://yourserverfqdn:1414</td></tr><tr><td>STIFLERULEZURL</td><td>The URL hosting the StifleRulez.xml file.</td><td>http://yourserverfqdn/StiflerRules/StifleRulez.xml</td></tr><tr><td>INSTALLDIR</td><td>The location in which the program files should be installed. </td><td>C:\Program Files\2Pint Software\StifleR Client</td></tr></tbody></table>

### **Automated Installation via Script**

2Pint has provided an installation script which can be used to automate the installation as well as handle various scenarios which might occur during the installation. The script can be found at the following location:

<https://github.com/2pintsoftware/StifleRScripting/tree/master/InstallerScripts/Client>

The script implementation includes two files:

* StifleR\_Client\_Installer.ps1
* StifleRDefaults.ini

To deploy the script, all of the files and the StifleR.ClientApp.Installer64.msi should be placed in the same folder or content source folder. To customize the client installation for your environment, modify the StifleRDefaults.ini with the settings specific to your environment. \
To invoke the settings in the StifleRDefaults.ini file, use the following command:

```
.\StifleR_Client_Installer.ps1 -Defaults .\StifleRDefaults.ini
```

### **Manual Installation**

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

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

{% embed url="<https://2492782234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FhZODuja8MqhSVaAOxVo4%2F01-StifleRClient-10.2-Welcome.jpg?alt=media&token=f91a991e-832a-4de2-8e02-d932dd708329>" %}

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**.

{% embed url="<https://2492782234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FNYAkKoQUGtLqVYyohhL5%2F02-StifleRClient-10.2-EULA.jpg?alt=media&token=d709ab56-3a90-4c16-9744-afd3a1adaf5d>" %}

At the"StifleR Server(s) screen, enter the URL to the StifleR web service and port and then click **Next**.

{% embed url="<https://2492782234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FJGT7KbfjPeu6Garo5Vbb%2F03-StifleRClient-10.2-StifleRServer.jpg?alt=media&token=2e42ad2b-0cec-4710-887e-2ec70bbf9c8f>" %}

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

{% embed url="<https://2492782234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FWJy6gW5w9wyCFtFmGUgT%2F04-StifleRClient-10.2-DestFldr.jpg?alt=media&token=5bf2e893-0709-4487-a5da-10934a362d50>" %}

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

{% embed url="<https://2492782234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FyUzpDBNpL7aydzBhwGDH%2F05-StifleRClient-10.2-ReadyInstall.jpg?alt=media&token=c90bdb67-bd8a-41cb-9180-c10a5b377e40>" %}

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

{% embed url="<https://2492782234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FY9MZE0s8LGnTxlsdUF7R%2F06-StifleRClient-10.2-Completed.jpg?alt=media&token=d3bc23ac-197e-454b-9474-da2f21150b62>" %}
