User Manual PLUS+1 License Administration Tool powersolutions.danfoss.com

Transcription

1 MAKING MODERN LIVING POSSIBLE User Manual PLUS+1 License Administration Tool powersolutions.danfoss.com

2 Revisions Revision History Table of Revisions Date Page Changed Rev 27 Jan, , 7-8 Minor corrections; added subsection: Access Components; BA Created table for License Information. 09 Dec, 2010 Replaces PLUS+1 License Administration Tool Manual.doc AA 2 L Rev CA Oct 2013

3 Contents Introduction About this document... 4 Overview... 4 PLUS+1 License Administration Tool... 4 PLUS+1 License... 4 PLUS+1 Traceability... 4 Application Security Strategy PLUS+1 Security Features... 5 Toolkey... 5 Read/Write Control and Access Levels... 5 File Download... 5 PLUS+1 GUIDE Access Components... 6 License Start/Expiry Dates... 6 PLUS+1 Security Strategy... 6 PLUS+1 License Level Settings... 6 PLUS+1 License Terminology PLUS+1 License Administration Tool License... 7 License Information... 7 Using the PLUS+1 License Administration Tool Installation... 9 Creating Licenses Overview... 9 Creating New License... 9 Editing Existing License Copying Existing License Deactivating or Activating License Finding User Importing 4.x Licenses Exporting License Data L Rev CA Oct

4 Introduction About this document This document assumes knowledge of the PLUS+1 concept and some understanding of the operation of the PLUS+1 GUIDE and Service Tool. This document provides: y An overview of the use of the PLUS+1 License Administration Tool. y An overview of the PLUS+1 License and how security can be used. y Details of how to use the PLUS+1 License Administration Tool. y Further PLUS+1 information can be found at: Overview PLUS+1 License Administration Tool The PLUS+1 License Administration Tool allows licenses to be created and managed for the PLUS+1 Service Tool. The PLUS+1 License Administration Tool is itself licensed. This license determines how many Service Tool licenses to be created and managed in the License Administration Tool. It is possible to have several PLUS+1 License Administration Tool licenses which extends the number of licenses that can be created and managed. PLUS+1 License The PLUS+1 License is used to control security to PLUS+1 applications and provides traceability of changes to applications. For example; the license can give the user different access levels to control what variable and parameters can be read or written to using the PLUS+1 Service Tool. PLUS+1 Traceability The public PLUS+1 Service Tool includes a license embedded in the installation that has the same ID for all users. The PLUS+1 License Administration Tool allows unique ID to be assigned to each user license. With a unique license ID the History Log in the PLUS+1 hardware will record: y Who The License ID y When y What Date of action (from PC clock) Performed action: Changes to an application. Compiling an application. Download to hardware Adjusting application parameters in hardware. Reading data from the hardware. 4 L Rev CA Oct 2013

5 Application Security Strategy PLUS+1 Security Features PLUS+1 allows many alternative methods for the control, deployment and life cycle management of applications in support of IEC None of the features are required to be used. However, if they have to be used, then it is helpful to develop a company wide strategy. This section describes the PLUS+1 features that are available and some questions that should be considered. Toolkey It is possible to provide a prevent access to PLUS+1 applications unless a user has the correct password or toolkey. The toolkey is a security code that is assigned to an application when it is created in the PLUS+1 GUIDE. To allow the PLUS+1 Service Tool access to an application, the toolkey must be known. The toolkey security code can be provided to the PLUS+1 Service Tool in one of three methods: y Embedded in the users PLUS+1 license. y Embedded in the PLUS+1 Service Tool application (P1D) file. y Entered manually by the user into the PLUS+1 Service Tool. The first two methods are preferred as the user does not need to know the toolkey. Therefore, toolkey security code would not be shared with unauthorized persons. A PLUS+1 license may contain up to three toolkeys. The default state of the toolkey in an application is blank. Therefore, it is possible for anyone with a PLUS+1 license to access an application and make changes to parameters and read signal values. Once the toolkey has unlocked an application then the further access control mechanisms may be used as described below. Read/Write Control and Access Levels Without the use of a toolkey in a PLUS+1 application any further restriction or security is meaningless. Read/write access is controlled independently, and groups of access can be disabled globally. When a group is enabled, access is then controlled by the access level. A number between 0 and 9. 0 is the highest access level, 9 is the most restrictive. The application developer will determine and program the access level for every signal and parameter in the PLUS+1 GUIDE. The users access level is determined by the PLUS+1 license. For example, a user might have inclusive access rights between 6 and 9, if the developer were to give a signal an access level of 5, the signal would not be viewable by the user. If the user has inclusive access rights between 0 and 5, the signal would be viewable by the user. File Download The PLUS+1 License can control if applications can be downloaded to PLUS+1 hardware. Details regarding license information and security settings, see PLUS+1 License Terminology, page 7 through 8. L Rev CA Oct

6 Application Security Strategy PLUS+1 Security Features (continued) PLUS+1 GUIDE Access Components Access components used in a GUIDE application will override the access rights defined in the license. License Start/Expiry Dates A PLUS+1 license can optionally be made to operate between the Start Date and the Expiry Date. Once a license has expired it cannot be reactive, it must be reissued with a new expiry date. It is possible for a PC to have several licenses loaded and available for use but only one PLUS+1 license can be active at a time. It is possible to update a user for one specific day to allow an unusual task to be conducted with a higher or different access level, or perhaps a different toolkey. After this time the special license would be no longer valid and the user would return to their original license. PLUS+1 Security Strategy When developing a company wide security strategy for PLUS+1 applications consider: y Is a security code required or should anybody, including competitors, be allowed to access applications? y Is a company wide toolkey, or a machine family or machine specific toolkey to be used? y Is a specific toolkey being used for a released development project? y Does everyone, including developers, production, service, distributors, and end users, require the same access levels to an application to read and write parameters? y Do different groups of people with different access levels need to be further divided into subgroups, even on a temporary bases, such as, when using the expiry date feature? PLUS+1 License Level Settings Parameter Full PLUS+1 GUIDE development / Service Tool design PLUS+1 Service Tool only Create Service P1D File Enabled Disabled Read Access Enabled Enabled Read Access Level 0 5 Write Access Enabled Enabled Write Access Level 0 5 Download Application Enabled Enabled Download Parameter File Enabled Enabled Read ECU History Enabled Enabled Application Log Access Enabled Disabled App Log Statistics Access Level 0 N/A App Log Errors Access Level 0 N/A App Log Others Access Level 0 N/A Danfoss reserves the right to change these settings at anytime without notice. 6 L Rev CA Oct 2013

7 PLUS+1 License Terminology PLUS+1 License Administration Tool License The PLUS+1 License Administration Tool license determines the number of licenses that can be created using the license administration tool. It is possible to use multiple licenses with the tool so the number of licenses managed can be extended at any time License Information Callout Item Description 1 License ID This cannot be changed and is provided for information only. ID is generated automatically by the license administration tool. 2 Sub ID This cannot be changed and is provided for information only. ID is generated automatically by the license administration tool. 3 License Expires Start Date This is the date from which the license will be active. The default is today. Values can be set in the future so that a license will only become active from the future date. Expire Date This is the date from which the PLUS+1 License will no longer work. 4 Download Application Files If this box is unchecked then the user will not be able to download an application to any hardware. If this box is checked then the user will be able download an application to hardware. L Rev CA Oct

8 PLUS+1 License Terminology License Information (continued) Callout Item Description 5 Download Read Only Parameter Files PLUS+1 Parameter Files are used to store Read Only parameter values that are used by an application. If this box is unchecked then the user will not be able to download a parameter file to any hardware. If this box is checked then the user will be able download a parameter file to hardware. 6 Access Level The Access Level is a number between 0 and 9. The highest level of access is zero and the most restrictive is 9. The application developer determines the access level for every signal and parameter in the PLUS+1 GUIDE. If a signal is given an access level of 5 and the user has an access level of 6, 7, 8 or 9 then the user will not be able to see the signal. If the user has an access level between 0 and 5 then the signal can be viewed. Read Access Checkbox If this box is unchecked then the user will not be able to read any signals or parameters from any hardware. If this box is checked then the user can read signals given the relevant access level. Read Access Level Sets the read access level for this license. Write Access Checkbox If this box is unchecked then the user will not be able to write any parameters from any hardware. If this box is checked then the user can write signals given the relevant access level. Write Access Level Sets the write access level for this license. 7 ECU History Access If this box is unchecked then the user will not be able to read the ECU history. 8 Application Log Access If this box is unchecked then the user will not be able to read any Application Log files from any hardware. Error Level Sets the application log error access level for this license. Statistics Level Sets the application log error access level for this license. Other Level Sets the application log error access level for this license. 9 Toolkey Clicking the Toolkey button opens the dialog where a toolkey together with a text description may be added. Up to three toolkeys can be added to the license. See the Application Security Strategy, page 5 through 6, for further details on the use of the toolkey and access levels. Toolkey Only If this box is checked then the user will only be able to access hardware running PLUS+1 applications with toolkey. 10 Activate/Deactivate Toolbar Button This is used to make a license active or inactive. When licenses are no longer needed it is not desirable to delete them from there database, as the trace information will be lost. 11 Optional User Information This optional user information can be used by the License Administrator to ease the management of licenses. The information is not included in the license key: Company This is the name of the company the user belongs to. The data is taken from the user ID file but it can be amended when the license is created. First Name/Last Name This is the name of the user. The data is taken from the user ID file but it can be amended when the license is created. Street / City / State / ZIP / This is the address of the user. Country This is the address of the user. 8 L Rev CA Oct 2013

9 Using the PLUS+1 License Administration Tool Installation Run the PLUS+1 License Administration Tool installation program. 1. Start the tool by clicking on the PLUS+1 License Administration Tool icon. 2. A message box appears with the option to launch the License Manager. 3. The License Manager can also be launched from the Tools menu. 4. Click Help in the License Manager for information on how to install and activate your license. Creating Licenses Overview It is recommended that the PLUS+1 License Terminology, page 7 through 8 of this document be reviewed before proceeding with the following lessons. Creating New License 1. Click the New button on the toolbar of License Manager. 2. Amend the Start date and Expire date as required. Uncheck License Expires to make the license perpetual. L Rev CA Oct

10 Using the PLUS+1 License Administration Tool Creating New License (continued) 3. Set the security settings appropriately. 4. Enter optional user information. 5. If a toolkey has to be entered click the Toolkey button to open the dialog screen: 6. Click the Add button to add a Key together with a Description to make the management of the toolkeys easier. Then click OK. 7. Click the Save button on the toolbar to save the license file into the license database. 8. The license key is available in the license key field. Click Copy To Clipboard to copy the license key to the Windows clipboard. Editing Existing License 1. Select the license to be edited in the License Manager list box. 2. Click the Edit button on the toolbar. 3. Make any necessary changes to the license. 4. When the changes are complete click the Save button on the toolbar. 5. The license key is available in the license key field. Click Copy To Clipboard to copy the license key to the Windows clipboard. Copying Existing License 1. Select the license to be copied in the License Manager list box. 2. Click the Copy button on the toolbar. 3. Follow the procedure for Creating New PLUS+1 License, page 9 through L Rev CA Oct 2013

11 Using the PLUS+1 License Administration Tool Deactivating or Activating License 1. Select the License Manager list box. 2. Click the Deactivate/Activate button on the toolbar. Finding User 1. Click the Find User button on the toolbar. 2. Enter filter information and the Search results will be updated automatically. 3. Select a license under Search results and click OK to jump to the license. Importing 4.x Licenses 1. Select Tools/Import 4.x licenses from the PLUS+1 License Administration Tool menu. 2. Make a backup of license database in the installation folder as needed and click OK to continue. L Rev CA Oct

12 Using the PLUS+1 License Administration Tool Importing 4.x Licenses (continued) 3. Click Browse and select the location of the 4.x License Administration Tool folder. 4. Check Import expire dates to import start and expire dates for 4.x Licenses. Leave this setting unchecked to import the licenses without an expiry date. 5. Click OK to start the import. Exporting License Data 1. Select Tools/Export License Data in the menu to export license data to a CSV file. 2. Select which data fields to include in the export file. 3. Select the delimiter for the CSV file. 4. Click OK to continue. 5. Select a filename for the export file. 6. Click OK to start the export. 12 L Rev CA Oct 2013

13 Notes L Rev CA Oct

14 Notes 14 L Rev CA Oct 2013

15 Notes L Rev CA Oct

16 Products we offer: Bent Axis Motors Closed Circuit Axial Piston Pumps and Motors Displays Electrohydraulic Power Steering Electrohydraulics Hydraulic Power Steering Integrated Systems Joysticks and Control Handles Microcontrollers and Software Open Circuit Axial Piston Pumps Orbital Motors PLUS+1 GUIDE Proportional Valves Sensors Steering Transit Mixer Drives Danfoss Power Solutions is a global manufacturer and supplier of high-quality hydraulic and electronic components. We specialize in providing state-of-the-art technology and solutions that excel in the harsh operating conditions of the mobile off-highway market. Building on our extensive applications expertise, we work closely with our customers to ensure exceptional performance for a broad range of off-highway vehicles. We help OEMs around the world speed up system development, reduce costs and bring vehicles to market faster. Danfoss Your Strongest Partner in Mobile Hydraulics. Go to for further product information. Wherever off-highway vehicles are at work, so is Danfoss. We offer expert worldwide support for our customers, ensuring the best possible solutions for outstanding performance. And with an extensive network of Global Service Partners, we also provide comprehensive global service for all of our components. Please contact the Danfoss Power Solution representative nearest you. Comatrol Schwarzmüller-Inverter Turolla Valmova Hydro-Gear Daikin-Sauer-Danfoss Local address: Danfoss Power Solutions US Company 2800 East 13th Street Ames, IA 50010, USA Phone: Danfoss Power Solutions GmbH & Co. OHG Krokamp 35 D Neumünster, Germany Phone: Danfoss Power Solutions ApS Nordborgvej 81 DK-6430 Nordborg, Denmark Phone: Danfoss Power Solutions 22F, Block C, Yishan Rd Shanghai , China Phone: Danfoss can accept no responsibility for possible errors in catalogues, brochures and other printed material. Danfoss reserves the right to alter its products without notice. This also applies to products already on order provided that such alterations can be made without subsequential changes being necessary in specifications already agreed. All trademarks in this material are property of the respective companies. Danfoss and the Danfoss logotype are trademarks of Danfoss A/S. All rights reserved. L Rev CA Oct Danfoss A/S,