Tag Archive for: IBM Doors Page 2

Tag Archive for: IBM Doors

Data Migration to Modern Requirements Management

This post on moving away from IBM DOORS® is part of a series. You can find Part II on legacy software pains here, Part III on enabling innovation here, Part IV on the difficulties of compliance here, and Part VI on migration solutions here. 

IBM® Rational DOORS® has been around since the early ‘90s and has served many teams well in the past. But in today’s web-based, interconnected world, if you’re still using DOORS, your requirements are likely stuck in a siloed Windows application. It’s time to retire DOORS and move to a modern requirements management solution. Here is a hands-on guide for a painless data migration from a legacy requirements management solution like DOORS to Jama Connect®.

Software Migration Prep Work: Start by Taking Inventory

Before you begin your software migration, start by screening your DOORS data to get a rough overview of the work ahead of you. Collect key metrics of your current system:

  • How many DOORS modules do you have?
  • How many objects (items) reside in each module? Average? Maximum? Minimum?
  • How many attributes do your modules have, and how complex are they? Again, look at average, maximum, minimum, and also whether you use DXL attributes.
  • How many DOORS projects and folders?
  • How consistent is your data? Do all modules of a certain type (e.g. “User Needs”) have the same attributes?
  • Do you use any special DOORS features, like DOORS Tables, DXL scripts, or OLE objects?

Decide What to Migrate Where

It is rarely necessary to migrate all your data to Jama Connect. Your data migration typically only needs to include active data, not completed projects. It’s usually not necessary to migrate the history of your data, only the latest version.

Of course, completed projects and version history must not simply be discarded. Rather, you want to keep this information accessible somewhere, at least as long as legally required – this needs to be part of your software migration strategy.

You have the following options for your data migration, and you can mix and match them as you see fit:

  • You should always make a regular DOORS backup and properly archive it. This data is inaccessible, unless you reactivate DOORS
  • Active data should migrate to Jama Connect
  • Completed data should be exported in a format that can be processed without DOORS. This could be a simple PDF (or Office) export
  • Alternatively, you can export the data using the Requirements Interchange Format (ReqIF). ReqIF is an open standard for exchanging requirements. As Jama Connect supports ReqIF, you could always import that data if needed at a later time
  • Lastly, you can decide to keep DOORS around on a single license, and ensure all data is accessible

See how IBM DOORS customers can migrate to Jama Connect by viewing our datasheet.

Invest in Jama Connect Configuration

There is always the temptation in a software migration to simply move what you have from point A to point B; from DOORS to Jama Connect.

However, migrating to a new solution is a great opportunity for optimizing your processes and taking advantage of the capabilities of the new solution. This does not mean that you should throw everything out that you built so far. It simply means that you should revisit what you have, remove what did not stand the test of time, and reflect on the underlying use cases to ensure that the underlying problem is solved instead of blindly copying a mediocre solution.

In Jama Connect, this means that you should carefully analyze your existing data to configure frameworks for the various types of projects that you have. For instance, you may have a framework for complex, safety-critical development that follows the V-Model, and another lightweight Agile framework for app development.

A framework in Jama Connect is a configuration consisting of project structure, trace rules, workflow, and permissions that can be used as a template for new projects, as shown in the figure below. You should have frameworks that fit the data you intend to import. After the migration, all projects in DOORS that were “similar” will then follow the framework in Jama Connect, creating improved alignment and consistency.

Data is Easy, Customization is Hard

There is also a good chance that your DOORS system was customized significantly over the years. This is mainly due to the fact that DOORS can be programmed with a scripting language called DXL. While it is tempting to quickly solve a software migration problem by writing a little script, this can create long-term liabilities and maintenance nightmares.

It’s important to understand that no other requirements management tool supports DXL. Therefore, if you migrate to another solution (Jama Connect or otherwise), you will leave DXL behind.

So, rather than providing a scripting language, Jama Software provides an open Application Programming Interface (API). This allows you to perform customizations if necessary, without the liabilities that comes with scripting.

RELATED: Legacy Sunset: Scalable Migration Solutions for Jama Connect

Migrating to Jama Connect

Now that the Jama Connect frameworks are configured and the data identified, it’s time to migrate. We would not recommend your data migration happens all at once, but instead unfolds in three phases:

  • Phase One: In the preparation phase, you’ll perform a few test imports to ensure the data migrates across correctly.
  • Phase Two: When ready, you can migrate one pilot project. After evaluating the results (or even better, working for a few weeks in production), you can fine-tune and optimize the import process for subsequent projects.
  • Phase Three: At this point, you’re ready to migrate the remaining data. It is generally a good idea to keep the overlap — with both DOORS and Jama Connect in production — as small as possible.

The Software Migration Process

Jama Software provides four different facilities for data migration. Whichever one you use depends on your specific situation and the amount of data you need to migrate. All data migration options will maintain formatting and traceability:

  • Jama Connect ships with a built-in DOORS importer. To use it, you export views in DOORS to HTML, which are then imported. Every module has to be processed by hand, so this path is useful for test imports and small quantities of data (a few dozen DOORS modules).
  • You can also use Jama Software’s Data Exchange, which works with ReqIF, the Requirements Interchange Format. You can export data in DOORS and subsequently import it into Jama Connect. This scales better as you can process whole projects at a time.
  • You can also use Jama Software’s DOORS Migration Engine, a set of configurable tools that we tailor to your specific situation, which makes bulk migration possible.
  • If none of these options works for whatever reason, you can build your own scripts that import data into Jama Connect using our REST API.
RELATED: Legacy Sunset: Why Jama Connect is a Proven Alternative to Legacy Requirements Management Tools

Learn more about requirements traceability by downloading our eBook, “The Jama Software Guide to Requirements Traceability.”

Conclusion

DOORS has been a faithful requirements management tool that has served the product development community well for almost 30 years. But in order to stay competitive, it’s necessary to switch to a modern requirements management solution like Jama Connect.

Software migrations are rarely fun. However, when you migrate from DOORS to Jama Connect, it is a rewarding experience, as you end with an intuitive, user-friendly, and team-friendly environment. Plus, as your data gets aligned to the Jama Connect framework during the software migration process, your requirements data will be consistent and synchronized to your team’s processes.

See how Jama Connect can transform your requirements management process for legacy software customers in our whitepaper, “Jama Connect: A Modern Requirements Management Alternative to IBM DOORS.”

Legacy Software Blog Post

This post is part of a series. You can find Part I modern alternatives to IBM DOORS® here, Part III on enabling innovation here, Part IV on the difficulties of compliance here, Part V on moving from DOORS to Jama Connect here, and Part VI on migration solutions here. 

For decades, companies building highly regulated, technically complex products and systems have relied on legacy tools like IBM® DOORS® or even Microsoft® Office® for requirements management (RM).

As software becomes more prevalent in physical products and development methodologies evolve, legacy RM tools like these have struggled to keep up with the modern speed of capturing, sharing, and managing requirements.

See how Jama Connect stacks up to legacy software tools like IBM® DOORS® in our whitepaper.

Legacy tools are powerful, but even with their complex capabilities and reputation for stability, they don’t always match the goals of teams who need to adapt, innovate, and grow.

Noticing this misalignment can surface as painful moments — like when your team struggles to get work done. Sometimes those issues are process or market related, but in some cases they are actually because of the exact software tools you’re using to make your life easier with requirements management.Here are some critical signals that your team is no longer aligned with your legacy solution for requirements management, and how you might consider a change going forward.

Painful Moment 1: You value the input of multiple roles and skillsets, but you realize only a handful of people know how to use your RM tool (or worse, they’re not allowed into it).

Why It Matters: This is a signal that the RM tool was not set up with the whole team in mind. For companies innovating quickly, this lack of visibility into what you’re working on and why is a major risk. If it were possible for only a handful of people to build complex products, teams and companies wouldn’t have the diversity of skills and thought processes they do today.

What to Do: Consider a system that supports the workflow of multiple roles with advanced, user-friendly tools for different data types and views that still all roll up to the same goals. User-friendly traceability is essential.

Are you getting the most from your requirements management? Read our best practices guide.

Painful Moment 2: You miss the deadline for feedback on a requirement because the notification was unclear. Now you have to go outside the normal channels to have your input seen.

Why It Matters: This is an instance not always appreciated by those who wrote the processes. However, with legacy software that doesn’t make the intentions of users clear (such as wanting input by a specific date), it’s hard to avoid miscommunication and lost time.

What to Do: Look for RM tools that make the next action required of you clear and sends timely notifications with clear instructions.

Painful Moment 3: You try to enter data into the system, but it’s locked, archived, or somehow just not visible.

Your decision is blocked. The person you know who provides access and training is unavailable (for example, on vacation… or no longer at the company).

Why It Matters: Having company-mission critical software that only a handful of people understand and have access to is a huge risk for many reasons – some not as obvious. On the lower end of severity, you lose a few hours trying to access the right data. However, if the trend is that fewer people have permissions and training to use your RM tool, then you’re at risk of data being lost or your system eventually needing to be replaced entirely.

What to Do: Data can get richer over time; it doesn’t have to go stale. Invest in requirements management tools that support your team’s continuous growth and capture continuous input and collaboration.

Painful Moment 4: Your team wants to upgrade its legacy software to fix issues, improve security, and access the latest features. Unfortunately, it’s so customized and patched together that you can’t update without major consequences.

Why It Matters: The products you’re building change and improve over time. The software tools you use to get your work done every day need to keep up with you, at a pace that balances change with allowing users time to learn.

What to Do: Consider the risk and costs associated with stale software, and look for options that avoid getting you locked in to unsupported versions and brittle customizations.

There’s a lot of requirements management solutions on the market. Cut through the clutter with our buyer’s guide.

Painful Moment 5: You want to change the way your team uses the legacy software to match a new process, but there are no configuration experts available.

What if you break something? You hope you can create an experiment project on the side that will ultimately integrate back into the big picture, but it’s not clear how to create this outcome.

Why It Matters: If teams are struggling to get on the same page with their requirements management process, it’s a signal that whatever your building may have misalignments as well.

What to Do: Consider RM solutions that balance each team’s need for autonomy with the need for alignment. This can be supported by software that have services experts available to adapt the tools to your needs as you change, rather than one big rollout that attempts to predict the future.

It’s tough to have to work around legacy software to get your job done. It’s also expensive. Maybe you can’t change the RM tools you use on demand, but if you start to notice these painful patterns it becomes easier to build a business case for making a change that supports the whole company’s vision.

Learn the benefits of switching from legacy software tools for requirements management with our paper, “Jama Connect: A Modern Requirements Management Alternative to IBM DOORS.”

At Jama, we work with the world’s most innovative companies and government agencies to manage the entire lifecycle of product delivery. They think differently, challenge the status quo, and are constantly looking for new ways to improve product delivery to gain that competitive edge. Unfortunately many find it really challenging to work with a legacy tool that no longer meets their needs. What is the risk to the business? What is the cost to move all the old data to a new solution?

We have built a world-class solution to help you move active data from IBM DOORS to Jama, a lower cost, cutting-edge product delivery platform. Jama’s import capabilities for IBM DOORS include the ability to bring along the requirements, test cases and other information you care about.

Don’t work the old way. Now is the time to move off IBM DOORS. We can help. Bring what you need into Jama, when you need it. The Jama DOORS migration solution will maintain all relationships, so you can easily configure or change any elements.

How does it works

Learn more! Contact us to see how it works.