Sparx Systems Keystore Service
Contents
1. Now listening for connections SYSTEM Client connected from 172 16 17 96 SYSTEM SUCCESS Client from 172 16 17 96 authenticated User Name mfreser Product Sparx Systems Enterprise Architect build 854 SYSTEM Client disconnected from 172 16 17 96 SYSTEM Client connected from 172 16 17 96 SYSTEM SUCCESS Client from 172 16 17 96 authenticated User Name mfraser Product Sparx Systems Enterprise Architect build 854 INFO CHECKOUT SUCCESS mfraser Sparx Systems Enterprise Architect build 854 M a0 m 2 EA Ultimate Edition MFRASERO3 n SYSTEM SUCCESS Checked out EA Ultimate Edition key for MFRASEROS mfraser SYSTEM Client disconnected from 172 16 17 96 SYSTEM Client connected from 172 16 17 96 SYSTEM SUCCESS Client from 172 16 17 96 authenticated User Name mfreaser Product Sparx Systems Enterprise Architect build 654 INFO CHECKIN SUCCESS mfraser Sparx Systems Enterprise Architect build 654 API SETI MENSE EA Ultimate Edition SYSTEM SUCCESS Client at 172 16 17 96 checked in key SL SE Ps SYSTEM Client disconnected from 172 16 17 96 Sparx Systems Keystore Service User Guide Troubleshooting 8 Troubleshooting The best source of troubleshooting information can be found in the Sparx Systems Keystore Service log files 2A The log file location and level of detail are configured through the configuration A file Itis recommended that for trouble shooting the LOG_LEVEL pro2. Migrate To menu option The Migrate Keystore File dialog displays with the local keystore file path in the Source field 2005 2012 Sparx Systems Pty Ltd 25 Keystore Service Administration Migrate Shared Keys From File Based Keystore Migrate Keystore File The keystore migration process allows you to transfer keys from a file based keystore to a service based keystore NOTE All keys will be removed from the source keystore once the transfer is complete Source C temp sskeys dat Destination ssks mfraser03 Alternatively to display this dialog click on the Migrate key store icon in the toolbar or right click in the Key Stores panel and select the Migrate to context menu option Click on the button to the right of the Destination field and browse for the name of the network based keystore into which the shared keys are to be transferred Click on the OK button to migrate the shared keys from the source file based keystore to the target service based keystore Sparx Systems Keystore Service User Guide Keystore Service Administration Release Shared Keys 26 5 5 Release Shared Keys Itis usually not necessary to manually release a shared key from a workstation as this happens automatically if e The keystore s AutoCheckin 2 option has been enabled and you close all running instances of Enterprise Architect on your workstation e The lease on the key expires However if further users want to acce
3. The user failed to authenticate with the keystore as they provided a Authenticate failed due to password that did not match the server password specified in the an invalid password configuration property AUTHMETHOD_OPTIONS Ensure that the password is entered correctly passwords are case sensitive otherwise contact your Sparx Systems Keystore Service administrator for the correct password Authentication Failures Active Directory Reported Error Could not get The Active Directory authentication module failed to initialize as it could not DefaultNamingContext resolve the Default Naming Context for the current domain Ensure that the machine the Sparx Systems Keystore Service is installed on is able to contact the Active Directory domain controller and has the necessary permissions to query the domain s Active Directory Could not open root DSE The Active Directory authentication module failed to initialize as it could not open the domain s root DSA Directory Server Agent Specific Entry DSE at Idap rootDSE The root DSE entry provides information about the contents and capabilities of the Active Directory domain controller Ensure that the machine the Sparx Systems Keystore Service is installed on is able to contact the Active Directory domain controller and has the necessary permissions to query the domain s Active Directory Could not initialize the Active The Active Directory authentication module failed to initialize a
4. lt Services Console Windows 11 Shared Key Store Selection Dialog 20 Shared Keys Assign To Workstation 28 Using 28 Software Product License Agreement 4 Sparx Systems Key Store Dialog 19 Sparx Systems Keystore Service Assign Key To Workstation 28 Sparx Systems Keystore Service Configure 12 Copyright Notice 3 End User License Agreement 4 Install 9 Introduction 2 License Agreement 4 Online User Guide 2 Options Dialog 22 Properties 12 Restart 11 Select Feature 9 Set Auto Checkin 22 Set Issue Period 22 Software Product License Agreement 4 Stat 11 Stop 11 Support 7 User Feedback 8 Using Shared Keys 28 Sparx Systems Keystore Services Activity Logs 29 Add Shared Keys To Keystore 21 Administration 19 Authentication Failures Active Directory 30 Authentication Failures Global Password 30 Checkin Failures 30 Checkout Failures 30 Connect To Local Keystore 24 Connect To Remote Keystore 20 Delete Shared Keys 27 Initialization Failures 30 Migrate Keys Between Keystores 24 Release Shared Keys 26 Troubleshooting 30 SSKS Introduction 2 Online User Guide 2 Support For Registered Users 7 Oy fie Troubleshooting Authentication Failures Active Directory 30 Authentication Failures Global Password 30 Checkin Failures 30 Checkout Failures 30 Initialization Failures 30 U User Feedback User Forum 7 W Workstation Assign Key To 8 28 2005 2012 Sparx Systems Pty Ltd Sparx Systems Keystore Service
5. Key cccicscccccetsscstecssc cece cece eet NENNE EAREN EEEE ka aeeeetiiaceetel 26 Delete Shared Key wiscccsssecccessseiseces ssaceccsssesdeesicececesssesecessseecccisneeeeesisececesisesteeisneseeuizeeeees 27 Configure Enterprise Architect to Acquire Keys From Keystore 28 Activity Logs 29 Troubleshooting 30 Index 33 2005 2012 Sparx Systems Pty Ltd 1 Foreword Foreword The Sparx Systems Keystore Service is used to manage the registration keys issued with the Floating Licenses purchased for Enterprise Architect Corporate Business and Software Engineering Systems Engineering and Ultimate editions and for related MDG products Sparx Systems Keystore Service User Guide Introduction 2 1 Introduction The Sparx Systems Keystore Service SSKS helps you to manage the use of registration keys issued with the Floating Licenses purchased for Enterprise Architect Corporate Business amp Software Engineering Systems Engineering and Ultimate editions and for related MDG products Using the Sparx Systems Keystore Service application an administrator can create a key store in a network file location that enables licenses with a finite administrator defined issue period to be assigned to specific workstations The key store also enables the administrator to quickly determine which user has a particular key and to see the date on which the key expires Note Each Enterprise Architect workstation can be associated with only one k
6. have been caused directly or indirectly by this document Printed May 2012 Special thanks to All the people who have contributed suggestions examples bug reports and assistance in the development of the Sparx Systems Keystore Service The task of developing and maintaining this tool has been greatly enhanced by their contribution Contents Table of Contents Foreword 1 Introduction 2 Copyright NONGO sescdscseteci ee ccehedectccectes secede rdedactenecebedeetedectesccchades tedacievecchedectedesciercccbideeteducs 3 End User License Agreement wi cie ccctecee ccc eciee cet leneececesiee coedsaeececesees decdsneececesses connedeeceoess 4 SUPPO hoai a A E 7 Your Fee dback ccsssisccctetisccccsctavstteecceccace invested sieweteesavet tee E iR 8 Install the Keystore Service 9 Start Stop the Keystore Service 11 Configure the Keystore Service 12 Active Directory Configuration File tcsies tcdccccees execs cz ctccectavcnrceszetacecensczecedsstanecsavezees cactzateees 15 SSKS Configuration FilC seess iak RNR 17 Keystore Service Administration 19 Connect Toa Remote Keyslore erscsnnanccnmepnn aaa 20 AGO Shared Ko Scr te ctaa stadtcesece Geaceceetteeci ask aca weak bcceicat teagacaticeeitegiacatond 21 Set Issue Periods for the KeyS i0ccccccccctccecsesecsceeetscecceeesseeceeteseecesesecctestececcessssectesreceeces 22 Migrate Shared Keys From File Based Keystore cececceeeeeeeeeeeeeeeeeeeeeeseeeeeeeeeeeeeeeees 24 Release Shared
7. of the SOFTWARE PRODUCT by virtue of this EULA Your use of this software indicates your acceptance of this EULA and warranty DEFINITIONS In this End User License Agreement unless the contrary intention appears e EULA means this End User License Agreement e SPARX means Sparx Systems Pty Ltd A C N 085 034 546 e Licensee means YOU or the organization if any on whose behalf YOU are taking the EULA e SOFTWARE PRODUCT or SOFTWARE means Sparx Systems Keystore Service which includes computer software and associated media and printed materials and may include online or electronic documentation e Support Services means email based support provided by SPARX including advice on usage of Sparx Systems Keystore Service investigation of bugs fixes repairs of models if and when appropriate and general product support e SPARX support engineers means employees of SPARX who provide on line support services GRANT OF LICENSE In accordance with the terms of this EULA YOU are granted the following rights a To install and use one copy of the SOFTWARE PRODUCT or in its place any prior version for the same operating system on a single computer As the primary user of the computer on which the SOFTWARE PRODUCT is installed YOU may make a second copy for your exclusive use on either a home or portable computer b To store or install a copy of the SOFTWARE PRODUCT on a storage device such as a network server used only to ins
8. the group specified in the configuration property AUTHMETHOD_OPTIONS The user name requesting to authenticate with the keystore could not be found on the domain Add the user to domain 2005 2012 Sparx Systems Pty Ltd 33 Index Index oe Activity Logs 29 Add Keys Dialog 21 Add Shared Keys 21 Assign Key To Workstation 28 Authentication Failures Active Directory 30 Authentication Failures Global Password 30 Auto Checkin Option 22 C Checkin Failures 30 Checkout Failures 30 Compiled 19 March 2010 2 Configure Keystore Service Properties 12 Copyright Notice 3 D Delete Shared Keys 27 ces End User License Agreement 4 F Floating License Editions of Enterprise Architect 2 MDG Products 2 Initialization Failures 30 Install Sparx Systems Keystore Service 9 Introduction License Agreement 4 Support 7 To Sparx Systems Keystore Service 2 Issue Period 22 Sparx Systems Keystore Service User Guide K Keys Assign To Workstation 28 Expire After 22 For Floating Licenses 28 Lease Expiry 22 Register Product Key In Enterprise Architect 28 Set Auto Checkin 22 Set Issue Period 22 Shared Using 28 Keystore Manager 19 Select Feature 9 Keystore Server Option 20 oy ee License Agreement 4 Migrate Keys To Remote Keystore 24 Migrate Keystore File Dialog 24 O Options Dialog 22 R Register 28 Product Key 28 Product Key In Enterprise Architect 28 Release Shared Keys 26
9. to Active Directory group membership the permitted group is specified bya common name in the AUTHMETHOD_OPTIONS property for example AUTHMETHOD_OPTIONS SSKS_USERGROUP Where SSKS_ USERGROUP is the Active Directory group that is authorized to use the keystore e AM_ACTIVEDIRECTORYEX Users authenticate according to Active Directory group membership the keys available to different groups is configured in the filename specified in the AUTHMETHOD_OPTIONS property for example AUTHMETHOD_OPTIONS SERVICE_PATH keystoreservice adconfig For instructions on defining this file see Active Directory Configuration File 15 AM_SSKSGROUP Users authenticate with a group name and password the groups and the keys available to each are specified in the filename specified in the AUTHMETHOD_OPTIONS property for example AUTHMETHOD_OPTIONS SERVICE_PATH keystoreservice ssksgroupconfig For instructions on defining this file see SSKS Configuration File MA The value of this property depends on the value specified in the AUTHMETHOD property above please see the description for AUTHMETHOD for more details The path to the keystore file By default the service is configured to check 2005 2012 Sparx Systems Pty Ltd 13 Configure the Keystore Service MINIMUM_EA_BUILD AUDIT_TIME_PERIOD LOG_LEVEL LOG_DIRECTORY LOG_HALECOUNT keys in and out from the sskeys daftfile located in the installer directory Note The
10. user the service is set to run as must be granted read write permissions to the keystore file specified by KEYSTORE_PATH If a service is setto run as the user LOCALSYSTEM it generally has read write access to its installation directory The minimum build of Enterprise Architect that can be serviced by the keystore You can use this keystore server setting to deny older builds of Enterprise Architect the shared keys from this keystore The time period in seconds to wait between logging audit reports Audit reports are logged at the INFO level To turn auditing off set this property to 0 zero The level of messages that are written to the log file Higher log levels include messages from the lower levels that precede them Valid log levels from lowest to highest are FATAL Events that result in termination of the service s execution WARNING Events outside the normal scope of the service s operation but that are not fatal such as a wrong password supplied by a client REPORT Events generated by the keystore s internal auditing mechanism INFO Events generated within the normal scope of the service s operation Such as key checkin and checkout SYSTEM Detailed system level events Such as client connection disconnection and service module startup The path to which the log files are written Notes e This directory must already exist at service start time e The user the service is set to run a
11. 1 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 2010 03 2010 03 2010 03 11 2010 03 11 2010 03 11 2010 03 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 18 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 11 15 29 16 15 29 16 15 29 16 15 29 16 15 29 16 15 29 16 15 29 16 15 29 16 15 29 23 15 29 23 15 29 23 18 29 23 15 29 23 INFO HHFHTTFEHHTTEH TEE H TTT ERTT Ee T TTR TSE TEETH TT TERT Te HTT ETT HHH INFO Sparx Systems Keystore Service 4 INFO 8 SSHdSSEEHSSES HASSLE RSSELTSES HR SSS ERASE HASSLE HASSE ASSE EASES ERAS SEH ESSE EES INFO Protocol Version 1 0 4 INFO Start Time 2010 03 11 15 29 11 4 INFO Operating System Windows 6 01 4 INFO INFO Service Path C EA Addins SparxServices Current Debug INFO Logging Dir C EA Addins SparxServices Current Debug Logs INFO HHFEEHAFSERHTSERHTFESEATSEEATSESHTISERHTSELHTAEE CHASER RATER HAASE ERASER RATE HHA INFO 4 Starting up SYSTEM SUCCESS Started GlobelPassword Authentication Module SYSTEM SUCCESS Started AuthenticetionMenager SYSTEM SUCCESS Started keystore manager SYSTEM SUCCESS Management thread started SYSTEM SUCCESS Bound and listening on port 7771 SYSTEM SUCCESS Socket acceptor thread started INFO
12. ENT Product BusinessSuite Academic false Limit 10 END ENTITLEMENT END GROUP The properties belonging directly to a group are described below The common name of the Active Directory group NamingContext The LDAP path that represents the container that the group resides in leave blank to use the domain s default naming context IsManager Specifies whether members ofthis group are permitted to perform management operations such as add remove keys on the keystore Within each group a list of entittements may also be defined between ENTITLEMENT and END ENTITLEMENT as shown in the example above The properties belonging to an entitlement are described below The name ofthe product that this entitlement gives access to for users of this group Available strings are UltimateSuite Business Suite RealTimeSuite Corporate Professional Desktop Sparx Systems Keystore Service User Guide Configure the Keystore Service Active Directory Configuration File 6 VSIntegration MDGLinkVS Eclipselntegration MDGLinkEclipse MDGDoors MDGSys ML MDGDDS MDGZachman MDGUPDM MDGTogaf MDGRealTime MDGCodeAnalysis TCSElIntegration TCSESuite RaQuest Determines if this group should be given academic keys Limit Optionally restrict they number of keys of this type available to this group toa subset of the keys available in the keystore 2005 2012 Sparx Systems Pty Ltd 7 Configure the Keystore Service SSKS C
13. ENTERPRISE ARCHITECT Sparx Systems Keystore Service SSKS User Guide This booklet describes the Sparx Systems Keystore Service facilities for Enterprise Architect The Sparx Systems Keystore Service is used to manage the registration keys issued wth the Floating Licenses purchased for Enterprise Architect Corporate Business amp Software Engineering Systems Engineering and Ultimate editions and for related MDG products Sf SYSTEMS Copyright 2005 2012 Sparx Systems Pty Ltd Sparx Systems Keystore Service User Guide 2005 2012 Sparx Systems Pty Ltd All rights reserved No parts of this work may be reproduced in any form or by any means graphic electronic or mechanical including photocopying recording taping or information storage and retrieval systems without the written permission of the publisher Products that are referred to in this document may be either trademarks and or registered trademarks of the respective owners The publisher and the author make no claim to these trademarks While every precaution has been taken in the preparation of this document the publisher and the author assume no responsibility for errors or omissions or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to
14. KS Configuration File Business Suite RealTimeSuite Corporate Professional Desktop VSIntegration MDGLinkVS Eclipselntegration MDGLinkEclipse MDGDoors MDGSys ML MDGDDS MDGZachman MDGUPDM MDGTogaf MDGRealTime MDGCodeAnalysis TCSElIntegration TCSESuite RaQuest Determines if this group should be given academic keys Limit Optionally restrict they number of keys of this type available to this group toa subset of the keys available in the keystore 2005 2012 Sparx Systems Pty Ltd 2 Keystore Service Administration 5 Keystore Service Administration The management of shared keys within a keystore is performed through the Keystore Manager application which operates through the Sparx Systems Key Store dialog File Key Tools Help ty fa ali A Key Stores File Path Key Count Keys contained in this store Key Assigned To To manage a remote keystore you must first connectl 20 the application to it and to any number of other remote keystores as required The Keystore Manager then enables you the administrator to e Add Shared Keys 2T e Setlssue Periods for Shared Keys 2A e Migrate Shared Keys from a Legacy File Based Keystore PA e Release Shared Keys 26 e Delete Shared Keys 2 Sparx Systems Keystore Service User Guide Keystore Service Administration Connect To a Remote Keystore 5 1 Connect To a Remote Keystore To connect to a remote ke
15. User Guide www sparxsystems com
16. ase Services Enables acc Manual Local Service C4 UPnP Device Host Allows UPn Manual Local Service Gh User Profile Service This service Started Automatic Local System Virtual Disk Provides m Manual Local System Extended Standard Locate the Sparx Systems Keystore Service entry in the Services console and start stop or restart it through the console toolbar buttons or context menu options Sparx Systems Keystore Service User Guide Configure the Keystore Service 12 4 Configure the Keystore Service When starting up the Sparx Systems Keystore Service scans its installation directory for the file keystoreService config which contains a list of properties and values used to configure the server The properties and their descriptions are provided below Property SERVER_PORT AUTHMETHOD AUTHMETHOD_OPTIONS KEYSTORE_PATH The TCP IP port on which the service is configured to listen for incoming connections By default the Sparx Systems Keystore Service is configured to run on port 7770 The method used to authenticate Keystore Service users connecting to the service The value of this method affects how the property AUTHMETHOD_OPTIONS is interpreted below Valid AUTHMETHOD values are e AM_GLOBALPASSWORD Users authenticate with a single global password the password is specified in the AUTHMETHOD_OPTIONS property and can be left blank e AM_ACTIVEDIRECTORY Users authenticate according
17. cess the Services console either through the Control Panel under Administrative Tools or by running the command ser vi ces msc from the command line File Action View Help e 00E oi3 Gm gt in Services Local Sparx Systems Keystore Service Name a Description Status Startup Type Log On As C Software Protection Enables the Automatic D Network Service dealer s Keysi Automatic Local System SEENTE RE T SPP Notification Service Provides So Manual Local Service Ch SQL Server SQLEXPRESS Provides sto Started Automatic Network Service Ci SQL Server Active Directory Helper Enables inte Disabled Network Service C SQL Server Browser Provides SQ Disabled Network Service TE SQL Server VSS Writer Provides th Started Automatic Local System Sh SSDP Discovery Discovers n Started Manual Local Service Oe Storage Service Enforces gr Manual Local System G Superfetch Maintains a Started Automatic Local System System Event Notification Service Monitors sy Started Automatic Local System S Tablet PC Input Service Enables Tab Manual Local System G4 Task Scheduler Enables aus Started Automatic Local System A TCP IP NetBIOS Helper Provides su Started Automatic Local Service Oy Telephony Provides Tel Manual Network Service Sh Themes Provides us Started Automatic Local System Thread Ordering Server Provides or Manual Local Service Ci TPM B
18. ey store ata time See Also e Copyright Notice 34 e End User Licensing Agreement 44 e Support 7 e Your Feedbackl 8 e Install the Keystore Servicel 9 e Start Stop the Keystore Service e Configure the Keystore ServicehA e Sparx Systems Keystore Service Administration A e Configure Enterprise Architect to Acquire Keys from Keystore 28 e Activity Logs 2A e Troubleshooting 30 2005 2012 Sparx Systems Pty Ltd 3 Introduction Copyright Notice 1 1 Copyright Notice Copyright 1998 2012 Sparx Systems Pty Ltd All rights reserved The software contains proprietary information of Sparx Systems Pty Lid It is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law Reverse engineering of the software is prohibited Please read the license agreement 4 for full details Due to continued product development this information can change without notice The information and intellectual property contained herein is confidential between Sparx Systems and the client and remains the exclusive property of Sparx Systems If you find any problems in the documentation please report them to us in writing Sparx Systems does not warrant that this documentis error free No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or by any means electronic mechanical photocopying recording or otherwise without the prior written perm
19. ission of Sparx Systems Licensed users are granted the right to print a single hardcopy of the user manual per licensed copy of the software but may not sell distribute or otherwise dispose of the hardcopy without written consent of Sparx Systems Sparx Systems Pty Ltd 7 Curtis St Creswick Victoria 3363 AUSTRALIA Phone 61 3 5345 1140 Fax 61 3 5345 1104 Support Email support sparxs ystems com Sales Email sales sparxsystems com Website www sparxsystems com Sparx Systems Keystore Service User Guide Introduction End User License Agreement 4 1 2 End User License Agreement Sparx Systems Keystore Service SSKS Copyright C 1998 2012 Sparx Systems Pty Ltd All Rights Reserved IMPORTANT READ CAREFULLY This End User License Agreement EULA is a legal agreement between YOU as Licensee and SPARX for the SOFTWARE PRODUCT identified above By installing copying or otherwise using the SOFTWARE PRODUCT YOU agree to be bound by the terms of this EULA If YOU do not agree to the terms of this EULA promptly return the unused SOFTWARE PRODUCT to the place of purchase for a full refund The copyright in the SOFTWARE PRODUCT and its documentation is owned by Sparx Systems Pty Ltd A C N 085 034 546 Subject to the terms of this EULA YOU are granted a non exclusive right for the duration of the EULA to use the SOFTWARE PRODUCT YOU do not acquire ownership of copyright or other intellectual property rights in any part
20. keys in the key store Click on the OK button to confirm your selection This acts against the purpose of having the checkbox It is therefore advisable to create two key stores each with a different setting for Auto checkin 2005 2012 Sparx Systems Pty Ltd 23 Keystore Service Administration Set Issue Periods for the Keys Mobile users who want to use Enterprise Architect from home or other Not selected disconnected locations Fixed users who leave their computers at work Selected Ifa user has a key with no automatic check in they then have use of the key for a theoretically unlimited time However the Sparx Systems Keystore Service also enables an administrator to limit use by setting an issue period for the keys in the key store The period is counted as continuous time spent away from the network connection to the key store The issue period can be setin either weeks or days For example if a user has a license with an issue period of one week and is away from an active connection to the key store for more than one week they cannot use Enterprise Architect until they obtain another key To set the issue period for the keys in the key store e In the first Keys leases expire after field type the required number of units in the second field click on the drop down arrow and select the unit Days or Weeks Click on the OK button to confirm your selection Sparx Systems Keystore Service User Guide Keystore Service Adminis
21. ll perform substantially in accordance with the accompanying written materials for a period of ninety 90 days from the date of receipt and any Support Services provided by SPARX shall be substantially as described in applicable written materials provided to YOU by SPARX and SPARX support engineers will make com mercially reasonable efforts to solve any problems associated with the SOFTWARE PRODUCT EXCLUSIONS To the maximum extent permitted by law SPARX excludes for itself and for any supplier of software incorporated in the SOFTWARE PRODUCT all liability for all claims expenses losses damages and costs made against or incurred or suffered by YOU directly or indirectly including without limitation lost costs profits and data arising out of e YOUR use or misuse of the SOFTWARE PRODUCT e YOUR inability to use or obtain access to the SOFTWARE PRODUCT e Negligence of SPARX or its employees contractors or agents or of any supplier of software incorporated in the SOFTWARE PRODUCT in connection with the performance of SPARX obligations under this EULA or e Termination of this EULA by either party for any reason LIMITATION The SOFTWARE PRODUCT and any documentation are provided AS IS and all warranties whether express implied statutory or otherwise relating in any way to the subject matter of this EULAor to this EULA generally including without limitation warranties as to quality fitness merchantability correctness accu
22. onfiguration File 4 2 SSKS Configuration File When using the AM_SSKSGROUP authentication method an additional configuration file is specified by the AUTHMETHOD_ OPTIONS property This file defines any number of groups and the permissions that each group receives Each group is defined between GROUP and END GROUP as shown in the example below GROUP Name International Robotics Convention 2012 UserName robot2012 Password danger StartDate 2012 03 01 EndDate 2012 03 31 ENTITLEMENT Product RealTimeSuite Academic false END ENTITLEMENT END GROUP The properties belonging directly to a group are described below Afriendly name for this group The username that needs to be appended to the connection string when connecting as a member of this group The password to connect to the keystore with this group SiartDate Optionally restrict access for this group to be allowed only after the given date Specified as YYYY MM DD EndDate Optionally restrict access for this group to be allowed only before the given date Specified as YYYY MM DD Within each group a list of entitlements may also be defined between ENTITLEMENT and END ENTITLEMENT as shown in the example above The properties belonging to an entitlement are described below The name ofthe product that this entitlement gives access to for users of this group Available strings are e UltimateSuite Sparx Systems Keystore Service User Guide Configure the Keystore Service SS
23. perty be set to the highest level SYSTEM so that the greatest amount of information is available to the administrator Initialization Failures Reported Error Could not open keystore at FilePath The file does not exist and could not be created Could not open keystore no keystore file specified Invalid or missing keystore file Keystore file cannot be opened by this version of the service or the file has been corrupted Key file has been moved Checkout Failures Reported Error There are no more available keys for this product in the key store The key store does not contain any keys for this product The service was unable to open the keystore file specified by the KEYSTORE_PATH property in the configuration file Ensure that this path exists and that the user account the Sparx Systems Keystore Service runs under has the necessary permissions to read and write to the file No file path was specified in the property in the configuration file Type a file path into the KEYSTORE_PATH configuration property that the user account the Sparx Systems Keystore Service runs under can read and write to The keystore file specified by the configuration property KEYSTORE_PATH is either incompatible with the current version of the keystore service or has somehow been corrupted on the file system Restore the keystore file specified in the configuration property KEYSTORE_PATH from a recent backup or contact Spar
24. ption The Options dialog displays Keystore Options Keystore ssks mfraser03 Key leases expire after 1l Days Auto checkin m Alternatively to display this dialog right click on the keystore name in the Key Stores panel and select the Options context menu option When most people close Enterprise Architect they no longer require their license Therefore there is little pointin continuing to allocate the license to a user who is not actually using Enterprise Architect e On the Options dialog you select the Auto checkin checkbox so that any license in the key store is automatically returned to the key store when the user closes Enterprise Architect Click on the OK button to confirm your selection When the user closes Enterprise Architect the keyis then available to the next user who wants to do some work in Enterprise Architect However a laptop user having closed Enterprise Architect might still want to use the license off site with no access to the key store and therefore no way to request another key While the laptop user can put their machine into standby or hibernate mode while leaving Enterprise Architect running there is the risk that the laptop might have to be rebooted Once Enterprise Architect restarts it will report the lack of a license the license having been automatically checked in e To enable such users to have access to Enterprise Architect you could dese ect the Auto checkin checkbox for the
25. racy reliability correspondence with any description or sample meeting your or any other requirements uninterrupted use compliance with any relevant legislation and being error or virus free are excluded Where any legislation implies in this EULA any term and that legislation avoids or prohibits provisions in a contract excluding or modifying such a term such term shall be deemed to be included in this EULA However the liability of SPARX for any breach of such term shall if permitted by legislation be limited at SPARX s option to any one or more of the following upon return of the SOFTWARE PRODUCT and a copy of the receipt e Ifthe breach relates to the SOFTWARE PRODUCT e the replacement of the SOFTWARE PRODUCT or the supply of an equivalent SOFTWARE PRODUCT e the repair of such SOFTWARE PRODUCT e the payment ofthe cost of replacing the SOFTWARE PRODUCT or of acquiring an equivalent SOFTWARE PRODUCT or e the payment ofthe cost of having the SOFTWARE PRODUCT repaired e Ifthe breach relates to services in relation to the SOFTWARE PRODUCT e the supplying of the services again or e the payment of the cost of having the services supplied again TRADEMARKS All names of products and companies used in this EULA the SOFTWARE PRODUCT or the enclosed documentation may be trademarks of their corresponding owners Their use in this EULAis intended to be in compliance with the respective guidelines and licenses Sparx Systems Keystore Ser
26. s it could not Directory COM interface open or access the Active Directory COM interface Ensure that the machine hosting the user account that the Sparx Systems Keystore Service runs under has the necessary permissions to create and communicate with the Active Directory COM interface No permitted ActiveDirectory The Active Directory authentication module failed to initialize as the group name provided in the configuration property AUTHMETHOD_OPTIONS was left blank AUTHMETHOD_OPTIONS configuration property Enter a valid Active Directory group in the AUTHMETHOD_OPTIONS property in the service configuration file or use the AM_GLOBALPASSWORD authentication module if you do not want keystore access to be restricted to a particular Active Directory group Group Group Name not The Active Directory authentication module failed to initialize as the Active found Directory group specified in the configuration property AUTHMETHOD_OPTIONS could not be resolved Sparx Systems Keystore Service User Guide Troubleshooting 32 Reported Error User User Name is not a member of any permitted groups Account name User Name not found Ensure thatthe group name specified in the configuration property AUTHMETHOD_OPTIONS exists and is spelt correctly The user failed to authenticate with the keystore as they are nota member of the Active Directory group specified in the configuration property AUTHMETHOD_OPTIONS Add the user to
27. s must be granted read write permissions to the directory specified by LOG_DIRECTORY If a service is setto run as the user LOCALSYSTEM it generally has read write access to its installation directory The number of rolling log files that the service keeps Log files are kept in First In First Out FIFO order with the oldest log file being deleted once the LOG_FILECOUNT threshold is reached Sparx Systems Keystore Service User Guide Configure the Keystore Service 4 LOG_ALESIZE The size in bytes a log file can reach before the logging framework rolls the log files over Other system level properties such as the service startup condition and service user account can be configured through the Microsoft Windows Service console See the Start Stop the Keystore Servicel1 topic for details on how to access the Service console 2005 2012 Sparx Systems Pty Ltd 15 Configure the Keystore Service Active Directory Configuration File 4 1 Active Directory Configuration File When using the AM_ACTIVEDIRECTORYEX authentication method an additional configuration file is specified by the AUTHMETHOD_OPTIONS property This file defines any number of groups and the permissions that each group receives Each group is defined between GROUP and END GROUP as shown in the example below Permissions are accumulated across all groups that a user is a member of GROUP Name human_resources NamingContext IsManager false ENTITLEM
28. se Key s menu option The License Management dialog displays 2 Click on the Add Key button the Add Registration Key dialog displays Enter Private Key Get Shared Key Name Michael Fraser Company Sparx Systems Shared Keystore ssks mfraser03 tans Selecta Product ENM 3 Select the Get Shared Key tab In the Name and Company fields type your user name and company name 5 Click on the button to the left of the Shared Keystore field and browse to the network location of the shared key store When connecting to a keystore using the AM_SSKSGROUP authentication method the user will need to append the group name they have been given to the server path in the following format ssks lt server name gt user lt user name gt 6 Inthe Select a Product field select the licensed product and then click on the OK button If keys are available one is allocated to you and you are able to continue working in Enterprise Architect If keys are not available you cannot work in Enterprise Architect and must wait until another user closes Enterprise Architect and releases their key 2005 2012 Sparx Systems Pty Ltd Activity Logs 7 Activity Logs The activity of the Sparx Systems Keystore Service is logged to file according to the options specified in the keystore configuration A The log content resembles the following 2010 03 11 2010 03 11 2010 03 11 2010 03 11 2010 03 1
29. ss Enterprise Architect and there is some technical anomaly that has prevented the return of a key you can manually release the key using the Sparx Systems Key Store dialog To release a key from active association with a particular workstation click on the keyin the Keys contained in this store panel and then select the Key Release menu option Alternatively click on the Release Key icon in the toolbar or right click on the key and select the Release context menu option 2005 2012 Sparx Systems Pty Ltd Keystore Service Administration Delete Shared Keys 5 6 Delete Shared Keys To delete a key from the keystore open the Sparx Systems Key Store dialog click on the key in the Keys contained in this store panel and then select the Key Delete menu option Alternatively click on the Delete Key icon in the toolbar or right click on the key and select the Delete context menu option Sparx Systems Keystore Service User Guide Configure Enterprise Architect to Acquire Keys From Keystore 6 Configure Enterprise Architect to Acquire Keys From Key StAKe keys are available through the purchase of floating licenses for the Corporate edition of Enterprise Architect version 4 51 or later and also the Business amp Software Engineering Systems Engineering and Ultimate editions of Enterprise Architect version 7 5 or later 1 From the workstation start Enterprise Architect and select the Help Register and Manage Licen
30. tall or run the SOFTWARE PRODUCT over an internal network If YOU want to increase the number of users entitled to concurrently access the SOFTWARE PRODUCT YOU must notify SPARX and agree to pay an additional fee c To make copies of the SOFTWARE PRODUCT for backup and archival purposes ADDITIONAL RIGHTS AND LIMITATIONS YOU hereby undertake not to sell rent lease translate adapt vary modify decompile disassemble reverse engineer create derivative works of modify sub license loan or distribute the SOFTWARE PRODUCT other than as expressly authorized by this EULA YOU further undertake not to reproduce or distribute license key codes except under the express and written permission of SPARX ASSIGNMENT YOU may only assign all your rights and obligations under this EULA to another party if YOU supply to the transferee a copy of this EULA and all other documentation including proof of ownership Your license is then terminated 2005 2012 Sparx Systems Pty Ltd 5 Introduction End User License Agreement TERMINATION Without prejudice to any other rights SPARX may terminate this EULA if YOU fail to comply with the terms and conditions Upon termination YOU or YOUR representative shall destroy all copies of the SOFTWARE PRODUCT and all of its component parts or otherwise return or dispose of such material in the manner directed by SPARX WARRANTIES AND LIABILITY WARRANTIES SPARX warrants that the SOFTWARE PRODUCT wi
31. tems com 2005 2012 Sparx Systems Pty Ltd 9 Install the Keystore Service 2 Install the Keystore Service When you purchase a floating license product that uses the Sparx Systems Keystore Service you receive an email from Sparx Systems Sales that provides e The installation instructions for the Keystore Service e The location of the installer executable file soarxkeystoreservice exe to download e The password that enables you to run the executable If you do not received the password or have lost a previous password please contact Sparx Systems Sales at sales sparxs ystems com To install the Keystore Service download and run the executable file and enter the password This installation is password protected Enter the installation password into the field below Password Cancel Note Vista Windows 7 users Please ensure that the installer is run with administrator permissions by right clicking on the SparxKeystoreService exe installer file and selecting the Run as Administrator context menu option Review the license agreement and readme information clicking on the Next button as you finish reading each document The Select Features page displays from which you select the features to install Sparx Systems Keystore Service User Guide Install the Keystore Service 0 Select Features Please select which features you would like to install Sparx Systems Keystore Service Feature Description Ke
32. the Sparx Systems Key Store dialog select the Key Add menu option The Add Keys dialog displays Add Keys to Keystore Keystore ssks mfraser03 Please enter one or more keys to be added to the shared key store One key per line Diir J bbrd ori u ihid iii i r di ri Ci e i E a Tam N 20 8 ITTE P A 0 9 F s hi i e F n i ahri Dm EPR TP TI MrS LFS miL EE ee w j g i iss hri g ihr fay t i Pel aa jni ELGE E I S LE E imn rn rn s Pig ia irei F ar Biy a g hrp p p i_lei Lar _ Ep EETL vr Alternatively to display this dialog click on the Add Key s icon in the toolbar or right click in the Keys contained in this store panel and select the Add context menu option In the text field type the keys provided by Sparx Systems one key per line Click on the OK button to register them with the keystore Sparx Systems Keystore Service User Guide Keystore Service Administration Set Issue Periods for the Keys 22 5 3 Set Issue Periods for the Keys The Sparx Systems Keystore Service helps you to e Ensure thatthe number of people using Enterprise Architect is limited to the number of floating licenses that have been purchased e Enable people to operate Enterprise Architect using a floating license while disconnected e g using a laptop computer To achieve this select the key store from the Key Stores section of the Sparx Systems Keystore Service dialog and then select the Tools Options menu o
33. tration Migrate Shared Keys From File Based Keystore EN 5 4 Migrate Shared Keys From File Based Keystore You might want to upgrade from a legacy file based keystore and migrate your keys to a new network based keystore This process effectively removes all keys from the file based keystore leaving it empty and places the keys into the network based keystore To migrate the shared keys select the File Link To menu option on the Sparx Systems Key Store dialog or use the toolbar icon or context menu option 20 and select the File Based Keystore option then browse for the local keystore and click on the OK button to connect to it The Sparx Systems Key Store dialog now resembles the following File Key Tools Help ty halk Key Stores File Path Key Count EA Ultimate Edition C temp sskeys dat 10 Type P ssks mfraser03 0 Available 10 Expired but Available 0 Checked Out 0 Total Available 10 Keys contained in this store Key Product Assigned To Lease Expires a Py Se Pel Pel EA Ultimate Edition Eia Fri 2 B EA Ultimate Edition i i Tw Me oh Li hi EA Ultimate Edition z Leg ris Pa EA Ultimate Edition Br ilis debu EA Ultimate Edition i E E m ee EA Ultimate Edition E Sa LTEN el ae EA Ultimate Edition mA ee m se EA Ultimate Edition CUUR Wen Vee MM CA Lilian t Cditinn a In the Key Stores panel click on the file based keystore path and then on the File
34. vice User Guide Introduction End User License Agreement 6 Windows Windows 98 Windows NT Windows ME Windows XP Windows Vista Windows 2000 and Windows 2003 Server are trademarks of Microsoft GOVERNING LAW This agreement shall be construed in accordance with the laws of the Commonwealth of AUSTRALIA 2005 2012 Sparx Systems Pty Ltd Introduction Support 1 3 Support Technical support for Sparx Systems Keystore Service is available to registered users Responses to support queries are sent by email Sparx Systems endeavors to provide a rapid response to all product related questions or concerns Registered users can lodge a support request by visiting http Wwww sparxsystems com registered reg_support html An online user forum is also available for your questions and perusal at http www s parxs ystems com cgi bin yabb YaBB cqi Sparx Systems Keystore Service User Guide Introduction Your Feedback 8 1 4 Your Feedback Sparx Systems likes to stayin touch with what the Sparx Systems Keystore Service users require in order to accomplish their tasks efficiently and effectively We value any suggestions feedback and comments you might have regarding this product documentation or install process You can access our online feedback pages at e www sparxsystems com bug_report htm and e www sparxsystems com feature_request htm Alternatively you can contact Sparx Systems by email at support sparxsys
35. x Systems Support for assistance The keystore file specified by the configuration property KEYSTORE_PATH is locked to the serial number of the hard drive itis created on If the keystore file is moved from this hard drive the service is unable to open it If the keystore file has been moved restore the file to its initial location Certain RAID configurations can affect how the hard drive s serial number is presented to the keystore service Thus itis recommended that you house the keystore file on a non RAID drive wherever possible Keys for this product exist however they are all checked out to other users If this error is frequently reported consider limiting the use of the product across your enterprise or purchasing more keys to meet the demand for the product This keystore does not contain keys for the requested product Keys for the product might have been provided by the keystore in the past but have since been removed Uninstall the product and return any shared keys on the client machine 2005 2012 Sparx Systems Pty Ltd 31 Troubleshooting Checkin Failures Reported Error Key not found in keystore The key being checked in has either been deleted since itwas checked out or was checked out from another keystore Ensure that users return any shared keys to the keystore they were leased from before swapping keystores Authentication Failures Global Password Reported Error GlobalPasswordAM
36. ystore select the File Link To menu option on the Sparx Systems Key Store dialog The Shared Keystore Selection dialog displays Select a Keystore File Based Keystore Keystore Location Sparx Keystore Server Server Address ssks mfraser03 Password eecccee Alternatively to display this dialog click on the Link to existing store icon in the toolbar or right click in the Key Stores panel and select the Link to context menu option Select the Sparx Keystore Server radio button to indicate that you want to connect to a remote service The File Based Keystore option is there to provide backwards compatibility with legacy file based keystores see Migrate Shared Keys from a Legacy File Based Keystore below In the Server Address field tyoe the URI to the Sparx Systems Keystore Service server If the authentication module you choose requires a password type that into the Password field To test connectivity to the server with the credentials you have entered click on the Test button If the connection fails review the address password and permissions Once the connection succeeds click on the OK button to finalize the connection to the server The Sparx Systems Key Store dialog redisplays with the path of the remote keystore in the Keystores panel 2005 2012 Sparx Systems Pty Ltd 21 Keystore Service Administration Add Shared Keys 5 2 Add Shared Keys To add shared keys to the keystore on
37. ystore Manager R G8 Entire feature will be installed on local hard drive Will be installed on local hard drive Feature will be installed when required on the local hard X Entire feature will be unavailable on your hard drive Wise Installation Wizard Fi Disk Cost Reset lt Back fomien teeerton Sparx Systems Keystore Service Enterprise Architect clients A TCP IP service that exposes shared key management functions to remote Install this feature if you would like the host machine to act as the Keystore server Keystore Manager An application that facilitates administration 14 of a remote or local keystore e g adding removing and releasing keys Install this feature if you would like to administer local or remote Sparx Systems Keystore Service keystores or legacy file based keystores from the host machine Continue through the installation prompts and screens to finalize the installation If you installed the Sparx Systems Keystore Service feature the installer attempts to start the service at the end of the installation process using the default configuration For further information on configuring the service please see the Configure the Keystore Servicel 1A topic 2005 2012 Sparx Systems Pty Ltd 11 Start Stop the Keystore Service 3 Start Stop the Keystore Service You can start and stop the Sparx Systems Keystore Service through Microsoft Windows Services console You ac
Download Pdf Manuals
Related Search