EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License...

76
EPLAN License Manager Installation Instructions Version 7.1 06 / 2012

Transcript of EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License...

Page 1: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

EPLAN License Manager Installation Instructions

Version 7.1

06 / 2012

Page 2: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Copyright © 2012 EPLAN Software & Service GmbH & Co. KG.

EPLAN Software & Service GmbH & Co. KG assumes no liability for either technical or printing errors, or for deficiencies in this technical information and cannot be held liable for damages that may result directly or indirectly from the delivery, performance, and use of this material.

This document contains legally protected proprietary information that is subject to copyright. All rights are protected. This document or parts of this document may not be copied or reproduced by any other means without the prior consent of EPLAN Software & Service GmbH & Co. KG.

The software described in this document is subject to a licensing agreement. The use and reproduction of the software is only permitted within the framework of this agreement.

RITTAL® is a registered trademark of Rittal GmbH & Co. KG.

EPLAN®, EPLAN Electric P8

®, EPLAN Fluid

®, EPLAN PPE

®, EPLAN Cabinet

®, EPLAN Pro Panel

®

and EPLAN Mechatronic Integration® are registered trademarks of EPLAN Software & Service GmbH

& Co. KG.

Windows NT®, Windows 2000

®, Windows XP

®, Windows Vista

®, Windows 7

®, Microsoft Windows

®,

Microsoft® Excel

®, Microsoft

® Access

® and Notepad

® are registered trademarks of the Microsoft

Corporation.

PC WORX®, CLIP PROJECT

®, and INTERBUS

® are registered trademarks of Phoenix Contact GmbH

& Co.

AutoCAD® and AutoCAD Inventor

® are registered trademarks of Autodesk, Inc.

STEP 7®, SIMATIC

® and SIMATIC HW Konfig.

® are registered trademarks of Siemens AG.

InstallShield® is a registered trademark of InstallShield, Inc.

Adobe® Reader

® and Adobe

® Acrobat

® are registered trademarks of Adobe Systems Inc.

TwinCAT® is a registered trademark of Beckhoff Automation GmbH.

Unity Pro® is a registered trademark of Schneider Electric.

RSLogix 5000® and RSLogix Architect

® are registered trademarks of Rockwell Automation.

All other product names and trade names are trademarks or registered trademarks of their respective owners.

EPLAN uses the Open Source software 7-Zip (7za.dll), Copyright © by Igor Pavlov. The source code of 7-Zip is subject to the GNU Lesser General Public License (LGPL). The source code of 7-Zip and details on this license can be found on the following Web site: http://www.7-zip.org

EPLAN uses the open-source software Open CASCADE, Copyright © by Open CASCADE S.A.S. The source code of Open CASCADE is subject to the Open CASCADE Technology Public License. The source code of Open CASCADE and details on this license can be found on the following Web site: http://www.opencascade.org

Page 3: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Table of contents

EPLAN License Manager Installation Instructions 3

Table of contents

Introduction ....................................................................................... 5

Notes for the Reader .................................................................................. 6

Requirements .................................................................................... 7

Software ..................................................................................................... 7

Approved for ............................................................................................... 8

Software No Longer Supported ................................................................. 8

Updating an Existing EPLAN License Manager .............................. 9

Uninstalling ELM 6.1 under Windows Server 2003 .................................... 9

Uninstalling RDS 5 under Windows Server 2003 ...................................... 9

Uninstalling RDS 4.3 under Windows 2000 Server ................................. 10

Installing the EPLAN License Manager ................................................... 11

Configuring the DCOM Interface .................................................... 15

Approved Windows Server Operating Systems ....................................... 15

Windows XP Professional, Windows Vista, and Windows 7.................... 22

Configuring the EPLAN License Manager ..................................... 30

Launching the configuration program ...................................................... 31

Validating / Updating a License ............................................................... 31

Defining Bundles ...................................................................................... 32

Defining new bundles ............................................................................................. 34

Editing bundles ....................................................................................................... 36

Specifying Properties ............................................................................... 37

Making Settings for Borrowing Network Licenses .................................... 41

Define Settings for Saving the Event Log ................................................ 43

Define Settings for Rights Management .................................................. 44

Specifying Settings for Failure Protection ................................................ 47

Using EPLAN License Client .......................................................... 51

Installing the EPLAN License Client ........................................................ 51

Connecting the Client Computer to the EPLAN License Manager .......... 52

Borrowing a License with EPLAN License Manager ................................ 54

Creating a Request File with EPLAN License Client ............................... 56

Page 4: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Table of contents

4 EPLAN License Manager Installation Instructions

Loading a Confirmation File with EPLAN License Client ......................... 57

Retrieving the Validation Code Online with EPLAN License Client ......... 58

Starting EPLAN using Parameters ........................................................... 60

Using EPLAN License Manager Monitor ........................................ 62

Installing the EPLAN License Manager Monitor ...................................... 62

Displaying License Data........................................................................... 62

Create report ............................................................................................ 66

Creating an XML File ............................................................................... 67

Sample Default Listing ............................................................................. 71

Sample Listing of the Current Status for Variable Bundles ...................... 72

Sample of a Listing of the Current Status for Default Bundles................. 73

Sample Listing of the Status Within a Specific Period ............................. 74

Creating a Log File using Command Line Parameters ............................ 74

Parameters for the Call ............................................................................ 74

Example ................................................................................................... 75

Page 5: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Introduction

EPLAN License Manager Installation Instructions 5

Introduction

Dear EPLAN user, This document describes how to install and configure the "EPLAN License Manager" (ELM) Version 7.1. This program allows you to manage EPLAN product licenses within a network. Communication between server and client computers takes place via the "Remote Dongle Service" (RDS), which is set up in Control Panel during installation of the EPLAN License Manager and starts automatically.

The following components are available for network licensing:

• EPLAN License Manager for the server

• EPLAN License Client for the client computer(s)

• EPLAN License Manager Monitor

When using the EPLAN License Manager to license EPLAN products, it is absolutely essential that you update the licensing on every connected client computer. For more information on this, see the section entitled "EPLAN License Client" on page 51.

The "EPLAN License Manager Monitor" can be installed on a server or on a client computer and allows you to display the license status on an EPLAN License Manager. More information on this is provided starting on page 62.

Note:

Please note that only those bundles for which you actually have the rights are displayed in the license status. These instructions are aimed at administrators who are already familiar with EPLAN and who have an in-depth knowledge of programs and systems.

Page 6: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Introduction

6 EPLAN License Manager Installation Instructions

Notes for the Reader

Before you begin reading, please note the following symbols and styles used in this document:

Caution:

Text preceded by this symbol contains a warning; you should be absolutely sure to read this warning before proceeding!

Note:

Text preceded by this image contains extra notes.

Example:

Examples are highlighted by this symbol.

• User interface elements are marked in bold so they can immediately be located in the text.

• Italic text provides particularly important information that you should definitely pay attention to.

• Code examples, directory names, direct input, etc. are shown in a non-proportional font.

• Function keys, keyboard keys, and buttons within the program are shown in square brackets (e.g. [F1] for the "F1" function key).

• To improve the flow of the text, we often use "menu paths" in this document (for example, Start > Run). In order to find a particular program function, the menus and options shown in a menu path must be selected in the sequence shown.

• In combination with settings or fields (e.g. check boxes) which can only be switched on or off, in this document we often use the term "activate" (after which the setting is active ) and "deactivate" (after which the setting is inactive ).

Page 7: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Requirements

EPLAN License Manager Installation Instructions 7

Requirements

In order to run, the EPLAN License Manager requires the following conditions to be satisfied:

Software

The following software preconditions must be satisfied:

• An operating system for which the EPLAN License Manager is approved must be installed (see also the next section: "Approved for").

• It is also assumed that the computer systems all have the latest security updates.

• The installation must be carried out from a user account with administrator rights.

• The dongle must be connected to the computer where the EPLAN License Manager is to be installed.

• The installation starts automatically after the product CD is inserted. It can also be started by running the Setup.exe file on the CD.

Caution:

EPLAN products should not be installed on servers running back-office products from Microsoft (e.g. Proxy, SQL, Active Directory, Exchange) or other vendors (e.g. Lotus Notes, Linux Server, Novell Server). This EPLAN version is only suitable for Windows XP, Windows Vista and Windows Server 2003 and Windows Server 2008, but not for Windows NT 4.0, Linux, or other operating systems. EPLAN Software & Service GmbH & Co. KG provides no guarantee that these products will run with EPLAN Electric P8 or other EPLAN products.

Page 8: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Requirements

8 EPLAN License Manager Installation Instructions

Approved for

Client computer

• Windows XP Professional SP2 and SP3 with all hotfixes and updates

• Windows Vista SP2 (Vista Enterprise, Vista Business N, and Vista Ultimate).

• Windows 7 (7 Professional, 7 Enterprise, and 7 Ultimate).

Server

• Windows Server 2003 SP2 and Windows Server 2003 R2 with all hotfixes and updates.

• Windows Server 2008 SP2 and Windows Server 2008 R2 with all hotfixes and updates.

Note:

Other servers (e.g. Windows NT 4.0, Windows 2000 Server, Novell, Linux) are not currently supported.

Software No Longer Supported

RDS 4.3 is no longer supported.

Page 9: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Updating an Existing EPLAN License Manager

EPLAN License Manager Installation Instructions 9

Updating an Existing EPLAN License Manager

Only one EPLAN License Manager can be run on a given computer. For this reason, any existing version of the EPLAN License Manager / Remote Dongle Service must be uninstalled first. The following section describes this procedure using Windows Server 2003 as an example.

Uninstalling ELM 6.1 under Windows Server 2003

� To upgrade to EPLAN License Manager 7.1, simply run the Setup.exe file on the EPLAN License Manager 7.1 CD. The older version will be automatically uninstalled.

Uninstalling RDS 5 under Windows Server 2003

1. To uninstall Remote Dongle Service 5, click Start and then select Settings > Control Panel.

� The Control Panel program of the operating system opens.

2. Click the Add or Remove Programs icon in Control Panel.

3. In the Add or Remove Programs dialog, select the EPLAN RDS program and click [Change / Remove].

4. The uninstallation then begins. Follow the instructions for uninstalling.

5. Finally, click [OK].

� The EPLAN RDS 5 program has now been successfully removed.

Page 10: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Updating an Existing EPLAN License Manager

10 EPLAN License Manager Installation Instructions

Uninstalling RDS 4.3 under Windows 2000 Server

1. To uninstall Remote Dongle Service 4.3, click Start and then select Settings > Control Panel.

� The Control Panel program of the operating system opens.

2. Click the Add or Remove Programs icon in Control Panel.

3. In the Software dialog, select the Remote Dongle Service 4.3 program and click [Change / Remove].

4. Answer the next two confirmation prompts with [Yes].

� The uninstallation then begins. The check marks in the subsequent dialog indicate how many components have been removed, and the progress bar shows the current status of the uninstall process.

5. Finally, click [OK].

� The Remote Dongle Service 4.3 has now been successfully removed.

Page 11: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Updating an Existing EPLAN License Manager

EPLAN License Manager Installation Instructions 11

Installing the EPLAN License Manager

Before starting to install the EPLAN License Manager, make sure that the dongle provided is connected to the computer.

The installation program starts automatically after the product CD is inserted. If you have deactivated "AutoRun" for CDs then double-click the Setup.exe file in the root directory of the CD.

1. Once the installation wizard has started, select the Program variant to be installed.

2. To install the EPLAN License Manager, select the "License Manager" variant.

3. Click [Install].

4. In the following installation wizard dialogs, you will be asked to confirm the license conditions and specify the Target Directory.

5. Click [Install] once more to start the actual installation.

Page 12: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Updating an Existing EPLAN License Manager

12 EPLAN License Manager Installation Instructions

� The EPLAN License Manager - Configurator dialog opens during the installation. This allows you to select a primary server and activate your license data using the validation code supplied.

6. Select the functional level of your License Manager.

Caution:

If it is the first License Manager in your environment, make sure that you select the Primary License Manager entry. The Standby License Manager can only be used if you have included the Failure protection option in your validated installation.

7. First enter the name of your company in the Company name box.

Page 13: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Updating an Existing EPLAN License Manager

EPLAN License Manager Installation Instructions 13

8. Enter your validation code in the Validation code box and then click [OK].

Notes:

• At this point, you can also decide to just leave the box blank and enter the validation code later. To do this, click [OK] and exit the installation wizard.

• You can also enter several validation codes, one after another. To do this, click [Apply] after entering the first code. The dialog remains open and (after the licensed add-ons are displayed) you can enter another validation code. Do not click [OK] until you have entered the last validation code.

� The licensed add-ons are then displayed in the Validated license dialog.

Page 14: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Updating an Existing EPLAN License Manager

14 EPLAN License Manager Installation Instructions

9. Click [Close].

10. Finally, click [Finish] to end the installation wizard.

The following section explains how to configure the DCOM interface for operating the EPLAN License Manager.

Page 15: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

EPLAN License Manager Installation Instructions 15

Configuring the DCOM Interface

Depending on the operating system, extra configuration of the DCOM interface may be necessary so that the clients can access the computer on which EPLAN License Manager was installed.

The computer on which EPLAN License Manager is installed, and the clients accessing this computer, should all be members of the same Windows domain.

If this is not the case, then an account with the same name and password must be created on the server for every client user account.

Note:

It is assumed that the DCOM configuration reflects the default settings made at the time the operating system was installed. If different settings were made, e.g. to increase system security, then you should consult your system administrator.

Approved Windows Server Operating Systems

Access can be configured so that every user logged into the domain can use a license in EPLAN License Manager; alternatively, a group containing the authorized users can be created. Both variants are described in the following sections. For the second variant, it is assumed that a group called "ELM Users" has been created.

First start the configuration program for the DCOM interface.

1. To do this, select Start > Run, and enter the dcomcnfg command in the Run dialog.

� The Component Services dialog opens.

2. In the tree view of this dialog, select Component Services > Computers > My Computer.

Page 16: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

16 EPLAN License Manager Installation Instructions

3. Right-click My Computer, and select Popup menu > Properties.

� The My Computer Properties dialog opens.

4. On the Default Properties tab, make sure that the Enable Distributed COM on this computer check box is selected.

Page 17: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

EPLAN License Manager Installation Instructions 17

5. Switch to the COM Security tab.

6. Under Launch and Activation Permissions, click the [Edit Limits] button.

� The Launch Permission dialog opens.

7. You must now decide what security settings you wish to make.

If access is to be allowed for all users, select Everyone and then select the Allow check box for all four permission types.

Page 18: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

18 EPLAN License Manager Installation Instructions

If access is only to be allowed for members of the ELM Users group, click the [Add] button and select the appropriate group. After this, all four permission types must be activated for this group via the Allow check boxes.

8. Close the Launch Permission and My Computer Properties dialogs by clicking [OK].

9. Then, in the tree view of the Component Services window, navigate to the DCOM Config folder.

Page 19: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

EPLAN License Manager Installation Instructions 19

10. On the right side of the window, select the ELM7 component.

11. Right-click this component, and select Popup menu > Properties.

� The ELM7 Properties dialog opens.

12. Select the Security tab.

13. In the Launch and Activation Permissions group box, select the Customize option and then click the [Edit] button.

� The Launch Permission dialog opens.

14. If access is to be allowed for all users, select Everyone and then select the Allow check box for all four permission types.

Page 20: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

20 EPLAN License Manager Installation Instructions

If access is only to be allowed for members of the ELM Users group, click the [Add] button and select the appropriate group. After this, all four permission types must be activated for this group via the Allow check boxes.

15. In the Access Permission group box, select the Customize option, and click the [Edit] button.

� The Access Permission dialog opens.

16. If access is to be allowed for all users, select Everyone and then select the Allow check box for all four permission types.

Page 21: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

EPLAN License Manager Installation Instructions 21

If access is only to be allowed for members of the ELM Users group, click the [Add] button and select the appropriate group. After this, all four permission types must be activated for this group via the Allow check boxes.

17. In the Configuration permission group box, select the Customize option, and click the [Edit] button.

� The Change configuration permission dialog opens.

18. If access is to be allowed for all users, select Everyone and then select the Allow check box for all four permission types.

Page 22: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

22 EPLAN License Manager Installation Instructions

If access is only to be allowed for members of the ELM Users group, click the [Add] button and select the appropriate group. After this, all four permission types must be activated for this group via the Allow check boxes.

19. Close the Launch Permission and ELM7 Properties dialogs by clicking [OK].

� The EPLAN License Manager can now be accessed from every authorized client.

Windows XP Professional, Windows Vista, and Windows 7

Access to the DCOM interface under Windows XP is described by way of example.

Access can be configured so that every user logged into the domain can use a license in EPLAN License Manager; alternatively, a group contain-ing the authorized users can be created. Both variants are described in the following sections. For the second variant, it is assumed that a group called "ELM Users" has been created.

Page 23: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

EPLAN License Manager Installation Instructions 23

First start the configuration program for the DCOM interface.

1. To do this, select Start > Run, and enter the dcomcnfg command in the Run dialog.

� The Component Services dialog opens.

2. In the tree view of this dialog, select Component Services > Computers > My Computer.

3. Right-click My Computer, and select Popup menu > Properties.

� The My Computer Properties dialog opens.

Page 24: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

24 EPLAN License Manager Installation Instructions

4. On the Default Properties tab, make sure that the Enable Distributed COM on this computer check box is selected.

5. Switch to the COM Security tab.

6. Under Access Permissions, click the [Edit Limits] button.

Page 25: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

EPLAN License Manager Installation Instructions 25

7. In the Access Permission dialog, enable Remote Access for the "ANONYMOUS LOGON" user. Click [OK] to close the dialog.

8. In the My Computer Properties dialog under Launch and Activation Permissions, click the [Edit Limits] button.

� The Launch Permission dialog opens.

9. You must now decide what security settings you wish to make.

If access is to be allowed for all users, select Everyone and then select the Allow check box for all four permission types.

Page 26: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

26 EPLAN License Manager Installation Instructions

If access is only to be allowed for members of the ELM Users group, click the [Add] button and select the appropriate group. After this, all four permission types must be activated for this group via the Allow check boxes.

10. Close the Launch Permission and My Computer Properties dialogs by clicking [OK].

11. Then, in the tree view of the Component Services window, navigate to the DCOM Config folder.

Page 27: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

EPLAN License Manager Installation Instructions 27

12. On the right side of the window, select the ELM7 component.

13. Right-click this component, and select Popup menu > Properties.

� The ELM7 Properties dialog opens.

14. Select the Security tab.

Page 28: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

28 EPLAN License Manager Installation Instructions

15. In the Launch and Activation Permissions group box, select the Customize option and then click the [Edit] button.

� The Launch Permission dialog opens.

16. If access is to be allowed for all users, select Everyone and then select the Allow check box for all four permission types.

Page 29: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the DCOM Interface

EPLAN License Manager Installation Instructions 29

If access is only to be allowed for members of the ELM Users group, click the [Add] button and select the appropriate group. After this, all four permission types must be activated for this group via the Allow check boxes.

17. Close the Launch Permission and ELM7 Properties dialogs by clicking [OK].

� The EPLAN License Manager can now be accessed from every authorized client.

Page 30: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

30 EPLAN License Manager Installation Instructions

Configuring the EPLAN License Manager

When EPLAN License Manager is installed, a shortcut to the "ELM Configurator" is created on the Windows desktop. You can use this shortcut to launch the configuration program for the EPLAN License Manager. The various tabs of the "EPLAN License Manager Configurator" allow you to:

• Add additional validations

• Define bundles

• Configure License Manager properties, such as monitoring interval, borrowing licenses offline, changing passwords and monitoring your license.

• Specify settings for borrowing network licenses

• Specify settings for saving the event log

• Specify settings for rights management

• Specify settings for failure protection.

Page 31: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 31

Launching the configuration program

1. Double-click the EPLAN icon "ELM Configurator" ( ).

� The EPLAN License Manager – Configurator dialog opens.

Notes:

• You can also launch the configuration program via the Windows Start menu. Installation of the EPLAN License Manager creates the menu items ELM > ELM Configurator in the EPLAN program group.

• Please note that the Borrow, Event log, Rights management and Failure protection tabs are only displayed if you have validated EPLAN License Manager, and your license has the extensions needed for this program.

• Clicking [Apply] saves your new settings in the configuration program, leaving the dialog open.

• Clicking [Update service] updates the EPLAN License Manager. Your new settings in the configuration program are now also available to users when selecting a license.´

Validating / Updating a License

On the Validate tab, enter a validation code for EPLAN License Manager – you can do this during installation or later.

Adding another license

1. To add another validation to the EPLAN License Manager, switch to the Validate tab.

2. Enter the validation code provided by EPLAN in the Validation code box.

3. Then click [Apply].

Page 32: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

32 EPLAN License Manager Installation Instructions

� The licensed add-ons are displayed in the Validated license dialog. The license pool of available systems and extensions on the Define bundles tab is updated. The EPLAN License Manager Configurator remains open, and you can enter other settings.

Defining Bundles

You define bundles for network licensing on the Define bundles tab. "Bundling" allows you to group the various licenses for systems and extensions into practical, well-defined groups.

A bundle can also be created as a "variable bundle". For you this means that you can create bundles regardless of the number of licenses.

With a variable bundle, all the licenses defined in the bundle are always used.

Page 33: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 33

Available Systems and Extensions

After the EPLAN License Manager has been validated, this box shows all available systems and extensions. Systems (e.g. "EPLAN Electric P8 - Professional") are indicated with a red icon and extensions with a blue icon . Extensions can be a language (e.g. "EPLAN W3 Language English") or an add-on (e.g. "EPLAN - API Extension"), for example.

Here you can select the systems and / or extensions from your license validation that you want to bundle and move them to the Defined

bundles box by clicking the Move right button or double-clicking. However, to do this you must first define a bundle.

Defined Bundles

This box displays all defined bundles. The systems / extensions as-signed to a bundle are shown in a tree view. You can expand and col-lapse the tree by double-clicking the bundle name or the corresponding icon .

Another icon was introduced for the variable bundle so that both non-variable and variable bundles can be visualized. .

The Delete button is used to delete a defined bundle or completely remove an assigned system or extension from a bundle. Double-clicking

a system or extension or clicking the Move left button decreases the allocated number of the selected system or extension by 1.

Toolbar

The following buttons are available on the toolbar above the list of defined bundles:

Button Meaning

(New) Generates a new bundle.

(Edit) Allows a selected bundle to be renamed. Opens the Edit number of systems / extensions dialog for the selected systems / extensions. Allows the number of licenses to be changed.

Page 34: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

34 EPLAN License Manager Installation Instructions

Button Meaning

(Delete) Deletes the selected bundle(s). Removes selected systems or extensions from a bundle.

(Bundle properties)

Used to convert a non-variable bundle to a variable bundle.

(Import) Opens a dialog allowing bundle files to be imported.

(Export) Opens a dialog allowing the defined bundles to be exported as a bundle file (*.4elm).

Popup menu

The popup menu contains the following menu items:

Menu item Meaning

New bundle Generates a new bundle.

Edit Allows a selected bundle to be renamed. Opens the Edit number of systems / extensions dialog for the selected systems / extensions. Allows the number of licenses to be changed.

Bundle properties Used to convert a non-variable bundle to a variable bundle.

Delete Deletes the selected bundle(s). Removes selected systems or extensions from a bundle.

Export Opens a dialog allowing the defined bundles to be exported as a bundle file (*.4elm).

Import Opens a dialog allowing bundle files to be imported.

Defining new bundles

1. In the EPLAN License Manager – Configurator dialog, switch to the Define bundles tab.

2. Above the Defined bundles box, click the New button .

� The Edit bundle properties dialog opens.

Page 35: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 35

3. Here you should enter the bundle name that will later be available to users.

4. Activate the Variable bundle check box if you want to create a variable bundle.

5. Click [OK].

6. Add the desired systems and extensions to the bundle by double-

clicking them or by clicking the Move right button .

7. Then click [Apply].

� The defined bundle is saved. The EPLAN License Manager Configurator remains open, and you can enter other settings.

Notes:

• When you have made your settings, click the [Update services] button. This will update your settings for all users when they select a license.

• Double-clicking or single-clicking the (Move to the right) button deducts a system or extension from the available number (the number in the Available number column is reduced by 1) and adds it to the non-variable bundle.

• Make sure that the systems and extensions in the bundle always result in a valid combination in terms of licenses.

• Bundles that have already been selected or borrowed by a user in EPLAN License Manager – Configurator cannot be edited / modified. To do this, first release the borrowed license.

Page 36: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

36 EPLAN License Manager Installation Instructions

Example:

In our example, we have created a simple variable bundle containing the "EPLAN Electric P8 - Professional" system. The extensions "EPLAN – Pages unlimited", "EPLAN W3 Language All", and "EPLAN - User Rights Management", as well as the licenses for particular versions were then added to this. In this type of situation – a bundle with one system – we recommend giving the bundle the same name as the system (in this example "EPLAN Electric P8 Professional").

For variable bundles, you do not have to specify the number of licenses used as EPLAN License Manager does this for you.

Note:

If you are using a variable bundle, please make sure that all the available licenses are always used.

Editing bundles

The Edit feature allows you to add or remove licenses from a selected system or extension in a bundle.

1. Select a system or extension from a bundle in the Defined bundles box. Multiple systems and / or extensions can also be selected.

Page 37: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 37

2. Select Edit.

� The Edit number of licenses dialog opens.

3. Enter the number of licenses to be made available for the selected bundle in the Number box. The maximum possible number is the number of licenses available for this system / extension. Entering "0" removes a selected system / extension.

4. Then click [Apply].

� Your changes are saved. The EPLAN License Manager Configurator remains open, and you can enter other settings.

Specifying Properties

You can define the following properties on the Properties tab:

• Maximum number of computers allowed

• License expiration date

• Cross-domain usage

• Monitoring interval for checking the client/server connection

• Offline borrowing

• Password changes

• Monitor

Page 38: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

38 EPLAN License Manager Installation Instructions

Maximum number of computers allowed

This field shows how many computers can access the License Manager at the same time.

License expiration date

If you have a license with an expiration date, the date is shown here.

Cross-domain usage

If you want to use License Manager across domains, you will need the necessary license.

Note:

Please note that this field is not displayed unless your validation code incorporates this functionality.

Monitoring interval

If the EPLAN application on the client computer does not contact the server within the time interval specified in Timeout for license user response (e.g. because a program was aborted), EPLAN License Manager releases the previously used license, thus making it available to another user.

Page 39: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 39

[Borrow]

Click this button to create an offline license file. To do this you will need a request file created on the client, which is loaded in the Borrow license dialog.

Note:

Please note that this button is not displayed unless your validation code incorporates this functionality.

The request file can be created using the Network license > Borrow license > Create request file menu option from the Select license dialog on the license client.

When the request file thus created is received, it is displayed by clicking the [...] button.

Page 40: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

40 EPLAN License Manager Installation Instructions

Click the [Borrow] button. An .egb file is created. The ELM data directory is suggested by default (e.g. C:\Users\Public\EPLAN\ELM).

Note:

You can also specify a different location for creating this file.

[Change password]

This button is used to define a password for the ELM configurator. The password protects the program from unauthorized access.

1. Enter your old password in the Old password box.

Note:

Please note that the Old password box can only be empty the very first time a password is created. Otherwise, the correct old password must always be entered here.

2. Enter your new password in the New password box.

3. To avoid typing errors on entry, you must enter the password a second time in the Confirm box.

4. Click [OK].

� The next time you start the EPLAN License Manager Configurator", the Start EPLAN License Manager - Configurator dialog is displayed and you must enter the password before you can make any settings in the configuration program.

[Monitor]

This button is used to display the current ELM utilization. You can also check the status of the standby License Manager.

Page 41: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 41

Making Settings for Borrowing Network Licenses

You make settings for borrowing network licenses in the Borrow tab.

Note:

Please note that this only appears if you have validated EPLAN License Manager, and your license contains the extension allowing you to borrow network licenses for this program.

When a network license is borrowed from the license selection, the systems and extensions belonging to that network license are used for the allowed borrowing period defined here. The number of licenses available for other users is reduced accordingly during this time.

If you have not yet defined a bundle on the Define bundles tab, then the Available bundles box only contains the "Default" bundle. This lists all systems and modules belonging to the license you are using.

Page 42: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

42 EPLAN License Manager Installation Instructions

The numbers shown in parentheses after the system or extension stand for: Number to borrow / Maximum number to borrow. For example, "EPLAN Electric P8 - Professional (5 / 10)" means that only 5 of these systems can currently be borrowed out of a total number of 10 systems available for borrowing.

The values in Maximum number to borrow and Maximum borrowing period depend on the license you have for EPLAN License Manager. You can specify a different, lower number and / or a shorter allowed borrowing period for the various elements in the Available bundles box.

If bundles have already been created, all systems and extensions in the ELM license are still listed in the "Default" bundle. However, for the systems and extensions assigned to defined bundles, the values in parentheses are reduced (Number to borrow / Maximum number to borrow), i.e., fewer elements are available for borrowing outside the bundles.

Defining settings for borrowing

1. In the EPLAN License Manager – Configurator dialog, switch to the Borrow tab.

2. Select a system or extension in the Available bundles box.

� Multiple systems and / or extensions can also be selected. If you select a defined bundle, the settings will apply to all systems and extensions in the bundle.

3. In the Number to borrow box, define the number available for borrowing for the selected bundle, system and / or extension if you want this number to be different from the maximum number.

4. In the Allowed borrowing period box, define the permitted borrowing period for the selected bundle, system and / or extension if you want this period to be different from the maximum borrowing period.

5. Define the Number of systems allowed per computer. The number can be Unlimited or Limited to a particular number of systems.

6. Then click [Apply].

� The EPLAN License Manager Configurator remains open, and you can enter other settings.

Page 43: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 43

Note:

Subsequent changes to the settings on the Borrow tab (e.g. a modified borrowing period) have no effect on network licenses that are already borrowed.

Define Settings for Saving the Event Log

The Event log tab is used to make settings for saving the log.

Note:

Please note that this tab is not displayed unless your validation code incorporates this functionality.

To start logging, activate the Create event log check box on the Event log tab. You can then define the Directory and Retention time for the event log.

Page 44: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

44 EPLAN License Manager Installation Instructions

Define Settings for Rights Management

The Rights management is used to make settings for the created bundles for users or groups.

Note:

Please note that this tab is not displayed unless your validation code incorporates this functionality.

This gives you an overview of all the bundles you have created. The "ELM.Everyone" permission is assigned to each bundle by default.

Note:

"ELM.Everyone" allows all users within and outside a domain to access the License Manager. The important factor here is that, as described under "DCOM", the user is set up or has a user with which he can log on to the server.

Page 45: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 45

Toolbar

Button Meaning

(New) Generates a new user

(Delete) Deletes the selected user

(ELM.Everyone) Adds the "ELM.Everyone" user

Create a new user

To add a new user to a displayed bundle, first select the bundle for which the user is to be given rights. Then click the icon [User / Add groups].

To select a user from the domain, click the [...] button. The operating system's default dialog for this action is displayed.

Continue in the normal way for this operating system. In this example, the "Any" user from the "Electric P8 Select" bundle is added.

Page 46: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

46 EPLAN License Manager Installation Instructions

Then click [OK]. The user is displayed under User / group name. He is given the "Use" and "Borrow" permissions by default.

You can configure the Use and Borrow areas manually. To do this, click the "Allowed" entry in the Use column. You can now decide whether the user should be allowed to use the bundle.

Configure in the same way for Borrow.

Note:

If you are using a group, you cannot nest one group inside another. You may only define users within the group. EPLAN License Manager will not break down another group.

Page 47: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 47

Specifying Settings for Failure Protection

You make the settings for the standby License Manager on the Failure protection tab. (A standby EPLAN License Manager must exist within the domain or the same workgroup.)

Note:

Please note that this tab is not displayed unless your validation code incorporates this functionality. To be able to establish a connection between the two systems, you must run the service under a user account. You then use this account to start the Remote Dongle Service.

To do this, switch to the Services console on your server operating system (enter services.msc under Run). The Services console starts.

Find the "Remote Dongle Service" entry and open the properties for this service. Then select the Log on tab.

Page 48: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

48 EPLAN License Manager Installation Instructions

Select the This account option, then select a user for the service.

Note:

Here you can create a user in the domain. They should be created as the default user in the domain. Give the user administrator rights on the server on which EPLAN License Manager is running.

If you have any other questions, please consult your system administrator.

Page 49: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

EPLAN License Manager Installation Instructions 49

Switch to the ELM Configurator program, and select the Failure protection tab.

Activate the Activate failure protection check box, and enter the computer name for the standby EPLAN License Manager. Click the [Update service] button and then click [OK].

Standby server configuration

Switch to the computer on which you want to run the secondary EPLAN License Manager. Install EPLAN License Manager from the CD. When you install, you can decide which operating mode the EPLAN License Manager is to use. In this case, select Standby License Manager.

Page 50: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Configuring the EPLAN License Manager

50 EPLAN License Manager Installation Instructions

Configure the standby License Manager with identical information in the Component services (DCOM) area. Enter dcomcnfg in the Run dialog, and configure the service as described in this document.

Open the ELM Configurator. Here you can enter information about your domain, i.e. the computer name and the serial number of your dongle.

Note:

Please make sure that the primary EPLAN License Manager and standby EPLAN License Manager are in the same domain.

Page 51: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

EPLAN License Manager Installation Instructions 51

Using EPLAN License Client

To allow communication between the EPLAN workstation and the server on which the EPLAN License Manager was installed, the EPLAN License Client must be installed on the EPLAN workstation. This installation must be carried out on every client computer for which you want to use network licensing via the EPLAN License Manager.

Note:

When using the EPLAN License Manager, it is absolutely essential that you update the licensing on every connected client computer.

Installing the EPLAN License Client

The licensing for the client computer is also included on the product CD. The installation program starts automatically after you insert the CD or you can double-click the Setup.exe file in the root directory of the CD. Alternatively, you can find this license in the \License Client directory on the CD.

1. Once the installation wizard has started, select the "License Client" program variant.

2. Click [Install].

3. Click [Next] in the following installation wizard dialogs, finally click [Finish] to install the License Client.

Note:

For installations that are run using MSIEXEC, you must enter the call setup.exe /q for a silent installation, rather than the MSIEXEC call.

Type /? to call other parameters.

Page 52: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

52 EPLAN License Manager Installation Instructions

Connecting the Client Computer to the EPLAN License Manager

After installing the License Client, you still need to connect the client computer to the EPLAN License Manager.

If there is no license on the computer (e.g. when installing EPLAN Electric P8 for the first time), the Validate license dialog is displayed when the relevant EPLAN application starts for the first time. This dialog is also displayed when no connection exists to the EPLAN License Manager.

1. In the Validate license dialog, select the Connect to License Manager option, then click [OK].

� The Connect to License Manager dialog opens.

2. Enter the name of the computer running the EPLAN License Manager in the License Manager box.

Note:

Please note that you cannot use the character string "\\" when specifying the server name.

3. Click [OK].

� If the connection was successful, a message appears stating that the EPLAN License Manager is now available.

Page 53: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

EPLAN License Manager Installation Instructions 53

4. Click [Close].

� The Select license dialog is displayed.

5. Select the required network license from the Selection box.

Note:

The small yellow star on the icon indicates the most recently used license. You can borrow a license via Network license > Borrow license from 'License Manager'. A borrowed network license is indicated by the icon.

6. Click [OK].

� EPLAN starts.

If a single-user license already exists on the computer, the Select license dialog opens when the EPLAN application is started.

1. Select Network license > Connect to License Manager.

� The Connect to License Manager dialog opens.

2. Enter the name of the computer running the EPLAN License Manager in the License Manager box.

3. Click [OK].

� If connection was successful, a message is displayed stating that the EPLAN License Manager is now available.

4. Click [Close].

� The selection in the Select license dialog is updated and you can now access the network licenses in the connected EPLAN License Manager.

In the same way, you can also select the license server using the Select license > Network license > Connect to License Manager dialog.

Page 54: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

54 EPLAN License Manager Installation Instructions

Borrowing a License with EPLAN License Manager

You can also use the Validate license dialog to borrow a license.

Note:

Please note that borrowing is only possible if this functionality is enabled in EPLAN License Manager – Configurator.

To do this, select the Borrow license > From License Manager (online) option. The Borrow license dialog opens. Enter your EPLAN License Manager in the License Manager box, and press [Enter]. Your license bundles are displayed.

Page 55: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

EPLAN License Manager Installation Instructions 55

Select the bundle that you want to borrow on the server, and click the [Borrow] button.

Page 56: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

56 EPLAN License Manager Installation Instructions

Your borrowed license is displayed.

In the same way, you can also borrow a license using the Select license > Network license > Borrow license from the License Manager (online) dialog.

Creating a Request File with EPLAN License Client

To create a request file, select the Create request file menu option.

Note:

Please note that borrowing is only possible if this functionality is enabled in EPLAN License Manager – Configurator.

Page 57: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

EPLAN License Manager Installation Instructions 57

If you have already selected a license file, you can use the Recently used licenses option to select the last used license. If you have still not selected a license, you can note which license you required in the Remark box. You then send this file to your EPLAN administrator so that he can create an offline file on the EPLAN License Manager.

In the same way, you can also create a confirmation file using the Select license > Network license > Borrow license > Create request file dialog.

Loading a Confirmation File with EPLAN License Client

When you send the request file, your EPLAN administrator will create a license file for you.

Note:

The EPLAN administrator should read the "Configure EPLAN License Manager > Define properties" area to do this.

They can then use the Load confirmation file option.

Page 58: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

58 EPLAN License Manager Installation Instructions

Use the Load confirmation file dialog to load your license.

In the same way, you can also load a license using the Select license > Network license > Borrow license > Load confirmation file dialog.

Retrieving the Validation Code Online with EPLAN License Client

You can retrieve a validation code from your license online. To do this, switch to the Select license >Single-user license > Enter validation code dialog.

Page 59: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

EPLAN License Manager Installation Instructions 59

Click the new [Retrieve online] button. When you open it, your serial number is displayed. Please enter the other information requested.

If you have a direct Internet connection, simple click the [Send] button. If you connect to the Internet via a proxy server, click the [Settings] button and enter your Internet login details in the Settings: Internet connection dialog.

Note:

Please speak to your system administrator if you need any further information.

Page 60: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

60 EPLAN License Manager Installation Instructions

Starting EPLAN using Parameters

EPLAN can be started automatically using parameters with the w3u.exe call. The bundle to be started is selected using a cfg file. This file defines whether the license is simply used or has been borrowed.

Parameter Meaning

W3u.exe Calls EPLAN

/license:<path> Parameter for loading the license

A call can thus be structured as follows:

W3u.exe /license:"C:\Users\Public\EPLAN\Common\cfg"

The call file is created using the [Save as file] button in the Borrow license menu option.

Page 61: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Client

EPLAN License Manager Installation Instructions 61

The file contains the following options, which can be used manually:

Option Meaning

[RdsServer]

NetworkAddress=XXXX Computer name of the License Manager

[License]

Borrow=true License is borrowed; if it is set to 'false', the license is merely used.

Packet=2 Which bundle is used

Duration=7 Number of days used

System Which system is loaded

Modules Which modules are loaded

Page 62: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

62 EPLAN License Manager Installation Instructions

Using EPLAN License Manager Monitor

The "EPLAN License Manager Monitor" is a tool you can use to display the license status of a validated EPLAN License Manager, among other things. The associated dialog shows you which licenses of the EPLAN License Manager are available, in use, or borrowed in the network and provides additional general information on the EPLAN License Manager. The "ELM Monitor" can be installed on a server or on a client computer.

Installing the EPLAN License Manager Monitor

This program is also included on the product CD. The installation pro-gram starts automatically after you insert the CD or you can double-click the Setup.exe file in the root directory of the CD.

1. Once the installation wizard has started, select the "Client Tool" program variant.

2. Click [Install].

� The installation then begins.

3. Follow the instructions of the installation wizard in the subsequent dialogs.

Displaying License Data

After a successful installation, you will see an "ELM Monitor" shortcut on your desktop. Start the EPLAN License Manager Monitor by double-clicking the corresponding EPLAN icon.

License Manager

You enter the name of the computer running the EPLAN license manager in this box.

The fields below provide additional general information about the EPLAN License Manager, such as the company name, serial number etc., defined on validation.

Page 63: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

EPLAN License Manager Installation Instructions 63

Users

This tab shows the current users of the defined EPLAN License Manager.

For each user , this tab displays the computer name, user name, user ID, logon time, and for a borrowed license, the date on which the borrow-ing period expires. If the user has borrowed a network license or has started an EPLAN License Manager - Monitor, this is indicated by a different icon (borrowed license: ; ELM Monitor: ).

When you select a user, the box below displays additional information about this user (e.g. name, host ID of the computer, version information, and the systems and extensions associated with a selected license). The systems in a bundle are indicated by this red icon and the extensions by a corresponding blue icon .

Page 64: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

64 EPLAN License Manager Installation Instructions

Licensed add-ons

This tab shows the licensed add-ons of the EPLAN License Manager. The following information, if available, is displayed for every individual system / extension in the ELM license:

• ID

• Bundle name

• Used / Available

• Borrowed / Available

• Borrowing period.

This allows you to see, for example, whether a system / extension is already fully used and whether it belongs to a bundle. You can sort the licensed add-ons information in ascending or descending order by clicking the relevant column header.

Page 65: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

EPLAN License Manager Installation Instructions 65

If you select a system or extension that is in use, the box below shows which user is currently using this element. If this is a system / extension belonging to a borrowed network license, you will also see the borrowing period.

General

This tab shows additional general information on the EPLAN License Manager (e.g. settings made under Monitoring interval or Borrow license).

Dialog language

Different languages for the user interface are offered for selection in this drop-down list.

Time interval for update

In this box, you can specify the time interval for updating the Monitor dialog. After making a change here, click the [Set] button to apply the modified time interval.

Page 66: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

66 EPLAN License Manager Installation Instructions

Create report

If you want to create a report, click [Create report].

Notes:

• Please note that this button only appears if you have validated EPLAN License Manager, and your license contains this extension for this program.

• Please also note that you can only create reports for those bundles to which you have access. To be able to generate reports for all bundles, you will need a user who has access rights to all bundles. This is configured in the Rights management module.

• To be able to generate a report, you must have activated the Create event log check box on the Event log tab in EPLAN License Manager – Configurator.

The output format file contains information that is output in a text file. The output format file is created as an XML file.

It is also possible to read the log files from another directory.

Page 67: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

EPLAN License Manager Installation Instructions 67

Note:

Please note that UTC computer time is always used when you log in on the server. Select the Computer time menu option to set the time zone in which you are working. The output file is then created with your computer time.

Creating an XML File

The EPLAN License Manager report is created via a configurable file.

File name under which the file is to be saved:

<logfile name="ElmLogFile_%FNYEAR.%FNMONTH.%FNDAY_%FNHOUR.%FNMINUTE" extension="txt" path="C:\ELMConfigXml\" date="%d.%B %Y" time="%H:%M:%S" separator="TAB">

The file name is made up of the following values:

%FFYEAR The year specified in "From" %FFMONTH The month specified in "From" %FFDAY The day specified in "From" %FFHOUR The hour specified in "From" %FFMINUTE The minute specified in "From" %FFSECOND The second specified in "From" %FTYEAR The year specified in "To" %FTMONTH The month specified in "To" %FTDAY The day specified in "To" %FTHOUR The hour specified in "To" %FTMINUTE The minute specified in "To" %FTSECOND The second specified in "To" %FNYEAR The year part of the creation time %FNMONTH The month part of the creation time %FNDAY The day part of the creation time %FNHOUR The hour part of the creation time %FNMINUTE The minute part of the creation time %FNSECOND The second part of the creation time

The file is saved as a txt text file. It is called using extension=txt.

You can also specify the path for creating the file. This is called using path=c:\xxx.

The separator is used to output the text file in tab-separated format, for example. This format can then be copied and pasted directly into Excel, for example.

The permitted separators are comma, semicolon and tab.

Page 68: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

68 EPLAN License Manager Installation Instructions

You can also output additional information about the version of EPLAN License Manager used, the serial number, the dongle number and the license expiry date.

<text>EPLAN Software &amp; Service Gmbh Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION</text> <text>License serial number: %ELM_LICENSESERIALNUMBER Dongle: %ELM_DONGLESERIALNUMBER Valid until:%ELM_LICENSEENDDATE</text> <linespacing>1</linespacing> <text>%CREATORNAME %DATE %TIME</text>

- %ELM_VERSION Outputs the version of the license

server.

- %ELM_DONGLESERIALNUMBER Outputs the dongle number.

- %ELM_LICENSEENDDATE Outputs the license expiry date.

- %CREATORNAME Outputs the name of the person who

created the text file.

- %DATE Outputs the date on which the text

file was created.

- %TIME Outputs the date on which the report

was created.

- %TZONE Time zone

The following information can be output in the <list> area.

<list> <linespacing>2</linespacing> <text>State of used license</text> <text> Time zone: %TZONE </text> <username header="NAME" value="all" format="%USER@%DOMAIN" /> <userid header="ID" value="all"/> <userhostid header="HOST ID" value="all"/> <usercomputer header="COMPUTER" value="all"/> <datetime header="TIME" value="all" format="%d.%m.%y %H:%M:%S"/> <action header="ACTION" value="all"/> <state header="STATE" value="all"/> <totalissued header="Total Issued" value="all"/> <totalinuse header="Total licenses in use" value="all"/> <totalborrowissued header="Total borrow issued" value="all"/> <totalborrowed header="Total borrowed" value="all"/> <totalfree header="Total free" value="all"/> <bundle header="BUNDLE" value="all"/> <module header="MODULE" value="all"/> </list>

Page 69: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

EPLAN License Manager Installation Instructions 69

- username Indicates the user.

- userid Displays the ID of the user.

- userhostid Displays the host ID of the user.

- usercomputer Displays the computer.

- datetime Displays the date of the action.

- action Displays the action carried out: IN, OUT, BORROW and RETURN

- state Logged OK or FAILURE. If FAILURE the error message is also

output.

- totalissued Number of existing licenses.

- totalinuse Number of licenses in use.

- totalborrowissued Number of licenses available for borrowing.

- totalborrowed Number of borrowed licenses.

- totalfree Number of free licenses.

- bundle Bundle name.

- module Module name.

The regular expressions are used in the value area to filter by a specific entry. A query about a user or computer would then have the following structure:

<list> <linespacing>2</linespacing> <text>State of used license</text> <username header="^YourPreciseName@eplan\.lan$" value="all" format="%USER@%DOMAIN" /> </list>

In this example, the report would search specifically for the name "[email protected]".

The characters can be used here:

- ^ means search for everything after this character.

- ^ and $ at the end means search for exactly this expression.

Page 70: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

70 EPLAN License Manager Installation Instructions

- There is an exception to this in the "Username" area, as hear the search relates to the format %USER@%DOMAIN. In this case, the query should also contain this information. This means that, when searching for a user within the domain, you must use ^YourPreciseName@eplan\.lan$. Dots must always be preceded by a backslash \.

This applies to all value entries.

It is also possible to request an overview of the license server's status. In this case, the current licenses are added together.

<summary value="current"> <linespacing>2</linespacing> <text>Summary of license</text> <bundle header="Bundle" value="all"/> <module header="MODULE" value="all"/> <totalissued header="Total Issued" value="all"/> <totalinuse header="Total licenses in use" value="all"/> <totalborrowissued header="Total borrow issued" value="all"/> <totalborrowed header="Total borrowed" value="all"/> <totalfree header="Total free" value="all"/> </summary>

Only the variable bundles without a default bundle are output in the above example. The lower entry is used to check the default bundle.

<defaultbundle_summary value="current"> <linespacing>2</linespacing> <text>Summary of pool source bundle</text> <bundle header="Bundle" value="all"/> <module header="Module" value="all"/> <totalissued header="Total Issued" value="all"/> <totalinuse header="Total licenses in use" value="all"/> <totalborrowissued header="Total borrow issued" value="all"/> <totalborrowed header="Total borrowed" value="all"/> <totalfree header="Total free" value="all"/>

</defaultbundle_summary>

Note:

Here you should note that it is possible to change the value of summary and defaultbundle. The following can be specified:

• current: Represents the current status on the license server.

• action: Every action of the license is logged for a specific period.

• For summary, the call would have the following structure: <summary value="current">

Page 71: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

EPLAN License Manager Installation Instructions 71

• For defaultbundle, the call would have the following structure: <defaultbundle_summary value="current">

To obtain a summary of the bundles used, you should only use the <bundle header="Bundle" value="all"/> entry.

To obtain a summary of the modules used, you should only use the <module header="Module" value="all"/> entry.

Sample Default Listing

<?xml version="1.0"?> <logfile name="ElmLogFile_%FNYEAR.%FNMONTH.%FNDAY_%FNHOUR.%FNMINUTE" extension="txt" path="C:\ELMConfigXml\" date="%d.%B %Y" time="%H:%M:%S" separator="tab"> <head> <text>EPLAN Software &amp; Service Gmbh Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION Released 20.11.2009</text> <text>License serial number: %ELM_LICENSESERIALNUMBER Dongle: %ELM_DONGLESERIALNUMBER Valid until:%ELM_LICENSEENDDATE</text> <linespacing>2</linespacing> <text>%CREATORNAME %DATE %TIME</text> </head> <list> <linespacing>2</linespacing> <text>State of used license</text> <username header="NAME" value="all" format="%USER@%DOMAIN" /> <userid header="ID" value="all"/> <userhostid header="HOST ID" value="all"/> <usercomputer header="COMPUTER" value="all"/> <datetime header="TIME" value="all" format="%d.%m.%y %H:%M:%S"/> <action header="ACTION" value="all"/> <state header="STATE" value="all"/> <totalissued header="Total Issued" value="all"/> <totalinuse header="Total licenses in use" value="all"/> <totalborrowissued header="Total borrow issued" value="all"/> <totalborrowed header="Total borrowed" value="all"/> <totalfree header="Total free" value="all"/> <bundle header="BUNDLE" value="all"/> <module header="MODULE" value="all"/> </list>

</logfile>

Page 72: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

72 EPLAN License Manager Installation Instructions

Sample Listing of the Current Status for Variable Bundles

<?xml version="1.0"?> <logfile name="ElmlogPoolAction_%FNYEAR.%FNMONTH.%FNDAY_%FNHOUR.%FNMINUTE" extension="txt" path="C:\ELMConfigXml\" date="%d.%B %Y" time="%H:%M:%S" separator="tab"> <head> <text>EPLAN Software &amp; Service Gmbh Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION</text> <text>License serial number: %ELM_LICENSESERIALNUMBER Dongle: %ELM_DONGLESERIALNUMBER Valid until:%ELM_LICENSEENDDATE</text> <linespacing>1</linespacing> <text>%CREATORNAME %DATE %TIME</text> </head> <linespacing>2</linespacing> <summary value="current"> <linespacing>2</linespacing> <text>Summary of used bundles</text> <bundle header="Bundle" value="all"/> <totalissued header="Total Issued" value="all"/> <totalinuse header="Total licenses in use" value="all"/> <totalborrowissued header="Total borrow issued" value="all"/> <totalborrowed header="Total borrowed" value="all"/> <totalfree header="Total free" value="all"/> </summary>

<linespacing>4</linespacing>

</logfile>

Page 73: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

EPLAN License Manager Installation Instructions 73

Sample of a Listing of the Current Status for Default Bundles

<?xml version="1.0"?> <logfile name="ElmlogPoolCurrrent_%FNYEAR.%FNMONTH.%FNDAY_%FNHOUR.%FNMINUTE" extension="txt" path="C:\ELMConfigXml\" date="%d.%B %Y" time="%H:%M:%S" separator="tab"> <head> <text>EPLAN Software &amp; Service Gmbh Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION</text> <text>License serial number: %ELM_LICENSESERIALNUMBER Dongle: %ELM_DONGLESERIALNUMBER Valid until:%ELM_LICENSEENDDATE</text> <linespacing>1</linespacing> <text>%CREATORNAME %DATE %TIME</text> </head> <defaultbundle_summary value="current"> <linespacing>2</linespacing> <text>Summary of pool source bundle</text> <module header="MODULE" value="all"/> <totalissued header="Total Issued" value="all"/> <totalinuse header="Total licenses in use" value="all"/> <totalborrowissued header="Total borrow issued" value="all"/> <totalborrowed header="Total borrowed" value="all"/> <totalfree header="Total free" value="all"/>

</defaultbundle_summary>

</logfile>

Page 74: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

74 EPLAN License Manager Installation Instructions

Sample Listing of the Status Within a Specific Period

<?xml version="1.0"?> <logfile name="ElmlogAction_%FNYEAR.%FNMONTH.%FNDAY_%FNHOUR.%FNMINUTE" extension="txt" path="C:\ELMConfigXml\" date="%d.%B %Y" time="%H:%M:%S" separator="tab"> <head> <text>EPLAN Software &amp; Service Gmbh Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION</text> <text>License serial number: %ELM_LICENSESERIALNUMBER Dongle: %ELM_DONGLESERIALNUMBER Valid until:%ELM_LICENSEENDDATE</text> <linespacing>1</linespacing> <text>%CREATORNAME %DATE %TIME</text> </head> <summary value="action"> <linespacing>2</linespacing> <text>Summary of modules</text> <bundle header="Bundle" value="all"/> <module header="MODULE" value="all"/> <totalissued header="Total Issued" value="all"/> <totalinuse header="Total licenses in use" value="all"/> <totalborrowissued header="Total borrow issued" value="all"/> <totalborrowed header="Total borrowed" value="all"/> <totalfree header="Total free" value="all"/> </summary>

</logfile>

Creating a Log File using Command Line Parameters

The "EPLAN License Monitor" must be installed in order to create reports using command lines. This is called using the ELMMonitor.exe file.

Parameters for the Call

/Createreport Creates the report /computertime Sets the computer time /Silent No messages are displayed /Servername:Rechner Name of the computer on which the

ELM is running /Xmlfile:c:\*.xml Content of the report

Page 75: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

Using EPLAN License Manager Monitor

EPLAN License Manager Installation Instructions 75

/From:10.09.2009 00:00:00 Start date for the report /To: 12.09.2009 00:00:00 End date for the report The following may be used in place of /From and /To: /Lastdays:01 Number of logged days /Lasthours:01 Number of logged hours /Readdirect Reads the RLOG file immediately /Elmpath:c:\* Reads in the directory; specify

/Readdirect to use.

Example

"C:\Programs\EPLAN\ELM\ElmMonitor.exe" /Createreport /Servername:xt-eplan-1 /Xmlfile:C:\ELMXML \UserNameElmlogfile.xml /From:02.09.2009 06:17:35 /To:30.12.2009 15:07:35

"C:\Programs\EPLAN\ELM\ElmMonitor.exe" /Createreport /Servername:xt-eplan-1 /Xmlfile:C:\ELMXML\Elmlogfile.xml /Lastdays:10

Page 76: EPLAN License Manager Installation Instructions · PDF fileTable of contents 4 EPLAN License Manager Installation Instructions Loading a Confirmation File with EPLAN License Client

EPLAN Software & Service GmbH & Co. KG An der alten Ziegelei 2 40789 Monheim am Rhein · Germany Phone: +49 (0) 21 73 / 39 64-0 Fax: +49 (0) 21 73 / 39 64-25 [email protected] · www.eplan.de