• Ready for review

    • Host Tax Balance in a Windows Service

    Owned by CBE
    Last updated: Jan 09, 2024
    1 min read

    Hosting Tax Balance in a Windows Service is available since 23.0.260.

    1. Obtain the installation resources of Tax Balance 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:

      New-Service -Name "Tax Balance" -BinaryPathName "<tax-balance-install-directory>\AMANA.SmartTaxBalance.Web.Api.exe" -Credential "<tax-balance-user>" -Description "Tax Balance Web Application" -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 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 the Configuration of Tax Balance

    5. Additional configuration steps may be required, 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:

      Start-Service -Name "Tax Balance"

    Â