Getting started with IBM Rational DOORS Next Generation, V4.0.6 - Exercise environment setup

This article shows you how to set up your environment for use with the tutorial Getting started with IBM Rational DOORS Next Generation, V4.0.6.

Share:

Yianna Papadakis-Kantos (ypapadak@us.ibm.com), Curriculum Architect, IBM

Yianna Papadakis-KantosYianna Papadakis-Kantos is a curriculum architect and instructional designer for IBM Rational DOORS and IBM Rational DOORS Next Generation. Her background consists of many years of teaching, consulting, and developing training.



27 May 2014

This Appendix describes how to set up the exercise environment needed to perform the exercises of the Getting started with IBM Rational DOORS Next Generation tutorial. The tutorial uses the Automated Meter Reader Sample project, which contains prepopulated data to demonstrate the various capabilities of Rational DOORS Next Generation. You can access the sample data in two ways:

  1. Use a sandbox: Sandboxes are web-based trial environments that you can use to evaluate and explore IBM® Jazz™ products without having to install anything on your computer. This setup is good for people who are interested in Rational DOORS Next Generation from a usage perspective. If you take this approach, you create a project in the sandbox area and use the project to complete the exercises in this guide.
  2. Locally install the product: This setup is good for people who are interested in the product from a usage perspective, but who also want to understand aspects related to installation, configuration, and administration. If you take this approach, you download and install software on your computer.

Option 1. Use a sandbox

To create a sandbox, you must be a registered user on Jazz.net. If you do not have a Jazz.net user ID, you can create one for free at https://jazz.net/action/register.

Create and configure the sandbox

To create and configure the sandbox, complete the following steps. The setup and configuration are also demonstrated in this video.

  1. Log in to Jazz.net and go to the sandbox area at https://jazz.net/products/sandbox/.
  2. Select either the latest release of the product or the latest milestone. This tutorial was written for Rational DOORS Next Generation 4.0.6
  3. When you select the capabilities for the sandbox, either select only the check box for requirements management or select the check boxes for all three capabilities. In the following image, all three capabilities are selected.
  4. Optionally, change the project name to Automated Meter Reader (Water) <your jazz id> to match the name of the sample in the tutorial. Adding <your jazz id> will help differentiate it from the other similar projects on Jazz.net.
Figure 1. Select the capabilities for your Collaborative Lifecycle Management sandbox.
Select capabilities

After the sandbox project is created, you are sent an email with the details of the sandbox project and how you can access it.

Figure 2. After the sandbox project is created, you can navigate to the different applications.
Navigate in the sandbox

Create and configure the sandbox

The requirements management (RM) project created in the sandbox can be opened by clicking on it from the Visit your sandbox project in Figure 2. When the project is opened it looks like the following image:

Figure 3. The sandbox creates a requirements management project that contains no data.
Sandbox project contains no data

When a RM project is created in the sandbox, by default, the standard Rational Requirements Server template is used. That template does not contain prepopulated data.

Populate the project with sample data

To populate the project with sample data, complete these steps:

  1. Grant access rights to the Author role.
    1. From the Administration menu, click Manage This Project Area (Figure 4).
    2. Click Permissions and then click the Show by role radio button. From the list of roles, select Author, since this is the role that has been assigned to you.
    3. In the Permissions for Author list, scroll to the Import ReqIF operation. Hover over its row and click the Grant Permission icon Grant Permission icon (Figure 5).
    4. Scroll to the Save Types operation and click its Grant Permission icon. You need this permission because you will be changing the structure of the default RM project by introducing link types, artifact types, and so forth.
    5. Scroll to the Save Shared View operation and click its Grant Permission icon. You need this permission because you will be sharing views with your team.
    6. Save your changes and return to the Artifact page by clicking the browser's back button.
    Figure 4. You can manage the project area from the Administration menu.
    Administration menu
    Figure 5. You can grant or remove permissions.
    Grant or remove permissions
  2. Import the ReqIF file that is provided with the tutorial.
    1. Download the ReqIF file that is provided with the tutorial. (See the Download section.)
    2. From the Artifacts page, select Artifact > Import Artifact
    3. In the import window, select Import Requirements from a ReqIf file.
    4. Browse to and upload the ReqIF file, and then click Next to import the requirements.

You are now ready to start the demo by using the sandbox on Jazz.net.


Option 2. Locally install the product

If you are not using the sandbox, you can install the product on your computer. Alternatively, if you have an instance of Jazz Team Server, you can connect to it. You must create a requirements management project that is based on a template.

In your final environment, make sure that these prerequisites are met.

Install and configure

You installed and configured the V4.0.6 applications for the Rational solution for Collaborative Lifecycle Management (CLM). You can download the applications at https://jazz.net/products.

  1. For more help, see the interactive installation guide.
  2. If you want to install the software for evaluation and training, use an evaluation topology where your production license keys will not be affected because the tool comes with short-term licenses. To watch a demonstration of how to download, install, and set up Jazz Team Server and the CLM applications on your computer by using localhost, see this video. The evaluation topology setup is not for production level, but can be used for this demo.

Create a project from a template

Create an RM project that is based on the Automated Meter Reader Sample template:

  1. Ensure that you have a URL for Jazz Team Server; for example, https://jazz-server:9443/jts/admin.
  2. Ensure that you can log in to Jazz Team Server as a user who has the following permissions and licenses:
    1. The JazzAdmins repository permission, which includes the JazzProjectAdmin permission
    2. The Rational DOORS Next Generation - Analyst license
    3. The Rational Quality Manager – Contributor license
    4. The Rational Team Concert – Contributor license
    Figure 6. Required repository permissions and client access license
    Repository permissions and license
  3. Install the Automated Meter Reader sample project:
    1. Go to the Jazz Team Server home page: https://jazz-server:9443/jts/admin.
    2. In the Requirements Management (/rm) section, select Create Project Area.
    Figure 7. Create an RM project from the Jazz Team Server home page.
    Create an RM project
  4. Name the project area Automated Meter Reader (Water), and to initially populate the project, select the Automated Meter Reader Sample template.
Figure 8. Create a project from the Automated Meter Reader Sample template.
Create project from sample template

The Automated Meter Reader (Water) requirements management project is now installed and you are ready to start this tutorial.


Download

DescriptionNameSize
Sample data for Getting Started with DOORS NGAMR-4-0-6.zip1,152 K

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into Rational software on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational
ArticleID=972007
ArticleTitle=Getting started with IBM Rational DOORS Next Generation, V4.0.6 - Exercise environment setup
publish-date=05272014