.

Annual Maintenance & Services Offer 2014 - 2015

Web Service Configuration Instructions

Datamine Fusion

Version 8.0

1

CONTENTS

Ensuring that .NET Framework 4.0 is installed 3

Enabling IIS features 5

Copying web service application files to the server 10

Creating a new application pool for the web service 11

Creating Central or Fusion Remote data source 14

Testing the connection to the web service 15

Enabling the web service in Fusion Administrator 17

Troubleshooting tips 18

** The instructions and screen shots detailed in this document were taken on a server running the Windows Server 2012 operating system. Note that both Windows Server 2003 and 2008 are still supported. However, the instructions and paths may differ slightly.

Please contact Datamine support if you have any questions or concerns.

2

Ensuring that .NET Framework 4.0 is installed

The first step is to make sure that the Microsoft .NET Framework 4.0 (or higher) is already installed on the server.

To check which versions of the .NET Framework are installed, enter the following in Windows Explorer and hit ENTER:

%windir%\Microsoft.NET\Framework\

Where "%windir%" represents the "Windows" directory on the system (e.g. C:\Windows\)

The folder contents should appear as follows:

If you have a folder named v4.X.X or greater, then you do not need to install .NET 4.0.

If the .NET Framework 4.0 installer is needed, you can download it from Microsoft’s website:

http://www.microsoft.com/en-ca/download/confirmation.aspx?id=17718

File: dotNetFx40_Full_x86_x64.exe

Should you have difficulties downloading or installing the framework, please contact Datamine Support for further assistance.

3

Troubleshooting tips:

Should you receive the following error when attempting to install the .NET Framwork 4.0, then you already have a newer version on the system. You can then cancel the install and continue following the steps outlined in this document.

4

Enabling IIS features

The next step involves enabling Internet Information Services (IIS) as well as a few related features on the server.

First, open the Programs window (Add/Remove programs in older versions of Windows) in the Control Panel and then click on “Turn Windows features on or off”

Next, click on IIS in the left menu bar. That will then start the “Add Roles and Features Wizard”. Click NEXT:

5

Select “Role-based or feature-based installation” and click NEXT:

Select your server from the list and click NEXT:

6

Select the IIS role and make sure it is selected/checked. Then, under the Security options, make sure that the “Basic Authentication” option is selected:

Make sure that Application Development is enabled and then make sure that the “.NET Extensibility 4.5” option is installed and selected:

7

Make sure that Performance is enabled and that the “Dynamic Content Compression” option is selected. Then, click NEXT:

Make sure the following options are selected and click NEXT:

8

Click Install:

Click Close once the installation has completed:

9

Copying the web service application files to the server

Copy the web service folder contents (provided by Datamine) to a directory on the primary drive of your server. In this example, the SyncService folder was copied to the root of the C: drive:

Note that you are not required to set any additional permissions to this folder. IIS will handle the permissions necessary for users to access the service.

10

Creating a new application pool for the web service

In the server manager window, right-click on your server and select “Internet Information Services (IIS) Manager”. Alternatively, you can open the IIS Manager window from the Tools shortcut in the top right-hand corner:

Next, expand your server name on the right-hand side and click on “Application Pool”. Then, right-click in the main window and select “Add Application Pool”:

11

Make sure to select the same options as displayed in the following screen shot and then click OK. Note that the version number of the .NET Framework may differ slightly (but should start with v4.0):

Right-click on “Default Web Site” and then select “Add Application”:

12

Make sure to select the Application Pool that was created in the previous step. In addition, you must select the path to the Data Sync folder created on page 10 of this document. Then click OK:

13

Creating Central or Fusion Remote data source

In order for the databases to communicate with the web service, the Central or Fusion Remote data source must be created on the server. If you are configuring the web service for a Central database server, then simply create the Central ODBC entry just as you would on a client machine. If you are configuring the service for a Fusion Remote server, then configure the Fusion Remote ODBC entry just as you would on a user’s computer.

NOTE: Make sure to create the DSN for the 32-bit platform

The 32-bit version of the ODBC Data Source Administrator is located in the %systemdrive%\Windows\SysWoW64 folder:

14

Testing the connection to the web service

First, test the connection on the server itself. To do this, enter the following into a web browser on the web server:

http://localhost/DataSyncService/Service1.svc

The resulting page should look similar to this:

You can also replace the occurrence of localhost in the URL with the machine name or IP Address.

15

The last test involves testing the same URL from a user’s machine on the same network. To do this, enter the following URL into a web browser on the user’s machine:

http://localhost/DataSyncService/Service1.svc

** You will need to replace the occurrence of localhost with the server’s IP address or machine name.

For example:

http://gdmstest.dataminesoftware.com/DataSyncService/Service1.svc

The result should look similar to the following:

16

Enabling the web service in Fusion Administrator

The last step involves enabling use of the web service in Fusion Administrator. To do this, follow these steps:

(1) Login to Fusion Administrator against the Central database (or the Fusion Remote database if you are enabling the web service for a Fusion Remote database) using an account with the Administrator profile.

(2) Click on Edit�Datasync Webservice Configuration..

(3) Enter the full web service URL and check the “Enabled” checkbox for the authentication type that will be used. For this example, we are enabling the web service for database authentication:

(4) Click OK to apply the changes and exit Fusion Administrator.

** NOTE: If you are using Windows Authentication, you will want to make use of the net.tcp protocol. You will simply need to replace the occurrence of “http” in the URL to “net.tcp”

17

Troubleshooting tips:

If you receive the following error:

"The page you are requesting cannot be served because of the extension configuration. If the page is a script, add a handler. If the file should be downloaded, add a MIME map"

when accessing the .svc file for the first time after web service installation, you may need to run aspnet_regiis.exe from the .net version used. To do this, open a command prompt on the server and browse to the framework folder. Then enter the command aspnet_regiis.exe -i :

C:\Windows\Microsoft.NET\Framework\v4.0.30319>aspnet_regiis.exe -i

18

8585 Cote-de-Liesse

Saint-Laurent, Quebec

H4T 1G8

Canada

Tel: +1 514 341 2000 ext2404

www.dataminesoftware.com