E3install Enu
E3install Enu
1
Welcome to E3!
E3 is a complete system for process supervisory and control, developed for our customer's
connectivity, flexibility, and reliability requirements. E3 is the result of years of Elipse's
research and hard work.
Its architecture is fully focused on network operation and distributed applications, creating a
true Client-Server system that offers a wide range of features allowing fast application
development, high communication capability, and also ensures system expansion, which
preserves your investments.
With E3, you can perform communication with hundreds of data acquisition devices, using
proprietary drivers and OPC (OLE for Process Control). Powerful graphical user interfaces can be
viewed on a single computer, on a local network, or via Internet. Other features, like alarm
acknowledgement, access to most common databases on the market, information exchange
among several software programs and components, and specific report and formula modules,
make E3 much more powerful and versatile than any other software program available.
We appreciate your preference for our products, and we wish you success with your new work
tool!
2
Package Content
Please make sure you have the following items in your Elipse E3's package:
· Software license
· Installation CD
· Installation Guide
Contact your Elipse Software dealer if you did not find any of these items.
3
Installers
Since version 3.1, installer names have been changed, in order to contain information about
installer's platform and language. The new installer name format is the following:
nnnn-pppp-qqq.exe
Where nnnn is the product name, pppp is the platform, and qqq is the language code, as in
the following examples:
LANGUAGE CODE
Brazilian Portuguese ptb
English enu
German deu
Spanish esn
6 Installers
3.1 E3 Server and E3 Studio
To run E3 server or E3 programming environment, you must have an IBM-PC compatible
computer with the following configuration:
· 256 MB of RAM
· 100 MB of hard disk free space (does not include space for data files)
· Microsoft Windows XP SP3, XP x64 SP2, Server 2003 SP2, Vista SP2, Server 2008 SP2, Server
2008 R2 SP1, and Windows 7 SP1
· USB port
3.2 Viewer
To run Viewer (client), you must have an IBM-PC compatible computer and the following
configuration:
· 64 MB of RAM
· Microsoft Windows XP SP3, XP x64 SP2, Server 2003 SP2, Vista SP2, Server 2008 SP2, Server
2008 R2 SP1, and Windows 7 SP1
Installers 7
CHAPTER
4
Installation
E3 allows two types of installation: Full or Viewer Only (for client stations). For more
information about limitations of the Demo mode, see the topic Limitations of Demonstration
Mode in E3 User's Manual.
4.1 Full
1. Plug the protection device (hardkey) in your computer's USB port. E3 validates licenses
based on this device.
2. Insert the Installation CD in your drive and follow the on-screen instructions.
3. An Installation Complete message will appear when installation is finished. A program group
named Elipse E3 will be created at Windows Start menu.
In case the installer does not open automatically, open the file e3full-x86-enu.exe to install
only E3. This file can be found at root directory of the Installation CD.
NOTES:
· In case of a time-limited protection device installation, E3 Server will show, on Windows
Notification Area, messages warning how much time remains (in days, hours, and finally
minutes) until program license expires
· To install E3 using a softkey-type protection device, please contact Elipse Software
4.2 Viewer
1. Insert the Installation CD in your drive and execute the installation file for Microsoft
Windows XP SP3, XP x64 SP2, Server 2003 SP2, Vista SP2, Server 2008 SP2, Server 2008 R2
SP1, or Windows 7 SP1.
2. Follow the on-screen instructions, and wait for the end of the installation.
8 Installation
4.3 WebViewer
WebViewer is a web client that allows viewing and controlling E3 applications in browsers
supporting the ActiveX technology, such as Internet Explorer. Thus, it is possible to view and
interact with a factory floor process via regular web browsers. To do so, it is necessary to
enable this license type in the protection device. Otherwise, you will not be able to use a
WebViewer.
5. Software installation then starts (to install IIS, you must have a Windows Install CD). Wait
for the end of the process to perform the necessary settings.
To install IIS on Windows Vista SP2 or Windows 7 SP1, follow these steps, using an
administrator account:
4. Click Continue.
5. Locate the item Internet Information Services (IIS), and then expand it to show all its items.
Installation 9
IIS installation on Windows Vista or 7
· ASP
· ISAPI Extensions
· ISAPI Filters
· Default Document
· HTTP Redirection
· Static Content
10 Installation
· Security
· Basic Authentication
· Request Filtering
7. Software installation then starts (you must have a Windows Install CD). Wait for the end of
the process to perform the necessary settings.
NOTE: The file e3webviewer-x86-enu.exe must match the running E3 Server's version (and
build). You must update all files in IIS directory if you update E3 Server's version.
After copying these files to folder C:\InetPub\wwwroot, then you can start configuring IIS.
2. Click Internet Information Services on Windows XP SP3, or click Internet Services Manager on
Windows Server 2003 SP2.
3. Right-click the item Default Web Site, and then choose the item Properties.
Installation 11
Opening Virtual Directory properties
10.Go to Documents tab. Click Remove to exclude all documents from section Enable Default
Document. Click Add and type "e3web.asp" in field Default Document Name to insert this
document as the default page.
2. Click Internet Information Services (IIS) Manager, and then click Continue.
3. Right-click the item Default Web Site, and then double-click the option Default Document,
12 Installation
inside the central frame.
IIS configuration
4. Click the Add option on panel Actions, type "e3web.asp" in field Name, and then click OK.
5. After these procedures, the client station will be able to access the web server via Internet
Installation 13
Explorer.
4.4.1.3 Windows 7
On Windows 7 SP1, follow these procedures:
3. Right-click the item Default Web Site, and then double-click the option Default Document,
inside the central frame.
4. Click the option Add on panel Actions, type "e3web.asp" in field Name, and then click OK.
14 Installation
Adding a default document
5. After these procedures, the client station will be able to access the web server via Internet
Explorer.
1. Go to menu Start - Control Panel - Administrative Tools, and then choose Routing and Remote
Access.
2. In the list of IIS servers, expand the sub-items of the chosen server, and then select option
Network Address Translation.
Installation 15
NAT setup
4. Select the interface exposing E3 Server on the Internet. Notice that this is not the interface
connecting the server to an intranet. Click OK.
16 Installation
5. Choose option Public interface connected to the Internet, and then check Translate TCP/UDP
headers.
6. Go to Special Ports tab, and then click Add. Fill in the Incoming port and Outgoing port fields
with port number 6515, which is the default port used by E3 to communicate. In field Private
address, type the server's IP number.
7. Now you must change the file docwrite2.asp. Open this file (which is published in IIS virtual
directory) in Notepad, and then change the following line:
var domain = getDomain();
To
var domain = "IIS Server's external IP";
Installation 17
The file docwrite2.asp now should look like this:
function getDomain() {
// document.location.host returns server and port.
// This function returns document name, without port.
return document.location.host.split(':')[0];
}
function writeApplet() {
var content = "<object classid='clsid:7EB4D157-FACC-45BB-9536-C14B9DCE3CA7'";
content += " width='100%' height='100%'>";
var domain = getDomain();
// if domain is on a different server, it must be set below
// domain = "myserver";
content += "<PARAM NAME='Domain' VALUE='" + domain + "'>";
content += "<PARAM NAME='Screen' VALUE=''>";
content += "<PARAM NAME='CachePath' VALUE=''>";
content += "<PARAM NAME='Ping' VALUE='0'>";
content += "<PARAM NAME='StartReadOnly' VALUE='0'>";
content += "</object>";
document.write(content);
}
writeApplet();
During server's first access, the browser will start installing components, in case they had not
been previously installed, as seen at the beginning of this chapter. This component is signed
by Elipse Software, and users must accept the installation to start the necessary
configurations.
WebViewer Installation
18 Installation
After installation, the WebViewer will be opened in the browser, and viewing server's
application. Next time it will not be necessary to install the components, and connection will
be faster.
NOTE: Client's version must match server's version. For this, the installer file (e3webviewer-
x86-enu.exe) on server must always be the most updated version.
Installation 19
CHAPTER
5
Software Update
Periodically, Elipse releases new software versions, which contain new tools or updates. Such
updates can be obtained via common media (CD-ROM), or via www.elipse.com.br. There are
also demo versions available. To get these updates, follow these steps:
2. Follow on-screen procedures and wait them to finish. If you already have an Elipse E3
version installed, installer will ask if you want to remove the older one. The message
Installation completed will appear if process was successful. A program group named Elipse
E3 is then created on your computer.
6
Help and Support
Elipse Software has many ways to provide product support. The first step is to check the
documentation, which includes Online Help, User's Guide, and the Internet (www.elipse.com.
br), where users can download new product versions, and also the Elipse Knowledgebase (kb.
elipse.com.br), containing articles about Drivers, E3, SCADA, etc. If documentation does not
answer the questions, users can contact our product support directly at Elipse Software, free
of charge.
· Release Notes: This document contains late-breaking information about new features. It is
located at E3's installation directory
· Manuals: Users can find information about E3 tools and resources at both User's Manual and
Scripts Reference. These manuals are electronically available in CHM format, and in printed
format within Master and Studio software packages
· VBScript Reference Guide: Official Microsoft documentation for Visual Basic Scripting
language. Users can also find this resource by clicking Documentation - VBScript Reference
Guide icon at Start - All Programs - Elipse Software - Elipse E3 program group
· MSForms Reference Guide: Official Microsoft documentation for MSForms objects. Users
can also find this resource by clicking Documentation - MSForms Reference Guide icon at
Start - All Programs - Elipse Software - Elipse E3 program group
If it does, it may be related to the system configuration. Try using a different video driver, or
even modifying the system configuration to see if the problem persists. It is advisable to have
a machine with configurations not much different from the average.
Users can check the software version by opening the item About E3 Studio on Help menu.
Applications generated in older versions are fully compatible with recent ones; however,
applications generated in recent versions cannot be edited or executed in older versions.
Try isolating the component causing the problem. Users can use information about under
which circumstances it happened to help isolate it. If the problem occurs with a script, users
may want to create a smaller example. If it is too large, try splitting it, and then executing it,
step by step.
POSSIBLE REASON
Another E3 version is installed and opened while trying to install this new version.
SOLUTION
Close the older version first, and then continue installation by clicking Retry.
POSSIBLE REASON
An Elipse SCADA version is installed and opened while trying to install Elipse E3.
SOLUTION
After installation, the following message appears when I try to run the software: "E3 Studio
license not found in this server. Do you want to run in demonstration mode?"
POSSIBLE REASON
SOLUTION
a) Run HaspDinst.exe application with -I option. This can be done via Run option on Windows
Start menu. The command line is:
C:\Program Files\Elipse Software\Elipse E3\HASP\haspdinst.exe -I
b) Test USB port with another known device (for example, a printer). Check setup for port
configuration.
For more information about E3's Demo mode limitations, see topic Limitations of
Demonstration Mode in E3 User's Manual.
I moved the application to another computer and now it does not display images anymore
POSSIBLE REASON
SOLUTION
Create the same directory structure (the same path) as the original computer.
6.3.1 E-mail
Users can send a message to the following e-mails:
6.3.2 Internet
Users can go to the Elipse Software homepage to get the latest news and the most updated
version of the software at www.elipse.com.br, in addition to the Elipse Knowledgebase at kb.
elipse.com.br.
6.3.3 Telephone
Support by telephone is available from Monday to Friday. When calling, users must have their
computer nearby, and running E3Elipse Power. Users must also have all available
documentation, along with information listed below:
Porto Alegre, RS +55 (51) 3346-4699 Rio de Janeiro, RJ +55 (21) 2158-1015
(Brazil) (Brazil)
São Paulo, SP (Brazil) +55 (11) 3061-2828 USA +1 (252) 995-6885
6.3.4 Fax
Support by fax is an easy and quick way to solve problems. Try to describe the problem and its
circumstances, step by step. The fax must contain the following information:
Curitiba, PR (Brazil) +55 (41) 3342-0103 Germany +49 (0) 6333 2790045
Branch SP Branch PR
Rua dos Pinheiros, 870 - Conj. 141/142 Av. Sete de Setembro, 4698/1705
05422-001 São Paulo - SP 80240-000 Curitiba - PR
Phone: +55 (11) 3061-2828 Phone: +55 (41) 3342-0120
Fax: +55 (11) 3061-2828 Fax: +55 (41) 3342-0120
E-mail: [email protected] E-mail: [email protected]
Branch RJ USA
Praia de Botafogo, 300/525 40190 Jarvis Gray Lane
22250-044 Rio de Janeiro - RJ Avon - NC - USA 27915
Phone: +55 (21) 2158-1015 Phone: +1 (252) 995-6885
Fax: +55 (21) 2158-1099 Fax: +1 (252) 995-5686
E-mail: [email protected] E-mail: [email protected]
Germany Taiwan
D-67714 Waldfischbach Deutschland 9F., N.12, Beiping 2nd St., Sanmin Dist.
Phone: +49 (0) 6333-4439 807 Kaohsiung City - Taiwan
Fax: +49 (0) 6333-2790045 Phone: +886 (7) 323-8468
E-mail: [email protected] Fax: +886 (7) 323-9656
E-mail: [email protected]
Check our website for information about a representative in your city or country.
w w w .elipse.c om.br
[email protected] om.br