================================================================================
  accesso Onsite Payment Service V2 - Installation Guide
================================================================================

PREREQUISITES
-------------
- Windows 10 or Windows 11 (64-bit)
- .NET 8.0 Runtime (x64) installed
  Download: https://dotnet.microsoft.com/download/dotnet/8.0
- Administrator privileges


PACKAGE CONTENTS
----------------
This installer package contains:

  install.bat                              - Main installer (double-click to run)
  install-ops-service.ps1                  - PowerShell installation script
  Accesso.OnSitePayments.Service.exe       - OPS V2 service binary (digitally signed)
  NLog.config                              - Logging configuration
  README-INSTALLER.txt                     - This file


INSTALLATION INSTRUCTIONS
-------------------------

STEP 1: Verify Prerequisites
  - Ensure .NET 8 Runtime is installed:
    Open PowerShell and run: dotnet --list-runtimes
    You should see: Microsoft.NETCore.App 8.x.x

  - If not installed, download from:
    https://dotnet.microsoft.com/download/dotnet/8.0
    Select: ".NET Runtime 8.0.x" → Windows → x64

STEP 2: Extract Files
  - Extract all files from this ZIP to a local folder
  - DO NOT run from a network drive or Downloads folder
  - Recommended: C:\Temp\OPS-V2-Install\

STEP 3: Run Installer
  - Double-click "install.bat"
  - OR right-click "install.bat" → "Run as administrator"
  - The installer will:
    * Verify .NET 8 is installed
    * Request admin privileges if needed
    * Copy files to: C:\Program Files\accesso\OnSitePayments
    * Create Windows Service: Accesso.OnSitePaymentsV2
    * Generate HTTPS certificates
    * Start the service

STEP 4: Verify Installation
  - Open Services: services.msc
  - Verify "Accesso.OnSitePaymentsV2" is running
  - Service should start automatically
  - Check logs for any startup errors (see NLog.config for log path)


INSTALLATION DETAILS
--------------------

Service Name:        Accesso.OnSitePaymentsV2
Display Name:        Accesso OnSitePaymentsV2
Install Path:        C:\Program Files\accesso\OnSitePayments
Startup Type:        Automatic
Recovery:            Restart on failure (3 attempts)

gRPC Endpoint:       https://localhost:5201 (default)
Logs:                (check NLog.config for log path)


COEXISTENCE WITH V1
-------------------

OPS V2 uses a DIFFERENT service name than V1:
  - V1: accesso.OnsitePaymentService
  - V2: Accesso.OnSitePaymentsV2

Both can run on the same machine simultaneously during migration.
However, they CANNOT both use the same GPS instance or payment terminals.


UPGRADING FROM V1
-----------------

This installer does NOT automatically migrate V1.

Manual upgrade steps:
  1. Install OPS V2 (this installer)
  2. Verify V2 service is running
  3. Test V2 with a test terminal
  4. Once verified, stop V1 service:
     services.msc → "accesso.OnsitePaymentService" → Stop
  5. Switch ShoWare Director to use V2


UNINSTALLATION
--------------

To remove OPS V2:
  1. Open Services (services.msc)
  2. Stop "Accesso.OnSitePaymentsV2"
  3. Open PowerShell as Administrator
  4. Run: sc.exe delete Accesso.OnSitePaymentsV2
  5. Delete folder: C:\Program Files\accesso\OnSitePayments


TROUBLESHOOTING
---------------

Installation fails with ".NET 8 not found":
  - Install .NET 8 Runtime: https://dotnet.microsoft.com/download/dotnet/8.0
  - Verify: Open PowerShell → dotnet --list-runtimes
  - Must show: Microsoft.NETCore.App 8.x.x

Service won't start:
  - Review service logs (see NLog.config for path)
  - Verify GPS service is accessible
  - Check Windows Event Viewer → Application logs
  - Verify all required files were copied correctly

"Signature verification failed":
  - The service executable must be digitally signed by ACCESSO
  - Do not modify or replace the .exe file
  - Re-download the installer package if needed

Service starts but Director can't connect:
  - Verify service is running: services.msc
  - Check gRPC endpoint: https://localhost:5201
  - Verify firewall allows local connections
  - Review service logs for connection errors


SUPPORT
-------

Documentation:
  https://github.com/accesso/sw-us-core/blob/main/docs/OPS_V2_INTEGRATION.md

Version: 2.1.6.3
Release Date: May 2026

For issues or questions, contact the ShoWare Development Team.

================================================================================
