Jump to: navigation, search

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


(Basic installation)
 
(143 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This page describes how to set up 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 publish data from the {{UBIK}} database to a mobile device (eg mobile phone, tablet).
+
  
== Configuration of Microsoft Internet Information Server ==
+
== {{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]]
  
=== Resources ===
+
== {{UBIK}} Authentication Web Service ''USAM.svc''==
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.
+
If authentication should happen via a distinctive [[USAM]] web service
=== Install role ===
+
# Create a new directory in the ''wwwroot'' directory of the IIS installation (default: ''c:\inetpub\wwwroot'')
[[File:UI_01_Server_Manager.png|thumb|220px|alt=01_Server Manager|01_Server Manager]]
+
# Copy the components of the {{UBIK}} Web Service into the (new) directory
[[File:UI_02_Add_Roles_Wizard.png|thumb|220px|alt=02 Add Roles Wizard|02 Add Roles Wizard]]
+
# Create a new web applicaton as described [[HowTo:Configure_Microsoft_IIS_for_UBIK#Create_new_Web_Application|here]]
[[File:UI_03_Add_Roles_Wizard.png|thumb|220px|alt=03 Add Roles Wizard|03 Add Roles Wizard]]
+
# [[Web_Service_Configuration|Configure]] the authentication mode of the USAM web service using [[HowTo:Configure_Single_Local_Application_Authentication|Single Local Application]]
[[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.
+
* 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.
+
== {{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]]
  
==Setting up the web server==
+
== See also ==
[[File:UI_10_IIS_Manager.png|thumb|220px|alt=10 IIS Manager|10 IIS Manager]]
+
* [[Web_Service_Configuration|Web Service Configuration]]
For UBIK webservice we need additional features to make it properly and smoothly.
+
* [[HowTo:Install Microsoft IIS]]
* Microsoft. NET Framework 4
+
* [[HowTo:Configure_Microsoft_IIS_for_UBIK]]
* Roles / Feature. NET Framework 3.5.1 feature
+
* [[USAM]]
  
 
+
[[Category:How-To|Install UBIK Web Service]]
== Setting up the web service ==
+
[[Category:Web service|Install UBIK Web 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==
+
* [[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