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 version.

  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., Contose\ServiceUser or the Local Service Account or a Custom domain account NT AUTHORITY\LocalService. If this parameter is not specified, then 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"

...