Professional Documents
Culture Documents
Lantek Integra Installation Guide
Lantek Integra Installation Guide
Installation Guide
Copyright
Disclaimer
Lantek I+D
Parque Tecnológico de Álava
Albert Einstein 36, Ed. Lantek
01510 Miñano - Álava (ESPAÑA)
www.lanteksms.com • info@lanteksms.com
Installation
guide
4
Installation
guide
5
Installation
guide
6
Installation
guide
The procedure to install IIS, create virtual directories and handle known errors is given in this
manual.
DOCUMENTATION CONVENTIONS
The documentation conventions used throughout the manual are as follows:
CONVENTION DESCRIPTION
7
Installation
guide
CHAPTER
1
1 Internet Information Server Installation
First of all, before we install Lantek Integra from DVD we must be sure that the Internet
Information Server is installed in the machine otherwise installer wont´t allow us to install
it.
9
Installation
guide
10
Installation
guide
11
Installation
guide
12
Installation
guide
13
Installation
guide
o In the opening tree click on ”Roles” y then in the middle console click “Add
Server Roles”
Select “Web Server (IIS)”, then some other options will we selected
automatically.
Then we click next and the options inside IIS that we can select are shown. We
must select “Web server -> Application development -> ASP.NET” and
“Management Tools-> IIS 6 management compatibility-> IIS 6 Metabase
14
Installation
guide
compatibility”
15
Installation
guide
CHAPTER
2
2 Internet Information Server configuration
Once we´ve installed Integra from the DVD there are some issues we must check to ensure
the system is configured correctly:
16
Installation
guide
If we´ve installed Integra in 64 bit operating system we must configure the IIS to
allow our 32bit application to work properly:
IIS6
o As shown in
http://extended64.com/blogs/rhoffman/archive/2005/05/10/482.aspx and
http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/II
S/0aafb9a0-1b1c-4a39-ac9a-994adc902485.mspx?mfr=true
w3svc/AppPools/Enable32bitAppOnWin64 1
IIS7
http://blogs.msdn.com/rakkimk/archive/2007/11/03/iis7-running-32-bit-and-64-
bit-asp-net-versions-at-the-same-time-on-different-worker-processes.aspx
Right click the application pool Integra is running at and click "Advanced Settings…"
or click on the same option from the action panel after selecting the application
pool.
Then a window appears and we must set the "Enable 32-bit Applications"
parameter to "True" and click "Accept".
17
Installation
guide
In Windows 7 operating systems we must change the user under our application
runs, to do this:
o Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
o Select the application pool of our application in the view “Application pools”.
18
Installation
guide
CHAPTER
3
3 Virtual directory creation
Installer will create automatically the virtual directories needed to run the application, if
something goes wrong with the installation and you need to create them manually follow
these steps:
Right click on “Default Web Site” and select “New Virtual Directory…”.
o Content directory of the Web site, select the directory where you have Integra
installed, for example c:\lantek\integra.
Open the IIS Administrator and expand completely the main node.
Right click on “Default Web Site” and select “Add application”.In the window that
will be displayed, select the following:
19
Installation
guide
o Alias: Integra
o Local path. Select the directory where you have Integra installed, for example
c:\lantek\integra.
o Content directory of the Web site, select the database directory, for example
c:\lantek\integra.
o In “HTTP Headers” tab select “Enable content expiration” and that the content
must expire immediately.
Open the IIS Administrator and expand completely the main page.
Right click on the “Integra” virtual directory and select “Add application…”.In the
window that will be displayed, select the following:
o Alias: FilesVirtualDir.
20
Installation
guide
o Once it is created left click on the virtual directory and double click in the
section “HTTP Headers”
o Click on the option “Set Common Headers” located in the “Actions” board
and select “Enable Content Expiration” and “Expire Immediately”.
In case of Windows vista SP1 is required in order to visualize this option. If SP1 is not
installed execute the following two commands:
21
Installation
guide
CHAPTER
4
4 Directories permissions
Depending on the version of IIS installed Integra is running as different Windows users:
The user which is used by the IIS to run Integra must have permission in the directories
where Lantek Expert writes files, these are, the Lantek Expert installation directory and
the database folder.
22
Installation
guide
CHAPTER
5
5 Key configuration
Integra needs the Lantek LicenseServer in order to run, this software is installed in
%INSTALLDIR%\System\LicenseServer. This software con work in two modes:
o When we launch the LicenseServer for the first time it asks us for a “Software
Key” which is provided by Lantek
o Once the LicenseServer is started we must set the “Server IP” parameter of the
ipaddress.cfg file (alocated in %INSTALLDIR%\System\Key) to the IP of the
computer where the LicenseServer is running.
o Ensure we´ve a floating dongle, go to “Start -> Settings -> Control Panel ->
WIBU-KEY” and in the Content tab check how many lines does the dongle
contain, there must be at least four.
o Launch the wibukey server “Start -> Programs -> WIBU-KEY -> Network Server”.
o Right click in the Wibukey server tray icon and press “Start server”.
23
Installation
guide
o Configure the Wibukey configuration to use the floating dongle. “Start ->
Settings -> Control Panel -> WIBU-KEY”. In the Network tab in the “WIBU-KEY
subsystems” section select the WkLAN option and unselect Local(Kernel) and
WkNET. Then in the “WkLAN Server Search List” section click browse and select
the name of that computer, then click OK.
o Copy the .key file in the %INSTALLDIR%\System\Key folder and ensure its name
is expert.key.
24
Installation
guide
CHAPTER
6
6 Known problems
Description:
When displaying the main page of the program in computers using Windows XP it shows
error on page.
Cause:
Solution:
25
Installation
guide
Description:
The Asian tooltips cannot be correctly visualized in systems with Windows XP.
Cause:
The required languages for the operating system are not installed.
Solution:
Go to “Start -> Setup -> Control panel -> Regional and language options”.
26
Installation
guide
Description:
The locations of the toolbars and the menus are not correct.
Cause1:
In IIS5, the .NET Framework version of the virtual directory of the solution is not 2.0.
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
In the tree located in the left side select the virtual directory of the installation.
Expand the drop-down list “ASP.NET version” and select the option “2.0.50727”.
Cause2:
Activate Internet Explorer 8 compatibility mode. This button is located on the left
side of “Update”.
27
Installation
guide
Cause:
The System sites need some files of resources for rendering the controls. This files are
very big and if the explorer doesn’t chaches them correctly, the response times become
higher and longer.
Response times also become higher if some of the resources, as for example the
javascript, are not compressed.
Make sure that in the "compilation" node doesn't appear the "debug"
attribute or appears with “false" value.
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
In the tree located in the left side select the virtual directory of the
installation.
28
Installation
guide
29
Installation
guide
Modifying some of the default setup properties makes the Firefox response times better.
Solution:
o network.http.pipelining:true
o network.http.pipelining.maxrequests:8
o network.http.proxy.pipelining: true
o network.dns.disableIPv6:true
30
Installation
guide
o plugin.expose_full_path:true
o In the window that will be displayed, introduce the name of the new property
and the initial value.
31
Installation
guide
Description:
Saving images with local paths in Integra makes no sense. No navigator will show them
if it is not executed from the same machine to which the path refers to. Therefore that is
not the problem regarded here. The problem occurs when a record is edited in order to
change its image and a local image is selected.
When the parameter “viewLocalImages” of the Web.config file is in “true”, the system
will try to show the local image without reloading the page. The problem consists in the
fact that the image cannot be visualised not in Firefox neither in Internet Explorer.
Cause:
The security setup of the navigator doesn’t allow displaying those images.
user_pref("capability.policy.policynames", "localfilelinks");
32
Installation
guide
user_pref("capability.policy.localfilelinks.sites", "http://www.domain.com");
user_pref("capability.policy.localfilelinks.checkloaduri.enabled", "allAccess");
Linux:~/.mozilla/firefox/xxxxxxxx.default/
Apart from the lines introduced for the previous versions of Firefox, it is
necessary to introduce the following lines in the file “user.js”:
user_pref("capability.principal.Avantia.id", "http://www.domain.com");
user_pref("capability.principal.Avantia.granted", "UniversalXPConnect");
user_pref("signed.applets.codebase_principal_support", true);
33
Installation
guide
Copy the following lines in a .reg file and double click on the file:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet
Explorer\MAIN\FeatureControl\FEATURE_BLOCK_LMZ_IMG]
"iexplore.exe"=dword:00000000
"iexplore.exe"=dword:00000000
Description:
When loading a page with local paths the explorer displays a message saying that the
page contains secure and unsecure elements and asks if the unsecure elements should
be shown. If you click on "No" button, the system goes back to the home page.
Cause:
The connection has a certificate of server, the address starts with “https://, and the
images with local paths are considered unsecure elements.
Solution:
34
Installation
guide
Description:
In Firefox 1.5 and 3.0 to 3 the tooltips are too long or contain line feeds that are not
correctly displayed.
Cause:
The Firefox version has not the Add-on required to solve this problem installed.
Solution:
Download and install the required Add-on. You can find this add-ons in:
https://addons.mozilla.org/en-US/firefox/addon/1715.
35
Installation
guide
When downloading a file from Internet Explorer a download window is displayed and it
is immediately hidden without downloading the file.
Cause:
The IP address of the Web server, or the name associated to that address, doesn’t
appear as a secure Web site in the Internet Explorer setup.
36
Installation
guide
Cause:
In a previous download where the window was displayed, the user unchecked the
option “Always ask before opening thid type of file”.
37
Installation
guide
Is not possible to access the requested page due to the extension setup. If the page is a
script, add a controller. If the file must be loaded, add a MIME type.
Cause:
The MIME type for the file type we want to download is not enable in the site or web
application. This happens in IIS6 and IIS7.
Solution:
Add the required MIME type for the type of file to be downloaded. See a list of types in
http://www.webmaster-toolkit.com/mime-types.shtml. If the required type cannot be
found it is possible to select “application/octet-stream”, which is the MIME type of the
executables, or "application/<MyExtension>", which will always show a window that
allows searching a program to open the file or download it to the disk.
http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/cd72c
0dc-c5b8-42e4-96c2-b3c656f99ead.mspx
38
Installation
guide
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
In the tree located in the left side select the virtual directory of the
installation.
Add the required file extension and the MIME type, and click on “OK”.
39
Installation
guide
Description:
When working with the application the following message is displayed “Your session
timeout has expired. Please, enter the system again.” now you have to log in the
application again.
Cause1:
The customer has had the application on hold, which means he hasn’t worked with it in
the explorer for longer than the session timeout.
If the customer wants to establish longer periods of hold, it is necessary to increase the
session timeout.
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
In the tree located in the left side select the virtual directory of the
installation.
40
Installation
guide
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
In the tree located in the left side select the virtual directory of the
installation.
In the window located in the right side double click on “Session state”.
Cause2:
Any of the customers of the applications has been working with them during the same
time or even longer than the "Idle timeout” established for the group of applications.
This time should be the same or longer than the session timeout previously indicated.
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
Increase the value of “Shutdown worker processes after being idle for”
field.
41
Installation
guide
Go to “Start -> Setup -> Control panel Administrative tools -> Internet
information services".
Cause3:
There has been a change in the dlls, aspx files and/or Web.config while a session is
logged.
This is a temporary problem, everytime you change any of the dlls, aspx files and/or
Web.config session will expire.
Cause4:
The high workload of the server can cause delay in the resolution of a request.
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
Select the application pool where our application is executed from the
tree located in the left.
42
Installation
guide
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
In the tree located in the left side select the virtual directory of the
installation.
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
43
Installation
guide
Increase the maximum request execution time (valid procedure also for IIS6):
Description:
Exception:System.Configuration.ConfigurationErrorsException
Cause:
Solution:
%SYSTEMROOT
%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe –ua
%SYSTEMROOT
%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe –i
44
Installation
guide
Description:
Cause:
Solution:
%SYSTEMROOT
%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe –u
%SYSTEMROOT
%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe –i
Description:
45
Installation
guide
Cause:
After installing the .NET framework in Windows XP there is no aspnet user in the server.
Cause:
The date of any aspnet dll is subsequent to the date of the system.
Solution:
Check if the date of the system is correct. As last option, reinstall the Framework.
Description:
Cause:
Solution:
In Internet Information Server manager, you have to display the node of the system from
the tree located in the left side. Then you click on “Web service extensions” in the right
side to enable “ASP.NET v2.0.50727”
46
Installation
guide
Description:
Cause:
Crystal Reports’ engine has been installed in the Integra server before IIS server.
Solution:
47
Installation
guide
Description:
When applying a very complex filter to a report there is a HTTP 404.15 error.
Cause:
The limit of the HTTP request has been exceeded. By default, this limit is 2048 bytes.
Solution:
system.webServer>
security>
<requestFiltering>
<requestLimits maxQueryString="4096"/>
</requestFiltering>
</security>
</system.webServer>
48
Installation
guide
Description:
When starting the Web site from the Configuration Console of IIS 5.1 there is an
unexpected error 0x8ffe2740
Cause:
There is another application using the port that uses the web site. It usually is the
Number 80.
Solution:
You have to change the port where the web site is run from the configuration console of
IIS:
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
Select the web site from the tree located in the left side.
Right click on this web site and in drop-down menu click on “Properties”.
49
Installation
guide
When starting the web site from the configuration console of IIS 7.0 there is an error:
The process has not access to the file because it is being used by another
process.(Except for HRESULT: 0x80070020)
Cause:
There is another application using the port that uses the web site. It usually is the
Number 80.
Solution:
You have to change the port where the web site is run from the configuration console of
IIS:
Go to “Start -> Setup -> Control panel -> Administrative tools -> Internet
information services".
Select the web site from the tree located in the left side.
Select the first entry, click on Modify and change the port.
50
Installation
guide
W
WIBU-KEY dongle: Portable hardware provided along with the software that has to be
connected to the relevant port of your computer to execute Lantek software.
ET
51
Installation
guide
A M
ASP.NET....................................................................14 Metabase.................................................................13
H S
I V
53
Feedback Form
Table of Contents
Index