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:
- 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.
- 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.
- Log in to Jazz.net and go to the sandbox area at https://jazz.net/products/sandbox/.
- Select either the latest release of the product or the latest milestone. This tutorial was written for Rational DOORS Next Generation 4.0.6
- 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.
- 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.
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.
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.
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:
- Grant access rights to the Author role.
- From the Administration menu, click Manage This Project Area (Figure 4).
- 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.
- In the Permissions for Author list, scroll to the Import ReqIF operation. Hover over its row and click the Grant Permission icon (Figure 5).
- 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.
- 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.
- 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.
Figure 5. You can grant or remove permissions.
- Import the ReqIF file that is provided with the tutorial.
- Download the ReqIF file that is provided with the tutorial. (See the Download section.)
- From the Artifacts page, select Artifact > Import Artifact
- In the import window, select Import Requirements from a ReqIf file.
- 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.
- For more help, see the interactive installation guide.
- 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:
- Ensure that you have a URL for Jazz Team Server; for example,
- Ensure that you can log in to Jazz Team Server as a user who has the
following permissions and licenses:
- The JazzAdmins repository permission, which includes the JazzProjectAdmin permission
- The Rational DOORS Next Generation - Analyst license
- The Rational Quality Manager – Contributor license
- The Rational Team Concert – Contributor license
Figure 6. Required repository permissions and client access license
- Install the Automated Meter Reader sample project:
- Go to the Jazz Team Server home page:
- In the Requirements Management (/rm) section, select Create Project Area.
Figure 7. Create an RM project from the Jazz Team Server home page.
- Go to the Jazz Team Server home page:
- 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.
The Automated Meter Reader (Water) requirements management project is now installed and you are ready to start this tutorial.
|Sample data for Getting Started with DOORS NG||AMR-4-0-6.zip||1,152 K|
Dig deeper into Rational software on developerWorks
Get samples, articles, product docs, and community resources to help build, deploy, and manage your cloud apps.
Experiment with new directions in software development.
Software development in the cloud. Register today to create a project.
Evaluate IBM software and solutions, and transform challenges into opportunities.