Leanpub Header

Skip to main content

EA Deployment Playbook

A Guide for Sparx Enterprise Architect Power-Users and Small Teams

Get your team excited and ready to collaborate in Sparx Enterprise Architect. Navigate PCS setup, security, and RAS with confidence.

Minimum price

$19.97

$29.97

You pay

$29.97

Author earns

$23.97
$

...Or Buy With Credits!

You can get credits with a paid monthly or annual Reader Membership, or you can buy them here.

Buying multiple copies for your team? See below for a discount!

EPUB
About

About

About the Book

Hey, fellow EA user — Welcome! Maybe you've been modeling solo for years, and now it's time to enable your team to join in. Your previous work with Enterprise Architect was so easy — a repository was just a simple file. Now there are so many questions: Should we share a file, or work with a DBMS? Is Pro Cloud Server something we need? What good is a RAS?

This book will be your friendly guide through that transition. I've been there: digging through the help documents and forums, trying to figure out the best way to bring EA to my group. As I was struggling, I wished for a single source of information to help untangle the options and give some guidance. I couldn't find a book like this, so I wrote it.

No overwhelming references here. Just clear steps and tips to get your team collaborating smoothly with EA, in about 200 pages.

Team Discounts

Team Discounts

Get a team discount on this book!

  • Up to 3 members

    Minimum price
    $49.00
    Suggested price
    $74.00
  • Up to 5 members

    Minimum price
    $79.00
    Suggested price
    $119.00
  • Up to 10 members

    Minimum price
    $139.00
    Suggested price
    $209.00
  • Up to 15 members

    Minimum price
    $199.00
    Suggested price
    $299.00
  • Up to 25 members

    Minimum price
    $299.00
    Suggested price
    $449.00

Author

About the Author

Max Hinkley

Max Hinkley is a consulting software and systems engineer with more than twenty years of experience delivering embedded, desktop, and distributed systems in safety‑critical and mission‑critical domains. He is the principal consultant at SafeCode Consulting, and he has worked across medical, aerospace, industrial, and security‑sensitive markets where firmware failure, data compromise, or downtime carries high regulatory and business costs. Max is known for combining secure coding practices with model‑driven engineering and pragmatic architecture, helping small engineering organizations raise their bar on reliability and safety without grinding development to a halt.

Contents

Table of Contents

  • Introduction
  • Part I - Bleeping Basics
    • 1. What it's All About
      • Who this book is for
      • What "successful deployment" looks like
      • The few levers that actually matter
      • How the rest of the book fits together
    • 2. Picking Your Editions and Licenses
      • Editions you actually need to think about
      • Licenses: how keys are allocated and shared
      • Matching editions to solo, mini team, and small team
      • When to bring PCS into the picture
      • Choosing a PCS strategy, not just “PCS: yes or no”
      • The SaaS Shortcut
      • Coming Up
    • 3. Choosing Your Repository Type: File vs DBMS
      • What a "repository" really is
      • File‑based repositories: what they are good at
      • When file sharing still makes sense for a mini team
      • DBMS repositories: when you are ready for the big leagues)
      • How PCS fits over both file and DBMS
      • How to decide in practice
      • Coming Up
    • 4. Installing Enterprise Architect
      • Windows: the baseline recipe
      • Linux: EA under Wine
      • macOS: EA under Wine or CrossOver
      • When this chapter has done its job
      • Coming Up
  • Part II - Revisiting Repositories
    • 5. Fast Path: Setting Up a File-Based Repository
      • Solo: one file, one habit
      • When (and how) to consider .feap locally
      • Mini team: shared .qeax and simple rules
      • Repository Version Control
      • Coming Up
    • 6. Replication: A File-based Solution for the Disconnected
      • What is meant by "replication"
      • When replication matters
      • The shape of a sane replication setup
      • Trade‑offs and sharp edges
      • How this fits into your deployment choices
    • 7. Team Path: Setting Up a DBMS Repository
      • When it is worth starting on DBMS
      • DBMS options that matter for small teams
      • Creating an empty EA repository in a DBMS
      • Direct vs via PCS
      • Consistent connection strings
      • Day‑to‑day use when you begin on DBMS
      • Backups
      • "Test vs production" from the start
    • 8. Moving From File to DBMS Without Losing Your Mind
      • Recognizing that your file‑based fast path is no longer the right path
      • Using Full Project Transfer: moving from file-based to DBMS, safely
      • Common migration patterns
      • Cleaning up after migration
  • Part III - Dancing with the Details
    • 9. Turning On Security and Defining Roles
      • File‑based vs DBMS security
      • What EA means by "security"
      • Users, groups, and the permission firehose
      • In‑Model Collaboration Lives on Top of Security
      • Model Mail: Internal Mailbox, Shared Repository
      • Model Chat and Discussions: Conversations Anchored to the Model
      • What This Means for Your Deployment Choices
      • Locks: keeping people from tripping over each other
      • Turning security on (the minimum you need)
      • Solos: when to care and when not to
      • Mini teams: stop relying on good intentions
      • Small teams on DBMS: two layers of security, one coherent story
      • Security as a prerequisite for AI
    • 10. Configuring EA’s AI Assistant
      • What EA’s AI assistant is (and is not)
      • Versions, editions, and prerequisites
      • Configuring LLM providers
      • Tying AI actions to users and permissions
      • AI and In‑Model Collaboration Content
      • Governance basics for small teams
    • 11. Structuring Your Repository for Growth
      • Basic Organizational Elements
      • Common structures that actually age well
      • What I say .vs. What I do
      • Traps that quietly wreck structure
      • Designing a starter repository you can reuse
      • Using RAS and XMI for starter content
      • Package Control and Baseline Management
      • A word about GUIDs and reuse
      • How to tell if the structure is working
      • Why this chapter belongs in your deployment checklist
    • 12. Using PCS for Repositories, RAS, and Floating Licenses
      • What PCS actually adds
      • PCS Editions in practice: standard vs Pro repositories
      • Installing PCS without tripping over the basics
      • PCS quirks worth knowing about
      • Configuring the PCS Floating License Server
      • Using PCS for RAS and shared assets
      • Where PCS fits in your deployment story
  • Part IV - Plans, Patterns, and Practical Application
    • 13. Recipes and Scenarios
      • Solo consultant with several clients
      • Consultant with a traveling laptop and replicated client copies
      • Mini team on a shared .qeax (file‑based first, DBMS later)
      • Small internal team with DBMS and PCS
      • Consultancy or architecture team with a pattern library (RAS)
      • How these plays fit together
    • 14. Capability Patterns for EA Deployment
      • Capability 1: "I just need to get work done"
      • Capability 2: "We need to work together without building a platform"
      • Capability 3: "This repository is now part of how we run"
      • Capability 4: "People are everywhere, and the model has to be too"
      • Capability 5: "We want the capabilities, not the plumbing"
      • How to use this chapter with the recipes
    • 15. Case Study: From Solo to Cloud
      • Two solo modelers, one system
      • Phase 1 – "Tempy": a deliberate temporary cloud
      • Phase 2 – "Perm": a small, serious server
      • Migrating from Tempy to Perm
      • Handover and after‑effects
      • How this maps to the rest of the book
  • Appendices
    • Appendix A: Example Security Model for Embedded Teams
      • A.1 Group Types and Overall Rationale
      • A.2 Core Capability Groups
      • A.3 Qualifier Groups
      • A.4 Label Groups
      • A.5 Team Roles
    • Appendix B: A Layered Security Model for an Enterprise Architecture Team
      • B.1 Group Types
      • B.2 Capability Groups (What They Can Do)
      • B.3 Qualifier Group
      • B.4 Label/Tag Groups
      • B.5 TOGAF EA Team Roles
    • Appendix C: Going Deeper

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

Now, this is technically risky for us, since you'll have the book or course files either way. But we're so confident in our products and services, and in our authors and readers, that we're happy to offer a full money back guarantee for everything we sell.

You can only find out how good something is by trying it, and because of our 100% money back guarantee there's literally no risk to do so!

So, there's no reason not to click the Add to Cart button, is there?

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $14 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub