EPLAN License Manager Installation Instructions - … · Introduction 6 EPLAN License Manager...

EPLAN License Manager Installation Instructions

Version 7.1

09 / 2013

EPLAN Software & Service GmbH & Co. KG

Technical Information

Copyright © 2013 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

®,

EPLAN Mechatronic Integration® and EPLAN Harness proD

® are registered trademarks of EPLAN

Software & Service GmbH & Co. KG.

Windows XP®, Windows 7

®, Windows 8

®, Windows Server 2012

®, 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 Config.

® 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

Table of Contents

EPLAN License Manager Installation Instructions 3

Table of Contents

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

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

Preconditions ............................................................................................. 7

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

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

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

Updating the EPLAN License Manager 7.1.2 ............................................ 9

Updating the primary and secondary EPLAN License Manager 7.1.2 ...... 9

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

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

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

Windows 7 and Windows 8 ...................................................................... 23

Configuring the EPLAN License Manager ..................................... 32

Validating / Updating a License ............................................................... 33

Defining Bundles ...................................................................................... 34

Defining new bundles ............................................................................................. 36

Editing bundles ....................................................................................................... 39

Determining Properties ............................................................................ 39

Making Settings for Borrowing Network Licenses .................................... 44

Specifying Settings for Storing the Event Log .......................................... 47

Specifying Settings for the Rights Management ...................................... 48

Carrying out Settings for Failure Protection ............................................. 51

Using the EPLAN License Client .................................................... 55

Installing the EPLAN License Client ........................................................ 55

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

Borrowing a License using the EPLAN License Manager ....................... 58

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

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

Calling up a Validation Code Online with the EPLAN License Client ...... 64

Starting EPLAN using Parameters ........................................................... 66

Table of Contents

4 EPLAN License Manager Installation Instructions

Using the EPLAN License Manager Monitor ................................. 68

Installing the EPLAN License Manager Monitor ...................................... 68

Displaying License Data........................................................................... 68

Creating a report ...................................................................................... 73

Creating an XML file ............................................................................................... 74

Example for a Standard Listing ............................................................................... 78

Example for a Listing of the Current Status for Variable Bundles ............................ 79

Example for a Listing of the Current Status for Standard Bundles .......................... 80

Example for a Listing of the Status within a Specific Period .................................... 81

Creating a Log File via Command Line Parameters ................................................ 82

Introduction


Introduction

Dear EPLAN users,

This document describes how to install and configure the "EPLAN License Manager" (ELM) Version 7.1. This program allows you to man-age 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 the Control Panel program and automatically started during installation of the EPLAN License Manager.

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 section "Using the EPLAN License Client" on 5.

The "EPLAN License Manager Monitor" can be installed on the 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 68.

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.

Introduction


Notes for the Reader

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

Warning:

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

Note:

Text preceded by this image contains extra notes.

Example:

Examples are highlighted by this symbol.

Tip:

Useful tips to facilitate your interaction with the program are presented after this image.

• 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, and direct input (among other elements) are displayed 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 ).

Introduction


Preconditions

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 has been released must be installed (see also the following section: "Approved for").

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

• The installation must be performed from a user account with rights equivalent to an Administrator.

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

Note:

Characters that do not occur in the Latin alphabet are not supported by the EPLAN License Manager (for example Chinese, Cyrillic characters, etc.). If you want to use the EPLAN License Manager, you may only use characters in ASCII format for your user and computer names. Please inform yourself about the hardware prerequisites and the soft-ware approvals of the EPLAN Platform before installing EPLAN products. This information is available in the EPLAN performance descriptions of the respective products.

Introduction


Approved for

Client computer

• Microsoft Windows XP Professional SP3 (32 bit)

• Microsoft Windows 7 SP1 (64 Bit) Professional, Enterprise and Ultimate.

• Microsoft Windows 8 (64 bit) Pro, Enterprise.

Server

• Microsoft Windows Server 2003 SP2 (32 bit and 64 bit)

• Microsoft Windows Server 2008 SP2 (32 bit and 64 bit)

• Microsoft Windows Server 2008 R2 (64 bit)

• Microsoft Windows Server 2012 (64 bit).

Note:

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

Warning:

The approval for the Microsoft Windows XP operating system only ap-plies for the EPLAN License Manager. From 2013, the EPLAN platform only supports the 64-bit variant of the Microsoft operating systems Windows 7 and Windows 8.

Updating an Existing EPLAN License Manager



Only one EPLAN License Manager can be run on a given computer. For this reason, an existing installation of the EPLAN License Manager must always first be uninstalled.

Updating the EPLAN License Manager 7.1.2

In order to change from the EPLAN License Manager Version 7.1.2 to the new Version 7.1.3 you only have to install the new version. The older version is then removed automatically.

1. On the DVD of one of the products of the EPLAN Platform change to the directory ELM and here select the system type of your installed operating system (32 bit or 64 bit). In this example we will use the 64 bit version.

2. Open the ELM\License Manager (x64) directory and here double-click the setup.exe file. Carry out the installation.

� Your settings in the "Services" and "DCOM" section are trans-ferred automatically when the setup.exe file is executed.

Updating the primary and secondary EPLAN License Manager 7.1.2

If you use two EPLAN License Managers (Primary License Manager and Standby License Manager) in your company network in order to ensure failsafe performance, you must always first update the primary License Manager during an update.

1. Terminate the "Remote Dongle Service" on the primary License Manager.

2. Set the start type to "Deactivated". Check whether the standby License Manager becomes active.



3. Start the installation on the primary License Manager. Open the ELM\License Manager (x64) directory and here double-click the setup.exe file. Carry out the installation.

� Your settings in the "Services" and "DCOM" section are trans-ferred automatically when the setup.exe file is executed.

4. After successful installation set the start type of the service back to "Automatic". Subsequently restart the service.

� After a certain updating interval the active standby License Manager now transfers all the tasks back to your primary License Manager.

5. Check whether the primary License Manager is active again.

6. Subsequently you can now update the standby License Manager. To do so start the setup.exe file and then the installation.

7. After success installation check whether the "Remote Dongle Service" has started.

� After a certain updating interval the two EPLAN License Manager synchronize automatically.



Installing the EPLAN License Manager

Before beginning the installation of the EPLAN License Manager, make sure that the dongle provided is connected to the computer.

1. After inserting the DVD of one of the products of the EPLAN Platform change to the directory ELM and here select the system type of your installed operating system (32 bit or 64 bit). In this example we will use the 64 bit version.

2. Open the ELM\License Manager (x64) directory and here double-click the setup.exe file.

3. Answer [Yes] to confirm the subsequent safety prompt.

4. In the subsequent dialog click [Install].

� The installation wizard for the EPLAN License Manager is opened.



5. In the next installation wizard dialogs, among other things you confirm the license conditions and define the Target Directory.

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

� The Select License Manager Configurator dialog opens during the installation.

7. Here select the operating mode of your EPLAN License Manager.



Caution:

If this is the first EPLAN License Manager in your system environ-ment ensure that the Primary License Manager is selected. The Standby License Manager option may only be used if your valida-tion code includes the Failure protection functionality (see the section "Carrying out Settings for Failure Protection" on Page 51).

� The dialog Primary License Manager - Configurator is opened. This allows you to activate your license data via the validation code supplied.

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

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



Notes:

• At this point, you can also leave the box empty and enter the validation code later. To do this, click [OK] and exit the installa-tion 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 licensing scope is displayed) you can enter another validation code. Do not click [OK] until you have entered the last validation code.

� The licensing scope is then displayed in the Validated license dialog.

10. Click [Close].

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

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

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 the EPLAN License Manager has been installed.

The computer on which the EPLAN License Manager is installed, and also 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 pass-word must be created on the server for every client user account.

Note:

It is assumed that the DCOM configuration reflects default settings made at the time the respective 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 on in the domain can use a license in the EPLAN License Manager; alternatively, a group containing the authorized users is 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.

The configuration program for the DCOM interface must first be started.

1. To do this, select Start > Run, and enter the dcomcnfg command in the Run dialog. You can carry out the entry directly under Windows Server 2012.

� 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 the Popup menu > Properties.

� The My Computer Properties dialog opens.



4. In the Default Properties tab, make sure that the Enable Distrib-uted COM on this computer check box is selected.

5. Change to the COM Security tab.



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

� The Launch and Activation Permissions 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 permission types.



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 and Activation Permissions and My Computer Properties dialogs by clicking [OK].

9. After this, in the tree view of the Component Services dialog navigate to the DCOM Config folder.



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

11. Right-click this component and select the 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.


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



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 then click the [Edit] button.

� The Access Permission dialog opens.




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, the permission types must be activated for this group via Allow.

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

� The Change Configuration Permission dialog opens.




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, the permission types must be activated for this group via Allow.

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

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

Windows 7 and Windows 8

Access to the DCOM interface under Windows 8 is described as an example.

Access can be configured so that every user logged on in the domain can use a license in the EPLAN License Manager; alternatively, a group containing the authorized users is 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.



The configuration program for the DCOM interface must first be started.

1. Move the cursor to the left-hand lower corner of the user interface and click Start to open the Start interface of Windows 8.

2. Here enter the command dcomcnfg and press [Enter] to confirm.

� The Component Services dialog opens.

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

4. Right-click My Computer and select the Popup menu > Properties.



� The My Computer Properties dialog opens.

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

6. Change to the COM Security tab.



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

8. In the Access Permission dialog, enable Remote Access for the "ANONYMOUS LOGON" user. Close the dialog by clicking [OK].



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


10. 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 permission types.



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

11. Close the Launch and Activation Permissions and My Computer Properties dialogs by clicking [OK].

12. After this, in the tree view of the Component Services dialog navi-gate to the DCOM Config folder.



13. On the right side of the dialog, select the component ELM7.

14. Right-click this component and select the Popup menu > Proper-ties.

� The ELM7 Properties dialog opens.

15. Select the Security tab.



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





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

18. Close the Launch and Activation Permissions and ELM7 Properties dialogs by clicking [OK].

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

Configuring the EPLAN License Manager



During the installation of the EPLAN License Manager 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 (from Page 33)

• Define bundles (from Page 34)



• Specify the properties of the EPLAN License Manager (from Page 39)

• Specify settings for borrowing network licenses (from Page 44)

• Specify settings for storing the event log (from Page 47)

• Specify settings for the rights management (from Page 48)

• Specify settings for the failure protection (from Page 51).

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 the "EPLAN License Manager" and your license contains the extension allowing you to borrow network licenses.

• Clicking [Apply] saves your new settings in the configuration pro-gram, 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 during license selection in the dialog Select license.

Validating / Updating a License

In the Validate tab, enter a validation code for the 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].

� The licensing scope is displayed in the Validated license dialog. The "license pool" of available systems and extensions in the Bun-dles tab is updated. The EPLAN License Manager - Configurator remains open, and you can make additional settings.

Defining Bundles

In the Bundles tab you define bundles for network licensing. "Bundling" of licenses 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". This means for you that the bundling can be created irrespective of the number of licenses.

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

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 (such as "EPLAN Language: English") or an add-on (such as "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 bund-les 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 collapse the tree by double-clicking the bundle name or the corresponding icon .

A further 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 expansion by 1.

Toolbar

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

Button Meaning

(New) Creates 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.

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



Button Meaning

(Bundle properties)

Allows a non-variable bundle to be converted into a variable one.

(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 Creates 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 Allows a non-variable bundle to be converted into a variable one.

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 Bundles tab.

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

� The Edit bundle properties dialog is opened.



3. Here 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 .


� The defined bundle is saved. The EPLAN License Manager - Configurator remains open, and you can make additional settings.

Notes:

• You should click [Update service] after you have carried out your settings. Your settings are then updated for all the users during the license selection.

• One system or extension will be subtracted from the available number (the respective number in the Available number column is reduced by 1) and added to the non-variable bundle whenever you double-click or when you click the button (Move right).

• 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 cannot be edited / modified in the EPLAN License Manager - Configurator . To do so first release the borrowed license.



Example:

In our example, we have created a simple variable bundle containing the "EPLAN Electric P8 - Professional" system. The extensions "EPLAN – Pages unlimited", "EPLAN Language: English", 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").

You do not have to specify the number of used licenses at variable bund-les. The EPLAN License Manager manages this for you.

Note:

Please note that all the available licenses are always used when a varia-ble bundle is 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.

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.


� Your changes are saved. The EPLAN License Manager - Con-figurator remains open, and you can make additional settings.

Determining Properties

You can specify the following properties and carry out the following actions in the Properties tab:

• Maximum number of computers allowed

• License expiration date

• Cross-domain usage

• Monitoring interval for checking the client-server connection

• Creating a report

• Creating an offline-license file for borrowing



• Changing the password

• Monitoring the license status via Monitor.

Maximum number of computers allowed

This field displays the number of computers that can access the EPLAN License Manager simultaneously.

License expiration date

If your license has an expiration date, it is displayed here.



Cross-domain usage

If you want to use the EPLAN License Manager across domains, you have to have this license.

Note:

Please note that this field is only displayed if your validation code con-tains 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., due to a program abort), the license previously in use is released by the EPLAN License Manager and is then available to an-other user.

[Create report]

This functionality allows you to evaluate the log files (*.rlog) of the EPLAN License Manager that are created by the event log.

Further information is available in the section "Specifying Settings for Storing the Event Log" on Page 47 and in the section "Creating a report" on Page 73.

[Borrow]

This button is used to create an offline license file. To this purpose you need a request file created on the client (see the corresponding section on Page 61). The request file is read into the Borrow license dialog.

Note:

Please note that this button is only displayed if your validation code contains this functionality.

After you have received the created request file, select it using the [=] button.



Click the [Borrow] button. This creates an offline license file (*.egb) in the default directory of the EPLAN License Manager (for example C:\Users\Public\EPLAN\ELM).

[Change password]

This button is used to specify 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 must be empty when a password is set up for the first time. 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 the EPLAN License Manager - Configurator is started, the Start EPLAN License Manager - Configurator dialog is displayed and you must enter the password before you can make settings in the configuration program.

[Monitor]

Use this button to open the "EPLAN License Manager Monitor". Here you can have the license status of the EPLAN License Manager dis-played. In addition, you can check the status of the Standby License Manager.



Making Settings for Borrowing Network Licens-es

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

Note:

Please note that this tab is only displayed if your validation code contains this functionality.

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



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

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 your particular license for the EPLAN License Man-ager. For the various elements in the Available bundles box, you can specify a different, lower number and / or a shorter allowed borrowing period.

If bundles have already been created, all systems and extensions in the ELM license are still listed in the "Default" bundle. However, for the sys-tems and extensions assigned to the defined bundles, the values in the 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 numbering 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 borrow-ing period for the respective bundles, systems and / or extensions 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.




� The EPLAN License Manager - Configurator remains open, and you can make additional settings.

Note:

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



Specifying Settings for Storing the Event Log

You make settings for storing the logs in the Event log tab.

Note:


To start logging activate the Create event log check box in the Event log tab. Then you can set the Directory and the Retention time for the event log.



Specifying Settings for the Rights Management

In the Rights management tab you assign users or groups with specific authorizations to the created bundles.

Note:


An overview of all the bundles created by you is provided. By default each bundle contains the user / group "ELM.Everyone" with the authori-zation to use and borrow this bundle.



Note:

"ELM.Everyone" allows all users within and outside a domain to access the EPLAN License Manager. It is important in this respect that a user is set up as described in the section “Configuring the DCOM Interface" on Page 15, or has the login information of a different user with which the user can log on to the server.

Toolbar

Button Meaning

(Add users / groups) Creates a new user.

(Remove users / groups) Deletes the selected user.

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

Creating a new user

To add a new user to the displayed bundle first mark the bundle for which the user is to have the rights. Subsequently click the icon (Add users / groups).

Click the [...] button to select a user from the domain. The default dialog of the operating system is displayed for this action.



Proceed here as is usual for the operating system. In this example the user "Everyone" is added to the "Electric P8 Select" bundle.

Then click [OK]. The user is displayed under User / group name. By default the user has the authorizations "Use" and "Borrow".



You can configure the entries for the authorizations in the Use and Borrow columns manually. To do so click "Allowed" in the Use column. Here, you can now specify whether the selected user / group is to have the authorization to use the bundle ("Allowed" entry) or not ("Not allowed" entry).

Configuration for Borrow is carried out similarly.

Note:

Cross-domain groups ("Universal groups") are also supported.

Carrying out Settings for Failure Protection

To improve failure protection (failover), it is now also possible to install two EPLAN License Managers. In the case of a server failure of the primary License Manager a second previously inactive EPLAN License Manager (standby License Manager) takes over its function and makes the licenses available.

You carry out the setting for the standby License Manager in the Failure protection tab.

Notes:

• Please note that this tab is only displayed if your validation code contains this functionality.

• Also ensure that the primary License Manager and the standby License Manager are located in the same domain.

Configuration of the Remote Dongle Service

In order to establish a connection between the two License Managers you have to execute the service under a user account. Using it you then start the Remote Dongle Service service.

Go to the Microsoft administrative program Services on your server operating system (enter services.msc under Run.) The Services dialog opens.



Here search for the entry "Remote Dongle Service" and open the proper-ties of the service. Then select the Log On tab.

Select the This account option and select a user for the service.

Note:

You can create a user in the domain here. This user should be created as a default user in the domain. Assign administrative rights to the user on the server on which the EPLAN License Manager runs.

If you have any further questions, please contact your system adminis-trator.



Change 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 License Manager. Click the [Update service] button and then [OK].

Configuration of the standby server

Change to the computer on which the secondary EPLAN License Man-ager is to be executed. Install the EPLAN License Manager from the DVD. During the installation you can choose the operating mode of the EPLAN License Manager. Select the Standby License Manager option here.



Configure the standby License Manager with the identical information in the Component Services (DCOM) section. To this purpose enter dcomcnfg in the Run dialog and configure the service as described in this document.

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

Using the 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 performed on every client computer for which you want to use net-work 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 DVD of a product of the EPLAN Platform. The EPLAN Setup Manager installation program starts automatically after you insert the DVD. Alternatively, you can double-click the Setup.exe file in the root directory of the DVD. Alternatively, you can find this license in the \License Client directory on the DVD.

1. Follow the instructions in the started EPLAN Setup Manager.

2. In the dialog with the User-defined installation select the Program component "EPLAN License Client".

3. Click [Install] to install the license client.

4. Finally, click [Finish] to terminate the EPLAN Setup Manager.

Note:

In the case of installation carried out using MSIEXEC, you have to enter the setup.exe /q call for a "silent installation" instead of the MSIEXEC call.

Further parameters can be called up using /?.



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 no license exists on the computer (e.g., after installing EPLAN Electric P8 for the first time), the Validate license dialog is displayed when the respective EPLAN application starts. 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 and 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 computer name.

3. Click [OK].

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

4. Click [Close].

� The Select license dialog is displayed.

5. Select the desired network license in the Selection box.

Note:

The small yellow star on the icon shows you the most recently used license. You can borrow a license via Network license > Borrow license > From License Manager (online). 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 is displayed when the EPLAN application is started.

1. Here 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.

Borrowing a License using the 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 is enabled in the EPLAN License Manager - Configurator.

1. Select the Borrow license > From License Manager (online) option to do so.

� The Borrow license dialog is opened.

2. Enter your EPLAN License Manager here in the License Manager box and press [Return].

� The license bundles to be borrowed are displayed.



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

� Your borrowed license is displayed.



Tip:

You can also borrow a license by using the Select license dialog. Select the Network license > Borrow license > From License Manager (online) menu items to do so.



Creating a Request File with EPLAN License Client

You have to select the Create request file option in the Validate license dialog to create a request file.

Note:

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

The Create request file dialog then opens.



If you have already selected a license file, you can use the Recently used licenses check box to select the license used last. If you have not yet selected a license, you can enter the license you need in the Remark field. You subsequently send this file to your EPLAN administrator so that the administrator can create an offline license file on the EPLAN License Manager.

Tip:

You can also create a request file by using the Select license dialog. Select the Network license > Borrow license > Create request file menu items to do so.

Loading a Confirmation File with EPLAN License Client

After you have sent the request file your EPLAN administrator will create an offline license file for you.

Note:

EPLAN administrators should read the section "Determining Properties" starting on Page 39 for further information. This section provides infor-mation about how to create an offline license file on the basis of the request file in the Properties tab of the configuration program.

You can subsequently read this in using the Load confirmation file option.



Read in your license using the Load confirmation file dialog.

Tip:

You can also load a license by using the Select license dialog. Select the Network license > Borrow license > Load confirmation file menu items to do so.



Calling up a Validation Code Online with the EPLAN License Client

You can call up a validation code for your license online.

1. To do so go to the Select license dialog.

2. Select the menu items Single-user license > Enter validation code.

� The Enter validation code dialog opens.

3. Here click the [Retrieve online] button.



4. Your serial number is displayed in the Set validation code online dialog. Please enter the further information.

5. If you have a direct Internet connection, you only have to click the [Send] button.

6. If you are connected to the Internet through a proxy server, please click the [Settings] button and enter your logon information for the Internet in the Settings: Internet connection dialog.

Note:

If you require further information, please contact your system administra-tor.



Starting EPLAN using Parameters

EPLAN can be started automatically with parameters by using the call w3u.exe. The bundle to be started is selected via a cfg file. This file contains all the information whether the license is only being used or is borrowed.

Parameter Meaning

W3u.exe EPLAN call

/license:<Path> Parameter for loading the license A call could for example be as follows:

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

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



The file contains the following options that can be used manually:

Option Meaning

[RdsServer]

NetworkAddress=XXXX Computer name of the License Manager

[License]

Borrow=true License is borrowed. At "false" the license is only used.

Packet=2 Which bundle is used

Duration=7 Number of days used

System Which system is loaded

Modules Which modules are loaded

Using the 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 a client computer.

Installing the EPLAN License Manager Monitor

This program is also included on the DVD of a product of the EPLAN Platform.

1. After inserting the DVD change to the directory ELM and here select the system type of your installed operating system (32 bit or 64 bit). In this example we will use the 64 bit version.

2. Open the ELM\License Tools (x64) directory and here double-click the setup.exe file.

� The installation wizard for the EPLAN License Monitor is opened.

3. In the subsequent dialogs follow the instructions of the installation wizard, and click [Install] to start the actual installation.

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 man-ager 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.

User

This tab shows the current users of the defined EPLAN License Man-ager.

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 bor-rowing 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 the red icon and the extensions by a corresponding blue icon .

Licensed add-ons

This tab shows the licensing scope 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 fully used and whether it belongs to a bundle. You can sort the licensing scope information in ascending or descending order by clicking the respective column headers.



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.



Creating a report

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

Notes:

• Please note that this button is only displayed if your validation code contains this functionality.

• Please also note that you can only create reports for bundles that you can access. To evaluate all bundles you require a user who has access rights to all the bundles. You can configure this in the Rights management.

• In order to evaluate a report you must have activated the Create event log check box on the Event log tab in the EPLAN License Manager - Configurator.

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

It is furthermore also possible to read in the log files directly from a differ-ent directory.

Note:

Please note that the UTC computer time is always used during a login on the server. In order to set the time zone in which you are working, select the menu item Computer time. The output file is then created with your computer time.



Creating an XML file

Evaluation of the EPLAN License Manager is carried out using a configu-rable file.

File name for saving the file:

<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 can be composed from the following date values:

%FFYEAR Year specification of "From" %FFMONTH Month specification of "From" %FFDAY Day specification of "From" %FFHOUR Hours specification of "From" %FFMINUTE Minutes specification of "From" %FFSECOND Seconds specification of "From" %FTYEAR Year specification of "To" %FTMONTH Month specification of "To" %FTDAY Day specification of "To" %FTHOUR Hours specification of "To" %FTMINUTE Minutes specification of "To" %FTSECOND Seconds specification of "To" %FNYEAR Year specification of the creation time %FNMONTH Month specification of the creation time %FNDAY Day specification of the creation time %FNHOUR Hours specification of the creation time %FNMINUTE Minutes specification of the creation time %FNSECOND Seconds specification of the creation time

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

The path in which the file is created can be specified. It is called via path=c:\xxx.

The separator is used to output the file, for example, tab-separated. This format can then for example be inserted directly into MS Excel using "Copy & Paste".

Permissible separators are comma, semicolon and tab.

It is possible to output additional information about the used version of the EPLAN License Manager, the serial number, the dongle number and the license expiration date.



<text>EPLAN Software & Service GmbH Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION</text> <text>License serialnumber: %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 expiration date.

- %CREATORNAME Outputs the creator of the text file.

- %DATE Outputs the date of creation of

the text file.

- %TIME Outputs the creation time of the report.

- %TZONE Time zone

The following information can be output in the <list> section:

<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 license 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>

- username Displays 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 executed action: IN, OUT, BORROW and RETURN



- state Records OK or FAILURE. At FAILURE the error message is also output.

- totalissued Number of existing licenses.

- totalinuse Number of used licenses.

- totalborrowissued Number of licenses that can be borrowed.

- totalborrowed Number of borrowed licenses.

- totalfree Number of free licenses.

- bundle Bundle name.

- module Module name.

In order to filter for a specific entry, the regular expressions can be used in the value section. A query for a user or a computer would then have the following form:

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

In this example the evaluation would search exactly for the name "[email protected]".

The following characters are available here:

- ^ means that the search is carried out for everything behind it.

- ^ and $ at the end means that the search is carried out exactly for this search term.

- The "Username" section is an exception here since the search is carried out for the %USER@%DOMAIN format. These query should also contain this information here. This means ^YourExactName@eplan\.lan$ has to be used at a search for a user within the domain. Dots have to be marked with a preceding backslash \ .

This applies to all the value entries.

In addition, it is possible to obtain an overview of the license server status. The current licenses are totaled here.



<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 license in use" value="all"/> <totalborrowissued header="Total borrow issued" value="all"/> <totalborrowed header="Total borrowed" value="all"/> <totalfree header="Total free" value="all"/> </summary>

In the above example only the variable bundles without standard bundle are output. The lower entry is used to check the standard 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 license 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>

Notes:

Take into account that it is possible to change the value of summary and defaultbundle. The following can be specified here:

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

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

• At summary the call would be as follows: <summary value="current">

• At defaultbundle the call would be as follows: <defaultbundle_summary value="current">

You should only use the entry <bundle header="Bundle" value="all"/> to obtain an overview of the used bundles.

You should only use the entry <module header="Module" value="all"/> to obtain an overview of the used modules.

However the current value can also be used for value at the list output.

• At list the call would be as follows: <list value="current">

The current status of the bundles used is then displayed.



Example for a Standard 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 & Service GmbH Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION Released 20.11.2009</text> <text>License serialnumber: %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 license 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>



Example for a 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 & Service GmbH Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION</text> <text>License serialnumber: %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 use bundles</text> <bundle header="Bundle" value="all"/> <totalissued header="Total Issued" value="all"/> <totalinuse header="Total license 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>



Example for a Listing of the Current Status for Standard 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 & Service GmbH Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION</text> <text>License serialnumber: %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 license 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>



Example for a 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 & Service GmbH Co. KG</text> <text>EPLAN License Manager Version %ELM_VERSION</text> <text>License serialnumber: %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 license 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 via Command Line Parameters

The "EPLAN License Monitor" program has to be installed for the evaluation through command lines. Calling is carried out using the ELMMonitor.exe file.

Parameters for the Call

/Createreport Creates the report /computertime Sets the computer time /Silent No messages are displayed /Servername:Computer Computer name on which the ELM is running /Xmlfile:c:\*.xml Contents for the evaluation

/From:10.09.2009 00:00:00 Start date of the evaluation /To: 12.09.2009 00:00:00 End date of the evaluation Instead of /From and /To the following can be used: /Lastdays:01 Number of logged days /Lasthours:01 Number of logged hours /Readdirect Reads the RLOG file immediately /Elmpath:c:\* Reads in the directory. Use with

specification of /Readdirect.

Example

"C:\Program Files\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:\Program Files\EPLAN\ELM\ElmMonitor.exe" /Createreport /Servername:xt-eplan-1 /Xmlfile:C:\ELMXML\Elmlogfile.xml /Lastdays:10

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

EPLAN License Manager Installation Instructions - … · Introduction 6 EPLAN License Manager...

Documents

Transcript of EPLAN License Manager Installation Instructions - … · Introduction 6 EPLAN License Manager...