Downloading and installing pattern types

To use a pattern, you must download its pattern type, and then install it on the appliance. The download package contains the pattern artifacts.

After you install a pattern type, accept the license agreement and enable the pattern type for use. Then, verify that it was successfully installed.

Before you begin

You must have a supported installation of the appliance that is being used to manage resources in a cloud-computing environment.

To install software on the appliance, you must be assigned the Create new catalog content role or the Workload resources administration role with full permissions. For more information about user roles, see Managing system users.

About this task

Each pattern type download package includes a pattern type archive file (.tgz) that contains the pattern definition files.

From PureSystems® Centre, find the package information, then follow the instructions to download the package to an interim system on Linux or Microsoft Windows. Then, extract and upload the pattern type archive file to the appliance by importing it as a pattern type.

Procedure

  1. Go to the PureSystems Centre website.
  2. Search for the following pattern types.
    • IBM® Rational® Integration Tester

      This pattern type includes IBM Rational Integration Tester Pattern and IBM Rational Test Control Panel Pattern, which are separate patterns after installation.

    • IBM Rational Test Virtualization Server
    • IBM Rational Performance Test Server
    Important: Each download package can be used on a Linux environment that runs on the appliance. The download package includes IBM Rational License Key Server Pattern Type, which provides automated license management for deployed patterns. If you plan to deploy any of the following patterns, you must enable automated licence management.
    • IBM Rational Integration Tester
    • IBM Rational Test Virtualization Server with Agent mode licensing
    • IBM Rational Performance Test Server with Agent mode licensing
  3. To obtain the pattern type archive file, from a Linux or Windows workstation, extract the contents of each package to a temporary location.
    • com.ibm.rational.rit.ptype-1.0.0.0.tgz
    • com.ibm.rational.rtvs.ptype-1.0.0.0.tgz
    • com.ibm.rational.rpts.ptype-1.0.0.0.tgz
    • com.ibm.rational.rlks.ptype-1.0.0.0.tgz
  4. Load the pattern type archive file into the appliance by using the workload console (suitable for files that are smaller than 2 GB) or the command-line interface:
    • To use the workload console:
      1. Log in to the appliance by using the following web address:

        http://appliance_IP

        where appliance_IP is the IP address or host name of the appliance.

      2. Go to the Pattern Types menu by clicking Catalog > Pattern Types.

        Clicking Pattern Types from Catalog menu

      3. Click the New icon on the toolbar.

        Clicking the New icon

      4. Use the Local or Remote tab to locate the pattern type archive file, for example, com.ibm.rational.rlks.ptype-1.0.0.0.tgz, and click OK.

        Installing a pattern type from a local directory

    • To use the command line:
      1. Download and install the command-line interface tool to your local computer. For more information, see Downloading the command-line interface.
      2. Go to the pure.cli/bin subdirectory in the location where you installed the command-line interface tool.
      3. Start the command-line interface by running the following command:

        pure –h appliance_IP

        where appliance_IP represents the host name or the IP address of the appliance.

      4. When prompted, enter your user ID and password.
      5. Run the deployer.patterntypes.create command by using the following syntax:

        deployer.patterntypes.create('fully_qualified_archive_filename')

        where fully_qualified_archive_filename represents the file name and location of the pattern type archive file.

        For example:

        deployer.patterntypes.create('/tmp/com.ibm.rational.rlks.ptype-1.0.0.0.tgz')

What to do next

Accept the license agreement of the pattern type and enable the pattern type for use.

Accepting licenses and enabling the pattern type

Before you can work with the patterns, you must accept the required license for the pattern type, and then make the installed components available for use.

About this task

From the appliance where the pattern type was installed, accept the license for the pattern type and enable the pattern type.

Procedure

  1. Go to the Pattern Types menu by clicking Catalog > Pattern Types.
  2. To view further details, from the list of pattern types, select the pattern type.
    • IBM Rational Integration Tester Pattern Type 1.0.0.0
    • IBM Rational Test Virtualization Server Pattern Type 1.0.0.0
    • IBM Rational Performance Test Server Pattern Type 1.0.0.0
    • IBM Rational Licensed Key Server Pattern Type 1.0.0.0
    Tip: Use the filter to find all pattern types with rational in the name.
    Filtering to find a selection
    Notice that the license agreement is shown as Not Accepted.
  3. To display the license agreement, click License.

    Accepting the license agreement

  4. To change the state of the license agreement to Accepted, review the license and then click Accept.
    Note: This step does not apply to IBM Rational License Key Server Pattern Type.
  5. To enable the pattern type, update the Status value by clicking Enable.

    Enabling the pattern type

    When the process completes, the value is updated to Available.

What to do next

Verify that the pattern type was successfully installed.

Verifying the installed pattern type

After you install the pattern type, accept the license agreement, and enable it for use, verify that all parts were successfully installed.

About this task

From the appliance where the pattern type was installed, verify that the pattern type was successfully installed.

Procedure

  1. Verify that the plug-in shows the installed software components:
    1. View the plug-in. Click Catalog > System Plug-ins
    2. From the list at the top of the left pane, select a pattern type.
      • IBM Rational Integration Tester Pattern Type 1.0.0.0
      • IBM Rational Performance Test Server Pattern Type 1.0.0.0
      • IBM Rational Test Virtualization Server Pattern Type 1.0.0.0
      • IBM Rational License Key Server Pattern Type 1.0.0.0
    3. To view the component details, click each pattern type.
      • IBM Rational Integration Tester Pattern Type 1.0.0.0
        • com.ibm.rational.rit 1.0.0.0
        • com.ibm.rational.rtcp 1.0.0.0
      • IBM Rational Performance Test Server Pattern Type 1.0.0.0
        • com.ibm.rational.rpts.agent 1.0.0.0
      • IBM Rational Test Virtualization Server Pattern Type 1.0.0.0
        • com.ibm.rational.rtvs.agent 1.0.0.0
      • IBM Rational License Key Server Pattern Type 1.0.0.0
        • com.ibm.rational.rlks.admin.agent 1.0.0.0
        • com.ibm.rational.rlks.admin 1.0.0.0
        • com.ibm.rational.rlks 1.0.0.0
        • com.ibm.rational.ss.rlks 1.0.0.0
  2. Verify the pattern type:
    1. View the pattern type. Click Catalog > Pattern Types.
    2. Locate the following items in the left pane:
      • IBM Rational Integration Tester Pattern Type 1.0.0.0
      • IBM Rational Performance Test Server Pattern Type 1.0.0.0
      • IBM Rational Test Virtualization Server Pattern Type 1.0.0.0
      • IBM Rational License Key Server Pattern Type 1.0.0.0
    3. To view the details of an item, click the item.

      Viewing the pattern type details

  3. If you installed IBM Rational Integration Tester Pattern Type, verify the results database script. Click Catalog > Script Packages, and locate Configure DB2 Results Database for RIT either by scrolling through the list or by specifying a filter value of Results Database.

    Finding the script package

  4. If you installed IBM Rational License Key Server Pattern Type, verify the shared service.
    1. View the shared service. Click Patterns > Shared Services.
    2. Locate IBM Shared Service for Rational License Key Server (External) 1.0.0.0 in the left pane.
    3. To view the shared service details, click its name.
  5. Verify the virtual system patterns.
    1. View the virtual system pattern. Click Patterns > Virtual System Patterns.

      Clicking the Patterns menu.

    2. Locate the following virtual system patterns:
      • IBM Rational Integration Tester Pattern
      • IBM Rational Test Virtualization Server Pattern
      • IBM Rational Performance Test Server Pattern
      • IBM Rational Test Control Panel Pattern
      • IBM Rational License Key Server Pattern
    3. To view the pattern details, click its name.
      Important: If you see warning messages about missing parameters, you can ignore them. When you deploy the pattern you add the missing parameters.

What to do next

Prepare to deploy.
Feedback