SWARCO MIZAR S.R.L.

OMNIA
Installation Guide
 SWARCO MIZAR S.R.L.

Title: [ENG] OMNIA - OM0706E18SG - Installation Guide.doc

Date: 04/07/18
Version: 008

A publication of

SWARCO MIZAR S.R.L.

Via Nizza, 262/57 - 10126 Torino (Italy)
Tel: +39.011.6500411
Fax: +39.011.6500444
www.swarcomizar.com

Contact:
[email protected]

All rights reserved

OM0807E18SG

Reproduction in whole or part, in any form, without the written consent of the copyright owner
is prohibited.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 2/78
 SWARCO MIZAR S.R.L.

CONTENT

1 ABOUT THIS DOCUMENT ............................................................................................................. 5

1.1 Objectives ................................................................................................................................ 5
1.2 Document Properties ............................................................................................................... 5
1.3 Versions ................................................................................................................................... 5
1.4 Definitions ................................................................................................................................ 6

2 Introduction .................................................................................................................................... 7

3 Technologies used and compatibility ......................................................................................... 8

4 OMNIA Environment ...................................................................................................................... 9

4.1 Distributed installation over multiple servers ........................................................................... 9
4.2 Single server installation ........................................................................................................ 10

5 OMNIA Installation Prerequisites ............................................................................................... 11

5.1 Operating System .................................................................................................................. 11
5.2 Third party packages ............................................................................................................. 11
5.3 Network Configuration ........................................................................................................... 12
5.4 Database Server prerequisites .............................................................................................. 13
5.4.1 Server name and engine instance name ....................................................................... 13
5.4.2 Setting up the SQL administrator user “omniauser” ...................................................... 14
5.5 Omnia Application Server prerequisites ................................................................................ 16
5.6 Omnia Web Server prerequisites .......................................................................................... 16
5.6.1 Automatic actions carried out by the Installation package ............................................ 17

6 New Installation ........................................................................................................................... 18

6.1 STEP 1 – Download Setup Packages ................................................................................... 18
6.2 STEP 2 – Running the OmniaInstaller application ................................................................ 20
6.3 STEP 3 – Installing third party components .......................................................................... 23
6.3.1 .NET Framework on Windows 2012 and above ............................................................ 24
6.4 STEP 4 – Installing the Omnia Components ......................................................................... 33
6.4.1 STEP 4A – Single server installation ............................................................................. 33
6.4.2 STEP 4B – Distributed installation over multiple servers .............................................. 33
6.4.3 STEP 4.1 – Installing the Database Components Management ................................... 35
6.4.4 STEP 4.2 – Building up databases using OmniaDbBuilder .......................................... 38
6.4.5 STEP 4.3 – Installing the web components ................................................................... 42
6.4.5.1 WEB Services configuration ...................................................................................... 44
6.4.5.2 Graphical User Interface test ..................................................................................... 47
6.4.5.3 OMNIA Custom Logo (optional) ................................................................................ 48
6.4.6 STEP 4.4 – Installing OMNIA Web Connection Manager (WCM)................................. 50
OM0807E18SG

6.4.6.1 WCM configuration .................................................................................................... 51

6.4.7 STEP 4.5 – Installing the kernel applications ................................................................ 54
6.4.8 STEP 4.6 – Installing OMNIA Server............................................................................. 56
6.4.8.1 Omnia Server 1001 Error .......................................................................................... 57
6.4.8.2 Omnia Server test ...................................................................................................... 58

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 3/78
 SWARCO MIZAR S.R.L.

7 Updating Omnia previously installed through the installation packages ............................. 59

7.1 Verifying the Omnia Installer version ..................................................................................... 59
7.2 Verifying the installed components ........................................................................................ 59
7.3 Upgrading the available Omnia packages............................................................................. 60
7.4 System Update ...................................................................................................................... 63

8 Updating Omnia previously installed without the installation packages .............................. 65

8.1 OMNIA WEB Components .................................................................................................... 65
8.1.1 Before Starting ............................................................................................................... 65
8.1.2 WEB Services ................................................................................................................ 65
8.1.3 Graphical User Interface ................................................................................................ 66
8.2 OMNIA Apps Components .................................................................................................... 66
8.3 OMNIA Server ....................................................................................................................... 66
8.4 OMNIA Web Connection Manager (WCM) ........................................................................... 66
8.5 Omnia Web Commons Components directories ................................................................... 67

9 Troubleshooting .......................................................................................................................... 68
9.1 Internet Information Service (IIS)........................................................................................... 68
9.1.1 Installation of one or more roles, role services, or features failed ................................. 68
9.2 WEB Services ........................................................................................................................ 69
9.2.1 Test procedure does not work with Firefox ................................................................... 69
9.2.2 Test procedure does not return any data ...................................................................... 72
9.3 Graphical User Interface........................................................................................................ 73
9.3.1 Server Error in ‘/Omnia/WebDesktop’ Application – The request failed with HTTP status
404: Not Found .............................................................................................................................. 73
9.3.2 Server Error in ‘/Omnia/WebDesktop’ Application ......................................................... 74
9.3.3 Failed to load data xml from ../GroupStatusPageHandler.ashx?from... ........................ 75
9.3.4 Server Error in ‘/Omnia/WebDesktop’ Application –
System.Web.Services.SoapException .......................................................................................... 76
9.3.5 Server Error in ‘/Omnia/WebDesktop’ Application – Response filter is not valid ......... 76
9.3.6 Signal Group Diagram export to PNG or PDF crashes ................................................. 77
9.3.7 Fault management not able to load data ....................................................................... 77
9.3.8 Error loading OMNIA Calendar Editor ........................................................................... 78
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 4/78
 SWARCO MIZAR S.R.L.

1 ABOUT THIS DOCUMENT

1.1 Objectives

This document describes the OMNIA installation.

This document can be used for any OMNIA installation.

1.2 Document Properties

Author (s) Fabio D’Aprile, Antonella Barletta

Checked by Technical Division
Distribution List Public
Filename [ENG] OMNIA - OM0706E18SG - Installation Guide.doc

1.3 Versions

Version-
Date Change Author
number
01 18-05-2017 First version Fabio D’Aprile,
Antonella Barletta
02 12-02-2018 Various updates Antonella Barletta
03 14-03-2018 Pre-updating sanatorium and revisions Antonella Barletta
04 16-04-2018 Minor updates Antonella Barletta
05 11-05-2018 Section of creation db user and Omnia Server 1001 Antonella Barletta
error
06 23-05-2018 Section OmniaConfigManager.exe Antonella Barletta
07 14-06-2018 Various updates Antonella Barletta
08 04-07-2018 Third party and WCM changes Antonella Barletta
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 5/78
 SWARCO MIZAR S.R.L.

1.4 Definitions

DB Database
DBMS Data Base Management System
DOS Disk Operating System
DSN Data Source Name
DTD Document Type Definition
FEP Front End Processor
HW Hardware
LAN Local Area Network
LU Logical Unit
MISTIC Mizar Software for Traffic Information Centre
MIZAR MIZAR Automazione S.R.L.
MoM Minutes of Meeting
MS Microsoft®
MS SQL Microsoft SQL Server™
OCX OLE Control eXtension
ODBC Open Database Connectivity
OLE Object Linking and Embedding
OSI Open Systems Interconnection
SQL Structured Query Language
SRT Short Receive Telegram
SW Software
TCP Transmission Control Protocol
UAC User Account Control
UDP User Datagram Protocol
UI User Interface
URL Uniform Resource Locator
VMS Variable Message Sign
XML eXtensible Markup Language
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 6/78
 SWARCO MIZAR S.R.L.

2 Introduction

This guide intends to aid technicians involved with the installation or update of OMNIA.

The installation phases are described in this document in three main chapters which refer to
three different installation scenarios:

A brand new installation

Update a OMNIA installed using setup packages
Update a OMNIA previously installed manually

Refer to the specific section of the document according to your needs.

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 7/78
 SWARCO MIZAR S.R.L.

3 Technologies used and compatibility

OMNIA can be installed on physical or virtual servers equipped with Microsoft Windows
Server 2008 R2 / 2012 / 2012 R2 / 2016.

It is fully compatible with 64-bit operating systems.

OMNIA system databases are based on the relation database Microsoft SQL Server.
Versions 2008 R2 / 2012 / 2014 / 2016 of Microsoft SQL server are supported.

The business engines for the OMNIA were implemented using Microsoft Visual Studio 2010 /
2015.
They stand over the .NET Framework 4.0 and extensions.

These engines also use an "Open Database Connectivity" (ODBC) fully supported by “SQL
Server”.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 8/78
 SWARCO MIZAR S.R.L.

4 OMNIA Environment
According to the specific system requirements, OMNIA can be installed in different
approaches.

The two most common use cases described in this guide are:
A distributed installation over multiple servers
A “stand alone” installation over a single server

4.1 Distributed installation over multiple servers

A typical distributed installation requires the following three servers (physical or virtual):

Database Server
Applications Server
Web Server

The following names are suggested for the servers mentioned above:

Server Default Name

Database Server OMN-DBS-SRV
Applications Server OMN-APP-SRV
Web Server OMN-WEB-SRV

The use of these names is not mandatory since the setup packages allow using different
names; it does not affect the installation process.

It is strongly advised, however, the use of the given default names in order to establish a
standard installation procedure that aims to provide an answer to all possible questions that
may arise during the installation process.

In case of requiring this type of installation, please refer to the specific note regarding the
applicability of this particular case in the following chapters.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 9/78
 SWARCO MIZAR S.R.L.

4.2 Single server installation

A single server installation means that the three main components of OMNIA: Database,
Applications and Web components; will be installed onto one single server.

Follow the installation steps described in the following chapters concerning this case.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 10/78
 SWARCO MIZAR S.R.L.

5 OMNIA Installation Prerequisites

5.1 Operating System

OMNIA supports the operating system Microsoft Server 2008 R2 / 2012 / 2012 R2 / 2016.

The physical or virtual machines that make up the environment must have previously
installed the above operating systems. Then, a user with full administrator rights must be
allocated on all the machines and network disks required. This User shall be used during the
installation process of the Platform.

Windows 2012 operating systems:

The user must be Administrator and not belong to the group; otherwise, if the user belongs to
the group, the UAC (User Account Control) must be disabled from the policy manager.

In order to disable the UAC from the policy manager, the policy of active directory must be
changed.

Use Case: For all Environment Variations

You must assign the suitable roles available to the servers according to the windows
platforms in order to carry out the tasks of Database Server, Application Server and Web
Server.

5.2 Third party packages

The kernel applications of OMNIA use some libraries created by third parties.
These packages are available from the SWARCO Mizar Download Center and are
distributed in order to simplify the installation of the Omnia on the machines that comprise
the environment:

1) Microsoft .Net Framework

2) ASP.NET MVC 4 for Visual Studio 2010 SP1 and Visual Web Developer 2010
SP1

Apps and Web machines must have previously installed the Microsoft.NET Framework
versions 4.0 or higher.
It is a standard component of the Windows operating system and the above version can be
retrieved and installed through the Omnia Installer program from the SWARCO Download
Center (Mizar Release server) or directly downloaded from Official Microsoft Download
Centre using the provided links https://www.microsoft.com/en-
us/download/details.aspx?id=42642; however it is necessary to refer to the Microsoft website
in order to download updates and / or language support.

Also important for web server installation is Microsoft Internet Information Services (IIS), a
standard component of the Windows operating system.
OM0807E18SG

Please refer to the Microsoft official Support centre for information regarding the installation
of the Microsoft Framework and related software.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 11/78
 SWARCO MIZAR S.R.L.

5.3 Network Configuration

Use Case: Single server installation

Since there is only one system server, then the only concern would be to give a primary valid
IPV4 IP address to the machine.

Use Case: Distributed installation over multiple servers

As mentioned before, the system is installed over three servers:

Server Default Name

Database Server OMN-DBS-SRV
Applications Server OMN-APP-SRV
Web Server OMN-WEB-SRV

The above names are only suggestions as the installation packages allow to define different
names as it has been previously stated into this guide.

Allocate to every machine a valid IPV4 primary address.

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 12/78
 SWARCO MIZAR S.R.L.

5.4 Database Server prerequisites

This manual does not cover how to install Microsoft SQL Server. Please refer to the official
Microsoft support centre for information about it. This chapter only covers the features
necessary in order to install Omnia.

Use Case: dedicated Database server machine or unique system server

Install Microsoft SQL Server 2008 R2 or higher in English with all the features available
either on a dedicated server (distributed installation) or on the unique system server (single
server installation).

It is suggested to install SQL Server with “named instance" under the name "SQLOMNIA01".

The database instance name is required throughout the setup of a MS SQL Server
authentication; this is the instance name given to the TCP / IP port. The name of the
database can contain a maximum of 128 characters.

By default, the name of the instance is "MSSQLSERVER" (non-express edition) or

"SQLEXPRESS" (express edition). This has to be changed to "SQLOMNIA01".

In MS SQL Server in order to install OMNIA databases you have to use an user “db_owner”
roles. For example:
Login: omniauser
Password: omnia123

If you don’t have a dedicated machine, it needs to use an administrator database user.

5.4.1 Server name and engine instance name

Default names have been suggested for the default SQL Server instance. Although these are
only suggestions and should not represent a constraint; there is however, a restriction
between the instance name and the name of the Database Server machine.

Restriction: Both names cannot be contained one inside the other.

For example:

No No Yes

Server Name DBOMNIA SQLOMNIA_PC OMNIASERVER

SQL Server Name SQLDBOMNIA SQLOMNIA SQLOMNIA01

For the server machine the suggested name is: “OMN-DBS-SRV”.

For the SQL instance the suggested name is: “SQLOMNIA01”.
OM0807E18SG

Special Use Case: Multiple instances of Omnia with a unique Database Server

In case of having to install multiple instances of SQL Server on the same server; it is
suggested to use the names: “SQLOMNIA01”, “SQLOMNIA02”, and so on.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 13/78
 SWARCO MIZAR S.R.L.

5.4.2 Setting up the SQL administrator user “omniauser”

In order to set up a new user, open “Microsoft SQL Management Studio” on the database
server machine and follow these steps:

1) Connect to the server using <server name>\<instance name>

2) Right click over the directory “Security\Logins” and select “New Login”
3) From the left hand side menu, click on the page “General” and enter “omniauser” as
Login name followed by a password.
4) From the left hand side menu, click on the page “Server Roles” to provide the
permissions necessary for the new user (select “dbcreator”, “public”, “sysadmin”).
5) From the left hand side menu, click on the page “User Mapping” to manage the
relationship between the user and the databases. Map out the databases “master”,
“model”, “msdb”, “tempdb” with the roles “db_owner” and “public”.

The following images show the steps described above.

Add the user “omniauser”:

Enter the username and password (Eg. “omniauser” and “omnia123”) respectively; and
remove the option about “Enforcing password policy” from the checkbox:
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 14/78
 SWARCO MIZAR S.R.L.

Allocate the roles on the server (“dbcreator”, “public”, and “sysadmin”):

OM0807E18SG

Map out the user to the system databases (“master”, “model”, “msdb”, “tempdb”) and the
roles “public” e “db_owner”:

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 15/78
 SWARCO MIZAR S.R.L.

5.5 Omnia Application Server prerequisites

Use Case: dedicated Application Server machine or unique system server

The Server machine where the Omnia applications package is to be installed must be
supplied with a physical disk for example identified with the letter “C:\” which is not
compulsory but strongly advised. In this case the Omnia applications are installed into the
directory C: \ Omnia \ Apps.

In case of setting up a distributed installation and in case of having the availability of a NAS,
it is advised to make so, that all machines that are part of the system environment, point out
to the disk “C:\” where the Omnia applications are.

The user in charge of setting up all machines of the Platform must have full Administration
rights on the disks and computers involved.

This manual is not a reference to the Windows Operating System Guide. Please refer to the
Microsoft official guide for information about disk configuration and use.

5.6 Omnia Web Server prerequisites

Use Case: dedicated Web Server machine or single system server

OM0807E18SG

The web server computer must be supplied with Internet Information Services (IIS) version 7
or higher.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 16/78
 SWARCO MIZAR S.R.L.

Internet Information Services (IIS) is a standard component of the Windows operating

system. Setup files (where needed) are available directly in the operating system disk.

Please make sure that all of the IIS features are installed since a Standard IIS installation will
not contain all the features required by Omnia Web.

The web server engine can be customized by adding or removing modules. Integrate
pipeline processing of IIS and ASP.NET. Please refer to the guide chapters for the correct
configuration.

Use Case: Specific Web Server machine with disk C:\ within an array of shared hard disks
(NAS) amongst Database/Application/Web Server or Single System Server installation

The Omnia web components are installed into the directory C: \ Omnia \ Web, the web
commons components directly in the C: \ Omnia directory.

It is not compulsory but strongly advised to install these components into the drive “C: \”,
particularly for this use case.

Use Case: Specific Web Server machine without a disk unit C:\ into an array of hard disks
and the drive C:\ is shared amongst Database/Application/Web Server

Omnia Web components are installed in the directory <drive>:\ Omnia \ Web \, the web
commons components directly in the <drive>:\ Omnia directory.

The chapter dedicated to the installation of web and web commons components of this guide
describes how to set up the above installation directory.

5.6.1 Automatic actions carried out by the Installation package

In addition to the creation of the system environment and installing web and web commons
components (directory and Web applications) the installation package performs the following
actions:

1) Creates an Application pool in IIS named “AP – Omnia Web”

2) Creates an Application pool in IIS named “AP – OmniaWebCommons”
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 17/78
 SWARCO MIZAR S.R.L.

6 New Installation
This type of installation applies to systems that do not have any components of Omnia
installed; that is on servers that only comply with the Microsoft packages required:

1) Microsoft SQL Server

2) Microsoft Internet Information Services (IIS)

It is out of the scope of this guide to describe the installation process of the above packages.
Please refer to the official Microsoft support centre for information on how to install any of the
above software components.

These programs must be previously installed and must be working properly before installing
OMNIA.

6.1 STEP 1 – Download Setup Packages

Use Case: Single server installations

The "STEP 1 - Download Setup Packages" must be applied on the server where Omnia is to
be installed.

Use case: Distributed installations

The "STEP 1 - Download Setup Packages" must be repeated on each server that takes part
of the distributed environment.

Special Use Case: Isolated Server or Server not connected to Internet

Download the packages on a computer connected to the network and then copy all the
downloaded content from the folder C: \ InstallOmnia onto the destination server into another
folder called C:\ InstallOmnia.

Make sure that all the downloaded content was fully copied into the destination folder
C:\InstallOmnia of the appointed server.

Preliminary Actions before downloading the Setup packages

Create the “InstallOmnia” folder on the C: \ drive of your server (C: \ InstallOmnia)

From the Browser of your choice, go to the SWARCO Mizar Download Center page:
http://products.miz.it/DownloadCenter/OmniaPackages/lastrev.html as it is shown in the
following screenshot:
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 18/78
 SWARCO MIZAR S.R.L.

Download the program OmniaInstaller.exe by clicking on the corresponding link and save it
into the folder “C: \ InstallOmnia”.

The link to the Download Center will always return the last updated version of this
application.

Note:
Prior to executing any action to update Omnia (once an initial installation was performed),
make sure that the current version of OmniaInstaller.exe is the same as the one available on
the download page. To know the version of OmniaInstaller.exe program right click on it and
Properties/Details.
In case the version in use were older than the one available at the Download Center, then
download first the latest version and replace (overwrite) the old one (in C:\InstallOmnia\
OmniaInstaller.exe) with the new one.
OM0807E18SG

Launch the program OmniaInstaller.exe.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 19/78
 SWARCO MIZAR S.R.L.

6.2 STEP 2 – Running the OmniaInstaller application

Use case: Installation from Scratch – Installation packages unavailable

The program OmniaInstaller.exe will display an empty list of components since such
packages have not been downloaded yet from the SWARCO Mizar Download Center.

Click on the “Packages Downloader” tab for downloading the most up to date versions and
released packages from the SWARCO Mizar Download Center.

Click the "Load" button to populate the list of updated files.

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 20/78
 SWARCO MIZAR S.R.L.

After a few seconds of downloading, depending on your internet connection speed, the
program will display a list of files and updated installation packages available for download;
as it is shown on the following image:

Select either all or individual files to be downloaded by clicking into the boxes on the left
hand side.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 21/78
 SWARCO MIZAR S.R.L.

Click on the "Download" button:

Wait for the download process to be completed.

Note:
The application OmniaInstaller.exe displays the list of all files available on the SWARCO
Mizar Download Center; however, only the files not yet updated locally will be downloaded.

At the end of the download process, the Platform Installer will display the following:
OM0807E18SG

Tab “Packages Downloader” will show the status of “Completed” for all files
Tab “Packages Launcher” will display the list of packages to be installed.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 22/78
 SWARCO MIZAR S.R.L.

Don’t close the OmniaInstaller application until the end of all installation activities. Incorrect
closing of the application, however, does not cause any problems.

Special Use Case: Isolated Server or Server not connected to Internet

Download all packages on a computer with internet connection. When download is
completed, copy all packages to the “C:\InstallOmnia” folder of the isolated server.

6.3 STEP 3 – Installing third party components

Use Case: Single server installation

Third party components must be installed on the system machine.

Use Case: Distributed installation

All the third party components must be installed on the Web Server machines. On the
Application Server you need to install the ASP.NET MVC 4 libraries.

Actions
Use the OmniaInstaller.exe to select the option “Third Parts Components” and click on the
“Install” button.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 23/78
 SWARCO MIZAR S.R.L.

The following installation packages will be sequentially launched:

1) Microsoft.NET Framework
2) ASP.NET MVC 4 for Visual Studio 2010 SP1 and Visual Web Developer 2010
SP1
3) Microsoft Internet Information Services (IIS)

6.3.1 .NET Framework on Windows 2012 and above

It should be noted that the .NET Framework components on Windows 2012 Microsoft
operating systems and above represent "server roles"; can be enabled from Server Manager.

When the OmniaInstaller launches the installation of the Framework packages, a warning is
displayed saying that this must be done through the Server Manager tool.

When this happens, proceed with the installation of the remaining components (automatically
launched) by pressing the "Close" button.

Manual Installation example of the Framework components over Windows 2016

On Windows 2016, use the "Server Manager" tool in order to install the Framework
components, as follows:

Go to the Server Manager:

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 24/78
 SWARCO MIZAR S.R.L.

Select “Add roles and features”:

In the step "Installation type" select the option “Role-based or feature based installation”:
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 25/78
 SWARCO MIZAR S.R.L.

Go through the steps “Server Selection” and “Server Roles” to get to the “Features” screen:

Select the options “.NET Framework 3.5 Features” and “.NET Framework 4.6 Features” and
then click “Next”.

Once the installation process has finished click on the “Close” button.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 26/78
 SWARCO MIZAR S.R.L.

Manual Installation example of the server roles of IIS over Windows 2012

On Windows 2012, use the "Server Manager" tool in order to install the Framework
components, as follows:

1. Start the “Server Manager” from the “Application bar”.

2. Open the “Dashboard” view and select “Quick Start”

Figure 1: Server Manager

3. Click on “Add roles and features” to open the “Add Roles and Features Wizard”

Figure 2: Add Roles and Features Wizard

OM0807E18SG

4. Select “Role-base or feature-based installation” and next to continue the

configuration of the Server Roles for selected server

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 27/78
 SWARCO MIZAR S.R.L.

Figure 3: Select installation type

5. Click “Next” to start the Server Selection, select the server from the Server Pool and
next to start the configuration of the Server Roles only for selected server

Figure 4: Select destination server

6. From the Roles list, select “Web Server IIS”, “Add Roles and Features Wizard” is
OM0807E18SG

displayed

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 28/78
 SWARCO MIZAR S.R.L.

Figure 5: Select Web Server (IIS) Role

7. “Add Roles and Features” window will appear to include “Management Tools”, click
“Next”

Figure 6: Add Roles and Features Wizard – IIS Management Console

8. Confirm the option to include management tools and click “Add Features” button to
proceed

9. In the “Add Roles and Features Wizard”:

a. add all .NET Framework 3.5 Features
OM0807E18SG

b. add ASP.NET 4.5 (all features)

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 29/78
 SWARCO MIZAR S.R.L.

Figure 7: Add Roles and Features Wizard – Features

10. Click Next to proceed to “Role Services” configuration

a. locate “Performance” section and enable “Dynamic Content Compression”

Figure 8: Roles Services – Performance

b. locate “Application Development” section and enable ASP, ASP.NET 3.5,

ASP.NET 4.5 and WebSocket Protocol
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 30/78
 SWARCO MIZAR S.R.L.

Figure 9: Roles Services – Application Development

c. locate the “Management Tools” section and select “IIS Management Scripts and
Tools” and “IIS 6 Management Compatibility” (all features).

Figure 10: Roles Services – Management Tools

d. Click “Next” to continue

OM0807E18SG

11. Click “Install” in the Confirmation installation selections window

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 31/78
 SWARCO MIZAR S.R.L.

Figure 11: Roles Services – Confirmation installation selections

Once the installation process has finished click on the “Close” button.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 32/78
 SWARCO MIZAR S.R.L.

6.4 STEP 4 – Installing the Omnia Components

Different actions must be performed depending on whether OMNIA is installed on a “single

server” or “over multiple servers”.

Continue with the STEP “A” or “B” depending on the type of installation.

It is suggested to keep the “OmniaInstaller” application open until the end of all installation
activities. Closing the application mistakenly, however, does not affect the correct installation
of the platform.

6.4.1 STEP 4A – Single server installation

It is possible to install OMNIA on a single server if the service to be provided is compatible

and supported by the available hardware.

The evaluation of an optimal environment for OMNIA as well as the necessary hardware will
be performed in advance by a qualified SWARCO technician.

Actions

After downloading the individual installation packages on the server, follow the next steps in
the order listed below:
install the “Omnia Database Components Management” package
Run the “OmniaDbBuilder” application in order to construct the databases on MS
SQL Server
install the “Omnia Web Commons Components” package
install the “Omnia Web Components” package
install the “Omnia WCM Service” package
install the “Omnia Applications” package
install the “Omnia Server” package

Please refer to the appropriate chapters within this guide for every step. The specific actions
to be followed that correspond to any particular Use Case can be found there.

6.4.2 STEP 4B – Distributed installation over multiple servers

After downloading the installation packages on all servers that belong to the system
environment, it is required to perform the following installation steps in the order stated
below. This must be repeated for every dedicated server:

Database Server
OM0807E18SG

install the “Omnia Database Components Management” package

Run the “OmniaDbBuilder” application in order to construct the databases on MS
SQL Server

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 33/78
 SWARCO MIZAR S.R.L.

Omnia Web Server

install all the “Third party” components
install the “Omnia Web Commons Components” package
install the “Omnia Web Components” package
install the “Omnia WCM Service” package

Omnia Application Server

install the .NET Framework “Third party” components
install the “Omnia Applications” package
install the “Omnia Server” package

Please refer to the appropriate chapters within this guide for every step. The specific actions
to be followed that correspond to any particular Use Case can be found there.

Install the components for every server of the platform in the following order:
1) Database Server
2) Application Server
3) Web Server

SPECIAL Use Case 1: Distributed Installation using only two servers grouping Application
and Web into one server

Even when Omnia installation is done into a single server, it is required to install its
components in the correct order.

Firstly install the database components into the Database server as stated into the
appropriate chapter.

Then, it is required to install the Omnia applications package followed by the web
components package into the same server (Application and Web machine). Please refer to
the appropriate chapter in the guide in order to do so.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 34/78
 SWARCO MIZAR S.R.L.

6.4.3 STEP 4.1 – Installing the Database Components Management

Use Case: Single server installation

This package must be installed on the single system machine.

Use Case: Distributed installation

This package must be installed on the “Database Server” machine; this is the server where
MS SQL server is installed.

Actions

Use the “OmniaInstaller” application from “C: \ InstallOmnia” and select the "Omnia Database
Components" option, then click on the "InstallOmnia" button.

This will open the setup Welcome screen:

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 35/78
 SWARCO MIZAR S.R.L.

Press the "Next" button at the bottom of the screen to continue with the window for selecting
the installation directory:

Press "Next" and on the next input form, please edit information about:
Database Server Name – name of the machine where the installation is taking place
Database Server IP Address – primary IPV4 of the machine
OM0807E18SG

SQL Server Instance Name –SQL Server instance name

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 36/78
 SWARCO MIZAR S.R.L.

Click on the “Next” button to begin the installation.

At the end of the installation, it is possible to verify the presence of the components installed
by opening the "Start" menu in Windows.

The following options become available:

Omnia \ Database Config Apps
OmniaDbBuilder
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 37/78
 SWARCO MIZAR S.R.L.

6.4.4 STEP 4.2 – Building up databases using OmniaDbBuilder

Use Case: Stand Alone installation

The system storage (multiple databases) is build up into the single system machine.

Use Case: Distributed Installation

The system storage (multiple databases) is built up using the “Database Server”. Perform the
required actions on the database server machine.

Actions

After having installed the necessary components to build up the database, it is then possible
to build up the database for Omnia.

From the "Start" menu in Windows, launch the OmniaDbBuilder application through the
menu item:
Omnia \ Database Config Apps
OmniaDbBuilder

The application OmniaDbBuilder will be displayed with the input fields correctly filled in with
the default values that correspond perfectly to the environment to be installed.
OM0807E18SG

If necessary, change the installation paths of the database files, otherwise are used the
default paths.

Default:
Database Path: C:\Omnia\SqlData\Database
SWARCO MIZAR S.R.L. a socio unico
Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 38/78
 SWARCO MIZAR S.R.L.

Log Path: C:\Omnia\SqlData\Log

Backup: C:\Omnia\SqlData\Backup

At the creation of a new database, you can write the name of it and chose the collation to use
for it. Remember that for the creation of a new database you have to use a “sysadmin” user
(e.g. the user “omniauser” created before). At the updating operation you can select the one
existing database, clicking on the button associated to the database name.

Open the tab “Script Execution” and click the button “Launch” to launch the scripts
associated to the last database revision:

Scripts will be executed for the construction of the database components contained in the
solution. A progress bar will show the status of the work.
This phase takes a few minutes, depending on the hardware used.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 39/78
 SWARCO MIZAR S.R.L.

Errors can be easily identified by the presence of a red icon on the left hand side. Error
details are also available through the button "Show Log".

At the end of the construction phase of the database, the application OmniaDbBuilder can be
closed by clicking the "Close" button.
OM0807E18SG

The list of databases that comprise Omnia can be seen from SQL Server Management
Studio.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 40/78
 SWARCO MIZAR S.R.L.

The database that belong to Omnia is:

Omnia
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 41/78
 SWARCO MIZAR S.R.L.

6.4.5 STEP 4.3 – Installing the web components

Use Case: Stand Alone installation

The web components will be installed onto the single system machine.

Use Case: Distributed Installation

The web components will be installed on the Web Server machine.

Using the OmniaInstaller.exe application, select the option “Omnia Web Components” first
and “Omnia Web” then and click the install button.

The corresponding installation program will be launched.

This is the Welcome screen of the installation package for the web components (web
Commons and Web components):
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 42/78
 SWARCO MIZAR S.R.L.

When the installation directory is prompted click “Next”.

The installation of web components is very similar to the one of the kernel applications;
hence, enter the reference to the machines that make up the system environment.

Next, three input forms will be displayed for web components to enter the connection to the
installation machines.

Database Server (Name, IP address, SQL Server instance name)

Application Server (Name, IP address)
Web Server (Name, IP address)

Since this is an installation on a single server machine, it is required to enter the same
references for the entries:

Database Server Name = Application Server Name = Web Server Name

Database Server IP = Application Server IP = Web Server IP
OM0807E18SG

Continue until the end of the installation wizard.

Restart the server after the installation.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 43/78
 SWARCO MIZAR S.R.L.

The automated installation provide to assign the correct database server name and instance
name in the Omnia connection string in the config file, but doesn’t change the name of
database if it is different from the default “Omnia”.

6.4.5.1 WEB Services configuration

After the Web Components installation, you have to update the file web.config in the folder
Web\WebServicesApp.
To do this you can choose to work manually on it or to use an appropriate tool provided by
the setup: OmniaConfigManager.exe.

6.4.5.1.1 Manual configuration

1. Open Windows Explorer and browse the destination (local or network) disk where the
setup of the Web Services has been performed (i.e. C:\Omnia\Web\WebServicesApp)
2. Open the “web.config” file in the WebServicesApp directory using any textual editor

3. In the section <connectionStrings> update the “Catalog” parameter of the key

“connectionString” with the database name:

DATABASE NAME Name of the Omnia Database installed on the DBMS

(default = Omnia)
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 44/78
 SWARCO MIZAR S.R.L.

6.4.5.1.2 OmniaConfigManager.exe tool configuration

1. Open Windows Explorer and browse the destination (local or network) disk where the
tool provided by setup is located (i.e. C:\Omnia\WinApps\OmniaConfigManager.App)
2. Launch the OmniaConfigManager.exe application

3. The values presented in the form are the default values of the section
<connectionStrings> of the key “connectionString” of the file
C:\Omnia\Web\WebServicesApp\web.config:

4. Change these values as you need and save the results (clicking on the “Save” button)
OM0807E18SG

6.4.5.1.3 WEB Services test

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 45/78
 SWARCO MIZAR S.R.L.

1. From the “Internet Information Services” Manager, open the Web Sites tree to the deep
level of the “Omnia\WebServicesApp”.
2. Click on “WebServicesApp” to display the list of files in the “WebServicesApp” directory
3. In the list of files, locate the file “WS_Access2.asmx”, select it and then right click to open
the drop down menu, then select “Browse”.

4. In the WS_Access2 Web Service view, click on the “CheckUsername” link.

5. Fill the username field using the default administrator user (username=admin), then click
“Invoke” button.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 46/78
 SWARCO MIZAR S.R.L.

6. If everything is correct, the request will return value 1

6.4.5.2 Graphical User Interface test

1. Start Microsoft Internet Explorer and test the installation at http://localhost:[PORT]/omnia

2. If everything is correct, the OMNIA login

page is displayed (In the image the old
GUI interface).

3. Log in using the default username / password.

username admin
password admin

4. if everything is correct, the OMNIA welcome page is displayed.

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 47/78
 SWARCO MIZAR S.R.L.

6.4.5.3 OMNIA Custom Logo (optional)

OMNIA can be configured adding a custom logo.
When a custom logo is configured, it will be displayed on both Login page and Virtual
Desktop.

6.4.5.3.1 Custom logo preparation

In order to be able to configure and activate the custom logo in OMNIA, you should first of all
prepare the custom logo.
Different logos for different customers will of course have different aspect ratio and they
should be adjusted to proper fit in OMNIA login and welcome page.
To ease the configuration, a SWARCO logo with the aspect ratio of 150x44 pixels is
available in the “[TARGET DIR]\Omnia\Web\WebData\UI” directory of the installation folder.
OM0807E18SG

6.4.5.3.2 Custom logo configuration.

To configure and activate the custom logo in OMNIA:

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 48/78
 SWARCO MIZAR S.R.L.

1. add a new key “CustomLogo” to the section <appSettings> of the WebDesktop

Web.config file

<add key=“CustomLogo”
value="..\WebData\UI\customlogo.png|||136|||40|||205|||60"/>

2. configure the “CustomLogo” key, setting the value as follows:

custom logo file relative path
aspect ratio login page
aspect ratio desktop
all values separated by triple pipe |||

6.4.5.3.3 Custom logo test

1. Start the browser and connect to OMNIA

If everything is correct the custom logo is displayed in the Login page.

2. Login using any active user credentials

If everything is correct the custom logo is displayed in the welcome page.

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 49/78
 SWARCO MIZAR S.R.L.

6.4.6 STEP 4.4 – Installing OMNIA Web Connection Manager (WCM)

Use Case: Stand Alone installation

Omnia WCM Service will be installed onto the single system machine.

Use Case: Distributed Installation

Omnia WCM Service will be installed on the Web Server machine.

Using the OmniaInstaller.exe application, select the option “Omnia WCM Service” first and
click the install button.

The corresponding installation program will be launched.

This is the Welcome screen of the installation package for the Omnia WCM Service:
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 50/78
 SWARCO MIZAR S.R.L.

When the installation directory is prompted click “Next”.

Continue until the end of the installation wizard.

Restart the server after the installation.

6.4.6.1 WCM configuration

OMNIA Web Connection Manager (WCM) is the server of the communications with all the
web clients and dispatches messages between OMNIA functions and web clients.
Omnia Web Connection Manager (WCM) can be configured directly from the Omnia WCM
console web interface.

1. Start Omnia Management Console opening the browser at http://localhost:8083

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 51/78
 SWARCO MIZAR S.R.L.

2. Click “Enter” to access Omnia WCM Console.

3. Click on “Settings” in the System panel to open the Settings tab.

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 52/78
 SWARCO MIZAR S.R.L.

4. Fill the database settings according to the following table.

Java TCP Port: IP port used for communications with Java applet
WS TCP Port IP port used for communications with Web Socket

5. Click “Submit” to complete the configuration.

6. In the confirmation message, click “Ok” to complete the operation.

SPXTCP.DAT
IPC connections are used to interface only ‘INTERNAL APPLICATIONS’ (OMNIA managers).
Detailed settings about the IPC connections with ‘INTERNAL APPLICATIONS’ are available in the
‘sysconf.ini’.

Example: TCP SGM

SPXTCP.DAT file is stored in the Web Communication Manager (WCM) folder (default:
C:\Program Files (x86)\Swarco Mizar\Omnia WCM Service).
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 53/78
 SWARCO MIZAR S.R.L.

6.4.7 STEP 4.5 – Installing the kernel applications

Please remember that, if necessary, the Applications components can be installed on the
machine through the UTOPIA installation packages (Please do reference to UTOPIA-
Installation Guide).

Use Case: Stand Alone installation

The applications will be installed onto the single system machine.

Use Case: Distributed Installation

The kernel applications will be installed on the Application Server machine.

Using the OmniaInstaller.exe application, select the option “Apps Components” and click the
install button.

The corresponding installation program will be launched.

This is the Welcome screen of the installation package for the web components (web
Commons and Web components) and then click on “Next” button:
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 54/78
 SWARCO MIZAR S.R.L.

Next, three input forms will be displayed to enter the connection to the installation machines.

Database Server (Name, IP address, SQL Server instance name)

Application Server (Name, IP address)
Web Server (Name, IP address)

If this is an installation on a single server machine, it is required to enter the same references
for the entries:

Database Server Name = Application Server Name = Web Server Name

Database Server IP = Application Server IP = Web Server IP

In case of distributed installation insert the different values and continue until the end of the
installation wizard.

Restart the server after the installation.

OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 55/78
 SWARCO MIZAR S.R.L.

6.4.8 STEP 4.6 – Installing OMNIA Server

Use Case: Stand Alone installation

Omnia Server will be installed onto the single system machine.

Use Case: Distributed Installation

Omnia Server will be installed on the Application Server machine.

Using the OmniaInstaller.exe application, select the option “Omnia Server” first and click the
install button.

The corresponding installation program will be launched.

This is the Welcome screen of the installation package for the Omnia Server components:
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 56/78
 SWARCO MIZAR S.R.L.

When the installation directory is prompted click “Next”.

Continue until the end of the installation wizard.

Restart the server after the installation.

6.4.8.1 Omnia Server 1001 Error

In case of the first installation of the Omnia Server application could happen an error “Error
1001: Unable to get installer types…”.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 57/78
 SWARCO MIZAR S.R.L.

To solve this you have to launch the appropriate file batch, install32.bat or install64.bat
according to the SO used and then proceed with the installation of Omnia Server.

These files are available on the page of the SWARCO Download Center
http://products.miz.it/DownloadCenter/OmniaPackages/lastrev.html in the “Setup Tools” item
as “ExtensionsErrorOmniaServer.zip”.

6.4.8.2 Omnia Server test

1. Start Omnia Management Console opening the browser at http://localhost:8084
2. Click on “Services\Database” in the System panel to open the Database tab.
OM0807E18SG

3. If the configuration is correct, Connection state field under Connection info section
reports the state “Active”.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 58/78
 SWARCO MIZAR S.R.L.

7 Updating Omnia previously installed through the

installation packages
The following procedure is for updating Omnia when the platform was previously installed
using the installation package (automatic procedure) is very similar to an installation from
scratch.

7.1 Verifying the Omnia Installer version

Before beginning any upgrade of the Omnia components, make sure you have the latest
version of the Omnia Installer application. The latest version of the Installer can be found on
the SWARCO Mizar Download Center page:
http://products.miz.it/DownloadCenter/OmniaPackages/lastrev.html

To verify the current version of the Omnia Installer from the folder “C: \ InstallOmnia”; open
up the Omnia Installer and click on the computer icon on the upper corner of the window:

In case the version in use were older than the one available at the Download Center, then
firstly download the latest version and replace (overwrite) the old “OmniaInstaller.exe” (in C: \
InstallOmnia \ OmniaInstaller.exe) with the new one.

7.2 Verifying the installed components

Before you begin any upgrade, make sure that all components to be upgraded are already
installed. Use the Windows tool to check the installed programs ("Program and Features").
OM0807E18SG

In a single server installation, the next items should be listed:

Omnia Platform Database Server Components

Omnia Platform Web Commons Components

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 59/78
 SWARCO MIZAR S.R.L.

Omnia Platform Web Components

The column “Version” displays the individual version number of every installed component.

7.3 Upgrading the available Omnia packages

Use Case: Stand Alone installation

Updates must be done on the server where Omnia has been installed.

Use Case: Distributed installation on multiple servers

Updates must be done on each server that is part of the distributed installation.

SPECIAL Use Case: Updating an Isolated Server not connected to Internet

Please download the packages as suggested below on a computer connected to the

Internet. Then copy (onto the server machine isolated from the internet) all the contents in C:
\ InstallOmnia from the machine connected to the Internet (used exclusively to obtain the
installation packages).
Make sure all contents in C: \ InstallOmnia of the download machine are the same as in
C:\InstallOmnia of the destination server.

Actions

Before doing any action to install / update Omnia, make sure that the version of
OmniaInstaller.exe is lined up with the one available from the download page of the Omnia
Download Center.

Open the Web Browser of your choice and go to the SWARCO Mizar Download Center
(Mizar release server) at:
http://products.miz.it/DownloadCenter/OmniaPackages/lastrev.html
Then, check the latest distributed version:

Check the version of OmniaInstaller.exe in C: \InstallOmnia\ by doing one of the two possible
ways:
Launch the application and double click on the image located at the top of the screen
on the right hand side (the “About” window will be displayed with information about
OM0807E18SG

the version)
Right click on the executable file in order to see its properties. Look into the “Details”
section.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 60/78
 SWARCO MIZAR S.R.L.

In case the version in use were older than the one available at the Download Center, then
download first the latest version and replace the old one (in C:\ InstallOmnia \
OmniaInstaller.exe).

Next, run the OmniaInstaller.exe located into C: \ InstallOmnia and open the tab “Packages
Downloader” in order to download the latest releases from the SWARCO Mizar Download
Center.

Click the "Load" button to populate the list of updated files.

After a few seconds of downloading, depending on your internet connection speed, the
program will display a list of files and updated installation packages available for download.

Select all files from the list by ticking the checkbox available on top of the list at the left hand
side, as it is shown below:
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 61/78
 SWARCO MIZAR S.R.L.

Then click on the “Download” button.

Wait until the process of downloading files has finished.

Note:
OM0807E18SG

The application OmniaInstaller.exe displays the list of all files available on the SWARCO
Mizar Download Center; however, only the obsolete files (on the local machine) will be
downloaded.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 62/78
 SWARCO MIZAR S.R.L.

This means that all items in the list can be selected without having to worry about including
or excluding particular items from the list.

At the end of the download process, the application will display the following:
Tab “Packages Downloader” will show the status of “Completed” for all files
Tab “Packages Launcher” will display the list of packages to be installed.

At this point it is possible to proceed with the installation as if you were installing the platform
from the beginning, following its own use case.

Install only the components shown by the Omnia Download Center with a higher version to
the one currently installed (check the programs installed in Windows).

Before proceeding with the installation, write down which of the following steps must be
carried out by checking the current version and the new version available from the Download
Center:

Update the components to build up the database

Update the databases on SQL Server
Update the web commons components
Update the web components
Update Omnia Web Connection Manager (WCM)
Update the applications
Update Omnia Server components

Note:
Any update errors are protected by the verification procedures inherent in the update
packages. This means that the installation of previous versions, obsolete versions or the
installation of a version that already exists is not allowed.

7.4 System Update

Please continue with the installation packages as if it was a setup from scratch in order to
update the following components:

Omnia Database Server Components

Updating the storage databases to the latest version (through the OmniaDBBuilder
application)
Omnia Web Commons Components
Omnia Web Components
Omnia WCM Service (uninstalling before)
Omnia Platform Applications
Omnia Server (uninstalling before)

Follow the instructions described in the chapters according to the components to update and
its corresponding use case.
OM0807E18SG

Since it is a package “update” instead of a “new installation” the wizard will not ask for the
server names again for the packets that require them.

Restart the server after the installation/upgrade of one or more components.

SWARCO MIZAR S.R.L. a socio unico
Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 63/78
 SWARCO MIZAR S.R.L.

Note:
When the databases are updated through the OmniaDbBuilder.exe application, the data is
preserved by the update operations. The operations performed by the application concern
only to update the database structure and do not modify the data contained in it. However, it
is highly advisable to backup all databases prior to any updates.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 64/78
 SWARCO MIZAR S.R.L.

8 Updating Omnia previously installed without the

installation packages
The Omnia upgrading operations need more attention, when the platform was previously
installed manually. It is warmly suggested to prepare a safe backup copy of the Omnia
folders:
• save old data
• refer to the installation from scratch described in the chapter "6 New Installation" of
this document and continue installing the needed components
• retrieve system configurations from the specific files.

8.1 OMNIA WEB Components

This step involves the files in the Web destination folder (e.g. C:\Omnia\Web).

Before starting any upgrade action, please carefully check the details reported in the
following sections.
In every section are listed special actions and configurations eventually required to perform
the update in the proper way from that specific software release to any newer release.

8.1.1 Before Starting

Before starting the installation of the web components, and in particular the Web Services
and the Graphical User Interface update procedure, it is necessary to stop Internet
Information Service (IIS).
In order to restart IIS, run the command “iisreset -stop”.

Then open Windows Explorer and identify the destination folder (local or network) containing
the Web components (e.g. C:\Omnia\Web) and rename it to “__Web”.
Continue installing the OMNIA WEB Components (refer to the installation from scratch
described in the chapter "6.4.5 STEP 4.3 – Installing the web components" of this document)
and finally proceed with the manual operations described in the following chapters.

8.1.2 WEB Services

OM0807E18SG

1. Open Windows Explorer and identify the destination folder (local or network) containing
the Web Services (e.g. C:\Omnia\Web\WebServicesApp).

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 65/78
 SWARCO MIZAR S.R.L.

2. The automated installation provide to assign the correct database server name and
instance name in the Omnia connection string in the config file, but doesn’t change the
name of database if it is different from the default “Omnia”.
Therefore, you have to copy the “Web.Config” file from the old Web Services folder
(“__Web\WebServicesApp”) to the updated folder
3. Restart the Internet Information Service (IIS).
4. Remove the old WebServicesApp folder (“__Web\WebServicesApp”).

8.1.3 Graphical User Interface

1. Open Windows Explorer and identify the destination folder (local or network) containing
the Graphical User Interface (default C:\Omnia\Web\WebDesktopApp)
2. Open the “Web.Config” file from the old Graphical User Interface folder
(“__Web\WebDesktopApp”) and compare it to the one in the updated folder. You have to
change all keys present in the old file but beware of preserve the structure of the file (do
not remove the new added keys or do not add the deleted keys).
3. Copy the “license.xml” file from the old Graphical User Interface folder
(“__WebDesktopApp”) to the updated folder.
4. Copy the content of the Junction View backgrounds folder (“SVGbackgrounds”) from the
old Graphical User Interface folder (“__Web\WebDesktopApp”) to the updated folder.
5. Copy the log and temp folder from the old Graphical User Interface folder
(“__WebDesktop”) to the updated folder.
6. Restart the Internet Information Service (IIS)
7. Remove the old WebDesktopApp folder (“__Web\WebDesktopApp”).

8.2 OMNIA Apps Components

1. Before starting any upgrade action, please save the files in the dbase destination folder
(e.g. C:\Omnia\Data\dbase) renaming the folder to “__dbase”.
2. Continue installing the OMNIA Apps Components (refer to the installation from scratch
described in the chapter "6.4.7 STEP 4.5 – Installing the kernel applications" of this
document)
3. Finally replace the old files from the “__dbase”.folder to the new dbase destination folder.

8.3 OMNIA Server

In order to update OMNIA Server to current release:
1. Uninstall OMNIA Server old version
2. Install new OMNIA Server release following the instructions available in section 6.4.8
STEP 4.6 – Installing OMNIA Server” of this document.

8.4 OMNIA Web Connection Manager (WCM)

In order to update OMNIA Web Connection Manager to current release:
1. Uninstall OMNIA Web Connection Manager old version
OM0807E18SG

2. Install new OMNIA Web Connection Manager release following the instructions available
in section 6.4.7 STEP 4.4 – Installing OMNIA Web Connection Manager (WCM) of this
document.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 66/78
 SWARCO MIZAR S.R.L.

8.5 Omnia Web Commons Components directories

The performed manual installations shall present a different configuration from the one
obtained with an automatic installation. Below are reported the most common actions
performed installing the web commons packets.

Actions

1. The folders and the files are moved

FROM:
<drive>:\Omnia\Web\WebData\Commons
TO:
<drive>:\Omnia\WebCommons

2. The folders and the files are moved

FROM:
<drive>:\Omnia\Web\WebUtility
TO:
<drive>:\Omnia\WebUtility

Note:
The notation <drive> must always be replaced with the actual installation drive.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 67/78
 SWARCO MIZAR S.R.L.

9 Troubleshooting
9.1 Internet Information Service (IIS)

9.1.1 Installation of one or more roles, role services, or features failed

Seen on a Windows® 2012 Server running .Net Framework 4.5.2

In the “Select features“ view of the “Add Roles and Features Wizard”, disable .NET
Framework 3.5 features and repeat the setup
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 68/78
 SWARCO MIZAR S.R.L.

In the “Select role services“ view of the “Add Roles and Features Wizard”, locate Application
Development and disable .NET Extensibility 3.5 and ASP .NET 3.5

Repeat the setup.

9.2 WEB Services

9.2.1 Test procedure does not work with Firefox

From the Internet Information Service Window, using Firefox to browse the file
“WS_Access2.asmx” from the list of files in the “WebService” directory, the error in the
following figure is displayed.

1. Open the “Internet Information Services” Manager.

2. In the “Internet Information Services” view locate the Omnia Virtual Directory and right
click on the “WebServices” sub-directory to open the drop down menu, then select
OM0807E18SG

“Properties” to start the “Properties” view.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 69/78
 SWARCO MIZAR S.R.L.

3. In the “WebServices Properties” view, select the “Directory” tab and enable the “Directory
browsing”. Click on “OK” button to confirm the modification.
OM0807E18SG

4. Repeat the WEB Services test.

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 70/78
 SWARCO MIZAR S.R.L.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 71/78
 SWARCO MIZAR S.R.L.

9.2.2 Test procedure does not return any data

From the Internet Information Service Window, using Internet Explorer to browse the file
“WS_Access2.asmx” from the list of files in the “WebService” directory, the view that
appears invoking the WEB service for the ‘admin’ user does not return any data (see figure
below).

The malfunctioning is related to a configuration mismatch in the section <connectionStrings>

of the Web.Config file.
1. Open the “Web.config” file in the WebServicesApp directory using any textual editor
2. In the section <connectionStrings> verify the parameters of the key “connectionString”

DATABASE SERVER DBMS Network ID (Network ID of the computer running

SQL Server)1
DATABASE NAME Name of the Omnia Database installed on the DBMS
(default = Omnia)
User ID Omnia Database Administrator Username
Password Omnia Database Administrator Password
OM0807E18SG

1
NB: For DATABASE SERVER key, enter ‘Server Name’ (e.g. localhost) for SQL Server®
Standard Edition, ‘Server Name’\MSSMLBIZ for Small Business Edition or ‘Server
Name’\SQLEXPRESS for SQL EXPRESS Edition
SWARCO MIZAR S.R.L. a socio unico
Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 72/78
 SWARCO MIZAR S.R.L.

9.3 Graphical User Interface

9.3.1 Server Error in ‘/Omnia/WebDesktop’ Application – The request failed

with HTTP status 404: Not Found

Using Internet Explorer to log into Omnia, the system reports the following Server Error in
‘/Omnia/WebDesktop’ Application:
1. The request failed with HTTP status 404: Not Found

The malfunctioning is related to a configuration mismatch in the section <appSettings> of the

Web.Config file.
1. Open the “Web.config” file in the WebDesktop directory using any textual editor
2. In the section <appSettings> verify the path of all the WebServices

Key Value (default)

WS_Access.WS_Access2 http://localhost/omnia/webservices/WS_Access2.asmx
WS_Status.ws_status2 http://localhost/omnia/webservices/ws_status2.asmx
WS_TrafficData.WS_TrafficData2 http://localhost/omnia/webservices/WS_TrafficData2.asmx
WS_Diagnostic.WS_Diagnostic2 http://localhost/omnia/webservices/WS_Diagnostic2.asmx
WS_Topology.WS_Topology2 http://localhost/omnia/webservices/WS_Topology2.asmx

3. Stop and Restart the “Internet Information Services” Manager.

4. Repeat the Login procedure
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 73/78
 SWARCO MIZAR S.R.L.

9.3.2 Server Error in ‘/Omnia/WebDesktop’ Application

The error occurs after an update or an installation and is determined by Permissions Error

1. Locate the WebDesktop directory

2. Right click the mouse on the folder an open the properties window.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 74/78
 SWARCO MIZAR S.R.L.

3. Click on “Add” button to add a new user.

4. In the “Select Users or Groups” window,
add the user “Everyone” and click “OK” to
confirm.

5. In the “WebDesktop Properties” window,

select the user “Everyone” and give it the
permissions for “Full Control”

6. Click on “Advanced” button to access special permissions and advanced settings

7. Apply the WebDesktop properties just configured to all the child folders.
8. Restart the browser to complete the configuration.

9.3.3 Failed to load data xml from ../GroupStatusPageHandler.ashx?from...

When opening signal group diagram recording, to select the date and time 4 error messages
popup every time selection is changed.

Malfunctioning is determined by .NET Framework in use.

It can been fixed installing the SP2 for .NET 2.0.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 75/78
 SWARCO MIZAR S.R.L.

9.3.4 Server Error in ‘/Omnia/WebDesktop’ Application –

System.Web.Services.SoapException

When this error occurs, check that the OMNIA folder and all its subfolders have the user
“Everyone” defined with full control rights

9.3.5 Server Error in ‘/Omnia/WebDesktop’ Application –

Response filter is not valid

The error occurs clicking on the “Export data to excel” button in the Traffic data form, with
traffic data correctly loaded.

Error is determined by a bug in .NET framework release 3.5 and is fixed in the release 1.2.0
of OMNIA.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 76/78
 SWARCO MIZAR S.R.L.

9.3.6 Signal Group Diagram export to PNG or PDF crashes

Signal Group Diagram export to PNG or PDF could crash in case the “InkScapeExecutable”
key in the webdesktop\web.config file is not set properly.

<add key="InkScapeExecutable" value="C:\Program Files\Inkscape\inkscape.exe" />

9.3.7 Fault management not able to load data

The Fault management functionality is not able to retrieve data from the database, and a
error box appears (see next image).

1. Open the WebDesktop/web.config configuration file.

2. Add the line
<add key="WS_Configuration.WS_Configuration"
value="http://SERVERADDR/Omnia//WebServices/WS_Configuration.asmx"/>,

where SERVERADDR is the IP address of your web server.

3. Restart IIS
4. Try again
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 77/78
 SWARCO MIZAR S.R.L.

9.3.8 Error loading OMNIA Calendar Editor

The error has been documented on a Windows 2008 server 64 edition running IIS 7.

When OMNIA is started on Firefox or Internet Explorer, launching the Calendar Editor from
the shortcut provided in the Map View selection tree, the following error is displayed.

Malfunctioning is determined by a configuration mismatch in plan library actions table.

Update plan scenario editor module to the latest release and check the configuration of traffic
scenarios.
OM0807E18SG

SWARCO MIZAR S.R.L. a socio unico

Via Nizza, 262/57, I-10126 Torino, T. +39-011-6500411, F. +39-011-6500444, E. [email protected]
Tribunale di TORINO 189/82 - Capitale Sociale Euro 200.000 i. v. - C.C.I.A.A. Torino 606099 – C.F. e P.I. IT03972050011
Direzione e coordinamento: SWARCO AG 78/78