Install Retail Hardware Station

Important

This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

Applies To: Microsoft Dynamics AX 2012 R3

Microsoft Dynamics AX Retail Hardware Station provides services for Microsoft Dynamics AX Retail Retail Modern POS (point of sale) clients and peripherals such as printers, cash drawers, or payment devices that enable these devices to communicate with Microsoft Dynamics AX Retail Server. This section includes the following information about how to install and configure Hardware Station.

  • Before you begin

  • Install Hardware Station by using Setup

  • Install Hardware Station by using Windows PowerShell

Note

Hardware Station is available only with Microsoft Dynamics AX 2012 R3.

Before you begin

  • Be aware that you do not have to install Hardware Station in a domain. You can install it as part of a work group on a single computer.

  • Create a service account. This service account is used for the identity of the application pool for Hardware Station. This account does not have to be a domain account. It can be a work group account. For more information, see Create service accounts.

  • On the computer where you plan to install this component, run the prerequisite validation utility to verify that system requirements have been met. For information about how to run the prerequisite validation utility, see Check prerequisites.

    For more information about the hardware and software requirements for Microsoft Dynamics AX, see the system requirements.

  • Because this component uses Secure Sockets Layer (SSL) encryption, you must install a server certificate that was issued by a trusted certification authority. (For test environments, you can create a self-signed certificate in IIS.) When you run Setup, you will need to enter the thumbprint for the certificate. To view the thumbprint in IIS Manager, double-click the certificate and click the Details tab.

Option 1: Install Hardware Station by using Setup

Use this procedure to install Hardware Station. If you install other Microsoft Dynamics AX components at the same time, the installation pages vary, depending on the components that you are installing.

  1. Start Microsoft Dynamics AX Setup. Under Install, select Microsoft Dynamics AX components.

  2. Advance through the first wizard pages.

  3. If the Setup Support files have not yet been installed on this computer, the Select a file location page is displayed. The Setup Support files are required for installation. Provide a file location or accept the default location, and then click Next. On the Ready to install page, click Install.

  4. On the Select installation type page, click Custom installation, and then click Next.

  5. On the Select components page, select Retail Hardware Station, and then click Next.

  6. On the Prerequisite validation results page, resolve any errors. For more information about how to resolve prerequisite errors, see Check prerequisites. When no errors remain, click Next.

  7. On the Configure Retail Hardware Station page, enter the following information about the web site where Hardware Station will run.

    • Configure Hardware Station: On the Configure Hardware Station page, select the check box to configure Hardware Station by using Setup. If you clear this option, the application files are installed, but Hardware Station is not configured. If you’re configuring Hardware Station, enter the following information:

    • Application name – The name of an existing web application or the name of an application that you want Setup to create.

    • Website name – The name of an existing web site or the name of a site that you want Setup to create.

    • App pool name – The name of an existing web application pool in your server environment or the name of an application pool that you want Setup to create.

    • User name and Password – The credentials for the application pool identity. The user does not have to be a domain account. It can be a member of a work group on the local computer.

    • HTTP port and HTTPS port – You can specify any available ports. Verify that these ports are open in Windows firewall.

      Important

      We strongly recommend that you use an HTTPS port for Hardware Station.

      Warning

      To avoid conflicts with the Default Web Site on the computer, we recommend that you do not use the default HTTPS port (443). A nonstandard port number also helps make the website more secure.

    • SSL certificate thumbprint – The thumbprint for your Secure Sockets Layer (SSL) encryption certificate.

    • Retail Server URL – The URL specified when Retail Server was installed. By default, the URL is created by using the following parameters:

      https://<Fully Qualified Server Name>:Port/<WebApplicationName>/v1

  8. On the Prerequisite validation results page, resolve any errors. For more information about how to resolve prerequisite errors, see Check prerequisites. When no errors remain, click Next.

  9. On the Ready to install page, click Install.

  10. After the installation is completed, click Finish to close the wizard.

Option 2: Install Hardware Station by using Windows PowerShell

Use this procedure to install Hardware Station manually by using Windows PowerShell. Manual installations are often performed by businesses and organizations that automate deployments by using scripts.

Dn741431.collapse_all(en-us,AX.60).gifExtract installation files

Use Microsoft Dynamics AX Setup to extract the files that are needed for manual installation.

  1. Start Microsoft Dynamics AX Setup. Under Install, select Microsoft Dynamics AX components.

  2. On the Select installation type page, click Custom installation, and then click Next.

  3. On the Select components page, select Retail Hardware Station, and then click Next.

  4. On the Prerequisite validation results page, resolve any errors. For more information about how to resolve prerequisite errors, see Check prerequisites. When no errors remain, click Next.

  5. On the Configure Retail Hardware Station page, clear the Configure Retail Server option.

  6. On the Prerequisite validation results page, resolve any errors. For more information about how to resolve prerequisite errors, see Check prerequisites. When no errors remain, click Next.

  7. On the Ready to install page, click Install.

  8. After the installation is completed, click Finish to close the wizard.

Dn741431.collapse_all(en-us,AX.60).gifConfigure settings in the hs-settings.xml file

After you extract the installation files by using Setup, you must configure settings in the hs-settings.xml file.

  1. Open the folder where the installation files are installed. By default, the files are located at C:\Program Files (x86)\Microsoft Dynamics AX\60\HardwareStation\Tools.

  2. Create a copy of the hs-settings.xml file. We recommend that you do not change the original file.

  3. Open the hs-settings.xml file in Microsoft Visual Studio or a text editor, such as Notepad.

  4. Enter a value for the following parameters:

    Parameter

    What to enter

    Default value

    WebAppPoolName

    The name of an existing web application or the name of an application that you want Setup to create.

    HardwareStationAppPool

    WebSiteName

    The name of an existing web site or the name of a site that you want Setup to create.

    HardwareStationWebsite

    WebSiteHttpPort

    You can specify any available port. Verify that the port is open in Windows firewall. Also, note the port number. The port is used to create the URL for Retail Server in the format: https://<server name>:port/<web application name>. This URL is required to activate Retail Modern POS devices that connect to Retail Server.

    None

    WebSiteHttpsPort

    You can specify any available port. Verify that the port is open in Windows firewall. Also, note the port number. The port is used to create the URL for Retail Server in the format: https://<server name>:port/<web application name>. This URL is required to activate Retail Modern POS devices that connect to Retail Server.

    None

    WebApplicationName

    The name of an existing web application or the name of an application that you want Setup to create.

    HardwareStation

    WebSiteSSLCertificateStore

    The Certificates store specified when the certificate was created or imported.

    My

    WebSiteSSLCertificateRootStore

    The server where the certificate is stored.

    LocalMachine

    WebSiteWorkingFolder

    The folder where you want PowerShell to create a new IIS virtual directory.

    %SystemDrive%\inetpub\HardwareStation

    WebAppPoolUser

    Enter a domain account for the application pool. Enter the account in the form value="Domain\User".

    None

    WebSiteSSLCertificateThumbprint

    The thumbprint for your Secure Sockets Layer (SSL) encryption certificate. You must obtain a valid, registered certificate from a provider.

    Because this component uses Secure Sockets Layer (SSL) encryption, you must install a server certificate that was issued by a trusted certification authority. (For test environments, you can create a self-signed certificate in IIS.) You will need to paste the thumbprint for the certificate into the settings file. To view the thumbprint in IIS Manager, double-click the certificate and click the Details tab. We recommend that you paste the thumbprint into a text file and remove all spaces before you paste it into the settings file.

    Caution noteCaution
    A thumbprint can contain hidden characters at the beginning of the thumbprint value. You must delete these extra characters before you paste the thumbprint into the settings file.

    None

    WebApplicationServiceBinarySourceFolder

    By default, this folder is:

    C:\Program Files (x86)\Microsoft Dynamics AX\60\HardwareStation\Package folder

    None

    WebApplicationWorkingFolder

    The folder from where the web service will run. You can specify the WebApplicationServiceBinarySourceFolder or any available folder.

    [RetailServerWebSiteWorkingFolder]\[RetailServerWebApplicationName]

    RetailServerURL

    The URL specified when Retail Server was installed. By default, the URL uses the following format:

    https://<ServerName>:Port/<WebApplicationName>

    None

  5. Save your changes .

Dn741431.collapse_all(en-us,AX.60).gifRun PowerShell scripts to deploy and configure Hardware Station

After you configure the parameters in the hs-settings.xml file, you can run the Windows PowerShell scripts that deploy and configure Hardware Station.

  1. On the server where you want to run the script, open the folder where the PowerShell scripts are installed. By default, the files are located at C:\Program Files (x86)\Microsoft Dynamics AX\60\HardwareStation\Tools

  2. If you’re using Windows Server 2012 or a later operating system, use Windows Explorer to open the folder where the scripts are installed. Then click File > Open Windows PowerShell > Open Windows PowerShell as administrator.

    If you’re using Windows Server 2008 R2 or an earlier operating system, start Windows PowerShell as the administrator. Then, change the directory by using the following command: CD “<Path to directory>”.

  3. In the Windows PowerShell console, run the following command to create a credential object in Active Directory for the service account. Replace ‘domain\useraccount’ and ‘password’ with credentials that have permission to create sites in IIS:

    $Cred = @((New-Object System.Management.Automation.PSCredential(‘domain\useraccount',(ConvertTo-SecureString 'password' -AsPlainText -Force))))
    
  4. Run the following command to deploy and configure Hardware Station:

    .\DeployHardwareStation.ps1 -SettingsXmlFilePath .\hs-settings.xml -TopologyXmlFilePath .\hs-topology.xml -Credentials $Cred –Verbose $true
    

    For example:

    .\DeployHardwareStation.ps1 -SettingsXmlFilePath "C:\Program Files (x86)\Microsoft Dynamics AX\60\HardwareStation\Tools\hs-settings.xml" -TopologyXmlFilePath "C:\Program Files (x86)\Microsoft Dynamics AX\60\HardwareStation\Tools\hs-topology.xml" -Credentials $Cred –Verbose $true

After you install Hardware Station

For information about how to install Modern POS, see Install Retail Modern POS. To install Retail Server, see Install Retail Server.

See also

Retail Modern Point of Sale