Jump to: navigation, search

Difference between revisions of "HowTo:Set up UBIK"


Line 1: Line 1:
 
The initial setup of {{UBIK}} and its components requires some extensive but straight forward steps. This guide gives an overview about the dependencies of the different components, whereas more detailed installation instructions can be found in separate linked articles, respectively.
 
The initial setup of {{UBIK}} and its components requires some extensive but straight forward steps. This guide gives an overview about the dependencies of the different components, whereas more detailed installation instructions can be found in separate linked articles, respectively.
  
A section covers the components required for the use cases as mentioned in the [[Getting_Started#Introduction|introduction]], respectively.
+
The next sections covers the components required for the use cases as mentioned in the [[Getting_Started#Introduction|introduction]], respectively. Specific configurations related to the {{UBIK Web Service}} will be discussed subsequently.
  
 
== Setup for Data Model Administration ==
 
== Setup for Data Model Administration ==
Line 42: Line 42:
 
Of course, it is also possible to use another authentication mode like [[USAM#LAS_.28Local_Application_Service.29|Local Application Service]].
 
Of course, it is also possible to use another authentication mode like [[USAM#LAS_.28Local_Application_Service.29|Local Application Service]].
  
=== UBIK Database ===
 
Set up the database either by importing an export file of an existing database or by executing the
 
** [Create empty SQL DB + execute SQL script]
 
* UBIK Studio
 
* .NET Framework 4.0
 
• UBIK Application (Android, Windows)
 
 
• Use cases
 
o UBIK Studio only: SL
 
o Working with client (mobile, web): LAS + USAM
 
  
 +
== Setup web
 
• Web service
 
• Web service
 
o Content
 
o Content
Line 59: Line 50:
 
o Optional: Push
 
o Optional: Push
 
***Configuration: endpoints, bindings
 
***Configuration: endpoints, bindings
 
 
All content and configuration data of {{UBIK}} is managed in a [http://www.microsoft.com/en-us/sqlserver/default.aspx Microsoft SQL] database (2008 R2 or newer). Once the SQL server engines is installed successfully, an administrator can set up a new {{UBIK}} database simple using the available release database.
 
 
[[File:UI_SettingUpUBIKDatabase_01.png|thumb|alt=Microsoft SQL Server Management Studio|Microsoft SQL Server Management Studio]]
 
== Setting up {{UBIK}} database ==
 
# Start the ''Microsoft SQL Server Management Studio'' and connect to the database server
 
# Navigate to ''Databases'' and add a new database
 
# Choose ''Tasks → Restore → Database'' from the context menu
 
## Choose the newly created database in the setting ''In database''
 
## Choose the copied backup file in ''From media''
 
## Check ''Restore'' of the according backup set
 
# Switch to the options-slider and check ''Overwriting actual data'' (if necessary)
 
# Finish the process by clicking {{key press|OK}}
 
 
{{Attention|Use maintenance plans for periodic backup of your own and the system databases!}}
 
 
== Requirements ==
 
=== Database user ===
 
The database user configured in {{UBIK}} Studio used to connect to the database needs
 
* to have the role ''sys.admin'' assigned
 
* to be marked as ''Database owner'' (dbo) of the according {{UBIK}} database
 
 
=== Windows firewall ===
 
For a non-local SQL server make sure that the SQL server port (default: 1433) is unlocked by the Windows firewall Inbound and Exbound rules.
 

Revision as of 13:40, 22 July 2015

The initial setup of UBIK® and its components requires some extensive but straight forward steps. This guide gives an overview about the dependencies of the different components, whereas more detailed installation instructions can be found in separate linked articles, respectively.

The next sections covers the components required for the use cases as mentioned in the introduction, respectively. Specific configurations related to the UBIK® Web Service will be discussed subsequently.

Setup for Data Model Administration

See Set up UBIK® Database for help on configuration issues.
See How to install UBIK® Studio for help on installation issues.

Session Management Type

Using Single Local Application mode is sufficient to administrate the data model and to work with UBIK® Studio only.

See this guide for help on configuration issues.

Of course, it is also possible to use another authentication mode like Local Application Service.

Setup for Working Mobile

See Set up UBIK® Database for help on configuration issues.
See How to install UBIK® Studio for help on installation issues.
See Configure Microsoft IIS for UBIK for help on configuration issues.

Session Management Type

For being able to use mobile clients it is mandatory to use Local Application Service as authentication mode.

See this guide for help on configuration issues.

Setup for Interfacing 3rd Party Systems

See Set up UBIK® Database for help on configuration issues.
See How to install UBIK® Studio for help on installation issues.
See How to install UBIK® Enterprise Service for help on installation issues.

Session Management Type

Using Single Local Application mode is sufficient to administrate the data model and to interface 3rd pary systems.

See this guide for help on configuration issues.

Of course, it is also possible to use another authentication mode like Local Application Service.


== Setup web • Web service o Content  Configuration: endpoints, bindings vom Push o USAM o Optional: Push

      • Configuration: endpoints, bindings