81058027EN Installation Guide - Vision Air Server

Vision Air Server
Installation Guide
81058027EN / 2016-04-08
Metrohm AG
CH-9100 Herisau
Switzerland
Phone +41 71 353 85 85
Fax +41 71 353 89 01
info@metrohm.com
www.metrohm.com
Vision Air Server
Installation Guide
81058027EN / 2016-04-08
ahag
Technische Dokumentation
Metrohm AG
CH-9100 Herisau
techdoc@metrohm.com
This documentation is protected by copyright. All rights reserved.

Although all the information given in this documentation has been
checked with great care, errors cannot be entirely excluded. Should you
notice any mistakes please send us your comments using the address
given above.
Table of Contents
Table of Contents
Table of Contents
III
1.1
1.1.1
1.1.2
Introduction
Vision Air Software.......................................................................... 1

Vision Air Networking Overview Diagram ...................................................... 1
Data/server security and confidentiality.......................................................... 2
Overview
2.1
2.1.1
Minimum Vision Air Server System Requirements ........................... 3

Additional Software & Requirements ............................................................. 4
2.2
2.2.1
2.2.2
Administrator privileges .................................................................. 5

For the Vision Air Server ................................................................................ 5
For the SQL Server ......................................................................................... 5
2.3
Communication Protocols ................................................................ 5
2.4
SQL database Backups & Maintenance ............................................ 5
2.5
DNS URL Address ............................................................................ 6
2.6
SSL Certificate ................................................................................. 6
2.7
SMTP ............................................................................................... 6
2.8
Vision Air Password Policy............................................................... 7
2.9
Computer Virus Prevention .............................................................. 7
2.10
Server Ports ..................................................................................... 8
Pre-installation
10
3.1
Site Preparation ............................................................................. 10
3.2
System & Database Backup ........................................................... 10
3.3
3.3.1
3.3.2
3.3.3
Installation Requirements .............................................................. 11

SQL Server Configuration............................................................................. 11
SQL Server 2012 Login Permissions ............................................................. 13
SQL Server Maintenance Plans ..................................................................... 15
III
Installation Guide - Vision Air Server
3.4
4
4.1
Table of Contents
Matlab Installation......................................................................... 16
Server Installation & Upgrade
18
The Host Tray Tool ........................................................................ 28
IIS Configuration
29
5.1
Vision Air Site Setup ...................................................................... 30
5.2
Website Handler Mappings ............................................................ 33
5.3
MIME Types ................................................................................... 34
5.4
HTTP Response Headers ................................................................ 35
5.5
Request Filtering ............................................................................ 36
5.6
Default HTTP Bindings ................................................................... 37
Troubleshooting
39
Installing SQL Client Connectivity
40
7.1
7.1.1
7.1.2
7.1.3
Configure SQL Server ..................................................................... 40

Allow remote connection to the SQL Server ................................................. 40
Enable TCP/IP protocol in SQL Server Configuration Manager ...................... 43
Grant access to the Vision Air Server Account .............................................. 44
7.2
7.2.1
7.2.2
7.2.3
7.2.4
Configuring the Vision Air Server ................................................... 51

Allow Outgoing Communication.................................................................. 51
Fix dependency to SQL service ..................................................................... 52
Configure access to SQL Server .................................................................... 53
Configure Vision air to work with SQL Server 2012 ...................................... 54
7.3
7.3.1
7.3.2
7.3.3
7.3.4
7.3.5
Tips & Troubleshooting.................................................................. 56

Move database and security......................................................................... 56
Redirect Vision Air to use another SQL Server (on already installed system) .. 56
Troubleshooting...........................................................................................56
CLR Stored procedures (obsolete from 6.2) .................................................. 56
SQL Tools for Vision Air Server (obsolete in 6.6) ........................................... 58
IV
1 Introduction
1 Introduction
1.1 Vision Air Software
Vision Air supports a range of Metrohm NIRSystems instruments. Products
currently supported include:
Metrohm NIRS DS2500
Metrohm NIRS XDS-Rapid Liquid Analyzer
1.1.1 Vision Air Networking Overview Diagram
1 Introduction
1.1.2 Data/server security and confidentiality

All data is solely owned by the individual or customer and is not used or
accessed by Metrohm NIRSystems except when instructed by the
customer or during the provision of technical support requested by the
customer.
All client data is synchronized & stored on a secure Vision Air servers &
databases. All communication is initiated by the customers computer and
not by the Vision Air Server. Metrohm NIRSystems cannot access to any
data stored on the client machines.
2 Overview
2 Overview
2.1 Minimum Vision Air Server System Requirements
Operating Systems
Windows Server 2008 R2 Full Edition (32&64 bit) with Service Packs Operating System Language must be English
CPU
2 x 2 GHz Processors
Memory (RAM)
8 GB
HDD
80 GB free space (dependant on data storage needs)

NTFS File System
Video
SVGA at 1024x768, 16-bit color
NIC
1 Gbit Ethernet
Database Server
Microsoft SQL Server 2008 R2

Microsoft SQL Server 2012 1)
Connectivity
2-5 open ports on firewall (Incoming) (The number of ports is

dependent on instrument type & proxy server configuration)
External IP address or DNS address (recommended) for external clients
to be able to communicate with the Vision Air Server
SMTP account for emailing Reports & Vision Air Manager download
links (Optional)
2 Overview
2.1.1 Additional Software & Requirements

NOTE
All needed software can be found on the provided DVD
in the folder Additional Software
Internet Information Services (IIS) Server role
.NET 4 Framework Extended
Crystal Reports Runtime Crystal Reports Runtime 13.0.9.1312 (x86 and
x64 2)
MATLAB Compiler Runtime 8.0 (x86 and x64 2)
Microsoft SQL Server 2012 Management Objects 11.1.3000.0 (x86 and
x64 2)
Microsoft SQL Server 2012 System CLR Types 11.1.3000.0 (x86 and x64
2)
Microsoft Visual C++ 2005 Redistributable

Microsoft Visual C++ 2008 Redistributable
SQL Server 2012 is required for SQL Reporting Services for Vision Air and
can be installed side-by-side with SQL Server 2008.
The x64 versions are only required for the Windows Server 64-bit
operating system.
2)
NOTE
If installing a clean version of Microsoft SQL Server 2012
(i.e. SQL Server 2008 was not previously installed) the
following will also need to be installed:
1. Microsoft SQL Server 2008 R2 Native Client
2. Microsoft SQL Server System CLR Types
3. Microsoft SQL Server 2008 R2 Management Objects
2 Overview
2.2 Administrator privileges

2.2.1 For the Vision Air Server
Installation of any Metrohm NIRSystems software requires domain level
administrator privileges. Please ensure a computer user with full domain
administrator rights is available prior to installation.
2.2.2 For the SQL Server

Installation of the Vision Air Server database requires administrator
privileges. Please ensure a computer user with full SQL administrator rights
(sysadmin role) is available prior to installation. The Vision Air database can
not be created without a User with sysadmin level privileges on the SQL
Server.
2.3 Communication Protocols

Communication between the Vision Air Server and Vision Air clients is
based on WCF & TCP or HTTP and is encrypted with a SSL certificate. The
HTTP version is intended for use only by customers with Proxy servers
which limit TCP communications.
2.4 SQL database Backups & Maintenance

It is the customer's responsibility to backup & safeguard the Vision Air
data from loss. Metrohm NIRSystems cannot be held liable for data due to
inadequate data backups.
Metrohm NIRSystems strongly recommends that the Vision Air Server SQL
database is backed up on a reoccurring and timely schedule, at a
minimum daily, in order to safeguard the data from loss. This can be done
by using any software capable of performing full system backups, full
system snapshots or SQL Server backups. The Vision Air Server software
does not contain any backup functionality.
Additionally, it is recommended that each SQL Server have an automated
SQL maintenance plan to help ensure the health and optimization of the
SQL Server. Please consult the local IT department for assistance in
creating SQL maintenance plans.
2 Overview
2.5 DNS URL Address

A DNS address is recommended in order for Vision Air clients to locate
and communicate with the Vision Air Server. Please contact your IT
department for the DNS URL prior to beginning the installation process
(e.g. VisionAir.yourcompany.com).
NOTE
The Vision Air clients can also connect using an IP
address but each instrument will need to be
reconfigured if the IP address ever changes. Use of a
DNS URL Address will allow for changing the Vision Air
Server IP address without reconfiguring each instrument.
2.6 SSL Certificate

Communication between the Vision Air Server and clients is secured using
a SSL certificate installed on both the Vision Air Server and the client PC.
Metrohm NIRSystems provides a SSL certificate during the Vision Air
Server installation.
A custom SSL certificate (e.g. VisionAir.yourcompany.com) may be used
instead of the one provided by Metrohm NIRSystems. There are no
requirements for custom certificates other then it must not be expired.
Communication between the Vision Air Server and clients cannot occur if
the SSL certificate is missing or expired.
2.7 SMTP
The Vision Air Server uses SMTP for emailing installation links to users to
assist in the installation of Vision Air Manager. Vision Air Server can also
be configured to email scheduled surveillance reports to instrument
managers.
Both features are option and will require an SMTP Server, a SMTP port and
a User Name & Password (when anonymous relaying is prohibited).
2 Overview
2.8 Vision Air Password Policy

The default Vision Air password policy is:
Passwords must be at least 5 characters long (alpha or numeric)
Must be different then the last 5 passwords
Must be changed every 90 days
The password policy may be changed on an individual user basis on Users
Summary tab.
2.9 Computer Virus Prevention

Metrohm NIRSystems recommends that our customers maintain
continuous protection of their computers and network infrastructure from
threats posed by computer viruses, worms, and other types of hostile
computer programs.
This can be implemented by installing and frequently updating an
appropriate anti-virus program on the PCs and connecting the PCs in a
minor closed network.
Protection against computer viruses is solely the responsibility of the
customer and Metrohm NIRSystems can not be held responsible for any
damage these types of programs may cause including lost & corrupted
data or data theft.
2.10
2 Overview
Server Ports
Port A: Required standard port for TCP communication with Vision Air
Server (Vision Air clients).
Port B: Alternative port for HTIP communication with Vision Air Server
(Vision Air clients).
Port C: Required HTIP port for ClickOnce installation and update of Vision
Air Manager clients.
Client and instrument ports: Communication is always initiated from the
Vision Air client and the instruments. The same ports opened on the
Vision Air Server/firewall must be open for outgoing traffic only on the
clients and instruments.
Mail account: Vision Air has features for

generating and sending emails to users.
Such mails are sent from the Vision Air
Server which in that case needs to be
configured with a SMTP Relay agent (not
mandatory).
Port numbers: Metrohm reccomends
using ports in the 8000 range to reduce
potential interference by other
applications. The port range can be
changed to meet the customer's needs.
2 Overview
CAUTION
CLIENT-SIDE PORTS: Communication is always initiated
from the client/instrument. The same ports opened on
the Vision Air Server must be open for outgoing traffic
on the client. The ports do need to be opened on the
client (or external client site) for incoming
communication.
CAUTION
Please contact your IT Department for any firewall port
issues. Metrohm NIRSystems cannot make any changes
to your firewalls.
3 Pre-installation
3 Pre-installation
3.1 Site Preparation
The Site Preparation Check List must be completed before installation
of any Vision Air component or interfacing software program.
Verify that the firewall have been updated to allow incoming and
outgoing traffic on new ports.
If using a Vision Air Server, verify DNS has been configured for Vision
Air Server URL.
If using a Vision Air Server, verify the SSL certificate has been acquired
and installed.
Verify the account used for installation is a full Administrator account
3.2 System & Database Backup

Metrohm NIRSystems strongly recommends that a full system backup or
server snapshot is performed prior to running the Vision Air Server
installation whenever upgrading the Vision Air software. In addition, it is
strongly recommended to create a full SQL database backup of the Vision
Air database before beginning the installation.
10
3 Pre-installation
3.3 Installation Requirements

See chapter 2.
3.3.1 SQL Server Configuration

NOTE
Microsoft SQL Server and SQL Server Management
Studio must be purchased and installed separately prior
to beginning the Vision Air Server installation. SQL
Server is not supplied or installed by Metrohm
NIRSystems.
1. Open SQL Server Management Studio,
2. Connect to SQL Server instance created during SQL Server Installation.
3. Right-click on the SQL Server instance and select New Query.
11
3 Pre-installation
4. Enter the query below and click Execute:
Sp_configure 'show advanced options', 1;

GO
RECONFIGURE;
GO
Sp_configure 'clr enabled', 1;
GO
RECONFIGURE;
GO
5. The results should display that the Query executed successfully with a
message similar to the one below.
12
3 Pre-installation
3.3.2 SQL Server 2012 Login Permissions

This section only applies if the SQL Server is installed on same physical
device as the Vision Air Server software. If SQL Server is installed on a
separate server, please see Section 7 Installing SQL Client Connectivity.
1. Open SQL Server Management Studio.
2. Connect to SQL Server instance created during SQL Server Installation.
3. Expand Security and Logins. Right-click on NT AUTHORITY\SYSTEM and
select Properties.
If this Login is not existing, create it:
a. Right Click on "Logins"
b. "New Login"
c. Create a new user
13
3 Pre-installation
4. Click on Server Roles and verify public & sysadmin are selected
(checked). If not select them.
5. Click on User Mappings and verify the master database is selected and
the roles are db_owner and public.
6. Click OK and exit
14
3 Pre-installation
3.3.3 SQL Server Maintenance Plans

Metrohm NIRSystems strongly recommends the use of SQL Server
maintenance plans in order to keep Vision Air performing at peak
performance and to prevent issues which normally occur through the
long-term usage of any database.
At a minimum the following maintenance plans should be created and
scheduled to run weekly:
Database Integrity
Rebuild Indexes
Update Statistics
Please consult the local IT Department for assistance in creating the SQL
Server maintenance plans.
15
3 Pre-installation
3.4 Matlab Installation

Vision Air requires Matlab Compiler Runtime 8.0 to be installed on the
same server as the Vision Air Server software. Matlab must be installed
separately prior to installing or upgrading the Vision Air Server software.
The Matlab software is included along with the Vision Air Server
installation software
NOTE
The Vision Air Server supports the 32-bit version of
MatLab only
1. Double-click on MCRInstaller 8.0 (32bit).exe
2. Click Next
3. Select 'Yes' to agree to the terms of the license agreement and click
Next
16
3 Pre-installation
4. Click Next
5. Click Install. Installation will take 5-10 minutes.
6. Click Finish
17
4 Server Installation & Upgrade

1. Double-click on SetupVisionAirServer.exe to start installation of Vision
Air Server. The installation will verify if all the prerequisites (e.g.
Microsoft Visual C++, .NET 4, Crystal Reports Runtime or anyothers) are
installed. If any are missing click Install when prompted and follow the
component installation prompts.
2. Once the installation of the prerequisites is complete click Next.
18
3. In order to proceed browse to the location of the license file received

from Metrohm upon order and payment of the Vision Air Server
license.
4. If Vision Air Server is already installed the following prompt will be

displayed. To upgrade an existing Vision Air Server on this computer
click No and continue with Step 4. To install a new/additional Vision
Air Server click Yes and skip to Step 6.
19
5. (For Upgrade Only) Select the name of Vision Air Server to be

upgraded and click Next.
6. (For Upgrade Only) Click Yes that you would like to upgrade this
application and skip to Step 8.
20
7. (For New Install Only) Click I accept the terms of the license
agreement and click Next.
8. (For New Install Only) Select the path where to install Vision Air
Server application and click Next.
21
9. Enter the Vision Air Server DNS or IP address, the Vision Air TCP port
and Automatic Update port for client communication and click Next. It
is recommended taking a screenshot of this screen for your installation
records.
NOTE
Do not use port number 8123. This leads to a conflict
when running the instrument simulator on the same
machine.
22
10. Click Next if using the default Metrohm NIRSystems SSL certificate. If
using a custom SSL certificate click Change to and follow the prompts
to select another SSL certificate.
11. Select the Database (SQL) server from the drop-down list (or type the
name of the server) which will host the Vision Air database.
12. Enter the name of the database catalog (typically either VisionAir, the
companys name or organizational unit e.g. EMEA, Americas or similar
depending on how the server is organized.). This will be the name of
the database created in SQL. Click Next. It is recommended to take a
screenshot of this screen for your installation records.
NOTE
Enter the SQL Server name. Do not use the name
localhost as it is known to cause error during
operation.
NOTE
If installing the database to a remote SQL Server see
chapter 7.
23
13. (For Upgrade Only) Click Browse next to name of database catalog
and select the name of the database to be updated and click OK.
24
14. (For Upgrade Only) Click Yes to confirm the database selection.
15. Type in <Service System Name(SSN)>. Use the same name as Name of
database catalog in the previous step. Make a note of the Service
System Name as it will be referred to during the IIS configuration.
Metrohm NIRSystems recommends taking a screen shot of this screen
for your installation records.
25
16. Enter the Mail server address, port, username (if any) and password (if
any) into the respective fields and click Next. Metrohm NIRSystems
recommends taking a screen shot of this screen for your installation
records.
17. Click Install and wait for the installation process to complete. This will
take several minutes to complete.
26
18. Click Finish.
After clicking Finish the Vision Air Server will build the SQL database in the
background. This process will take 5-10 minutes. There will be no
notifications on the screen.
27
4.1 The Host Tray Tool

The Host Tray Tool is a small application which displays information on the
current status of Vision Air Server connectivity and is located in the System
Tray.
After installing Vision Air the icon will be white or yellow denoting the
service is starting up.
After a couple of minutes it will turn yellow indicating the database is

being created/updated or IIS is not properly configured. Follow the steps
in the next section to configure IIS
Once the SQL database is fully built and IIS is properly configured the Host
Tray Tool will turn green.
Do not shut down or reboot the computer until the Host Tray Tool has
turned green. Doing so may corrupt the SQL database.
28
5 IIS Configuration
5 IIS Configuration
At a minimum, Internet Information Services (IIS) should be installed with
the following features:
29
5 IIS Configuration
5.1 Vision Air Site Setup

1. Open IIS Manager and right-click on Default Web Site and select Add
Application.
2. Enter the following Add Application info as shown below:

Enter the name "VisionAir" as the Alias.
Click the ellipse (...) and navigate to C:\Inetpub and click OK.
30
5 IIS Configuration
3. Right-click on the new Vision Air site under Default Web Site and
select Add Application.

Enter the pre-defined <Service System Name(SSN)> as alias.
(as pre-defined in section 4 Step 16)
Click the ellipse (...) and navigate to C:\Inetpub and click OK.
31
5 IIS Configuration
5. Right-click on the newly created < Service System Name(SSN)> and

select Add Application.
Enter the Manager as the Alias.
Click the ellipse (...) and navigate to & select C:\Program Files
(x86)\Metrohm\Vision Air\<SSN>\VisionAirManager and click OK.
(<SSN> is the System Service Name set in Section 4 Step 16).
7. The website tree should look similar to image below:
32
5 IIS Configuration
5.2 Website Handler Mappings

1. Click to highlight the Vision Air site under Default Web Site and
double-click on Handler Mappings in the /Vision Air Home pane.
2. Click Edit Feature Permissions from the Actions pane and verify there is
a check next to Read and Script. Add the checks if either are missing.
Click OK.
33
5 IIS Configuration
5.3 MIME Types

1. Click to highlight the Vision Air site again under Default Web Site
and double-click on MIME Types in the /Vision Air Home pane.
2. Locate the extension ".cer", click Remove on the Actions pane and
then Yes. If the extension is not listed continue to next step.
3. Locate the extension ".config" and click Remove on the Actions pane
and then Yes. If the extension is not listed continue to next step.
34
5 IIS Configuration
5.4 HTTP Response Headers

and double-click on HTTP Response Headers in the /Vision Air Home
pane.
2. On the right hand side click Set Common Headers and change the
default to Expire Web Content After 1 Minute(s).
35
5 IIS Configuration
5.5 Request Filtering

and double-click on Request Filtering in the /Vision Air Home pane.
2. In the list of File Name Extensions, locate and right-click on .config,

select Remove and then Yes to confirm the removal.
36
5 IIS Configuration
3. Click Allow File Name Extension on the Actions pane.

4. Enter .config and click OK.
5. The Request Filtering for .config should now be set to True
5.6 Default HTTP Bindings

If the Automatic Updates port has been set to any number other than the
default of blank (port 80) then the default HTTP Bindings must be set to
the new port number. (See Section 4 Step 9)
1. Highlight 'Default Web Site' and click on 'Bindings' on the Action Pane
37
5 IIS Configuration
2. Under Site Bindings type highlight 'http' and click Edit
3. Change the Port field to the Automatic Updates port number set in
Section 4 Step 9 and click OK
4. Click Close
38
6 Troubleshooting
6 Troubleshooting
IIS Request Filtering
If Request Filtering is not listed in IIS:
Option 1 (this option will affect all websites on this server):
Open the
C:\Windows\System32\inetsrv\config\ApplicationHost.config
with Notepad and delete the line:
<add fileExtension=".config" allowed="false" />
Save & Exit
Option 2:
Open the
C:\Windows\Microsoft.NET\Framework\v4.0.30319\web.config
with Notepad, locate the HandlerMappings section and add the
line:
<remove fileExtension=".config" allowed="false" />
to Default Web Site
Save & Exit
39
7 Installing SQL Client Connectivity

This section describes how to connect the Vision Air Sever with a remote
SQL Server (i.e. SQL Server is not installed on the same computer as the
Vision Air Server). You will need administrator level access on both the
Vision Air Server and the remote SQL Server in order to complete this
section.
7.1 Configure SQL Server

7.1.1 Allow remote connection to the SQL Server
1. Open SQL Management Studio and log in.
2. Right-click on the <server name> and select Properties.
40
3. Select the Connections page and place a check in "Allow remote

connections to this server" checkbox and click OK.
4. Close SQL Management Studio.

5. Click Start -> Administrative Services and then Services.
6. Verify the SQL Server Browser service Startup Type is Automatic and
Status is Started.
7. Verify the Distributed Transaction Coordinator service Startup Type is

Automatic and Status is Started.
8. Configure DTC on the SQL Server to allow inbound transactions:

Click Start -> Administrative Tools then Component Services.
Expand to locate Local DTC (see below). Right-click on Local DTC and
select Properties.
41
Click on the Security tab.

Place a check in Network DTC Access and Allow Inbound.
In case of cross-domain setup select No Authentication Required.
42
Click OK and close Component Services.

Restart all the SQL services
To check if DTC is working there are several options:
Use DTCTester (tool from Microsoft).
Use SQL Management Studio to try to create distributed transactions if
you have a local SQL Server.
7.1.2 Enable TCP/IP protocol in SQL Server Configuration Manager

1. Click Start -> All Programs -> Microsoft SQL Server 2008 ->
Configuration Tools and select SQL Server Configuration Manager.
2. Expand SQL Server Network Configuration.
3. Highlight Protocols for <SQL Server Name>.
4. Right-click on TCP/IP and select Enable.
5. Click OK, close the SQL Configuration Manager and restart the SQL
services.
43
7.1.3 Grant access to the Vision Air Server Account

To connect using a Windows account:
1. Select if a machine account or a user account will be used:
<domain>\<machine>$ (like DOMAIN\VISIONAIRPC$) or
<domain>\<accountname>
2. On the SQL Server open SQL Server Management Studio and login.
3. Expand Security and right-click on Logins and select New Login.
44
4. On the General page click Search to locate and add the Windows
account which will communicate with the SQL Server (machine or user
account).
5. Click on Server Roles page and place a check next to dbcreator and
public.
6. If the database already exists, click on User Mapping page and add a
check next to the database name and then db_owner and public
in the role membership pane.
45
7. Click OK and exit SQL Server Management Studio.
To connect using a SQL account:
46
1. Open SQL Server Management Studio and log in.

2. Right click on the server name and select Properties.
47
3. Click on the Security page and enable "SQL Server and Windows
Authentication mode" radio button and click OK.
4. Expand Security and right-click on Logins and select New Login.
5. On the General page

Enter Login name
Select SQL Server authentication
48
Enter and confirm the password

Deselect Enforce password expiration
6. Click on Server Roles page and place a check next to dbcreator and
public.
49
7. If the database already exists, click on User Mappings page and add a
check next to the database name and then db_owner and public
in the role membership pane.
8. Click OK and exit SQL Server Management Studio.
50
7.2 Configuring the Vision Air Server

7.2.1 Allow Outgoing Communication
1. Click Start, Administrative Services and then Services.
2. Verify the Distributed Transaction Coordinator service Startup Type is
Automatic and Status is Started.
3. Configure DTC on the SQL Server to allow inbound transactions:

Click Start -> Administrative Tools and then Component Services
Expand to locate Local DTC (see below). Right-click on Local DTC and
select Properties
Click on the Security tab
Place a check in Network DTC Access and Allow Outbound

In case of cross-domain setup select No Authentication Required
Click OK and close Component Services
51
Restart the Metrohm NIRSystems Vision Air (<Company Name>) service

To check if DTC is working there are several options:
Use DTCTester (tool from Microsoft)
Use SQL Management Studio to try to create distributed transactions if
you have a local SQL Server.
7.2.2 Fix dependency to SQL service

Configure a Vision Air Service named to not depend on SQL Server, but
only on Distributed Transaction Coordinator
1. Open a command prompt
2. Type SC QUERY and then press Enter.
3. Scroll through the list and make note of the Vision Air Service name.
The service name will be Vision Air Server (<SSN>) where <SSN> is the
Service System Name set during the Vision Air Server installation
(Section 4 Step 13) (e.g. VisionAir).
52
4. Get the configuration of Vision Air Service by typing SC QC Metrohm

NIRSystems Vision Air (<SSN>) and press Enter.
5. Remove the SQL Server dependency and leave the Distributed

Transaction Coordinator dependency type SC CONFIG Vision Air
Server (<SSN>) depend= MSDTC and press Enter.
6. To verify the SQL Server no longer appears under dependencies type

SC QC Vision Air Server (<SSN>) and press Enter.
NOTE
To configure the Vision Air service to depend on
SQLEXPRESS and Distributed Transaction Coordinator:
sc config Vision Air Server (<SSN>) depend=
MSDTC/MSSQL$SQLEXPRESS
7.2.3 Configure access to SQL Server

Depending on the account used for SQL Connection, you may need to
configure Vision Air service to run as a specific domain account (which
needs to be an administrator on the Vision Air Server) or to modify
hosting.exe.config for SQL Authentication.
If you are using SQL authentication then update Vision
AirConnectionString in hosting.exe.config: so it looks like:
Open C:\Program Files (x86)\Metrohm\Vision
Air\VISIONAIR\VISIONAIR\Hosting.exe.config using
Notepad
Search for MosaicConnectionString
Change the section after connectionString= to
"Server=SERVERNAME\sqlexpress;Database=Vision AirXXX;pooling =
false;User Id=USERNAME;Password=PASSWORD;Connection Timeout=30"
53
Vision AirXXX is the Service System Name of the Vision Air database
USERNAME is the SQL Login name set up in the previous section
PASSWORD is the password set for the SQL Login account
Verify the symbols are included and the line ends with />
7.2.4 Configure Vision air to work with SQL Server 2012

This section is only relevant when connecting to SQL Server 2012.
1. Install the following on the Vision Air Server:
Microsoft System CLR Types for SQL Server 2012
Microsoft SQL Server 2012 Share Management Objects
SQL Server 2008R2 Native Client
These SQL Server features are available from Microsoft and are contained
in the respective SQL Feature packs:
SQL 2012: http://www.microsoft.com/enus/download/details.aspx?id=29065
SQL 2008 R2: http://www.microsoft.com/enus/download/details.aspx?id=16978
2. Open C:\Program Files (x86)\Metrohm\Vision
Air\VISIONAIR\VISIONAIR\Hosting.exe.config using
Notepad
3. Add the following fragment after </connectionStrings> (character
spacing is not important)
54
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Microsoft.SqlServer.Smo"
publicKeyToken="89845dcd8080cc91"
culture="neutral" />
<bindingRedirect oldVersion="10.0.0.0" newVersion="11.0.0.0"
/>
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity
name="Microsoft.SqlServer.ConnectionInfo"
/>
<dependentAssembly>
<assemblyIdentity
name="Microsoft.SqlServer.SqlEnum"
/>
</assemblyBinding>
</runtime>
55
7.3 Tips & Troubleshooting

7.3.1 Move database and security
If you have an existing database, then first make a backup and restore
that backup on the target SQL Server instance
Grant SQL Server db_owner rights for the user representing machine
where Vision Air Service is running. Also set the Vision Air database as
default one for the mentioned user.
7.3.2 Redirect Vision Air to use another SQL Server (on already installed
system)
Stop Vision Air Service
Edit hosting.exe.config, set connectionString property to the correct
server.
Move the database (either backup & restore or detach & move &
attach)
Start Vision Air Service again
7.3.3 Troubleshooting
If Vision Air fails to start, then check the logfiles, located in Vision Air
installation folder, subfolder Logs (like "C:\Program Files
(x86)\Metrohm\Vision Air\VISIONAIR\VISIONAIR\Logs).
Start with the newest hosting.exe-??.e2e and possibly also
SchemaManagement-??.e2e
In the case you are trying to run an old (older than 1.0) Vision Air host
with a remote database you need to copy the CLR assembles to the PC
where SQL Server is installed (see the next paragraph).
In the case you have problems with MSDTC (it is mentioned in
exception text in server logs), try enabling Allow Inbound and Allow
Outbound on both SQL and application servers (see 7.1.1 and 7.2.1
for more details)
7.3.4 CLR Stored procedures (obsolete from 6.2)

Vision Air uses CLR Stored Procedures. If these are not located in the
correct directory Vision Air will fail with exceptions like:
SqlException: CREATE ASSEMBLY failed because it could not open the
physical file " C:\Program Files (x86)\Metrohm\Vision
Air\VISIONAIR\VISIONAIR\Foss.Vision
Air.Foundation.SystemConfiguration.DataStorage.dll
On the Vision Air Server use Windows Explore to navigate to
C:\Program Files\Metrohm\Vision Air\<SSN> (<SSN> is the System
Service Name set in Section 4 Step 11)
56
Copy the 6 .DLL files listed below to the exact same location on the
SQL Server.
NOTE
The directories may need to be manually created before
copying the files.
NOTE
The directory names and structure on the SQL Server
must exactly match the Vision Air Server. It is especially
important to be aware of the directory names when
mixing 32 & 64 bit OS environments.
Foss.Vision Air.Foundation.SystemConfiguration.DataStorage.dll
Foss.Vision Air.Foundation.DataManagement.DataLoader.dll
Foss.Vision Air.Foundation.DataManagement.StoredProcedures.dll
Foss.Vision Air.Foundation.DataManagement.Metamodel.dll
Foss.Vision Air.Foundation.DataManagement.CommonTypes.dll
Foss.Vision Air.Foundation.DataManagement.Vision AirMetadata.dll
Important:
If Vision Air started to create the database before this point you may have
to delete it and restart the service to create it again.
57
7.3.5 SQL Tools for Vision Air Server (obsolete in 6.6)

NOTE
You will need access to the SQL Server installation
software in order to setup Client Connectivity.
1. Follow the steps in Section 4 to install Vision Air Server. At Step 10
enter the name or IP address of the remote SQL server (e.g.
Server1\SQLServer1). Continue with the remaining steps in Section 4 &
5.
2. After the installation is complete the service Vision Air (Vision Air) will
not be able to start.
3. Run the SQL Server 2008 R2 installation and install the following two
features:
Client Tools Connectivity
Client Tools Backwards Compatibility
4. Follow the prompts and close the installation program when complete.
58

81058027EN Installation Guide - Vision Air Server

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

81058027EN Installation Guide - Vision Air Server

Enviado por

Direitos autorais:

Formatos disponíveis

Vision Air Server

Vision Air Server

This documentation is protected by copyright. All rights reserved.

Vision Air Software.......................................................................... 1

Minimum Vision Air Server System Requirements ........................... 3

Administrator privileges .................................................................. 5

Communication Protocols ................................................................ 5

SQL database Backups & Maintenance ............................................ 5

DNS URL Address ............................................................................ 6

SSL Certificate ................................................................................. 6

Vision Air Password Policy............................................................... 7

Computer Virus Prevention .............................................................. 7

Server Ports ..................................................................................... 8

Site Preparation ............................................................................. 10

System & Database Backup ........................................................... 10

Installation Requirements .............................................................. 11

Installation Guide - Vision Air Server

Server Installation & Upgrade

The Host Tray Tool ........................................................................ 28

Vision Air Site Setup ...................................................................... 30

Website Handler Mappings ............................................................ 33

MIME Types ................................................................................... 34

HTTP Response Headers ................................................................ 35

Request Filtering ............................................................................ 36

Default HTTP Bindings ................................................................... 37

Installing SQL Client Connectivity

Configure SQL Server ..................................................................... 40

Configuring the Vision Air Server ................................................... 51

Tips & Troubleshooting.................................................................. 56

Installation Guide - Vision Air Server

1.1.1 Vision Air Networking Overview Diagram

Installation Guide - Vision Air Server

1.1.2 Data/server security and confidentiality

Installation Guide - Vision Air Server

80 GB free space (dependant on data storage needs)

SVGA at 1024x768, 16-bit color

Microsoft SQL Server 2008 R2

2-5 open ports on firewall (Incoming) (The number of ports is

Installation Guide - Vision Air Server

2.1.1 Additional Software & Requirements

Microsoft Visual C++ 2005 Redistributable

Installation Guide - Vision Air Server

2.2 Administrator privileges

2.2.2 For the SQL Server

2.3 Communication Protocols

2.4 SQL database Backups & Maintenance

Installation Guide - Vision Air Server

2.5 DNS URL Address

2.6 SSL Certificate

Installation Guide - Vision Air Server

2.8 Vision Air Password Policy

2.9 Computer Virus Prevention

Installation Guide - Vision Air Server

Installation Guide - Vision Air Server

Mail account: Vision Air has features for

Installation Guide - Vision Air Server

3.2 System & Database Backup

Installation Guide - Vision Air Server

3.3 Installation Requirements

3.3.1 SQL Server Configuration

Installation Guide - Vision Air Server

4. Enter the query below and click Execute:

Sp_configure 'show advanced options', 1;