# Overview

Visit the 2Pint support Knowledge Base. There’s useful stuff in there – we promise.

If something is not right, ensure that the settings in 2PXE are set correctly. For each integration type the 2Pint.2PXE.Service.exe.config file values should be checked as follows

For Configuration Manager integration:

1. Stop the 2PXE Service if it is started
   1. Enable Configuration Manager Extension by setting **EnableSCCMExtension** to “1”
   2. Disable the PowerShell Extension by setting **EnablePowerShellExtension** to “0”
   3. Disable the referral only mode by setting **iPXEWSOnly** to “1"
   4. Set **EnableSCCMSQLConnection** to “1”
   5. Set **ConfigMgrSQLConnectionString** to the right one, basically you need the Server FQDN and the Configuration Manager DB name in there.
2. Enable iPXE Boot loaders by setting **EnableiPXEBootLoaders** to “1”.
3. Enable 2PXE HTTP server by setting **RunHttpServer** to “1”.
4. Optional: Enable Unknown Machines support by setting **EnableSCCMUnknownMachinesSupport** to “1”
5. Run the service in interactive mode as per below.

#### For PowerShell integration:

1. Stop the 2PXE Service if it is started
   1. Enable the PowerShell Extension by setting **EnablePowerShellExtension** to “1”
   2. Disable the Configuration Manager Extension by setting **EnableSCCMExtension** to “0”
   3. Disable the referral only mode by setting **iPXEWSOnly** to “1"
   4. Enable iPXE Boot loaders by setting **EnableiPXEBootLoaders** to “1”.
   5. Disable the 2PXE HTTP server by setting **RunHttpServer** to “0”.
   6. Check the **UseEmbeddedBootSDI** and set it to “0” if you don’t have the boot.sdi integrated in the image as described earlier in this document.
2. Ensure you have an IIS Virtual Directory for the wimboot.bin file, boot.sdi, and boot images (C:\ProgramData\2Pint Software\2PXE\RemoteInstall) and copy your boot images to the \Sources sub-folder. Also make sure that you have the correct MIME types setup. See the 2PXE Server PowerShell Mode Guide for these settings.
3. Edit the 2PXE PowerShell files and make sure it returns a proper URL to the files above.
4. Create a Windows Firewall rule to allow incoming TCP traffic to the 2PXE Web service on port 8050
5. Bounce the service and check for errors

### Running the service interactively

Ensure that the service is stopped before doing this.

You can run the service directly from either a console or by double clicking the executable from within Windows Explorer. This starts the service in a command prompt window, allowing for simple troubleshooting as you can observe directly while the boot request rolls through the console window.

When running in interactive mode all debug logging will be pushed to the console window. This will greatly help when you run into issues or want to showcase the technology. Please note that the console runs under the user executing it and not the service account (SYSTEM by default) which can lead to access violations.

Note that boot speed can also be greatly reduced as the printing to console will take longer than the actual actions. We recommend that this mode is only used for testing or troubleshooting and is best utilized while booting only a single system.

As an example, the following screen shows the executable being run in interactive mode, failing to bind to HTTP.SYS as the port is being used by another process.

![](/files/-LlIDfxIZqT2qSBV-5XZ)

Figure 9 shows the 2PXE service running interactively, failing to bind to the HTTP port (due to the service already running).

### Helpful Logs & Files:

During WinPE, these are helpful in troubleshooting, if you send a support request, please have these ready to send if you're having issues on the client side.

* **smsts.log** in x:\Windows\Temp\SMSTSLog\\
* **2PSiPXEWinPEClient.log** in x:\Windows\Temp
* **smstftp.log** in x:\Windows\Temp
* **ipxews.ini** in x:\Windows\System32

### Errors & Issues

There are many things that can go wrong in 2PXE. If the machine is not booting it’s likely that you have set a configuration that is invalid. Check the valid configuration options and if you can’t find the issue enable debug logging and send us the log after trying to boot an image. Please include any PowerShell scripts as well as the .config file in the email. Email the files to <support@2pintsoftware.com> or use our online forums.

Note: Don’t forget to add all the files to a .zip folder otherwise the email might get caught in a spam or antivirus filter.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.2pintsoftware.com/2pxe-server/troubleshooting/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.