Setting up and configuring the Design Management Server by using express setup

Use the following steps to set up and configure the Design Management Server. After Design Management is installed, you must configure the Jazz™ Team Server URI as well as create an administrative user. The Express Setup configuration option uses the default Apache Derby database and creates the administrative user which is assigned to the data warehouses for each installed application.

Before you begin

Before you configure the server, you must enable pop-up windows to avoid installation problems during the setup and configuration process.
Important: When you set up and configure the model server, do not refresh the browser or use the front and back buttons.

Procedure

  1. Start the installed server by using an account that has administrator permissions.
    • If you are using Apache Tomcat on a Windows operating system, click Start > All Programs > Collaborative Lifecycle Management > Start the Jazz Team Server.
      Important: In each case, if you are using Apache Tomcat, wait for the message INFO: Server startup in # ms. This step might take a while to complete the first time that you start the server; on subsequent restarts, the server starts much faster.
      Tip: To start the server from the command line, open a command prompt as an administrator: click Start > Programs > Accessories, right-click Command Prompt, and click Run as administrator. In the administrator command window, go to the server folder in your server installation directory and run server.startup.bat.
    • If you are using Apache Tomcat on a Linux operating system, go to the server folder in your server installation directory and run server.startup.
    • If you are using WebSphere® Application Server, start the server from the WebSphere Application Server administrative console.
  2. In a web browser, go to https://fully_qualified_host_name:9443/jts/setup.

    A fully_qualified_host_name includes both the host name and the DNS domain reference of the server on which the Jazz Team Server is installed. An example of a fully qualified host name is myserver.example.org. The fully qualified host name cannot include localhost or an IP address.

    To find the fully qualified host name (hostname.DNSsuffix) of the server on a Windows operating system, at a command prompt, type hostname to get the hostname, and type ipconfig to get the DNS suffix.

    On a Linux operating system, in a terminal window type hostname –fqdn.

  3. The Design Management Server is built on and runs on Jazz Team Server. Therefore, during the setup and configuration process, you must use parts of the standard Jazz Team Server functionality. On the Jazz Team Server login page, enter ADMIN (case sensitive) in both the User ID and Password fields, and then click Log In.

    The following diagram displays the login page for the Jazz Team Server.

  4. On the Setup page, click Express Setup and click Next.
  5. On the Configure Public URI page, provide a public URI in the following format: https://fully_qualified_host_name:9443/jts. After you read the warning, and if you understand the implications, click I understand that once the Public URI is set, it can not be modified. Design Management verifies the connection; after the test is successful, click Next.

    The following diagram shows the Configure Public URI page. You can accept the default URI or enter a different URI.

    Tip: If another Jazz product is installed on the server, to avoid a port number collision, change the default port number from 9443 to an available port number.
    Remember: The variable fully_qualified_host_name is the host name and the DNS domain reference of the computer on which the Jazz Team Server is installed.
  6. On the Create User page, create the user ID, name, password, and email address of the user who has administrative user access to the Jazz Team Server. You might consider using DM_Admin for the user ID, name, and password. This user has access to the data warehouse to run reports.
  7. Click Next.
  8. The application begins to configure and set up the database and data warehouse, register applications, install the sample project, and finalize each application. This process can take a few minutes. After the process is complete, click Next.
  9. On the Assign Licenses page, assign the Rational Software Architect Design Manager - Design Manager or Rational Rhapsody Design Manager - Design Manager license to the new DM_Admin account, and then click Next.
    Note: If you are installing other CLM applications, you can also select licenses for Rational® Requirements Composer, Rational Team Concert™, or Rational Quality Management. Click Activate Trial to get a temporary license.
  10. Click Finish and the wizard redirects you to https://fully_qualified_host_name:9443/jts/admin.

What to do next

To help you get started, on the Server Administration page, click Create Users or Assign Client Licenses on the right side of the page under Task Guide.

Feedback