iPXE Anywhere Web Service Install

Pre-Requisites

• Windows Server 2019 (or above) with Microsoft .NET version 4.8 or higher..

• The user account executing the installation (installation account) must have Administrator rights on the server in which the web service will be installed as well as specific SQL permissions.

• License key (optional at this point)

• SQL Database - This database stores info about PXE booted computers and their capabilities. Traffic to this database is very small and, if necessary, it may be hosted on SQL Express. The SQL Database does not have to be installed on the same server as the iPXE Anywhere Web Service, but the service requires access to and permissions on the SQL Server in order to create the database and also to interact with it. See the Permissions page for more information.

Note: If the server hosting the SQL Server has older versions of TLS and cipher suites disabled, the installer may fail to complete the installation when the installer prompts the user to test the connection. To bypass authentication checks while in the installation wizard, use a command prompt to launch the installer with the following properties:

msiexec /i iPXEAnywhere.WebService.Installer64.msi CHECK_CREATE_DATABASE_PERMS=no CHECK_RUNTIME_DATABASE_PERMS=no

Installation

From an Elevated Command prompt launch iPXEAnywhere.WebService.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 "Select Certificate" screen, choose Http for non-encrypted client communication or Https for TLS based client communication. If using a non-self signed certificate, enter the certificate thumbprint as well. Click Next to continue.

At the "Database Server" screen, enter the server name \ instance of the SQL server which will host the iPXE Anywhere database, and then click Next.

At the "Database Name" screen, enter the database name you would like to define for the iPXE Anywhere database, and then click Next.

At the "Database Creation Credentials" screen, you will test to see if the account you are logged in as has the correct permissions to create the iPXE Anywhere database. You can alternatively use a SQL Authentication username and password, but this is not recommended. Click the Test Connection button to run the test. If it passes, click Next to continue. If it fails, modify the permissions to the SQL instance to grand your account permissions to create the database then try again.

At the "Destination Folder" screen, enter the path in which the iPXE Anywhere program files should be installed 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 kombucha, you’ve earned it.

Adding the Scripts Folder

Depending on the value of the EnableiPXEAnywhereWebService setting in the 2PXE Server Configuration File, you will likely need several scripts which you can download from the 2Pint Github repository.

1. Visit the 2Pint Github repository.

2. Click the <Code> link at the top menu.
3. The green Code button will appear, select it, and in the context menu, click Download ZIP.
4. Download the ZIP and extract the contents. The only folder needed is the "Scripts" folder.

5. Copy the Scripts folder to the iPXE Anywhere Web Service installation folder. As an example, the resulting path would be: C:\Program Files\2Pint Software\iPXE AnywhereWS\Scripts.