# 2Pint PXE Server Manual Installation

## Prerequisites

The following items must be installed and configured on the 2PXE Server regardless of which handler you will be using (Configuration Manager or PowerShell)

* Windows Server 2019 (or above) with Microsoft .NET version 4.8 or higher.
* The Visual C++ Runtime for Visual Studio must be installed (not necessary if the Configuration Manager client is installed)
* Installation account must have Administrator rights. Please see this page regarding other [permissions](https://documentation.2pintsoftware.com/2pxe-server/3.6/planning/permissions).
* If you want to use Configuration Manager, the 2PXE Server must be installed on a Configuration Manager Distribution Point
* License key (optional at this point)

## Installation

From an Elevated Command prompt launch **2Pint Software 2PXE Service (x64).msi**.

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2F8w2BEVFt0lPab1pj0AGu%2F01-2PXEServer-3.5-Welcome.jpg?alt=media&token=49aa93c0-cae4-40fa-bcea-007d386edbe4>" %}

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://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FzuHgv9MJRojkGZ0IJbw6%2F02-2PXEServer-3.5-EULA.jpg?alt=media&token=cd0304b4-e187-4cf3-8b89-a2def8ff9745>" %}

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.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FwFEgt8j45j6iEK4VEh6S%2F03-2PXEServer-3.5-License.jpg?alt=media&token=1e3ce70a-6bc5-4ed6-96bf-b9051976540c>" %}

At the "Select Operation Mode and Parameters" screen, select **Configuration Manager**, and then select either of the various options:

**PowerShell Integrated Installation -** this option should be used when not integrating with Microsoft Configuration Manager.\
**Configuration Manager - Requires DP Role Installed -** this option should be used when integrating with Microsoft Configuration Manager. \
**Referral to iPXE Web Service Only - No license required -** this option should be used when configuration and licensing is handled by the iPXE Anywhere Web Service.

* **Use SQL for ConfigMgr DB Access instead of HTTP (Recommended) -** this option configures the 2PXE Server to directly query the Configuration Manager database for deployment information rather than query the Management Point. Using this option increases performance. The server hosting the 2PXE service must be granted [specific access](https://2pxe.docs.2pintsoftware.com/planning/permissions#allowing-access-to-the-configuration-manager-sql-database) for this to work.&#x20;
* **Enable Unknown Machine Support for ConfigMgr -** select this option to enable unknown computer support as you would when enabling the option on a PXE-enabled Distribution Point in Configuration Manager.
* **Use HTTPS for iPXE to 2PXE Communication (Recommended) -** select this option to enable HTTPS based communications from an iPXE booting client to the 2PXE server. This only takes effect after the initial boot program has been delivered to the client, when HTTP based communication initiates, aka the Windows Boot Image.&#x20;
* **Bind to single IP (Recommended) -** select this option to choose the IP address which should be used to listen and serve PXE requests. If left unchecked, the 2PXE server will determine the best IP to bind to.

&#x20;Once complete, click **Next**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FjAQs1As0l7ABAX8GwXBs%2F04-2PXEServer-3.5-OpsMode.jpg?alt=media&token=3635a1d4-0461-4812-8a71-8fc9e9f02e31>" %}

At the "iPXE Anywhere Web Service Integration" screen, choose either of the following options:

**Standalone Installation -** use this option if an iPXE Anywhere Web server is not installed

**iPXE Anywhere Web Service integrated -** use this option if an iPXE Anywhere Web server is installed. In the text box, enter the URL and port of the iPXE Anywhere server. \
\&#xNAN;*Ex: <http://yourserver.company.local:8051>*

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FnM6VGbJffEjdzZPUxxM9%2F05-2PXEServer-3.5-WebSvcIntegration.jpg?alt=media&token=945abe70-5f27-470e-90b1-e6a86d77bbde>" %}

At the "Service Account" screen, choose the logon type and then click **Next**.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FZsMo5jiUEJOHNyXAuwVI%2F06-2PXEServer-3.5-SvcCreds.jpg?alt=media&token=a07c2e5e-505f-4eea-ad03-cb93a85206b4>" %}

At the "Port Selection" screen, enter a **Port Number**, or accept the default port 8050, 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**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FtuDaEGrf6xc0QqYNtxj3%2F07-2PXEServer-3.5-Port.jpg?alt=media&token=106073f8-e758-403c-81c9-ae890cbfd6f4>" %}

{% hint style="info" %}
Note: The next three screens will not be displayed if the following options in the previous screen were not selected:\
**Configuration Manager - Requires DP Role Installed** or

**Use SQL for ConfigMgr DB Access instead of HTTP (Recommended)**&#x20;
{% endhint %}

At the "Database Instance" screen, enter the Server Name \ Instance hosting the Configuration Manager database.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FhgIukjA6tGuJqUhoncy0%2F08-2PXEServer-3.5-CMDBServer.jpg?alt=media&token=ebab4a5a-6c0f-4390-8550-e52526ea81c0>" %}

At the "Database Name" screen, enter the name of the Configuration Manager database and then click **Next**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2Fzm9fUFHuO1V4xmqpFNi7%2F09-2PXEServer-3.5-CMDBName.jpg?alt=media&token=1f45c45d-7e6f-44ea-84cf-148c47d74181>" %}

At the "SQL Account" screen, choose the authentication mechanism to connect to the Configuration Manager database. "Windows integrated authentication" is recommended. \
Once complete, click **Next**.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FEcZxjPH6OStYB6ibtdJT%2F10-2PXEServer-3.5-SQLAccount.jpg?alt=media&token=1f61a4c7-ced6-4fa8-ab80-dd0e1761531a>" %}

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2F6jTeuTDrWkcxLumN69M7%2F11-2PXEServer-3.5-DestFldr.jpg?alt=media&token=def5d185-16ee-4efb-a568-f49e8915663b>" %}

At the "Select Firewall Configuration" screen, choose whether you would like the installer to create firewall exceptions for the ports required for iPXE to function. Click **Next** to continue.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2F2TxDzG0qUEUBn2kgxz98%2F12-2PXEServer-3.5-Firewall.jpg?alt=media&token=3aecfe37-675d-490d-9cb2-5030df927389>" %}

At the "Username and password for iPXE" screen, enter a service account to use to connect to the distribution point. If you are using HTTP, and the DP is not in anonymous mode, you need to define an iPXE Network Access Account. This can be left at default if you are using HTTPS. Once complete, click **Next**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2F7RTmwlr9M5GOCkUhsjnR%2F13-2PXEServer-3.5-iPXEAcct.jpg?alt=media&token=bbd6ca1c-f97a-4904-b9e2-353aa2c2305e>" %}

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FfLXpWp8CML0PULnmkG9t%2F14-2PXEServer-3.5-ReadyInstall.jpg?alt=media&token=6a376239-9a27-4d93-8102-c5dd4802b4b4>" %}

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKVCPrZcvHg064pgPXykG%2Fuploads%2FWeD2aE82TCHdchNbJxHD%2F15-2PXEServer-3.5-CompletedSetup.jpg?alt=media&token=a742608b-b0ab-497e-a233-12821a03718b>" %}
