Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Hosting Tax Balance in a Windows Service is available in an upcoming versionsince 23.0.260.

  1. Obtain the installation resources of Tax Balance . Usually this is an archive with the file extension (.nupkg)from the download link that was provided to you via E-mail.

  2. Extract the archive to a desired location on the file system of the machine that will host Tax Balance. We will refer to that location as <tax-balance-install-directory>.

  3. Use PowerShell (Version 6 or later) to register a service. From an administrative PowerShell command shell execute the following command:

    Code Block
    languagepowershell
    New-Service
      -Name "Tax Balance"
      -BinaryPathName "<tax-balance-install-directory>\AMANA.SmartTaxBalance.Web.Api.exe"
      -Credential "<tax-balance-user>"
      -Description "Tax Balance Web Application"
      -Description "Tax Balance" 
      -StartupType Automatic

    Replacing <tax-balance-install-directory> with the location of the exctracted installation resources.
    Replacing <tax-balance-user> with a Service user account , with the format DOMAIN OR COMPUTER\USER e.g., Contoso\ServiceUser or the Local Service Account or a Custom domain account NT AUTHORITY\LocalService. If this parameter is not specified, the local service account is used.
    Learn more about permissions required for the Tax Balance Windows Service or using a Managed Service Account.

  4. Continue with Configure the Configuration of Tax Balance

  5. Additional configuration steps may be required to make Tax Balance work as a Windows service. As , as per default, Tax Balance Server will listen to https://localhost:443/. To change this, open the appsettings.json file located at <tax-balance-install-directory> and change the value of the key Urls to a desired listening address(es). Learn more about exposing Tax Balance server. You will also be provided with information how to setup a X.509 certificate for HTTPS protocol.

  6. Start the service with the following PowerShell 6 command:

    Code Block
    languagepowershell
    Start-Service -Name "Tax Balance"

...