This guide walks through the simplified process of setting up IIS (Internet Information Services) for use with SwiftPOS, particularly for Order Away, PDT, and other services.

Video Demonstration:  


https://www.youtube.com/watch?v=0e1iShisJXg&list=PLni2SLbPJ1LirXbWwI-Wu433wBKPp6CHo&index=1&pp=iAQB


Here's the detailed troubleshooting process with timestamps added:

(Note the following has been generated using Ai Transcribing so use both the video and script as a guide) 


Step 1: Install IIS (0:10)

  1. Access the Control Panel:

    • Open Control Panel, go to Programs and Features, and then click Turn Windows Features On or Off.
  2. Enable IIS Features:

    • Scroll down and check Internet Information Services (IIS).
    • Expand Application Development Features and ensure you select:
      • ASP.NET 4.8: This enables support for running .NET applications.
      • Application Initialization: Required to ensure the application stays alive and doesn’t go idle.
  3. Install the IIS Management Console:

    • If you haven’t already, also check IIS Management Console so you can manage IIS sites and applications via the graphical interface.
  4. Complete the Installation:

    • Click OK to install the selected features. Wait for the installation to finish. Once done, you can close the window and proceed.

Step 2: Open and Configure IIS (1:27)

  1. Open IIS Manager:

    • Use the Windows search function to search for IIS Manager, then open it.
  2. Verify IIS is Installed:

    • After opening IIS Manager, verify the IIS installation. You will see the server node listed, but there will be no sites or applications yet.
  3. Create a New Application Pool for SwiftPOS:

    • Right-click Application Pools in the IIS Manager sidebar and select Add Application Pool.
    • Name the pool (e.g., SwiftPOS Application Pool).
    • Set the .NET CLR version to v4.0.
    • Click OK to create the pool.
  4. Configure the Application Pool Settings:

    • Right-click on the new SwiftPOS Application Pool and choose Advanced Settings. Configure the following:
      • Enable 32-bit Applications: Set this to True. This is necessary for SwiftPOS, which uses 32-bit components.
      • Idle Time-Out: Set this to 0 to prevent the application from going idle and stopping unexpectedly.
      • Regular Time Interval: Set this to 1440 minutes for recycling the application pool daily, based on the system's requirements.

Step 3: Add a Web Application for SwiftPOS (3:05)

  1. Add an Application to the Default Website:

    • Right-click on Default Website in IIS Manager and select Add Application.
    • In the Alias field, name your application (e.g., Web API).
    • Choose the SwiftPOS Application Pool that you created earlier from the dropdown menu.
    • In the Physical Path field, browse to the folder where your SwiftPOS Web API files are stored.
  2. Set Up Other Applications (e.g., Reports):

    • If you have additional applications such as Reports, follow the same process to add them:
      • Right-click Default Website > Add Application.
      • Name it (e.g., Reports), select the SwiftPOS Application Pool, and specify the folder path for the reports.
  3. Change the Website Port (Optional) (3:36):

    • By default, IIS websites use Port 80. If you prefer to use a different port (e.g., 8000):
      • Right-click Default Website and select Edit Bindings.
      • Click on the existing binding for Port 80, choose Edit, and change it to 8000.
      • Click OK and then Close.

Step 4: Restart IIS and Verify Configuration (3:48)

  1. Restart IIS:

    • After creating or modifying an application, always restart IIS to apply the changes:
      • Right-click on the server node in IIS Manager and select Restart.
  2. Test the Web API:

    • To confirm that your Web API is running, open a browser and navigate to:
    • You should see the Swagger UI or some form of API response, confirming the Web API is functioning.
  3. Test the Reports Application:

    • Similarly, navigate to http://localhost:8000/reports to check if the reports are accessible. If properly configured, you should see the report interface.

Step 5: Configure Windows Firewall for Local Access (4:39)

  1. Open Firewall Settings:

    • Open Windows Firewall from the Control Panel or use Windows search to find it. Then click Advanced Settings on the left-hand side.
  2. Create a New Inbound Rule:

    • In the Inbound Rules section, click New Rule.
    • Select Port as the rule type.
    • Specify the port number you configured for IIS (e.g., 8000).
  3. Configure Network Type:

    • Choose which types of networks this rule applies to (e.g., Private network).
    • Name the rule (e.g., PDT Access or SwiftPOS Web API Access), and click Finish.
  4. Refine the Rule (Optional):

    • After creating the rule, you can go into Properties and further configure which IP addresses, computers, or protocols are allowed to connect. This can be useful for limiting access to specific devices on your network (e.g., PDT devices).

Step 6: Troubleshoot and Reinstall IIS (6:35)

  1. Remove IIS (if needed):

    • If IIS is not functioning correctly, you can remove and reinstall it:
      • Go to Control Panel > Programs and Features > Turn Windows Features On or Off.
      • Uncheck IIS to uninstall it, then restart the system.
      • After rebooting, delete the inetpub folder (located in the C:\ drive) to remove any leftover settings or configuration files.
  2. Reinstall IIS:

    • Follow the steps in Step 1 to reinstall IIS from scratch, ensuring that you start with a fresh configuration.

Step 7: Add Additional Shared Folders for Other Features (7:26)

  1. Create a New Folder for Advertising:

    • If you need to host other content, such as video advertising, create a folder in your SwiftPOS directory (e.g., Advertising).
  2. Add an Application for Advertising:

    • In IIS Manager, right-click Default Website and select Add Application.
    • Name it Advertising, select the SwiftPOS Application Pool, and set the Physical Path to your Advertising folder.
  3. Access the Content:

    • You can now access the content via http://localhost:8000/advertising. If you have video files in the folder, they can be accessed directly via this URL and used within SwiftPOS.

Final Thoughts (8:41)

  • This guide ensures you have a fully functional IIS setup for SwiftPOS, including Web API, Reports, and any additional features such as Advertising.
  • Make sure to enable 32-bit applications in the application pool, configure firewall rules for external access, and troubleshoot by resetting IIS if necessary.

By following this step-by-step guide, IIS will be set up to handle SwiftPOS Web APIs, Reports, and additional features, while also ensuring proper network access for devices like PDTs and Order Away terminals. The installation and configuration will enable stable performance and accessibility.

4o