Sparx Systems Keystore Services User Guide

1 Copyright 2005-2012 Sparx Systems Pty LtdSparx Systems KeystoreService (SSKS) User GuideThis book let describes the Sparx Systems Keystore Servicefacilities for enterprise Sparx Systems Keystore Service is used to manage theregistration k eys issued with the Floating Licenses purchased forEnterprise Architect Corporate, Business & Software Engineering, Systems Engineering, and Ultimate editions, and for related rights reserved. No parts of this work m ay be reproduced in any form or by any m eans - graphic, electronic, orm echanical, including photocopying, recording, taping, or inform ation storage and retrieval system s - without thewritten perm ission of the that are referred to in this docum ent m ay be either tradem arks and/or registered tradem arks of therespective owners.

2 The publisher and the author m ake no claim to these tradem every precaution has been taken in the preparation of this docum ent, the publisher and the author assum e noresponsibility for errors or om issions, or for dam ages resulting from the use of inform ation contained in thisdocum ent or from the use of program s and source code that m ay accom pany it. In no event shall the publisher andthe author be liable for any loss of profit or any other com m ercial dam age caused or alleged to have been causeddirectly or indirectly by this docum : May 2012 Sparx Systems Keystore Service User Guide 2005-2012 Sparx Systems Pty LtdPublisherSpecial thanks to:All the people who have contributed suggestions, examples, bugreports and assistance in the development of the Sparx SystemsKeystore Service.

3 The task of developing and maintaining this toolhas been greatly enhanced by their EditorTechnical EditorSparx SystemsGeoffrey Spark sMichael FraserIContents 2005-2012 Sparx Systems Pty LtdTable of 3 Copyright Notice .. 4 End User License Agreement .. 7 Support .. 8 Your Feedback Install the Keystore Service9 Start/Stop the Keystore Service11 Configure the Keystore 15 Active Directory Configuration File .. 17 SSKS Configuration File Keystore Service 20 Connect To a Remote Keystore .. 21 Add Shared Keys .. 22 Set Issue Periods for the Keys .. 24 Migrate Shared Keys From File-Based Keystore .. 26 Release Shared Keys .. 27 Delete Shared Keys Configure enterprise Architect to AcquireKeys From Keystore28 Activity Logs29 Troubleshooting30 Index33 ForewordThe Sparx Systems Keystore Service is used to manage theregistration keys issued with the Floating Licenses purchasedfor enterprise Architect Corporate, Business and SoftwareEngineering, Systems Engineering, and Ultimate editions,and for related MDG Systems Keystore Service User GuideIntroduction | 2 2005-2012 Sparx Systems Pty Ltd1 IntroductionThe Sparx System s Keystore Service (SSKS)

4 Helps you to m anage the use of registration keys issued withthe Floating Licenses purchased for enterprise Architect Corporate, Business & Software Engineering,System s Engineering, and Ultim ate editions, and for related MDG the Sparx System s Keystore Service application, an adm inistrator can create a key store in a networkfile location that enables licenses with a finite (adm inistrator-defined) issue period to be assigned tospecific workstations. The key store also enables the adm inistrator to quickly determ ine which user has aparticular key, and to see the date on which the key :Each enterprise Architect workstation can be associated with only one key store at a tim AlsoCopyright NoticeEnd User Licensing Agreem entSupportYour FeedbackInstall the Keystore ServiceStart/Stop the Keystore ServiceConfigure the Keystore ServiceSparx System s Keystore Service Adm inistrationConfigure enterprise Architect to Acquire Keys from KeystoreActivity LogsTroubleshooting34789111219282930 Introduction | Copyright Notice3 Sparx Systems Keystore Service User Copyright NoticeCopyright 1998-2012 Sparx Systems Pty.

5 Ltd. All rights reservedThe software contains proprietary inform ation of Sparx System s Pty Ltd. It is provided under a licenseagreem ent containing restrictions on use and disclosure and is also protected by copyright law. Reverseengineering of the software is prohibited. Please read the license agreem ent for full to continued product developm ent, this inform ation can change without notice. The inform ation andintellectual property contained herein is confidential between Sparx System s and the client and rem ains theexclusive property of Sparx System s. If you find any problem s in the docum entation, please report them to usin writing. Sparx System s does not warrant that this docum ent is error-free. No part of this publication m aybe reproduced, stored in a retrieval system , or transm itted in any form or by any m eans, electronic,m echanical, photocopying, recording or otherwise without the prior written perm ission of Sparx System users are granted the right to print a single hardcopy of the user m anual per licensed copy of thesoftware, but m ay not sell, distribute or otherwise dispose of the hardcopy without written consent of SparxSystem Systems Pty.

6 Curtis St,Creswick, Victoria 3363,AUSTRALIAP hone: +61 (3) 5345 1140 Fax: +61 (3) 5345 1104 Support Em ail: support@sparxsystem Em ail: sales@sparxsystem : | End User License Agreement4 2005-2012 Sparx Systems Pty End User License AgreementSparx Systems Keystore Service (SSKS)Copyright (C) 1998-2012 Sparx Systems Pty Ltd. All Rights ReservedIMPORTANT- READ CAREFULLY: This End User License Agreem ent ("EULA") is a legal agreem ent betweenYOU as Licensee and Sparx for the SOFTWARE PRODUCT identified above. By installing, copying, orotherwise using the SOFTWARE PRODUCT, YOU agree to be bound by the term s of this EULA. If YOU donot agree to the term s of this EULA, prom ptly return the unused SOFTWARE PRODUCT to the place ofpurchase for a full copyright in the SOFTWARE PRODUCT and its docum entation is owned by Sparx System s Pty Ltd 034 546.

7 Subject to the term s of this EULA, YOU are granted a non-exclusive right for the duration of theEULA to use the SOFTWARE PRODUCT. YOU do not acquire ownership of copyright or other intellectualproperty rights in any part of the SOFTWARE PRODUCT by virtue of this use of this software indicates your acceptance of this EULA and this End User License Agreem ent, unless the contrary intention appears:"EULA" m eans this End User License Agreem ent." Sparx " m eans Sparx System s Pty Ltd 085 034 546."Licensee" m eans YOU, or the organization (if any) on whose behalf YOU are taking the EULA."SOFTWARE PRODUCT" or "SOFTWARE" m eans Sparx System s Keystore Service, which includescom puter software and associated m edia and printed m aterials, and m ay include online or electronicdocum entation.

8 "Support Services " m eans em ail based support provided by Sparx , including advice on usage of SparxSystem s Keystore Service, investigation of bugs, fixes, repairs of m odels if and when appropriate, andgeneral product support." Sparx support engineers" m eans em ployees of Sparx who provide on-line support OF LICENSEIn accordance with the term s 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 sam eoperating system , on a single com puter. As the prim ary user of the com puter on which the SOFTWAREPRODUCT is installed, YOU m ay m ake a second copy for your exclusive use on either a hom e orportable com )To store or install a copy of the SOFTWARE PRODUCT on a storage device, such as a network server,used only to install or run the SOFTWARE PRODUCT over an internal network.

9 If YOU want to increasethe num ber of users entitled to concurrently access the SOFTWARE PRODUCT, YOU m ust notify SPARXand agree to pay an additional )To m ake copies of the SOFTWARE PRODUCT for backup and archival RIGHTS AND LIMITATIONSYOU hereby undertake not to sell, rent, lease, translate, adapt, vary, m odify, decom pile, disassem ble,reverse engineer, create derivative works of, m odify, sub-license, loan or distribute the SOFTWAREPRODUCT other than as expressly authorized by this further undertake not to reproduce or distribute license key-codes except under the express and writtenperm ission of m ay only assign all your rights and obligations under this EULA to another party if YOU supply to thetransferee a copy of this EULA and all other docum entation including proof of ownership.

10 Your license isthen term | End User License Agreement5 Sparx Systems Keystore Service User GuideTERMINATIONW ithout prejudice to any other rights, Sparx m ay term inate this EULA if YOU fail to com ply with the term sand conditions. Upon term ination YOU or YOUR representative shall destroy all copies of the SOFTWAREPRODUCT and all of its com ponent parts or otherwise return or dispose of such m aterial in the m annerdirected by AND LIABILITYWARRANTIESSPARX warrants that the SOFTWARE PRODUCT will perform substantially in accordance with theaccom panying written m aterials for a period of ninety (90) days from the date of receipt, and any SupportServices provided by Sparx shall be substantially as described in applicable written m aterials provided toYOU by Sparx , and Sparx support engineers will m ake com m ercially reasonable efforts to solve anyproblem s associated with the SOFTWARE the m axim um extent perm itted by law, Sparx excludes, for itself and for any supplier of softwareincorporated in the SOFTWARE PRODUCT, all liability for all claim s, expenses, losses, dam ages and costsm ade against or incurred or suffered by YOU directly or indirectly (including without lim itation lost costs,profits and data) arising out of.