Elipse DCOM Wizard User's

Manual

Copyright © 2013-2017 Elipse Software Ltda. All rights reserved.

Version 1.0.59 (12/06/2017)
Table of Contents
1 Introduction ......................................................................................... 1
2 Starting the Application ....................................................................... 2
3 Reviewing a Setting Before Applying It ................................................ 6
3.1 Firewall Tab .................................................................................... 7
3.2 DCOM Tab .................................................................................... 10
4 Applying a Setting .............................................................................. 14

I
CHAPTER
Introduction
1
Elipse DCOM Wizard is a wizard to configure DCOM (Distributed Component
Object Model) and Windows Firewall to allow remote connections. It displays
predefined settings for the main products by Elipse Software, but it can be
also used to configure third-party products. Elipse DCOM Wizard was initially
developed based on Elipse Software's Knowledgebase articles and enhanced
to support more functionality.

1 Introduction
CHAPTER
Starting the Application
2
The next figure displays Elipse DCOM Wizard's main window when this
application is opened.

Elipse DCOM Wizard's main window

To configure a computer, the following steps are needed:

1. Select a predefined setting or create a Custom setting.

2. Select an Action among the ones available, Add exceptions and

permissions or Remove or reset exceptions and permissions.

Starting the Application 2

3. Click Apply to apply the selected setting.

The following settings are predefined for Elipse Software products:

· Elipse E3 x86

· Elipse E3 x64

· Elipse OPC Server

· Elipse OPC Client

· Elipse SCADA

On these settings, all parameters are already set. Select a setting and follow
steps two and three described previously.

Elipse DCOM Wizard validates these parameters before applying them. For
example, if the Elipse E3 x64 setting was selected and this product is not
installed or contains some incorrect dependency, an error window is displayed
when applying this setting.

Error window for an invalid setting

In this case, click Settings on the main window and check all parameters in
error, displayed on Application Exceptions group with a red background,
according to the next figure.

3 Starting the Application

 Parameters in error for the selected setting

At any time users can edit these parameters before applying them, even for
pre-defined settings.

NOTE
Changing pre-defined settings or creating a custom setting demands
advanced knowledge on DCOM configuration and on Windows Firewall.

Starting the Application 4

Elipse DCOM Wizard allows configuring third-party products or applications,
as it works as a facilitator to access Windows configurations.

5 Starting the Application

CHAPTER
Reviewing a Setting Before
3 Applying It

For this example, let's configure the Elipse E3 x64 setting on a computer.

NOTE
It is advisable a previous knowledge about Windows Firewall and about
DCOM configurations for this step. To apply only this setting directly, please
check topic Applying a Setting. Otherwise, the following Elipse
Knowledgebase articles may help understand this configuration process:
· DCOM and Firewall Settings in Windows XP/2003/Vista/2008 for Elipse
applications
· DCOM and Firewall Settings in Windows 7 for Elipse applications

Before preparing this setting to apply it, users must install the 64-bit version of
Elipse E3 or have it previously installed on the computer. If the product to
configure is not installed or incompletely installed, revise its parameters and fix
them before applying that setting.

Select the Elipse E3 x64 option and click Settings to open the settings window.
The available options on this window are described on the next topics.

Reviewing a Setting Before Applying It 6

3.1 Firewall Tab
The Firewall tab concentrates settings applied to Windows Firewall.

Firewall tab

The Port Exceptions group indicates ports that must be added to Windows
Firewall's list of exceptions so that E3 works remotely.

7 Reviewing a Setting Before Applying It

 Edit Port Exception window

On this window users can inform any port in the range between 0 (zero) and
65535, select TCP or UDP protocol, and a Profile to which this exception is
applied. Notice that the name is automatically filled in according to the
previously selected setting, for a better identification of the settings applied by
Elipse DCOM Wizard.

NOTE
For versions earlier than Windows 7 the concept of profile is not available
and, in this case, the Profiles option remains disabled.

The Application Exceptions group indicates applications that must be added

to Windows Firewall's list of exceptions.

Reviewing a Setting Before Applying It 8

 Edit Application Exception window

When a predefined setting is selected (in this example the Elipse E3 x64
setting) and that application cannot be found on its installation path, Elipse
DCOM Wizard assumes that this application is on the same directory it was
executed. However, if this application does not exist at this location, it remains
in red on the group, indicating that it is invalid.

NOTE
For versions earlier than Windows 7 the concept of profile is not available
and, in this case, the Profiles option remains disabled.

9 Reviewing a Setting Before Applying It

3.2 DCOM Tab
The DCOM tab concentrates settings to apply to DCOM Config item of
Component Services on Control Panel - Administrative Tools. This setting is
also available by typing dcomcnfg.exe on a command prompt.

DCOM tab

The DCOM Application Permissions group allows adjusting DCOM

permissions needed for the applications of Elipse E3 x64 setting. To do so,
users must inform an application's AppID, by clicking Add. If users want to add
another application, the Add DCOM Permission window has three options,
displayed on the next figure.
Reviewing a Setting Before Applying It 10
 Add DCOM Permission window

· By entering the path where it was registered: Inform an application's

path. In this case, Elipse DCOM Wizard searches on Windows Registry for
an AppID linked to this application

· By informing its ProgID: Inform an application's ProgID. This is a

friendlier name than the AppID. Again, a search is performed on Windows
Registry for an AppID linked to the informed ProgID

· By informing its AppID: Inform the application's AppID directly

Click Validate and, if the AppID is found (the AppID field on Application
group is filled in), click OK.

11 Reviewing a Setting Before Applying It

 Application validated

The COM Security group allows selecting access permissions automatically for
the following users:

· EVERYONE

· SYSTEM

· ANONYMOUS LOGON

NOTE
Changing these parameters requires advanced knowledge. If users are not
confident about these settings, leave these parameters with their default
values.

Reviewing a Setting Before Applying It 12

The Services and Network Sharing group allows configuring the following
items:

· Configure Remote Registry Service: Useful for some applications where

a client want to retrieve information about a server. This setting is on
Control Panel - Administrative Tools - Services - Remote Registry or
by typing services.msc on a command prompt

· Configure Network Discovery: Network discovery so that other

applications that want to connect remotely to a local E3 can find this
computer on the network

NOTE
Changing these parameters requires advanced knowledge. If users are not
confident about these settings, leave these parameters with their default
values.

13 Reviewing a Setting Before Applying It

CHAPTER
Applying a Setting
4
After checking that the desired setting is correct, it is time to apply it. At this
moment there are two possible options, available on the Action group:

· Add exceptions and permissions: Applies the entire setting informed,

adds exceptions to Windows Firewall, edits user and application
permissions for COM and DCOM, and start these services

· Remove or reset exceptions and permissions: Removes Windows

Firewall exceptions, removes or restarts user and application permissions
for COM and DCOM, depending on the user, and stops these services

If any check box is not selected, this means that user and service permissions
ARE NOT CHANGED whatsoever by Elipse DCOM Wizard.

Applying a Setting 14
 System option not selected

When clicking Apply, the dialog box on the next figure should be displayed.

15 Applying a Setting
 Settings applied successfully

If an error message is displayed, this means that one of the applications

informed could not be found. In this case, Elipse DCOM Wizard informs which
problems occurred.

The next figure displays an example of setting with incorrect parameters that
were not applied and the resulting error is displayed on Details section of
Elipse DCOM Wizard's main window.

Applying a Setting 16
 Setting in error

17 Applying a Setting
Headquarters Taiwan
Rua 24 de Outubro, 353 - 10º andar 9F., No.12, Beiping 2nd St., Sanmin Dist.
90510-002 Porto Alegre 807 Kaohsiung City - Taiwan
Phone:(+55 51) 3346-4699 Phone: (+886 7) 323-8468
Fax: (+55 51) 3222-6226 Fax: (+886 7) 323-9656
E-mail: [email protected] E-mail: [email protected]

Check our website for information about a representative in your city or country.
www.elipse.com.br
kb.elipse.com.br
forum.elipse.com.br
www.youtube.com/elipsesoftware
[email protected]

Gartner, Cool Vendors in Brazil 2014, April 2014.

Gartner does not endorse any vendor, product or service depicted in its
research publications, and does not advise technology users to select only
those vendors with the highest ratings. Gartner research publications consist
of the opinions of Gartner’s research organization and should not be
construed as statements of fact. Gartner disclaims all warranties, expressed
or implied, with respect to this research, including any warranties of
merchantability of fitness for a particular purpose.