Jump to: navigation, search

Difference between revisions of "HowTo:Install UBIK Web Service"


 
(151 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This document describes how to setup an IIS server and a web service for UBIK on MS Server 2008 R2.
+
Prior to the installation of an {{UBIK Web Service}} make sure to have a [http://www.iis.net/ Microsoft Internet Information Server (IIS)] available and configured accordingly. If not read the instructions how to [[HowTo:Install_Microsoft_IIS|install]] and [[HowTo:Configure_Microsoft_IIS_for_UBIK|configure]] an IIS for {{UBIK}}.
The web service is used to bring data from the UBIK database to a mobile device (eg mobile phone, tablet).
+
  
== Configuration of Internet Information Server (IIS) ==
+
== {{UBIK}} Content Web Service ''UBIKContent.svc'' ==
 +
# Create a new directory in the ''wwwroot'' directory of the IIS installation (default: ''c:\inetpub\wwwroot'')
 +
# Copy the components of the {{UBIK}} Web Service into the (new) directory
 +
# Create a new web applicaton as described [[HowTo:Configure_Microsoft_IIS_for_UBIK#Create_new_Web_Application|here]]
 +
# [[Web_Service_Configuration|Configure]] the authentication mode of the web service using either
 +
#* [[HowTo:Configure_Single_Local_Application_Authentication|Single Local Application]] or
 +
#* [[HowTo:Configure_LAS_Authentication|Local]] or [[HowTo:Configure_LAS_Authentication|Global Application Service]]
  
=== General ===
+
== {{UBIK}} Authentication Web Service ''USAM.svc''==
This document describes how to setup an IIS server and a web service for UBIK on MS Server 2008 R2.
+
If authentication should happen via a distinctive [[USAM]] web service
The web service is used to bring data from the UBIK database to a mobile device (eg mobile phone, tablet).
+
# Create a new directory in the ''wwwroot'' directory of the IIS installation (default: ''c:\inetpub\wwwroot'')
=== Resources ===
+
# Copy the components of the {{UBIK}} Web Service into the (new) directory
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.
+
# Create a new web applicaton as described [[HowTo:Configure_Microsoft_IIS_for_UBIK#Create_new_Web_Application|here]]
=== Install role ===
+
# [[Web_Service_Configuration|Configure]] the authentication mode of the USAM web service using [[HowTo:Configure_Single_Local_Application_Authentication|Single Local Application]]
[[File:UI_01_Server_Manager.png|thumb|220px|alt=01_Server Manager|01_Server Manager]]
+
[[File:UI_02_Add_Roles_Wizard.png|thumb|220px|alt=02 Add Roles Wizard|02 Add Roles Wizard]]
+
[[File:UI_03_Add_Roles_Wizard.png|thumb|220px|alt=03 Add Roles Wizard|03 Add Roles Wizard]]
+
[[File:UI_04_Add_Roles_Wizard.png|thumb|220px|alt=04 Add Roles Wizard|04 Add Roles Wizard]]
+
[[File:UI_05_Add_Roles_Wizard.png|thumb|220px|alt=05 Add Roles Wizard|05 Add Roles Wizard]]
+
[[File:UI_06_Add_Roles_Wizard.png|thumb|220px|alt=06 Add Roles Wizard|06 Add Roles Wizard]]
+
[[File:UI_07_Add_Roles_Wizard.png|thumb|220px|alt=07 Add Roles Wizard|07 Add Roles Wizard]]
+
[[File:UI_08_Add_Roles_Wizard.png|thumb|220px|alt=08 Add Roles Wizard|08 Add Roles Wizard]]
+
[[File:UI_09_Add_Roles_Wizard.png|thumb|220px|alt=09 Add Roles Wizard|09 Add Roles Wizard]]
+
[[File:UI_02_Server_Manager.png|thumb|220px|alt=02_Server Manager|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.
+
== {{UBIK}} Push Web Service ''UBIKPush.svc'' ==
 +
# Create a new directory in the ''wwwroot'' directory of the IIS installation (default: ''c:\inetpub\wwwroot'')
 +
# Copy the components of the {{UBIK}} Web Service into the (new) directory
 +
# Create a new web applicaton as described [[HowTo:Configure_Microsoft_IIS_for_UBIK#Create_new_Web_Application|here]]
 +
# [[Web_Service_Configuration|Configure]] the authentication mode of the web service using either
 +
#* [[HowTo:Configure_Single_Local_Application_Authentication|Single Local Application]] or
 +
#* [[HowTo:Configure_LAS_Authentication|Local]] or [[HowTo:Configure_LAS_Authentication|Global Application Service]]
  
• Click Roles Summary, click Add Roles.
+
== See also ==
 +
* [[Web_Service_Configuration|Web Service Configuration]]
 +
* [[HowTo:Install Microsoft IIS]]
 +
* [[HowTo:Configure_Microsoft_IIS_for_UBIK]]
 +
* [[USAM]]
  
• Use the "Add Roles" wizard to add the Web Server role.
+
[[Category:How-To|Install UBIK Web Service]]
 
+
[[Category:Web service|Install UBIK Web Service]]
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.
+
 
+
==Setting up the web server==
+
[[File:UI_10_IIS_Manager.png|thumb|220px|alt=10 IIS Manager|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
+
==See also==
+
* [[Installation_UBIK_Studio|Set up {{UBIK}} Studio]]
+
* [[Microsoft_SQL_Server|Set up Microsoft SQL Server]]
+
 
+
[[Category:UBIK Studio]]
+
[[Category:Configuration]]
+

Latest revision as of 09:49, 4 August 2015

Prior to the installation of an UBIK® Web Service make sure to have a Microsoft Internet Information Server (IIS) available and configured accordingly. If not read the instructions how to install and configure an IIS for UBIK®.

UBIK® Content Web Service UBIKContent.svc

  1. Create a new directory in the wwwroot directory of the IIS installation (default: c:\inetpub\wwwroot)
  2. Copy the components of the UBIK® Web Service into the (new) directory
  3. Create a new web applicaton as described here
  4. Configure the authentication mode of the web service using either

UBIK® Authentication Web Service USAM.svc

If authentication should happen via a distinctive USAM web service

  1. Create a new directory in the wwwroot directory of the IIS installation (default: c:\inetpub\wwwroot)
  2. Copy the components of the UBIK® Web Service into the (new) directory
  3. Create a new web applicaton as described here
  4. Configure the authentication mode of the USAM web service using Single Local Application

UBIK® Push Web Service UBIKPush.svc

  1. Create a new directory in the wwwroot directory of the IIS installation (default: c:\inetpub\wwwroot)
  2. Copy the components of the UBIK® Web Service into the (new) directory
  3. Create a new web applicaton as described here
  4. Configure the authentication mode of the web service using either

See also