Jump to: navigation, search

Install UBIK Web Service


Revision as of 12:01, 26 June 2013 by PFR (Talk | contribs)

This page describes how to set up an IIS server and a web service for UBIK® on MS Server 2008 R2. The web service is used to publish data from the UBIK® database to a mobile device (eg mobile phone, tablet).

Installation of Microsoft IIS

Resources

A physical server with MS Server 2008 R2 is used as the host system. On this server, the Hyper-V role is installed to operate at several virtual servers . However, a virtual server can have different operating systems. But in our case we need also an MS-​​Server2008 R2 installation.

Install role

01_Server Manager 02 Add Roles Wizard 03 Add Roles Wizard 04 Add Roles Wizard 05 Add Roles Wizard 06 Add Roles Wizard 07 Add Roles Wizard 08 Add Roles Wizard 09 Add Roles Wizard 02_Server Manager

To install the Internet Information Services (IIS) on Windows Server 2008 R2, start the server manager.

  • Click Start, point to Administrative Tools, and then click Server Manager.
  • Click Roles Summary, click Add Roles.
  • Use the "Add Roles" wizard to add the Web Server role.

When you use the Add Roles Wizard to install IIS, you get the default installation, which has a minimum set of role services. If you need additional IIS role services, such as Application Development or Health and Diagnostics, make sure to select the check boxes associated with those features in the Select Role Services page of the wizard.

Configuration of the web server

10 IIS Manager

For UBIK webservice we need additional features to make it properly and smoothly.

  • Microsoft. NET Framework 4
  • Roles / Feature. NET Framework 3.5.1 feature


Download and installation Microsoft .NET Framework 4

.NET Framework 4

01 .net Framework4 02 .net Framework4 03 .net Framework4

Installation .net Framework 3.5.1 Feature

01 .net Framework3.5.1 02 .net Framework3.5.1 03 .net Framework3.5.1 04 .net Framework3.5.1

Add Application Pool

An application pool is defined which (parts of) web site which work process (es) will be delivered - ultimately this means that an application pool defines who is responsible for the processing of one (or several) URL (s).

01 Application Pool 02 Application Pool 03 Application Pool

Certificate

We need a certificate that guarantees us the security of the connection and recognition of authorized mobile devices. After the creation of the certificate on the server, it must be exported using the export function. Our developers need this certificate to integrate it into our mobile application.

01 Certificate 02 Certificate 03 Certificate 04 Certificate

Bindings

Now we create a binding, so we get the correct certificate to access to our IIS service from external.

01 Binding 02 Binding 03 Binding 04 Binding 05 Binding 06 Binding 07 Binding

Local IIS-User

Create new service for UBIK

Testing the new service

Configuration of the UBIK® web service

Pre-requisites

  • Mobile application requires SSL authentication
  • A valid certificate must exist on the IIS, whereas a Self-Signed-Certificate on a local webserver if enough
  • Certificate has to be embedded in the mobile application by Augmensys GmbH
  • Create a local user "UBIK" on the web server with its own user profile
  • Use any password and add this user to the group "IIS_IUSRS"

Install service

  • Locate the public directory of the webserver (default: "inetpub\wwwroot")
  • Create a subdirectory and past the components of the UBIK® web service
  • Open the Server Manager and go to Internet Information Services Manager
  • Create a new application pool UBIK.Pool with .NET Framework >= v4.x
  • Locate the created subdirectory among the IIS sites and use the Convert to Application from the context menu
  • Click Select… and choose your application pool
  • Click Connect as… and choose UBIK as specific user
  • Open Advanced Settings of the application and enable https protocol

See also