Hedberg Web Services Client Installation Procedure

Hedberg Web Services Client Installation Procedure 

June 26, 2012 

Copyright (c) 2012 Hedberg Data Systems, Inc. All rights reserved. This document is for informational 

purposes only and should not be construed as a contract or commitment. Neither Hedberg Data Systems, 

Inc. nor Steelcase Inc assumes any responsibility for any errors or omissions in this document or any 

effects thereof. FaxSr is a copyright of Omtool. All rights reserved.

2 Hedberg Web Services Client Installation Procedure

Table of Contents 

Hedberg Web Services Client Installation Procedure ................................................................................... 4 

Overview of Hedberg Web Services Client ............................................................................................... 4 

Technical Requirements ............................................................................................................................ 4 

The process for Installing and Configuring the Hedberg Web Services Client ......................................... 4 

Sending an Email Request for Security Certificates to Hedberg Customer Support ............................ 5 

Installing The Hedberg Web Services Client ......................................................................................... 5 

Installing the Hedberg Web Services Client Security Certificates ......................................................... 8 

Appendix I – How To Verify the Certificates and HWSC ............................................................................ 12 

How to check if certificates were properly imported ................................................................................ 12 

How to test HWSC ................................................................................................................................... 12 

Appendix II – Removing the Hedberg Web Services Client ....................................................................... 15 

Hedberg Web Services Client Installation Procedure 3

Hedberg Web Services Client Installation Procedure 

Overview of Hedberg Web Services Client 

The Hedberg Web Services Client is an application that provides an object interface for third party 

applications (like Configura’s CET) to use to communicate with a Hedberg System via Hedberg Web 

Services. The communication can occur through an intranet or internet connection to HWS. For 

example, you can use HWSC to create quotes on a Hedberg System from information that is gathered in 

a third party application. Requests and responses are encrypted and password-protected to ensure 

secure transactions over the Internet. 

HWSC requires the following: 

� A software application that will assemble data for requests to send to a Hedberg System. 

� An intranet or internet connection to an HWS server. 

� Security certificates to be issued on the application workstation to insure secure communications 

between the application and the Hedberg System. 

The HWS client software, while constructed as a 32-bit application, can be installed on both 32-bit and 

64-bit operating systems. 

The document assumes that: 

� You are familiar with Windows procedures such as software installation procedures. 

� You are familiar with the Hedberg web site. 

� You are familiar with Hedberg Web Services. 

Technical Requirements 

Here are the requirements for the HWSC machine. 

� Hardware Requirements: 

o 1 GHz or higher Intel or compatible processor 

o 1 GB of memory or higher 

o 200 MB of free disk space 

� The operating system must be at least: 

o Windows XP with Service Pack 2 

o Windows Vista with Service Pack 2 

o Windows 7 

o Windows 2003 with Service Pack 2 

o Windows 2008 with Service Pack 1 

� Local rights: 

o The user installing HWSC must have local administrative privileges on the machine. 

o In addition, Windows 7 and Windows 2008 come with User Account Control (UAC) mode 

that launches all processes in restricted mode unless users specifically accept the 

elevation confirmation. This will require the person doing the installation to elevate the 

normal administrative permissions by using “Run As”. 

o The user does not need to be a local administrator to use the software. 

� If there is a local firewall on the client machine, it must be configured to allow traffic outbound on 

the same port that the dealership is using to accept Secure HWS traffic. Typically, this is TCP 

port 8080. 

The process for Installing and Configuring the Hedberg Web Services Client 


There are three basic steps to the HWSC installation. 

1. Send an email request for security certificates to Hedberg Customer Support at 

Incident.Hedberg@Steelcase.com. 

2. Install the software component of HWSC. If you already had a previous version of the Hedberg 

Web Services client installed, it will need to be uninstalled first. This will only need to be done if 

you have a previous version of the client already installed. Please see the appendix for specific 

instructions on this 

3. Install the security certificates required to use HWSC. 

Please see the corresponding section below for further details. 

Sending an Email Request for Security Certificates to Hedberg Customer Support 

Security certificates are required to insure the communication between HWSC and the Hedberg System 

is secure. A request must be sent to Hedberg Customer Support to request the issuance and distribution 

of those certificates. 

To request a certificate, send an email to Incident.Hedberg@Steelcase.com which includes the following 

information: 

� Subject: HWSC Certificate Request 

� Text: 

o Your Name 

o Your Dealership Name 

o Your Dealership TPID 

o The application that will be using HWSC 

o Your e-mail address 

Hedberg Customer Support will send an email response with the required certificates attached. 

Please expect a two to three day turnaround to receive the certificates. 

Installing The Hedberg Web Services Client 

The installation of the Hedberg Web Services Client is very simple, requiring the download of the 

installation procedure, putting the installation procedure on the target machine, and executing the 

installation procedure. 

1. Log onto the client with local administrative rights. 

2. Save the HWS Client EXE file on the workstation to 

be installed. 

3. Disable your anti-virus software’s auto-protect or 

real-time protection (some software installations do 

not operate correctly when this feature is turned 

on). 


4. For Windows Vista, Windows 7 and Windows 2008, 

browse to the client installation file, right-click on 

the file and select “Run As Administrator”. 

For all other supported operating systems, doubleclick 

the installation file. 

5. For machines with UAC (User Account Control), 

users will see the attached message. Select “Yes” 

to continue. 

Please note the program name will be specific to 

the version you are installing. In this example, we 

are loading the HWS Client version 1.2 for a 32-bit 

machine. 

6. Click “Next” to continue. 


7. The Welcome to the InstallShield Wizard for 

Hedberg Web Services Client screen is displayed. 

Click “Next” to continue. 

8. The Select Installation Folder screen is displayed. 

The installation folder can be changed by entering 

a new folder or clicking the Browse button to select 

a different folder. It is recommended that the 

destination folder not be changed. 

Leave the “Everyone/Just me” radio button 

selection at the default of Everyone. 


9. The Confirm Installation screen is displayed. 



10. The Installation Complete screen is displayed. 

Click “Close” to complete the HWS Client Software 

installation portion of the installation. 

11. Select “Finish” completing the installation. 

12. Re-enable your anti-virus software. 

This completes the installation of the Hedberg Web Services Client. Please proceed to the next section 

to install the security certificates needed by HWSC. 

Installing the Hedberg Web Services Client Security Certificates 

Hedberg Customer Support will reply to the request for security certificates with an email with two 

attached files. Both attached files have a .zip extension: 

1. One attached file has the word “Public” in the file name. Send that file to your Hedberg Web 

Services administrator and the administrator can extract a public certificate file (with a .cer 

extension) and import that certificate to HWS using the normal HWS certificate import procedure. 

2. Take the other .zip file and copy it to the HWSC workstation. Remember the drive and folder that 

the .zip file has been placed in. 

Note on import rights: 

� If the local user has local administrative rights, they will be able to import all the necessary 

certificates; the CA certificate along with the required public and private certificates. 


� If the local user does not have local administrative rights, someone with local administrative 

rights will need to import the required certificates AND then the local user will then need to import 

the public and private certificates into their profile. 

If the local user HAS local administrative rights: 

1. Click the Start button. 

2. Select All Programs \ HWSC Utilties \ HWSC 

Certificate Management for Admin. 

3. 

4. The HWSC Certificate Management screen is 

displayed. 


5. In the Certificates Zip File field, enter the fully 

specified name of .zip file that was attached to the 

Hedberg Customer Support email. 

Click the Browse button to navigate to the .zip file 

and select it. 

6. After entering the .zip file name, the list of 

certificates that will be installed appears in the “List 

of available Certificates” box. 

The list of certificates will be similar to the list 

shown at the right and will include: 

� one file with .pfx extension 

� two files with .cer extensions 

Select the “Import All” button to install all the 

certificates. 


7. Upon completion of the Import All, the status of 

each certificate installed is listed on the bottom of 

the screen. There should be three SUCCES 

messages on the screen. 

Select the “Close” button to exit the HWSC 

Certificate Management utility. 

If the local user does NOT have local administrative rights: 

1. Someone who has local administrative rights needs to log onto the machine and run the steps 

above. 

2. Then the local user has to log in 

3. The local user follows the steps above EXCEPT instead of running Select “HWSC Certificate 

Management for Admin”, they need to select the “HWSC Certificate Management for User” 

program. 

4. Follow the remaining steps to import their personal certificates. The Root Certificate Authority will 

not be needed and the display will reflect this. 

This completes the installation of the Hedberg Web Services Client security certificates. 


Appendix I – How To Verify the Certificates and HWSC 

How to check if certificates were properly imported 

1. Browse to C:\Program Files\Hedberg Data 

Systems\HWSC\DebugTools\ and run the 

MMC_HWSClient_Certificates.msc. 

2. Select the Current User / Personal / 

Certificates folder and make sure it 

contains a proper private certificate. 

3. Select the Current User / Other People / 

Certificates folder and make sure it 

contains a proper public certificate. 

4. Select the Current User / Trusted Root 

Certificate Authorities /Certificates folder 

and make sure it contains a proper CA 

certificate (Steelcase CA). 

How to test HWSC 

For support and testing purposes, Hedberg supplies a utility which can test the communication link 

between the Hedberg Web Services server and the Hedberg Web Services Client. 


1. Select the Windows Start ribbon (or button 

depending on operating system) and find 

the Program group “HWSC Utilities” 

Select “HWSC Tester” to start the testing 

utility. 

2. The “Test HWSC Connection” tab will test 

the connectivity of the software itself. 

When “Get Assembly Info” is selected, it 

should return a “Success” with the version 

number of the software. 


3. The “Test Database Connection” tab will 

test the connectivity between the Hedberg 

Web Service client software and the 

Hedberg Web Services server. 

Enter the correct values for the TPID, 

HWS Server and IN2 account and 

password fields. Only change the 

remaining fields if your dealership is NOT 

using the defaults. 

Select the “Submit Request to HWS” 

button to submit the request and then 

“Review Response” when completed. 

4. The results will be in an XML file (typically 

XMLResponse_generalInformationInquiry. 

xml). 

Depending on the results of the above tests, contact Hedberg Customer Support if there are issues. 


Appendix II – Removing the Hedberg Web Services Client 

To un-install the Hedberg Web Services Client, this needs to be done through the operating system tools. 

1. Click the Start button and select the “Control 

Panel”. 

2. In the Control Panel, use “Add\Remove Programs”. 

Depending on your operating system, it may be 

called Programs. 


3. Select the “Hedberg Web Services Client” entry to 

highlight it. 

Depending on your operating system, either: 

a. Click the “Remove” button, or 

b. Click the “Uninstall” menu pick. 

4. After a progress screen, the Hedberg Web 

Services Client – InstallShield Wizard screen is 

displayed with the question ‘Do you want to 

completely remove the selected application and all 

of its features?’ 

Select the “Yes” button. 


5. The Setup Status screen is displayed showing 

progress. 

6. A series of un-installation progress screens will 

display, followed by the “Uninstall Complete” 

screen. 

Select the “Finish” button. 

This completes the un-install of the Hedberg Web Services Client.

Hedberg Web Services Client Installation Procedure

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?