Prerequisites:
• The ww.dll must be installed.
Note: Please refer to Siriusware Inc. documentation (E-Commerce Installation Guide and Salesware Reporting) for instructions on installing ww.dll, E-Commerce pages and Reporting Services.
• .Net 4.0 / 4.5 (come pre-installed on Windows 8 and Windows Server 2012)
• Siriusware Common Files application
• Local Firewall on the PC needs to allow communication over TCP port 80
• A static IP address is required on the Salesware Service PC/Server
• IIS 7.0 or higher
• An operating System of Windows 7 or Windows Server 2008 or newer is required
Steps for installing Salesware Service:
1. Run the Salesware Service installer Install_Siriusware_SaleswareService_4300.msi. This should create a web.config file in the c:\inetpub\wwwroot\SaleswareService folder.
• Configure the IHCSettings section if you plan to use In-House Cards as a payment type:
<IHCSettings>
<IHCPrefixes>
<IHCPrefix swipeLength="11" prefix="600585" />
<IHCPrefix swipeLength="10" prefix="603524"/>
<IHCPrefix swipeLength="7" prefix="603524999"/>
</IHCPrefixes>
</IHCSettings>
Note: SwipeLength is the number of characters in the barcode scanned. Prefix is the value that is prepended to the scanned barcode value.
• Configure the Printers section
If you plan to use a wireless network printer, enter the IP and port 9100. The layout used to print is also specified here:
<Printers>
<Printer name="Receipt" windowsPrinterName="TCP:10.0.2.245:9100" mode="SPML" transform="btReceipt.xsl"/>
<Printer name="Ticket" windowsPrinterName="TCP:10.0.2.245:9100" mode="SPML" transform="btTicket2.xsl"/>
<Printer name="CCReceipt" windowsPrinterName="TCP:10.0.2.245:9100" mode="SPML" transform="ccReceipt.xsl"/>
</Printers>
To configure more printers with specific Salespoints:
<Printer name="Receipt3" windowsPrinterName="TCP:10.0.2.41:9100" mode="SPML" salespoints="MS01" transform="btReceipt.xsl"/>
<Printer name="Ticket3" windowsPrinterName="TCP:10.0.2.41:9100" mode="SPML" salespoints="MS01" transform="btTicket2.xsl"/>
<Printer name="CCReceipt3" windowsPrinterName="TCP:10.0.2.41:9100" mode="SPML" salespoints="MS01" transform="ccReceipt.xsl"/>
<Printer name="Receipt2" windowsPrinterName="TCP:10.0.2.40:9100" mode="SPML" salespoints="MOBDAD" transform="btReceipt.xsl"/>
<Printer name="Ticket2" windowsPrinterName="TCP:10.0.2.40:9100" mode="SPML" salespoints="MOBDAD" transform="btTicket2.xsl"/>
<Printer name="CCReceipt2" windowsPrinterName="TCP:10.0.2.40:9100" mode="SPML" salespoints="MOBDAD" transform="ccReceipt.xsl"/>
If a bluetooth printer is used, the <Transformations> section is used, which is hardcoded, although different layouts can be designated:
<Transformations>
<Transform name="Simple Receipt" transform="btReceipt.xsl"/>
<Transform name="Simple Ticket" transform="btTicket2.xsl"/>
<Transform name="CC Receipt" transform="ccReceipt.xsl"/>
</Transformations>
Emails that can be sent are configured in the <Emails> section, which is hardcoded except for the subject and layout to be used:
<Emails>
<Email name="Simple Email" subject="Your Receipt" transform="Email.xsl" />
</Emails>
2. Ensure you have a Salesware Service update file in your updates folder (c_saleswareService_XXXX_XXXX.exe)
3. Update the Salesware Service files by double-clicking on the Update SaleswareService icon that was created during the installation in step 1.
4. Edit the SaleswareService web.config file
• If you are using Salesware Service for Mobile Sales, enter the name of the Mobile Sales Host to be used for processing sales within the HostSalespoint configuration setting. As ww_sales records are generated from the Mobile Sales apps, only those records with a match to the Mobile Sales Host name will be picked up and processed by the specified Mobile Sales Host.
<HostSettings HostSalespoint="MOBSH" />
• If you are using Salesware Service for Reserved Seating, enter "direct" for the HostSalespoint configuration setting. This will turn off the enforced logins after an inactivity timeout occurs.
<HostSettings HostSalespoint="direct" />
5. Enable HTTP Activation (Windows 8 and Windows Server 2012 only)
• For Windows 8 operating systems:
a. Use the shortcut keys <Windows>-i (The windows key and the letter i ) and click on Control Panel
b. Click on Programs
c. Under Programs and Features, click Turn Windows features on or off
d. Expand .NET Framework 4.5 Advanced Service, then WCF Services, and check HTTP Activation, and then click OK
• For Windows Server 2012 operating systems:
a. Run Server Manager
b. Choose server to administer (probably the local server)
c. Scroll down to Roles and Features section
d. Choose Add Roles and Features from the Tasks dropdown on the right
e. On the Add Rolls and Features Wizard, click Next until you get to the Server Selection. At that point, you can click directly on Features on the left side.
f. Expand .NET Framework 4.5 Features
g. Expand WCF Services
h. Check HTTP Activation
i. Click Install
6. Perform an IISRESET
7. Test the installation by going to these URLs:
• http://localhost/SaleswareService/SaleswareService.svc
Note: This returns an xml page displaying the version info on the Salesware Service, ww.dll and database.