Академический Документы
Профессиональный Документы
Культура Документы
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
Installation Guide
81058027EN / 2016-04-08
ahag
Technische Dokumentation
Metrohm AG
CH-9100 Herisau
techdoc@metrohm.com
Table of Contents
Table of Contents
Table of Contents
III
1.1
1.1.1
1.1.2
Introduction
Overview
2.1
2.1.1
2.2
2.2.1
2.2.2
2.3
2.4
2.5
2.6
2.7
SMTP ............................................................................................... 6
2.8
2.9
2.10
Pre-installation
10
3.1
3.2
3.3
3.3.1
3.3.2
3.3.3
III
3.4
4
4.1
Table of Contents
Matlab Installation......................................................................... 16
18
IIS Configuration
29
5.1
5.2
5.3
5.4
5.5
5.6
Troubleshooting
39
40
7.1
7.1.1
7.1.2
7.1.3
7.2
7.2.1
7.2.2
7.2.3
7.2.4
7.3
7.3.1
7.3.2
7.3.3
7.3.4
7.3.5
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 Introduction
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
Video
NIC
1 Gbit Ethernet
Database Server
Connectivity
2 Overview
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 Overview
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.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.
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
10
3 Pre-installation
11
3 Pre-installation
12
3 Pre-installation
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.
14
3 Pre-installation
15
3 Pre-installation
3. Select 'Yes' to agree to the terms of the license agreement and click
Next
16
3 Pre-installation
4. Click Next
6. Click Finish
17
18
19
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
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
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
30
5 IIS Configuration
3. Right-click on the new Vision Air site under Default Web Site and
select Add Application.
31
5 IIS Configuration
32
5 IIS Configuration
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
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
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
36
5 IIS Configuration
37
5 IIS Configuration
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
40
41
42
5. Click OK, close the SQL Configuration Manager and restart the SQL
services.
43
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
46
47
3. Click on the Security page and enable "SQL Server and Windows
Authentication mode" radio button and click OK.
48
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.
50
51
52
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 />
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"
publicKeyToken="89845dcd8080cc91"
culture="neutral" />
<bindingRedirect oldVersion="10.0.0.0" newVersion="11.0.0.0"
/>
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity
name="Microsoft.SqlServer.SqlEnum"
publicKeyToken="89845dcd8080cc91"
culture="neutral" />
<bindingRedirect oldVersion="10.0.0.0" newVersion="11.0.0.0"
/>
</dependentAssembly>
</assemblyBinding>
</runtime>
55
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)
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
4. Follow the prompts and close the installation program when complete.
58